A integração com o Microsoft Dynamics AX é unidirecional: a Linkana consome diretamente as APIs REST do Dynamics após a aprovação do fornecedor, sem necessidade de camada intermediária.
Como funciona
1. Aprovação do fornecedor na Linkana
A aprovação do fornecedor — seja de um novo cadastro ou de uma atualização cadastral — dispara automaticamente o envio ao Dynamics.
2. Autenticação
A Linkana obtém um token de acesso via OAuth 2.0 (Azure AD, fluxo Client Credentials) antes de cada execução.
3. Verificação de existência
A Linkana consulta a API do Dynamics pelo CNPJ do fornecedor. Com base no resultado:
Fornecedor não encontrado → criação via POST na entidade
VendorsV2Fornecedor já existente → atualização via PATCH com o
VendorAccountNumberretornado pela consulta
O VendorAccountNumber é armazenado no painel da Linkana após a criação bem-sucedida e utilizado nos envios subsequentes.
4. Dados bancários
Quando o fornecedor possui dados bancários, a Linkana verifica se já existe uma conta cadastrada no Dynamics para aquele fornecedor. Caso exista, executa um PATCH na entidade VendorBankAccounts. Caso não exista, executa um POST para criação. Se não houver dados bancários no payload, nenhuma ação é executada nessa entidade.
Dados enviados ao Dynamics
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 (inscrição estadual e municipal)
Informações complementares constantes na base da RFB (CNAE, regime tributário, tipo de entidade)
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 Dynamics é definido na planilha De-para durante a fase de validação de escopo.
Pré-requisitos específicos
Credenciais OAuth 2.0 do Azure AD (client ID, client secret e tenant ID) para os ambientes de testes e produção
URL base da instância Dynamics AX do cliente
Acesso de rede externo à API do Dynamics, viabilizado pelo cliente. Este é um pré-requisito bloqueante: sem acesso, o desenvolvimento não pode ser iniciado.
Definição dos campos e entidades da API que devem ser utilizados pela Linkana — o comportamento da API pode variar conforme a versão e configuração do ambiente Dynamics do cliente. O responsável técnico do cliente deve mapear e documentar os campos obrigatórios, valores aceitos e parâmetros fixos antes do início do desenvolvimento.
Mapeamento de campos Linkana → Dynamics
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 Dynamics pode ser gerenciado pela Linkana. Quando um fornecedor é bloqueado ou desbloqueado na Linkana, a integração dispara automaticamente a atualização correspondente no Dynamics, desde que o campo esteja mapeado e a API permita a ação. As regras de negócio que definem quando um fornecedor deve ser bloqueado ou desbloqueado são alinhadas durante o escopo do projeto.