Connecting Zelty to XPRIO

Zelty connects directly to XPRIO with an API key that Zelty gives you. Allow a few days to receive the key, then half an hour to set everything up. This guide assumes you have read the general overview. Connecting your till (POS) to XPRIO

What to know

The key is free and is requested from Zelty. XPRIO takes no commission on the connection.
Opened store by store. While the Zelty card shows “Coming soon”, click We’ll let you know: we open the connection for your account and write to you as soon as it’s ready.
Zelty only displays an order once it is paid. An order paid online arrives paid with the “XPRIO” method. An order to be paid on site arrives paid with your “Espèces” (cash) method or with “XPRIO”, with the payment method in the note: you take the customer’s payment without re-entering it.
Every item must be linked. Zelty refuses free lines: an unlinked item blocks the order from being sent, with a clear message. The XPRIO order itself is still taken and visible in Live.
No test environment: the test order arrives on your real till, flagged as a test.

Step 1: request your API key

Open the form at zelty.fr/forms/api.
Enter your brand and your restaurants as they are named in your Zelty back office, and your login email.
Choose the partner Autre (Other) and describe the use: “XPRIO, online orders”.
Zelty sends keys on Tuesdays and Thursdays. The key is only visible for 5 minutes after you receive it: copy it straight away and keep it somewhere safe.

Step 2: prepare your Zelty back office

Two settings, to do once:

Configuration › Méthodes de paiement (payment methods): create a method named XPRIO. It is used to mark orders paid online as paid. If an Espèces (cash) method already exists, XPRIO uses it for orders paid in cash.
Your menu: create a Frais de livraison (delivery fees) product with an open price. XPRIO puts each delivery’s fee amount on it.

Step 3: connect Zelty in XPRIO

Go to App Configuration, Point of sale (POS), choose the store, then Connect on the Zelty card.
Paste the key into Zelty API key and click Save and test.
Choose this store’s Zelty restaurant, then Activate.

XPRIO then reads your Zelty menu: dishes, menus, options and stock-outs.

Step 4: items

Follow the card’s Next step box: import Zelty dishes into XPRIO if your menu is not there yet, or match the two. Linking is based on the reference (SKU) of each dish: use it as the PLU of your XPRIO product and everything links automatically. Matching items between XPRIO and your till

Two Zelty specifics:

Zelty menus have no reference: link each XPRIO meal deal to its Zelty menu by hand, on the matching screen;
Zelty does not accept a menu through its API: if your till is empty, the button gives you an import file to load into your Zelty back office, then syncing links everything.

Step 5: test order

Send a test order creates an order flagged as a test on your till. If it prints where you expect it, your real orders will follow the same path.

Day to day

Every order is sent with its dishes, options, menus and their choices, delivery fees and the customer’s note. An XPRIO discount appears in Zelty as a discount on the total.
Closing both ways: an order completed in XPRIO is closed in Zelty, and an order closed on the till becomes completed in XPRIO within minutes. An order scheduled for another day is closed in Zelty on the scheduled day.
Cancellation: Zelty does not allow an order to be cancelled from XPRIO. When you cancel in XPRIO, a message reminds you to cancel it on the till too: do it straight away, so it does not go to the kitchen.
Partial refund: it is made in XPRIO and entered on the till. The card shows you the amount.
Stock-outs from Zelty to XPRIO: a dish or option sold out on Zelty becomes unavailable in XPRIO. Not the other way: Zelty does not allow a stock-out to be set externally. A stock-out set in Live stays in XPRIO.

Frequently asked questions

I’ve lost my key. It is no longer shown after 5 minutes: submit a new request on the Zelty form.

An order was not sent: “item not linked”. Open the matching screen, link the item shown, then click Retry in the card’s latest sends.

Delivery fees don’t go through. Check that the Frais de livraison product exists in your Zelty menu, with an open price, then click Resync catalog.

How do I disconnect? Disconnect button on the card. Item links are removed on the XPRIO side; nothing is deleted in Zelty.