Conectando o Business Central

A conexão com o Business Central 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 Business Central; 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

• A integração cobre o Business Central online. A instalação on-premises roda em outro endereço e não é coberta.
• Peça ao administrador do Business Central:
  • o Tenant ID do Microsoft Entra — o GUID de 36 caracteres do diretório da empresa;
  • o nome do ambiente, como aparece no admin center do Business Central (normalmente Production);
  • o registro da aplicação da Toca na página Microsoft Entra applications, dentro do próprio Business Central, com o registro habilitado e um permission set de leitura atribuído — a Microsoft não permite atribuir SUPER a uma aplicação. Para localizar essa página no painel, confirme na documentação oficial da Microsoft.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Business Central e clique no botão de conexão.
3. Preencha os dois campos:
   • Tenant ID do Entra — o GUID de 36 caracteres do diretório.
   • Ambiente — o nome exato do ambiente (ex.: Production).
4. Salve. O card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê faturamento e razão, contas a pagar e a receber, clientes e fornecedores, itens e estoque. A integração é somente leitura: a Toca não cria, não altera e não exclui nada no Business Central.

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 habilitado dentro do Business Central, com o permission set atribuído. Se o administrador desabilitar ou remover o registro, a leitura para — refazê-lo 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 Business Central recusa a leitura. Peça ao administrador para conferir o registro da aplicação da Toca em Microsoft Entra applications, com o permission set atribuído.
• Tenant ID não aceito — o campo espera o GUID de 36 caracteres do diretório no Microsoft Entra, não o nome da empresa nem o domínio.
• Ambiente não encontrado — o nome precisa ser exatamente o que aparece no admin center do Business Central.
• Dúvida sobre qual produto conectar — o Dynamics 365 Finance é outro ERP da Microsoft, de grande porte, com card e guia próprios. Este guia é do Business Central, o ERP de pequeno e médio porte.