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.