Generación Documento Equivalente POS (Body)

Descripción

Emite un Documento Equivalente POS autenticado por API Key, recibiendo el documento en el
cuerpo de la petición. Equivale al endpoint anterior, pero orientado a integraciones que
envían el documento como texto JSON en lugar de un archivo.

Autenticación por API Key mediante el header x-api-key, validado contra la compañía indicada
en companyId.

Método y ruta

POST /api/pos/documents/send-public-key

Headers

Header	Tipo	Requerido	Descripción
`x-api-key`	string	Sí	Clave de acceso (API Key) de tu compañía.
`Content-Type`	string	Sí	`application/json`

Body

Campo	Tipo	Requerido	Descripción
`companyId`	integer	Sí	Identificador de la compañía emisora.
`prefijo`	string	Sí	Prefijo de la numeración autorizada.
`jsonOriginal`	string	Sí	Documento a emitir, como texto.
`numero`	integer	No	Consecutivo del documento. Si no se envía, se toma del rango autorizado.
`tipoFactura`	string	No	Tipo de documento. Default `pos`. Un valor no reconocido se trata como `pos`.
`enviarCorreo`	boolean	No	`true` para enviar la representación gráfica por correo.
`extensiones`	object	No	Extensiones POS (ver sección de extensiones).
`id`	integer	No	Identificador de referencia del sistema origen.
`tipoData`	string	No	Campo de compatibilidad.
`estado`	integer	No	Campo de compatibilidad.
`programa`	string	No	Campo de compatibilidad.
`procesar`	boolean	No	Campo de compatibilidad.
`generaNumeroFactura`	boolean	No	Campo de compatibilidad.

Ejemplo de body

{
  "companyId": 1,
  "prefijo": "PDE",
  "numero": 1024,
  "tipoFactura": "pos",
  "enviarCorreo": true,
  "jsonOriginal": "{ ... documento ... }",
  "extensiones": {
    "codigoComprador": "C-001",
    "nombresApellidos": "JUAN PEREZ",
    "puntos": "120",
    "placaCaja": "CAJA-01",
    "ubicacionCaja": "Sede Norte",
    "cajero": "MARIA GOMEZ",
    "tipoCaja": "Registradora",
    "codigoVenta": "V-9981",
    "subTotal": "10000.00"
  }
}

Estructura Json Original

Para la estructura del Json Original revisa el schema Documento Equivalente POS.

Respuesta

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"
}

Si la API Key es inválida, la respuesta es HTTP 403 sin cuerpo.

curl --location --globoff 'https://{{url_basel}}/api/pos/documents/send-public-key' \ --header 'x-api-key: {{api_key}}' \ --header 'Content-Type: application/json' \ --data-raw '{ "companyId": {{company_id}}, "prefijo": "NDPOS", "tipoFactura": "nota-ajuste-debito", "enviarCorreo": false, "numero": 2, "jsonOriginal": "{\"documento\":{\"prefijo\":\"NDPOS\",\"numeroDocumento\":\"1\",\"numeroAutorizacion\":\"18760000001\",\"fechaInicioNumeracion\":\"2019-01-19\",\"fechaFinNumeracion\":\"2030-01-19\",\"numeracionDesde\":\"1\",\"numeracionHasta\":\"1000\",\"tipoDocumento\":\"20\",\"tipoOperacion\":\"20\",\"subTipoDocumento\":\"95\",\"fechaEmision\":\"\",\"horaEmision\":\"\",\"moneda\":\"COP\",\"idDocReferencia\":\"66aca71aecce50a47e9ec880d38aa788d09c3b65157508c65b7ad7070f1bcb6c0c0dc295c3df5bcaa43543305ef25ace\",\"numDocReferencia\":\"EPOS2\",\"notificaciones\":[{\"tipo\":1,\"valor\":[\"brayancl@arqs.com\"]}],\"formaPago\":[{\"tipoPago\":1,\"codigoMedio\":\"10\",\"notas\":[\"46700.00\"]},{\"tipoPago\":1,\"codigoMedio\":\"49\",\"notas\":[\"46700.00\"]}],\"beneficiosComprador\":{\"codigo\":\"0\",\"nombresApellidos\":\"Brayan Cañas\",\"puntos\":\"0\"},\"cajaVenta\":{\"placaCaja\":\"CAJA-01\",\"ubicacionCaja\":\"Bogotá, D.C.\",\"cajero\":\"Cajero POS\",\"tipoCaja\":\"POS\",\"codigoVenta\":\"42\",\"subTotal\":\"46700.00\"},\"folio\":\"e1fda47e-634b-f111-a8bd-e43a6e80e855\",\"idCia\":\"1\",\"documentosAfectados\":[{\"numeroDocumento\":\"EPOS2\",\"UUID\":\"66aca71aecce50a47e9ec880d38aa788d09c3b65157508c65b7ad7070f1bcb6c0c0dc295c3df5bcaa43543305ef25ace\",\"fechaEmision\":\"2026-07-24\",\"codigoCausal\":\"1\",\"observaciones\":[\"Ajuste por mayor valor facturado\"]}],\"notas\":[\"Nota de ajuste debito al documento equivalente POS EPOS1\"]},\"adquiriente\":{\"identificacion\":\"1193238697\",\"tipoIdentificacion\":\"13\",\"razonSocial\":\"Brayan Cañas\",\"nombreSurcusal\":\"CONSUMIDOR FINAL\",\"correo\":\"brayancl@arqs.com\",\"telefono\":\"57\",\"tipoPersona\":\"2\",\"responsabilidadesRUT\":[\"R-99-PN\"],\"ubicacion\":{\"pais\":\"CO\",\"ciudad\":\"Bogotá, D.C.\",\"departamento\":\"11001\",\"direccion\":\"57\"}},\"totales\":{\"valorBruto\":43714.81,\"valorCargos\":0.0,\"valorDescuentos\":0.0,\"valorTotalSinImpuestos\":37314.81,\"valorTotalConImpuestos\":46700.0,\"valorNeto\":46700.0},\"detalles\":[{\"tipoDetalle\":1,\"valorCodigoInterno\":\"40401920\",\"codigoEstandar\":\"EA\",\"valorCodigoEstandar\":\"40401920\",\"descripcion\":\"GRA MAR SEN GRA 450\",\"unidades\":1.0,\"unidadMedida\":\"94\",\"valorUnitarioBruto\":16700.0,\"valorBruto\":15462.96,\"tributos\":[{\"id\":\"04\",\"nombre\":\"INC\",\"esImpuesto\":true,\"valorImporte\":1237.04,\"valorBase\":15462.96,\"porcentaje\":8.0}],\"guidMovimiento\":\"d1fda47e-634b-f111-a8bd-e43a6e80e853\"},{\"tipoDetalle\":1,\"valorCodigoInterno\":\"40402276\",\"codigoEstandar\":\"EA\",\"valorCodigoEstandar\":\"40402276\",\"descripcion\":\"PASTEL CARNE BROWN\",\"unidades\":1.0,\"unidadMedida\":\"94\",\"valorUnitarioBruto\":11500.0,\"valorBruto\":10648.15,\"tributos\":[{\"id\":\"04\",\"nombre\":\"INC\",\"esImpuesto\":true,\"valorImporte\":851.85,\"valorBase\":10648.15,\"porcentaje\":8.0}],\"guidMovimiento\":\"c2558f86-634b-f111-a8bd-e43a6e80e853\"},{\"tipoDetalle\":1,\"valorCodigoInterno\":\"40402049\",\"codigoEstandar\":\"EA\",\"valorCodigoEstandar\":\"40402049\",\"descripcion\":\"AMERICANO EXTGRA 400\",\"unidades\":1.0,\"unidadMedida\":\"94\",\"valorUnitarioBruto\":12100.0,\"valorBruto\":11203.7,\"tributos\":[{\"id\":\"04\",\"nombre\":\"INC\",\"esImpuesto\":true,\"valorImporte\":896.3,\"valorBase\":11203.7,\"porcentaje\":8.0}],\"guidMovimiento\":\"75a2bdb1-634b-f111-a8bd-e43a6e80e853\"},{\"tipoDetalle\":1,\"valorCodigoInterno\":\"40351702\",\"codigoEstandar\":\"EA\",\"valorCodigoEstandar\":\"40351702\",\"descripcion\":\"AGUA CRISTAL CON GAS\",\"unidades\":1.0,\"unidadMedida\":\"94\",\"valorUnitarioBruto\":6400.0,\"valorBruto\":6400.0,\"tributos\":[],\"guidMovimiento\":\"74bb37c1-634b-f111-a8bd-e43a6e80e853\"}],\"tributos\":[{\"id\":\"04\",\"nombre\":\"INC\",\"esImpuesto\":true,\"valorImporteTotal\":2985.19,\"detalles\":[{\"valorImporte\":1237.04,\"valorBase\":15462.96,\"porcentaje\":8.0},{\"valorImporte\":851.85,\"valorBase\":10648.15,\"porcentaje\":8.0},{\"valorImporte\":896.3,\"valorBase\":11203.7,\"porcentaje\":8.0}]}],\"versionIntegrador\":\"1.0.8.6 cude\",\"cufeIntegrador\":\"eba892d941b1d4e9e5d94d9980aed529258e5ae7aaf9fd3f0772d1abcda0e9b07b7c24bcb586289b6b0dfee999c94c8d\"}" }'

{ "idDocumento": 1234643, "estado": 0, "descripcion": "Documento rechazado por la DIAN", "dianStatus": "false", "cude": "546cfb2d45db7498347c579ce4da14d16b407ff3a7b84e11a8b8d9ff3a70ddcfd97de4c2952424dc973e483af35b3d32", "prefijo": "EPOS", "numeroDocumento": "1", "qr": "https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=546cfb2d45db7498347c579ce4da14d16b407ff3a7b84e11a8b8d9ff3a70ddcfd97de4c2952424dc973e483af35b3d32", "rutaContenedor": null, "valorFirma": null, "erroresDian": [ "" ] }

Descripción#

Método y ruta#

Headers#

Body#

Ejemplo de body#

Estructura Json Original#

Respuesta#

Ejemplo de respuesta · 200 Aceptado#

Ejemplo de respuesta · 200 Rechazado por la DIAN#

Ejemplo de respuesta · 400 Solicitud inválida#

Solicitud

Respuestas