Generación Documento Equivalente POS (Archivo)

Descripción

Emite un Documento Equivalente POS o su nota de ajuste a partir de un archivo. El documento se
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-data

Path 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

Los siguientes alias se usan tanto en la ruta /{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"
}

curl --location --globoff 'https://{{url_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"'

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

Descripción#

Método y ruta#

Path params#

Headers#

Tipos de documento#

Form data#

Estructura Interna del File#

Ejemplo de respuesta · 200 Aceptado#

Ejemplo de respuesta · 200 Rechazado por la DIAN#

Ejemplo de respuesta · 400 Solicitud inválida#

Solicitud

Respuestas