Descargar PDF
GET /api/document-file/{print_model}/{document_external_id}/{print_format}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Devuelve el PDF de un documento en el formato pedido (lo genera si aún no existe en ese formato). Es el mismo enlace que llega en data_ws.pdf_a4_filename al emitir.
⚠️ Este endpoint usa GET por compatibilidad; próximamente tendrá una versión POST.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). No se restringe por vendedor: cualquier usuario puede operar sobre cualquier registro de la empresa.
Formato de respuesta: archivo (PDF, XML, ZIP, Excel o texto), no JSON. application/pdf (inline).
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
print_model (ruta) |
string | Sí | document comprobante electrónico (factura, boleta, notas), dispatch guía de remisión, saleNote nota de venta, quotation cotización, income ingreso, expense gasto. Para notas de venta usa salenote. |
document_external_id (ruta) |
string (uuid) | Sí | external_id del documento. |
print_format (ruta) |
string | Sí | a4, a5, ticket (80 mm), ticket_58 (58 mm). |
Errores: 500 {success: false, message} si el external_id no existe para ese modelo.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
print_model |
ruta | sí | document |
|
document_external_id |
ruta | sí | `` | |
print_format |
ruta | sí | a4 |
Respuestas
200 — PDF
%PDF-1.4
%... (contenido binario del PDF) ...
%%EOF
500 — No existe
{
"success": false,
"message": "El código 9b2f6c1e-7a44-4d0b-9a55-0f3c2a1d8e77 es inválido, no se encontro documento relacionado"
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.