Fiscal.io Connect : Requisitos para novas integrações

Fiscal.io Connect: Requisitos para novas integrações


Este recurso permite que o usuário realize a conciliação fiscal de um período desejado com 2 cliques dentro do Fiscal.io Monitor.

O sistema conecta com o banco de dados do ERP ou sistema contábil e retorna quando os documentos foram escriturados para a tela do Fiscal.io Monitor, de 5 em 5 minutos, cruzando com seu banco de XMLs oficial buscado da SEFAZ e atualiza o status em tempo real.

Dessa forma, o usuário pode saber, a qualquer momento, quais documentos já foram escriturados, quais estão pendente de escrituração, ou quais estão escriturados no ERP e cancelados na SEFAZ, por exemplo, eliminando necessidade de conciliação fiscal através de planilhas.

Veja abaixo os requisitos técnicos.

Integrações atuais

Abaixo, listamos os sistemas já integrados ao Fiscal.io Monitor através do Fiscal.io Connect:

  1. Domínio Sistemas (Thomson Reuters);
  2. SAP Business One (Standard ou com SAP Hana);
  3. UniSystem: Compass ERP;
  4. TOTVS: Sistema RM;
  5. TOTVS: PROTHEUS;
  6. ALTERDATA Contábil e Fiscal;
  7. Kacique Sistemas: KS Agro;
  8. AS Sistemas: Auditor Net;
  9. ECOSIS;
  10. SAP ECC e SAP HANA;
  11. Rodopar Visual (DataPar);
  12. InforLN (Baan);
  13. Agrotis (AgroTI);
  14. Agrogestão (Agro1)
  15. Sistema Versa (Versa Partner);
  16. Questor Fiscal;
  17. SSPlus (AutMaster);
  18. StartSoft;
  19. WSGE Gestão Empresarial;
  20. Gênesis ERP;
  21. Linx DMS Apollo;
  22. Unisystem Mosayco ERP;
  23. SCI Único ERP;
  24. ERP Callisto;
  25. Fiscal.io: Padrão (ver tópico Integração padrão no final deste documento). 
Caso a data de busca (ponteiro) seja definida, a busca retroativa será de 90 dias.

Além da conexão via banco de dados, é possível entregar os registros de escrituração no Fiscal.io Monitor via API.  Para saber mais consulte a documentação: Como enviar registro de escrituração de documentos fiscais via API para o Fiscal.io Monitor.

Requisitos técnicos

Para conectar o Fiscal.io Monitor a outros sistemas é necessário obtermos informações técnicas para modelar a integração entre os dois softwares. Sendo elas:

1. Tipo de banco de dados

O software externo deverá utilizar um dos seguintes sistemas de banco de dados:

  1. SAP Sql Anywhere (Sybase);
  2. Microsoft SQLServer;
  3. Oracle;
  4. Mysql *Oracle ou MySQLMariaDB;
  5. PostgreSQL;
  6. SAP Hana;
  7. Firebird.

2. Ambiente de rede

O Fiscal.io Monitor deverá ter permissão para conectar no banco de dados conforme endereço e porta de conexão, e a liberação do firewall se a conexão for via web.

É necessário que a aplicação e o banco de dados de destino estejam comunicáveis via TCP/IP (dentro de uma mesma rede ou em nuvem) .
Para realizar a conexão com o banco de dados é preciso das seguintes informações: Endereço IP do servidor de banco de dados, porta, usuário e senha.

3. Mapeamento de tabelas

Para realizar a conectividade, precisamos o mapeamento das seguintes tabelas e campos no banco de dados do sistema externo.
Para cada um dos campos devemos ter a informação do seu tipo e do seu tamanho.

Tabelas obrigatórias

Tabela de Cadastro de empresas
Campo: Identificador (chave primária) 
Campo: Nome da Empresa
Campo: Estado/UF
Campo: CNPJ/CPF
Campo: Inscrição Estadual
Se o cadastro do estado/UF não forem duas letras (exemplos: MT, SP, RJ, MG), é necessário que seja informado a tabela de registros destes códigos.
Caso a IE/inscrição estadual seja um local diferente, é necessário que seja informada a tabela e o relacionamento para se chegar nos registros.
Tabela de Notas Fiscais de Entrada
Campo: Chave de acesso 
Campo: Número do Documento
Campo: Data de Entrada (considerada no SPED)
Campo: Data de Registro (lançamento da nota)
Campo: Usuário de Registro (quem lançou)
Campo: Código da Empresa
Campo: Situação do Documento
Campo: Número do documento fiscal (referência fiscal)

Nome da Tabela de Notas Fiscais de Saída
Campo: Chave de acesso
Campo: Número do Documento
Campo: Data de Emissão (considerado no SPED)
Campo: Data de Registro (lançamento da nota)
Campo: Usuário de Registro (quem lançou)
Campo: Código da Empresa
Campo: Número do documento fiscal (referência fiscal)
Para o campo usuário de registro, caso seja preenchido por código do usuário é necessário que seja enviado a tabela com o mapeamento dos usuários
Tabelas opcionais
Tabela de Certificados Digitais
Campo: Senha (como decodificar)
Campo: Conteúdo do Certificado
Tabela de arquivos XMLs das notas de saída
Campo: Chave de acesso
Campo: Conteúdo do XML
Necessário que seja enviado uma amostragem de 10 registros de todas as tabelas.

Integração Padrão

É possível realizar a integração utilizando um modelo padrão de comunicação chamado "Fiscal.io - Padrão".

Esta integração se aplica a clientes que utilizam sistemas ERP não listados  no item "Integrações atuais" e que não queiram contratar o desenvolvimento de uma integração específica para seu ERP com a empresa Fiscal.io.

Neste cenário, o cliente precisa criar no seu banco de dados views ou tabelas conforme os dicionários de dados descritos abaixo.

O nome dos objetos (views ou tabelas) devem terminar conforme demonstrado abaixo, porém as letras iniciais são abertas para qualquer texto.

Exemplo: A view filiais pode ser criada no banco de dados com o nome fiscal_filiais ou view_filiais.

Nome da View: filiais

Objetivo: Retornar a relação de pessoas jurídicas ou pessoas físicas que terão os documentos fiscais pelo Fiscal.io Monitor.

CamposTipoTamanhoDescrição
codigointeiroCódigo da empresa no sistema ERP
identstring14CNPJ ou CPF
iestring14Inscrição estadual
nomestring60Nome da pessoa jurídica ou pessoa física
estufvarchar2Sigla do Estado
ativobooleanoInformar se a empresa está ativa ou inativa

Nome da View :  entradas

Objetivo: Retornar a relação dos documentos de entrada (NFe, CTe, CFe SAT, etc) escriturados no sistema ERP

CamposTipoTamanhoDescrição
filialinteiroCódigo da empresa no sistema ERP
docnumstring14Número do documento no sistema ERP
dockeystring44Chave do documento
dtdigidataData de registro do documento
dtlancdataData que o documento é reconhecido pela contabilidade ou SPED
usuariostring150Usuário que registrou o documento

Nome da View:  saidas

Objetivo: Retornar a relação dos documentos de saída (NFe, CTe, CFe SAT, etc) emitidos pelo sistema ERP

CamposTipoTamanhoDescrição
filialinteiroCódigo da empresa no sistema ERP
docnumstring14Número do documento no sistema ERP
dockeystring44Chave do documento
dtemitdataData de remissão do documento
dtautodataData de autorização do documento na SEFAZ
usuariostring150Usuário que emitiu o documento





        • Related Articles

        • Fiscal.io Connect: Como integrar o Fiscal.io Monitor com seu sistema de gestão

          O Fiscal.io Monitor é completo com automações para ajudar os processos fiscais, contábeis e logísticos da empresas. O objetivo é eliminar processos manuais salvando tempo e esforço dos colaboradores, assim como garantir conformidade fiscal mitigando ...
        • Vantagens em utilizar o SAP GRC Inbound com o Fiscal.io Monitor Enterprise

          O Fiscal.io Monitor Enterprise apresenta vantagens importantes na substituição do SAP GRC Inbound como componente de monitoramento e download de XMLs de documentos de entrada (NFe, CTe, MDFe e eventos). A recomendação de substituição se atém apenas ...
        • Como enviar XMLs do SAP GRC NFe para o Fiscal.io Monitor

          A forma mais simples de integrar os XMLs de saída no Fiscal.io Monitor é utilizando um e-mail para transferência dos documentos. Este artigo descreverá como fazer isso a partir do SAP GRC NFe. Criar e-mail É necessário criar um e-mail para receber os ...
        • Integrações

          O que é a funcionalidade de integração? Com o Monitor de Documentos Fiscais da Fiscal.io você pode importar e exportar os arquivos XML de diversas fontes e destinos, o que pode resolver grandes questões e automatizar os processos. Vale a pena você ...
        • Como exportar um relatório do Fiscal.io Monitor em Excel

          Todos os Relatórios Especiais do Fiscal.io Monitor são exportáveis em Excel. É impressionante a simplicidade e eficiência da exportação das informações! Veja mais sobre neste artigo. Principais usos Relatórios sobre a documentação fiscal são de ...