Integración ERP: Dynamics 365 Business Central
Microsoft Dynamics 365 Business Central es el ERP de Microsoft orientado a pequeñas y medianas empresas. La integración utiliza la API estándar de Business Central (versión 2.0), autenticada mediante OAuth 2.0 con Azure Active Directory.
Este artículo orienta sobre la configuración de la credencial y detalla los reportes disponibles de este conector. Para ver el paso a paso de uso en el flujo de preparación de datos — selección del conector, credencial, reporte y parámetros — consulta el artículo Etapa ERP.
Configuración de la credencial
Campo | Descripción | Obligatorio |
|---|---|---|
Token URL | URL del endpoint de token de Azure AD (ej: | Sí |
Client ID | ID de la aplicación registrada en Azure AD | Sí |
Client Secret | Secreto de la aplicación de Azure AD | Sí |
Host | URL base del entorno de Business Central (ej: | Sí |
Company ID | ID de la empresa en Business Central (GUID). Visible en Configuraciones → Mis configuraciones → Empresa | Sí |
Consejo: En Azure AD, registra una aplicación y concede el permiso Dynamics 365 Business Central → API.ReadWrite.All. En Business Central, accede a Configuraciones → Permisos de API y autoriza la aplicación registrada.
Reportes disponibles
Módulo: Inventario
Artículos / Productos
Devuelve el registro de artículos y servicios disponibles en Business Central.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno (GUID) |
number | Código del artículo |
displayName | Descripción |
type | Tipo (Inventario / Servicio) |
unitPrice | Precio de venta unitario |
unitCost | Costo unitario |
baseUnitOfMeasureCode | Unidad de medida base |
inventory | Cantidad en inventario |
blocked | ¿Artículo bloqueado? |
lastModifiedDateTime | Última modificación |
Ubicaciones / Almacenes
Devuelve las ubicaciones de almacenamiento (locations) registradas.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
code | Código de la ubicación |
displayName | Nombre |
contact | Contacto responsable |
addressLine1 | Dirección |
city | Ciudad |
state | Estado |
country | País |
Movimientos de Inventario (Item Ledger Entries)
Devuelve los movimientos de entrada y salida de inventario.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
postingDateFrom | Fecha inicial de contabilización. Se completa automáticamente con el 1.º día del mes de referencia | No |
postingDateTo | Fecha final de contabilización. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
entryType | Tipo de movimiento (Purchase, Sale, Transfer, etc.) |
postingDate | Fecha de contabilización |
documentNumber | Número del documento de origen |
itemNumber | Código del artículo |
description | Descripción |
quantity | Cantidad (positivo = entrada, negativo = salida) |
unitOfMeasureCode | Unidad de medida |
locationCode | Ubicación de almacenamiento |
lastModifiedDateTime | Última modificación |
Módulo: Contabilidad
Plan de Cuentas
Devuelve las cuentas del plan de cuentas configurado en Business Central.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
number | Número de la cuenta |
displayName | Nombre de la cuenta |
category | Categoría (Assets, Liabilities, Equity, Income, etc.) |
subCategory | Subcategoría |
blocked | ¿Cuenta bloqueada? |
accountType | Tipo (Posting / Heading / Total) |
lastModifiedDateTime | Última modificación |
Asientos Contables (General Ledger Entries)
Devuelve los asientos del libro mayor general.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
postingDateFrom | Fecha inicial de contabilización. Se completa automáticamente con el 1.º día del mes de referencia | No |
postingDateTo | Fecha final de contabilización. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
postingDate | Fecha de contabilización |
documentNumber | Número del documento |
documentType | Tipo de documento |
accountId | ID de la cuenta |
accountNumber | Número de la cuenta |
description | Historial |
debitAmount | Importe al debe |
creditAmount | Importe al haber |
lastModifiedDateTime | Última modificación |
Módulo: Cuentas por Cobrar
Clientes
Devuelve el registro de clientes de Business Central.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
number | Código del cliente |
displayName | Nombre / Razón social |
type | Tipo (Persona / Empresa) |
Correo electrónico | |
phoneNumber | Teléfono |
taxRegistrationNumber | CNPJ / VAT |
currencyCode | Moneda |
blocked | ¿Bloqueado? |
lastModifiedDateTime | Última modificación |
Facturas de Venta
Devuelve las facturas emitidas a clientes.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
invoiceDateFrom | Fecha inicial de la factura. Se completa automáticamente con el 1.º día del mes de referencia | No |
invoiceDateTo | Fecha final de la factura. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
number | Número de la factura |
invoiceDate | Fecha de emisión |
dueDate | Fecha de vencimiento |
customerNumber | Código del cliente |
customerName | Nombre del cliente |
totalAmountIncludingTax | Importe total con impuestos |
currencyCode | Moneda |
status | Estado (Draft / In Review / Open / Paid / Canceled) |
lastModifiedDateTime | Última modificación |
Notas de Crédito de Venta
Devuelve las notas de crédito emitidas a clientes (devoluciones).
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
creditMemoDateFrom | Fecha inicial. Se completa automáticamente con el 1.º día del mes de referencia | No |
creditMemoDateTo | Fecha final. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos: Mismos que Facturas de Venta.
Pagos de Clientes
Devuelve los pagos recibidos de clientes.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
postingDateFrom | Fecha inicial de contabilización. Se completa automáticamente con el 1.º día del mes de referencia | No |
postingDateTo | Fecha final de contabilización. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
journalDisplayName | Nombre del diario |
postingDate | Fecha de contabilización |
customerNumber | Código del cliente |
customerName | Nombre del cliente |
description | Descripción |
amount | Importe del pago |
currencyCode | Moneda |
lastModifiedDateTime | Última modificación |
Módulo: Cuentas por Pagar
Proveedores
Devuelve el registro de proveedores de Business Central.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
number | Código del proveedor |
displayName | Nombre / Razón social |
Correo electrónico | |
phoneNumber | Teléfono |
taxRegistrationNumber | CNPJ / VAT |
currencyCode | Moneda |
blocked | ¿Bloqueado? |
lastModifiedDateTime | Última modificación |
Facturas de Compra
Devuelve las facturas recibidas de proveedores.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
invoiceDateFrom | Fecha inicial. Se completa automáticamente con el 1.º día del mes de referencia | No |
invoiceDateTo | Fecha final. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
number | Número de la factura |
invoiceDate | Fecha de la factura |
dueDate | Fecha de vencimiento |
vendorNumber | Código del proveedor |
vendorName | Nombre del proveedor |
totalAmountIncludingTax | Importe total con impuestos |
currencyCode | Moneda |
status | Estado |
lastModifiedDateTime | Última modificación |
Módulo: Fiscal
Grupos de Impuestos (Tax Groups)
Devuelve los grupos de impuestos configurados.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
code | Código del grupo |
displayName | Descripción |
taxType | Tipo de impuesto |
lastModifiedDateTime | Última modificación |
Áreas Fiscales (Tax Areas)
Devuelve las áreas fiscales configuradas.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos: Mismos que Grupos de Impuestos.
Parámetros fijos (gestionados automáticamente)
Parámetro | Valor predeterminado | Motivo |
|---|---|---|
|
| Límite de registros por página de la API de Business Central |
| (lista de campos preconfigurada) | Define los campos devueltos para optimizar el volumen de datos |
Artículos relacionados
Etapa ERP
Introducción a las integraciones
Integraciones personalizadas vía API Rest y conectores SQL