Para las implementaciones de Microsoft Dynamics 365 Business Central Cloud, puede optar por instalar el conector de administración de gastos de beneficios desde AppSource o 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 Cloud:

1. Instale la extensión desde el Fuente de la aplicación o como una extensión.
2. Configurar el servicio web en Business Central Cloud.
3. Configurar el conector en Business Central.
4. Configurar la exportación en Perk:
   • exportación de gastos
   • exportación de facturas
5. Sincronizar datos maestros y transaccionales.

Instalar el conector Perk desde Microsoft 365 Dynamics App Source

Para instalar el conector Perk, busque el extensión en AppSource escribiendo Perk y haciendo clic Consíguelo ahora.

Esto instala la extensión en su inquilino de Microsoft 365 Dynamics Business Central.

Instalar el conector Perk como una extensión

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

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 identificación son dinámicos y pueden verse influenciados por la licencia del cliente.
Si el cliente utiliza estos rangos de ID, es posible que tenga que 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 el servicio web en Business Central para Cloud

Dado que Business Central es responsable de recuperar datos de Perk, debe crear el servicio web en Business Central para manejar este proceso.

1. Registrar una aplicación en el portal de MS Azure.
2. Publicar el servicio web en la página de servicio web en Business Central.
3. Asignar los permisos adecuados en Business Central.

Precaución: Asegúrate de desactivar la actualización del entorno de pruebas si instalas la extensión en un entorno de prueba. De lo contrario, tendrás que reconfigurarla después de cada actualización.

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://businesscentral.dynamics.com/OAuthLanding.htm
   • https://businesscentral.dynamics.com/
   • https://test.yokoy.ai/oauth2/callback (Prueba de perk) o https://app.yokoy.ai/oauth2/callback (Propina de beneficio)
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 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. Introduzca el ID de la aplicación (creado en la sección Descripción general en el portal de Azure) en ID de cliente.
3. Ingresar Beneficio para Business Central en la Descripción.
4. En “Estado”, seleccione Activado.

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 Conjunto de permisos de Perk BC (PERMISOS YKY) para realizar cambios posteriores en la integración y sincronizar los datos.

A continuación, debes 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 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 (3110567)
   • Procesamiento de facturas:Webhooks YKY (3110566)
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.

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 sus anexos se pueden adjuntar a los asientos del diario según sea necesario. Si la empresa planea procesar notas de crédito, debe habilitarlas para la entidad legal.

Debe 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. No se puede usar el conector Perk para exportar dietas/kilometraje por separado.

Para ello:

1. Ve a Configuración > Integraciones.
2. Seleccione el Exportación de gastos tarjeta de integración.
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
   • Secreto 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:

La configuración de exportación de gastos Excluir objetos de costo 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 costo 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 el Exportación de facturas tarjeta.
3. En el Exportaciones de facturas pestaña, haga clic Asistente de inicio.
4. Introduzca estos datos:
   • Nombre de exportaciónFacturas de Business Central
   • Tipo de documento: Facturas de proveedores
5. En Sistema pestaña, seleccionar Integración de Business Central.
6. 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.