Quem procura um conector Business Central raramente quer o conector em si: quer que a encomenda da loja online chegue ao ERP sem ser digitada, que os movimentos do banco entrem na contabilidade e que a direção veja números fiáveis num painel de BI. Esta página explica o que o Microsoft Dynamics 365 Business Central oferece para a integração do Business Central com o resto do sistema de informação, onde estão os limites e como uma PME portuguesa deve cadrar cada ligação antes de contratar.
Se ainda está a avaliar o produto, comece pela visão geral dos módulos do Business Central; se já decidiu, o ponto de partida deste tema é perceber que integrar não é instalar uma aplicação: é definir um fluxo, um dono e um plano para quando algo falhar.
As três vias para ligar o Business Central
Na prática, qualquer integração cai numa de três categorias. Escolher a via certa para cada fluxo evita a maior parte dos custos escondidos.
| Via | Quando faz sentido | Quem mantém |
|---|---|---|
| Aplicação (extensão) do Marketplace | Necessidade comum: banco, loja online, assinatura, EDI | O editor da aplicação |
| API REST ou OData chamada por um sistema externo | Software próprio ou de terceiros que precisa de ler e escrever dados | Quem desenvolveu o cliente da API |
| Desenvolvimento em AL dentro do ERP | Regra de negócio específica ou campo que a API standard não expõe | O integrador, ao abrigo de suporte |
A regra de ouro é começar pela via mais standard e só subir quando o requisito o justificar. Uma extensão publicada tem comunidade e histórico de atualizações; um desenvolvimento à medida é só tão bom quanto o contrato que o sustenta. O tema é desenvolvido em personalização e desenvolvimento no Business Central.
A API do Business Central: o que é e o que não é
API REST v2.0
O Business Central expõe uma API REST (v2.0) pensada para relacionar o ERP com soluções de terceiros. Na versão online, as API estão ativas por defeito, o que simplifica o arranque: não há um módulo a comprar nem um serviço a ligar. Quem pesquisa por API Business Central encontra aqui o ponto de entrada normal para sincronizar clientes, artigos, encomendas ou documentos de venda com uma aplicação externa.
Campos em falta: API personalizada
Há uma limitação que convém conhecer cedo: não é possível acrescentar campos a uma API standard. Se o seu fluxo precisa de um campo que a API não traz, copia-se o código AL correspondente e cria-se uma API personalizada. Isto não é um defeito, é uma escolha de arquitetura, mas tem consequência de custo: a API própria passa a ser código seu, que tem de ser testado a cada atualização do ERP. Pergunte ao integrador quantas API personalizadas prevê e quem as testa.
Limites de chamadas
A API tem limites operacionais por utilizador. Para chamadas OData V4, a Microsoft fixa 5 pedidos simultâneos, 100 ligações e uma janela deslizante de 6 000 pedidos em 5 minutos. Ao ultrapassar o limite, o serviço responde com o código HTTP 429. Por isso, um programa que "pergunta tudo de cada vez" falha em produção mesmo quando funcionou na demonstração.
Três consequências práticas para o desenho do fluxo:
- sincronize por alterações e por lotes, não por leitura integral periódica;
- trate o código 429 com tentativas espaçadas, em vez de insistir em ciclo;
- use um utilizador de integração dedicado, para que o tráfego do robô não consuma a quota de uma pessoa.
A Microsoft recomenda a API ou o OData em vez de SOAP, que está destinado a ser descontinuado. Se um fornecedor lhe propõe um conector baseado em SOAP, peça-lhe o plano de migração.
Extensões e Marketplace: a via mais rápida
Na versão online, o Business Central estende-se por aplicações (extensões) instaladas a partir do Microsoft Marketplace. Desde a 2022 release wave 2, as páginas Connectivity Apps e Banking Apps propõem aplicações de ligação a serviços externos, por exemplo para importar transações bancárias. É o caminho natural para quem quer um conector Business Central sem desenvolvimento.
Duas cautelas de bom senso. Primeira: uma aplicação do Marketplace é de um editor, não da Microsoft; o suporte, o preço e a política de atualização são os dele. Segunda: o facto de existir uma aplicação não garante que cubra o seu caso português. Faça sempre uma prova com os seus dados reais, em ambiente de teste.
Os ambientes são relevantes aqui. Um ambiente do Business Central pode ser ligado a um ambiente Power Platform do mesmo tipo (produção ou sandbox); a ligação é exclusiva e serve de alvo por defeito para integrações com a Power Platform e com outros produtos Dynamics 365. Quem prevê automatizações ou painéis nessa plataforma deve decidir esta ligação já no desenho dos ambientes de teste e de produção.
Comércio eletrónico: o conector Shopify
O caso mais documentado é o conector Shopify. Sincroniza produtos, stocks, clientes, encomendas, expedições, transações e pagamentos entre a loja e o ERP, suporta várias lojas e importa encomendas da loja online, do Shopify POS e do B2B.
O que importa a um responsável de operações:
- os artigos sincronizam nos dois sentidos, com imagens, variantes, códigos de barras, etiquetas e metacampos;
- é possível exportar atributos, textos de marketing e traduções;
- os preços exportados baseiam-se nos grupos de preços de clientes e nos descontos escolhidos;
- a sincronização de produtos, stocks, encomendas e expedições pode correr em segundo plano pela fila de trabalhos (job queue) do Business Central, com registo detalhado para diagnosticar falhas.
Para outras plataformas de loja e para os marketplaces, não assuma um equivalente. Verifique no Marketplace se existe extensão mantida, ou peça um orçamento de desenvolvimento por API. O enquadramento de negócio está em ERP para comércio eletrónico, e a gestão de armazém por trás da loja em stocks e compras no Business Central.
Banca, pagamentos e documentos
Movimentos bancários e pagamentos
A importação de extratos é o caso típico das Banking Apps. O que determina o resultado não é o conector, é o formato que o seu banco entrega e a forma como a sua contabilidade concilia. Pontos a validar numa prova:
- se os movimentos entram com a referência que permite conciliar automaticamente;
- como são tratadas as referências Multibanco e as transferências SEPA em lote;
- o que acontece a movimentos duplicados ou rejeitados.
A conciliação alimenta a contabilidade, que pode aprofundar em contabilidade e finanças no Business Central.
Ferramentas de escritório, BI e assinatura
As ligações a folhas de cálculo, a painéis de BI e a ferramentas de assinatura eletrónica seguem a mesma lógica: ou há uma extensão ou ligação standard que cobre o caso, ou usa-se a API. Para a BI, o princípio mais importante é não consultar o ERP de produção de forma intensiva em horas de faturação; combine com o integrador janelas e volumes, tendo em conta os limites descritos acima.
EDI
O EDI com grandes clientes e distribuidores é quase sempre um projeto à parte: depende do formato exigido pelo parceiro comercial, não do ERP. Peça ao seu cliente a especificação, e só depois pergunte ao integrador se há extensão, serviço intermediário ou desenvolvimento. Em ERP para distribuição e grossistas encontra o contexto setorial.
O que é específico de Portugal
Em Portugal, a integração que ninguém pode falhar é a que toca na conformidade fiscal: SAF-T (PT), software de faturação certificado pela AT, ATCUD e código QR, comunicação de faturas via e-fatura e o trabalho do contabilista certificado. Qualquer conector que crie ou altere documentos de venda (uma loja online, um POS, um portal B2B) tem de respeitar a numeração e a série do documento certificado, ou deixa de haver prova coerente.
Sobre a localização: a Microsoft fornece diretamente a localização do Business Central em 21 países, entre os quais Áustria, Bélgica, Alemanha, França, Itália, México, Países Baixos, Espanha, Suíça e Reino Unido. Para os restantes países, a localização chega por aplicações desenvolvidas por parceiros, disponíveis no Marketplace. Portugal não consta da lista de exemplos que a Microsoft cita; peça por isso ao integrador que indique, por escrito, qual a localização portuguesa em uso, quem a mantém e como se articula com cada integração. O ponto é desenvolvido em Business Central em Portugal e, para o enquadramento legal, em SAF-T (PT) e ERP e software de faturação certificado.
Como cadrar um fluxo de integração
Um bom caderno de encargos de integração cabe numa página por fluxo. Para cada ligação, responda a estas perguntas antes de pedir preço:
- Que dados circulam? Artigos, encomendas, faturas, movimentos? Em que sentido?
- Quem é a fonte de verdade? O preço vive na loja ou no ERP? O stock vive no ERP ou no armazém externo?
- Com que frequência? Tempo real, a cada hora, à noite? A frequência decide a via técnica e o risco de atingir os limites da API.
- O que acontece em caso de erro? Quem é alertado, onde fica o registo, como se reenvia?
- Quem mantém? Editor da aplicação, integrador ou equipa interna, e com que contrato.
- Como se testa a cada atualização? Existe um ambiente de teste com dados representativos?
Um fluxo sem resposta clara à pergunta 4 é, em geral, o que gera mais chamadas de emergência meses depois da entrada em produção. O modelo de requisitos genérico em modelo de requisitos de ERP ajuda a estruturar as respostas.
Quem mantém as integrações
A manutenção é onde muitas integrações falham. Separe três responsabilidades:
| Componente | Responsável habitual | O que exigir |
|---|---|---|
| Aplicação do Marketplace | Editor da aplicação | Política de atualização e canal de suporte |
| Integração à medida (API, AL) | Integrador | Cláusula de suporte, código documentado, testes após cada atualização |
| Conta de serviço, credenciais, alertas | A sua empresa, com o integrador | Dono nomeado, rotação de acessos, monitorização |
Combine em contrato o que acontece quando o Business Central é atualizado e uma integração deixa de funcionar. O enquadramento do suporte contínuo está em suporte e manutenção do Business Central. Para escolher quem assume o projeto, veja como escolher o parceiro para o Business Central.
Sinais de alerta antes de assinar
- Um fornecedor promete "integração com tudo" sem listar fluxos, sentidos e responsáveis.
- O orçamento não distingue aplicação de terceiros e desenvolvimento à medida.
- Não há ambiente de teste previsto para validar atualizações.
- Ninguém sabe dizer como se trata o código HTTP 429 ou uma falha de sincronização.
- O conector altera documentos fiscais sem referência à comunicação à AT, ao ATCUD ou ao SAF-T (PT).
O próximo passo
Liste as suas ligações por ordem de criticidade (faturação, banco, loja, BI, EDI), junte uma página por fluxo e use-a para pedir propostas comparáveis. Se quiser que o integrador certo analise o seu caso, o processo de ligação a um integrador explica como funciona o serviço: gratuito, sem compromisso, e neutro quanto ao editor. Se o âmbito do projeto ainda não estiver fixado, a implementação do Business Central mostra onde as integrações se encaixam no calendário.
Perguntas frequentes
Que tipo de API tem o Business Central?
O Business Central expõe uma API REST (v2.0) para ligar o ERP a soluções de terceiros, e as API estão ativas por defeito na versão online. A Microsoft aconselha a usar a API ou o OData em vez de SOAP, que está destinado a ser descontinuado. Se precisar de campos que a API standard não tem, é preciso criar uma API personalizada em AL.
Posso acrescentar um campo a uma API standard do Business Central?
Não. A documentação indica que não é possível acrescentar campos a uma API standard: copia-se o código AL e cria-se uma API personalizada, que passa a ser mantida pela sua empresa ou pelo integrador. Convém decidir isto cedo, porque cada API própria tem de ser testada a cada atualização.
Existe um conector Business Central para lojas online?
Sim, para o Shopify existe um conector da Microsoft que sincroniza produtos, stocks, clientes, encomendas, expedições, transações e pagamentos, com suporte para várias lojas. Para outras plataformas de comércio eletrónico e para marketplaces, a solução passa normalmente por extensões de terceiros ou por um desenvolvimento à medida, a validar com o integrador.
As integrações com bancos e pagamentos vêm incluídas?
Não de forma uniforme. As páginas Connectivity Apps e Banking Apps reúnem aplicações de ligação a serviços externos, como a importação de movimentos bancários, mas o formato de ficheiros e o comportamento dependem do seu banco e da aplicação escolhida. Peça ao integrador um teste com extratos reais antes de decidir.
Quem mantém as integrações depois da entrada em produção?
Depende do que contratou. As aplicações do Marketplace são mantidas pelo seu editor; as integrações à medida ficam a cargo de quem as desenvolveu, normalmente o integrador, ao abrigo de um contrato de suporte. O importante é que cada fluxo tenha um responsável nomeado por escrito, com alertas em caso de falha.
Fontes
Os nomes de software mencionados são marcas dos respetivos editores, citadas a título meramente informativo. Este site é independente e não é afiliado a nenhum editor.