Regras de negócio
Disparos de e-mail
A cada execução (segunda a sexta, 14:00 UTC), a maria.supply avalia a carteira do dia e decide, pedido a pedido, se envia um lembrete de entrega ou uma cobrança de agendamento. O que define o fluxo é a coluna flag_agendamento do arquivo de pedidos.
Quem recebe os e-mails
As mensagens vão para o time comercial responsável pelo pedido — os endereços informados nas colunas email_analista, email_gerente_comercial e email_assistente_comercial da carteira (endereços repetidos são enviados uma única vez).
- É enviado um e-mail por fornecedor, reunindo todos os pedidos dele que dispararam no dia.
- Dentro do e-mail, os pedidos são agrupados por unidade (coluna
local_entrega). - Fornecedor sem nenhum dos três e-mails preenchidos não gera envio.
- Cada envio é registrado em histórico, e um mesmo fornecedor não recebe o mesmo tipo de e-mail duas vezes no mesmo processamento.
Lembrete de entrega (pedidos agendados)
Vale para pedidos com flag_agendamento = agendado. A regra é uma só:
Regra de disparo
O lembrete é enviado quando hoje = data_agendamento − 3 dias. Ou seja: entrega agendada para 19/07 gera lembrete em 16/07.
- Pedido sem
data_agendamento(ou com data em formato inválido) não gera lembrete. - O disparo acontece apenas no dia exato. Se o pedido não estiver na carteira daquele dia, o lembrete não é enviado.
- Como a esteira não roda em fins de semana, agendamentos cujo "D−3" cai em sábado ou domingo não recebem lembrete.
Como o e-mail chega
Nos exemplos abaixo usamos o cliente fictício Acme — o nome da sua operação e o remetente são configurados no onboarding e aparecem no assunto e na assinatura.
Prezado Fornecedor ALIMENTOS BOA MESA LTDA
Lembramos que há uma entrega programada em nosso Centro de Distribuição conforme dados abaixo:
Dados do Agendamento:
Unidade: CD SAO PAULO | Data: 19/07/2026
• Pedido 557201
Em caso de qualquer imprevisto que impossibilite o cumprimento do agendamento, solicitamos comunicação imediata.
Atenciosamente,
Agendamento – Acme
E-mail: agendamento@acme.com.br
Cobrança de agendamento (pedidos sem agenda)
Vale para pedidos com flag_agendamento = sem agenda. Aqui o envio segue uma cadência de cobrança calculada a partir de três colunas do arquivo: data_pedido, data_recebimento_previsto e prazo_entrega.
1 · Frequência entre cobranças
frequência (dias) = arredonda( (prazo_entrega − 3) ÷ 3 )
O arredondamento sobe quando a fração é ≥ 0,6 — ex.: prazo de 15 dias → (15−3)÷3 = 4 → cobrança a cada 4 dias; prazo de 8 dias → 1,67 → a cada 2 dias; prazo de 13 dias → 3,33 → a cada 3 dias.
2 · Janela de cobrança
As datas de cobrança começam em data_pedido + 1 dia e vão até data_recebimento_previsto − 3 dias, espaçadas pela frequência acima.
3 · Regra de disparo do dia
A cobrança é enviada hoje se…
- hoje é uma das datas da cadência; ou
- a previsão de recebimento já venceu (nesse caso o pedido é cobrado em toda execução, até ser agendado ou sair da carteira).
Pedido sem previsão de recebimento não é cobrado
Se data_recebimento_previsto estiver vazia ou em formato inválido, o pedido nunca entra na cadência — por isso a coluna é obrigatória para pedidos sem agenda. O mesmo vale para prazo_entregaausente ou de até 4 dias (frequência < 1): a cadência fica vazia e o pedido só é cobrado depois que a previsão vence.
Exemplo completo
| Dados do pedido | data_pedido = 01/07 · data_recebimento_previsto = 16/07 · prazo_entrega = 15 |
| Frequência | (15 − 3) ÷ 3 = 4 → a cada 4 dias |
| Janela | de 02/07 até 13/07 (16/07 − 3) |
| Cobranças | 02/07, 06/07 e 10/07 (o passo seguinte, 14/07, cai fora da janela) |
| Após 16/07 | previsão vencida → cobrança em toda execução enquanto o pedido seguir sem agenda |
Lembrando: os disparos só acontecem em dias úteis. Se uma data da cadência cair no fim de semana, aquela cobrança específica não é enviada.
Como o e-mail chega
Prezado Fornecedor ALIMENTOS BOA MESA LTDA,
Informamos que os pedidos abaixo permanecem sem agendamento de entrega, comprometendo nosso abastecimento.
Pedidos Críticos Sem Agendamento:
Unidade: CD SAO PAULO | Data: 25/07/2026
• Pedido 557202
Solicitamos posicionamento formal e agendamento imediato. Caso contrário, poderão ser adotadas as medidas:
- Cancelamento do pedido
- Avaliação de performance do fornecedor
- Revisão da parceria comercial
Atenciosamente,
Agendamento – Acme
E-mail: agendamento@acme.com.br
Na reincidência (2ª cobrança), o assunto muda para PEDIDO SEM AGENDA (2ª COBRANÇA) - [Fornecedor] e o corpo passa a abrir com "Reiteramos" em vez de "Informamos".
Resumo rápido
| Fluxo | Condição | Quando dispara | Assunto |
|---|---|---|---|
| Lembrete | flag_agendamento = agendado | 3 dias antes da data_agendamento | CONFIRMAÇÃO DE ENTREGA |
| Cobrança | flag_agendamento = sem agenda | cadência de data_pedido+1 até data_recebimento_previsto−3, ou diariamente após a previsão vencer | PEDIDO SEM AGENDA |