Como parte dos termos da Last Mile Fleet Solution (LMFS), da Plataforma Google Maps, uma transação faturável ocorre quando as tarefas associadas a um envio são concluídas.
O objeto Task é um tipo fundamental de objeto que desempenha um papel fundamental
no rastreamento e na geração de relatórios de transações faturáveis na API LMFS Deliveries.
Nossos termos exigem que você modele as tarefas do motorista corretamente e registre o
TaskOutcome
adequadamente. Isso garante que todas as transações faturáveis sejam registradas corretamente. Para clientes contratados, consulte os requisitos de relatórios aplicáveis ao produto:
- Requisitos de relatórios da solução Last Mile Fleet
- Requisitos de relatórios de serviços de mobilidade
O que é uma tarefa faturável?
Uma tarefa faturável é qualquer tarefa que conclui uma remessa com sucesso: o transporte de um ou mais itens de um remetente exclusivo para um destinatário exclusivo. Tarefas de remessa com falha não são faturáveis.
A tabela a seguir fornece alguns cenários reais para tarefas faturáveis e não faturáveis.
Cenário | Faturável? |
---|---|
Um motorista tentou entregar um pacote, e a tentativa foi bem-sucedida. Por exemplo, o destinatário recebeu diretamente ou o motorista deixou o pacote com um vizinho. | Sim |
um motorista entregou um pacote fora do prazo indicado para ele. | Sim |
Um motorista informou que uma remessa foi bem-sucedida, mas o destinatário mais tarde contestou o recebimento. | Sim |
Um motorista tentou entregar um pacote, mas ocorreu uma falha. Por exemplo, o destinatário não tinha uma assinatura obrigatória ou o endereço estava errado. | Não |
um motorista fizer uma pausa ou parada programada; | Não |
Como ocorre o faturamento na API Deliveries?
Uma tarefa é faturada nas seguintes condições:
A tarefa tem um tipo definido como
delivery
. As tarefas de retirada não acionam o faturamento, e as pausas ou paradas programadas não se qualificam. Cada transação faturável precisa ter uma tarefa de entrega associada a ela. As retiradas na primeira milha de um depósito podem ter a tarefa de retirada modelada no local de coleta e a tarefa de entrega modelada no depósito.O
TaskOutcome
tem o valorSUCCEEDED
.
A API Last Mile Fleet Solution Deliveries cria um evento faturável na primeira
vez que um TaskOutcome
é atualizado com um valor de SUCCEEDED
. Quando isso acontece, a métrica de faturamento da SKU é incrementada. As atualizações subsequentes dessa tarefa
não afetam essa métrica de faturamento, que não pode ser incrementada ou reduzida
depois que o resultado é definido pela primeira vez.
Como você deve modelar suas tarefas?
Nesta seção, fornecemos recomendações básicas para ajudar você a verificar se você definiu corretamente suas tarefas de acordo com nossos Termos e Condições.
- Defina os campos corretos para tarefas de envio. Defina o tipo de tarefa como
delivery
, atribua um ID de tarefa exclusivo e especifique o local correto para a conclusão de cada tarefa. Certifique-se de que cada remessa tenha uma tarefa de entrega. - Crie tarefas separadas para cada combinação entre remetente e destinatário. Por exemplo, use duas tarefas para um único destinatário de vários remetentes. Ou, para um único local de entrega em que vários pacotes serão entregues a vários destinatários, crie várias tarefas.
- Defina corretamente as tarefas que não são de envio. Para paradas programadas, defina a tarefa
Type
comoSCHEDULED_STOP
. Para pausas do motorista, definaType
comoUNAVAILABLE
. - Defina o campo
TaskOutcome
corretamente. Quando a tarefa for concluída, confira se a implementação defineTaskOutcome
comoSUCCEEDED
ouFAILED
. A simples atualização de uma tarefa concluída para um estadoCLOSED
não está de acordo com nossos termos. Você pode definir o resultado da tarefa usando o SDK do Driver, o gRPC ou o REST.
Para mais informações, consulte os seguintes tópicos do guia do usuário do Fleet Engine: