A integração com o SAP Ariba SLP é bidirecional: o Ariba é o sistema de origem do fornecedor, a Linkana realiza a homologação, e os dados de resultado retornam ao Ariba ao final do processo.
Diferenças no início do processo com o Ariba SLP
Ao contrário de outras interfaces, as APIs públicas do SAP Ariba SLP não permitem a criação de fornecedores por sistemas externos. As APIs disponíveis são de leitura e atualização parcial — é possível consultar fornecedores existentes e atualizar respostas de questionários, mas não criar novos registros.
Por isso, o fornecedor deve obrigatoriamente ter origem no Ariba SLP, criado por um usuário interno do cliente via Internal Supplier Request. Não é possível que a Linkana seja o sistema de origem do fornecedor nesta integração.
Como funciona
1. Criação do fornecedor no Ariba SLP
Um usuário interno do cliente cria um Internal Supplier Request no Ariba SLP com os dados mínimos do fornecedor (razão social, tax ID, país e contato). Após aprovação interna, o fornecedor é criado com status Not Invited — sem nenhuma comunicação ao fornecedor. O Ariba não envia convite de registro, e toda a interação com o fornecedor ocorrerá exclusivamente pela Linkana.
2. Identificação dos fornecedores a integrar (polling no Ariba)
A Linkana executa um processo periódico de polling via Supplier Data API do Ariba, buscando fornecedores atualizados no intervalo recente. Para cada fornecedor encontrado, a Linkana verifica o estado do questionário modular de integração — um questionário configurado no Ariba SLP exclusivamente para controle da sincronização com a Linkana.
O questionário funciona como flag de estado:
Fornecedor com questionário não preenchido → novo fornecedor, ainda não processado pela Linkana
Fornecedor com questionário preenchido pela Linkana via API → já sincronizado e em processo de homologação (ou concluído) na Linkana
Os critérios exatos de filtragem são definidos durante o levantamento de escopo.
3. Criação do fornecedor na Linkana
Ao identificar um fornecedor elegível, a Linkana realiza sua criação via API, iniciando o processo de homologação. O smVendorId — identificador único do fornecedor no Ariba — é armazenado como campo do comprador na Linkana para uso nas etapas seguintes. O questionário modular no Ariba é atualizado para indicar que o fornecedor está em processo de homologação.
Os campos necessários para a criação na Linkana são:
Campo na Linkana | Fonte no Ariba |
| Tax ID (CNPJ, CPF ou TIN) |
| SM Vendor ID |
| Definida no escopo |
| Contato do fornecedor |
| Nome do fornecedor. Obrigatório apenas para fornecedores internacionais e PF. |
| País do fornecedor. Obrigatório para fornecedores internacionais. |
4. Homologação na Linkana
O fornecedor recebe o convite de homologação exclusivamente pela Linkana. Todo o processo de homologação é conduzido na plataforma Linkana.
5. Retorno dos dados ao Ariba SLP após aprovação
Ao final da homologação, um webhook dispara o envio dos dados de resultado ao Ariba. A Linkana localiza o fornecedor pelo smVendorId armazenado, consulta o ID do questionário modular e atualiza as respostas via API com as informações de resultado, de acordo com o definido no escopo do projeto. O questionário fica disponível para consulta pelos usuários do Ariba e pode ser usado para sincronização com o ERP conforme configuração existente do cliente.
Dados enviados ao Ariba SLP
Os dados de resultado enviados pela Linkana ao questionário modular incluem, de forma geral:
Score ou resultado da homologação
URL do painel do fornecedor na Linkana
Link compartilhável do relatório de homologação
Demais campos mapeados no questionário, conforme regras de negócio definidas no escopo
O mapeamento exato dos campos Linkana → questionário Ariba é definido durante a fase de validação de escopo, de acordo com os IDs de questão configurados pelo cliente.
Pré-requisitos específicos
Habilitar acesso à Supplier Data API no Ariba SLP e gerar credenciais (API Key + OAuth2 Client Credentials) — responsabilidade do cliente junto à SAP
Garantir que o template de Internal Supplier Request contenha os campos mínimos necessários para a criação na Linkana (tax ID, contato, país)
Criar o questionário modular de integração no Ariba SLP e mapear os IDs dos campos que a Linkana deve preencher
Formalizar internamente que fornecedores geridos pela Linkana não receberão convite de registro do Ariba (
Invitenunca deve ser acionado)Definir os critérios de elegibilidade para polling
Definir política de deduplicação para casos em que múltiplos
smVendorIdscorrespondam a um mesmo CNPJMapeamento de campos Ariba → Linkana (criação) e Linkana → Ariba (retorno de resultado)
Disponibilidade do responsável técnico do cliente durante o desenvolvimento e testes
Bloqueio e desbloqueio de fornecedores
O status de bloqueio do fornecedor no Ariba SLP pode ser gerenciado pela Linkana. Quando um fornecedor é bloqueado ou desbloqueado na Linkana, a integração pode atualizar o campo correspondente no questionário modular do Ariba, desde que o campo esteja mapeado no escopo e a API 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.