Este artigo cobre ERPs e sistemas de gestão que expõem um endpoint REST para recebimento de dados de fornecedores — incluindo ERPs como TOTVS Protheus, Consinco, entre outros. Para SAP e Oracle, consulte os artigos específicos de cada sistema.
Como funciona
O modelo é unidirecional: a Linkana envia os dados do fornecedor ao ERP após a aprovação. O ERP deve responder à chamada com o código HTTP adequado (2xx para sucesso, 4xx/5xx para erro) — é com base nesse retorno que a Linkana determina se o envio foi bem-sucedido ou deve ser tratado como falha.
Caso o ERP retorne na resposta um identificador interno do fornecedor criado (equivalente a um supplier ID), esse valor pode ser armazenado como campo personalizado no painel da Linkana e utilizado em envios subsequentes — por exemplo, para identificar o fornecedor em atualizações cadastrais futuras sem depender de uma nova busca por CNPJ.
1. Aprovação do fornecedor na Linkana
A aprovação do fornecedor — seja de um novo cadastro ou de uma atualização — dispara automaticamente o envio ao ERP.
2. Envio dos dados ao ERP
A Linkana autentica no endpoint do ERP conforme o mecanismo configurado (Basic Auth, API Key ou OAuth 2.0) e realiza um POST com os dados cadastrais do fornecedor na API disponibilizada. Quando a API do ERP suportar operações de atualização (PATCH ou PUT), a Linkana pode utilizá-las para atualizar o cadastro do fornecedor em envios subsequentes — caso contrário, apenas a criação estará disponível no escopo da integração. Em alguns casos, o próprio cliente mantém uma camada intermediária que recebe o payload da Linkana e orquestra internamente a lógica de criação ou atualização; nesse modelo, o comportamento de upsert é de responsabilidade dessa camada.
3. Confirmação
O ERP retorna um status HTTP de sucesso (2xx). Em caso de erro, a Linkana registra a falha e age de acordo com o processo de Reprocessamento de integrações.
Dados enviados ao ERP
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 ERP é definido na planilha De-para durante a fase de validação de escopo.
Pré-requisitos específicos
Endpoint REST disponível para recebimento dos dados do fornecedor, acessível externamente pela Linkana
Documentação do contrato da API: URL, método HTTP, autenticação, estrutura do payload esperado e códigos de retorno
Credenciais de acesso ao endpoint para os ambientes de testes e produção
Mapeamento dos campos da Linkana para os campos esperados pelo ERP
Definição do comportamento de upsert: o endpoint deve ser capaz de identificar se o fornecedor já existe (por CNPJ ou ID) e criar ou atualizar conforme o caso, ou alternativamente deve ser possível consultar a existência do fornecedor por algum método que retorne o ID interno antes do envio
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 ERP pode ser gerenciado pela Linkana. Quando um fornecedor é bloqueado ou desbloqueado na Linkana, a integração dispara automaticamente a atualização correspondente no ERP, 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.
Nota sobre conectividade
O endpoint do ERP precisa estar acessível via internet. ERPs hospedados em ambiente on-premise ou em rede interna sem exposição externa requerem que o cliente disponibilize um ponto de acesso público. Sem isso, a integração não é viável neste modelo. Consulte o artigo de pré-requisitos para mais detalhes sobre conectividade.