AddToBatch Credit Note

Endpoint

• Método: POST
• Ruta: /api/ubl2.1/add-to-batch/credit-note/{batch_id}
• URL ejemplo: {{BASE_URL}}/api/ubl2.1/add-to-batch/credit-note/batch1

Descripción

Agrega una Nota Crédito al lote (batch) indicado en la URL. Luego podrás enviarlo con SendBatch.

Flujo recomendado:

1. Llama este endpoint por cada documento que quieras agregar al lote.
2. Cuando completes el lote, ejecuta SendBatch.

Parámetros en la URL

• batch_id: identificador del lote. Ejemplo: batch1.

Autenticación

• Tipo: Bearer Token
• Header: Authorization: Bearer {{API_TOKEN}}

Headers

Key	Value
Authorization	Bearer {{API_TOKEN}}
Accept	application/json
Content-Type	application/json

Body

{
  "billing_reference": {
    "number": "990010016",
    "uuid": "31fb5b49826c9ee845f9cb3c8f52b3d96d98ccdc2732e2063273836b634f26f9df9d26cf83dfbc045751c8d445ee3277",
    "issue_date": "2020-07-30"
  },
  "discrepancyresponsecode": 2,
  "discrepancyresponsedescription": "PRUEBA DE MOTIVO NOTA CREDITO",
  "number": 754,
  "type_document_id": 4,
  "date": "2020-07-30",
  "time": "06:00:13",
  "customer": {
    "identification_number": 900166483,
    "dv": 1,
    "name": "INVERSIONES DAVAL SAS",
    "phone": 3103891693,
    "address": "CLL 4 NRO 33-90",
    "email": "alexanderobandolondono@gmail.com",
    "merchant_registration": "0000000-00",
    "type_document_identification_id": 6,
    "type_organization_id": 1,
    "municipality_id": 822,
    "type_regime_id": 1
  },
  "tax_totals": [
    {
      "tax_id": 1,
      "tax_amount": "0.00",
      "taxable_amount": "0.00",
      "percent": "0.00"
    }
  ],
  "legal_monetary_totals": {
    "line_extension_amount": "45000.00",
    "tax_exclusive_amount": "0",
    "tax_inclusive_amount": "45000.00",
    "allowance_total_amount": "0",
    "charge_total_amount": "0.00",
    "payable_amount": "45000.00"
  },
  "credit_note_lines": [
    {
      "unit_measure_id": 70,
      "invoiced_quantity": "1",
      "line_extension_amount": "45000.00",
      "free_of_charge_indicator": false,
      "allowance_charges": [
        {
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL",
          "amount": "0.00",
          "base_amount": "45000.00"
        }
      ],
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": "0.00",
          "taxable_amount": "0.00",
          "percent": "0.00"
        }
      ],
      "description": "PRUEBA NOTA CONTABLE ELECTRONICA",
      "code": "001NOTA",
      "type_item_identification_id": 4,
      "price_amount": "45000",
      "base_quantity": "1"
    }
  ]
}

Ejemplo cURL

curl -X POST '{{BASE_URL}}/api/ubl2.1/add-to-batch/credit-note/batch1' \
  -H 'Authorization: Bearer {{API_TOKEN}}' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "billing_reference": {
    "number": "990010016",
    "uuid": "31fb5b49826c9ee845f9cb3c8f52b3d96d98ccdc2732e2063273836b634f26f9df9d26cf83dfbc045751c8d445ee3277",
    "issue_date": "2020-07-30"
  },
  "discrepancyresponsecode": 2,
  "discrepancyresponsedescription": "PRUEBA DE MOTIVO NOTA CREDITO",
  "number": 754,
  "type_document_id": 4,
  "date": "2020-07-30",
  "time": "06:00:13",
  "customer": {
    "identification_number": 900166483,
    "dv": 1,
    "name": "INVERSIONES DAVAL SAS",
    "phone": 3103891693,
    "address": "CLL 4 NRO 33-90",
    "email": "alexanderobandolondono@gmail.com",
    "merchant_registration": "0000000-00",
    "type_document_identification_id": 6,
    "type_organization_id": 1,
    "municipality_id": 822,
    "type_regime_id": 1
  },
  "tax_totals": [
    {
      "tax_id": 1,
      "tax_amount": "0.00",
      "taxable_amount": "0.00",
      "percent": "0.00"
    }
  ],
  "legal_monetary_totals": {
    "line_extension_amount": "45000.00",
    "tax_exclusive_amount": "0",
    "tax_inclusive_amount": "45000.00",
    "allowance_total_amount": "0",
    "charge_total_amount": "0.00",
    "payable_amount": "45000.00"
  },
  "credit_note_lines": [
    {
      "unit_measure_id": 70,
      "invoiced_quantity": "1",
      "line_extension_amount": "45000.00",
      "free_of_charge_indicator": false,
      "allowance_charges": [
        {
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL",
          "amount": "0.00",
          "base_amount": "45000.00"
        }
      ],
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": "0.00",
          "taxable_amount": "0.00",
          "percent": "0.00"
        }
      ],
      "description": "PRUEBA NOTA CONTABLE ELECTRONICA",
      "code": "001NOTA",
      "type_item_identification_id": 4,
      "price_amount": "45000",
      "base_quantity": "1"
    }
  ]
}'