Devolução do lote e o faturamento automático

O que acontece após expedição

Quando a última peça da remessa termina expedição, o lote está pronto pra voltar pro ponto de coleta. No painel Remessas Recebidas da matriz, a remessa volta a aparecer — agora com botão azul Devolver.

Por que esse botão é diferente

Os outros botões da operação (concluir setor, etc) são reversíveis ou idempotentes. O Devolver não:

• Marca todas as ordens como prontas pra retorno
• Gera faturamento das comandas entregues
• Manda a remessa de volta pra unidade de origem

Por isso o A7X exige confirmação modal antes de executar (Sprint Guerra Bloco 2 — fix UX).

Como funciona a confirmação

Click em Devolver abre dialog com contexto:

• ID da remessa (ex: #A1B2-3C4D)
• Origem (qual ponto de coleta vai receber)
• Quantidade de OS (quantas comandas vão voltar)
• Aviso explícito: “Esta operação não pode ser desfeita pelo PDV.”

Botões:

• Cancelar (não muta nada — fecha o dialog)
• Confirmar devolução (executa)

Por que este modal existe: antes do fix, um clique acidental devolvia a remessa inteira. Operador via, ficava em pânico, e o caos logístico já estava feito. Agora: 2 cliques deliberados.

O que o sistema faz quando você confirma

A RPC return_remessa é atômica e faz tudo em uma transação:

1. Marca cada ordem como ready_for_dispatch (pronta pra entregar)
2. Gera receivable se a comanda foi paga antecipadamente
3. Cria payable com a parte do industrial (se houver acordo matriz↔ponto)
4. Envia notificação automática pro ponto de coleta
5. Status da remessa vira returned

Tudo em segundos. Mesmo lote com 200 ordens.

Idempotência

Se o operador clicar Confirmar duas vezes (rede ruim, duplo-toque), a segunda chamada não duplica nada. INSERT ... ON CONFLICT DO NOTHING em payables/receivables.

O que NÃO acontece

• Não gera receita ainda — receita só sai do A7X quando o cliente final recebe a peça no ponto de coleta (via PDV → Entregar)
• Não baixa estoque (estoque é gerenciado em outro fluxo)
• Não dispara cobrança automática ao cliente final

A devolução é operacional + faturamento entre unidades. Receita real vem só na entrega ao cliente.

Erros comuns

• Clicar Devolver com produção incompleta: o sistema permite devolver mesmo se nem toda peça passou pela expedição? Sim, mas não faça. Se uma peça ficou perdida, ela vai voltar como “ausente” e o cliente vai cobrar.
• Devolver pra unidade errada: é a unit_id original da remessa — imutável. Mas conferir antes evita o pânico.
• Esperar o cliente final ser notificado: não é. A unidade de origem recebe a remessa e ela mesma notifica o cliente. Outra camada.

Insight

A devolução é o ponto onde operação encontra finanças. O auto-faturamento entre unidades elimina conferência manual mensal — matriz e ponto de coleta sempre têm os números batendo.

Próximo passo

Tudo dito, mas como o gestor vê se a produção está rodando bem? Última aula da trilha: indicadores e auditoria.