¿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`.

Para conocer más acerca de los campos requeridos, consulta nuestra documentación técnica.

¿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

Si se envía como false (valor por defecto), la app se abrirá directamente sin mostrar notificación.

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

¿Cómo imprimir un ticket personalizado?

¿Qué necesitas para usarlo?#

Campos disponibles#

¿Qué puedes mostrar en el ticket?#

1. Texto (text)#

2. Línea (line)#

3. Columnas (column)#

¿Quieres mostrar una notificación antes de imprimir?#

Recomendaciones#

¿Qué pasa al enviar el ticket?#

Respuestas posibles#

¿Qué necesitas para usarlo?

Campos disponibles

¿Qué puedes mostrar en el ticket?

1. Texto (`text`)

2. Línea (`line`)

3. Columnas (`column`)

¿Quieres mostrar una notificación antes de imprimir?

Recomendaciones

¿Qué pasa al enviar el ticket?

Respuestas posibles