Generación Documento Equivalente POS (Archivo)
Desarrollando
POST
/api/pos/documents/{{tipoDocumento}}
TransmisiónPOS
Última modificación:2026-07-31 13:09:58
Descripción
transforma, numera, firma y envía a la DIAN. Si es aceptado y se solicita, se envía la
representación gráfica por correo al adquiriente.
Método y ruta
POST /api/pos/documents/{tipo}Content-Type: multipart/form-dataPath params
| Param | Tipo | Requerido | Descripción |
|---|---|---|---|
tipo | string | Sí | Tipo de documento: pos, nota-ajuste-credito o nota-ajuste-debito. |
Headers
| Header | Tipo | Requerido | Descripción |
|---|---|---|---|
x-user-id | integer | No | Identificador del usuario responsable de la emisión. |
Content-Type | string | Sí | multipart/form-data |
Tipos de documento
/{tipo} como en el campo tipoFactura:| Alias | Documento |
|---|---|
pos | Documento Equivalente Electrónico POS |
nota-ajuste-credito (o nota-ajuste) | Nota de Ajuste crédito |
nota-ajuste-debito | Nota de Ajuste débito |
Form data
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
file | file | Sí | Archivo del documento a emitir. |
companyId | integer | Sí | Identificador de la compañía emisora. |
prefijo | string | Sí | Prefijo de la numeración autorizada. |
numeroDocumento | integer | No | Consecutivo del documento. Si no se envía, se toma del rango autorizado. |
enviarCorreo | boolean | No | true para enviar la representación gráfica por correo. Default false. |
extensiones | object | No | Extensiones POS (ver sección de extensiones). |
Estructura Interna del File
Para la estructura del Json Original revisa el schema Documento Equivalente POS.
Ejemplo de respuesta · 200 Aceptado
{
"idDocumento": 20481,
"estado": 0,
"descripcion": "Documento validado por la DIAN",
"dianStatus": "true",
"cude": "9b1c3d4e5f60718293a4b5c6d7e8f901a2b3c4d5e6f708192a3b4c5d6e7f8012",
"prefijo": "PDE",
"numeroDocumento": "1024",
"qr": "https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=9b1c...",
"erroresDian": [],
"notificaciones": [],
"rutaContenedor": null,
"valorFirma": null
}Ejemplo de respuesta · 200 Rechazado por la DIAN
{
"idDocumento": 20482,
"estado": 0,
"descripcion": "Documento rechazado por la DIAN",
"dianStatus": "false",
"cude": "1a2b3c4d5e6f708192a3b4c5d6e7f8019b1c3d4e5f60718293a4b5c6d7e8f901",
"prefijo": "PDE",
"numeroDocumento": "1025",
"qr": null,
"erroresDian": ["Regla: FAJ01, Rechazo: ..."],
"notificaciones": ["Regla: FAJ48, Notificación: ..."],
"rutaContenedor": null,
"valorFirma": null
}Ejemplo de respuesta · 400 Solicitud inválida
{
"status": 400,
"error": "Bad Request",
"message": "Solicitud invalida",
"details": ["prefijo: El campo 'prefijo' es obligatorio"],
"correlationId": "b7f2c1a4-9e3d-4f18-8a52-1c0d6e9b4a77"
}Solicitud
Parámetros de Header
Parámetros del Body multipart/form-dataRequerido
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://{{ur_basel}}/api/pos/documents/{{tipoDocumento}}' \
--header 'x- user-id: 460' \
--form 'companyId="{{company_id}}"' \
--form 'prefijo="POSC"' \
--form 'numeroDocumento="1"' \
--form 'enviarCorreo="true"' \
--form 'file=@"C:\\Facturacion Electronica\\arqfe-module-orchestrator-pos\\ejemplos\\pos-nota-ajuste-credito-erp.json"'Respuesta Ejemplo de Respuesta
Ejemplo Error
{
"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-07-31 13:09:58