Comprendre la facturation

Conformément aux conditions d'utilisation de la solution Last Mile Fleet (LMFS) de Google Maps Platform, une transaction facturable est effectuée lorsque les tâches associées à une livraison sont bien effectuées.

L'objet Task est un type d'objet fondamental qui joue un rôle clé dans le suivi et la création de rapports sur les transactions facturables dans l'API LMFS Deliveries. Conformément à nos conditions, vous devez modéliser correctement les tâches du pilote et enregistrer correctement TaskOutcome. Cela garantit que toutes les transactions facturables sont correctement enregistrées. Pour les clients sous contrat, consultez les exigences concernant les rapports applicables à votre produit:

Qu'est-ce qu'une tâche facturable ?

Une tâche facturable est une tâche qui termine une expédition: le transport d'un ou de plusieurs articles d'un transporteur vers un destinataire unique. Les tâches d'expédition ayant échoué ne sont pas facturables.

Le tableau suivant fournit quelques scénarios concrets pour les tâches facturables et non facturables.

Scénario Facturable ?
Un chauffeur a essayé de livrer un colis, mais cette tentative a abouti. Par exemple, le destinataire l'a reçu directement ou le conducteur l'a laissé à un voisin. Oui
Un chauffeur a livré un colis en dehors du délai prévu pour ce colis. Oui
Un chauffeur a signalé qu'une commande a été expédiée, mais le destinataire a par la suite contesté la réception de la commande. Oui
Un chauffeur a essayé de livrer un colis, mais cette tentative a échoué. Par exemple, le destinataire n'était pas à la maison pour une signature obligatoire ou l'adresse était incorrecte. Non
Un conducteur fait une pause ou un arrêt programmé. Non

Comment la facturation est-elle effectuée dans l'API Deliveries ?

Une tâche est facturée selon les conditions suivantes:

  • Le type de la tâche est défini sur delivery. Les tâches de retrait ne déclenchent pas de facturation, ce qui n'est pas le cas des pauses ou des arrêts planifiés. Chaque transaction facturable doit être associée à une tâche de livraison. Pour les retraits de premiers kilomètres dans un dépôt, la tâche de retrait peut être modélisée pour le lieu de prise en charge et la tâche de livraison au niveau du dépôt.

  • TaskOutcome a la valeur SUCCEEDED.

L'API Last Mile Fleet Solution Deliveries crée un événement facturable la première fois qu'un TaskOutcome est mis à jour avec une valeur de SUCCEEDED. Dans ce cas, la métrique de facturation est incrémentée pour ce SKU. Toute mise à jour ultérieure de cette tâche n'a aucune incidence sur cette métrique de facturation, qui ne peut pas être incrémentée ni décrémentée une fois le résultat défini.

Comment devez-vous modéliser vos tâches ?

Cette section fournit des recommandations de base pour vous aider à vérifier que vous avez correctement défini vos tâches conformément à nos conditions d'utilisation.

  • Définissez les champs appropriés pour les tâches d'expédition. Définissez le type de tâche sur delivery, attribuez un ID de tâche unique et spécifiez l'emplacement approprié pour l'exécution de chaque tâche. Assurez-vous que chaque envoi comporte une tâche de livraison.
  • Créez des tâches distinctes pour chaque combinaison expéditeur-destinataire. Par exemple, utilisez deux tâches pour un seul destinataire provenant de plusieurs expéditeurs. Ou, pour un même lieu de livraison où plusieurs colis seront livrés à plusieurs destinataires, créez plusieurs tâches.
  • Définissez correctement les tâches qui ne sont pas liées à la livraison. Pour les arrêts planifiés, définissez la tâche Type sur SCHEDULED_STOP. Pour les pauses du conducteur, définissez Type sur UNAVAILABLE.
  • Définissez le champ TaskOutcome de manière appropriée. Une fois l'opération terminée, assurez-vous que votre implémentation définit TaskOutcome sur SUCCEEDED ou FAILED. Le simple fait de passer à l'état CLOSED d'une tâche terminée ne respecte pas nos conditions. Vous pouvez définir le résultat de la tâche à l'aide du SDK Driver, de gRPC ou de REST.

Pour en savoir plus, consultez les articles suivants du guide de l'utilisateur de Fleet Engine: