Una Linea, Descuento Global, 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 <TOKEN>
Headers
| Key | Value |
|---|---|
Content-Type | application/json |
Accept | application/json |
Body
{
"billing_reference": {
"number": "SETP990000954",
"uuid": "baa5ea24ceafc503fe51bbb69364e8516322b8243788108ae55ae4c03c4b92a4188281895ec8993bc363faf38b74ec53",
"issue_date": "2024-02-20"
},
"discrepancyresponsecode": 2,
"discrepancyresponsedescription": "PRUEBA DE MOTIVO NOTA CREDITO",
"notes": "PRUEBA DE NOTA CREDITO",
"prefix": "NC",
"number": 71,
"type_document_id": 4,
"date": "2024-08-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": true,
"sendmailtome": true,
"seze": "2021-2017",
"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": 800135582,
"dv": 7,
"name": "FUNDACION ALEJANDRO LONDOÑO",
"phone": "3105193539",
"address": "CLL 4 NRO 33-90",
"email": "gerencia@torresoftware.com",
"merchant_registration": "0000000-00",
"type_document_identification_id": 6,
"type_organization_id": 1,
"type_liability_id": 117,
"municipality_id": 822,
"type_regime_id": 1
},
"allowance_charges": [
{
"discount_id": 1,
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "50000.00",
"base_amount": "1000000.00"
}
],
"legal_monetary_totals": {
"line_extension_amount": "840336.134",
"tax_exclusive_amount": "840336.134",
"tax_inclusive_amount": "1000000.00",
"allowance_total_amount": "50000.00",
"payable_amount": "950000.00"
},
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "159663.865",
"percent": "19",
"taxable_amount": "840336.134"
}
],
"credit_note_lines": [
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "840336.134",
"free_of_charge_indicator": false,
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "159663.865",
"taxable_amount": "840336.134",
"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": "1000000.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 '{
"billing_reference": {
"number": "SETP990000954",
"uuid": "baa5ea24ceafc503fe51bbb69364e8516322b8243788108ae55ae4c03c4b92a4188281895ec8993bc363faf38b74ec53",
"issue_date": "2024-02-20"
},
"discrepancyresponsecode": 2,
"discrepancyresponsedescription": "PRUEBA DE MOTIVO NOTA CREDITO",
"notes": "PRUEBA DE NOTA CREDITO",
"prefix": "NC",
"number": 71,
"type_document_id": 4,
"date": "2024-08-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": true,
"sendmailtome": true,
"seze": "2021-2017",
"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": 800135582,
"dv": 7,
"name": "FUNDACION ALEJANDRO LONDOÑO",
"phone": "3105193539",
"address": "CLL 4 NRO 33-90",
"email": "gerencia@torresoftware.com",
"merchant_registration": "0000000-00",
"type_document_identification_id": 6,
"type_organization_id": 1,
"type_liability_id": 117,
"municipality_id": 822,
"type_regime_id": 1
},
"allowance_charges": [
{
"discount_id": 1,
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "50000.00",
"base_amount": "1000000.00"
}
],
"legal_monetary_totals": {
"line_extension_amount": "840336.134",
"tax_exclusive_amount": "840336.134",
"tax_inclusive_amount": "1000000.00",
"allowance_total_amount": "50000.00",
"payable_amount": "950000.00"
},
"tax_totals":
[
{
"tax_id": 1,
"tax_amount": "159663.865",
"percent": "19",
"taxable_amount": "840336.134"
}
],
"credit_note_lines":
[
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "840336.134",
"free_of_charge_indicator": false,
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "159663.865",
"taxable_amount": "840336.134",
"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": "1000000.00",
"base_quantity": "1"
}
]
}'