Habilitación Documento Equivalente POS
Desarrollando
POST
/api/pos/habilitacion
Última modificación:2026-09-16 15:04:52
Descripción
cantidad de documentos solicitada en ambiente de pruebas y reporta cuántos fueron aceptados y si la compañía quedó habilitada.
Método y ruta
POST /api/pos/habilitacionQuery params
| Param | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
companyId | integer | Sí | — | Identificador de la compañía a habilitar. |
cantidad | integer | No | 1 | Cantidad de documentos de prueba a enviar. |
testId | string | No | — | Identificador del set de pruebas asignado por la DIAN. |
Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
companyId | integer | Compañía procesada. |
solicitados | integer | Documentos de prueba solicitados. |
aceptados | integer | Documentos aceptados por la DIAN. |
rechazados | integer | Documentos rechazados por la DIAN. |
habilitado | boolean | true si la compañía quedó habilitada. |
mensaje | string | Mensaje descriptivo del resultado. |
detalle | array<string> | Detalle por documento (CUDE, estado y errores). |
Ejemplo · 200 Habilitación satisfactoria
{
"companyId": 1,
"solicitados": 1,
"aceptados": 1,
"rechazados": 0,
"habilitado": true,
"mensaje": "Habilitación satisfactoria: 1 documento(s) aceptado(s).",
"detalle": ["CUDE 9b1c3d4e... — aceptado"]
}Ejemplo · 200 No habilitada
{
"companyId": 1,
"solicitados": 1,
"aceptados": 0,
"rechazados": 1,
"habilitado": false,
"mensaje": "No habilitado: ningún documento fue aceptado.",
"detalle": ["CUDE 1a2b3c4d... — rechazado: Regla FAJ01 ..."]
}Solicitud
Parámetros de consulta
Parámetros de Header
Parámetros del Body multipart/form-dataRequerido
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --globoff --request POST 'https://{{url_basel}}/api/pos/habilitacion?companyId={{company_id}}&testId=undefined' \
--header 'user-id: {{user-id}}'Respuesta Ejemplo de Respuesta
{
"idDocumento": 1234621,
"estado": 0,
"descripcion": "Documento rechazado por la DIAN",
"dianStatus": "false",
"cude": "ba81423b9053eba2c610b2ee4c92f27a258fc6c7ae2558f2676e2d1e0b872f87177e855ef7f67ec104e60bcd8de60e01",
"prefijo": "EPOS",
"numeroDocumento": "1",
"qr": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=ba81423b9053eba2c610b2ee4c92f27a258fc6c7ae2558f2676e2d1e0b872f87177e855ef7f67ec104e60bcd8de60e01",
"rutaContenedor": null,
"valorFirma": null,
"erroresDian": [
"Regla: DEAD06, Rechazo: Valor del CUDE no está calculado correctamente.Regla: DEAB12b, Rechazo: Valor final del rango de numeración informado no corresponde a un valor final de los rangos vigentes para el contribuyente emisor.Regla: DEAJ73, Notificación: Estructura código no válidaRegla: DEAJ30, Notificación: Este código no corresponde a un valor correcto de la listaRegla: DEAJ10, Notificación: El nombre no corresponde un valor válido de la lista"
]
}Modificado en 2026-09-16 15:04:52