Nota Credito ICL
Endpoint
- Método: POST
- Ruta:
/api/ubl2.1/credit-note - URL ejemplo:
{{BASE_URL}}/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 {{API_TOKEN}}
Headers
| Key | Value |
|---|---|
Content-Type | application/json |
Accept | application/json |
Body
- Modo:
raw
{
"billing_reference": {
"number": "SETP990001109",
"uuid": "858813ba65240e31fc5f808ff51465f605a0c143d6c50a324b6c89978db8fcd93660f6b5eeb4fb61229d627b40334bb4",
"issue_date": "2024-06-28"
},
"discrepancyresponsecode": 2,
"discrepancyresponsedescription": null,
"notes": "Devolución Contado Automatico a documento SETP990001109",
"prefix": "NC",
"number": 95,
"type_document_id": 4,
"date": "2024-06-28",
"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
},
"legal_monetary_totals": {
"line_extension_amount": "17820.00",
"tax_exclusive_amount": "17820.00",
"tax_inclusive_amount": "33245.00",
"allowance_total_amount": null,
"charge_total_amount": null,
"payable_amount": "33245.00"
},
"type_operation_id": null,
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "891.00",
"percent": "5.00",
"taxable_amount": "17820.00",
"unit_measure_id": null,
"per_unit_amount": null,
"base_unit_measure": null
},
{
"tax_id": 19,
"tax_amount": "14534.00",
"percent": "0",
"taxable_amount": "0",
"unit_measure_id": "70",
"per_unit_amount": null,
"base_unit_measure": null
}
],
"credit_note_lines": [
{
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "891.0000",
"percent": "5.00",
"taxable_amount": "17820.00",
"unit_measure_id": null,
"per_unit_amount": null,
"base_unit_measure": null
},
{
"tax_id": 19,
"tax_amount": "14534.00",
"percent": "0",
"taxable_amount": "0",
"unit_measure_id": "70",
"per_unit_amount": "1.00",
"base_unit_measure": "14534"
}
],
"unit_measure_id": 1076,
"invoiced_quantity": "1.00",
"line_extension_amount": "17820.00",
"free_of_charge_indicator": false,
"description": "LDM AGUARDIENTE CAÑO CRISTALES 750 CC BOTELLA ",
"notes": "",
"code": "LDM001005",
"type_item_identification_id": 4,
"price_amount": "17820.00",
"base_quantity": "1"
}
]
}
Ejemplo cURL
curl \
-X POST \
"{{BASE_URL}}/api/ubl2.1/credit-note" \
-H "Authorization: Bearer {{API_TOKEN}}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data '{
"billing_reference": {
"number": "SETP990001109",
"uuid": "858813ba65240e31fc5f808ff51465f605a0c143d6c50a324b6c89978db8fcd93660f6b5eeb4fb61229d627b40334bb4",
"issue_date": "2024-06-28"
},
"discrepancyresponsecode": 2,
"discrepancyresponsedescription": null,
"notes": "Devolución Contado Automatico a documento SETP990001109",
"prefix": "NC",
"number": 95,
"type_document_id": 4,
"date": "2024-06-28",
"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
},
"legal_monetary_totals": {
"line_extension_amount": "17820.00",
"tax_exclusive_amount": "17820.00",
"tax_inclusive_amount": "33245.00",
"allowance_total_amount": null,
"charge_total_amount": null,
"payable_amount": "33245.00"
},
"type_operation_id": null,
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "891.00",
"percent": "5.00",
"taxable_amount": "17820.00",
"unit_measure_id": null,
"per_unit_amount": null,
"base_unit_measure": null
},
{
"tax_id": 19,
"tax_amount": "14534.00",
"percent": "0",
"taxable_amount": "0",
"unit_measure_id": "70",
"per_unit_amount": null,
"base_unit_measure": null
}
],
"credit_note_lines": [
{
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "891.0000",
"percent": "5.00",
"taxable_amount": "17820.00",
"unit_measure_id": null,
"per_unit_amount": null,
"base_unit_measure": null
},
{
"tax_id": 19,
"tax_amount": "14534.00",
"percent": "0",
"taxable_amount": "0",
"unit_measure_id": "70",
"per_unit_amount": "1.00",
"base_unit_measure": "14534"
}
],
"unit_measure_id": 1076,
"invoiced_quantity": "1.00",
"line_extension_amount": "17820.00",
"free_of_charge_indicator": false,
"description": "LDM AGUARDIENTE CAÑO CRISTALES 750 CC BOTELLA ",
"notes": "",
"code": "LDM001005",
"type_item_identification_id": 4,
"price_amount": "17820.00",
"base_quantity": "1"
}
]
}'