Sistemas de requisição de fornecedores — como ServiceNow, sistemas de compras internos ou portais proprietários — são plataformas onde usuários internos solicitam a inclusão de novos fornecedores antes de iniciar a homologação. A integração com esses sistemas conecta o processo de requisição diretamente à Linkana, eliminando cadastro manual e duplicidade de dados.
Como funciona
1. Criação do fornecedor na Linkana a partir da requisição
Quando uma requisição de fornecedor é aprovada no sistema de origem, este realiza um envio HTTP à Linkana com os dados do fornecedor. A Linkana cria o registro via API e inicia o processo de homologação. O ID da requisição no sistema de origem é armazenado como campo do comprador na Linkana para uso nas etapas seguintes.
Para que a criação seja realizada, os seguintes campos devem estar disponíveis no sistema de origem e enviados no payload:
Campo na Linkana | Descrição | Obrigatório |
| CNPJ, CPF ou TIN (internacionais) | Sim |
| ID único do fornecedor no sistema de origem | Sim, caso seja necessário para o retorno dos dados ao sistema de destino |
| Display name da categoria de criação na Linkana | Sim |
| E-mail do fornecedor, para envio do convite de criação de conta | Sim, caso se deseje convidar o fornecedor |
| Razão social ou nome comercial | Obrigatório para fornecedores internacionais e PF |
| País do fornecedor | Obrigatório para fornecedores internacionais |
O mapeamento entre os campos do sistema de origem e os campos da Linkana é definido durante o levantamento de escopo.
2. Homologação na Linkana
O fornecedor recebe o convite de homologação exclusivamente pela Linkana. Todo o processo de homologação é conduzido na plataforma.
3. Retorno do resultado ao sistema de destino
Ao final da homologação, um webhook dispara o envio dos dados ao sistema de destino. A Linkana localiza o registro pelo ID armazenado e envia os dados cadastrais enriquecidos e o resultado da homologação. Em caso de reprovação, o motivo e a justificativa da decisão também podem ser enviados ao sistema de origem para encerramento da requisição.
Autenticação
A Linkana autentica as chamadas ao sistema de origem conforme o mecanismo suportado — API Key, OAuth 2.0 ou Basic Auth. O sistema de origem deve também autenticar as chamadas de entrada à Linkana por meio de uma chave de API fornecida pela Linkana.
Variação: polling no sistema de origem
Em vez de receber o envio do sistema de origem, a Linkana pode realizar um polling periódico — consultando a API do sistema de origem em busca de requisições elegíveis para integração. Nesse modelo, os critérios de elegibilidade (status da requisição, campos preenchidos, etc.) são definidos no escopo e a Linkana identifica e processa os novos registros.
Esta abordagem é indicada quando o sistema de origem não possui capacidade de envio ativo (webhook ou HTTP push).
Dados enviados ao sistema de destino
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 sistema de destino é definido na planilha De-para durante a fase de validação de escopo.
Pré-requisitos específicos
Endpoint disponível no sistema de destino para recebimento dos dados após a homologação, com documentação da API (campos esperados, autenticação, comportamento para aprovação e reprovação)
Credenciais de acesso à API do sistema de origem e destino (para o retorno de dados e, se aplicável, para o polling)
Mapeamento dos campos do sistema de origem e destino para os campos da Linkana
Definição dos critérios de elegibilidade para integração — quais requisições devem ser enviadas à Linkana
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 sistema de destino pode ser gerenciado pela Linkana. Quando um fornecedor é bloqueado ou desbloqueado na Linkana, a integração dispara automaticamente a atualização correspondente, sem necessidade de intervenção manual, 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.