All Documentation
Yaxii Smart Form — WooCommerce COD Checkout Engine
·
Documentation
Shipping Api Troubleshooting
Connection Errors
These errors appear when you test a provider connection in Yaxii Smart Form > Shipping > Connect.
| Error Message | Provider | Cause & Fix |
|---|---|---|
| API ID is required. | Yalidine | The API ID field is empty. Enter the ID from your Yalidine account dashboard. |
| API Token is required. | Yalidine | The API Token field is empty. Enter the token from your Yalidine account. |
| Tenant ID is required. | ZR Express | The Tenant ID field is empty. Enter the UUID from your ZR Express account dashboard. |
| Secret Key is required. | ZR Express | The Secret Key (X-Api-Key) field is empty. Find it in your ZR Express API settings. |
| API token is required. | Ecotrack providers | The Bearer token field is empty. Enter the API token from your provider’s dashboard. |
Dispatch Errors
These errors appear in the Shipment Processing modal after pressing Send.
| Error Message | Cause & Fix |
|---|---|
| Unknown shipping provider. | The selected provider is not registered in Yaxii. Go to Shipping > Connect and reconnect it. |
| Order not found. | The WooCommerce order was deleted between selection and dispatch. Refresh the orders list and try again. |
| Dispatch failed. | A per-order API error occurred. Check that the order’s wilaya and phone number are valid, then use the Retry Failed button inside the modal. |
| City/wilaya could not be mapped to a provider territory. | The customer’s wilaya or city has no match in the provider’s territory list. Update the order address or add a manual mapping in Shipping > Wilayas. |
| WooCommerce is not active. | WooCommerce was deactivated. Re-activate it before dispatching orders. |
Tracking Errors
These errors appear inside the Tracking Modal or when clicking the Sync icon.
| Error Message | Cause & Fix |
|---|---|
| No tracking information found for this order. | The order has no tracking number saved yet. Dispatch it first via the Yaxii Fulfillment meta-box. |
| Provider not found. | The provider stored on the order is no longer connected. Reconnect it in Shipping > Connect, then click Sync on the order. |
| Parcel not found at provider. Please click the Sync icon to update this order’s status. | Ghost Shipment — the parcel was deleted on the courier portal. Click the Sync icon on the order row. Yaxii will automatically remove the stale tracking so the order can be re-dispatched. |
Sync Outcomes
The Sync All button in the order panel command bar and the per-order Sync icon both use the Universal Sync Engine. Each order produces one of five outcomes:
| Outcome | What Happened | Action Required |
|---|---|---|
| In Sync | Provider confirmed the parcel exists | None |
| Cleared | Parcel was deleted at the provider — Yaxii removed the tracking from the order | Re-dispatch the order |
| Unsupported | This provider does not support parcel verification | Verify manually on the provider portal |
| Unverified | A transient error prevented verification — order state is unchanged | Try Sync again later |
| No-op | Order has no tracking reference | Dispatch the order first |