根据 Google Maps Platform 最后一公里舰队解决方案 (LMFS) 条款的规定,在与运单相关的任务成功完成后,可结算交易将发生。
Task 对象是一种基本对象类型,在 LMFS Deliveries API 中跟踪和报告可结算交易方面发挥着关键作用。我们的条款要求您为驾驶员的任务正确建模并适当地记录 TaskOutcome
。这样可确保正确记录所有可结算交易。对于签约客户,请参阅适用于您产品的报告要求:
什么是计费任务?
可计费任务是指成功完成装运的任何任务:将一件或多件商品从唯一发货人运送到唯一收件人。失败的配送任务不计费。
下表介绍了可计费任务和不可计费任务的一些实际场景。
场景 | 是否可结算? |
---|---|
司机尝试递送包裹,但这次尝试成功。例如,接收者直接收到包裹,或者司机将包裹留给邻居。 | 是 |
驱动程序在为该软件包声明的预期时间范围内分发了软件包。 | 是 |
司机报告配送成功,但收货人后来对包裹的接收提出了异议。 | 是 |
司机尝试递送包裹,但未能成功。例如,需要签名的收件人不在家,或者地址错误。 | 否 |
司机安排休息或停车。 | 否 |
Deliveries API 内部是如何结算的?
在以下情况下对任务进行计费:
Task 的类型设置为
delivery
。自提任务不会触发结算,预定的间歇或停靠站不符合条件。每项可计费交易都必须具有关联的传送任务。对于送至站点的第一英里取货订单,可以在取货地点模拟提货任务,并在取货点模拟送货任务。TaskOutcome
的值为SUCCEEDED
。
首次将 TaskOutcome
更新为 SUCCEEDED
时,Last Mile Fleet Solution Deliveries API 会创建一个可计费事件。如果发生这种情况,该 SKU 的结算指标就会递增。该任务的任何后续更新都不会影响此结算指标,该指标无法在首次设置结果后递增或递减。
您应该如何为任务建模?
本部分提供了基本建议,帮助您检查是否已根据我们的条款及条件正确设置任务。
- 为配送任务设置正确的字段。将任务类型设置为
delivery
,分配唯一的任务 ID,并为每项任务的完成指定正确的位置。确保每件货品都有送货任务。 - 为每个发货人-收件人组合创建单独的任务。例如,对来自多个发货人的单个收件人使用两项任务。或者,对于单个递送位置(其中有多个包裹会递送给多个收件人),您可以创建多个任务。
- 正确定义非发货任务。对于计划停靠站,请将任务
Type
设置为SCHEDULED_STOP
。对于驱动程序中断,请将Type
设置为UNAVAILABLE
。 - 适当设置
TaskOutcome
字段。任务完成后,请确保您的实现将TaskOutcome
设置为SUCCEEDED
或FAILED
。仅将已完成的任务更新为CLOSED
状态并不符合我们的条款。您可以使用 Driver SDK、gRPC 或 REST 设置任务结果。
如需了解详情,请参阅以下 Fleet Engine 用户指南主题: