Real Time Tracking Modal
How Live Tracking Works
When you dispatch an order through Yaxii, the shipping provider returns a tracking number that is saved directly to the WooCommerce order. At any point after dispatch, you can open the Tracking Modal to see the shipment’s live position without leaving WordPress.
Opening the Tracking Modal
The tracking number appears as a clickable element in:
- The Yaxii Fulfillment meta-box on the single-order edit screen
- The order row inside the Yaxii Order Panel table (WooCommerce > Orders)
Click the tracking number or the package icon on the order row to open the modal.
Inside the Modal
The modal header shows:
- The tracking number as the title
- The order reference, customer name, and wilaya as the subtitle
- A Copy ID button — copies the tracking number to your clipboard with a single click
- A View on Yalidine button — opens the public Yalidine tracking page in a new browser tab
Below the header, a status bar shows the current shipment position in real time:
- A green pulsing dot with the latest status label (e.g. “In Delivery”)
- The date of the last update
- The provider name (“via Yalidine” or “via ZR Express”)
The timeline beneath the status bar lists every event in the shipment history — from parcel creation at the sorting center through each hub scan to final delivery. Each event shows:
- Status label
- Date and time
- Sub-status detail
- Location (sorting center or hub name)
[Screenshot: Tracking Modal open on a dispatched order — header with tracking number and Copy ID / View on Yalidine buttons; green status bar showing “In Delivery” with a pulsing dot and last-update date; a timeline of four events is visible below]
The Sync Button
Next to each tracking number in the order row, a circular Sync icon lets you manually verify that the parcel still exists at the provider. The sync runs silently and updates the order row in place without a page reload.
Sync outcomes:
| Outcome | What It Means |
|---|---|
| In Sync | Provider confirmed the parcel exists — no action needed |
| Cleared | Parcel was deleted at the provider — tracking removed from the order automatically |
| Unsupported | This provider does not support parcel verification |
| Unverified | A transient error prevented verification — order state unchanged, try again later |
| No-op | Order has no tracking reference — nothing to sync |
You can also sync all dispatched orders at once using the Sync All button in the order panel command bar.
Ghost Shipments
If a parcel is deleted directly on the Yalidine or ZR Express portal — without going through Yaxii — the tracking number stored in WooCommerce becomes a Ghost Shipment. The next time you open the Tracking Modal for that order, instead of a timeline, the modal shows:
- A centered package illustration
- A “Parcel not found” heading
- A message explaining that the shipment no longer exists at the provider
- A prompt to click the Sync icon on the order row
Clicking Sync runs the Universal Sync Engine, which detects the provider’s 404 and automatically removes the stale tracking information from the WooCommerce order. The order returns to an unfulfilled state, ready to be re-dispatched to any connected provider.
What’s Next?
→ Read: Shipping API Errors & Fixes