Saltar al contenido
Facturador

Vista de impresión HTML

GET /api/document-print-pdf/{print_model}/{document_external_id}/{print_format}/{extend_pdf_height}

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Devuelve la plantilla de impresión en HTML (no un PDF) de un comprobante o nota de venta, con estilos @media print ajustados al ancho del ticket. Pensado para imprimir directamente desde una app o navegador.

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. text/html.

Campo Tipo Obligatorio Descripción / valores permitidos
print_model (ruta) string Sí document (comprobante) o saleNote (nota de venta).
document_external_id (ruta) string (uuid) Sí external_id del documento.
print_format (ruta) string Sí a4, a5, ticket (ancho 78 mm), ticket_58 (56 mm).
extend_pdf_height (ruta) integer No Píxeles de alto adicionales al final (margen para el corte del papel). Puedes omitir el segmento; por defecto 0.

Errores: 500 {success: false, message} si el external_id no existe.

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
extend_pdf_height ruta sí 0

Respuestas

200 — HTML

<!DOCTYPE html><html><head><style> @media print { ... width: 78mm !important;} ...</style></head><body>... F001-1520 ...<div style='height:40px'></div></body></html>

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.