Skip to Content
dzshipBY DZBUILD

Delivery statuses in Algeria: one vocabulary for every courier

The fourteen parcel statuses dzship returns for every Algerian courier, with French and Arabic labels and the ones that need special handling.

Edit on GitHub

Each courier reports parcel status in its own dialect: French sentences, Arabic labels, English-ish slugs, or bare numbers. If you build your order screen against one courier's wording, adding a second courier means rewriting it.

The fix is to map everything onto one closed set once, and build your UI against that. This is the vocabulary the dzship API returns for every courier:

created → pending_pickup → picked_up → in_transit → at_hub → out_for_delivery
        → delivery_attempted → delivered
        → on_hold | returned | return_in_transit | cancelled | lost | unknown

delivered, returned, cancelled and lost are terminal. Everything else can still move.

UI labels, ready to paste

Algerian stores are Arabic-first with French common in back offices. These are the labels DZBuild uses in production dashboards:

StatusFrançaisالعربيةSuggested tone
createdEnregistréتم التسجيلneutral
pending_pickupEn attente de ramassageفي انتظار الاستلامneutral
picked_upRamasséتم الاستلام من المتجرinfo
in_transitEn transitقيد النقلinfo
at_hubAu centre de triفي مركز الفرزinfo
out_for_deliveryEn cours de livraisonخرج للتوصيلactive
delivery_attemptedTentative de livraisonمحاولة تسليمwarning
deliveredLivréتم التسليمsuccess
on_holdEn attenteمعلّقwarning
return_in_transitRetour en coursالإرجاع قيد النقلwarning
returnedRetournéتم الإرجاعdanger
cancelledAnnuléملغىdanger
lostPerduمفقودdanger
unknownStatut inconnuحالة غير معروفةneutral

Tips for the table above:

  • Render Arabic labels in an RTL context (dir="rtl"), or punctuation will jump to the wrong side.
  • Keep rawStatus visible somewhere (tooltip, detail view). When a status maps to unknown, the raw courier wording is the only thing support can act on.

Statuses that deserve special handling

delivery_attempted is your money status. The courier tried, the customer didn't pick up. Stores that call the customer within the hour recover a large share of these; stores that wait for the courier's second attempt mostly get returns. If you automate one notification, automate this one.

on_hold usually means the courier is waiting on something: customer unreachable, wrong commune, refused fee. It resolves either way within days; surface it to your ops instead of hiding it under "in progress".

unknown means the courier emitted wording outside the known vocabulary (it happens; tenants customize labels). Show rawStatus, keep polling, and the next event usually maps cleanly again.

Per-courier notes

  • Maystro reports numeric codes with unintuitive numbering; see the Maystro guide before trusting any homegrown mapping.
  • NOEST mixes payment/finance events into the tracking feed; those are not parcel movement. See the NOEST guide.
  • Ecotrack tenants customize status labels; expect drift between couriers on the same platform. See the Ecotrack guide.

Last updated on

On this page