How to print a customized ticket?
Send and print customized tickets on your Summit terminal
With this feature, you can send a customized ticket from your system to be displayed and printed directly on a Summit terminal using Billpocket’s service. You only need to specify the device’s serial number and define the ticket layout with the content you want to show.
What do you need to use it?
You must send a JSON request that includes:
- The terminal’s serial number (
serialNumber
) - The ticket structure (
ticketData
) - Optionally, a notification to be displayed beforehand (
showNotification
)
Available Fields
Field | Type | Required | Description |
---|---|---|---|
serialNumber | string | âś… Yes | Serial number of the Summit terminal where the ticket will be printed. |
showNotification | boolean | Optional | If set to true , the terminal will show a notification before opening the print app. Default value: false . |
notificationTitle | string | Only if showNotification = true | Notification title. Must be between 2 and 30 characters. |
notificationMessage | string | Only if showNotification = true | Notification message. Must be between 1 and 60 characters. |
ticketData | array of objects | âś… Yes | The content of the ticket to be printed. Composed of text , line , or column blocks. |
What can you display on the ticket?
Within the ticketData
field, you can combine different types of content:
1. Text (text
)
Prints a line of text. You can customize it with:
Size:
small
,normal
,big
Bold:: activar o no (
bold: true/false
)Alignment::
left
,center
,right
Example:
{"type": "text","value": "Pedidos para mesa 6","size": "big","bold": true,"align": "center"}
2. Line (line
)
Adds a visual separator line. It does not require additional content, just the type.
Example:
{"type": "line"}
3. Column (column
)
Prints a row with 2 or 3 columns. Useful for listing products, prices, totals, etc.
Example:
{"type": "column","value": ["Producto", "Precio", "Total"],"align": "center"}
Want to show a notification before printing?
You can enable this by using the showNotification
field.
If you send showNotification
: true
The terminal will display a popup notification with a title and message before opening the print app.
Required fields if notification is enabled:
Field | Description | Allowed length |
---|---|---|
notificationTitle | Title displayed in the notification | 2 to 30 characters |
notificationMessage | Message shown in the notification | 1 to 60 characters |
Recommendations
- Avoid sending duplicate tickets: You cannot overwrite a ticket that hasn’t been printed yet.
- Design your layout intentionally: Use lines and columns to ensure a clear and professional presentation.
- Prevent validation errors: Make sure you respect the character limits for notification fields.
What happens after sending the ticket?
A preview of the ticket will be shown on the terminal screen.
- The user can review it before printing.
- Upon pressing the “PRINT TICKET” button, the ticket is printed physically.
Possible Responses
Code | Meaning |
---|---|
201 | Ticket successfully sent |
400 | Bad Request |
401 | Unauthorized |
404 | Not found |
500 | Internal server error |