Si usas Microsoft Dynamics 365 Business Central y vendes en una tienda online o un marketplace, necesitas que stock, precios y pedidos circulen sin digitar. Aquí verás qué trae la API estándar, qué límites tiene, qué cubre el conector de Shopify y qué falta para los demás canales.
Qué es Business Central y dónde está disponible
Business Central es el ERP de Microsoft para pequeñas y medianas empresas. Cubre finanzas, ventas, compras, inventario y, en el plan Premium, manufactura y servicio. Esta guía trata la versión online.
Microsoft publica una tabla de disponibilidad por país que indica quién hace la localización, Microsoft o un partner:
| País | Localizado por | Versión base | Estado | Región de Azure |
|---|---|---|---|---|
| Chile | Partner | W1 (internacional) | Disponible | Brasil |
| Costa Rica | Partner | W1 (internacional) | Disponible | Brasil |
| Guatemala | Partner | W1 (internacional) | Disponible | Brasil |
| México | Microsoft | NA | Disponible | Estados Unidos |
Fuente: Microsoft Learn, “Country/regional availability and supported languages”.
En Chile, Business Central corre sobre la versión internacional y la localización la agrega un partner con apps de Marketplace. Microsoft aclara que la tabla no garantiza la disponibilidad de cada app de localización.
Precios de licencia
La página de precios de Microsoft para Estados Unidos publica Essentials a USD 80 por usuario al mes, Premium a USD 110 y Team Members a USD 8, con pago anual (valores al 8 de noviembre de 2026). La compra se hace a través de un partner.
La API REST v2.0
Business Central online trae la API v2.0 habilitada por defecto. Es una API REST basada en OData v4 y Microsoft la recomienda por sobre publicar páginas como servicios OData o SOAP.
Las URL siguen este patrón, según el ejemplo oficial de autenticación:
https://api.businesscentral.dynamics.com/v2.0/{entorno}/api/v2.0/companies({id})/itemsTodo cuelga de una empresa (companies). La referencia v2.0 tiene 87 recursos; estos son los que más se usan en comercio electrónico:
| Entidad | Qué trae |
|---|---|
items |
Código, nombre, GTIN, tipo, categoría, inventory (solo lectura), unitPrice y unitCost |
itemVariants |
Variantes de cada producto, con código y descripción |
customers |
Datos del cliente, dirección, número tributario (taxRegistrationNumber), límite de crédito y bloqueo |
salesOrders y salesOrderLines |
Pedidos de venta; cada línea admite variante (itemVariantId) y bodega (locationId) |
salesInvoices |
Facturas de venta con sus líneas |
itemLedgerEntries |
Movimientos de inventario: tipo, documento, fecha, cantidad, venta y costo |
locations |
Ficha de cada bodega: código, nombre y dirección |
Fuente: Microsoft Learn, referencia de recursos de la API v2.0.
Autenticación con Microsoft Entra ID
La API usa OAuth 2.0 con Microsoft Entra ID. Para una integración que corre sin nadie frente al teclado, Microsoft documenta la autenticación servicio a servicio (S2S), que usa el flujo de credenciales de cliente. Está disponible para la API v2.0 desde la versión 18.3 de Business Central online.
Se configura en dos partes:
- En Microsoft Entra ID: registrar una aplicación, crear un secreto de cliente y darle el permiso de aplicación
API.ReadWrite.Allsobre Dynamics 365 Business Central. - En Business Central: abrir la página de aplicaciones de Microsoft Entra, crear la ficha con el Client ID, dejarla habilitada y asignarle los conjuntos de permisos que necesita.
Microsoft no permite asignar el conjunto SUPER a estas aplicaciones. El token se pide a login.microsoftonline.com con el alcance https://api.businesscentral.dynamics.com/.default. Desde octubre de 2022, Basic Auth no funciona en la versión online.
Webhooks: cómo avisa los cambios
Business Central avisa cambios mediante suscripciones (subscriptions). Tu sistema registra una URL, recibe un validationToken y debe devolverlo con código 200. Así funcionan:
- No es inmediato. Espera 30 segundos después del primer cambio para agrupar cambios del mismo registro.
- El aviso no trae los datos. Indica la entidad y el tipo de cambio (
created,updated,deleted). Tu sistema tiene que consultar la API para leer el registro. - Cambios masivos. Si en esos 30 segundos cambian más de 1.000 registros, llega un solo aviso de tipo
collectioncon un filtro, y hay que pedir todo lo que calce. - Las suscripciones vencen a los tres días. Hay que renovarlas con un PATCH, que repite el saludo con el token.
- Reintentos acotados. Si tu URL no responde, Business Central reintenta durante 36 horas, pero solo ante códigos 408, 429 o 5xx. Con cualquier otro error borra la suscripción.
La lista de entidades con webhook incluye items, customers, salesOrders, salesInvoices y salesQuotes, entre otras. No incluye itemLedgerEntries ni locations. Para una tienda, eso significa que no hay una suscripción documentada que avise cada movimiento de inventario. Conviene combinar los avisos con consultas periódicas del stock.
API pages personalizadas
La API estándar no se puede extender con campos adicionales. Microsoft lo dice así: si necesitas más campos, tienes que copiar el código AL de la API y crear una API personalizada.
Una API personalizada es una página AL con PageType = API, publicada en una extensión, en una ruta del tipo api/{publisher}/{grupo}/{versión}/. Puede tener webhooks, salvo excepciones como tablas temporales o claves compuestas. Requiere alguien que programe en AL.
Límites publicados
Microsoft publica límites operativos para Business Central online. Los de velocidad hoy se aplican por usuario, y una aplicación S2S cuenta como un usuario más:
| Límite | Valor |
|---|---|
| Solicitudes OData por usuario | 6.000 en una ventana móvil de 5 minutos |
| Solicitudes procesadas a la vez por usuario | 5 (el resto espera en cola) |
| Solicitudes simultáneas por usuario, incluida la cola | 100 |
| Registros por respuesta | 20.000 |
Operaciones por $batch |
100 |
| Tiempo máximo por solicitud | 8 minutos |
| Suscripciones de webhook por entorno | 200 |
Fuente: Microsoft Learn, “Operational limits for Business Central online”.
Al pasar el límite la API responde 429, y una solicitud que espera más de 8 minutos en cola recibe 503. Microsoft aclara que no hay, por ahora, un cupo diario o mensual. Para mucho volumen recomienda repartir la carga entre varios usuarios o aplicaciones y reintentar con espera.
Qué no trae la API estándar: stock por bodega y listas de precios
Este es el punto que más pesa en una integración con tiendas.
Stock por bodega. La entidad items entrega un solo campo inventory, con el total del producto. locations es solo la ficha de cada bodega, sin cantidades. itemLedgerEntries lista movimientos, pero en la API v2.0 no trae el código de bodega. Puedes indicar la bodega en una línea de pedido, pero no leer el stock de cada una sin una API personalizada.
Precios. items expone un solo unitPrice, el precio de la ficha del producto. Entre los 87 recursos de la API v2.0 no hay uno de listas de precios ni de precios por grupo de clientes. Si vendes con precios distintos por canal o por cliente, también necesitas una API personalizada.
El ERP sí maneja esos datos (el conector de Shopify los usa); lo que falta es exponerlos en la API REST.
El conector oficial de Shopify
Microsoft mantiene el Shopify Connector, una app de código abierto preinstalada en los entornos nuevos. Funciona solo en la versión online y requiere licencias de Business Central y de Shopify.
Lo que sincroniza:
- Productos. Exporta nombre, descripción, imagen, precio, variantes y código de barras, o los importa desde Shopify.
- Stock. Envía el stock a cada ubicación de Shopify, calculado desde las bodegas que elijas con un filtro. Trae dos métodos de cálculo: saldo disponible proyectado a hoy e inventario libre (no reservado).
- Precios. Envía el precio y el precio de comparación. Puede usar el precio de un grupo de clientes y descuentos, y sincronizar precios por mercado. Los catálogos B2B requieren Shopify Plus.
- Pedidos. Importa pedidos y puede crear el pedido o la factura de venta en forma automática. Con Auto Sync Orders recibe un aviso de cada pedido nuevo y lo procesa con la cola de trabajos.
- Clientes, despachos y devoluciones.
Lo que no hace o tiene restricciones:
- Calcula cada precio para una unidad. No exporta precios ni descuentos por cantidad.
- No importa pedidos archivados en Shopify ni exporta vendedores desde Business Central.
- Solo envía un precio cuando cambia en Business Central. Si lo cambias a mano en Shopify, la sincronización no lo corrige.
- En países sin localización de Microsoft, el alta de una prueba desde la app de Shopify se detiene con un aviso de que Business Central no está disponible en ese mercado. En Chile, el alta pasa por un partner.
Para países soportados, Microsoft remite a la ficha del conector en Marketplace. Si estás armando la tienda, revisa nuestra guía de Shopify en Chile.
WooCommerce, Mercado Libre y Falabella
En la documentación de Business Central, el único conector de comercio electrónico propio de Microsoft es el de Shopify. Para WooCommerce, VTEX, Mercado Libre, Falabella u otros canales tienes dos caminos: una app de un partner o un desarrollo sobre la API.
Si desarrollas, define antes:
- Qué código usa cada canal y que coincida con el número o la variante en Business Central.
- De qué bodegas sale el stock publicado. Si es más de una o no es el total, necesitas la API personalizada.
- Qué precio usa cada canal: el de la ficha o el de un grupo de clientes.
- Cada cuánto consultas el stock, porque los movimientos de inventario no tienen webhook.
En marketplaces una venta sin stock termina en cancelación. Lo explicamos en sobreventa de stock multicanal y en cómo vender en Mercado Libre conectado al ERP.
Facturación electrónica en Chile
Business Central no trae la facturación electrónica chilena de fábrica. Como Chile tiene localización de partners, la emisión de DTE ante el SII depende de la app que instale tu partner. Si tu integración crea facturas por API, confirma con él cómo se emiten como DTE.
ERPSync con Business Central
ERPSync conecta el ERP con tiendas y marketplaces: WooCommerce, Shopify, VTEX, Magento, PrestaShop, Jumpseller, Mercado Libre, Falabella, Ripley, Paris y Walmart. Nuestra especialidad es Softland, y con Microsoft Dynamics Business Central trabajamos previa revisión técnica de tu caso, usando su API.
Cuesta 0,80 UF al mes por integración, sin límite de pedidos. Puede haber un costo inicial, que cotizamos después de revisar tu caso. Hay prueba de 14 días. El detalle está en precios.
Preguntas frecuentes
¿Business Central tiene API?
Sí. La versión online trae la API REST v2.0, basada en OData v4, con autenticación OAuth mediante Microsoft Entra ID.
¿Business Central está disponible en Chile?
Sí, con localización de partners sobre la versión internacional, según la tabla oficial de Microsoft. Lo mismo aplica a Costa Rica y Guatemala.
¿La API de Business Central entrega el stock por bodega?
No en la API estándar. items trae solo el inventario total y locations no trae cantidades. Para leer el stock de cada bodega hace falta una API personalizada.
¿Business Central avisa al instante cuando algo cambia?
Avisa mediante webhooks, pero con 30 segundos de espera, y el aviso no trae los datos. Las suscripciones vencen a los tres días y los movimientos de inventario no tienen webhook.
¿Cuántas llamadas permite la API de Business Central?
Hasta 6.000 solicitudes por usuario en una ventana móvil de 5 minutos, con 5 procesadas a la vez. No hay un cupo diario ni mensual publicado.
¿Business Central se conecta con Shopify?
Sí. El conector oficial de Microsoft sincroniza productos, stock por ubicación, precios, clientes y pedidos, solo en la versión online.
Fuentes
Consultadas el 8 de noviembre de 2026.
- Country/regional availability and supported languages, Microsoft Learn
- Business Central pricing, Microsoft
- Welcome to the API (v2.0) for Business Central, Microsoft Learn
- Item resource type, API v2.0, Microsoft Learn
- itemLedgerEntry resource type, API v2.0, Microsoft Learn
- location resource type, API v2.0, Microsoft Learn
- salesOrderLine resource type, API v2.0, Microsoft Learn
- Using service-to-service (S2S) authentication, Microsoft Learn
- Working with webhooks in Business Central, Microsoft Learn
- Developing a custom API, Microsoft Learn
- Web services overview, Microsoft Learn
- Operational limits for Business Central online, Microsoft Learn
- Get started with the Shopify connector, Microsoft Learn
- Synchronize items, Microsoft Learn
- Synchronize inventory, Microsoft Learn
- Synchronize prices, Microsoft Learn
- Synchronize and fulfill orders, Microsoft Learn
- FAQ for the Shopify connector, Microsoft Learn
Escrito por el equipo de ERPSync, especialistas en integraciones con Softland. Quiénes somos
