Tarification
Comprendre la tarification dynamique de Swaloo, les grilles tarifaires (RateCard) et l'estimation des frais de livraison.
Tarification
Swaloo calcule les frais de livraison de façon dynamique, à partir d'une grille tarifaire (RateCard) et de la distance entre l'enlèvement et la livraison.
Grilles tarifaires (RateCard)
Une grille tarifaire définit comment un prix est calculé. Elle comporte :
| Champ | Description |
|---|---|
| Nom | Libellé de la grille (name) |
| Frais de base | Montant fixe appliqué à chaque course (baseFee) |
| Prix au kilomètre | Tarif par kilomètre parcouru (pricePerKm) |
| Bonus fixe par tâche | Prime fixe par tâche (fixedBonusPerTask) |
| Taux de commission plateforme | Part revenant à Swaloo (platformCommissionRate) |
| Active | Indique si la grille est utilisable (isActive) |
Une grille peut être globale, propre à une organisation, ou propre à un marchand.
Résolution de la grille applicable
Pour une course donnée, Swaloo sélectionne la grille active selon cet ordre de priorité :
- la grille active du marchand (si un marchand est concerné) ;
- la grille active de l'organisation ;
- la grille globale (repli administré par Swaloo).
Si aucune grille applicable n'est trouvée, l'estimation échoue avec une erreur explicite (NO_APPLICABLE_RATE_CARD).
Snapshot immuable à la création
À la création d'une expédition, la grille utilisée est enregistrée comme snapshot immuable (appliedRateCard) sur l'expédition, aux côtés de la distance (distanceKm) et des frais calculés (deliveryFee).
Ce snapshot fige le tarif : modifier ou désactiver une grille par la suite n'affecte pas les expéditions déjà créées. Chaque expédition conserve le tarif en vigueur au moment de sa création.
Estimer un tarif
L'estimation de tarif calcule le coût d'une livraison à partir des coordonnées GPS d'enlèvement et de livraison. Swaloo en déduit la distance, puis applique la grille résolue et renvoie notamment :
- la grille appliquée (identifiant et nom) ;
- la distance estimée en kilomètres ;
- les frais de livraison ;
- la marge plateforme et la part chauffeur, selon le mode de travail du chauffeur.
La part chauffeur et la marge plateforme dépendent du mode de travail du chauffeur (par exemple freelance). Voir Portefeuilles & transactions.