¿Cómo imprimir un ticket personalizado?
Envía e imprime tickets personalizados en tu terminal Summit
Con esta funcionalidad puedes enviar desde tu sistema un ticket personalizado para que se muestre e imprima directamente en una terminal Summit mediante el servicio de Billpocket. Solo necesitas indicar el número de serie del dispositivo y definir el diseño del ticket con el contenido que desees mostrar.
¿Qué necesitas para usarlo?
Debes enviar una solicitud en formato JSON que incluya:
- El número de serie de la terminal (
serialNumber
) - La estructura del ticket (
ticketData
) - Opcionalmente, si deseas mostrar una notificación previa (
showNotification
)
Campos disponibles
Campo | Tipo | Obligatorio | Descripción |
---|---|---|---|
serialNumber | string | ✅ Sí | Número de serie de la terminal Summit donde se imprimirá el ticket. |
showNotification | boolean | Opcional | Si se envía como true , la terminal mostrará una notificación antes de abrir la app de impresión. Valor por defecto: false . |
notificationTitle | string | Solo si showNotification = true | Título de la notificación. Debe tener entre 2 y 30 caracteres. |
notificationMessage | string | Solo si showNotification = true | Mensaje de la notificación. Debe tener entre 1 y 60 caracteres. |
ticketData | array de objetos | ✅ Sí | Contenido del ticket a imprimir. Se compone de bloques de tipo text , line o column . |
¿Qué puedes mostrar en el ticket?
Dentro del campo ticketData
, puedes combinar distintos tipos de contenido:
1. Texto (text
)
Imprime una línea de texto. Puedes personalizarla con:
Tamaño:
small
,normal
,big
Negrita: activar o no (
bold: true/false
)Alineación:
left
,center
,right
Ejemplo:
{"type": "text","value": "Pedidos para mesa 6","size": "big","bold": true,"align": "center"}
2. Línea (line
)
Agrega una línea visual que actúa como separador. No requiere ningún contenido adicional, solo el tipo.
Ejemplo:
{"type": "line"}
3. Columnas (column
)
Imprime una fila con 2 o 3 columnas. Puedes mostrar listas de productos, precios, totales, etc.
Ejemplo:
{"type": "column","value": ["Producto", "Precio", "Total"],"align": "center"}
¿Quieres mostrar una notificación antes de imprimir?
Puedes hacerlo con el campo showNotification
.
Si envías showNotification
: true
- La terminal mostrará una notificación emergente con título y mensaje antes de abrir la app de impresión.
Campos obligatorios si activas la notificación:
Campo | Descripción | Longitud permitida |
---|---|---|
notificationTitle | Título que se mostrará en la notificación | 2 a 30 caracteres |
notificationMessage | Mensaje que se mostrará en la notificación | 1 a 60 caracteres |
Recomendaciones
- No repitas tickets activos: No se puede sobrescribir un ticket que aún no ha sido impreso.
- Diseña tu layout con intención: Usa líneas y columnas para una presentación clara y profesional.
- Evita errores de validación: Asegúrate de cumplir con los límites de caracteres para los campos de notificación.
¿Qué pasa al enviar el ticket?
Se muestra una previsualización del ticket en la pantalla de la terminal.
- El usuario puede revisarlo antes de imprimir.
- Al presionar el botón de “IMPRIMIR TICKET”, se imprime en físico.
Respuestas posibles
Código | Significado |
---|---|
201 | Ticket enviado correctamente |
400 | Error en la solicitud (validación) |
401 | No autorizado |
404 | Terminal no encontrada |
500 | Error interno del servidor |