API Credit Notes Creation

Credit notes follow the same logic across all countries Brinta supports. A credit note is created by sending invoice_type: "credit" and referencing the original invoice being credited via original_invoice_id or original_invoice_external_id.

Referencing the Original Invoice

Field	Type	Required	When to use / Notes
`original_invoice_id`	string	One of `original_invoice_id` / `original_invoice_external_id` is required	ID of the invoice being credited, in Brinta's system.
`original_invoice_external_id`	string	See above	ID of the invoice being credited, in the client's system.

Origin Company — Multi-Company Hierarchies

If your organization issues invoices under multiple companies that belong to the same corporate group (e.g. different legal entities per country, or per business unit), the original invoice being credited may have been issued under a different company than the one authenticating the current request (the company holder of the token).

Use origin_company_id / origin_company_external_id to tell Brinta which company actually issued the original invoice, when it differs from the token holder.

Field	Type	Required	When to use / Notes
`origin_company_id`	string	Optional	Company id, in Brinta's system, of the supplier that issued the original invoice. Only send this when that supplier is different from the company holder of the token.
`origin_company_external_id`	string	Optional	Same as above, but using the company id in the client's system.

Rule of thumb: if the credit note is being issued by the same company that issued the original invoice, omit origin_company_id / origin_company_external_id entirely. Only send them when crediting across companies within your hierarchy.

Example — Credit note referencing an invoice from a different company in the same group

{
  "invoice_type": "credit",
  "document_type": "credit note",
  "currency": "COP",
  "e_invoice": true,
  "reason": "void",
  "original_invoice_external_id": "<original_invoice_external_id>",
  "supplier_company_id": "<supplier_company_id>",
  "origin_company_id": "<origin_company_id>"
}

In this example, supplier_company_id is the company issuing the credit note (and the one authenticating the request), while origin_company_id points to the company that issued the original invoice being credited.