A entrega com prova fotográfica

Por que a entrega é mais rigorosa que a coleta

Coleta: peça vai pra fábrica, fácil de rastrear se algo divergir. Entrega: peça sai do controle do A7. Se cliente alegar que recebeu errado ou que não recebeu nada — sem prova, é palavra contra palavra.

A entrega no A7X exige prova fotográfica + checklist por tipo.

Estados da entrega

Pendente → Carregado (saiu da matriz) → No local → Entregue

Cada transição é um clique no botão grande do app. Sem mistério.

Estado: chegando ao cliente

Botão Cheguei atualiza pra in_route. Igual à coleta.

Estado: concluindo a entrega

Botão Concluir abre o CompleteStopModal. Aqui o motorista:

1. Tira fotos (obrigatório, mín. 1)

• Da peça entregue
• Da assinatura do recibo (se for caso)
• Do recibo digital
• De qualquer documento que valide a entrega

Limite: até 3 fotos por entrega. Comprime e envia automaticamente. Funciona com câmera do celular sem nenhum app extra.

2. Marca checklist (obrigatório)

Lista varia por tipo de peça/cliente:

• ✓ Cliente conferiu as peças
• ✓ Embalagem em ordem
• ✓ Cliente assinou recibo
• ✓ Pagamento recebido (se for “pagar na entrega”)

Todos os itens precisam estar marcados pra liberar o Confirmar.

3. Geo capturada em background

Enquanto o motorista preenche, o app pega coordenadas no fundo. Aparece no card como “Localização OK” (verde), “Localizando…” (cinza) ou “Sem localização” (âmbar).

Importante: Sem GPS não bloqueia a entrega. É informacional — protege em caso de auditoria, mas o motorista continua o fluxo normalmente.

Por que a entrega gera receita

Quando o motorista confirma, o app dispara advanceStop com stopType: "delivery" e newStatus: "delivered". No backend:

1. orders.status = 'delivered'
2. settleDeliveryReceivable liquida o receivable correspondente
3. financial_entries ganha entrada de receita com competence_month = data de entrega
4. DRE do mês reflete a receita imediatamente

Esse é o único momento em que receita aparece no DRE — não no orçamento, não no envio à produção. Só na entrega real.

Falha de entrega

Mesmo FailureReasonModal da coleta. Cliente ausente, recusa, dano — tudo registrado com motivo. A parada volta pra fila de reagendamento.

Erros comuns

• Pular foto: bloqueado. Sem foto, sem entrega.
• Marcar checklist sem ler: dor de cabeça depois. Cliente ligou reclamando? Olho no checklist — se “cliente conferiu” estava marcado e não conferiu de verdade, a equipe sabe quem foi.
• Foto fora de foco / muito escura: sistema aceita, mas em auditoria pode não servir. Foto boa é proteção do motorista.

Insight

Cada entrega registra 5 evidências: foto, checklist, geo, hora, motorista. Em qualquer disputa futura, a empresa tem prova. O motorista também — não fica sozinho na palavra.

Próximo passo

Mas e quando a internet cai? Próxima aula: como o app se comporta sem rede e por que o A7X escolheu não ter fila offline.