Consultar Nómina por API
Documentación Técnica de la API de DATAICO NÓMINA ELECTRÓNICA
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
Si tienes dudas, escríbenos por el chat de soporte dentro de tu cuenta de Dataico. Lo encuentras en la burbuja de la esquina inferior derecha de la pantalla.