Zapiet Pickup & Delivery
The POS Cafe Zapiet integration lets customers build their order on the POS Cafe online ordering menu, then choose pickup or local delivery with the Zapiet Pickup & Delivery app. POS Cafe reads Zapiet’s pickup or delivery details from each order and sends the tickets to the right location’s receipt printers and Fresh KDS screens.
How the Zapiet integration works
Section titled “How the Zapiet integration works”With the integration turned on, the ordering flow changes like this:
- Customers build their order in POS Cafe. They browse your POS Cafe online ordering menu and customise items with modifiers as usual.
- The cart hands over to Zapiet. When a customer opens their cart, they go straight to your Shopify cart page instead of the POS Cafe cart window. Zapiet’s widget on that page handles pickup or delivery, the location, the date and the time. Options from the POS Cafe cart window, such as the Drive Thru and Curbside vehicle details, don’t appear.
- POS Cafe routes the order. When the order is placed, POS Cafe reads the Zapiet details, matches the Zapiet location to your Shopify location, and prints tickets or sends them to Fresh KDS at that location. The order type (Pickup or Delivery) and the requested date and time appear on the tickets.
For delivery orders, Zapiet collects a time window. POS Cafe uses the start of that window as the ticket time.
Before you start
Section titled “Before you start”- POS Cafe Online Ordering is set up and live. See Getting started with online ordering.
- Zapiet Pickup & Delivery is installed and configured in your Shopify store, with your pickup and delivery locations set up in the Zapiet app.
- Zapiet’s widget shows on your Shopify cart page. Zapiet’s own setup guides cover this.
Set up the Zapiet integration
Section titled “Set up the Zapiet integration”- Open the Zapiet settings. In the POS Cafe app, go to Settings → Integrations → Zapiet Pickup & Delivery.
- Turn the integration on. Tick Enable Zapiet integration.
- Copy your Zapiet location IDs. In the Zapiet app, find the location ID for each of your pickup and delivery locations.
- Map each location. Under Location mapping, paste each Zapiet location ID next to the Shopify location it belongs to (for example
317021). - Save. Click Save in the bar at the top of the page.
Location mapping reference
Section titled “Location mapping reference”Every Shopify location that accepts Zapiet orders needs its own Zapiet location ID. The settings page warns you about anything that needs attention:
| What you see | What it means | What to do |
|---|---|---|
| A warning that a location has no Zapiet ID yet | Orders for that location fall back to the order’s existing Shopify location, which may not be the location the customer chose in Zapiet. | Add the Zapiet location ID before accepting orders for that location. |
| This Zapiet ID is mapped to more than one Shopify location | The same Zapiet ID is entered against two Shopify locations. POS Cafe won’t guess between them, and you can’t save. | Make every Zapiet location ID unique. |
| Mappings for inactive Shopify locations | The Shopify location is inactive. Its mapping is kept so routing resumes if you reactivate it. | Nothing, unless you want to remove the mapping. |
| Mappings for removed Shopify locations | The mapping points to a location Shopify no longer has. POS Cafe never deletes a mapping automatically. | Click Remove next to each mapping you no longer need, then save. |
Troubleshooting
Section titled “Troubleshooting”Customers still see the POS Cafe cart window
Section titled “Customers still see the POS Cafe cart window”Check that Enable Zapiet integration is ticked and saved under Settings → Integrations → Zapiet Pickup & Delivery. Then reload your online ordering page, because a page that was already open keeps its old settings.
An order printed at the wrong location
Section titled “An order printed at the wrong location”The Zapiet location the customer chose isn’t mapped, or is mapped to the wrong Shopify location. Open the Zapiet settings, check the ID next to each Shopify location against the Zapiet app, and save.
A shipping order didn’t print
Section titled “A shipping order didn’t print”This is expected. Shipping orders have no location, so POS Cafe can’t route them to a printer or Fresh KDS. Pickup and local delivery orders are routed as normal.
Can I turn the integration off?
Section titled “Can I turn the integration off?”Yes. Untick Enable Zapiet integration and save. Customers go back to the POS Cafe cart window, and your location mappings stay saved in case you turn it on again.