Como funciona o faturamento

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:

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 valor SUCCEEDED.

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 como SCHEDULED_STOP. Para pausas do motorista, defina Type como UNAVAILABLE.
  • Defina o campo TaskOutcome corretamente. Quando a tarefa for concluída, confira se a implementação define TaskOutcome como SUCCEEDED ou FAILED. A simples atualização de uma tarefa concluída para um estado CLOSED 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: