Como capturar XMLs do Omie no Fiscal.io Monitor (Integração via Omie)

Este artigo mostra como configurar a Integração via Omie no Fiscal.io Monitor para capturar (receber) arquivos XML do Omie automaticamente. Você define os tipos de documentos e a data inicial (ponteiro), e o sistema mantém o ponteiro atualizado para buscar apenas novos XMLs nas próximas execuções.

Para quem se aplica

• Objetivo: Receber arquivos XML
• Perfis: Fiscal, Administrativo, Implantação/Onboarding (ou perfis equivalentes com acesso a integrações)
• Permissões: acesso ao módulo Integrações e permissão para configurar canais/rotinas
• Observação: a execução ocorre na máquina definida em Local
  

Pré-requisitos

1) Credenciais do Omie (obrigatório)

• App Key
• App Secret
  Como obter: https://ajuda.omie.com.br/pt-BR/articles/499061-obtendo-a-chave-de-acesso-para-integracoes-de-api

2) Máquina executora (obrigatório)

• Defina o local (computador, servidor ou serviço) responsável por executar o canal.

3) Internet liberada (obrigatório)

• A máquina do Local deve ter acesso à internet para comunicação com o Omie.

Atenção (integração fiscal):
Credenciais incorretas (App Key/App Secret) podem impedir a captura. Sempre valide as chaves antes de ativar o canal.

Caminho de acesso

1. No Fiscal.io Monitor, na barra superior, no canto esquerdo.
2. Clique em Integrar
3. Em Buscar XMLs em Diretórios (Pasta), clique em Configurar Integração
4. No campo Meio, selecione Integração via Omie

Como utilizar (passo a passo)

1) Configurar o canal

Na tela Fiscal.io – Canal de Comunicação (Passo 01), preencha:

1. Nome

   • Ex.: Integração Omie – Receber XML

2. Objetivo

   • Selecione Receber arquivos XML

3. Meio

   • Selecione Integração via Omie

4. Local (computador, servidor ou serviço)

   • Selecione a máquina/servidor responsável

5. Quando (frequência)

   • Defina a periodicidade de execução
     ✅ Frequência mínima: 60 minutos

2) Informar credenciais do Omie

1. Preencha App Key
2. Preencha App Secret

Dica: use copiar/colar para evitar erros de digitação.

3) Definir os tipos de documentos e o ponteiro (data inicial)

Na área Ponteiros de leitura dos documentos:

1. Em Tipo, selecione quais documentos serão capturados (ex.: NF-e Entrada)
2. Em Ponteiro (aaaa.mm.dd), informe a data inicial (ex.: 2025.01.01)

O que é “Ponteiro”?
É a data a partir da qual a busca começa. Depois de cada execução, o sistema mantém esse ponteiro atualizado conforme a última busca realizada, para evitar trazer sempre o mesmo período.

4) Opções adicionais (opcional)

1. Verificar a validade jurídica dos XMLs durante a importação
2. Atribuir etiqueta ao receber os arquivos XML
3. Habilitar rastreabilidade (para facilitar consulta de logs)

Regras e validações

• Obrigatório: App Key e App Secret válidos e da empresa correta no Omie
• Obrigatório: configurar Local e Quando
• Frequência mínima: 60 minutos
• Recomendado: cadastrar ao menos um Tipo e o respectivo Ponteiro
• Ponteiro é sensível:
  • Data muito antiga → pode gerar alto volume na primeira execução
  • Data muito recente → pode “pular” documentos esperados

Exemplos práticos

Exemplo 1 — Primeira configuração (implantação)

• Tipo: NF-e Entrada
• Ponteiro: 2025.01.01
• Frequência: 60 minutos
• Resultado esperado: primeira execução busca a partir do ponteiro; próximas execuções trazem apenas novos XMLs.

Exemplo 2 — Reprocessar um período

• Ajuste o ponteiro para uma data anterior ao período desejado.
• Atenção: dependendo das regras do sistema, isso pode resultar em tentativa de importar XMLs já processados.

Mensagens/Erros comuns e como resolver

1) Falha de autenticação / integração não conecta

• Causa comum: App Key/App Secret incorretos
• Como resolver: validar as chaves no Omie e preencher novamente

2) Canal não executa / não captura nada

• Causa comum: Local aponta para máquina indisponível/sem internet
• Como resolver: conferir Local, conectividade e permissões

3) Não retorna documentos

• Causa comum: ponteiro muito recente ou tipo errado
• Como resolver: revisar Tipo e ajustar o Ponteiro

Perguntas frequentes (FAQ)

1) Qual a menor frequência permitida?
A frequência mínima é 60 minutos.

2) Posso capturar mais de um tipo de documento?
Sim. Você pode adicionar mais linhas na tabela de ponteiros (cada uma com seu Tipo e Ponteiro).

3) O que acontece se eu mudar o ponteiro?
O sistema passa a buscar a partir da nova data. Se você voltar o ponteiro, pode trazer períodos anteriores novamente.