Este manual explica como usar o app, passo a passo, do upload do XML até o envio do e-mail de agendamento.
Antes de começar
No topo da tela fica uma barra fixa com:
- Remetente — seu e-mail, usado apenas como referência no rascunho gerado.
- 💾 Salvar sessão / 📂 Carregar sessão — salva ou recupera todo o trabalho em andamento (todas as entregas de uma vez) em um arquivo
.json. Útil para continuar depois ou não perder o progresso.
- Um contador (ex: "3 NF(s) · 2 entregas · 5 produtos") e um indicador de pendências — quando aparecer ⚠ vermelho, clique nele para ir direto ao próximo campo que falta preencher, em qualquer etapa.
O app segue 5 passos, sempre nesta ordem, e não deixa avançar para o próximo enquanto houver pendências na etapa atual.
Passo 1 — Upload de XMLs
- Arraste ou clique na área de upload e selecione um ou mais arquivos
.xml das NF-e — pode subir várias notas de uma vez, mesmo de destinos diferentes.
- Para cada XML, o app extrai automaticamente: número da NF, série, data, fornecedor, UF de destino e os produtos (com Código TM, Num/Item PO e quantidade, quando disponíveis no XML).
- O destino (CDL) é definido sozinho a partir da UF do XML. Se aparecer o aviso ⚠ destino?, escolha manualmente no campo "Destino (CDL)" daquele card — isso acontece quando a UF não é uma das mapeadas ou quando a NF foi criada sem XML.
- Se quiser anexar o PDF (DANFe) daquela nota, use a área de upload de PDF dentro do mesmo card.
- Precisa cadastrar uma NF sem XML? Use o link "+ Adicionar NF manualmente" no topo da lista.
- Quando todas as NFs tiverem um destino definido, clique em "Próximo: Agrupar por Destino".
Passo 2 — Entregas por Destino
Aqui o app já agrupou as NFs automaticamente por destino — cada CDL vira um card de "entrega" com a lista das NFs que pertencem a ele.
- Em cada card, preencha a Data de Agendamento (SAP) daquela entrega — o campo fica destacado em amarelo até ser preenchido.
- Se alguma NF aparecer marcada como "sem destino" no topo da lista, volte ao Passo 1 para resolver.
- Clique em "Próximo: Dados & IMEIs".
Passo 3 — Dados & IMEIs
Para cada entrega, revise os produtos de cada NF:
- Confira Código TM, Num PO, Item PO e Quantidade — a maioria já vem do XML. Se faltar TM, digite o Código CPH correspondente: se for um modelo conhecido, o TM e a Descrição são preenchidos automaticamente.
- Cole os IMEIs em lote na caixa de texto (formato: IMEI1 + tab/vírgula + IMEI2, um par por linha) e clique em "⬆ Importar". O contador mostra se a quantidade de IMEIs bate com a Quantidade informada.
- Pode ajustar IMEIs individualmente, adicionar pares avulsos (+ Par) ou limpar tudo (🗑) direto na lista.
- Quando tudo estiver completo (sem avisos amarelos/vermelhos), clique em "Próximo: Review".
Passo 4 — Review
Cada entrega mostra o preview completo do e-mail: assunto, tabela de produtos e texto formatado.
Para enviar, duas opções:
- Recomendado: clique em "⬇ Baixar rascunho (.eml)" — gera um arquivo que abre direto no Outlook, já com Para, CC, Assunto e o corpo prontos, e com XML, PDF, TXT de IMEIs e Excel já anexados. É só abrir, conferir e enviar.
- Alternativa manual: use a checklist numerada (Copiar Para → CC → Assunto → Corpo) para montar o e-mail você mesmo no Outlook, colando cada campo na ordem.
Dependendo da configuração do Outlook, o .eml pode abrir pronto para enviar ou em modo de leitura — nesse caso, use "Encaminhar" ou "Editar Mensagem" antes de enviar.
Passo 5 — Exportar
Para cada entrega, um pacote de arquivos fica disponível:
- 📄 Rascunho (.json) — salva os dados daquela entrega específica (para reabrir depois ou guardar como registro).
- ⬇ Baixar ZIP desta entrega — reúne XML, PDF, TXTs de IMEI e a planilha Excel daquele destino num único arquivo.
- A lista mostra cada arquivo individualmente, com um indicador verde/vermelho avisando se algo está faltando (por exemplo, um PDF ainda não anexado).
Perguntas frequentes
Uma NF veio com a UF errada ou não reconhecida — e agora?
No Passo 1, edite o campo "Destino (CDL)" daquela NF manualmente, escolhendo o CDL correto na lista.
Posso continuar o trabalho depois?
Sim — use "💾 Salvar sessão" no topo (salva tudo) ou "📄 Rascunho (.json)" no Passo 5 (salva só aquela entrega). Ao carregar um rascunho depois, ele soma ao que já estiver na tela, não substitui.
Preciso re-anexar os arquivos XML/PDF depois de carregar um rascunho?
Sim — por segurança, o rascunho .json não guarda o conteúdo dos arquivos, só o nome. O app avisa quais precisam ser re-anexados ao carregar.
O .eml não abriu pronto pra enviar no meu Outlook, e agora?
Use "Encaminhar" ou "Editar Mensagem" para liberar a edição, ou recorra à checklist manual do Passo 4 como alternativa.
Dica: o indicador de pendências (⚠) na barra do topo é clicável em qualquer tela — ele leva direto ao campo que está faltando preencher.