Habilitación Nomina
POST
/public/api/nomina/v1/hab-nomina-controller/send-nomina-hab
HabilitaciónNómina Electrónica
Última modificación:2026-09-16 15:04:45
Descripción
servicio envía el set de prueba correspondiente y devuelve el resultado, indicando si la
compañía quedó habilitada.
x-api-key y x-company-id.Método y ruta
POST /arqHabNominaController/process-habHeaders
| Header | Tipo | Requerido | Descripción |
|---|---|---|---|
x-api-key | string | Sí | Clave de acceso (API Key) de tu compañía. |
x-company-id | integer | Sí | Identificador de la compañía. |
Content-Type | string | No | application/json si envías cuerpo. |
Query params
| Param | Tipo | Requerido | Descripción |
|---|---|---|---|
test-id | string | No | Identificador del set de pruebas asignado por la DIAN. |
Body
Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
Errors | array<string> | Mensajes de error cuando la habilitación no fue exitosa. |
IsValid | boolean | true si la compañía quedó habilitada. |
ResultCode | integer | Código de resultado (ver tabla). |
Warning | array<string> | Advertencias no bloqueantes. |
ResultData | string | Resultado del procesamiento (respuesta de la DIAN o mensaje descriptivo). |
Códigos de resultado
El endpoint responde HTTP 200 en todos los casos; el resultado real viaja en ResultCode.
| ResultCode | HTTP | IsValid | Significado |
|---|---|---|---|
| 200 | 200 | true | Compañía habilitada (set de prueba aceptado por la DIAN). |
| 304 | 200 | false | El proceso finalizó sin lograr la habilitación (ver Errors). |
| 401 | 200 | false | Credenciales inválidas. |
| 500 | 200 | false | Error al procesar la habilitación. |
Ejemplos de respuesta
200 · Habilitada
{ "Errors": [], "IsValid": true, "ResultCode": 200, "Warning": [], "ResultData": "<respuesta de la DIAN>" }304 · No habilitada
{ "Errors": ["<mensaje de error de la DIAN>"], "IsValid": false, "ResultCode": 304, "Warning": [], "ResultData": "<respuesta de la DIAN>" }401 · Credenciales inválidas
{ "Errors": ["Credenciales inválidas para la compañía con ID: 1"], "IsValid": false, "ResultCode": 401, "Warning": [], "ResultData": "Credenciales inválidas para la compañía con ID: 1" }500 · Error interno
{ "Errors": [], "IsValid": false, "ResultCode": 500, "Warning": [], "ResultData": "Error en el proceso de Habilitación: <detalle>" }Solicitud
Parámetros de consulta
Parámetros de Header
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --globoff --request POST 'https://{{url_basel}}/public/api/nomina/v1/hab-nomina-controller/send-nomina-hab' \
--header 'x-api-key: {{api_key}}' \
--header 'x-company-id: {{company_id}}'Respuesta Ejemplo de Respuesta
{
"Errors": [
"string"
],
"IsValid": true,
"ResultCode": 0,
"Warning": [
"string"
],
"ResultData": "string"
}Modificado en 2026-09-16 15:04:45