Descargar el PDF de una factura
Descripción
Este endpoint permite descargar el archivo PDF de una factura previamente registrada en el sistema.
Para acceder al recurso, debes proporcionar el identificador de la factura y un token Bearer válido.
Endpoint
GET /invoive/:ID/pdf
Reemplaza :ID por el identificador de la factura que deseas descargar.
Autenticación
Este endpoint requiere autenticación mediante un token Bearer.
Incluye el siguiente encabezado en la solicitud:
Authorization: Bearer TU_TOKEN
Parámetros de la solicitud
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
ID |
integer |
Sí | Identificador de la factura cuyo PDF deseas descargar. |
Ejemplo de solicitud
GET /invoive/177/pdf
Authorization: Bearer TU_TOKEN
Respuesta
Si la solicitud se procesa correctamente, el servidor devuelve el archivo PDF de la factura para su descarga.
La respuesta normalmente contiene los siguientes encabezados:
| Encabezado | Descripción |
|---|---|
Content-Type |
Indica el tipo de contenido. Para un archivo PDF, el valor esperado es application/pdf. |
Content-Disposition |
Puede indicar si el archivo debe descargarse como adjunto y especificar su nombre. |
El contenido de la respuesta es el archivo PDF, no un objeto JSON.
Consideraciones importantes
- Debes incluir un token Bearer válido en el encabezado
Authorization. - El identificador proporcionado debe corresponder a una factura existente y accesible para el usuario autenticado.
- Si la factura no existe o no tienes permiso para acceder a ella, el servidor puede devolver un error HTTP.
- El archivo PDF se recibe como contenido binario y puede guardarse o abrirse con un lector de PDF.