Conectar o Microsoft Dynamics 365 Finance & Supply Chain: receber pedidos de venda

Última atualização 2026-11-01

Registre um app no Microsoft Entra ID, registre esse mesmo app dentro do Finance & Operations e vincule um usuário, cole a URL do ambiente e os três campos de credenciais no Integration, teste, confira o mapeamento e ative: os pedidos de venda começam a entrar.

O conector do Microsoft Dynamics 365 Finance & Supply Chain traz os pedidos de venda do seu ambiente do Finance & Operations para o OMS, para o armazém despachá-los sem redigitá-los à mão. É isso que esta conexão faz hoje: ela traz pedidos de venda, e não traz clientes, não lê estoque e não devolve estoque nem nenhum outro dado ao Dynamics 365. Uma conexão atende a um único ambiente: a URL de ambiente que você preencher aponta direto para esse ambiente.

Passos: primeiro o app no Entra, depois o registro no F&O, então preencher, testar, mapeamento e ativar.

Pré-requisitos#

Um ambiente do Microsoft Dynamics 365 Finance & Supply Chain (Finance & Operations) ao qual você consiga entrar, e o endereço desse ambiente, como https://myorg.operations.dynamics.com.
Acesso de administrador ao Microsoft Entra ID para registrar um app — ou um administrador de TI que possa registrá-lo para você e lhe entregar o ID do locatário, o ID do cliente e o segredo do cliente.
Acesso de administração do sistema dentro do Finance & Operations: o app também precisa ser registrado lá e vinculado a um usuário, e esse usuário precisa de uma função que possa ler os dados de pedidos de venda. Uma credencial que só existe no Entra ID não basta sozinha.
Guarde o valor do segredo do cliente em um lugar seguro assim que o criar: ele é exibido uma única vez e depois não pode mais ser lido.

Obter credenciais#

URL do ambiente: use o endereço do seu ambiente do Finance & Operations, por exemplo https://myorg.operations.dynamics.com. Copie só o endereço base — não acrescente /data no final.
ID do locatário e ID do cliente: no Microsoft Entra ID, abra App registrations, registre um novo app (ou abra o que o seu administrador de TI registrou) e, na página de visão geral dele, copie o Directory (tenant) ID e o Application (client) ID.
Segredo do cliente: nesse mesmo app, abra Certificates & secrets e crie um novo segredo do cliente. Copie o valor dele na hora — o valor é exibido uma única vez, e o que funciona aqui é o valor, não o ID do segredo exibido ao lado dele.
Registre o app dentro do Finance & Operations: no F&O, vá a System administration → Setup → Microsoft Entra ID applications, adicione uma linha com o mesmo ID do cliente e vincule-a a um usuário cuja função possa ler os dados de pedidos de venda. Se pular esta etapa, o teste abaixo falha mesmo com todos os campos preenchidos corretamente.

Preencher no Integration#

Abra Integration → Marketplace → Microsoft Dynamics 365 Finance & Supply Chain → Nova conexão.
environment_url — URL do ambiente, obrigatório: o endereço do seu ambiente do Finance & Operations, por exemplo https://myorg.operations.dynamics.com. Preencha só o endereço base, sem /data no final. É este campo que localiza o seu ambiente — esta conexão não tem campo separado de nome de ambiente nem de empresa.
tenant_id — ID do locatário, obrigatório: o Directory (tenant) ID da página de visão geral do registro do app no Microsoft Entra ID. É um GUID no formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
client_id — ID do cliente, obrigatório: o Application (client) ID da mesma página de visão geral. Use exatamente o mesmo ID que você registrou dentro do Finance & Operations na etapa de credenciais — os dois precisam coincidir caractere por caractere.
client_secret — Segredo do cliente, obrigatório: o valor do segredo que você copiou de Certificates & secrets no Entra ID (o valor, não o ID do segredo). Guardado como segredo, nunca exibido.

Testar a conexão#

O teste executa duas etapas, e a mensagem de erro indica qual etapa falhou. Primeiro ele verifica se nada obrigatório está faltando (URL de ambiente faltando gera MISSING_ENV_URL, ID do locatário faltando gera MISSING_TENANT_ID e ID do cliente ou segredo faltando gera MISSING_CLIENT_SECRET); depois usa o seu ID do cliente e o seu segredo para pedir um token de acesso ao login da Microsoft para o seu locatário — um segredo errado falha aqui com INVALID_CREDENTIALS. Em seguida, ele usa esse token para ler um único pedido de venda do seu ambiente (a entidade de dados SalesOrderHeadersV2, um registro só). Se a Microsoft emitir o token, mas o Finance & Operations recusar essa leitura com um 401, o resultado mostra INVALID_TOKEN, o que quase sempre significa que o app não está registrado dentro do F&O ou que nenhum usuário está vinculado a ele; um 403 mostra MISSING_SCOPE, o que significa que o usuário vinculado não tem uma função que possa ler os dados de pedidos de venda. O teste concede até 12 segundos para o ambiente responder, então um ambiente lento pode falhar só pelo tempo — basta executar o teste de novo.

Mapping / escolher modelo#

Escolha o modelo padrão do Dynamics 365 Finance & Supply Chain. Ele pareia os campos dos pedidos de venda que este conector lê (a entidade de dados SalesOrderHeadersV2) com os campos do pedido padrão do lado do OMS. Antes de ativar, abra a prévia do mapeamento e confirme que o número do pedido cai no lugar certo e que todo campo do qual o seu armazém depende — datas de entrega, endereço de entrega, referência do cliente — está pareado. Campos deixados sem pareamento simplesmente não passam para o pedido padrão, então confira a prévia com um pedido de venda real do seu ambiente em vez de ativar às cegas.

Ida e volta do pedido de venda: entra o token e os pedidos saem para o OMS — esta conexão não envia nada de volta ao Dynamics 365.

Ativar#

Após ativar, o Integration traz novos pedidos de venda do seu ambiente do Finance & Operations na frequência definida, converte cada um em um pedido padrão pelo mapeamento e o entrega ao OMS para fulfillment. Nada flui no sentido contrário nesta conexão: ela não sincroniza clientes, não lê estoque e não devolve estoque nem fulfillment ao Dynamics 365. Acompanhe os primeiros pedidos em Runs / Logs e compare-os com os mesmos pedidos no F&O antes de confiar na conexão sem supervisão.

Perguntas frequentes#

O teste falha com INVALID_CREDENTIALS (401 ao pedir o token)

O login da Microsoft recusou o par ID do cliente e segredo: o valor do segredo está errado ou expirou, ou o ID do locatário e o ID do cliente preenchidos aqui pertencem a registros de app diferentes, então o par não combina.

Abra o registro do app no Microsoft Entra ID e confira os três valores com ele: o Directory (tenant) ID e o Application (client) ID da página de visão geral; e em Certificates & secrets crie um segredo novo, copie o valor dele (não o ID do segredo ao lado) e cole esse valor em client_secret. Depois teste de novo.

O teste falha com INVALID_TOKEN (token emitido, mas o F&O responde 401)

As credenciais funcionam no Entra ID, mas o Finance & Operations não conhece este app: ele nunca foi registrado em Microsoft Entra ID applications dentro do F&O, ou está registrado sem nenhum usuário vinculado, então o F&O rejeita o token.

No F&O, vá a System administration → Setup → Microsoft Entra ID applications, adicione ou localize a linha com o ID do cliente desta conexão e vincule-a a um usuário. Salve e execute o teste de novo — esta é a correção mais comum nesta conexão.

O teste falha com MISSING_SCOPE (403 do F&O)

O F&O conhece o app e aceitou o token, mas o usuário vinculado ao app não tem uma função que possa ler os dados de pedidos de venda, então a leitura da entidade de dados SalesOrderHeadersV2 é recusada.

No F&O, dê ao usuário vinculado uma função que possa ler os dados de pedidos de venda (o administrador do F&O atribui funções em System administration → Users), ou vincule o app a outro usuário que já tenha essa função. Depois teste de novo.

O teste falha com MISSING_ENV_URL, ou o ambiente não é alcançado

O campo environment_url está vazio, ou o endereço nele não é o endereço base do seu ambiente — o deslize mais frequente é um endereço terminado em /data, que aponta para além do lugar onde o conector entra.

Preencha environment_url com o endereço base do seu ambiente do Finance & Operations, por exemplo https://myorg.operations.dynamics.com, sem nada depois de .com — em especial, remova qualquer /data no final. Depois teste de novo.

Esta conexão também pode sincronizar clientes ou estoque?

Não. Esta conexão só traz pedidos de venda: não traz clientes, não lê estoque e não devolve estoque ao Dynamics 365. Mantenha o cadastro de clientes e o estoque no próprio Finance & Operations, e use esta conexão para o fluxo de pedidos até o OMS.

Os pedidos de venda são o único fluxo que esta conexão transporta de ponta a ponta, com suas linhas. Consulte clientes e estoque no Finance & Operations ao trabalhar um pedido no OMS — esta conexão não os trará.