Saltar al contenido

Requisitos previos para el conector de Microsoft Dynamics 365 Business Central v2 en Jitterbit Integration Studio

Introducción

Como la conexión de Microsoft Dynamics 365 Business Central v2 será una aplicación que se comunica con Microsoft, será necesario registrar una aplicación utilizando Microsoft Entra ID con un conjunto específico de permisos.

Pasos para el registro de la aplicación en Microsoft Azure

Sigue estos pasos para crear un registro de aplicación con la plataforma de identidad de Microsoft:

  1. En el portal de Azure, busca y haz clic en Microsoft Entra ID (anteriormente conocido como Azure Active Directory o Azure AD):

    Microsoft Dynamics 365 Business Central prerequisites 1

  2. En la barra lateral izquierda, bajo Administrar, haz clic en Registros de aplicaciones.

  3. Haz clic en Nuevo registro:

    Microsoft Dynamics 365 Business Central prerequisites 2

  4. Ingresa un Nombre para tu aplicación. Este nombre de visualización será visible para los usuarios:

    Microsoft Dynamics 365 Business Central prerequisites 3

  5. Haz clic en Registrar para completar el registro de la aplicación. Luego serás dirigido a la página de Resumen de la aplicación:

    Microsoft Dynamics 365 Business Central prerequisites 4

    Importante

    Retén el ID de aplicación (cliente) y el ID de directorio (inquilino) del registro de la aplicación para usarlos como client_id y tenant_id al configurar una conexión.

  6. Haz clic en Agregar un certificado o secreto.

  7. En la pestaña Secretos de cliente, haz clic en Nuevo secreto de cliente para abrir el panel Agregar un secreto de cliente. En este panel, ingresa una descripción y selecciona una fecha de expiración para el secreto de cliente, luego haz clic en Agregar:

    Microsoft Dynamics 365 Business Central prerequisites 5

  8. El secreto de cliente ahora es visible en la pestaña Secretos de cliente. Conservalo si deseas configurar una conexión utilizando el tipo de concesión Credenciales de cliente.

Agregar permisos requeridos a la inscripción de la aplicación

Tu inscripción de aplicación debe tener un conjunto específico de permisos.

En el portal de Azure, navega a tu inscripción de aplicación y haz clic en Permisos de API en la barra lateral izquierda:

Microsoft Dynamics 365 Business Central prerequisites 7

Importante

Dependiendo de la configuración de seguridad de tu organización en Azure, algunos permisos requerirán consentimiento de administrador para ser permitidos.

Estos son los permisos que necesitarás configurar:

Permisos de aplicación de Dynamics 365 Business Central

Para agregar permisos de aplicación de Dynamics 365 Business Central, sigue estos pasos:

  1. En la página Permisos de API, haz clic en Agregar un permiso.

  2. En el panel Solicitar permisos de API, haz clic en la pestaña APIs que usa mi organización, busca y haz clic en Dynamics 365 Business Central:

  3. Haz clic en Permisos de aplicación.

  4. Habilita los permisos AdminCenter.ReadWrite.All, API.ReadWrite.All, app_access y Automation.ReadWrite.All.

  5. Haz clic en Agregar permisos. Se muestra la página Permisos configurados de la inscripción de aplicación actualizada.

Permisos delegados de Dynamics 365 Business Central

  1. En la página de Permisos de API, haz clic en Agregar un permiso.

  2. En el panel de Solicitar permisos de API, haz clic en la pestaña APIs que usa mi organización, busca y haz clic en Dynamics 365 Business Central:

  3. Haz clic en Permisos de aplicación.

  4. Habilita los permisos Financials.ReadWrite.All y user_impersonation.

  5. Haz clic en Agregar permisos. Se muestra la página de Permisos configurados de la inscripción de la aplicación actualizada.

Permisos delegados de Microsoft Graph

  1. En la página de Permisos de API, haz clic en Agregar un permiso.

  2. En el panel de Solicitar permisos de API, haz clic en la pestaña APIs que usa mi organización, busca y haz clic en Microsoft Graph:

    Microsoft Dynamics 365 Business Central prerequisites 9

  3. Haz clic en Permisos de aplicación.

  4. Habilita los permisos Financials.ReadWrite.All y user_impersonation.

  5. Haz clic en Agregar permisos. Se muestra la página de Permisos configurados de la inscripción de la aplicación actualizada.

La siguiente tabla resume el conjunto mínimo de permisos requeridos.

Nombre de API/Permiso Tipo Descripción Consentimiento de administrador requerido
AdminCenter.ReadWrite.All Aplicación Acceso completo a la API del Centro de Administración Sí
API.ReadWrite.All Aplicación Acceso completo a la API de servicios web Sí
app_access Aplicación Acceso de acuerdo con los permisos de la aplicación en Dynamics 365 Business Central Sí
Automation.ReadWrite.All Aplicación Acceso completo a la automatización Sí
Financials.ReadWrite.All Delegado Acceso a Dynamics 365 Business Central como el usuario conectado No
user_impersonation Delegado Acceso como el usuario conectado No
User.Read Delegado Iniciar sesión y leer el perfil del usuario No

Una vez que hayas agregado estos permisos, haz clic en Conceder consentimiento de administrador para completar el registro. Una vez completado, cada permiso debería tener una marca de verificación verde.

A continuación, necesitas vincular tu aplicación a Dynamics 365 Business Central. Sigue estos pasos:

  1. Accede a la siguiente URL, haciendo los reemplazos necesarios: https://businesscentral.dynamics.com/{tenant_id}/{env}

  2. Inicia sesión.

  3. En Buscar Microsoft Entra ID, haz clic en Nuevo. Agrega el client_id de tu aplicación y añade una descripción (obligatorio).

  4. En Grupos de usuarios, utiliza el menú desplegable para seleccionar el permiso que deseas otorgar. Jitterbit recomienda D365 BUS FULL ACCESS, pero el mínimo aceptable es D365 COMPANY HUB.

Publicar objetos como servicios web

Los objetos de Business Central deben ser publicados como Servicios Web para ser accesibles a través de el conector. Para lograr esto, sigue los pasos descritos en la documentación de Microsoft.