Para las implementaciones locales de Microsoft Dynamics 365 Business Central, se instala el conector de administración de gastos de beneficios como una extensión.

Precaución: Al instalar el conector Perk como extensión, tenga en cuenta que no recibirá actualizaciones automáticas con nuevas funciones. Usted será responsable de instalar y administrar las actualizaciones del conector Perk.

La extensión debe registrarse y configurarse con Microsoft Entra para permitir el acceso de Perk a los puntos finales de la API de Business Central.

Para configurar el conector para Business Central On-Premises:

1. Instala la extensión.
2. Configurar Business Central para Microsoft Entra.
3. Configure el conector en Business Central..
4. Configurar la exportación en Perk:
   1. exportación de gastos
   2. exportación de facturas
5. Sincronizar datos maestros y transaccionales.

Precaución:La edición local de Business Central puede estar alojada en servidores web privados con acceso restringido desde y hacia redes no seguras. Asegúrese de que las políticas de seguridad no impidan el intercambio de tráfico entre Perk y los servicios del inquilino de Business Central.
En otras palabras, las reglas del firewall, las reglas de reenvío de puertos y las puertas de enlace de red seguras deben configurarse para permitir el paso de tráfico hacia y desde Business Central On-Premise y Perk antes de proceder a sincronizar los datos o activar la exportación.

Descripción general arquitectónica

Para intercambiar datos entre Perk y Microsoft Dynamics 365 Business Central, la aplicación utiliza la autenticación y autorización OAuth 2.0 para garantizar la seguridad de la transferencia de datos.

Microsoft Entra se utiliza como proveedor de identidad (IdP). Gestiona de forma segura la información del usuario, los derechos de acceso y las relaciones de confianza entre Business Central y Perk. Tras la autenticación del usuario (es decir, el inicio de sesión), el servidor de autorización emite tokens de seguridad que la aplicación cliente (la aplicación web de Perk) utiliza para conceder, denegar o revocar el acceso a la API de Business Central (autorización). Una vez que la aplicación cliente dispone de tokens de portador válidos (de acceso, ID y actualización), puede acceder a los datos de Business Central y realizar operaciones como crear, actualizar o eliminar. En otras palabras, cuando la aplicación Perk realiza llamadas a la API de Business Central, la extensión verifica los tokens de acceso proporcionados y determina si permite o deniega el acceso a los recursos solicitados. Si se concede el acceso, Perk puede registrar gastos o facturas.

Por lo tanto, debe configurar Microsoft Entra para que reconozca la aplicación cliente (Perk) y emita tokens de seguridad.

Instalar el conector Perk como una extensión

Para instalar el conector Perk como una extensión, necesita tener acceso al paquete del conector (.app). Abrir una solicitud de servicio para obtener acceso al paquete de conectores.

Una vez que tenga acceso a este archivo, puede proceder a Instalar la aplicación usando el Gestión de extensiones página.

El paquete de extensión utiliza estos rangos de ID para los objetos enumerados a continuación:

Nota:Los rangos de ID son dinámicos y pueden verse influenciados por su licencia.
Si utiliza estos rangos de ID, es posible que deba asignar otro para los objetos del paquete de extensión. De lo contrario, se producirán conflictos.

Las extensiones se pueden desinstalar automáticamente después de una actualización de Business Central sin pérdida de datos. Ver Desinstalar la extensión.

Configurar Business Central para Microsoft Entra

Una vez que hayas instalado la extensión, necesitas: registro y configurarlo en Microsoft Entra para permitir que Perk acceda a los puntos finales de la API de Business Central. También necesita configurar los permisos de la aplicación.

Precaución:Es sumamente importante que siga los pasos descritos en el Documentación oficial de Microsoft, en particular las secciones Configurar Business Central Server y Configurar Business Central Web Server Component

Para confiar en los tokens de seguridad emitidos por Microsoft Entra, debe registrar su aplicación. Durante el registro, la plataforma asigna valores clave, como:

• ID de la aplicación (cliente): También conocido como ID de la aplicación o ID del cliente, este identificador único es asignado a su aplicación por la plataforma de identidad. El ID del cliente ayuda a identificar su aplicación dentro de la plataforma y se incluye en los tokens de seguridad emitidos por la misma.
• URI de redireccionamiento:El URI de redireccionamiento especifica a dónde debe enviar el servidor de autorización al agente de usuario (por ejemplo, un navegador web o una aplicación móvil) después de completar el proceso de autenticación. Por ejemplo, después de que el usuario inicie sesión, el servidor de autorización lo redirige al URI especificado. Tenga en cuenta que no todos los tipos de cliente requieren un URI de redireccionamiento.

El registro de la aplicación también proporciona los puntos finales de autenticación y autorización necesarios para obtener identificadores y tokens de acceso.

Registrar una aplicación en el portal de MS Azure

Primero debe registrar una aplicación en el portal de MS Azure para el conector Perk.
Ver Registrar una aplicación en la plataforma de identidad de Microsoft para ayuda.

Cree la definición básica de la aplicación configurando el Descripción general, Autenticación, Certificados y secretos, y Permiso de API secciones.

Descripción general sección:

• Nombre de la aplicaciónConector de Perk Business Central
• Aplicación (ID de cliente): Copia esta identificación, la necesitarás más adelante.

Autenticación pestaña:

Hacer clic + Agregar una plataforma.

1. Seleccionar Web.
2. Ingresar URI de redireccionamiento:
   • https:///BC230/Iniciar_sesión
   • https:///BC230/respuesta_de_autenticación
   • https:///BC230/OAuthLanding.htm
   • https://test.yokoy.ai/oauth2/callback (prueba) o https://app.yokoy.ai/oauth2/callback (pinchar)
3. Haz clic en Guardar.

Consejo: Para agregar varias URI de redireccionamiento, debe agregar una y hacer clic Ahorrar. Luego puedes agregar el segundo en la pantalla principal.

Permisos de API sección:

1. Hacer clic + Agregar un permiso.
2. Seleccionar Dynamics 365 Business Central.
3. En Permisos delegados, seleccione y agregue permisos:
   • suplantación de identidad de usuario
   • Finanzas.LeerEscribir.Todo
4. En Permisos de la aplicación, seleccione y agregue permisos:
   • acceso a la aplicación
   • Centro de administración.LecturaEscritura.Todo
   • API.Lectura y escritura.Todo
5. Hacer clic Otorgar consentimiento de administrador para…

Certificados y secretos sección:

Cree un nuevo secreto de cliente. Le recomendamos que establezca una caducidad de 24 meses. Copie el... Valor y Identificación secreta.

Publicar el servicio web en Business Central

Ingresar "Aplicaciones de Microsoft Entra” en la herramienta de búsqueda global de Business Central (esquina superior derecha) para acceder a la configuración de la aplicación.

Crear la aplicación

Necesita crear una nueva aplicación en Business Central:

1. Crear una nueva tarjeta de aplicación.
2. Ingrese el ID de la aplicación (creada en la sección Información general del portal de Azure) en ID de cliente.
3. Ingresar Beneficio para Business Central en la Descripción.
4. En “Estado”, seleccione Habilitado

Asignar permisos de usuario en Business Central

Debe configurar la aplicación para que tenga permisos de superadministrador.

Más específicamente, debe agregar estos conjuntos de permisos en el Grupos de usuarios sección en la tarjeta de aplicación Microsoft Entra que acaba de crear.

Una vez completada la instalación inicial, los usuarios estándar necesitan el conjunto de permisos Perk BC (PERMISSIONSET YKY) para realizar cualquier cambio posterior en la integración y sincronizar los datos.

Además, debe determinar el rango de ID en el que se pueden crear nuevos objetos (por ejemplo, de 50000 a 55000).

Dado que el rango de ID utilizado para desarrollos personalizados puede variar, es importante especificar este rango, ya que el paquete de instalación sobrescribirá cualquier objeto existente al que se le haya asignado el mismo rango de ID. Ver Instale el conector como una extensión. Para obtener una lista de los rangos de ID utilizados en la extensión de forma predeterminada.

Configurar servicios web

Debe agregar los servicios web en Business Central para cada módulo que planea integrar (es decir, un servicio web para el procesamiento de facturas y otro para el procesamiento de gastos).

Para ello:

1. Ir a Servicios web.
2. Hacer clic + Nuevo para crear un nuevo objeto.
3. Seleccione el Tipo de objeto Codeunit.
4. Busque los ID de objetos según el módulo que desee implementar:
   • Procesamiento de gastos: Gastos de importación YKY (63807)
   • Procesamiento de facturas: Webhooks YKY (63806)
5. Introduzca un nombre de servicio único (por ejemplo, Procesamiento de facturas o Procesamiento de gastos). Asegúrese de que Publicado La casilla de verificación está seleccionada.

Una vez que hayas hecho esto, deberías Configurar la página de configuración de integraciones de Perk en Business Central antes de continuar configurando la exportación de gastos o facturas en Perk.

Configurar la exportación de gastos en Perk

Perk se encarga de exportar los datos de gastos al libro mayor de Business Central. Los recibos de gastos y los documentos adjuntos se pueden adjuntar a los asientos contables según sea necesario.

Si la empresa tiene previsto tramitar notas de crédito, deberá haber habilitado esta función para la entidad jurídica.

Necesitas configurar la pestaña Exportación de gastos (Administración > Integraciones, Exportación de gastos) para enviar datos de gastos (gastos, transacciones con tarjeta, gastos de viaje) a Business Central.

Precaución:No puede utilizar el conector Perk para exportar las dietas/kilometraje por separado.

Para ello:

1. Ve a Configuración > Integraciones.
2. Seleccione la tarjeta Exportación de gastos.
3. Elegir Business Central [API] como el Sistema ERP.
4. Introduzca las credenciales de autenticación:
   • ID de directorio de Azure:ID de inquilino de Business Central
   • ID de cliente: ID de cliente del portal de MS Azure creado previamente
   • Clave secreta del cliente: Secreto de cliente del portal de MS Azure creado previamente
5. Hacer clic Iniciar sesión con Business Central.

Asegúrese de Desactivar cualquier bloqueador de ventanas emergentes En la ventana de su navegador. La autenticación de MS Dynamics utiliza una ventana emergente para realizar la solicitud de autenticación a MS Entra.

Precaución: ¡Asegúrese de seleccionar el sistema ERP correcto! Ms Dynamics Cloud & MS Dynamic OnPrem son las facilidades de exportación para otro conector de MS Dynamics Business Central, no el conector desarrollado por Perk.

Una vez establecida la conexión, puede configurar los ajustes de exportación:

Advertencia:La configuración de exportación de gastos Excluir objetos de coste de la exportación no es compatible con esta integración. La integración de Perk para MS Dynamics 365 Business Central siempre espera un objeto de coste al exportar gastos.

Configurar la exportación de facturas en Perk

Para procesar facturas con Business Central, Perk utiliza webhooks para notificar a Business Central sobre cambios en el estado del documento. Perk cuenta con una función específica de exportación de facturas para gestionar la respuesta del webhook. Actualmente, los webhooks son síncronos. Esto significa que el proveedor debe esperar a que el webhook termine de procesarse para obtener una respuesta.

Para permitir que Business Central se conecte a Perk, debe configurar la integración en Perk:

1. Ve a Configuración > Integraciones .
2. Seleccione la tarjeta Exportaciones de facturas.
3. Introduzca estos datos:
   • Nombre de exportaciónFacturas de Business Central
   • Tipo de documento: Facturas de proveedores
4. En Sistema pestaña, seleccionar Integración de Business Central.
5. En Configuración En la pestaña "Ingresar", introduzca los datos utilizados para crear la URL de acceso a la API de Business Central. Debe introducir estos datos:

Necesitas hacer esto para cada entidad jurídica que desea vincular a una empresa de Business Central.

Advertencia: Si intenta configurar varias instalaciones de exportación (es decir, el conector Perk junto con las integraciones existentes), puede encontrar el error Validación: Múltiples facilidades de exportación aplicables Al intentar exportar una factura, solo se puede tener una función de exportación activa a la vez.

Consejo: Próximo paso: Configurar y sincronizar datos maestros y transaccionales.