A integração nativa com SAP Business One foi desenvolvida para oferecer máxima compatibilidade e segurança, dividida em duas partes principais: um plugin leve instalado na infraestrutura do cliente e o consumo nativo pelo Vendelo. Esta solução mantém a arquitetura desacoplada e não interfere no desempenho do B1.
Índice
Visão Geral da Arquitetura
A integração com SAP Business One utiliza uma arquitetura dupla que garante segurança máxima e desempenho otimizado:
- Plugin Leve: Instalado no servidor de integração do cliente
- Vendelo Nativo: Consome os dados através do plugin de forma segura
- Service Layer: 100% das operações utilizam a API oficial do SAP
- Arquitetura Desacoplada: Não modifica estruturas originais do B1
Esta arquitetura permite que o Vendelo seja desinstalado ou desvinculado do B1 sem deixar qualquer resíduo na estrutura original do SAP.
Plugin Leve do Servidor
O plugin instalado no servidor de integração do cliente oferece as seguintes funcionalidades:
Principais Recursos
- Consumo da Service Layer: Acessa a API do B1 sem exposição pública
- Monitoramento de Eventos: Detecta automaticamente atualizações no B1
- Consultas SQL Seguras: Permite consultas de leitura controladas
- Relatórios Crystal Reports: Gera espelhos de notas e impressão de propostas
- Controle de Acesso: Token de segurança para autenticação
Componentes do Plugin
| Componente | Função | Tecnologia |
|---|---|---|
| API Controller | Gerencia requisições HTTP | ASP.NET Core |
| Database Client | Conexão direta com B1 | SQL Server / HANA |
| Service Layer Proxy | Intermedia chamadas SL | HTTP Client |
| Crystal Reports Helper | Geração de relatórios | Crystal Reports Engine |
O plugin deve ser instalado em um servidor com acesso à rede do SAP Business One, mas não precisa estar no mesmo servidor do B1.
Consumo Nativo pelo Vendelo
O Vendelo consome os dados através do plugin utilizando exclusivamente a Service Layer oficial do SAP:
Fluxo de Integração
- Vendelo solicita dados ao plugin através de requisições criptografadas
- Plugin autentica a requisição e valida o token de acesso
- Plugin consulta a Service Layer ou executa consulta SQL conforme necessário
- Dados são retornados criptografados para o Vendelo
- Vendelo processa e armazena os dados em sua própria estrutura de nuvem
Tipos de Operações Suportadas
| Operação | Método | Descrição |
|---|---|---|
| Consulta de Dados | GET | Leitura de registros via Service Layer |
| Criação de Registros | POST | Inclusão de novos documentos |
| Atualização de Dados | PATCH | Modificação de registros existentes |
| Consultas SQL | Custom Query | Relatórios e consultas específicas |
| Geração de PDFs | Crystal Reports | Relatórios e documentos impressos |
Configuração do Ambiente
O ambiente é preparado durante a implantação para funcionar tanto com SQL Server quanto com HANA:
Pré-requisitos do Sistema
- SAP Business One: Versão 10 ou superior
- Service Layer: Configurada e funcionando
- Servidor de Integração: Windows Server com .NET 8.0
- Conectividade: Acesso HTTPS ao Vendelo e ao B1
Configurações de Banco de Dados
| Parâmetro | SQL Server | HANA | Obrigatório |
|---|---|---|---|
| Tipo de Conexão | SQL Client | HANA Client / ODBC | Obrigatório |
| String de Conexão | Integrated ou SQL Auth | Schema específico | Obrigatório |
| Porta Padrão | 1433 | 30015 | Opcional |
| Criptografia | TrustServerCertificate | SSL/TLS | Obrigatório |
A configuração é automatizada durante o processo de implantação, incluindo testes de conectividade e validação de permissões.
Vantagens da Arquitetura
Arquitetura Desacoplada
- Sem Campos de Usuário: Não cria estruturas no SAP
- Sem Dependências: Vendelo funciona independentemente
- Remoção Limpa: Desinstalação sem resíduos
- Estrutura Original Preservada: B1 permanece intacto
Performance e Infraestrutura
- Estrutura Própria de Nuvem: Vendelo roda em infraestrutura independente
- Sem Impacto no B1: Não afeta desempenho do ERP
- Cache Inteligente: Otimização de consultas frequentes
- Processamento Assíncrono: Operações não bloqueantes
Comparativo com Outras Integrações
| Aspecto | Vendelo Nativo | Integrações “Homologadas” |
|---|---|---|
| Modificação do B1 | Nenhuma | Campos de usuário, triggers, stored procedures |
| Impacto na Performance | Zero | Significativo (consultas diretas) |
| Processo de Homologação | Não necessário | Obrigatório devido às modificações |
| Manutenibilidade | Alta | Baixa (dependências estruturais) |
Outras integrações que se dizem “homologadas” frequentemente fazem uma grande bagunça estrutural no SAP, criando campos de usuário, modificando tabelas e instalando componentes que ficam permanentemente no sistema.
Aspectos de Segurança
Proteção de Dados
- Criptografia End-to-End: Todas as comunicações são criptografadas
- Token de Autenticação: Acesso controlado por tokens seguros
- Sem Exposição Pública: Service Layer não fica acessível externamente
- Logs de Auditoria: Registro completo de todas as operações
Controle de Acesso
| Recurso | Método de Proteção | Nível de Segurança |
|---|---|---|
| API Endpoints | Token Bearer + HTTPS | Alto |
| Banco de Dados | Credenciais criptografadas | Muito Alto |
| Service Layer | Cookies de sessão seguros | Alto |
| Arquivos de Configuração | Proteção de dados do Windows | Muito Alto |
Perguntas Frequentes
O plugin pode afetar o desempenho do SAP Business One?
Não. O plugin utiliza apenas consultas de leitura otimizadas e não interfere nas operações do B1. Além disso, pode ser instalado em um servidor separado.
É necessário criar campos de usuário no SAP para a integração funcionar?
Não. A arquitetura do Vendelo é completamente desacoplada e não requer modificações na estrutura original do SAP Business One.
O que acontece se eu quiser remover o Vendelo do ambiente?
A remoção é completamente limpa. Como não são criadas estruturas no SAP, apenas o plugin precisa ser desinstalado, sem deixar qualquer resíduo no B1.
A integração funciona tanto com SQL Server quanto com HANA?
Sim. O ambiente é configurado automaticamente durante a implantação para funcionar com ambos os tipos de banco de dados do SAP Business One.
Como é garantida a segurança das comunicações?
Todas as comunicações utilizam criptografia end-to-end, tokens de autenticação seguros e HTTPS. A Service Layer nunca fica exposta publicamente.
Por que outras integrações precisam de homologação e o Vendelo não?
Outras integrações modificam a estrutura do SAP criando campos de usuário, triggers e procedimentos. O Vendelo utiliza apenas a API oficial (Service Layer) sem modificações.
É possível gerar relatórios Crystal Reports através da integração?
Sim. O plugin inclui um componente específico para geração de PDFs através do Crystal Reports, permitindo espelhos de notas e impressão de propostas.
O plugin precisa estar no mesmo servidor do SAP Business One?
Não é obrigatório. O plugin pode ser instalado em qualquer servidor Windows com acesso à rede do B1 e conectividade HTTPS com o Vendelo.
Como são sincronizadas as atualizações do SAP com o Vendelo?
O plugin monitora automaticamente os eventos de atualização do B1 e notifica o Vendelo em tempo real, garantindo sincronização completa dos dados.
Posso usar campos de usuário já existentes no meu SAP com o Vendelo?
Sim. O Vendelo pode ler e utilizar campos de usuário já existentes no SAP sem criar novos campos, mantendo a compatibilidade com customizações existentes.
