A coleta na rua
Da próxima parada à confirmação da coleta — itens, destino e por que o sistema marca como "pendente validação".
O fluxo da coleta
Cada parada do tipo coleta passa por 3 estados:
Pendente → Carregado (motorista pegou) → Entregue (chegou no destino)
O motorista avança em cada etapa com um botão grande na tela.
Como aparece no app
Após iniciar jornada, o app mostra a próxima parada em destaque:
- Nome do cliente
- Endereço completo
- Tipo: COLETA (badge violeta)
- Posição na rota (#3 de #8)
Botão único embaixo: Iniciar coleta, Cheguei ou Concluir (muda conforme o estado).
Estado: chegando ao cliente
Quando o motorista clica em Cheguei, o app:
- Marca a parada como
in_route - Captura geolocalização em background (informacional — não bloqueia nada se GPS estiver fraco)
- Mostra novo botão: Concluir coleta
Estado: concluindo a coleta
Ao concluir, abre o ConfirmPickupModal. O motorista informa:
| Campo | Por que existe |
|---|---|
| Unidade destino | Pra qual ponto/matriz a coleta vai |
| Itens coletados (opcional) | Separado por tipo: peças, edredom, etc |
Por que destino é obrigatório: garante que a coleta não desaparece no caminho. Se vai pra unidade A ou matriz B, o sistema sabe.
Por que itens é opcional: motorista com pressa pode pular esse passo. A operação confere depois quando recebe o lote.
Por que a coleta NÃO vira receita imediatamente
Esse é o ponto mais importante da aula:
Coleta =
validation_status='pending'. Receita só nasce quando a peça é entregue ao cliente final, depois de processada.
O A7X protege o financeiro de “fantasmas” — não conta como receita qualquer coleta antes de validar de fato.
Falha de coleta
Se o cliente não está, endereço errado, ou motorista é redirecionado:
clica em Falha e abre o FailureReasonModal.
| Motivo | Quando usar |
|---|---|
| Cliente ausente | Bateu, não atendeu |
| Endereço incorreto | Endereço não existe ou diferente do cadastrado |
| Cliente não tem peças | Combinou coleta mas não tinha nada |
| Redirecionado | Cliente pediu pra reagendar |
| Outro | Justificativa livre |
A parada volta pra fila do gestor reagendar. Sem perda de dado, com motivo registrado.
Erros comuns
- Pular destino: o sistema bloqueia o
Concluir coletasem destino selecionado. Não tem como furar. - Marcar como entregue ao invés de coletado: o app só mostra o botão correspondente ao estado da parada. Confusão é difícil.
- Esquecer de selecionar tipo de itens quando houver: opcional, mas ajuda a operação a conferir mais rápido. Quando souber o tipo, marque.
Insight
A coleta é operacional, não financeira. O motorista trabalha com a realidade da rua sem se preocupar com o impacto financeiro — esse vem depois, na validação da operação.
Próximo passo
Coleta concluída ou no fim da rota, hora da entrega. Próxima aula mostra o fluxo completo, com fotos obrigatórias.
Seu progresso fica salvo nesse navegador. Continue de onde parou quando voltar.
Você concluiu essa trilha
Agora você já domina esse processo. Volte e revise quando quiser — ou avance pra próxima trilha do seu papel.
Ver todas as trilhas