This guide helps when an order sent from the till does not print in the kitchen or bar, products or preparation instructions are missing from the receipt, or the printout is incorrect. In Vektori, an order printed for the kitchen is called a kitchen receipt. Checks are carried out on the printer, in the till application and in Vektori Cloud. This guide applies to troubleshooting an already configured kitchen printer.
Cloud path: Vektori Cloud → Settings → Till → Kitchen printers.
Till path: Till → Functions → Settings → Kitchen printers.
If the kitchen printer has not yet been configured in the cloud and on the till, start with the guide Setting up kitchen printing.
Before reprinting: check with the kitchen that the order has not already arrived. The print indicator on the sales line, which may appear as an x or a cross, does not by itself prove that the paper was printed. Inform the kitchen about any possible reprint.
Select the section that matches your problem
- Nothing prints in the kitchen
- Products are missing or the new printout is blank
- A preparation instruction or other text is missing
- The same order prints several times
- Text is cut off or the receipt layout is incorrect
- The problem continues after the checks
Nothing prints in the kitchen
- Check the printer’s power, paper, cover and any error message.
- Open Till → Functions → Settings → Kitchen printers. Check that the correct printer is enabled.
- If the printer is missing from the till, open Vektori Cloud → Settings → Till → Kitchen printers and check the correct workspace and location. On the till, select Functions → Update products and check the printer list again.
- On the till, open the Configure function for the correct printer and select Test print, if available. Check whether the printout comes from the correct device.
If the test print is unsuccessful, check the details for the connection method in use below. If the test print is successful but the order does not print, continue to Products are missing or the new printout is blank. A test print does not yet show that the products in the order belong to this printer or that the order is sent as expected.
Check the connection method in use
Check the printer type and connection details under Vektori Cloud → Settings → Till → Kitchen printers. Till-specific settings can be found under Till → Functions → Settings → Kitchen printers → Configure for the relevant printer. Use only the check that corresponds to your connection method.
- Sunmi Cloud: check the printer’s internet connection and the correct serial number. Open Vektori Cloud → Settings → Till → Printer integrations and check the connection status of the Sunmi Cloud printer integration. Sunmi Cloud is a cloud connection; a Sunmi-branded device alone does not mean that this connection method is in use.
- ESC/POS LAN/WiFi: check the printer’s current IP address and port, as well as the till’s connection to the printer’s network. The default port is 9100, but use the device’s configuration. Also check the address in the till’s Configure view: the till-specific setting may differ from the default saved in the cloud.
- ESC/POS USB: check the USB connection and the USB identifier of the selected device. The cloud field is USB identifier (VID:PID or path).
- ESC/POS Bluetooth: check the device’s Bluetooth connection and the correct Bluetooth address / MAC.
If you do not know the printer model or the connection method in use, find out from the person responsible for setting up the device. Do not change the connection method or cloud integration credentials by trial and error.
Products are missing or the new printout is blank
Use these checks when only some products print, a reprint is blank, or the test print is successful but the order does not print.
- Check the product groups. Open Vektori Cloud → Settings → Till → Kitchen printers and the details for the relevant printer. Compare the Product groups selected for the printer with the group of the missing product. The kitchen and bar may receive different products.
- Check products without a group. If a product has no group, check Print products without a product group in the Configure view for the relevant kitchen printer on the till. A product without a group being omitted does not alone indicate a connection problem.
- Check whether the line has already been printed. Print only new lines leaves lines that have already been printed out of the next printout. Check the print indicator on the sales line. Follow the reprint instructions at the beginning of the page before sending a new printout.
- Check the sending method. Parking prints only when Print when parking is enabled for the printer. Printing when payment is made depends on the till setting Print kitchen receipt when paying. To send manually, tap the sales line and select Print → Print kitchen receipt.
A preparation instruction or other text is missing from the kitchen receipt
On the till, check that the message was added in the correct place before sending the order.
- If the instruction applies to one product, tap the correct sales line and select Line text. Check that the preparation instruction is shown below that product.
- If the message applies to the entire kitchen receipt, open Receipt text from the sales line menu and check the field Add text to kitchen receipt. The customer receipt field is separate; text entered there does not replace the message intended for the kitchen.
- If you use a ready-made text template, that is, a till receipt template, make sure that you have selected it for the relevant sale and in the correct field. Saving the template to the cloud does not automatically add it to a sale.
If the product itself is also missing from the kitchen receipt, first check the product groups in the previous section. Adding text alone does not send the order to the kitchen. Agree with the kitchen on how to correct an order that has already been sent before reprinting.
The same order prints several times
- Check whether the same order is sent both manually and automatically when parking or paying.
- In the Configure view for the correct kitchen printer, check whether Print only new lines is enabled.
- Check that the same physical printer has not accidentally been configured as several enabled printers.
Text is cut off or the kitchen receipt layout is incorrect
Check the paper width and command language appropriate for the device. The cloud defaults can be found under Vektori Cloud → Settings → Till → Kitchen printers in the details for the relevant printer. Also check the till-specific settings under Till → Functions → Settings → Kitchen printers → Configure.
Defaults configured in the cloud can be specified further for each till. Do not select the StarPRNT command language just to test it if the printer uses the ESC/POS language.
If the problem continues after the checks
If the checks for your symptoms do not resolve the problem, send a support request. Tell Support:
- the printer make and model, connection method, till device and till version number
- the location and the exact time of the problem
- whether the entire printout, a specific product or text is missing, whether the order prints repeatedly, or whether the layout is incorrect
- whether the test print is successful and whether a print indicator is shown on the sales line
- whether you sent the order manually, by parking or by paying, and the checks you performed and their results.
Do not include application keys or other secret credentials in the support description.
Comments
0 comments
Please sign in to leave a comment.