Sociétés de livraison et chauffeurs

Sociétés de livraison et chauffeurs

Une société de livraison est un partenaire logistique qui exploite une flotte de chauffeurs et perçoit les frais de livraison de chaque commande livrée avec succès (et de chaque commande tentée — voir Échec de livraison ci-dessous). Les frais arrivent dans le portefeuille de la société, libellé dans la devise de base de la plateforme, puis sont versés via un règlement.

Acteurs

Intégration

1. NQLA enregistre votre société avec un utilisateur responsable principal plus un nombre quelconque d'utilisateurs du personnel.
2. Vous enregistrez vos chauffeurs — chacun reçoit son propre identifiant. Le permis et la carte nationale d'identité d'un chauffeur sont stockés chiffrés.
3. Le portefeuille de votre société démarre à zéro ; il est crédité automatiquement à mesure que vous effectuez des livraisons.

Déroulement quotidien

1. Admin → société. Un administrateur affecte une commande approuvée à votre société. Le statut passe à assigned_to_delivery et delivery_company_id y est apposé.
2. Société → chauffeur. Vous (ou un administrateur) affectez l'un de vos propres chauffeurs. La plateforme rejette tout chauffeur n'appartenant pas à votre société. Statut → assigned_to_driver.
3. Le chauffeur démarre. Il appuie sur Démarrer. Statut → out_for_delivery. Seul le chauffeur affecté le peut.
4. Le chauffeur clôt le trajet avec :
   • Livrée — statut → delivered. Votre portefeuille est crédité des frais de livraison, et le portefeuille du marchand du net de la commande.
   • Échec — statut → failed_delivery. La tentative reste due (le marchand est facturé livraison + commission), et le stock est restauré.

Une commande échouée peut être réaffectée à un chauffeur et réessayée — voir Cas particuliers.

Ce que font les chauffeurs sur mobile

L'application dialogue avec /api/v1/driver/deliveries :

• GET / — lister mes livraisons (pagination par curseur ; suivre next_cursor).
• GET /{order} — voir une commande (seulement les miennes).
• POST /{order}/start — démarrer la livraison.
• POST /{order}/delivered — marquer comme livrée.
• POST /{order}/failed — marquer comme échouée (notes facultatif).
• POST /{order}/location — envoyer un point GPS (limité en débit).
• POST /{order}/review — soumettre une évaluation.

Chaque écriture est limitée au chauffeur authentifié — un chauffeur ne peut agir que sur les commandes dont le driver_id correspond.

Portefeuille & règlement

• Les frais de livraison sont crédités une seule fois par commande (idempotent — une nouvelle tentative ne crédite jamais deux fois).
• Les frais sont convertis de la devise de la commande vers la devise de base avant de toucher le portefeuille.
• Les soldes sont versés via des règlements ; une fois un règlement marqué payé, chaque commande couverte reçoit son settlement_id.

Écrans & points de terminaison

Pages liées

• Cycle de vie des commandes (orders-lifecycle).
• Sociétés de stockage et entrepôts (storage-companies-warehouses).