Como enviar XMLs para o Omie no Fiscal.io Monitor (Integração via Omie)

Este artigo ensina como configurar a Integração via Omie no Fiscal.io Monitor para enviar arquivos XML ao Omie. Após a configuração, o envio ocorre conforme o fluxo padrão do Monitor: logo após o Fiscal.io receber o arquivo XML.

Para quem se aplica

• Objetivo: Enviar 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 (Omie): https://ajuda.omie.com.br/pt-BR/articles/499061-obtendo-a-chave-de-acesso-para-integracoes-de-api

2) Máquina executora (obrigatório)

• Definir o Local (computador, servidor ou serviço) que executará o canal de envio.

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):
Para reduzir falhas e evitar envio indevido, configure a integração para enviar somente arquivos XML.

Caminho de acesso

1. No Fiscal.io Monitor, acesse Integrações
2. Clique em Integrar
3. Em Enviar XMLs para Diretório (Pastas), 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 – Enviar XML

2. Objetivo

   • Selecione Enviar 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
   

6. O envio ocorre conforme o comportamento padrão do Monitor: logo após o Fiscal.io receber o arquivo XML (conforme indicado na tela).
   

2) Informar credenciais do Omie

1. Preencha App Key
2. Preencha App Secret

3) Regra importante: enviar somente XML

✅ Ponto importante: selecione/configure a integração para enviar somente arquivos XML.
Isso evita envio de arquivos que não fazem parte do processo e reduz falhas de integração.

Regras e validações

• Obrigatório: App Key e App Secret válidos e da empresa correta no Omie
• Obrigatório: configurar Local
• Gatilho de envio: ocorre logo após o Monitor receber o XML
• Regra essencial: configurar para enviar somente XML

Exemplos práticos

Exemplo 1 — Envio padrão após recebimento

• Canal configurado com objetivo Enviar arquivos XML
• Ao receber um XML no Monitor, o sistema realiza o envio ao Omie automaticamente.

Exemplo 2 — Evitar envio de arquivos indevidos

• Se houver rotinas que geram outros arquivos no mesmo fluxo, mantenha a integração restrita a somente XML.

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) Não envia para o Omie

• Causa comum: Local incorreto/indisponível, falta de internet, credenciais inválidas
• Como resolver: conferir Local, conectividade e credenciais

3) Tentativa de envio de arquivos que não são XML

• Causa: regra de envio não restringida para XML
• Como resolver: ajustar a configuração para enviar somente XML

Perguntas frequentes (FAQ)

1) Quando o envio acontece?
O envio ocorre logo após o Fiscal.io receber o arquivo XML.

2) Preciso definir frequência (Quando)?
Para envio, o comportamento é acionado pelo fluxo padrão (após recebimento do XML), conforme indicado na tela.

3) Posso enviar outros formatos além de XML?
Recomendação: não. Configure para enviar somente XML.