A integração entre a Linkana e o SAP automatiza o cadastro de fornecedores aprovados diretamente no SAP, eliminando o processo manual de extração e inserção de dados entre os sistemas.
O fluxo é unidirecional: após a aprovação do fornecedor na Linkana, os dados são enviados automaticamente ao SAP. Não há retorno de informações do SAP para a Linkana além do BP Number (Business Partner Number) gerado na criação, que é registrado no painel da Linkana para fins de rastreabilidade.
Como funciona
1. Gatilho: aprovação do fornecedor na Linkana
O fluxo de integração é acionado automaticamente no momento em que um fornecedor é aprovado na Linkana. Não é necessária nenhuma ação manual para iniciar o envio.
2. Envio dos dados ao SAP
A Linkana envia os dados do fornecedor ao SAP por meio de um endpoint intermediário do cliente. Na prática, isso significa que o cliente precisa ter uma camada de integração própria — como o SAP Cloud Platform Integration (CPI), SAP PI/PO ou ferramenta equivalente — que receba o payload da Linkana e faça a criação do registro no SAP.
Esse modelo é necessário porque versões anteriores do SAP não costumam possuir APIs prontas para consumo externo — diferente do S/4HANA, que oferece APIs REST nativas. A camada intermediária do cliente é quem expõe um endpoint consumível pela Linkana e orquestra internamente o processo de criação do Business Partner no ERP.
3. Autenticação
Antes de cada envio, o middleware da Linkana realiza a autenticação na camada de integração do cliente. Os mecanismos mais comuns utilizados e suportados são Basic Auth, API Key e OAuth 2.0. O método utilizado é definido durante a fase de desenvolvimento, de acordo com o que a camada intermediária do cliente suporta. Para outros métodos, consultar a equipe durante a definição de escopo.
4. Criação ou atualização no SAP
O comportamento da integração depende do histórico do fornecedor no SAP:
Novo fornecedor: a Linkana envia o payload sem um BP Number. A camada de integração do cliente cria o Business Partner no SAP e retorna o BP Number gerado, que é então armazenado no painel do fornecedor na Linkana.
Fornecedor já existente: a Linkana inclui no payload o BP Number previamente registrado, sinalizando que se trata de uma atualização. A camada de integração do cliente localiza o registro correspondente e aplica as alterações.
Em ambos os casos, a lógica de criação ou atualização é executada pela camada de integração do cliente — a Linkana apenas envia o payload com ou sem o BP Number conforme o contexto. Para garantir a integridade dos dados, a camada intermediária deve realizar a verificação de unicidade pelo CNPJ ou tax ID antes de criar um novo registro, impedindo a duplicação do fornecedor no SAP. Alternativamente, deve ser possível realizar a busca do fornecedor por algum método que retorne o BP Number, permitindo que a Linkana o armazene e utilize nos envios subsequentes como atualização. Cenários em que o barramento opera de forma diferente desse modelo devem ser discutidos e formalizados durante a definição de escopo.
5. Retorno do BP Number
Após a criação bem-sucedida, o BP Number é retornado à Linkana e registrado automaticamente no painel do fornecedor, permitindo rastrear o vínculo entre os dois sistemas e garantindo que envios subsequentes sejam tratados como atualização.
Dados enviados ao SAP
Os dados enviados pela Linkana incluem, de forma geral:
Dados cadastrais do fornecedor (razão social, nome fantasia, CNPJ/CPF)
Endereço completo
Dados de contato comercial
Dados bancários
Dados fiscais (estadual e municipal)
Informações complementares constantes na base da RFB (natureza jurídica, regime tributário, etc)
Informações preenchidas em campos personalizados e formulários, conforme regras de negócio definidas
O mapeamento exato de cada campo para os campos do SAP é definido na planilha De-para durante a fase de validação de escopo, e pode variar de acordo com a configuração do ambiente SAP do cliente.
Pré-requisitos específicos
Além dos pré-requisitos gerais de integração, este modelo requer:
Camada de integração própria do cliente (ex.: SAP CPI, SAP PI/PO) com um endpoint disponível para receber o payload da Linkana
Credenciais OAuth 2.0 (Client ID e Client Secret) para autenticação na camada intermediária (ou conforme o método de autenticação)
URL do endpoint de criação/atualização de Business Partner exposta pela camada intermediária
Mapeamento de campos entre o modelo de dados da Linkana e os campos do SAP
Bloqueio e desbloqueio de fornecedores
O status de bloqueio do fornecedor no SAP pode ser gerenciado pela Linkana. Quando um fornecedor é bloqueado ou desbloqueado na Linkana, a integração dispara automaticamente a atualização correspondente no SAP, sem necessidade de intervenção manual no ERP, desde que a API disponibilizada permita a ação. As regras de negócio que definem como um fornecedor deve ser bloqueado ou desbloqueado são alinhadas durante o escopo do projeto.