[PA] Invoice Payload Example

{
    "e_invoice": true,
    "currency": "USD",
    "supplier_company_id": "{{company_id}}",
    "invoice_date": "2026-01-01",
    "invoice_due_date": "2026-01-31",
    "document_type": "invoice",
    "invoice_type": "debit",
    "invoice_external_id": "{{invoice_external_id}}",
    "buyer": {
        "company": {
            "name": "Buyer Company",
            "legal_name": "Buyer Company Corp.",
            "email": "[email protected]",
            "type": "business",
            "address": {
                "address_line_1": "Ciudad de Panama",
                "city": "Ciudad de Panama",
                "state": "PA-8",
                "country": "PA"
            },
            "tax_registrations": [
                {
                    "number": "155986022-2-201912",
                    // The RUC with its dashes, followed by the 2-digit DV (check digit), e.g. RUC 155986022-2-2019 and DV 12 → 155986022-2-201912. See "Buyer RUC format" below
                    "type": "RUC",
                    "status": "active",
                    "location": "PA",
                    "level": "country"
                }
            ]
        }
    },
    "items": [
        {
            "name": "Generic service description for the applicable period",
            "amount": 100.00,
            "quantity": 1,
            "item_external_id": "{{item_external_id}}",
            "categories": [
                {
                    "code": "81"
                }
            ],
            "taxes": [
                {
                    "name": "ITBMS",
                    "type": "VAT",
                    "rate": 0.07,
                    "rate_type": "percentage",
                    "amount": 7.00
                },
                {
                    "name": "ITBMS",
                    "type": "VAT",
                    "rate": 0.07,
                    "rate_type": "percentage",
                    "withholding_type": "withholding",
                    "amount": 7.00
                }
            ]
        }
    ]
}

Buyer RUC format

When the buyer's address.country is PA, send the buyer's RUC in tax_registrations[].number with type = RUC (uppercase, exactly as written):

  • Keep the dashes of the RUC exactly as the DGI issued them. A RUC without dashes is rejected by the DGI.
  • Add the 2-digit DV (dígito verificador) at the end, with no space or dash in between. If the DV is lower than 10, include the leading zero (e.g. 05).
  • The DV is mandatory. Brinta takes the last 2 digits as the DV and sends the rest as the RUC, so a RUC sent without its DV is rejected by the DGI.
  • type of the buyer company must match the DGI registry: business for legal entities, person for natural persons.
TaxpayerRUCDVnumber to send
Natural person (cédula)8-100-678908-100-67890
Legal entity, registered since October 2014155986022-2-201912155986022-2-201912
Non-commercial entity, registered since October 201426631254-3-20207826631254-3-202078
Legal entity, registered before October 20144789-321-1515854789-321-151585

Reasons

You can send the type of transaction with the parameter invoice.reason

If not sent, the transaction will be 01 for invoice , ticket, credit note, debit note , and 02 for export

Reason codeDescription
01Sale
02Export
03Re-export
04Sale of foreign source
05Service of foreign source
10Transfer
11Return
12Consignation
13Remesa
14Free delivery
20Purchase
21Import

Did this page help you?