Sistema de gestão de entregas para entregadores

O problema

• O despacho funciona na base de ligações, WhatsApp e um quadro branco, então ninguém tem uma visão única de qual entregador tem capacidade: os serviços são atribuídos em duplicidade ou caem, e um pedido urgente não encontra o entregador disponível mais próximo.
• O comprovante de entrega vive em romaneios de papel ou na galeria pessoal do celular de um entregador, então quando um cliente contesta 'nunca recebemos' não há assinatura, foto ou GPS para puxar e a cobrança é dada por perdida.
• As primeiras tentativas frustradas — normalmente de 8% a 20% das entregas de última milha, com os erros de endereço sozinhos causando cerca de 45% delas — viram, sem alarde, custos de reentrega (cerca de 17,78 dólares por pacote frustrado) sem motivo de exceção registrado e sem nova tentativa agendada.
• Vazamentos no faturamento: tempo de espera, paradas extras, horário noturno e adicionais de quilometragem nunca passam da memória do entregador para a fatura, e cada cliente está numa tabela de preços diferente, então a mesma corrida é faturada de forma inconsistente.

Um dia com o sistema

1. Uma conta de cliente agenda uma coleta no mesmo dia pelo seu portal (ou o despacho registra um pedido por telefone): endereços de coleta e entrega, janelas de horário, quantidade de volumes e nível de serviço — o serviço cai como 'não atribuído' no painel.
2. O despacho o atribui ao entregador disponível mais próximo cuja zona e veículo combinem; o serviço aparece no celular daquele entregador em ordem de parada, à frente do trabalho posterior dele se for urgente.
3. O entregador toca em 'a caminho da coleta', chega, confere os volumes e marca 'coletado' com marca de tempo — o rastreamento do cliente vira coletado automaticamente.
4. Na entrega, o entregador captura uma assinatura, uma foto do pacote na porta e o GPS; o serviço vira 'entregue' e o comprovante de entrega fica guardado naquela parada, sem poder ser editado depois.
5. Na entrega seguinte não tem ninguém em casa — o entregador registra a exceção recipient_not_home, tira uma foto da porta fechada, e o serviço vira 'frustrado'; o sistema coloca uma nova tentativa na fila e avisa o cliente em vez de engolir o custo em silêncio.
6. No meio da tarde entra um pedido urgente; o despacho o coloca no topo da fila do entregador disponível mais próximo sem rearranjar tudo na mão.
7. O tempo de espera numa doca de carga e uma parada adicionada são anexados ao serviço como adicionais enquanto a corrida ainda está fresca, para que de fato cheguem à fatura.
8. No fim do período, os serviços entregues são somados por cliente na tabela de preços dele numa fatura com cada comprovante de entrega anexado, pronta para enviar nas condições de pagamento.

Onde a IA erra

• Tratar uma entrega como um único endereço: um serviço de entrega é uma coleta E uma entrega (às vezes uma coleta e muitas entregas), cada uma com a sua própria janela de horário e a sua própria prova. Achate isso para um único 'endereço de entrega' e você perde a marca de tempo da coleta, as rotas com várias paradas e o comprovante de entrega por parada.
• Comprovante de entrega como um item dispensável: a assinatura, a foto com marca de tempo, o GPS e o nome de quem recebe são a evidência que ganha os estornos e as contestações de não entrega. A captura precisa estar amarrada à parada e à hora reais e não pode ser editável depois, ou ela não vale nada no instante em que um cliente alega que o pacote nunca chegou.
• Só 'entregue' versus 'não entregue': sem uma taxonomia explícita de exceções o app não consegue distinguir destinatário ausente de endereço errado de recusado, não consegue disparar a nova tentativa certa e não consegue faturar ou isentar corretamente. Modele exception_code como um campo de primeira classe, não como uma anotação de texto livre.
• A armadilha da classificação trabalhista: se os seus entregadores são autônomos (contratados independentes), ditar as rotas, os horários e os métodos exatos deles é um dos fatores que podem reclassificá-los como empregados e te expor a verbas atrasadas, impostos e multas. Guarde worker_type e mantenha mais leves os controles voltados ao contratado — isso é exposição regulatória real, não uma preferência de interface. Não é aconselhamento jurídico; consulte o teste da sua jurisdição.
• Um preço único por serviço: a mesma corrida é faturada de forma diferente conforme o contrato do cliente, e o tempo de espera, as paradas extras, o horário noturno e os adicionais de quilometragem são onde está a margem. Um único quoted_price sem adicionais e sem tabela de preços por cliente subfatura, em silêncio, todo dia movimentado.

Perguntas frequentes

Em que um serviço de entrega difere de um único endereço de entrega?

Um serviço de entrega é uma coleta e uma entrega — e às vezes uma coleta com muitas entregas —, cada uma com o seu próprio contato, janela de horário e prova. O app modela a coleta e a entrega como paradas distintas do serviço, então você mantém a marca de tempo da coleta, pode montar rotas com várias paradas e anexar o comprovante de entrega à parada exata onde ele aconteceu, em vez de a um único 'endereço de entrega' achatado.

O que conta como comprovante de entrega válido, e ele se sustenta numa contestação?

Um comprovante de entrega eletrônico sólido combina a assinatura de quem recebe, uma foto com marca de tempo do pacote no ponto de entrega, coordenadas GPS, o nome de quem recebe e quaisquer anotações do entregador, tudo capturado no aparelho do entregador no momento da entrega. Como o app amarra cada um desses itens a uma parada e a uma hora específicas e não deixa que sejam editados depois, a evidência existe antes da contestação — que é exatamente o que resolve a seu favor um estorno de 'nunca recebemos'.

O que acontece quando uma entrega falha na primeira tentativa?

O entregador registra uma exceção explícita — destinatário ausente, endereço errado, recusado, acesso negado — e tira uma foto. O serviço vira 'frustrado', o app coloca uma nova tentativa na fila e avisa o cliente automaticamente. Como as primeiras tentativas frustradas costumam ficar entre 8% e 20% das entregas de última milha a cerca de 17,78 dólares cada, capturar o motivo é o que deixa você reentregar, refaturar ou isentar de forma deliberada em vez de absorver o custo às cegas.

Posso dar aos clientes o próprio rastreamento e faturar cada um na sua própria tabela de preços?

Sim. Cada cliente tem uma tabela de preços e condições de pagamento, os adicionais são anexados aos serviços individuais e os serviços entregues são somados numa fatura por cliente com cada comprovante de entrega anexado. Você pode rodar tudo como um portal voltado ao cliente mais um back office de despacho no seu próprio domínio, hospedado na ybuild — os clientes acompanham os próprios serviços pelo fluxo de status enquanto a sua equipe trabalha o painel de despacho, tudo em um único sistema que é de fato seu.

Meus entregadores são autônomos — esse app vai criar um problema de classificação?

O app guarda worker_type em cada entregador e é construído para você documentar as entregas sem controlar demais como os autônomos trabalham. A classificação depende em grande parte de quanto você controla a rota, os horários e os métodos — ditar os três empurra um autônomo para o status de empregado. Mantenha os controles que você aplica aos entregadores autônomos mais leves que os aplicados aos empregados e trate isso como uma questão de desenho operacional, não como uma chave de configuração. Isto é orientação geral, não aconselhamento jurídico — consulte o teste de vínculo trabalhista da sua jurisdição.