A integração da Base com o SAP Business One foi desenvolvida para atender operações que utilizam um ERP robusto e altamente parametrizável. Por conta disso, é fundamental entender quais fluxos estão cobertos, quais ambientes são compatíveis e quais são as particularidades fiscais e técnicas desse cenário.
Compatibilidade da integração
Atualmente, a integração da Base é compatível com os seguintes ambientes SAP:
-
SAP Business One (SAP B1)
-
SAP HANA
A Base consegue se conectar tanto a ambientes SAP Business One que utilizam bancos de dados tradicionais quanto a ambientes baseados em SAP HANA. Em ambos os casos, a integração respeita as regras, estruturas e parametrizações definidas dentro do próprio SAP.
⚠️ É importante destacar que, independentemente do ambiente utilizado, o SAP possui alto nível de customização, o que torna cada projeto único.
Fluxos atualmente suportados na integração
Atualmente, a integração da Base com o SAP cobre os seguintes fluxos operacionais:
-
Importação de produtos
-
Sincronização de preços
-
Sincronização de estoques
-
Suporte a múltiplos depósitos
-
Envio de pedido de venda para o SAP ou
-
Envio de espelho de nota fiscal (invoice) para registro no SAP
Esses fluxos permitem manter estoque, preços e pedidos sincronizados entre a Base e o ERP, atendendo operações multicanal mais complexas.
Importante: o SAP não possui emissor de nota fiscal nativo
Um ponto essencial dessa integração é que o SAP não possui emissor de nota fiscal eletrônico nativo no cenário brasileiro.
Para realizar a emissão e autorização da NF-e junto à SEFAZ, é necessário contratar AddOns fiscais específicos. Esses AddOns funcionam como extensões do SAP e não fazem parte da integração padrão da Base.
Envio de espelho de nota fiscal para o SAP
Como o SAP não realiza a emissão da NF-e, a Base não envia uma nota fiscal emitida, mas sim um espelho de nota fiscal.
Nesse fluxo:
-
A Base faz a chamada no endpoint de invoice do SAP
-
O espelho da nota é registrado no ERP para:
-
Dar baixa de estoque
-
Registrar a movimentação fiscal
-
Atender às rotinas internas do SAP
-
⚠️ Importante:
Como a emissão não ocorre no SAP, não existe funcionalidade de captura de XML a partir desse ERP. Atualmente, a Base não realiza a leitura ou importação de XML originados no SAP.
Parametrização: principal ponto de atenção no SAP
O SAP é um ERP altamente parametrizável e, por isso, a configuração da integração exige atenção a diversos detalhes técnicos e fiscais. Muitos desses parâmetros só ficam disponíveis com perfil de suporte no SAP.
Entre os principais pontos de configuração, destacam-se:
-
Conexão com banco de dados (URL e credenciais)
-
Identificação da filial
-
Número de série da nota fiscal
-
Modelo da nota
-
Natureza de operação
-
Regras de impostos
-
Parâmetros de conciliação financeira
-
Contas de receita e despesa por forma de pagamento
-
Tipo de pagamento (dinheiro, cartão, transferência, etc.)
-
Definição de vendedor
Um exemplo prático observado em produção é o uso do modelo de nota 39, mesmo quando os modelos mais comuns no mercado são 55 ou 65. Esse tipo de particularidade é definido exclusivamente dentro do SAP e precisa ser respeitado no envio do espelho de nota.
Identificação e cadastro de clientes e produtos
A integração permite definir como clientes e produtos serão identificados dentro do SAP.
Clientes podem ser localizados por:
-
CNPJ
-
CPF
-
E-mail
-
Código do cliente
Caso o cliente não exista, é possível configurar se:
-
Ele será cadastrado automaticamente
-
Qual número de série será utilizado
-
Se o SAP irá gerar o código do cliente
Para produtos, a associação pode ser feita por:
-
SKU
-
EAN
Essas definições impactam diretamente a criação de pedidos e o correto vínculo das informações no ERP.
Extend Order Data: flexibilidade para cenários específicos
Devido ao alto nível de personalização do SAP, nem todas as regras e campos viram parâmetros padrão na integração.
Para esses casos, a Base disponibiliza o Extend Order Data, que permite o envio de um JSON com informações adicionais, totalmente customizado para o cenário do cliente. Esse recurso é utilizado para complementar dados na criação de clientes, pedidos ou faturas, quando necessário.
Mapeamento de marketplaces
Na configuração da integração, é realizado o mapeamento dos marketplaces conectados à Base.
Cada marketplace possui um ID de loja, que é enviado corretamente para o SAP. Atualmente, o cliente em produção utiliza apenas o Mercado Livre, mas o mesmo processo se aplica a outros canais, como Amazon.
Também é nesse ponto que ficam ativos:
-
Sincronização de preços
-
Sincronização de estoque
Envio de pedido ou envio de fatura
A Base permite escolher entre:
-
Enviar apenas o pedido de venda para o SAP, ou
-
Enviar a fatura (espelho de nota) para registro
Quando existe um XML anexado ao pedido na Base, a integração:
-
Lê o número e a série da nota
-
Envia essas informações de forma forçada para o SAP
Caso não exista XML anexado:
-
A Base segue a numeração padrão do SAP
-
Considera a última nota registrada para gerar a próxima
Esse comportamento garante consistência entre os sistemas, mesmo quando a emissão fiscal acontece fora do SAP.
Caso o cliente utilize um SAP com customizações específicas, a Base pode realizar desenvolvimento customizado para atender a essas particularidades.
Nesses cenários, é necessário realizar uma avaliação técnica prévia, e o prazo estimado para entrega da customização é de 2 a 3 semanas, conforme a complexidade do ajuste.