A conexão com o Dynamics 365 Finance usa dois identificadores — nenhum segredo é pedido: a autenticação é feita entre a aplicação da Toca e a Microsoft. O trabalho decisivo é do administrador do ERP, que registra a aplicação da Toca dentro do Finance, mapeada a um usuário de serviço; sem esse registro, a conexão autentica e não lê nada.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
Antes de começar
Peça ao administrador do Dynamics 365 Finance:
- o Tenant ID do Microsoft Entra — o GUID de 36 caracteres do diretório da empresa;
- o endereço do ambiente, como
suaempresa.operations.dynamics.com; - o registro da aplicação da Toca em System administration → Setup → Microsoft Entra applications, dentro do próprio Finance, mapeada a um usuário de serviço com acesso de leitura aos dados que a análise vai usar.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Dynamics 365 Finance e clique no botão de conexão.
- Preencha os dois campos:
- Tenant ID do Entra — o GUID de 36 caracteres do diretório.
- Endereço do ambiente — ex.:
suaempresa.operations.dynamics.com.
- Salve. O card fica marcado como conectado.
O que a Toca acessa
Com a conexão ativa, a Toca lê razão contábil, contas a pagar e a receber, clientes, fornecedores, itens e estoque, por empresa. A integração é somente leitura: a Toca não cria, não altera e não exclui nada no Finance.
Manutenção da conexão
Não há senha nem chave que expire do seu lado: a conexão permanece ativa enquanto o registro da aplicação da Toca continuar valendo dentro do Finance, mapeado a um usuário de serviço. Se o administrador remover o registro ou o usuário mapeado, a leitura para — refazer o registro restabelece a conexão sem mexer no card.
Problemas comuns
- Conectou, mas as consultas dão erro de acesso — é o sintoma clássico do registro faltando: a autenticação com a Microsoft funciona, e o Finance recusa a leitura. Peça ao administrador para conferir o registro em System administration → Setup → Microsoft Entra applications e o usuário mapeado.
- Os números parecem cobrir só uma empresa — por padrão, o Finance responde com a empresa padrão do usuário mapeado. A Toca pede as demais empresas quando a pergunta envolve mais de uma; se algo parecer parcial, diga no chat qual empresa você quer ver.
- Tenant ID não aceito — o campo espera o GUID de 36 caracteres do diretório no Microsoft Entra.
- Dúvida sobre qual produto conectar — o Business Central é outro ERP da Microsoft, de pequeno e médio porte, com card e guia próprios. Este guia é do Dynamics 365 Finance, o ERP de grande porte.