Integração ERP: Dynamics 365 Business Central
O Microsoft Dynamics 365 Business Central é o ERP da Microsoft voltado para pequenas e médias empresas. A integração utiliza a API padrão do Business Central (versão 2.0), autenticada via OAuth 2.0 com Azure Active Directory.
Este artigo orienta a configuração da credencial e detalha os relatórios disponíveis deste conector. Para o passo a passo de uso no fluxo de preparação de dados — seleção do conector, credencial, relatório e parâmetros — veja o artigo Etapa ERP.
Configuração da Credencial
Campo | Descrição | Obrigatório |
|---|---|---|
Token URL | URL do endpoint de token do Azure AD (ex: | Sim |
Client ID | ID do aplicativo registrado no Azure AD | Sim |
Client Secret | Segredo do aplicativo Azure AD | Sim |
Host | URL base do ambiente Business Central (ex: | Sim |
Company ID | ID da empresa no Business Central (GUID). Visível em Configurações → Minhas Configurações → Empresa | Sim |
Dica: No Azure AD, registre um aplicativo e conceda a permissão Dynamics 365 Business Central → API.ReadWrite.All. No Business Central, acesse Configurações → Permissões de API e autorize o aplicativo registrado.
Relatórios Disponíveis
Módulo: Estoque
Itens / Produtos
Retorna o cadastro de itens e serviços disponíveis no Business Central.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno (GUID) |
number | Código do item |
displayName | Descrição |
type | Tipo (Estoque / Serviço) |
unitPrice | Preço de venda unitário |
unitCost | Custo unitário |
baseUnitOfMeasureCode | Unidade de medida base |
inventory | Quantidade em estoque |
blocked | Item bloqueado? |
lastModifiedDateTime | Última modificação |
Localizações / Almoxarifados
Retorna os locais de armazenagem (locations) cadastrados.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
code | Código do local |
displayName | Nome |
contact | Contato responsável |
addressLine1 | Endereço |
city | Cidade |
state | Estado |
country | País |
Movimentos de Estoque (Item Ledger Entries)
Retorna os movimentos de entrada e saída de estoque.
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
postingDateFrom | Data inicial de lançamento. Preenchido automaticamente com o 1º dia do mês de referência | Não |
postingDateTo | Data final de lançamento. Preenchido automaticamente com o último dia do mês de referência | Não |
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
entryType | Tipo de movimento (Purchase, Sale, Transfer, etc.) |
postingDate | Data do lançamento |
documentNumber | Número do documento de origem |
itemNumber | Código do item |
description | Descrição |
quantity | Quantidade (positivo = entrada, negativo = saída) |
unitOfMeasureCode | Unidade de medida |
locationCode | Local de armazenagem |
lastModifiedDateTime | Última modificação |
Módulo: Contabilidade
Plano de Contas
Retorna as contas do plano de contas configurado no Business Central.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
number | Número da conta |
displayName | Nome da conta |
category | Categoria (Assets, Liabilities, Equity, Income, etc.) |
subCategory | Subcategoria |
blocked | Conta bloqueada? |
accountType | Tipo (Posting / Heading / Total) |
lastModifiedDateTime | Última modificação |
Lançamentos Contábeis (General Ledger Entries)
Retorna os lançamentos do razão geral.
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
postingDateFrom | Data inicial de lançamento. Preenchido automaticamente com o 1º dia do mês de referência | Não |
postingDateTo | Data final de lançamento. Preenchido automaticamente com o último dia do mês de referência | Não |
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
postingDate | Data do lançamento |
documentNumber | Número do documento |
documentType | Tipo de documento |
accountId | ID da conta |
accountNumber | Número da conta |
description | Histórico |
debitAmount | Valor a débito |
creditAmount | Valor a crédito |
lastModifiedDateTime | Última modificação |
Módulo: Contas a Receber
Clientes
Retorna o cadastro de clientes do Business Central.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
number | Código do cliente |
displayName | Nome / Razão social |
type | Tipo (Pessoa / Empresa) |
phoneNumber | Telefone |
taxRegistrationNumber | CNPJ / VAT |
currencyCode | Moeda |
blocked | Bloqueado? |
lastModifiedDateTime | Última modificação |
Faturas de Venda
Retorna as faturas emitidas para clientes.
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
invoiceDateFrom | Data inicial de fatura. Preenchido automaticamente com o 1º dia do mês de referência | Não |
invoiceDateTo | Data final de fatura. Preenchido automaticamente com o último dia do mês de referência | Não |
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
number | Número da fatura |
invoiceDate | Data de emissão |
dueDate | Data de vencimento |
customerNumber | Código do cliente |
customerName | Nome do cliente |
totalAmountIncludingTax | Valor total com impostos |
currencyCode | Moeda |
status | Status (Draft / In Review / Open / Paid / Canceled) |
lastModifiedDateTime | Última modificação |
Notas de Crédito de Venda
Retorna as notas de crédito emitidas para clientes (devoluções).
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
creditMemoDateFrom | Data inicial. Preenchido automaticamente com o 1º dia do mês de referência | Não |
creditMemoDateTo | Data final. Preenchido automaticamente com o último dia do mês de referência | Não |
Campos retornados: Mesmos de Faturas de Venda.
Pagamentos de Clientes
Retorna os pagamentos recebidos de clientes.
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
postingDateFrom | Data inicial do lançamento. Preenchido automaticamente com o 1º dia do mês de referência | Não |
postingDateTo | Data final do lançamento. Preenchido automaticamente com o último dia do mês de referência | Não |
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
journalDisplayName | Nome do diário |
postingDate | Data do lançamento |
customerNumber | Código do cliente |
customerName | Nome do cliente |
description | Descrição |
amount | Valor do pagamento |
currencyCode | Moeda |
lastModifiedDateTime | Última modificação |
Módulo: Contas a Pagar
Fornecedores
Retorna o cadastro de fornecedores do Business Central.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
number | Código do fornecedor |
displayName | Nome / Razão social |
phoneNumber | Telefone |
taxRegistrationNumber | CNPJ / VAT |
currencyCode | Moeda |
blocked | Bloqueado? |
lastModifiedDateTime | Última modificação |
Faturas de Compra
Retorna as faturas recebidas de fornecedores.
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
invoiceDateFrom | Data inicial. Preenchido automaticamente com o 1º dia do mês de referência | Não |
invoiceDateTo | Data final. Preenchido automaticamente com o último dia do mês de referência | Não |
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
number | Número da fatura |
invoiceDate | Data da fatura |
dueDate | Data de vencimento |
vendorNumber | Código do fornecedor |
vendorName | Nome do fornecedor |
totalAmountIncludingTax | Valor total com impostos |
currencyCode | Moeda |
status | Status |
lastModifiedDateTime | Última modificação |
Módulo: Fiscal
Grupos de Impostos (Tax Groups)
Retorna os grupos de impostos configurados.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
code | Código do grupo |
displayName | Descrição |
taxType | Tipo de imposto |
lastModifiedDateTime | Última modificação |
Áreas Fiscais (Tax Areas)
Retorna as áreas fiscais configuradas.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados: Mesmos de Grupos de Impostos.
Parâmetros Fixos (gerenciados automaticamente)
Parâmetro | Valor padrão | Motivo |
|---|---|---|
|
| Limite de registros por página da API do Business Central |
| (lista de campos pré-configurada) | Define os campos retornados para otimizar o volume de dados |
Artigos relacionados
Etapa ERP
Introdução às integrações
Integrações customizadas via API Rest e conectores SQL