Conectar Microsoft Dynamics 365 Finance & Supply Chain: recibir pedidos de venta
Registre una app en Microsoft Entra ID, registre esa misma app dentro de Finance & Operations y vincule un usuario, pegue la URL del entorno y los tres campos de credenciales en Integration, pruebe, revise el mapping y active: los pedidos de venta empiezan a entrar.
El conector de Microsoft Dynamics 365 Finance & Supply Chain trae los pedidos de venta de su entorno de Finance & Operations a OMS, para que el almacén los despache sin volver a teclearlos a mano. Eso es lo que hace hoy esta conexión: trae pedidos de venta, y no trae clientes, no lee inventario y no devuelve inventario ni ningún otro dato a Dynamics 365. Una conexión sirve a un solo entorno: la URL de entorno que complete apunta directamente a ese entorno.
Requisitos previos#
- Un entorno de Microsoft Dynamics 365 Finance & Supply Chain (Finance & Operations) al que pueda acceder, y su dirección de entorno, por ejemplo https://myorg.operations.dynamics.com.
- Acceso de administrador a Microsoft Entra ID para registrar una app, o un administrador de TI que pueda registrarla por usted y entregarle el ID de inquilino, el ID de cliente y el secreto de cliente.
- Acceso de administración del sistema dentro de Finance & Operations: la app también debe registrarse allí y vincularse a un usuario, y ese usuario necesita un rol que pueda leer los datos de pedidos de venta. Una credencial que solo existe en Entra ID no basta por sí sola.
- Guarde el valor del secreto de cliente en un lugar seguro en cuanto lo cree: se muestra una sola vez y después ya no se puede volver a leer.
Obtener credenciales#
- URL de entorno: use la dirección de su entorno de Finance & Operations, por ejemplo https://myorg.operations.dynamics.com. Copie solo la dirección base: no añada /data al final.
- ID de inquilino e ID de cliente: en Microsoft Entra ID, abra App registrations, registre una app nueva (o abra la que registró su administrador de TI) y, en su página de información general, copie el Directory (tenant) ID y el Application (client) ID.
- Secreto de cliente: en esa misma app, abra Certificates & secrets y cree un nuevo secreto de cliente. Copie su valor enseguida: el valor se muestra una sola vez, y lo que funciona aquí es el valor, no el ID de secreto que aparece junto a él.
- Registre la app dentro de Finance & Operations: en F&O, vaya a System administration → Setup → Microsoft Entra ID applications, añada una fila con el mismo ID de cliente y vincúlela a un usuario cuyo rol pueda leer los datos de pedidos de venta. Si se salta este paso, la prueba siguiente fallará aunque todos los campos estén bien completados.
Completar en Integration#
- Abra Integration → Marketplace → Microsoft Dynamics 365 Finance & Supply Chain → Nueva conexión.
- environment_url — URL de entorno, obligatorio: la dirección de su entorno de Finance & Operations, por ejemplo https://myorg.operations.dynamics.com. Complete solo la dirección base, sin /data al final. Este campo es el que localiza su entorno: esta conexión no tiene ningún campo aparte de nombre de entorno ni de empresa.
- tenant_id — ID de inquilino, obligatorio: el Directory (tenant) ID de la página de información general del registro de la app en Microsoft Entra ID. Es un GUID con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- client_id — ID de cliente, obligatorio: el Application (client) ID de la misma página de información general. Use exactamente el mismo ID que registró dentro de Finance & Operations en el paso de credenciales: ambos deben coincidir carácter por carácter.
- client_secret — Secreto de cliente, obligatorio: el valor del secreto que copió de Certificates & secrets en Entra ID (el valor, no el ID de secreto). Se guarda como secreto y nunca se muestra.
Probar la conexión#
La prueba ejecuta dos pasos, y el mensaje de error indica qué paso falló. Primero comprueba que no falte nada obligatorio (si falta la URL de entorno informa MISSING_ENV_URL, si falta el ID de inquilino MISSING_TENANT_ID, y si falta el ID de cliente o el secreto MISSING_CLIENT_SECRET); después usa su ID de cliente y su secreto para pedir un token de acceso al inicio de sesión de Microsoft para su inquilino: un secreto incorrecto falla aquí con INVALID_CREDENTIALS. Luego usa ese token para leer un único pedido de venta de su entorno (la entidad de datos SalesOrderHeadersV2, un solo registro). Si Microsoft emite el token pero Finance & Operations rechaza esa lectura con un 401, el resultado informa INVALID_TOKEN, lo que casi siempre significa que la app no está registrada dentro de F&O o que no tiene ningún usuario vinculado; un 403 informa MISSING_SCOPE, lo que significa que el usuario vinculado no tiene un rol que pueda leer los datos de pedidos de venta. La prueba concede hasta 12 segundos para que el entorno responda, así que un entorno lento puede fallar solo por tiempo: vuelva a ejecutar la prueba.
Mapping / elegir plantilla#
Elija la plantilla estándar de Dynamics 365 Finance & Supply Chain. Empareja los campos de los pedidos de venta que lee este conector (la entidad de datos SalesOrderHeadersV2) con los campos del pedido estándar del lado de OMS. Antes de activar, abra la vista previa del mapping y confirme que el número de pedido cae en el lugar correcto y que todo campo del que dependa su almacén — fechas de entrega, dirección de envío, referencia del cliente — está emparejado. Los campos que deje sin emparejar simplemente no pasan al pedido estándar, así que contraste la vista previa con un pedido de venta real de su entorno en lugar de activar a ciegas.
Activar#
Tras activar, Integration trae nuevos pedidos de venta de su entorno de Finance & Operations según la frecuencia definida, convierte cada uno en un pedido estándar mediante el mapping y lo entrega a OMS para su fulfillment. Nada fluye en sentido contrario en esta conexión: no sincroniza clientes, no lee inventario y no devuelve inventario ni fulfillment a Dynamics 365. Vigile los primeros pedidos en Runs / Logs y compárelos con los mismos pedidos en F&O antes de dejar la conexión sin supervisión.
Preguntas frecuentes#
La prueba falla con INVALID_CREDENTIALS (401 al pedir el token)
El inicio de sesión de Microsoft rechazó el par de ID de cliente y secreto: el valor del secreto es incorrecto o ha caducado, o el ID de inquilino y el ID de cliente completados aquí pertenecen a registros de app distintos, así que el par no coincide.
Abra el registro de la app en Microsoft Entra ID y contraste los tres valores con él: el Directory (tenant) ID y el Application (client) ID de la página de información general; y en Certificates & secrets cree un secreto nuevo, copie su valor (no el ID de secreto que aparece junto a él) y pegue ese valor en client_secret. Después pruebe de nuevo.
La prueba falla con INVALID_TOKEN (token emitido, pero F&O responde 401)
Las credenciales funcionan en Entra ID, pero Finance & Operations no conoce esta app: nunca se registró en Microsoft Entra ID applications dentro de F&O, o está registrada sin ningún usuario vinculado, así que F&O rechaza el token.
En F&O, vaya a System administration → Setup → Microsoft Entra ID applications, añada o localice la fila con el ID de cliente de esta conexión y vincúlela a un usuario. Guarde y vuelva a ejecutar la prueba: es la corrección más frecuente en esta conexión.
La prueba falla con MISSING_SCOPE (403 de F&O)
F&O conoce la app y aceptó el token, pero el usuario vinculado a la app no tiene un rol que pueda leer los datos de pedidos de venta, así que la lectura de la entidad de datos SalesOrderHeadersV2 es rechazada.
En F&O, dé al usuario vinculado un rol que pueda leer los datos de pedidos de venta (su administrador de F&O asigna los roles en System administration → Users), o vincule la app a otro usuario que ya tenga ese rol. Después pruebe de nuevo.
La prueba falla con MISSING_ENV_URL, o no se llega al entorno
El campo environment_url está vacío, o la dirección que contiene no es la dirección base de su entorno: el error más frecuente es una dirección terminada en /data, que apunta más allá del lugar donde el conector inicia sesión.
Complete environment_url con la dirección base de su entorno de Finance & Operations, por ejemplo https://myorg.operations.dynamics.com, sin nada después de .com; en particular, elimine cualquier /data final. Después pruebe de nuevo.
¿Esta conexión también puede sincronizar clientes o inventario?
No. Esta conexión solo trae pedidos de venta: no trae clientes, no lee inventario y no devuelve inventario a Dynamics 365. Mantenga el mantenimiento de clientes e inventario en el propio Finance & Operations, y use esta conexión para el flujo de pedidos hacia OMS.
Los pedidos de venta son el único flujo que esta conexión transporta de principio a fin, con sus líneas. Consulte clientes y stock en Finance & Operations al trabajar un pedido en OMS: esta conexión no los traerá.