Fiscal Pack.

Capturar notas por e-mail (conectar sua caixa de entrada)

Notas fiscaisEquipe Fiscal Pack3 min de leitura
cartão Caixa de e-mail (IMAP) em Configurações fiscais com servidor, porta e usuário preenchidos

Por que conectar o e-mail

No Brasil, muito fornecedor manda o XML da nota (junto com o DANFE) por e-mail. Em vez de alguém abrir cada mensagem, baixar o anexo e importar à mão, o Fiscal Pack lê uma caixa de e-mail sua e importa automaticamente todo XML anexado que encontrar.

Pense nisso como um reforço da captura automática da SEFAZ. Se um documento não veio pela SEFAZ mas caiu no e-mail, ele ainda entra. A dedupe é por chave de acesso: se a mesma nota chegar pelos dois caminhos, ela não duplica.

Antes de começar

Prepare uma caixa de e-mail dedicada só para receber XML (por exemplo, fiscal@sualoja.com.br). Use uma caixa exclusiva, não o e-mail pessoal do dono - a plataforma marca as mensagens como lidas ao processar.

Você vai precisar dos dados de acesso IMAP dessa caixa, que o provedor de e-mail fornece:

  • Servidor (host) e porta de IMAP.

  • Usuário (o endereço de e-mail) e senha.

  • Se usa conexão segura (TLS) e qual pasta varrer (normalmente a Caixa de entrada).

Passo a passo

  1. Vá em Configurações e abra Configurações fiscais.

  2. No cartão Caixa de e-mail (IMAP), preencha Servidor IMAP, Porta, Usuário e Senha.

  3. Confirme a Pasta a monitorar (normalmente INBOX) e marque Usar TLS para conexão segura.

  4. Marque Ingestão ativa e clique em Salvar.

formulário do cartão Caixa de e-mail (IMAP) preenchido, com Usar TLS e Ingestão ativa marcados

Ao ativar, a plataforma faz uma primeira leitura imediata e depois continua varrendo a caixa sozinha. A senha é guardada de forma cifrada e nunca aparece de volta na tela - só o indicador de que já existe uma senha configurada.

Para conferir o estado da captura, abra Configurações > Caixa de entrada e veja o cartão Entrada por e-mail: ele mostra a caixa conectada, o selo Ativa ou Desativada e a data da última leitura.

Remetentes autorizados (opcional)

Você pode restringir a importação apenas aos remetentes autorizados - ou seja, só os e-mails que você marcar como confiáveis têm os anexos importados. Com a lista vazia, qualquer remetente é aceito. A lista fica em Configurações > Caixa de entrada, no cartão Entrada por e-mail: informe o endereço e clique em Autorizar. É uma trava contra XML que caiu na caixa por engano. Há um tutorial dedicado a remetentes autorizados na trilha de Integrações.

O que a plataforma faz com cada mensagem

Para cada e-mail não lido: abre os anexos .xml e .zip, importa cada nota, deduplica por chave e marca a mensagem como lida. Um .zip com vários XMLs é expandido automaticamente. Anexos que não são XML são ignorados.

Fique atento

  • A captura por e-mail é um suplemento, não substitui a captura automática da SEFAZ. A SEFAZ é a fonte oficial; o e-mail é o reforço.

  • Se as importações pararem, o motivo mais comum é senha trocada no provedor ou a caixa ter travado o acesso IMAP. Reabra o cartão Caixa de e-mail (IMAP) em Configurações fiscais e confira os dados.

Próximo passo

Com SEFAZ e e-mail ligados, quase tudo entra sozinho. Para o que precisar entrar na mão (um histórico antigo, um arquivo avulso), o próximo tutorial mostra o envio manual de XML.

Continue aprendendo