Como integrar o Fiscal.io Monitor ao Domínio e automatizar o envio de XMLs (Onvio API)

Como integrar o Fiscal.io Monitor ao Domínio e automatizar o envio de XMLs (Onvio API)

O Fiscal.io Monitor envia os XMLs para o Domínio Fiscal pela API Onvio (Thomson Reuters). No escritório, o Domínio recebe esses documentos e você importa (manual ou automática) na Escrita Fiscal.

Visão do fluxo

  1. O escritório gera a chave de API no Onvio Gestão e habilita a empresa.
  2. No Monitor, o canal Domínio : Onvio API envia o XML.
  3. No Domínio, os documentos ficam disponíveis para importação (barra DOCS FISCAIS / Importação API).
  4. Opcional: configure Rotinas Automáticas na Escrita Fiscal para lançar sem intervenção manual.

Parte 1 — No Domínio: gerar a chave e receber documentos

Gerar a chave de API (Onvio Gestão)

Faça uma vez por empresa cliente que vai receber XMLs do Fiscal.io:

  1. Acesse o ONVIO Gestão e o menu API.
  2. Na guia Chave, clique em Nova habilitação.
  3. Em Descrição, dê um nome à chave e avance.
  4. Habilite o uso da funcionalidade e avance.
  5. Selecione a empresa e clique em Transferir.
  6. Clique em Concluir e guarde a chave — ela será informada no Monitor.

Passo a passo oficial da Domínio: Como gerar chave API para integração com ERP homologado.

Agente de Comunicação

Depois que o Monitor começa a enviar, o escritório precisa do Agente de Comunicação com Domínio Atendimento iniciado e com status verde (usuário GERENTE). Se estiver vermelho ou parado, os XMLs transmitidos não chegam ao Domínio.

Ajuda Domínio: verifique as soluções de Agente de Comunicação / status vermelho na mesma central de soluções.

Onde os documentos aparecem

Após o envio bem-sucedido, as notas ficam disponíveis para importação no Domínio — na barra inferior, ao lado de DOCS FISCAIS (junto com BOX-e, Busca NF-e, Web Service SEFAZ e outras origens de API).

Tipos suportados pela importação via API (conforme Domínio): NF-e, NFC-e, NFS-e, CF-e, CT-e, CT-eOS e baixas de parcelas.

FAQ oficial: Perguntas e Respostas — Importação API.

Importar no Domínio (manual)

Duas formas (conforme Domínio):

Pelo menu Utilitários

  1. Acesse Utilitários → Importação → Importação Padrão → Importação API.
  2. Selecione o tipo de nota (NF-e, NFS-e, CF-e etc.).
  3. Clique em Importar — o sistema busca as notas disponíveis na API (não precisa apontar pasta).

Pelo painel Docs Fiscais

  1. Clique no ícone Docs Fiscais na barra inferior.
  2. Selecione a empresa — o painel mostra quantidade de notas (entrada, saída, serviços, canceladas).
  3. Marque os tipos desejados e clique em Importar documentos.

Guia Domínio: Como importar notas através da API.

Observação: em geral entram notas a partir da data em que a integração foi parametrizada. Documentos ficam disponíveis na API por até 60 dias (conforme Domínio).

Importação automática (Rotinas Automáticas)

Para o Domínio lançar sozinho as notas que chegaram pela API:

  1. Acesse Arquivos → Rotinas Automáticas e crie uma nova rotina de importação via API.
  2. Na guia Importação, marque os importadores de API desejados (ex.: NF-e API, NFC-e API, NFS-e API, CF-e API, CT-e etc.).
  3. Em cada importador, use [...] para definir entradas/saídas e demais opções.
  4. Em seguida, em Movimentos → Rotinas Automáticas, crie a execução: agendamento (diário, semanal…), competência e empresas.
  5. Grave ou execute. Nas Entradas/Saídas, o campo Origem aparece como Importação via API.

Passo a passo oficial: Como configurar e executar a rotina automática para Importações via API.

Parte 2 — No Fiscal.io Monitor: enviar os XMLs

Antes de começar

  • Chave de API Onvio já gerada no Domínio (Parte 1).
  • Monitor com o recurso Domínio Onvio API liberado no plano.
  • Empresa (filial) cadastrada no Monitor.
  • Computador ou servidor definido como Local, com internet.

Abrir o canal

  1. Na barra superior, clique em Integrar.
  2. Clique em Gerenciar Canais de Integração.
  3. Clique em Adicionar (ou edite um canal existente).
  4. Em Meio, selecione Integração via Domínio : Onvio API.
  5. Em Objetivo, selecione Enviar arquivos XML.
  6. Informe Nome, Local e a frequência (Quando).
  7. Selecione a(s) empresa(s) do canal.

Aba Domínio : Onvio API

A grade Lista de habilitação no ONVIO : Chaves de API de Clientes:

  • Filial : CNPJ/CPF — empresa do Monitor (somente leitura).
  • Chave — chave de API Onvio daquela empresa (gerada no Domínio).

Sem chave em alguma filial o canal não salva. Use Testar Conexão... para validar. O link Saiba mais abre a ajuda do Domínio sobre a chave.

Confirmar entrega

  • Marcado — duas etapas: envia o XML e depois confirma o processamento no Onvio. Só então o Monitor marca o documento como exportado.
  • Desmarcado — uma etapa: só envia, sem esperar a confirmação de processamento.

Enviar cópia para BOX-e

Marque somente se o contrato Domínio tiver BOX-e e você quiser esse armazenamento na nuvem (serviço extra da Domínio, tipicamente por cerca de 5 anos). Sem BOX-e no contrato, deixe desmarcado.

Se algo não funcionar

  • No Domínio: Agente de Comunicação verde? Empresa habilitada na chave? Notas em DOCS FISCAIS?
  • No Monitor: chave correta por CNPJ? Testar Conexão ok? Local online? Recurso liberado no plano?
  • Se usou BOX-e, confirme o serviço no contrato Domínio.
  • Em dúvida, use o chat do Monitor ou o suporte Domínio, conforme o lado do problema.

Saiba mais no site da Fiscal.io

Contexto de produto sobre entrega de XML e integração contábil:

Artigos relacionados