Registrar orden de impresión
POST /api/print-orders
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Envía un documento (PDF en base64) a la cola del servicio de impresión local del restaurante. Si no indicas impresora se usa la predeterminada.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado sin envoltura: devuelve directamente el objeto o arreglo (sin success). En el éxito devuelve 201 con la orden creada (sin success).
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
name_printer |
string | No | Nombre de la impresora (máx. 255). Vacío = impresora predeterminada. |
pdf_b64 |
string | Sí en la práctica | Contenido del PDF en base64. |
client_public_ip |
string | Sí si la impresión local está activa | IP pública de la terminal. Con impresión local activa debe coincidir con la del servicio de impresión. |
Reglas:
- Estados de la orden (
status):0pendiente,1procesando,2impresa,3con error.
Errores:
403si la impresión local está activa y la terminal no está en la misma red.422si no se indicó impresora y no hay una predeterminada (o falla la validación).
Cuerpo
Content-Type: application/json
{
"name_printer": "COCINA-01",
"pdf_b64": "JVBERi0xLjcKJcfsj6IK...",
"client_public_ip": "190.12.34.56"
}
Respuestas
201 — Encolada
{
"name_printer": "COCINA-01",
"pdf_b64": "JVBERi0xLjcKJcfsj6IK...",
"status": 0,
"updated_at": "2026-11-07T19:10:00.000000Z",
"created_at": "2026-11-07T19:10:00.000000Z",
"id": 88
}
422 — Sin impresora
{
"success": false,
"message": "No hay impresoras configuradas. Configure una impresora predeterminada en el servicio de impresión."
}
403 — Otra red
{
"success": false,
"message": "Impresión local activa: esta terminal no está en la red del servicio de impresión."
}
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.