Configurando roles y permisos para la integración de Payhawk con D365 Finance

Prev Next

Antes de conectar Payhawk a Microsoft Dynamics 365 Finance, asegúrate de que dispones de los siguientes accesos y ajustes.

Qué necesitas

  • Acceso de administrador a Microsoft Lifecycle Services (LCS) para instalar la extensión de Payhawk en tu entorno de Microsoft Dynamics 365 Finance. Para obtener más información, consulta cómo instalar la extensión de Payhawk.

  • Una cuenta de Microsoft Dynamics 365 Finance con acceso de administrador. Con esta cuenta se inicia sesión al conectar los dos sistemas. El rol System administrator es la opción más sencilla, pero también sirve un rol personalizado que incluya la extensión de Payhawk.

Azure y Microsoft Entra ID

Tu equipo de TI no necesita crear ni gestionar un registro de aplicación en tu inquilino de Azure. Payhawk se conecta a través de su propia aplicación de Azure, que Payhawk registra y gestiona en su propio inquilino de Microsoft Entra.

Tu equipo de TI no necesita:

  • Crear un registro de aplicación

  • Generar un secreto de cliente o un certificado

  • Configurar URI de redirección ni permisos de API

  • Registrar una aplicación en System administration > Setup > Microsoft Entra applications en Microsoft Dynamics 365 Finance

Si tu inquilino no permite que los usuarios den su consentimiento a aplicaciones de terceros, Microsoft muestra una solicitud de aprobación cuando la cuenta inicia sesión durante la conexión. Un administrador de Microsoft Entra la aprueba una sola vez. No se necesita ninguna otra configuración de Azure.

Detalles técnicos para tu equipo de TI:

  • Propietario de la aplicación - Payhawk, registrada y gestionada en el propio inquilino de Microsoft Entra de Payhawk

  • Autoridad - https://login.microsoftonline.com/common/oauth2/v2.0

  • Tipo de concesión - Código de autorización de OAuth 2.0, delegado (en nombre del usuario que ha iniciado sesión)

  • Ámbitos solicitados - https://<your environment URL>/.default y offline_access

  • URI de redirección - https://microsoft-dynamics-fo-adapter.payhawk.com/callback

  • Datos a los que puede acceder Payhawk - Solo tu entorno de Microsoft Dynamics 365 Finance, dentro de los roles de seguridad de la cuenta que inicia sesión

  • Credenciales que almacena Payhawk - Solo tokens de OAuth, ninguna contraseña

La cuenta de integración

Payhawk trabaja en Microsoft Dynamics 365 Finance como la cuenta que inicia sesión durante la conexión. Cada registro que crea Payhawk se puede rastrear hasta esa cuenta en el registro de auditoría de Microsoft Dynamics 365 Finance.

Te recomendamos usar una cuenta dedicada, por ejemplo payhawk.integration@yourcompany.com, en lugar de la cuenta de una persona, para que la conexión siga funcionando cuando alguien deje la empresa o cambie de rol. La cuenta debe:

  • Existir en tu Microsoft Entra ID.

  • Estar habilitada en Microsoft Dynamics 365 Finance con acceso a la entidad legal que conectas.

  • Poder completar un inicio de sesión interactivo una vez.

Payhawk usa la cuenta para:

  • Acceder a las dimensiones financieras

  • Acceder a las tasas impositivas

  • Acceder a los proveedores

  • Acceder a los códigos del libro mayor/proyectos

  • Crear encabezados de diario

  • Crear asientos contables

  • Añadir archivos adjuntos

Si la cuenta se deshabilita, se restablece su contraseña o se revocan sus sesiones, la conexión se interrumpe. Para restablecerla, un administrador de Payhawk vuelve a conectar los sistemas desde Ajustes > Integraciones.

Tras el primer inicio de sesión, Payhawk renueva su acceso en segundo plano desde sus propios servidores. Las directivas de acceso condicional que exigen MFA repetida, una frecuencia de inicio de sesión corta, un dispositivo conforme o una red de confianza impiden estas renovaciones e interrumpen la conexión. Excluye la cuenta de integración de estas directivas o permite en ellas la aplicación de Payhawk.

Ajustes en Microsoft Dynamics 365 Finance

Los diarios y los ajustes de contabilización no forman parte del asistente de conexión de Payhawk. Se configuran en la página Payhawk Parameters de Microsoft Dynamics 365 Finance, que se instala con la extensión:

  • Diario de pagos de proveedor

  • Diarios generales y del libro mayor

  • Diario de depósitos

  • Método de pago predeterminado

  • Cuenta de comisiones

  • Grupo de impuestos

  • Tipos de transacciones bancarias

Puedes conectar los dos sistemas antes de completar estos ajustes, pero las exportaciones a Microsoft Dynamics 365 Finance fallarán hasta que lo hagas. Para obtener más información, consulta cómo configurar la extensión de Payhawk.

Antes de conectar

  • La extensión de Payhawk está instalada y la página Payhawk Parameters se abre y está completada.

  • La persona con acceso de administrador a Microsoft Dynamics 365 Finance está disponible para iniciar sesión durante la conexión.

  • Un administrador de Payhawk está disponible para realizar la conexión. Puede ser la misma persona.

  • Tienes la URL de tu entorno de Microsoft Dynamics 365 Finance. Termina en .dynamics.com, por ejemplo contoso.operations.dynamics.com.

  • Tu equipo de finanzas ha elegido la estructura de dimensiones financieras.

Para la configuración durante la conexión, tendrás que:

  1. Autenticarte.

  2. Asignar las cuentas.

  3. Completar la sincronización inicial de datos.

Próximos pasos