NC Una Linea, Sin Descuentos, Una Tarifa de IVA
Método: POST
URL: http://apidian2024.oo/api/ubl2.1/credit-note
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:
-
Asincrono: .../ubl2.1/invoice/iddelsetdepruebasdeladian
-
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 {{vault:BearerBuho}}
Headers
| Key | Value |
|---|---|
Content-Type | application/json |
Accept | application/json |
Body
{
"is_eqdoc": true,
"billing_reference": {
"number": "EPOS50",
"uuid": "88e34e23097d0d06c0176061bfb22c645725e57b51705a74dd3e8d4268d2ded15d9396a38dde54023b8f435333ca102e",
"issue_date": "2025-11-20",
"type_document_id": 15
},
"resolution_number": "20",
"discrepancyresponsecode": 2,
"notes": "PRUEBA DE NOTA CREDITO A DOCUMENTO EQUIVALENTE POS",
"prefix": "NCP",
"number": 1355,
"type_document_id": 26,
"date": "2025-12-05",
"time": "06:00:13",
"establishment_name": "TORRE SOFTWARE",
"establishment_address": "BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2",
"establishment_phone": "3226563672",
"establishment_municipality": 600,
"sendmail": false,
"sendmailtome": false,
"head_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
"foot_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
"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": "15966.386",
"percent": "19",
"taxable_amount": "84033.614"
}
],
"legal_monetary_totals": {
"line_extension_amount": "84033.614",
"tax_exclusive_amount": "84033.614",
"tax_inclusive_amount": "100000.00",
"payable_amount": "100000.00"
},
"credit_note_lines": [
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "84033.614",
"free_of_charge_indicator": false,
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "15966.386",
"taxable_amount": "84033.614",
"percent": "19.00"
}
],
"description": "COMISION POR SERVICIOS",
"notes": "ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.",
"code": "COMISION",
"type_item_identification_id": 4,
"price_amount": "100000.00",
"base_quantity": "1"
}
]
}
Ejemplo cURL
curl -X POST "http://apidian2024.oo/api/ubl2.1/credit-note" \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data-raw '{
"is_eqdoc": true,
"billing_reference": {
"number": "EPOS50",
"uuid": "88e34e23097d0d06c0176061bfb22c645725e57b51705a74dd3e8d4268d2ded15d9396a38dde54023b8f435333ca102e",
"issue_date": "2025-11-20",
"type_document_id": 15
},
"resolution_number": "20",
"discrepancyresponsecode": 2,
"notes": "PRUEBA DE NOTA CREDITO A DOCUMENTO EQUIVALENTE POS",
"prefix": "NCP",
"number": 1355,
"type_document_id": 26,
"date": "2025-12-05",
"time": "06:00:13",
"establishment_name": "TORRE SOFTWARE",
"establishment_address": "BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2",
"establishment_phone": "3226563672",
"establishment_municipality": 600,
"sendmail": false,
"sendmailtome": false,
"head_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
"foot_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
"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": "15966.386",
"percent": "19",
"taxable_amount": "84033.614"
}
],
"legal_monetary_totals": {
"line_extension_amount": "84033.614",
"tax_exclusive_amount": "84033.614",
"tax_inclusive_amount": "100000.00",
"payable_amount": "100000.00"
},
"credit_note_lines":
[
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "84033.614",
"free_of_charge_indicator": false,
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "15966.386",
"taxable_amount": "84033.614",
"percent": "19.00"
}
],
"description": "COMISION POR SERVICIOS",
"notes": "ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.",
"code": "COMISION",
"type_item_identification_id": 4,
"price_amount": "100000.00",
"base_quantity": "1"
}
]
}'