Saltar al contenido
Facturador

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): 0 pendiente, 1 procesando, 2 impresa, 3 con error.

Errores:

  • 403 si la impresión local está activa y la terminal no está en la misma red.
  • 422 si 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.