[CO] API Invoice POST & GET Example

POST — New Invoice


{
  "e_invoice": true,
  "currency": "COP",
  "supplier_company_id": "{{owner_id}}",
  "invoice_date": "2025-12-31",
  "invoice_due_date": "2025-12-31",
  "document_type": "invoice",
  "invoice_type": "debit",
  "invoice_external_id": "{{invoice_external_id}}",
  "buyer": {
    "company": {
      "name": "Buyer Company",
      "legal_name": "Buyer Company S.A.S.",
      "email": "[email protected]",
      "type": "business",
      "address": {
        "address_line_1": "Cra 7 # 71-21",
        "city": "Bogotá",
        "state": "CO-DC",
        "country": "CO"
      },
      "tax_registrations": [
        {
          "number": "900123456",
          "type": "NIT",
          "status": "Régimen común",
          "level": "country",
          "location": "CO"
        }
      ]
    }
  },
  "items": [
    {
      "name": "Test Service",
      "amount": 100000,
      "quantity": 1,
      "description": "Servicio de prueba",
      "item_external_id": "{{item_external_id}}",
      "taxes": [
        {
          "name": "IVA",
          "type": "VAT",
          "rate": 0.19,
          "rate_type": "percentage",
          "amount": 19000,
          "level": "country",
          "location": "CO",
          "adds_to_final_amount": true
        }
      ]
    }
  ]
}

API GET Example


{
  "id": "9e4c89cc-19fd-4beb-97ee-f2677d6ca7e7",
  "created_at": "2024-12-04T15:02:41.638Z",
  "status": "created",
  "status_description": "The invoice is created.",
  "invoice_number": "FD 4569",
  "invoice_type": "debit",
  "document_type": "invoice",
  "invoice_due_date": "2024-12-25",
  "currency": "COP",
  "e_invoice": true,
  "invoice_external_id": "53858482cdvjb48h",
  "invoice_date": "2024-11-25T16:21:45.656Z",
  "payment_method": {
    "type": "bank transfer"
  },
  "supplier_company_id": "793fb02a-22fb-21b1-8056-80c2857456921",
  "additional_info": "Retenciones a practicar: Retención en la fuente 4%. Retención de ICA Bogotá 9.66x1000. ",
  "pdf_url": "https://brinta-prod-bucket.s3.amazonaws.com/invoice/invoice-45.pdf?AWSAccessKeyId=AKIA4MSMNXRGD7JTKPOD&Expires=1733498720&Signature=kCzKa88vPaR4IxlAre5pVmF9yZs%3D",
  "xml_url": "https://brinta-prod-bucket.s3.amazonaws.com/invoice/invoice-45.xml?AWSAccessKeyId=AKIA4MSMNXRGD7JTKPOD&Expires=1733498720&Signature=1DtvW92HfSubYD4CrM%2BIkgn02%2F0%3D",
  "buyer": {
    "company": {
      "id": "7961e94a-6cd7-4bdc-b059-374cca4972f0",
      "legal_name": "Cliente BRINTA S.A.",
      "type": "business",
      "address": {
        "country": "CO",
        "address_line_1": "SAN M 8 74",
        "state": "CO-DC",
        "city": "Bogotá"
      },
      "tax_registrations": [
        {
          "id": "3d18d846-bff7-4112-b725-6ddba080f8a8",
          "number": "9013834749",
          "type": "NIT",
          "level": "country",
          "location": "CO"
        }
      ]
    }
  },
  "items": [
    {
      "id": "c4d3bf87-d700-4958-b22c-6a5f709f1e9f",
      "item_external_id": "5569bv59c2cdvjb",
      "name": "Test Service",
      "amount": 1482000,
      "category": {
        "code": "43231512"
      },
      "taxes": [
        {
          "id": "c3a94c98-8ccd-4cea-8aec-72da46b60dbf",
          "amount": 281580,
          "name": "VAT",
          "rate": 0.19,
          "rate_type": "percentage",
          "description": "Impuesto sobre el valor agregado",
          "adds_to_final_amount": true
        }
      ]
    }
  ]
}

Did this page help you?