Skip to main content

How Order Status Syncs With Your Delivery Company

Once an order has been sent to a delivery company, you don't need to check on it manually. As soon as the delivery company updates the parcel's status on their end (received, out for delivery, delivered, and so on), that update reaches Zimam automatically and the order's status in your dashboard updates on its own — no action needed from you.

How the updates arrive​

Once a parcel has been accepted by the delivery company, that company sends Zimam a real-time notification every time the parcel's status changes on their side — this is what's technically called a "webhook." Zimam receives that notification, translates the carrier's status into a status you can understand, and updates the order right away — no need to open the carrier's website or copy a tracking number to check manually.

This is currently active for delivery companies that support sending this kind of notification (such as ZR Express, Yalidine, and Maystro Delivery). Some of the other delivery companies supported in Zimam don't yet provide this automatic notification on their side; in that case the order's status in your dashboard stays as-is until the carrier itself supports this, and we recommend tracking the parcel directly on the carrier's own website using the tracking number shown in the order's details.

The statuses you'll see​

When an update arrives from the delivery company, the order's status usually moves to one of:

  • In Transit — the parcel is genuinely out for delivery.
  • Delivered — the customer received the order.
  • Returned — the parcel went back to the delivery company without being delivered.

These aren't every possible order status — others (like Call Back or Cancelled) are set by you or by a call center agent, before the order even reaches the delivery stage. For the full list of statuses and what triggers each transition, see Order Lifecycle & Statuses.

The delivery company can also signal that it hit an obstacle without that being a final outcome yet — in that case the order's own status doesn't change, but a Delivery Problem alert shows up next to it (see the next section).

The "Delivery Problem" alert and when it shows up​

Sometimes the delivery company sends a status that signals a real delivery obstacle, without yet classifying the parcel as returned or definitively cancelled. When that happens, the order's status stays exactly as it was (for example, still Confirmed or In Transit), and Zimam adds a Delivery Problem alert next to it with a reason:

  • Failed attempt
  • Delivery provider alert
  • Suspended parcel
  • Customer unreachable
  • Provider problem — a generic reason shown when the delivery company sends a status that clearly signals a problem, but in a form that doesn't fit any of the four reasons above. In that case Zimam shows you the carrier's original status text instead of translating it, so you have the full picture when following up with the customer or the delivery company.

This alert clears automatically once the delivery company sends a genuine follow-up update for the same parcel (for example, it actually moves to In Transit, Delivered, or Returned).

In every case, the parcel's tracking number stays visible on the order's details so you can look it up directly if you need to.

Good to know​

  • Automatic sync only kicks in once an order has actually been sent to the delivery company and a tracking number has been generated for it — an order that hasn't been sent yet won't update on its own, because the delivery company doesn't know about it yet.
  • This sync only reflects what the delivery company reports; Zimam never guesses or changes an order's status on its own.
  • If you change an order's status manually in the dashboard and the delivery company later sends a new update for the same parcel, that new update is what you'll see — since it comes straight from the delivery company's own record.