Pedidos com frete Retirada na associação passam a usar um código de 6 caracteres (ex.: LBKUJ7) como prova de que o paciente — ou alguém por ele autorizado — pode buscar o pedido no balcão. O objetivo é reduzir retiradas indevidas sem complicar a operação: o paciente recebe o código quando o pedido está pronto; a equipe valida na hora de lançar a retirada.

Como funciona o código
- Geração — o código é criado junto com o pedido de retirada (checkout ou pedido assistido no painel).
- Formato — 6 caracteres em maiúsculas, sem caracteres ambíguos (sem 0, O, 1, I).
- Unicidade — cada código é único dentro da associação.
- Revelação ao paciente — somente quando o status do pedido é Aguardando retirada, após a separação.
Experiência do paciente
Quando a equipe libera o pedido na separação:
- O paciente recebe um e-mail transacional «Pronto para retirada» com o código, o endereço da associação e instruções.
- Na área do associado (Meus pedidos), o mesmo código aparece no detalhe do pedido — apenas nessa etapa.
- No balcão, o paciente informa ou mostra o código para a equipe validar.
Terceiro autorizado: qualquer pessoa com o código válido pode retirar. O sistema registra o nome de quem efetivamente retirou (pode ser diferente do nome informado no checkout, desde que o código esteja correto).
Experiência da equipe (balcão)
Por segurança, o código não é exibido no card Retirada do painel enquanto o pedido aguarda retirada. A equipe deve pedir o código ao paciente e digitá-lo no dialog Lançar retirada.
- Código de retirada (obrigatório) — validado no servidor; espaços são ignorados (
L B K U J 7=LBKUJ7). - Quem retirou (obrigatório) — nome de quem está no balcão; fica no histórico do pedido.
- Selfie com documento (opcional) — foto anexada no lançamento, disponível para auditoria depois da retirada.
O fluxo mantém os gates já existentes: pedido pago, separação concluída, prescrição conferida e impressão da receita original confirmada antes de liberar «Lançar retirada».
Depois da retirada (auditoria)
Quando o pedido passa para Retirado:
- O código utilizado fica visível no card Retirada do painel — apenas para registro interno.
- Quem retirou e horário ficam no snapshot do pedido e nas notas internas.
- Divergência entre o nome do checkout e quem retirou gera nota de auditoria automática.
- Ação
ORDER_PICKUP_CONFIRMEDregistrada na trilha de auditoria.
O paciente deixa de ver o código na loja após a retirada — o código deixa de ser exposto nas APIs públicas.
Por onde começar
- Confirme que a associação oferece Retirada na associação em Configurações de frete.
- Treine a equipe do balcão: pedir código → dialog «Lançar retirada» → validar nome.
- Faça um pedido teste até Aguardando retirada e confira o e-mail + loja.
- Lance a retirada com o código e revise o registro no pedido retirado.
Perguntas frequentes
O código aparece antes do pagamento? Não. Só após a separação liberar o pedido para retirada.
E se o paciente perder o e-mail? O código continua disponível na loja, na etapa Aguardando retirada. A equipe nunca consulta o código no painel antes da retirada — o paciente precisa apresentá-lo.
Posso retirar sem código? Não. A confirmação exige código válido, além dos demais requisitos operacionais.