Skip to main content

Una Linea, Sin Descuentos, Una Tarifa de IVA Copy

Método: POST
URL: http://apidian2024.oo/api/ubl2.1/eqdoc

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

KeyValue
Content-Typeapplication/json
Acceptapplication/json

Body

{
"number": 503,
"type_document_id": 15,
"date": "2024-05-28",
"time": "04:08:12",
"postal_zone_code": "630003",
"resolution_number": "18760000001",
"prefix": "EPOS",
"notes": "ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA",
"sendmail": true,
"sendmailtome": true,
"foot_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
"software_manufacturer": {
"name": "ALEXANDER OBANDO LONDONO",
"business_name": "TORRE SOFTWARE",
"software_name": "BABEL"
},
"buyer_benefits": {
"code": "89008003",
"name": "INVERSIONES DAVAL SAS",
"points": "100"
},
"cash_information": {
"plate_number": "DF-000-12345",
"location": "HOTEL OVERLOOK RECEPCION",
"cashier": "JACK TORRANCE",
"cash_type": "CAJA PRINCIPAL",
"sales_code": "EPOS1",
"subtotal": "1000000.00"
},
"customer": {
"identification_number": 89008003,
"dv": 2,
"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,
"type_liability_id": 7,
"municipality_id": 822,
"type_regime_id": 1
},
"payment_form": {
"payment_form_id": 1,
"payment_method_id": 30,
"payment_due_date": "2024-05-28",
"duration_measure": "0"
},
"legal_monetary_totals": {
"line_extension_amount": "840336.134",
"tax_exclusive_amount": "840336.134",
"tax_inclusive_amount": "1000000.00",
"payable_amount": "1000000.00"
},
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "159663.865",
"percent": "19.00",
"taxable_amount": "840336.134"
}
],
"invoice_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/eqdoc" \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data-raw '{
"number": 503,
"type_document_id": 15,
"date": "2024-05-28",
"time": "04:08:12",
"postal_zone_code": "630003",
"resolution_number": "18760000001",
"prefix": "EPOS",
"notes": "ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA, ESTA ES UNA NOTA DE PRUEBA",
"sendmail": true,
"sendmailtome": true,
"foot_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL PIE DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
"software_manufacturer":{
"name": "ALEXANDER OBANDO LONDONO",
"business_name": "TORRE SOFTWARE",
"software_name": "BABEL"
},
"buyer_benefits":{
"code": "89008003",
"name": "INVERSIONES DAVAL SAS",
"points": "100"
},
"cash_information":{
"plate_number": "DF-000-12345",
"location": "HOTEL OVERLOOK RECEPCION",
"cashier": "JACK TORRANCE",
"cash_type": "CAJA PRINCIPAL",
"sales_code": "EPOS1",
"subtotal": "1000000.00"
},
"customer": {
"identification_number": 89008003,
"dv": 2,
"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,
"type_liability_id": 7,
"municipality_id": 822,
"type_regime_id": 1
},
"payment_form": {
"payment_form_id": 1,
"payment_method_id": 30,
"payment_due_date": "2024-05-28",
"duration_measure": "0"
},
"legal_monetary_totals": {
"line_extension_amount": "840336.134",
"tax_exclusive_amount": "840336.134",
"tax_inclusive_amount": "1000000.00",
"payable_amount": "1000000.00"
},
"tax_totals":
[
{
"tax_id": 1,
"tax_amount": "159663.865",
"percent": "19.00",
"taxable_amount": "840336.134"
}
],
"invoice_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"
}
]
}'

Probar endpoint

POST
Enviar Documento Equivalente
BASE URL
Se guarda localmente en tu navegador.
BEARER TOKEN
Se guarda solo en esta sesión/pestaña.
URL FINAL
/api/ubl2.1/eqdoc
BODY JSON
RESPUESTA
Envía la solicitud para ver la respuesta aquí.