Saltar al contenido
Facturador

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.