Estados

Nesta seção, vamos apresentar os estados de uma entrega no Shippify e ajudar a vinculá-los aos da sua plataforma.

Ciclo de vida

Para que uma entrega seja completada, ela deve passar por uma série de mudanças de estado, as quais detalhamos na seguinte imagem.

Estados de una entrega

Estados Iniciais

Quando uma entrega é criada no sistema, ela pode ser criada com o estado 'Processando', o que significa que a tarefa foi criada com sucesso e está pronta para ser atribuída. Quando é criada como 'Pendente de Revisão', significa que houve um erro na geolocalização, seja no endereço de coleta ou de entrega, e é necessário que um operador corrija o endereço para que possa passar para o estado 'Processando' e continuar o fluxo."

Atrelar

Para vincular uma entrega a um motorista, existem duas opções: colocá-la no estado de 'Transmissão' (a entrega é publicada na rede de motoristas para que um deles a aceite no aplicativo móvel) ou atribuí-la diretamente a um motorista (este processo é realizado por um operador no painel, e ao atribuí-la, não significa que o motorista aceitou a tarefa).

Coleta

Quando um motorista aceita a entrega pelo aplicativo móvel ou quando um operador a atribui pelo painel e o motorista a aceita no aplicativo, ela passa para 'Confirmado para Coleta'. Após confirmar a coleta, o motorista indica no aplicativo quando está a caminho para a coleta. Por fim, ao chegar ao armazém, o motorista marca no aplicativo que já está no ponto de coleta. Durante todo esse processo, o motorista pode rejeitar a entrega, alterando seu estado para 'Não Coletado'.

Coleta sem sucesso

Durante todo esse processo de coleta, o motorista pode rejeitar a entrega, alterando seu estado para 'Não Coletado', deixando assim a entrega sem motorista atribuído. Sob esse estado, podem ser configuradas razões para descrever o motivo da mudança ou rejeição, como problemas com o veículo

Entrega

Quando o motorista já está na bodega, procede-se à digitalização e verificação dos pacotes da entrega. No caso de a entrega pertencer a uma rota, o mesmo processo deve ser realizado para cada uma. Durante este processo, a tarefa está com o estado 'Em Entrega'. Após a conclusão da verificação, ela passa para 'A Caminho da Entrega' e posteriormente para 'No Ponto de Entrega' quando chegar ao endereço acordado.

Entrega sem sucesso

Durante todo esse processo de entrega, o motorista pode optar por não concluir a entrega, alterando o status para 'Em Resguardo pelo Motorista'. Nesse estado, podem ser configuradas razões para descrever o motivo da alteração, como, por exemplo, o cliente não estar no local de entrega. O motorista pode tentar a entrega novamente até um máximo de 3 vezes. Se conseguir realizar a entrega, a tarefa continua no fluxo verde. Caso contrário, segue o fluxo vermelho, que devolve o pacote à bodega, marcando a entrega como retornada.

Estados Finais

Após realizar a entrega dos pacotes ao destinatário, é solicitado no aplicativo comprovantes de entrega, como fotos ou assinatura da pessoa que recebe o pacote. Uma vez entregues os comprovantes, a tarefa muda para o estado 'Completado', finalizando assim o ciclo de vida da tarefa.

Cancelamento

Em qualquer etapa do fluxo, a entrega pode ser cancelada, seja por integração externa do API ou no painel. Ao cancelar, a entrega fica sem motorista atribuído. Sob este estado, podem ser configuradas razões para descrever o motivo da mudança, por exemplo, cliente cancelou o pedido.

Códigos de estado

Estado da entrega	Código	Descrição
Pendente de revisão	pending_to_review	Uma entrega é criada com informações ausentes de coleta ou entrega (contato, localização) e precisa ser revisada.
Processando	processing	Uma entrega é criada com sucesso na plataforma.
Buscando motorista	broadcasting	Uma entrega foi publicada na rede de motoristas.
Atrelada	assigned	Uma entrega foi atribuída a um motorista.
Confirmado para coleta	confirmed_to_pickup	A entrega foi confirmada para ser realizada por um motorista.
Em caminho para coleta	going_to_pickup	O motorista está a caminho do local de coleta.
No ponto de coleta	at_pickup	Um motorista está no local de coleta.
Em entrega	on_delivery	Motorista a caminho da entrega.
Em rota de entrega	going_to_dropoff	Um motorista está a caminho do endereço de entrega.
No ponto de entrega	at_dropoff	Um motorista está no endereço de entrega.
Entregue	dropped_off	Um motorista está aguardando o comprovante de entrega (foto, assinatura, dados do destinatário).
Completado	completed	Um motorista concluiu com êxito uma entrega.
Cancelado	canceled	Uma entrega foi cancelada.
Em rota de devolução	going_to_return	Um motorista está a caminho do local de coleta para devolver uma entrega.
No ponto de devolução	at_return_point	Um motorista está no local de coleta para devolver uma entrega.
Devolvido	returned	Um motorista devolveu com sucesso uma entrega.
Não coletado	not_picked_up	Um motorista informou que uma entrega não foi coletada.
Não coletado cobrável	not_picked_up_payable	Um motorista informou que uma entrega não foi coletada, mas será remunerado.
Em pose do motorista	hold_by_courier	Uma entrega está retida pelo motorista atribuído até que uma nova tentativa seja feita ou seja devolvida ao endereço de coleta.

Motivos e problemas

Se precisar especificar a razão pela qual uma tarefa mudou para um estado, você pode configurar, no estado de sua preferência, os motivos desejados. Esses motivos explicarão ou fornecerão mais detalhes sobre a mudança. Se em seu sistema externo houver um estado que não exista em nossa lista, você pode vinculá-lo ao mais semelhante e criar um motivo que o identifique melhor. Geralmente, esses motivos são adicionados aos estados de "retido pelo motorista" e "cancelado".

Exemplos

Estado na Shippify	Motivos	Estados Externos
hold_by_courier	Recusado pelo cliente	Recusado pelo cliente
hold_by_courier	Cliente ausente	Cliente ausente
canceled	Pacote perdido	Pacote perdido
canceled	Cancelado pelo cliente	Cliente cancelou

Criação

Pode criar esses motivos dentro do painel, acessando este link. Aqui você encontra razões do sistema que pode reutilizar e, caso não encontre a indicada, pode criá-la.

Pasos

1. Entre neste link.

2. Selecione um estado.

3. Revisa se não existe no sistema um motivo similar ao teu. Se existir, adiciona-o à tua companhia; caso contrário, crie um.

Motivos de problemas de entrega

Link de estados com plataforma externa

Já que você conhece os estados e motivos dentro do nosso sistema, pode proceder a vinculá-los com o seu sistema. Para ter uma visão melhor disso, você pode seguir o exemplo da nossa documentação nesta plantilla e preencher-la.

Aqui você encontrará uma tabela na qual você deve preencher as informações dos estados em seu sistema e como seriam equivalentes no Shippify.

Plantilla

Passos

1. Liste os estados da sua plataforma na coluna azul.

2. Encontre o estado equivalente no Shippify. Você pode se ajudar fazendo as seguintes perguntas:

   1. É um estado que ocorre antes da coleta dos pacotes no depósito?

      • Quando é recém criado/agendado?

      • Quando está procurando motorista?

   2. É um estado que ocorre durante o processo de coleta?

   3. É um estado que ocorre durante o processo de entrega?

   4. É um estado que indica que aconteceu algum problema?

      • No processo de coleta

      • No processo de entrega

      • Geral

   5. É um estado que indica que a entrega foi feita com sucesso?

3. Se você precisar de mais detalhes para um estado ou se o mesmo estado na Shippify corresponder a dois ou mais estados da sua plataforma, então adicione motivos à esse estado.

Quando já tiver sua tabela preenchida, poderá continuar a configurar a sincronização de estados no seu sistema.