Descargar los documentos electrónicos de un comprobante

Descargar los archivos del comprobante electrónico de un empleado ante la DIAN.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

La respuesta es un archivo comprimido, no JSON.

Reglas de negocio

  • El uuid es el del documento dentro de una transmisión —el comprobante de un empleado en un periodo—, no el de la transmisión completa. Se obtiene del listado /nominaelectronica/{uuid}/detalles, en el campo uuid de cada fila.
  • Nómina no guarda estos archivos: los pide al proveedor de nómina electrónica y los reenvía tal cual. El contenido exacto del comprimido lo define ese proveedor.
  • Devuelve únicamente información de la organización asociada al token; no recibe identificador de compañía.
  • El servicio declara el tipo de contenido como multipart/form-data aunque entrega un archivo comprimido. Si su cliente valida el Content-Type antes de guardar, contemple ese valor.
  • Un 417 cubre dos situaciones distintas: que falle la consulta de ese comprobante, o que el proveedor de nómina electrónica no esté disponible. El código de error del cuerpo permite distinguirlas.
  • Si el uuid no corresponde a un documento existente, se responde 404.
Path Params
string
required
Headers
string
required

Bearer token para la autorización. Consulte la documentación inicial del módulo de nómina para obtener instrucciones sobre cómo generar el token de autenticación.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json