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
- O escritório gera a chave de API no Onvio Gestão e habilita a empresa.
- No Monitor, o canal Domínio : Onvio API envia o XML.
- No Domínio, os documentos ficam disponíveis para importação (barra DOCS FISCAIS / Importação API).
- 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:
- Acesse o ONVIO Gestão e o menu API.
- Na guia Chave, clique em Nova habilitação.
- Em Descrição, dê um nome à chave e avance.
- Habilite o uso da funcionalidade e avance.
- Selecione a empresa e clique em Transferir.
- 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
- Acesse Utilitários → Importação → Importação Padrão → Importação API.
- Selecione o tipo de nota (NF-e, NFS-e, CF-e etc.).
- Clique em Importar — o sistema busca as notas disponíveis na API (não precisa apontar pasta).
Pelo painel Docs Fiscais
- Clique no ícone Docs Fiscais na barra inferior.
- Selecione a empresa — o painel mostra quantidade de notas (entrada, saída, serviços, canceladas).
- 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:
- Acesse Arquivos → Rotinas Automáticas e crie uma nova rotina de importação via API.
- 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.).
- Em cada importador, use [...] para definir entradas/saídas e demais opções.
- Em seguida, em Movimentos → Rotinas Automáticas, crie a execução: agendamento (diário, semanal…), competência e empresas.
- 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
- Na barra superior, clique em Integrar.
- Clique em Gerenciar Canais de Integração.
- Clique em Adicionar (ou edite um canal existente).
- Em Meio, selecione Integração via Domínio : Onvio API.
- Em Objetivo, selecione Enviar arquivos XML.
- Informe Nome, Local e a frequência (Quando).
- 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.