¿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

CampoTipoObligatorioDescripción
serialNumberstring✅ SíNúmero de serie de la terminal Summit donde se imprimirá el ticket.
showNotificationbooleanOpcionalSi se envía como true, la terminal mostrará una notificación antes de abrir la app de impresión. Valor por defecto: false.
notificationTitlestringSolo si showNotification = trueTítulo de la notificación. Debe tener entre 2 y 30 caracteres.
notificationMessagestringSolo si showNotification = trueMensaje de la notificación. Debe tener entre 1 y 60 caracteres.
ticketDataarray 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:

CampoDescripciónLongitud permitida
notificationTitleTítulo que se mostrará en la notificación2 a 30 caracteres
notificationMessageMensaje que se mostrará en la notificación1 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ódigoSignificado
201Ticket enviado correctamente
400Error en la solicitud (validación)
401No autorizado
404Terminal no encontrada
500Error interno del servidor