Configuration and Settings:
- To set up the merchant logo on receipts, the recommended size is 512x512 pixels in JPEG format. You need to upload the logo image in the Back Office under Settings > Hardware > Print Template and save the changes.
- Ensure your POS system and printer are on the same network. Sometimes, even on the same Wi-Fi, different access points can cause issues.
- Setting a static IP address for the printer is recommended for stability. If using dynamic IP, it may change after restarting the printer, requiring updates in the software.
- Check if the POS device's network settings (IP address, subnet mask, gateway) match the printer's settings. If the POS uses Wi-Fi and the printer uses LAN, they need to be in the same IP range (e.g., 192.168.x.x).
- Confirm the correct printer connection method (USB/Network/Bluetooth) is configured. USB connection is generally more stable than Bluetooth.
- Ensure the printer driver is installed correctly.
- Verify the correct printer model is selected and paired in the POS settings. For non-Sunmi built-in printers, you might need to select "Other" and connect via LAN or USB.
- It is suggested to configure LAN printers to one main POS device. Other devices (like ordering tablets) can route print jobs through this main device. Configuring the same printer on multiple devices can lead to duplicate printing.
- If tablet devices need to print bills/receipts directly, the printer needs to be configured on that tablet too. However, some printer models might not support connections to multiple devices.
- Connecting fewer than 5 printers per POS device is recommended for performance and stability. You can distribute printers across different devices.
- Check if the correct print template and content settings are complete, such as merchant information.
- For Epson printers, selecting "Graphic mode" might be necessary for correct printing. However, in one case, "Graphic" mode only printed a line, while "Text" mode printed, but with alignment issues. Epson printers might prevent font size adjustment.
- Adjusting print resolution (e.g., from 300 DPI to 180 DPI) can affect print quality and content display.
- Paper width setting (e.g., 58mm/80mm) must match the actual paper roll. An 80mm setting was reported to have incorrect format, while 58mm worked. For an 80mm printer, asking for 17 letters per line was considered possible.
- You can adjust the alignment of prepared receipts in the Back Office print template editor.
- Control which remarks/add-ons appear on temporary receipts through the Back Office print template settings.
- Cash drawers typically connect to the main POS or a printer. They usually open automatically for cash transactions without extra software settings when connected to the main POS. The signal sometimes goes through the printer. Updating the APK version might resolve cash drawer issues. Sunmi cash drawers are expected to receive signals from the printer.
- If using receipt printers on multiple workstations, the "Print receipt from other devices" setting should be turned off to prevent printing the same order receipt repeatedly.
- Manage which specific products/modifiers print to specific kitchen printers in the POS Back Office or settings. If a whole category is assigned, new products auto-bind; if products in a category go to different printers, manual binding is needed. Excluded products may not print to that printer.
- Disabling printing on payment terminals (like PAX) can be done by deleting the printer configuration or not inserting paper. Not inserting paper might cause the terminal to report an error and stop the transaction.
- For Kiosks with built-in printers running Android virtual machines on Windows, the printer might not be recognized. Switching to a different emulator (like Bliss OS) was suggested and worked for one customer.
- For print stability, having all printers and POS devices on the same local network with static IPs is recommended.
Issues and Bugs:
- Printer disconnection: USB or Bluetooth printers randomly disconnect, requiring a device or printer restart to reconnect. This issue occurred with various brands and devices. It might be related to network or WebSocket connections. Clearing app data/cache will erase printer settings.
- Duplicate Printing: Printers repeatedly printing old orders, sometimes from previous days, especially during settlement. May be linked to the "Print retry" feature or the software sending print tasks multiple times.
- Specific items not printing: Certain items (like Seared scallops) not printing to the assigned kitchen printer despite correct configuration, although they appear on KDS. Resolved by removing and re-adding the item to the printer configuration.
- Automatic printing failure: Test pages print fine, but automatic printing (e.g., on order creation or after payment) doesn't trigger. Could be due to network issues causing WebSocket disconnections or a problem in specific versions.
- Cross-device printing conflicts/issues: After configuring a printer to the main POS, other tablets cannot print bills/receipts directly, showing connection errors. This might be because the printer model doesn't support multiple device connections or devices are competing for the connection.
- Printing delays: Significant delays (e.g., 40 seconds) observed when printing settlement receipts from the main cash register. May occur when the system is busy.
- No printing after adding discounts: Receipts not printing after a discount is added. Developers stated discounts should not affect printing.
- Cash drawer issues: Workstations connected to an Elys Hub could not open the cash box automatically, requiring connection to a printer. An APK update resolved the issue.
- Report printing issues: System freezing or buttons getting stuck when generating daily reports. Unable to print shift reports, causing the application to exit. Shift reports printing with garbled characters.
Feature Requests / Development Pipeline:
- Printing and Receipt Customization:
- Display card payment price (distinguishing from cash price) on order receipts and payment devices/POS screens. Order receipts currently do not support adding card payment prices.
- Show automatic service fees (Gratuity) and tips separately on receipts. Currently shown as "Tips". This feature is under development.
- Allow tip selection before payment (on tablet or card reader). Currently, tip selection is done after payment. Kiosk needs tip selection before swiping, but this requires significant changes and time.
- Print checkout receipts only when needed, not automatically. Can currently disable auto-printing and print manually from records. This feature is under development.
- Tip amount needs to be displayed on the receipt.
- Remove the tip section on cash payment receipts.
- Display the bill number on automatically printed receipts.
- Allow tablets to connect directly to printers for printing bills/receipts (like temporary receipts) instead of routing through the main POS. The ability to send print commands to multiple distributed printers (e.g., 3 scattered printers) is desired. Currently supports single-point printing.
- Control which remarks/add-ons are displayed on temporary receipts.
- Simplify receipt layout for better understanding and clarity.
- Support two-color printing (e.g., red for modifiers/remarks) on Star printers. Currently unsupported, requires SDK integration and development.
- Option to select a printer via a pop-up window for printing. This is not currently supported and has been relayed to the team.
- Print receipts for Void and Refund transactions. This is a priority development item.
- Provide a function to print a receipt for signature (for manual tip addition by the customer).
- Option to skip generating a receipt altogether if the customer doesn’t need one. This is not currently available but can be enhanced in the future.
- Add an option to add an item to an order without sending it to the kitchen (for corrections, etc.). Not available currently, can be enhanced in future.
- Add the business name and a continuous serial number to the end-of-shift report. This is very similar to the required Z report format.
- Reporting and Data:
- The Back Office should have settings to assign newly added items to specific printers.
- Ability to view USB and Ethernet printer settings in the Back Office.
- Integrate the daily settlement report (Z report) to be more structured, including detailed transaction elements (like authorization code, card type, etc.). Needs formatting optimization for thermal printers (compact, right-aligned, separators, character width), support for Hebrew, PDF export, and customizable elements (merchant name, cashier name, shift info, currency symbol).
- Hardware and Integration:
- Connect weighing devices.
- Recommend sticky label printers for cups (Xprinter Label Printer suggested).
- Other:
- Ability to log in regardless of network range (offline mode) to potentially resolve WebSocket issues and improve print stability. Offline mode is under development.