Orders

Cahier §5.4: « Suivre chaque commande depuis la validation jusqu'à la livraison » — the status shown must be the back-office status and the history must stay available. Since 17 October 2026 every order waits for an explicit confirmation by HOCO (ORD-14) and every status change reaches the reseller live while the app is open, and as a notification (ORD-15). These screens are designed on day 9 and built in MRA-05; the live client and the return request (RA-40, on the system, returns and guest-mode page) are MRA-10. The order rules are those of lifecycles and statuses.

ID	Screen	UI title	Section	Release	Design	Build
RA-21	Orders	Commandes	Orders	V1	Day 9	MRA-05
RA-22	Order detail & tracking	Suivi de commande	Orders	V1	Day 9	MRA-05
RA-23	Assisted order confirmation	Commande assistée à confirmer	Orders	V1	Day 9	MRA-05
RA-40	Return request	Demande de retour	Orders	V1	Day 9	MRA-10

What the reseller sees of the lifecycle. Five counters and a five-step tracker; the status pill always shows the exact French label of the status (what the reseller sees):

Brouillon (DRAFT) orders are never shown to the reseller.

RA-21 — OrdersCopy Anchor Link

Purpose — See every order of the shop at a glance — how many wait, are confirmed, in preparation, shipped, delivered — find one quickly, and act on what needs the reseller (ORD-07, ORD-15).

Entry points & exits — Commandes tab; Commandes quick tile; home banners « commandes en attente de confirmation »; /orders?status=. Exits to RA-22 (card), RA-23 (pinned assisted order), RA-17 (« Recommander » result), RA-12 (empty state), RA-26 (bell), WhatsApp.

Layout

1. TabRootHeader (as on the reference).
2. SearchField « Rechercher une commande, un produit… » with a filter icon (opens the filter sheet).
3. « Statut des commandes »: five KpiTile in one row — En attente, Validées, En préparation, Expédiées, Livrées — icon, count, label. Tapping a tile filters the list on its statuses (the tile stays highlighted; tapping again clears).
4. Pinned section « À confirmer » (only when an assisted order awaits the reseller): warning-tone card « Commande préparée par Yacine — 45 600,00 DA — à confirmer avant le 17 nov. à 14:30 » with « Voir et confirmer » → RA-23.
5. « Historique des commandes »: infinite list of OrderCard:
   • number « CMD-2026-000158 », date « 14 nov. 2026 à 10:32 », StatusBadge with the exact status label;
   • first item thumbnail and name, « 3 articles », total TTC « 89 900,00 DA », chevron;
   • ProgressTracker with the five steps (current step in the status tone); off-tracker statuses replace it with one line (« Refusée — Stock insuffisant »);
   • under Envoyée: « En attente de confirmation par HOCO » in caption;
   • chips when relevant: « Commande assistée », « Retour en cours », « SAV en cours »;
   • on Livrée cards: text button « Recommander ».
6. Filter sheet: status (multi-choice, the five groups plus Refusée, Annulée, Retournée), period (« 30 derniers jours », « 3 mois », « 12 mois », custom dates), channel (« Application », « Web », « Commande assistée », « Saisie par HOCO »); « Réinitialiser », « Appliquer ».
7. WhatsAppButton (floating).

Data

Actions

• Card → RA-22. Pinned card → RA-23.
• Search: by order number (« 158 », « CMD-2026-000158 ») or product name and reference, 300 ms debounce → orders.list?q=.
• « Recommander » → orders.reorder with an Idempotency-Key → BottomSheet « 8 articles ajoutés au panier · 2 indisponibles » listing the skipped ones, « Voir le panier » → RA-17. Lines are added at today's prices.
• Live event for an order in the list: the card's pill and tracker animate to the new status, counters update, the list keeps its scroll position; a card that no longer matches the active filter stays until the next refresh, greyed.
• Pull-to-refresh → orders.summary and the first page.

Rules

• The reseller sees only their own orders (ACL-03); assisted orders appear once the delegate sends them for confirmation.
• The status shown is always the back-office status (cahier §5.4 acceptance criterion): from the server, refreshed live, on push, on tab focus.
• Counters cover all orders of the account; Refusée, Annulée and Retournée have no tile but are reachable through the filter.
• Reorder is offered for Livrée, Annulée, Refusée and Retournée orders (ORD-07).

States

Copy — « Rechercher une commande, un produit… » · « Statut des commandes » · « En attente » · « Validées » · « En préparation » · « Expédiées » · « Livrées » · « À confirmer » · « Voir et confirmer » · « Historique des commandes » · « {count} articles » · « En attente de confirmation par HOCO » · « Commande assistée » · « Retour en cours » · « SAV en cours » · « Recommander » · « {added} articles ajoutés au panier · {skipped} indisponibles » · « Vous n'avez pas encore passé de commande ».

Analytics — orders_viewed with awaitingConfirmation; orders_tile_clicked with group; orders_searched; order_reordered with orderId, added, skipped, source: "list"; order_live_update_shown with to.

Acceptance criteria

• When HOCO confirms an order in the back-office, the card on an open RA-21 switches to Validée within 5 seconds without a manual refresh, and the counters move.
• Each counter equals the number of orders listed when its tile is tapped.
• Searching « 158 » finds CMD-2026-000158.
• « Recommander » on a delivered order adds its available lines to the cart and reports the others.

RA-22 — Order detail & trackingCopy Anchor Link

Purpose — Follow one order from sending to delivery, live: status and history, items and totals, delivery, payment and documents; and act on it — cancel while allowed, reorder, download the invoice, contact support, open an after-sales claim or ask for a return (ORD-06, ORD-07, ORD-10, ORD-12, ORD-13, ORD-15).

Entry points & exits — Cards of RA-21, RA-20 (« Suivre ma commande »), pushes order.status_changed and order.modified, RA-26, RA-30 (invoice → order), /orders/{orderId}. Exits to RA-23 (assisted order awaiting confirmation), RA-17 (reorder), RA-31 (« Déclarer un paiement »), RA-33 (support or after-sales claim), RA-40 (return), RA-14 (line), the PDF viewer, WhatsApp.

Layout

1. AppBar: « Commande CMD-2026-000158 », WhatsApp icon (message naming the order), overflow menu (« Copier le numéro »).
2. Status header: large StatusBadge, the status sentence (table at the top of the page), « Passée le 14 nov. 2026 à 10:32 », channel line (« Depuis l'application », « Depuis le web », « Commande assistée préparée par Yacine », « Saisie par HOCO »).
3. Status banner, when relevant:
   • Envoyée: info « En attente de confirmation par HOCO. Vous serez notifié dès la confirmation. »
   • En attente awaiting the reseller (assisted): warning with « Voir et confirmer » → RA-23.
   • Refusée: error « Refusée le 15 nov. — Motif : … » with « Contacter l'assistance ».
   • Annulée: muted « Annulée par vous le … » or « Annulée par HOCO le … — Motif : … ».
   • Modified by HOCO: info « HOCO a modifié votre commande le 15 nov. — Motif : … » with « Voir les modifications » (scrolls to the timeline).
4. ProgressTracker, vertical, five steps, each with its date and time when reached; Expédiée shows the delivery mode, the carrier or driver and the tracking number (copy icon).
5. « Articles » — lines: thumbnail, name, reference, « 5 × 2 490,00 DA », line total, promotion label; a line changed by HOCO shows « 10 → 8 » with the old quantity struck through; collapsed after 5 lines with « Voir les 12 articles ».
6. Totals SummaryCard: « Sous-total HT », « Remises », « Frais de livraison », « TVA », « Total TTC ».
7. « Livraison » card: address snapshot (recipient, phone, address, commune, wilaya); mode (Livreur HOCO, Société de livraison, Retrait au dépôt); carrier and tracking number, or driver name and « Appeler le livreur »; delivered at and « Reçu par … ».
8. « Paiement » card: method; invoice status (Impayée, Partiellement payée, Payée…) or « Facture émise à l'expédition »; « Payé 5 000,00 DA · Reste 10 350,00 DA »; « Déclarer un paiement » for transfer, CCP and BaridiMob when an amount is due and the order is confirmed.
9. « Documents »: « Facture FAC-2026-000123 » and « Bon de livraison BL-2026-000123 » rows with a download icon; a document not yet issued shows « Disponible à l'expédition » / « Disponible quand la commande est prête » in grey.
10. « Retours et SAV » block, on Livrée orders: « Signaler un problème (SAV) » — « Produit défectueux, endommagé, erroné ou manquant » — available settings.afterSales.windowDays (30) days after delivery; « Demander un retour » — « Renvoyer des articles et recevoir un avoir » — available settings.returns.windowDays (7) days after delivery; then the existing returns and claims of this order (« Retour RET-2026-000012 — Accepté », « SAV TKT-2026-000045 — En cours de traitement ») → RA-40 or RA-34. After the window: « Délai de retour dépassé (7 jours après la livraison). »
11. « Votre note » (when the reseller wrote one).
12. « Historique » — Timeline of status changes (date, label, actor: « HOCO », « Vous », « Système »), modifications with their reason and diff, assisted confirmation steps.
13. StickyFooter with the actions allowed by allowedActions: secondary « Recommander »; destructive text « Annuler la commande »; text « Contacter l'assistance ».

Data

Actions

Rules

• Every modification and status change is dated, kept in the history and notified (ORD-06); the reseller sees modifications with HOCO's reason.
• Cancellation by the reseller only while the status is in settings.orders.cancelAllowedStatuses (Envoyée, En attente), never for an assisted order awaiting confirmation (it is rejected on RA-23); reservations are released automatically (ORD-10).
• Documents (ORD-12): the delivery note exists from Prête, the invoice from Expédiée (default billing.invoiceOn); both are PDFs read through short-lived signed URLs.
• Returns (ORD-13) and after-sales claims (SUP-04) only on Livrée orders, within their windows; the server re-checks (422 RETURN_WINDOW_EXPIRED, 422 AFTER_SALES_WINDOW_EXPIRED).
• Prices on the order are the snapshot taken at submission (and any controlled modification by HOCO); they never follow later catalog changes.
• The live stream is a convenience: the same changes arrive as notifications, and the screen refetches on focus.

States

Copy — « Commande {number} » · « Passée le {date} » · « En attente de confirmation par HOCO. Vous serez notifié dès la confirmation. » · « HOCO a modifié votre commande le {date} — Motif : {reason} » · « Voir les modifications » · « Articles » · « Voir les {count} articles » · « Livraison » · « Appeler le livreur » · « Reçu par {name} » · « Paiement » · « Déclarer un paiement » · « Documents » · « Facture {number} » · « Bon de livraison {number} » · « Disponible à l'expédition » · « Retours et SAV » · « Signaler un problème (SAV) » · « Demander un retour » · « Délai de retour dépassé ({days} jours après la livraison). » · « Historique » · « Recommander » · « Annuler la commande » · « Contacter l'assistance » · « Commande annulée » · « Statut mis à jour : {status} ».

Analytics — order_viewed with status, channel; order_live_update_applied with from, to; order_cancel_requested; order_cancelled with reasonCode; order_reordered with source: "detail"; order_document_downloaded with type; after_sales_started with orderId; return_started with orderId.

Acceptance criteria

• The status, dates and history equal those of the back-office order (BO-39) (cahier §5.4).
• A status change made in the back-office appears on an open RA-22 within 5 seconds, and also arrives as a push and in the inbox.
• « Annuler la commande » is visible only for Envoyée and En attente orders (not assisted ones awaiting confirmation); after cancellation the status is Annulée everywhere.
• The invoice PDF opens once the order is shipped; before, the row says when it will be available.
• « Demander un retour » disappears 7 days after delivery; « Signaler un problème » 30 days after.

RA-23 — Assisted order confirmationCopy Anchor Link

Purpose — Let the reseller check and confirm — or reject — an order their delegate prepared with or for them (cahier §4.4 « Une commande assistée doit être confirmée par le revendeur ou validée par l'administration », §6.7; ORD-08). Confirmation does not make the order Validée: it is then Envoyée and waits for HOCO like any other order (ORD-14).

Entry points & exits — Push and SMS assisted_order.awaiting_confirmation (deep link /orders/{orderId}/confirm), reminder push 24 h before expiry, the home banner, the pinned card of RA-21, the banner of RA-22. Exits to RA-20-like success then RA-22, to RA-19 (address), to RA-17 (« Copier dans mon panier » after a rejection or expiry), phone or WhatsApp to the delegate.

Layout

1. AppBar « Commande à confirmer ».
2. Delegate card: avatar with initial, « Préparée par Yacine, votre délégué HOCO », « le 14 nov. à 11:05 », « Appeler » and « WhatsApp » (delegate's number).
3. Number « CMD-2026-000161 » and expiry Countdown: « À confirmer avant le 17 nov. à 11:05 (dans 2 j 5 h) » — warning tone under 24 h.
4. Explanation: « Vérifiez les articles, l'adresse et le mode de paiement. Après votre confirmation, HOCO confirmera la commande avant de la préparer. »
5. Re-pricing banner when the totals changed since the delegate prepared it: « Les prix ont changé depuis la préparation : nouveau total 46 200,00 DA. »
6. Articles (read-only): thumbnail, name, reference, « 10 × 2 490,00 DA », line total; line issues as in the cart (out of stock, unavailable).
7. « Adresse de livraison » — AddressCard chosen by the delegate, « Modifier » → RA-19 in selection mode.
8. « Mode de paiement » — the RadioCard list of RA-18, with the same credit box and rules; the payment method is chosen by the reseller here.
9. « Note » (facultatif) — the delegate's note shown read-only, plus a field for the reseller's own note (500 characters).
10. SummaryCard with the current totals.
11. StickyFooter: primary « Confirmer la commande », destructive text « Refuser ».

Data

Actions

• « Confirmer la commande » → orders.confirmAssisted { paymentMethod, addressId, note, expectedTotalTtc } with an Idempotency-Key (same exactly-once handling as RA-18). Success → success screen « Commande confirmée ! Elle est maintenant en attente de confirmation par HOCO. » with « Suivre ma commande » → RA-22.
• « Refuser » → BottomSheet « Pourquoi refusez-vous cette commande ? »: « Articles ou quantités incorrects », « Prix trop élevés », « Je n'ai pas demandé cette commande », « Je commanderai plus tard », « Autre » (comment required) → orders.rejectAssisted { reasonCode, comment } with an Idempotency-Key → result « Commande refusée. Yacine en est informé. » with « Copier dans mon panier » (orders.reorder) and « Retour aux commandes ».
• Live event: if HOCO confirms the order for the reseller (by phone) while the screen is open, the screen switches to the read-only state.

Rules

• Confirmation only while the confirmation is En attente du revendeur and before assisted.expiresAt (72 h); a confirmation after expiry is refused even if the expiry job has not run (409 ASSISTED_ORDER_EXPIRED).
• The order is re-priced and re-controlled at confirmation like a checkout: the reseller confirms the totals shown (409 CART_CHANGED otherwise), with the same stock, credit and minimum-amount rules (cahier §6.7 « Le prix, le stock et le crédit sont contrôlés comme pour une commande normale »).
• The reseller cannot edit the lines in V1. To change them: refuse, then « Copier dans mon panier » and order normally, or ask the delegate for a new assisted order.
• A reseller still PENDING_VALIDATION cannot confirm (403 ACCOUNT_PENDING_VALIDATION): HOCO confirms the order by phone with them in BO-41 (Validée par l'administration), which is the usual path for a first order taken in the shop.
• The order keeps its source delegate for attribution in reports, whoever confirms it (ORD-09).

States

Copy — « Commande à confirmer » · « Préparée par {delegateFirstName}, votre délégué HOCO » · « À confirmer avant le {date} (dans {remaining}) » · « Vérifiez les articles, l'adresse et le mode de paiement. Après votre confirmation, HOCO confirmera la commande avant de la préparer. » · « Les prix ont changé depuis la préparation : nouveau total {total}. » · « Confirmer la commande » · « Refuser » · « Pourquoi refusez-vous cette commande ? » · « Commande confirmée ! Elle est maintenant en attente de confirmation par HOCO. » · « Commande refusée. {delegateFirstName} en est informé. » · « Copier dans mon panier » · « Cette commande a expiré le {date} sans confirmation. »

Analytics — assisted_order_viewed with hoursLeft; assisted_order_confirmed with method, hoursToConfirm, repriced; assisted_order_rejected with reasonCode; assisted_order_copied_to_cart.

Acceptance criteria

• Tapping the push opens this screen on the right order; confirming makes it Envoyée and visible in the back-office queue BO-41 as confirmed by the reseller, attributed to the delegate.
• A confirmation attempted after 72 h is refused with the expiry message.
• If prices changed since the preparation, the new total is shown before the reseller can confirm.
• A rejection requires a reason and notifies the delegate.
• A pending-validation reseller cannot confirm and is told that HOCO will confirm by phone.