Centro de Ayuda

Integración API DATAICO S.A.S

Nómina Electrónica.

Documentación Técnica de la API de DATAICO NÓMINA ELECTRÓNICA

Guía Práctica

Swagger (API Documentation): API DOCS Documentación Técnica de NE

Autentificación

Para la transmisión de NE, la API utiliza como método de autenticación el "Auth-token" de la cuenta DATAICO y los datos del “Software” (“pin", "dian-id"). Para obtener estos datos, sigue estos pasos:

Obtener "Auth-token"

Haz clic en las opciones en la parte superior / selecciona "Configuración".

“Software”

"software": {

"pin": "4123412",

"dian_id": "d0e88268-a4ab-447d-918c-19c1c248b5c3"

}

Nota: Los datos del “Software” no cambian, por lo tanto, se deben utilizar los mismos para todos los clientes.

Numeración

Para obtener los datos de tu numeración o consecutivo de tu nómina electrónica, sigue estos pasos:

Nómina / Configuración > Numeraciones

Tipos de conceptos

Devengados Salariales “amount”	Devengados No Salariales "amount-ns"
Devengados Salariales “amount”	Devengados No Salariales "amount-ns"
· BASICO	· VIATICO
· VIATICO	· BONIFICACION
· AUXILIO_DE_TRANSPORTE	· AUXILIO:
· BONIFICACION	· BONO_EPCTV
· AUXILIO	· DOTACION
· BONO_EPCTV	· APOYO_PRACTICA
· COMISION	· BONIFICACION_RETIRO
· PAGO_TERCERO	· INDEMNIZACION
· ANTICIPO	· VACACION_COMPENSADA
· TELETRABAJO	· PRIMA
· HORA_EXTRA_DIURNA	· CESANTIAS
· HORA_EXTRA_DIURNA_DF	· OTRO_CONCEPTO
· HORA_EXTRA_NOCTURNA
· HORA_EXTRA_NOCTURNA_DF
· HORA_RECARGO_DIURNA_DF
· HORA_RECARGO_NOCTURNO
· HORA_RECARGO_NOCTURNO_DF
· LICENCIA_PATERNIDAD
· LICENCIA_REMUNERADA
· VACACION
· PRIMA
· COMPENSACION
· INCAPACIDAD
· OTRO_CONCEPTO

Deducciones

· SALUD

· FONDO_PENSION

· FONDO_SOLIDARIDAD_PENSIONAL

· FONDO_SUBSISTENCIA

· SINDICATO

· PAGO_TERCERO

· ANTICIPO

· PENSION_VOLUNTARIA

· RETENCION_FUENTE

· AFC

· COOPERATIVA

· EMBARGO_FISCAL

· PLANES_COMPLEMENTARIOS

· EDUCACION

· REINTEGRO

· DEUDA

· OTRA_DEDUCCION

Creación de nómina electronica

Crear nómina electrónica (individual)

Método: POST

Endpoints (URL): https://api.dataico.com/direct/payroll-api/v2/payroll-entries

Headers

Content-type : application/json
Auth-token (Cuenta DATAICO)

Ejemplo configuración en Postman

Crear nómina electrónica (Por Lotes)

Método: POST

Endpoints (URL): https://api.dataico.com/direct/payroll-api/v2/payroll-entries-batch

Headers

Content-type: application/json
Auth-token (Cuenta DATAICO)

Ejemplo configuración en Postman

Estructura JSON

Recomendaciones claves

Elementos que no deben enviarse vacíos

Es importante tener en cuenta que no se pueden enviar variables opcionales con valores nulos o vacíos. Esto incluye campos como code, other-names, second-last-name, bank, account-type-kw, account-number y fire-date. Cuando se detecten valores vacíos, el sistema generará el siguiente mensaje: "El texto no puede ser vacío".

En caso de que un empleado no disponga de la información necesaria para asignar un valor a una variable, el sistema ERP no debe incluirlos en la estructura JSON que se enviará a través de la API v2.

Variables necesarias para la transmisión de la Nómina a la DIAN

Es imprescindible incluir la variable send_dian para indicar al sistema pueda transmitir el documento a la DIAN. Esta variable puede tener los valores true o false. A modo de ejemplo: ("send_dian": true).

Recursos Adicionales

+ API DOCS Documentación Técnica de NE
+ Guía de Solución de Problemas API DATAICO NÓMINA ELECTRÓNICA
+ Consultar nóminas por consecutivo
+ Crear nota de reemplazo
+ Crear nota de eliminación

Contacto

Si después de seguir estos pasos tienes alguna duda o encuentras algún problema, no dudes en ponerte en contacto con nuestro equipo de soporte a través de nuestro Chat 💬.