Una Linea, Una Tarifa de IVA, Una Tarifa de IC

Método: POST
URL: https://apidian2024.oo/api/ubl2.1/invoice

PRIMER ENVIO DE FACTURA

• Si se instalo un dominio se debe utilizar de la siguiente manera:

http://midominio.com/api/ubl2.1/invoice

• Requiere un token de autorizacion el cual fue devuelto al realizar el Paso 1 - Config Company, si este token se extravio, se puede consultar en la tabla de la base de datos de la API en la tabla users, en el campo API_TOKEN.

• En URL el ultimo parametro corresponde al id del set de pruebas que la dian entrego al momento de registrar el modo de operacion software propio.

.../ubl2.1/invoice/iddelsetdepruebasdeladian

• Este endpoint se puede utilizar de dos modos:

1. Asincrono: .../ubl2.1/invoice/iddelsetdepruebasdeladian

2. Sincrono: .../ubl2.1/invoice

• El modo sincrono no afecta al set de pruebas, pero la respuesta de la DIAN incluye posibles errores de validacion y estado de la factura, valida o no valida.

• El modo asincrono, afecta el set de pruebas y en la respuesta no se incluye el resultado de la factura, solo se entrega un ZIP_KEY el cual debe ser consultado mediante el endpoint:

.../ubl2.1/status/zip

de la seccion 03 - Consultas de estado para asi poder establecer si la factura fue valida o no y los errores de validacion.

Autenticación

• Tipo: Bearer Token
• Header: Authorization: Bearer <TOKEN>

Headers

Key	Value
Content-Type	application/json
Accept	application/json

Body

{
  "number": 994551130,
  "type_document_id": 1,
  "date": "2025-12-03",
  "time": "04:08:12",
  "resolution_number": "18760000001",
  "prefix": "SETP",
  "customer": {
    "identification_number": "900428042",
    "name": "TAMPAC TECNOLOGÍA EN AUTOMATIZACIÓN SAS"
  },
  "payment_form": {
    "payment_form_id": 1,
    "payment_method_id": 30,
    "payment_due_date": "2026-09-03",
    "duration_measure": "30"
  },
  "legal_monetary_totals": {
    "line_extension_amount": 1000.0,
    "tax_exclusive_amount": 1000.0,
    "tax_inclusive_amount": 1270.0,
    "payable_amount": 1270.0
  },
  "tax_totals": [
    {
      "tax_id": 2,
      "tax_amount": 80.0,
      "taxable_amount": 1000.0,
      "is_fixed_value": true,
      "per_unit_amount": 80.0,
      "base_unit_measure": 1,
      "unit_measure_id": 94
    },
    {
      "tax_id": 1,
      "tax_amount": 190.0,
      "taxable_amount": 1000.0,
      "percent": 19.0
    }
  ],
  "invoice_lines": [
    {
      "unit_measure_id": 70,
      "invoiced_quantity": 1,
      "line_extension_amount": 1000.0,
      "free_of_charge_indicator": false,
      "description": "Gaseosa 350ml",
      "code": "50202301",
      "type_item_identification_id": 4,
      "price_amount": 1000.0,
      "base_quantity": 1,
      "tax_totals": [
        {
          "tax_id": 2,
          "tax_amount": 80.0,
          "taxable_amount": 1000.0,
          "is_fixed_value": true,
          "per_unit_amount": 80.0,
          "base_unit_measure": 1,
          "unit_measure_id": 94
        },
        {
          "tax_id": 1,
          "tax_amount": 190.0,
          "taxable_amount": 1000.0,
          "percent": 19.0
        }
      ]
    }
  ]
}

Ejemplo cURL

curl -X POST "https://apidian2024.oo/api/ubl2.1/invoice" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --data-raw '{
    "number": 994551130,
    "type_document_id": 1,
    "date": "2025-12-03",
    "time": "04:08:12",
    "resolution_number": "18760000001",
    "prefix": "SETP",
    "customer": {
        "identification_number": "900428042",
        "name": "TAMPAC TECNOLOGÍA EN AUTOMATIZACIÓN SAS"
    },
    "payment_form": {
        "payment_form_id": 1,
        "payment_method_id": 30,
        "payment_due_date": "2026-09-03",
        "duration_measure": "30"
    },
    "legal_monetary_totals": {
        "line_extension_amount": 1000.00,
        "tax_exclusive_amount": 1000.00,
        "tax_inclusive_amount": 1270.00,
        "payable_amount": 1270.00
    },
    "tax_totals": [
        {
            "tax_id": 2,
            "tax_amount": 80.00,
            "taxable_amount": 1000.00,
            "is_fixed_value": true,
            "per_unit_amount": 80.00,
            "base_unit_measure": 1,
            "unit_measure_id": 94
        },
        {
            "tax_id": 1,
            "tax_amount": 190.00,
            "taxable_amount": 1000.00,
            "percent": 19.00
        }
    ],
    "invoice_lines": [
        {
            "unit_measure_id": 70,
            "invoiced_quantity": 1,
            "line_extension_amount": 1000.00,
            "free_of_charge_indicator": false,
            "description": "Gaseosa 350ml",
            "code": "50202301",
            "type_item_identification_id": 4,
            "price_amount": 1000.00,
            "base_quantity": 1,
            "tax_totals": [
                {
                    "tax_id": 2,
                    "tax_amount": 80.00,
                    "taxable_amount": 1000.00,
                    "is_fixed_value": true,
                    "per_unit_amount": 80.00,
                    "base_unit_measure": 1,
                    "unit_measure_id": 94
                },
                {
                    "tax_id": 1,
                    "tax_amount": 190.00,
                    "taxable_amount": 1000.00,
                    "percent": 19.00
                }
            ]
        }
    ]
}'