Skip to main content
Every order placed on storekit is sent to Comtrex as a new guest check the moment it’s paid. The check carries each product and modifier by POS ID, the table number for dine-in, the sales type you configured, any discount, tip or service charge, an order note, and a payment line so the check is already settled on the till.

How an Order Reaches the Till

1

Order placed

The customer pays. storekit queues the order for dispatch straight away — you don’t have to accept it in the dashboard first.
2

Check built

storekit builds a CreateNewOrder request for the till from the order, using the settings in Order handling and Media mapping.
3

Sent to the Comtrex server

The request is posted to the server address you configured. Each attempt waits up to two minutes for a reply, and storekit retries automatically if the server doesn’t respond or returns an error.
4

Result recorded

If the till accepts, the order shows as Accepted in Orders and the till’s guest check number is stored on it as the POS receipt. If the till refuses, or can’t be reached after the retries, the order is marked as failed and you’re notified — see When an order fails.
If the guest has already opened their table’s bill in storekit (pay at table) and then orders more, storekit adds the items to that Comtrex check instead of opening a new one. Orders placed without an open bill in storekit always open a new check — a check staff opened on the till isn’t picked up automatically. See Pay at Table.

What’s on the Check

A tip and a service charge on the same order both go into the check’s service charge lines, and the tip line replaces the service charge line. If you take both, ask storekit support about the right configuration for your till before going live.
Cash orders are also sent with a storekit payment line for the full total. If you’d rather cash orders stay open on the till for staff to settle, contact storekit support.

Order Handling Settings

Go to Stores → your store → SettingsIntegrationsComtrex and scroll to Order handling. Click Save after changing anything here.
The Order handling section showing the disabled Buffer Orders toggle, Send Gratuity Amount switched on, the Order Note Template editor with Insert Variable and Preview buttons, and Cover Count set to Automatic (number of diners)

The Order handling section

Buffer Orders

The Buffer Orders toggle is shown but disabled for Comtrex — you can’t change it from the dashboard. Scheduled orders are instead handled by the till itself as Comtrex future orders (below). If you need storekit to hold scheduled orders back until nearer the time, contact storekit support to have buffering configured.

Send Gratuity Amount

When on, a tip added at checkout is sent to the till as a service charge line against your Tip ID media. When off, tips stay in storekit only and the till check doesn’t include them. Pay-at-table tips are always sent, regardless of this setting.

Order Note Template

Controls the text sent as the check’s Instructions. Leave it empty and storekit sends the customer’s own notes. To include order details, type a template and use Insert Variable to add placeholders such as {{orderCode}}, {{fullName}}, {{phone}}, {{customerNotes}}, {{tableName}} or {{deliveryFullAddress}}; Preview shows how it will read on the till. Comtrex allows 255 characters — longer notes are cut short.

Cover Count

Sets how many covers the check is opened with. The options are fixed:
  • Do not send — no cover count on the check
  • Automatic (number of diners) — the number of diners the guest chose when ordering at a table; 0 if they weren’t asked
  • Fixed value — the number you enter in Cover Count Value (which appears when this option is selected); 0 is allowed

Scheduled Orders

Orders placed for later are sent to the till straight away as a Comtrex future order rather than held in storekit. The check carries:
  • PickupDateTime — the time the customer chose, in your store’s timezone
  • TriggerDateTime — that time minus your store’s Preparation time (the Pickup value for pickup orders, otherwise the store’s default prep time), so the till releases the check to the kitchen when it needs to start
ASAP delivery orders are also sent as future orders with the estimated delivery time as the pickup time and an immediate trigger, so the till shows when the order should be ready. If a scheduled order is cancelled in storekit before its time, storekit sends a CancelOrder to the till for that check.

When an Order Fails

If the till rejects the order or can’t be reached, storekit retries several times with increasing gaps between attempts. If every attempt fails:
  • The order is marked as Failed in Orders, with the till’s error text shown on the order page after Something went wrong sending this order to the POS:
  • An email headed Comtrex Issue is sent to your store’s email address
  • If the store has a storekit printer, the order is printed so the kitchen still receives it
  • The customer has already paid, so fulfil the order manually and fix the cause
Once the cause is fixed, open the order in Orders and choose Resend order to POS from the actions menu — it’s available on any order that doesn’t yet have a POS receipt. See Troubleshooting for the common causes.
storekit doesn’t check the basket against the till before checkout, and doesn’t snooze products after a failed order. If an item keeps failing, snooze it yourself in Menus until the till is fixed.

Order Injection

How order injection works across all POS providers

Troubleshooting

Fix failed orders