Complemento do Business Central para Configuração do RapidStart CRM
Etapas para instalar, configurar e validar o Addon do Business Central para o RapidStart CRM. Este addon utiliza tanto os fluxos em nuvem do RapidStart quanto a sincronização nativa do Business Central-Dataverse da Microsoft, portanto, os administradores devem validar ambos os lados antes de testar cenários de cliente ou cotação.
⚠️ Parceiro Recomendado
Devido à complexidade, sugerimos usar um de nossos Parceiros Certificados RapidStart para isso. No entanto, se o seu parceiro Business Central também for habilidoso na Power Platform, ele pode realizar essas etapas para você. Não recomendamos que um usuário final tente este processo.
Etapas de Alto Nível
- Crie ou use um ambiente existente habilitado para Dataverse.
- Instale o RapidStart CRM do AppSource no ambiente habilitado para Dataverse.
- Obtenha o ID do Sistema da Empresa do Business Central.
- Configure a Integração de dentro do Business Central.
- Verifique o papel do usuário da aplicação de integração do Business Central
- Configurar Mapeamento de Registros
- Vincular Ambientes (Opcional)
- Instale o Addon do Business Central para RapidStart CRM do AppSource no ambiente habilitado para Dataverse.
- Complete no aplicativo de Configurações do RapidStart
Já criamos um documento que cobre as etapas 1 & 2 aqui. Uma vez que essas etapas estejam concluídas, volte aqui para continuar com a Etapa 3.
Certifique-se de que os tipos de ambiente do Dataverse e BC correspondam: Produção para Produção, ou Sandbox para Sandbox.
Antes de Começar
Confirme estes requisitos antes de iniciar a configuração do Addon do Business Central:
- Business Central e Dataverse devem estar no mesmo locatário Microsoft Entra para tabelas virtuais do Business Central.
- Use um administrador de configuração humano com as permissões necessárias do Business Central e acesso de Administrador do Sistema do Dataverse durante a configuração.
- Confirme que o RapidStart CRM está instalado no ambiente do Dataverse que você planeja conectar.
Etapa 3: Obter ID da Empresa
Para obter o ID da sua empresa, procure Empresas no Business Central. Selecione a empresa alvo e pressione Ctrl+Alt+F1 para abrir a Inspeção de Página. Copie o ID mostrado e salve-o para mais tarde.
Use o GUID do ID do Sistema da Empresa
O ID da empresa que você precisa para a variável de ambiente do RapidStart é o GUID do ID do Sistema da Empresa do Business Central. Não use o nome de exibição da empresa editável da barra de endereço. Se você não puder abrir a Inspeção de Página, peça ao seu administrador ou parceiro do Business Central para fornecer o ID da empresa.
Etapa 4: Configurar a Integração de dentro do Business Central
Faça login no Ambiente do Business Central que você deseja conectar.
Anote o nome do ambiente do Business Central na barra de endereço. A URL também pode mostrar o nome de exibição da empresa, mas você já capturou o GUID do ID do Sistema da Empresa na etapa anterior.
Copie o nome do ambiente do Business Central para as mesmas notas onde você salvou o GUID do ID do Sistema da Empresa.
ID da Empresa já capturado
Use o GUID do ID do Sistema da Empresa da Etapa 3 quando a configuração solicitar o ID da Empresa do BC. O nome de exibição da empresa na URL é apenas uma alternativa compatível com versões anteriores para implantações mais antigas.
1. Clique na engrenagem
2. Selecione “Configuração Assistida”
Role para baixo até a seção “Conectar com outros sistemas” e clique em “Configurar uma conexão com o Dataverse”.
1. Selecione para Habilitar sincronização de dados
2. Selecione para habilitar tabelas virtuais e eventos
3. Clique em “Próximo”
Aceite os Termos e clique em “Próximo”
Aceite a conexão com o Dataverse “Permitir Sempre”, e clique em OK
Selecione o ambiente alvo habilitado para Dataverse, e clique em “Ok”
Confirme que o ambiente está correto, então clique no link para Fazer login no ambiente do Dataverse. Após fazer login, clique em “Próximo”
Selecione a propriedade de Equipe recomendada, alterne para Completar sem sincronização (faremos isso mais tarde) e clique em “Próximo”
1. Clique no Link para Instalar o aplicativo de Tabela Virtual do Business Central
2. Clique em “Próximo” (Uma nova aba será aberta para o AppSource)
Clique no botão “Obter agora” (Este addon é gratuito), e a página seguinte será aberta:
1. Selecione o ambiente alvo (onde você instalou o RapidStart CRM).
2. Concorde com os termos.
3. Clique em “Instalar”.
Você verá que a solução está “Instalando”. Isso pode levar vários minutos para ser concluído. Ocasionalmente clique em “atualizar” até ver que está “Instalado”, então volte para a aba do navegador do Business Central para continuar.
Clique em “Atualizar”
Você verá que o aplicativo de Tabelas Virtuais foi instalado com sucesso. Clique em “Concluir”
Após alguns minutos, esta página aparecerá. Selecione a Aba de Tabelas Virtuais e então “Tabelas Virtuais Disponíveis”
1. Comece selecionando a linha “item”
2. Clique em “Habilitar” (Isso criará a tabela virtual no Dataverse para itens)
3. Aguarde até ver a caixa “Visível” marcada. Você pode precisar atualizar algumas vezes.
Repita estas etapas para: salesInvoice, salesInvoiceLine, salesOrder, salesOrderLine, salesQuote, salesQuoteLine, salesShipment, e salesShipmentLine. Isso levará vários minutos para cada um ser habilitado.
Altere para ordenar por Visível/decrescente, e confirme que você vê todas essas tabelas. Não adicione mais Tabelas Virtuais neste momento. Você pode deixar a tela como está (voltaremos a ela) e abrir uma nova aba.
Etapa 5: Verificar o Usuário da Aplicação de Integração do Business Central
Não atribua Administrador do Sistema ao usuário da aplicação
O administrador de configuração humano precisa de permissões de Administrador do Sistema do Dataverse durante a configuração. O usuário da aplicação de integração do Business Central criado automaticamente deve usar o papel Business Central Dataverse Integration da Microsoft, não Administrador do Sistema.
Se as permissões de sincronização Business Central-Dataverse parecerem danificadas, abra Configuração de Conexão do Dataverse no Business Central e use Reimplantar Solução de Integração. Isso restaura a solução de integração da Microsoft e implanta o papel de segurança de integração do Business Central.
Continue apenas após o teste de conexão ser bem-sucedido e o usuário da aplicação de integração do Business Central ter o papel de Integração do Dataverse da Microsoft.
Etapa 6: Configurar Mapeamento e Acoplamento de Registros
Os fluxos RapidStart e a sincronização da Microsoft são separados
Os fluxos em nuvem RapidStart suportam ações de addon, como solicitações de cotação e atualizações selecionadas de cliente/contato. Os mapeamentos de tabelas de integração nativa do Business Central da Microsoft lidam com sincronização, acoplamento, dados de referência e sincronização agendada entre Business Central e Dataverse. Configure ambos contra o mesmo ambiente do Dataverse e empresa do Business Central.
Configure mapeamentos de referência antes da sincronização de clientes
Execute e valide mapeamentos de referência antes de testar CLIENTE. A sincronização de clientes frequentemente falha quando valores de moeda, termos de pagamento, método de envio ou agente de envio não existem ou não têm IDs de opção correspondentes no lado do Dataverse.
Mapeamentos de referência para configurar antes de CLIENTE
- MOEDA: Moeda do Business Central → Moeda de Transação do Dataverse. A direção deve ser Business Central para Dataverse. Confirme estes mapeamentos de campo habilitados: Código → Código da Moeda, Símbolo → Símbolo da Moeda, e Descrição → Nome da Moeda.
- Confirme que o mapeamento de CLIENTE contém Código da Moeda → Moeda. Sincronize moedas antes de clientes. A moeda base do Dataverse e a moeda local do Business Central devem concordar, e taxas de câmbio necessárias devem existir.
- Termos de Pagamento: sincronize com Termos de Pagamento da Conta antes de testar clientes.
- Método de Envio: sincronize com Termos de Frete da Conta antes de testar clientes.
- Agente de Envio: sincronize com Método de Envio da Conta antes de testar clientes.
Política de criação de clientes
Defina CLIENTE para Bidirecional se contas/empresas puderem ser criadas em qualquer lado. Então escolha a política Sincronizar Apenas Registros Acoplados como uma decisão de implantação de cliente:
| Configuração | Comportamento |
|---|---|
| Sincronizar Apenas Registros Acoplados = Ligado | Sincroniza apenas registros que um administrador já acoplou. Isso evita a criação ampla de novos registros não acoplados. |
| Sincronizar Apenas Registros Acoplados = Desligado | A sincronização inicial e agendada pode criar clientes/contas não acoplados no outro lado. Use isso apenas quando esse comportamento de criação for intencional. |
Acoplamento necessário quando Sincronizar Apenas Registros Acoplados está Ligado
Quando Sincronizar Apenas Registros Acoplados está Ligado, a sincronização da Microsoft atualiza apenas registros já acoplados. Um fluxo RapidStart pode criar um cliente do Business Central e armazenar seu número de cliente na conta do Dataverse, mas isso não estabelece o acoplamento nativo da Microsoft. Após usar o fluxo, acople manualmente o cliente e a conta no Business Central se a sincronização nativa contínua for necessária. Um número de cliente do Business Central por si só não é prova de acoplamento.
Validação de valores de opção
Os IDs de valor de enumeração do Business Central usados para Termos de Pagamento, Método de Envio e Agente de Envio devem corresponder aos IDs de opção correspondentes do Dataverse. O texto de exibição ou rótulo de código sozinho não é suficiente. Uma sincronização completa não corrige uma incompatibilidade de ID quando o Business Central contém valores de enumeração personalizados que não existem no Dataverse.
- Execute Sincronizar Registros Modificados para TERMOS DE PAGAMENTO, MÉTODO DE ENVIO e AGENTE DE ENVIO.
- Inspecione Mapeamento de Opções do Dataverse e o log de erros de sincronização antes de testar CLIENTE.
- Se os IDs não estiverem alinhados, use o padrão seguro no mapeamento de campos do CLIENTE: Código de Termos de Pagamento → Termos de Pagamento = FromIntegrationTable; Código de Método de Envio → Endereço 1: Termos de Frete = FromIntegrationTable; Código de Agente de Envio → Endereço 1: Método de Envio = FromIntegrationTable.
- Altere esses três campos para Bidirecional apenas depois que um desenvolvedor tiver adicionado IDs de opção correspondentes em ambos os lados.
- Não invente ou renumere IDs de opção durante a configuração. Valores personalizados do Dataverse e extensões de enumeração do Business Central devem usar exatamente os mesmos IDs.
Volte para a aba do Business Central no seu navegador que deixamos aberta.
1. Clique na aba “Integração”
2. então “Mapeamentos de Tabelas de Integração”
Decisão do cliente: mantenha VENDEDORES se o cliente quiser a sincronização padrão de usuário do Dataverse para vendedor do Business Central da Microsoft. Exclua ou desative este mapeamento apenas quando essa sincronização padrão não for intencionalmente usada.
1. Selecione CONTATO
2. Selecione Acoplamento
3. Então clique em “Acoplamento Baseado em Correspondência”.
4. Corresponda o acima e clique em OK
1. Selecione MOEDA
2. Selecione Acoplamento
3. Então clique em “Acoplamento Baseado em Correspondência”.
4. Corresponda o acima e clique em OK
Para CLIENTE Selecione Mapeamento/Campos
1. Selecione “Editar Lista”
2. e “habilitar” Número da conta.
Ainda para CLIENTE, selecione Acoplamento/Acoplamento Baseado em Correspondência. Corresponda usando os campos identificadores de cliente/conta mostrados na captura de tela, e confirme que os campos correspondentes identificam exclusivamente o mesmo cliente em ambos os lados.
Para TERMOS DE PAGAMENTO, selecione Acoplamento/Acoplamento Baseado em Correspondência. Corresponda os registros de termos de pagamento do Business Central aos valores de opção de termos de pagamento correspondentes do Dataverse pelos IDs configurados.
Para MÉTODO DE ENVIO, selecione Acoplamento/Acoplamento Baseado em Correspondência. Corresponda os métodos de envio do Business Central aos valores de opção de termos de frete correspondentes do Dataverse pelos IDs configurados.
Para AGENTE DE ENVIO, selecione Acoplamento/Acoplamento Baseado em Correspondência. Corresponda os agentes de envio do Business Central aos valores de opção de método de envio correspondentes do Dataverse pelos IDs configurados.
Para FORNECEDOR Selecione Mapeamento/Campos
1. Selecione “Editar Lista”
2. e “habilitar” Número da conta.
Ainda para FORNECEDOR, selecione Acoplamento/Acoplamento Baseado em Correspondência. Corresponda usando os campos identificadores de fornecedor/conta mostrados na captura de tela, e confirme que os campos correspondentes identificam exclusivamente o mesmo fornecedor em ambos os lados.
Etapa 7: Vincular Ambientes (Opcional)
Requisito opcional de vinculação de ambientes
Vincule ambientes apenas quando o ambiente do Business Central e o ambiente da Power Platform forem do mesmo tipo de ambiente, como produção-para-produção ou sandbox-para-sandbox, e estiverem na mesma geografia do Azure.
Para evitar que alguém exclua acidentalmente ambientes, você pode vinculá-los. Comece de volta no Business Central.
1. Selecione o ícone de engrenagem
2. Então selecione Centro de Administração
Selecione o link do ambiente alvo
Clique em “Vincular” e selecione seu ambiente do Dataverse
Etapa 8: Instalar o Addon do Business Central para RapidStart CRM do AppSource
Confirme a fundação necessária antes de instalar o addon
RapidStart CRM e o suporte de Tabela Virtual do Microsoft Business Central devem ser instalados primeiro. Verifique as tabelas virtuais do Business Central necessárias e os valores de conexão antes de continuar. A vinculação opcional de ambientes não precisa ser concluída para esta instalação do AppSource.
Clique neste link para abrir o AppSource da Microsoft e confirme que você está logado com sua conta comercial.
Selecione “Obter agora” para iniciar a instalação.
1. Selecione o ambiente onde você instalou a solução de Tabelas Virtuais.
2. Concorde com os termos.
3. Clique em Instalar. Note que a instalação pode levar vários minutos.
Você verá que a solução está “Instalando”. Isso pode levar vários minutos para ser concluído. Ocasionalmente clique em “atualizar” até ver que está “Instalado”.
Etapa 9: Complete no aplicativo de Configurações do RapidStart
Vá para o RapidStart CRM e selecione o Aplicativo de Configurações do RapidStart.
Você pode abrir o aplicativo de Configurações do RapidStart a partir do Seletor de Aplicativos no RapidStart CRM, ou do portal do criador:
1. Selecione Aplicativos na barra lateral.
2. Clique no ícone Executar para o aplicativo de Configurações do RapidStart.
1. Confirme que você está no Aplicativo de Configurações do RapidStart.
2. Selecione “Aplicativos e Addons” na barra lateral.
3. Clique em “Configurar” para o Addon do Business Central.
Use este assistente para completar quaisquer itens faltantes e gerenciar o conector.
Solução de Problemas
IDs de conexão ausentes
Se um fluxo relatar um ID de conexão ausente, repare as referências de conexão do Dataverse e do Business Central no aplicativo de Configurações do RapidStart ou no Power Automate, e então ligue o fluxo novamente. Recriar uma conexão sozinha não é suficiente se a referência de conexão ainda estiver vinculada à conexão antiga.
Erros de mapeamento de moeda
Se a sincronização de CLIENTE falhar na moeda, restaure ou verifique o mapeamento de MOEDA, confirme que Código → Código da Moeda está habilitado, sincronize moedas, e confirme que a moeda do cliente existe no Dataverse antes de tentar novamente CLIENTE.
Incompatibilidades de opções
Se a sincronização falhar porque um valor de Termos de Pagamento, Método de Envio ou Agente de Envio está fora do intervalo válido do Dataverse, o ID de valor de enumeração do Business Central não corresponde a um ID de opção do Dataverse. Use FromIntegrationTable para o mapeamento de campo do CLIENTE afetado até que IDs correspondentes sejam implantados.
Acoplamentos apontando para registros excluídos
Se um registro parecer acoplado, mas a sincronização apontar para um registro excluído ou ausente, remova o acoplamento obsoleto no Business Central e crie um novo acoplamento para a conta ou contato correto do Dataverse antes de executar novamente a sincronização.
Implantação Completa
Se houver problemas com esta documentação, por favor nos avise.