When to use it
Use Zenfulfilment when your warehouse orders ship through Zenfulfilment and your support team handles:- “where is my order?” questions that need the current carrier and tracking link
- “where is my return / refund?” questions
- confirming the shipping address or items on an order before answering a customer
- fixing a typo’d address before an order ships
- sending a customer a prepaid return label, or logging a return they already shipped back themselves
- cancelling an order before it ships, instead of asking the warehouse manually
Prerequisites
You need a Zenfulfilment account with API access: a Client ID, a Client Secret, and an API Key. Ask your Zenfulfilment contact for these if you don’t have them yet.Set it up
1
Open integrations
Open integrations from your workspace settings and choose Zenfulfilment.
2
Connect your account
Click Connect, enter the Client ID, Client Secret, and API Key, then confirm. cx logs in to Zenfulfilment with these credentials before saving the connection, so a wrong value is rejected immediately.
3
Check the connection
Add a Get order action to an AI Agent (see below), then run a test with a known order number to confirm it returns the order.
AI Agent actions
Give an AI Agent Zenfulfilment actions when you want automation to check an order, its tracking, or its return, fix an address, send a return label, or cancel an order. Connect Zenfulfilment first, then enable the actions on the agent and select which connected Zenfulfilment account(s) it may use.Get order
Looks up a Zenfulfilment order by the shop’s own order number (the same number shown in Shopify, for example#1164329) and returns its status, shipping address, and line items. This is a read action and does not require approval.
Before returning an order, cx checks that the order’s customer email matches an email already on file for the ticket’s contact. If it doesn’t match — or can’t be verified — the agent is told the order wasn’t found rather than shown another customer’s order.
Get tracking
Looks up shipment tracking for an order by the shop’s own order number and returns the carrier, tracking number, tracking link, and delivered date. Use this for “where is my package?” questions. This is a read action and does not require approval. It checks the order’s customer email the same way Get order does.Get return status
Looks up the status of a return on an order by the shop’s own order number — for example whether the return has arrived at the warehouse, is being processed, or is complete — and what happens next, such as a refund or a reshipment. This is a read action and does not require approval.A return record has no customer email of its own, so this lookup relies entirely on matching the order first, the same way Get order does.
Update shipping address
Updates the shipping address on an order — fix a typo’d street, city, or ZIP before it ships. Give the agent only the fields that need to change; everything else on the address stays as it is. Zenfulfilment refuses the change once an order has moved past the earliest stage of processing — tell the customer it’s too late to change the address and offer a return instead. This action defaults to Ask every time.Create return label
Generates a prepaid return shipping label for an order that has already been delivered, and gives the agent a link the customer can click to download and print it. Generating a label can take a few seconds; if it isn’t ready right away, the agent is told to try again shortly instead of leaving the customer waiting.Before this action can be used, add the warehouse address returned parcels should ship to — first name, last name, street, street number, city, ZIP, country, and phone — in the action’s own settings. This is the warehouse’s address, not the customer’s, and it’s the same for every return, so an admin sets it once rather than the agent filling it in per customer.
Create return
Records a return for an order the customer already shipped back on their own — for example with their own carrier or a returns portal that isn’t connected to Zenfulfilment. Give the agent the tracking number, carrier, and every item being returned with its reason. Recording the same tracking number again on the same order won’t create a duplicate return. This action defaults to Ask every time.Zenfulfilment has no way to issue a refund through this integration. Handle refunds through your usual payment provider or shop platform.
Safe testing
- Use an order you know has not shipped yet for Update shipping address; change one field and confirm only that field changed.
- Use a delivered order for Create return label and confirm the link opens a real, printable label.
- Run the agent in test mode for Cancel order, Update shipping address, Create return label, and Create return, and review the simulated result before approving anything.
- Check the proposed order number, address fields, or items before approving.
- For the first live run of any write action, approve on a disposable test order and verify the result in Zenfulfilment.