Crear Notas de Reemplazo por API
Crear notas de reemplazo (individual)
Método: POST
Endpoint: https://api.dataico.com/direct/payroll-api/v2/payroll-replacements
Headers
Content-type: application/jsonAuth-token: el token de tu cuenta Dataico o una llave API de tu empresa.
La respuesta trae la nota procesada, con los mismos campos que Consultar nota de reemplazo por API.
Crear notas de reemplazo (por lotes)
Método: POST
Endpoint: https://api.dataico.com/direct/payroll-api/v2/payroll-replacements-batch
Headers
Content-type: application/jsonAuth-token: el token de tu cuenta Dataico o una llave API de tu empresa.
El cuerpo del lote es {"entries": [ ... ]}. Todas las notas de un lote deben tener el mismo prefijo y pertenecer al mismo periodo.
El envío por lotes es asíncrono: responde 201 con un job-id y el resultado se consulta después. Ver Envío en bloque de nómina electrónica: respuesta asíncrona con job-id.
Estructura JSON
La nota de reemplazo lleva la nómina completa corregida, con la misma estructura de un documento de nómina (ver Documentación Técnica de la API de Nómina Electrónica), más la referencia al documento original en replacement-for:
"replacement-for": {
"cune": "<CUNE del documento original>",
"prefix": "N",
"number": 38,
"issue-date": "30/09/2026"
}
Ejemplos completos:
El esquema de cada campo está en el Swagger de la API v2.
Validaciones
- Numeración en producción. Con
"env": "PRODUCCION", el prefijo de la nota debe existir como numeración de notas de reemplazo. Si no existe, la respuesta es:¡El prefijo 'X' para nóminas de reemplazo no existe. Crearlo antes de continuar!. La numeración de notas se crea con el botón Agregar notas en Nómina > Configuración > Nómina Electrónica > Numeraciones. - Mismo empleado. La nota debe ser del mismo empleado (tipo y número de identificación) que el documento original. Si no lo es, la respuesta empieza por:
El número de identificación y tipo '...' '...' del empleado en su nota de reemplazo no es el mismo que el número de identificación del empleado en el documento original. - Modelo de empleado con fecha de vigencia. Si tu empresa usa este modelo, la API rechaza las notas de reemplazo. Ver Guía de errores de la API de Nómina Electrónica.
Recursos Adicionales
¿Este artículo te fue útil?