Introdução

A Plataforma SkyTax360° opera a partir da ingestão estruturada de dados operacionais e fiscais provenientes dos ambientes de gestão empresarial (ERP) das organizações. Para possibilitar o pleno funcionamento dos módulos analíticos e garantir acurácia nos diagnósticos, é necessário estabelecer um processo de integração técnica entre os sistemas da organização e a infraestrutura da plataforma.

Esta documentação descreve a arquitetura de integração, os métodos de coleta, os dados envolvidos, os requisitos técnicos e os padrões de segurança adotados. A leitura deste documento é recomendada para equipes técnicas envolvidas no processo de implantação e integração da solução.

Visão Geral da Integração

A plataforma disponibiliza duas modalidades de integração para ingestão de dados:

• Integração assistida via aplicação local (Data Collector)

  Aplicação desktop instalada no ambiente da organização, responsável por extrair e transmitir os dados de forma automatizada e segura. Para realizar a instalação, é necessário entrar em contato com a equipe de suporte técnico, que fornecerá todos os recursos e orientações necessárias.

• Integração direta via API pública RESTful

  Interface de comunicação exposta para recebimento de dados extraídos diretamente por sistemas internos da organização. Os detalhes dessa modalidade estão descritos na seção Integração via API - Data Collector desta documentação.

Ambas as abordagens seguem princípios de segurança, rastreabilidade e compatibilidade com padrões corporativos de mercado.

Arquitetura da Integração com Data Collector

Visão Funcional

O Data Collector é uma aplicação desktop leve, desenvolvida em arquitetura modular, destinada a realizar a coleta automatizada dos dados diretamente do banco de dados utilizado pela organização. Todo o processo ocorre em modo de leitura, sem qualquer intervenção ou modificação na base de origem.

Ambientes Suportados

A aplicação pode ser executada em ambientes internos controlados, como:

• Servidores locais (on-premises);
• Estações de trabalho com acesso autorizado;
• Ambientes virtualizados (VM);
• Infraestruturas com acesso via redes privadas (VPN), quando aplicável.

Banco de Dados Compatíveis

• Microsoft SQL Server;
• Oracle Database.

Requisitos de Conectividade

Para estabelecer a conexão entre o Data Collector e o banco de dados da organização, são necessários os seguintes parâmetros:

As credenciais são armazenadas localmente de forma criptografada e utilizadas exclusivamente para leitura.

Dados Processados

O processo de coleta contempla os seguintes grupos de dados, extraídos diretamente da base da organização:

• Documentos Fiscais
  • NF-e – Notas Fiscais Eletrônicas de Entrada e Saída (Modelo 55);
  • SAT/NFC-e – Cupons Fiscais Eletrônicos (Modelo 65).
• Cadastros e Tabelas Auxiliares
  • Produtos, serviços e unidades de medida;
  • Embalagens e fatores de conversão;
  • Participantes (clientes, fornecedores, transportadoras, etc.);
  • CFOP – Códigos Fiscais de Operações e Prestações;
  • CST/CSOSN – Situações Tributárias;
  • NCM – Nomenclatura Comum do Mercosul;
  • Códigos fiscais e parâmetros tributários: ICMS, ICMS-ST, IPI, PIS, COFINS, entre outros.

Os dados são organizados conforme o escopo definido durante a implantação e processados com base no período configurado.

Funcionamento da Aplicação

1. Extração

   O Data Collector executa consultas estruturadas com filtros temporais e parâmetros pré-definidos. A extração é realizada em lotes para assegurar controle transacional, desempenho e escalabilidade.

2. Validação

   Após a extração, os dados passam por validações locais, que incluem:

   • Verificação de integridade e estrutura;
   • Padronização de formatos;
   • Aplicação de regras de consistência interna.
3. Transmissão

   A transmissão dos dados ocorre via requisições HTTPS com autenticação JWT (JSON Web Token). São utilizados mecanismos de:

   • Criptografia ponta a ponta (TLS 1.2+);
   • Controle de sessão;
   • Identificação do emissor;
   • Isolamento lógico por CNPJ.
4. Modalidades de Envio

   A aplicação oferece suporte aos seguintes modos de envio:

   • Agendado (automático):

     Execução periódica conforme cronograma local definido na instalação.

   • Sob demanda (manual):

     Execução pontual realizada por operador autorizado.

5. Rastreabilidade e Monitoramento

   Durante todas as etapas, a aplicação gera registros técnicos que permitem rastrear eventos e diagnosticar comportamentos:

   • Logs locais: armazenados no ambiente de execução;
   • Logs centralizados: sincronizados com a infraestrutura da plataforma.

Segurança da Integração

A segurança da operação é garantida por meio de:

• Acesso exclusivo de leitura ao banco de dados;
• Armazenamento criptografado de credenciais e configurações;
• Transmissão de dados sob conexão criptografada (TLS);
• Autenticação via JWT com escopo e tempo de expiração controlado;
• Geração de logs de acesso, transmissão e falhas para auditoria.

Suporte Técnico

A equipe técnica da plataforma oferece suporte durante todas as etapas:

• Análise do ambiente e definição da estratégia de integração;
• Apoio na instalação e configuração do Data Collector;
• Assistência na homologação de chamadas via API pública;
• Monitoramento e atendimento pós-implantação.

Canais de contato e orientações complementares estão disponíveis no portal de suporte.