Etapa 2 - Configuração POP3/IMAP

Passo 2 - Configuração POP3 / IMAP

Nesta etapa se configura a conta de e-mail (caixa de entrada) de onde a Central XML® vai receber os arquivos XML dos fornecedores e transportadoras, e/ou a pasta de onde os XMLs serão importados por diretório.

A leitura pode ser feita de três formas:

Somente e-mail: “Xml por Email ou Diretório/Pasta” marcado e “Força Leitura Email e Diretório” desmarcado;
Somente diretório: os dois campos desmarcados — os XMLs são lidos da pasta informada;
Híbrido: “Força Leitura Email e Diretório” marcado — lê a caixa de e-mail e também a pasta.

Campos da tela

Campo	Parâmetro	Tipo	Padrão	Orientação
Protocolo Email	‣	Lista	POP3	`POP3` ou `IMAP`. Com IMAP a rotina exige a seção `[MAIL]` com `Protocol=IMAP` e `Folder=Inbox` no `appserver.ini`.
Servidor POP	‣	Caractere	`mail.meuservidorpop.com.br`	Host do servidor de recebimento POP3 ou IMAP (ex.: `outlook.office365.com`, `imap.gmail.com`).
Porta	‣	Numérico	110	Usualmente 110 (POP3), 995 (POP3 com SSL), 143 (IMAP) ou 993 (IMAP com SSL).
Login	‣	Caractere	`meu_usuario_pop`	Usuário da caixa de entrada que recebe os XMLs.
Senha	‣	Caractere	`senha1234`	Senha da conta. Para `outlook.office365.com` a rotina obtém automaticamente o token OAuth a partir do login e senha.
Usa SSL (Conexão Segura)	‣	Lógico	Não	Marque quando o servidor exigir conexão segura (portas 995/993).
Xml por Email ou Diretório/Pasta (Recebe via Email)	‣	Lógico	Sim	Marcado: os XMLs são lidos dos anexos dos e-mails. Desmarcado: os XMLs são lidos da pasta informada abaixo.
Diretório/Pasta Arquivos XML	‣	Caractere	`c:\centralxml\`	Pasta mapeada de onde os XMLs são importados na leitura por diretório. A pasta interna da Central XML® no RootPath (‣, padrão `\nf-e\`) não é alterada por esta tela.
Salva Anexos Pdf no RootPath?	‣	Lógico	Não	Grava também os PDFs anexos aos e-mails na pasta das NF-e abaixo do Protheus_data.
Força Leitura Email e Diretório (Híbrido)	‣	Lógico	Sim	Marcado: lê os e-mails e também a pasta (modo híbrido).
Exibe Botão Receber E-mails?	‣	Lógico	Sim	Exibe na tela da Central XML® o botão para o usuário disparar manualmente a leitura dos e-mails.

O que acontece ao clicar em Avançar

O teste de conexão só é feito quando “Recebe via Email” ou “Híbrido” está marcado:

IMAP: verifica a seção [MAIL] do appserver.ini. Se faltar Protocol=IMAP ou Folder=Inbox, pergunta se deve gravá-las (respondendo Não, a etapa não avança). Garante SSLVersion=2, conecta ("Conexão IMAP OK!") e mostra, para cada pasta da conta, nome, status, nº de mensagens, recentes e não lidas.
POP3: verifica se [MAIL] Protocol=POP3 está configurado e oferece gravá-lo, garante SSLVersion=2, aplica o time-out da Etapa 1 e conecta ("Conexão POP OK!").
Com o teste OK, grava protocolo, servidor, porta, login, senha e SSL.

Em todos os casos são gravados os campos de forma de leitura, pasta, PDF e botão Receber E-mails, e o Wizard avança para a Etapa 3 - Parâmetros Fiscais.

<aside> ⚠️

Se a leitura for somente por diretório (os dois campos desmarcados), os dados de servidor, porta, login e senha não são testados nem gravados.

</aside>

Mensagens de erro mais comuns

Mensagem	Causa provável / ação
Falta configuração de E-mail (IMAP/POP3)	A seção `[MAIL]` do `appserver.ini` não tem o protocolo escolhido. Responda Sim para a rotina gravar a chave ou ajuste o arquivo manualmente.
Falha ao conectar Imap / Falha ao conectar	Servidor, porta, login/senha ou SSL incorretos, ou acesso IMAP/POP desabilitado na conta.
Falha ao setar o TimeOut	Revise o Time-Out informado na Etapa 1.