In order to create a new colombian credit note, you need to use the /documents endpoint with the proper parameters.

reference_number should be the document that you are cancelling

​
Endpoint: https://api.userow.com/billing/V1/documents

  • Method: POST
  • Required headers:
  • Content-Type: application/json
  • Authorization: Bearer <token>
  • Accept: */*
{
  "header": {
    "account_id": 39,
    "document_type_id": "83",
    "received_issued_flag": 0,
    "issue_date": "2025-01-14",
    "issuer_tax_id_code": "860517022-2",
    "issuer_tax_id_type": "CO-NIT",
    "issuer_legal_name": "<string>",
    "issuer_address": "<string>",
    "issuer_district": "<string>",
    "issuer_city": "<string>",
    "issuer_country_id": "66",
    "issuer_phone": "<string>",
    "issuer_activity": "<string>",
    "receiver_tax_id_code": "860517022-2",
    "receiver_tax_id_type": "CO-NIT",
    "receiver_legal_name": "ESCUELA KEMPER URGATE",
    "receiver_address": "<string>",
    "receiver_district": "<string>",
    "receiver_city": "Bogota, D.C.",
    "receiver_country_id": "66",
    "receiver_phone": "<string>",
    "receiver_activity": "<string>",
    "payment_conditions": "0",
    "currency_id": 28
  },
  "details": [
    {
      "quantity": 1,
      "line_description": "Prueba ROW",
      "unit_measure": "70",
      "unit_price": 1500,
      "long_description": "Esta es una linea de prueba",
      "modifier_amount": -100,
      "total_taxes": 266,
      "modifier_percentage": 0,
      "total_amount_line": 1666,
      "taxes": [
        {
          "tax_type_id": "387",
          "tax_percentage": 19,
          "tax_amount": 266
        }
      ]
    }
  ],
  "references": [
    {
        "reference_type": "9eb81ec3d9bb363763d63865794ed934df2affee6f17b5acfe891d47ea5592523f5d97dea607b27445ab47d9011dc57c",
        "reference_number": "SETT1040108",
        "reference_code": 1,
        "description": "Anulacion solicitada por el emisor",
        "reference_date": "2025-01-14"
    }
  ],
  "totals": {
    "net_amount": 1400,
    "taxes_amount": 266,
    "total_amount": 1666
  }
}

API Reference POST /documents

Detailed endpoint documentation

➕ Create a new invoice➕ Create a new debit note