ReferenciaActualizado 9 de octubre de 2026
Consultar Nómina por API
Consultar nóminas por consecutivo
Método: GET
Endpoint: https://api.dataico.com/direct/payroll-api/v2/payroll-entries/{prefijo}/{número}
Ejemplo: https://api.dataico.com/direct/payroll-api/v2/payroll-entries/N/38
Params (opcionales)
| Parámetro | Valor de ejemplo | Qué hace |
|---|---|---|
include-pdf |
true |
Incluye el PDF del documento en el campo pdf. |
regenerate-pdf |
true |
Vuelve a generar el PDF y lo incluye en el campo pdf. |
Headers
Content-type: application/jsonAuth-token: el token de tu cuenta Dataico o una llave API de tu empresa.
Respuesta
| Campo | Contenido |
|---|---|
cune |
Código Único de Nómina Electrónica. |
number |
Prefijo y número del documento (por ejemplo, N38). |
dian_status |
Estado del documento ante la DIAN. |
email_status |
Estado del envío por correo al empleado. |
dian_messages |
Mensajes que devolvió la DIAN. |
qrcode |
Contenido del código QR. |
request_xml |
XML enviado a la DIAN, en base64. |
response_xml |
Respuesta de la DIAN, en base64. |
pdf |
El PDF, solo si pediste include-pdf=true o regenerate-pdf=true. |
Si no hay un documento con ese prefijo y número, la respuesta es HTTP 404:
{ "message": "El documento consultado no puede ser encontrado. Si acaba de ser enviado, debe esperar que el procesamiento termine." }
Revisa el prefijo y el número. Si enviaste el documento en un lote, espera a que el lote termine de procesarse antes de consultarlo.
Recursos Adicionales
¿Este artículo te fue útil?