Conectar Business Central

La conexión viene con los planes Pro Nacional y Enterprise, como los orígenes de importación (página de planes), y llega a Microsoft Dynamics 365 Business Central en línea. Trae tus artículos, tus clientes con sus direcciones de envío y una tarifa, y entrega a Business Central, como pedidos de venta, los pedidos que se entregan al confirmarse. No guardamos ninguna contraseña ni clave tuya: un administrador de tu Microsoft Entra da permiso a la aplicación de MercaMap y puede retirarlo allí cuando quiera.

Antes de conectar

El administrador de tu Business Central, con un administrador de tu Microsoft Entra, hace esto una vez, desde «Ajustes de la cuenta › Catálogo › ERP»:

1. Iniciar sesión con Microsoft. Un administrador de la cuenta guarda el entorno (Production o uno de pruebas), la empresa como la muestra Business Central y el inquilino (su identificador o un dominio verificado, como contoso.onmicrosoft.com), solo una pista. Pulsa «Usar este inquilino» si tu cuenta ya ha verificado uno en otra conexión; si no, «Iniciar sesión con Microsoft para verificar el inquilino» (con tu segundo factor): entra con una cuenta de trabajo, ni de invitado ni personal, un administrador de tu Microsoft Entra que pueda dar consentimiento a aplicaciones (global, de roles con privilegios, de aplicaciones o de aplicaciones en la nube). La conexión llega entonces solo a ese inquilino.
2. El consentimiento. La página muestra entonces el enlace «Dar permiso a la aplicación de MercaMap en Microsoft Entra», para el inquilino verificado. Un administrador de tu Microsoft Entra lo abre, inicia sesión y acepta: la aplicación pide solo el permiso de aplicación API.ReadWrite.All de Business Central («Access to APIs and webservices»), y Microsoft vuelve a llevarlo a la página «ERP», que dice si se dio el consentimiento.
3. La aplicación en Business Central. En la página de aplicaciones de Microsoft Entra («Microsoft Entra Applications» en inglés), añade una ficha con el identificador de la aplicación que muestra la página «ERP» y una descripción, y habilítala. Dale permiso para leer artículos con sus unidades de medida, clientes, direcciones de envío y líneas de tarifa, y para crear y leer pedidos de venta, nada más: Business Central nunca deja que una aplicación tenga SUPER.
4. Las páginas que publicar. Los artículos y los clientes llegan por la API estándar de Business Central; las unidades de medida, las direcciones de envío y las tarifas, de páginas que tu administrador publica como líneas de tipo Page en la página de servicios web («Web Services» en inglés): 5404 («Unidades medida producto», con un nombre como ItemUnitsOfMeasure), 300 («Ship-to Address», ShipToAddresses) y 7005 («Price List Line Review», PriceListLines). Escribe esos nombres en la página «ERP».

Por qué el inicio de sesión va primero. Escrito, el identificador de un inquilino no demuestra nada: el inicio de sesión muestra que lo preparó un administrador de tu organización, y ninguna otra cuenta de MercaMap puede conectar tu inquilino.

Microsoft Learn explica los pasos 2 a 4: Using Service to Service Authentication y Publish a Web Service.

Qué trae

Cada parte que marcas es un origen de importación propio, con «Traer ahora», programación opcional e historial; entra en las importaciones como un archivo subido, y en Business Central no cambia nada.

• Artículos, en tus referencias: el número del artículo como tu código, su nombre, su GTIN como código de barras y su tamaño de caja, la cantidad en unidades base enteras de la primera unidad que tiene entre las que la página «ERP» nombra como caja, en orden (CAJA, UDS). Un artículo sin ninguna conserva el tamaño de caja de su referencia; una referencia nueva sin él se rechaza. Los servicios y los artículos bloqueados se quedan fuera; puedes traer una sola categoría.
• Clientes y direcciones de envío, en tus códigos de tienda. Escribe cada cliente que es de una cadena, uno por línea (C00010 = Masymas): cada una de sus direcciones de envío es una tienda de esa cadena, con el código cliente/dirección (C00010/T01), buscada en nuestro directorio por su dirección y código postal; un cliente sin direcciones de envío es él mismo una tienda, con su número como código. Un cliente que no escribes, o uno bloqueado para envíos, se queda fuera.
• Una tarifa, en una de tus listas de precios: las líneas de una tarifa de Business Central, por su código, con el precio unitario de cada artículo vigente ese día para su unidad base. Solo las líneas activas (tras «Comprobar líneas») de la nueva experiencia de precios; con los precios de antes, súbela como archivo.

Entregar los pedidos

Marca «Entregar a Business Central, como pedidos de venta, los pedidos que se entregan al confirmarse»; para eso, la entrega tiene que ser «Al confirmarse cada pedido» (Archivos del ERP y entrega de pedidos). Cada uno llega entonces a Business Central como pedido de venta:

• su cliente y su dirección de envío, del código de la tienda (C00010/T01), con el nombre y la dirección de la página que publicaste;
• una línea de artículo por referencia, con tu código como número de artículo y las unidades como cantidad, en la unidad base del artículo, nunca en su unidad de venta;
• el identificador de nuestro pedido, sin guiones, como número de documento externo. Antes de crear un pedido buscamos ese número, así que un pedido cuya respuesta se perdió nunca se crea dos veces.

Business Central pone el precio como a cualquier pedido de venta, y su número vuelve como la respuesta: el pedido se muestra como «Aceptado por el ERP». La página «ERP» cuenta los pedidos que esperan para entregarse y lista los que no se han podido entregar, con el motivo:

• Business Central ha rechazado el pedido (un cliente bloqueado, un artículo que no conoce): entrega ese pedido por archivo.
• Nadie ha verificado el inquilino: verifícalo y pulsa «Volver a intentarlo».
• No ha aceptado nuestra aplicación, la empresa no está en ese entorno o una página no está publicada con el nombre que escribiste: corrígelo en Business Central o en Microsoft Entra y pulsa «Volver a intentarlo».
• Business Central ha tardado demasiado o ha respondido con un error: lo intentamos de nuevo más tarde y paramos tras varios fallos seguidos; «Volver a intentarlo» entrega de nuevo los pedidos detenidos.

Cuando Business Central pide esperar, los pedidos esperan a la siguiente ronda sin contar como fallo.

Qué guardamos

El inquilino escrito, el entorno y la empresa, lo que lee cada parte y las cadenas de los clientes, hasta que eliminas la conexión o se cierra la cuenta; el verificado (su identificador, quién empezó el inicio de sesión y cuándo), hasta que lo libera el soporte de MercaMap o se cierra la cuenta. Ninguna contraseña, secreto ni clave tuya: el token que Microsoft da a nuestra aplicación vive solo en la memoria de nuestro servidor y caduca antes de una hora. «Eliminar la conexión», tras confirmarlo, elimina sus orígenes (las importaciones que abrieron se quedan) y deja de entregar pedidos. Para retirar el acceso de MercaMap, elimina la aplicación de las aplicaciones empresariales de tu Microsoft Entra o deshabilítala en Business Central.

Siguientes pasos

• Archivos del ERP y entrega de pedidos
• Orígenes de importación
• Pedidos