Antes de criar a rotina: verifique se a importação manual funciona
Diversas situações podem impedir a importação das notas via API. Por isso, confira cada item abaixo até que a importação manual funcione.
Confirme a origem das notas e a conclusão da integração
A rotina só importa notas que chegam ao Domínio pela API. Verifique se o escritório utiliza SIEG ou ERP integrado e se a integração está concluída.
Se utiliza SIEG (não é necessário habilitar as empresas no Onvio), acesse o SIEG Hub, faça login, clique em 'Integração Soluções Domínio' e verifique se a integração está concluída, além da Data da Integração. A integração não é retroativa: apenas notas com data de emissão igual ou posterior à data de integração são enviadas ao Domínio. Se a integração não estiver concluída, clique em [Efetuar login de integração], informe os dados de login do Onvio, clique em [Entrar], informe o código de verificação de identidade, clique em [Continuar] e, na mensagem de autorização, clique em [Aceitar].
Se utiliza ERP:
Verifique se o ERP está integrado ao Domínio Sistemas. Acesse o menu ONVIO Gestão > menu API > Chave e confirme se a empresa possui chave gerada com a funcionalidade 'Nota fiscal e Baixa de parcelas - Envio' e consulta habilitada. Confirme se o ERP já incluiu a chave no sistema. Após a liberação pelo ERP, as notas ficam disponíveis no Onvio.
Confira se o Agente de Comunicação está conectado
A comunicação entre Domínio e SIEG ocorre pelo Onvio. Se o indicador do Agente de Comunicação, na barra inferior do sistema, estiver vermelho ou aparecer a mensagem "Usuário ou senha do usuário GERENTE estão inválidos", atualize os dados de acesso ao Onvio do usuário Gerente.
Confira se as notas estão disponíveis e se a importação manual funciona
• Pelo menu Utilitários:
Acesse Utilitários > Importação > Importação Padrão > Importação API, selecione o tipo de nota e clique em [Importar]. O sistema busca as notas disponíveis automaticamente.
• Pelo painel de comunicação (Docs Fiscais):
Clique no ícone Docs Fiscais na barra inferior, selecione a empresa e confira a quantidade de notas disponíveis para importação. Marque os tipos de nota desejados e clique em [Importar documentos].
Se as notas não aparecerem ou a importação não funcionar, revise as configurações:
• Com SIEG, verifique se as notas estão no Cofre SIEG. As notas ficam disponíveis para importação no Domínio até 48 horas após a Data de Envio ao Cofre. O status de envio apresentado pela SIEG não garante que a nota está no cofre.
• Acesse o Onvio, módulo API, e clique em Documentos Fiscais para verificar se as notas chegaram à API do Domínio.
• Com ERP, verifique a habilitação da empresa e a inclusão da chave API no sistema do ERP.
Com a importação manual funcionando, configure a rotina.
Configuração da Rotina
1. Acesse o menu Arquivos > Rotinas Automáticas e crie uma nova rotina para importação de notas via API;
2. Na guia Importação, selecione os tipos de importação via API que serão realizados de forma automática;
3. Ao lado de cada importador escolhido, clique no botão [...];
4. No quadro Filtro, defina se a importação será apenas das notas ainda não importadas ou de todas as notas;
5. No quadro Importar, selecione o tipo de notas que será importado (entradas, saídas, canceladas ou somente cadastros) e clique em [OK];
6. Para NF-e e NFC-e, é possível indicar a quantidade de notas que serão importadas simultaneamente;
7. Preencha o restante das guias e clique no botão [Gravar].
Execução da Rotina
1. Acesse o menu Movimentos > Rotinas Automáticas e crie uma execução para a rotina cadastrada;
2. Na guia Executar, no quadro Agendamento, configure o período de agendamento da rotina, como Mensalmente, o dia, a hora e o mês inicial no campo A partir de;
3. No quadro Competência do Cálculo, no campo Mês, selecione a opção desejada:
1. 'Competência anterior à execução': a rotina considera a competência anterior à data atual do computador. Por exemplo, se a competência atual é 02/2024, a rotina será executada para 01/2024;
2. 'Competência da execução': a rotina considera a competência vigente na data atual do computador;
3. No quadro Rotinas, clique em [Incluir] e informe a rotina de importação via API que será executada;
4. Na guia Empresas, selecione as empresas que irão executar a rotina. Se marcar a opção '[x] Gerar relatórios individualizados por empresa', o botão [...] na coluna Pasta de Destino será habilitado para definir o local de gravação dos relatórios;
5. Clique em [Gravar] para aguardar a execução conforme o agendamento, ou clique em [Executar] para iniciar a rotina imediatamente;
6. Para conferir as importações realizadas, acesse o menu Movimentos > Entradas/Saídas e verifique o campo Origem, onde será exibido 'Importação via API'.
Informações Complementares
• Agende a execução alguns dias após o fim da competência, porque as notas podem levar até 48 horas para ficar disponíveis para importação após o envio ao cofre. Por exemplo, agende para o dia 5 de cada mês;
• Quando selecionada a opção 'Não agendar', no quadro Agendamento, a execução ocorre manualmente e o sistema considera a competência atual em que a rotina é executada;
• Para importação das notas via Rotinas Automáticas, nas configurações de importação, no campo 'Quando o produto a ser importado estiver cadastrado em duplicidade', selecione a opção 'Utilizar o produto de menor código' ou 'Utilizar o produto de maior código';
• As notas ficam disponíveis para importação via API por até 60 dias. Após esse prazo, não são listadas na rotina. Para importá-las, obtenha o XML no portal da prefeitura ou da SEFAZ e importe manualmente em Utilitários > Importação > Importação Padrão;
• A rotina pode ser executada para várias empresas simultaneamente, reduzindo retrabalho e evitando a importação manual a cada competência.