maria.supplyDocumentação← Site

Dúvidas frequentes

FAQ

As dúvidas mais comuns sobre o envio dos arquivos e os disparos de e-mail. Se a sua pergunta não estiver aqui, fale com o time de suporte da maria.supply.

Sobre os arquivos

Posso enviar planilha do Excel (.xlsx) em vez de CSV?+

Não. A esteira processa apenas CSV. Ao exportar do Excel, use "Salvar como → CSV UTF-8". Os formatos de data do Excel (serial numérico) são aceitos, mas o arquivo em si precisa ser CSV.

Enviei o arquivo de pedidos depois das 14:00 UTC. O que acontece?+

A execução do dia roda sem ele: o arquivo é procurado exatamente no horário do processamento. Os pedidos daquele dia só serão avaliados quando aparecerem no arquivo de um próximo dia útil — por isso, disparos com regra de dia exato (como o lembrete D−3) podem ser perdidos.

Minhas datas estão em dd/mm/yyyy. Funciona?+

Não — 05/02/2026 é tratado como data vazia. Use o formato ISO (2026-02-05) ou o serial do Excel. Uma data vazia tira o pedido dos disparos: sem data_agendamento não há lembrete; sem data_recebimento_previsto não há cobrança.

O que acontece com linhas sem cod_fornecedor?+

Elas não geram cadastro nem pedido. O nome do fornecedor (se preenchido) fica registrado na lista de fornecedores não encontrados do processamento, para que a base seja corrigida no arquivo seguinte.

O mesmo pedido aparece em várias linhas do arquivo. Tem problema?+

Não — é o esperado quando o pedido tem vários itens (uma linha por item). Os dados do pedido (datas, flag, contatos) são lidos da primeira linha em que ele aparece; as demais linhas só acrescentam itens.

Como atualizo o e-mail de um fornecedor?+

Envie um CSV para <seu-ambiente>/emails/ com as colunas cod_fornecedor e email. A atualização é imediata (disparada pela chegada do arquivo) e vale a partir do próximo processamento. Detalhes na página Padrão de arquivos.

Sobre os disparos de e-mail

Por que um pedido não gerou e-mail?+

As causas mais comuns, em ordem de frequência:

  • Nenhum dos três e-mails comerciais preenchido (email_analista, email_gerente_comercial, email_assistente_comercial).
  • Data em formato inválido — vira nula e o pedido sai da regra de disparo.
  • flag_agendamento com valor diferente de agendado / sem agenda.
  • Hoje simplesmente não é um dia de disparo para aquele pedido (D−3 ou cadência).
  • O dia de disparo caiu em fim de semana, quando a esteira não roda.
O fornecedor recebe o e-mail diretamente?+

Não. As notificações vão para o time comercial responsável pelo pedido (analista, gerente e assistente informados na carteira), que faz o contato com o fornecedor.

Quantas cobranças um pedido sem agenda recebe?+

Depende do prazo: as cobranças seguem a cadência (a cada round((prazo_entrega − 3) ÷ 3) dias, de data_pedido + 1 até data_recebimento_previsto − 3). Depois que a previsão de recebimento vence, o pedido passa a ser cobrado em toda execução até ser agendado ou sair da carteira.

Um fornecedor pode receber mais de um e-mail no mesmo dia?+

No máximo um por tipo: os pedidos do fornecedor que dispararam no dia são reunidos em um único e-mail (agrupados por unidade). Um fornecedor com lembrete e cobrança no mesmo dia recebe os dois e-mails, um de cada tipo.

O pedido foi agendado ontem. A cobrança para quando?+

Para no dia em que o pedido chegar na carteira com flag_agendamento = agendado (e data_agendamento preenchida). A esteira sempre lê o estado do arquivo do dia — mantê-lo atualizado é o que interrompe as cobranças.

Feriado conta como dia útil?+

A esteira roda de segunda a sexta, sem calendário de feriados. Em feriados que caem em dia de semana o processamento acontece normalmente — se não quiser disparos, basta não enviar o arquivo do dia.