Integração ERP: Dynamics 365 Finance & Operations
O Microsoft Dynamics 365 Finance & Operations (F&O) é o ERP enterprise da Microsoft, voltado para grandes organizações. A integração utiliza as OData APIs nativas do D365 F&O, acessadas via autenticação OAuth 2.0 com o 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
A autenticação é feita via OAuth 2.0 com Azure AD (fluxo client credentials).
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 D365 F&O (ex: | Sim |
Company | Código da empresa (data area) padrão para as consultas (ex: | Não |
Dica: No Azure AD, o aplicativo precisa ter a permissão de API Dynamics ERP - Runtime Service. O ambiente D365 deve ter os usuários de integração configurados e o aplicativo registrado como usuário autorizado no sistema.
Relatórios Disponíveis
Módulo: Administração
Empresas (Legal Entities)
Retorna as empresas (entidades legais) configuradas no ambiente D365.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
DataArea | Código da empresa (data area ID) |
CompanyName | Nome da empresa |
DefaultCurrencyCode | Moeda padrão |
CountryRegionISOCode | País (código ISO) |
Estabelecimentos Fiscais
Retorna os estabelecimentos fiscais (CNPJ) cadastrados no D365.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
FiscalEstablishmentId | Código do estabelecimento fiscal |
CNPJNumber | CNPJ |
Name | Nome do estabelecimento |
IsEnabled | Estabelecimento ativo? |
dataAreaId | Empresa (data area) |
Módulo: Estoque
Produtos Lançados
Retorna os produtos cadastrados e lançados para uso nas empresas do D365.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
ItemNumber | Código do produto |
ProductName | Nome do produto |
ProductGroupId | Grupo de produto |
UnitId | Unidade de medida |
ProductType | Tipo de produto |
PurchasePriceQuantity | Quantidade base para preço de compra |
SalesPriceQuantity | Quantidade base para preço de venda |
dataAreaId | Empresa |
Saldo de Estoque
Retorna o saldo físico disponível de itens nos armazéns.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
ItemNumber | Código do produto |
InventSiteId | Código do site / planta |
InventWarehouseId | Código do armazém |
AvailPhysical | Quantidade física disponível |
ReservPhysical | Quantidade reservada |
InventStatusId | Status de inventário |
dataAreaId | Empresa |
Armazéns
Retorna os armazéns cadastrados no D365.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
WarehouseId | Código do armazém |
WarehouseName | Nome do armazém |
InventorySiteId | Site associado |
dataAreaId | Empresa |
Módulo: Contabilidade
Plano de Contas (Contas Principais)
Retorna as contas contábeis principais configuradas no D365.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
MainAccountId | Código da conta contábil |
Name | Nome da conta |
Type | Tipo de conta |
MainAccountCategory | Categoria |
IsBlocked | Conta bloqueada? |
Lançamentos Contábeis
Retorna os lançamentos do razão geral por período.
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
AccountingDateFrom | Data inicial de competência. Preenchido automaticamente com o 1º dia do mês de referência | Não |
AccountingDateTo | Data final de competência. Preenchido automaticamente com o último dia do mês de referência | Não |
Campos retornados:
Campo | Descrição |
|---|---|
RecId | ID do registro |
AccountingDate | Data de competência |
LedgerAccount | Conta contábil |
TransactionCurrencyCode | Moeda da transação |
TransactionCurrencyAmount | Valor na moeda da transação |
AccountingCurrencyAmount | Valor na moeda contábil |
Text | Histórico / descrição |
JournalNumber | Número do diário |
dataAreaId | Empresa |
Diários Contábeis (Cabeçalhos)
Retorna os cabeçalhos dos diários contábeis lançados.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
JournalBatchNumber | Número do lote do diário |
JournalName | Nome do diário |
PostingLayer | Camada de lançamento |
IsPosted | Está lançado? |
TotalCredit | Total a crédito |
TotalDebit | Total a débito |
dataAreaId | Empresa |
Módulo: Contas a Receber
Clientes
Retorna o cadastro de clientes do D365.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
CustomerAccount | Código do cliente |
CustomerGroupId | Grupo de clientes |
OrganizationName | Razão social |
CurrencyCode | Moeda |
SalesTaxGroup | Grupo de impostos de venda |
dataAreaId | Empresa |
Faturas de Clientes
Retorna as faturas emitidas para clientes no período.
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 |
|---|---|
InvoiceNumber | Número da fatura |
CustomerAccountNumber | Código do cliente |
InvoiceDate | Data da fatura |
DueDate | Data de vencimento |
InvoiceAmountInAccountingCurrency | Valor da fatura (moeda contábil) |
AccountingCurrencyCode | Moeda contábil |
Status | Status da fatura |
dataAreaId | Empresa |
Módulo: Contas a Pagar
Fornecedores
Retorna o cadastro de fornecedores do D365.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
VendorAccountNumber | Código do fornecedor |
VendorGroupId | Grupo de fornecedores |
OrganizationName | Razão social |
CurrencyCode | Moeda |
PurchaseTaxGroup | Grupo de impostos de compra |
dataAreaId | Empresa |
Faturas de Fornecedores
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 |
|---|---|
InvoiceNumber | Número da fatura |
OrderVendorAccountNumber | Código do fornecedor |
InvoiceDate | Data da fatura |
DueDate | Data de vencimento |
InvoiceAmount | Valor da fatura |
InvoiceCurrencyCode | Moeda |
dataAreaId | Empresa |
Módulo: Vendas
Pedidos de Venda
Retorna os pedidos de venda registrados.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
SalesOrderNumber | Número do pedido |
CustomerAccountNumber | Código do cliente |
SalesOrderStatus | Status do pedido |
RequestedReceiptDate | Data solicitada de entrega |
TotalChargesAmount | Total de encargos |
SalesOrderTotalTaxAmount | Total de impostos |
dataAreaId | Empresa |
Módulo: Compras
Ordens de Compra
Retorna as ordens de compra emitidas.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
PurchaseOrderNumber | Número da OC |
OrderVendorAccountNumber | Código do fornecedor |
PurchaseOrderStatus | Status da OC |
RequestedDeliveryDate | Data solicitada de entrega |
TotalChargeAmount | Total de encargos |
TotalInvoiceAmount | Total faturado |
dataAreaId | Empresa |
Módulo: Fiscal
Transações de Impostos
Retorna as transações fiscais registradas no D365.
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
TransDateFrom | Data inicial da transação. Preenchido automaticamente com o 1º dia do mês de referência | Não |
TransDateTo | Data final da transação. Preenchido automaticamente com o último dia do mês de referência | Não |
Campos retornados:
Campo | Descrição |
|---|---|
RecId | ID do registro |
TransDate | Data da transação |
TaxCode | Código do imposto |
TaxAmount | Valor do imposto |
TaxBaseAmount | Base de cálculo |
CurrencyCode | Moeda |
Voucher | Comprovante |
dataAreaId | Empresa |
Parâmetros Fixos (gerenciados automaticamente)
Parâmetro | Valor padrão | Motivo |
|---|---|---|
|
| Limite de registros por página da API OData do D365 |
| (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