Saltar al contenido principal

Descargar documento de un eCMR

GET 
/ecmr/documents/:service_code/:document_id

Propósito​

Descarga un documento concreto asociado al eCMR y lo entrega como stream binario.

Objetivo​

Permitir a usuarios autorizados recuperar el archivo original almacenado en el sistema de ficheros.

Casos de uso​

  • Descargar una factura adjunta al eCMR.
  • Obtener un justificante para revisión interna.
  • Integrar la descarga en cliente web o móvil autenticado.

Flujo de validación​

flowchart TD
  A[Recibir GET /ecmr/documents/:service_code/:document_id] --> B{¿Usuario autenticado?}
  B -->|No| C[401 NO_TOKEN_OR_APIKEY]
  B -->|Sí| D[Resolver usuario, compañía y eCMR]
  D --> E[Buscar documento por document_id]
  E --> F[Solicitar archivo a storage]
  F -->|Existe| G[200 application/octet-stream]
  F -->|No existe| H[404 File not found]
  E -->|Error interno| I[500 INTERNAL_ERROR]

Detalles técnicos​

El endpoint localiza el documento por document_id dentro del eCMR y delega la entrega a storage (s3Tools.getFile). La respuesta exitosa no usa wrapper JSON, sino application/octet-stream.

Autenticación​

Soporta JWT Bearer token y API Key.

Request​

Responses​

Documento descargado correctamente

Response Headers