Factuarea APIDevelopers
Contracte

Un justificant per a cada cobrament

Els justificants s'emeten per cobrament, també els parcials: les operacions de justificant de factures i despeses accepten un payment_id opcional i les seves tools MCP retornen el número del justificant. Els PDF de documents mostren l'IBAN de l'emissor només amb formes de pagament bancàries i fan servir 9 pt de mida base per defecte. Dues operacions i dues tools MCP actualitzades.

15 d'octubre de 2026 — Cada cobrament vigent d'una factura i cada pagament vigent d'una despesa té el seu propi justificant, també els parcials i les bestretes. El justificant mostra la factura tal com va quedar just després d'aquest cobrament: els cobraments fins a ell, l'import cobrat i el que queda pendent.

Justificants

  • Tria el cobrament — Descarregar el PDF del justificant d'un cobrament i Descarregar el PDF del justificant d'un pagament d'una despesa accepten el paràmetre de query opcional payment_id, l'ID d'un cobrament o pagament d'aquesta factura o despesa. Sense ell obtens el justificant del cobrament vigent més recent.
  • Des del primer cobrament — una factura no ha d'estar cobrada del tot per tenir justificant: una bestreta ja en té. Un cobrament anul·lat no té justificant.
  • Número i nom del fitxer — cada justificant es numera amb JC- (vendes) o JP- (despeses), seguit del número de la factura i els sis últims caràcters de l'ID del cobrament, per exemple JC-F-2026-014-282633. Content-Disposition anomena el fitxer justificante-<número>.pdf.
  • Errors — 422 quan la factura o la despesa no té cobraments vigents o quan payment_id és un cobrament anul·lat (business_rule_violation a les factures, receipt_not_available a les despeses, amb subcode no_active_payments o payment_reversed), i 404 resource_not_found quan payment_id no és un cobrament d'aquesta factura o despesa.
  • Tools MCP — get_invoice_payment_receipt i get_purchase_invoice_payment_receipt accepten payment_id i retornen receipt_number juntament amb el PDF.

El justificant segueix la personalització dels PDF de l'empresa (logo, color, font i mida base), escriu l'import en lletres i surt en l'idioma de facturació de l'empresa. No és una factura i no porta dades de VERI*FACTU.

Les crides sense payment_id continuen funcionant i retornen el justificant de l'últim cobrament.

PDF de documents

  • L'IBAN de l'emissor només apareix quan la forma de pagament és una transferència o una domiciliació, o quan el document no té forma de pagament.
  • Les empreses que no han triat una mida base de lletra reben els seus PDF a 9 pt.

Endpoints actualitzats2

EndpointDescripció
GET/v1/invoices/{invoice}/payment-receiptDescarregar el PDF del justificant d'un cobrament
GET/v1/purchase_invoices/{purchase_invoice}/payment-receiptDescarregar el PDF del justificant d'un pagament d'una despesa

En aquesta pàgina

Et donem un cop de mà?Contactar amb suport