Perk comprueba la conexión con Business Central antes de cada exportación de gastos. Si la conexión no es válida, la exportación se bloquea inmediatamente con un mensaje de error claro y útil, en lugar de fallar silenciosamente a mitad del proceso. Este artículo explica los motivos por los que puede fallar la autenticación y cómo solucionarlos.
Cuándo y dónde Perk muestra errores de autenticación
Perk realiza la comprobación de credenciales antes de que comience la exportación, por lo que el error aparece inmediatamente, antes de que se envíen documentos a Business Central, en lugar de después de un intento fallido.
- Exportaciones manuales: el error aparece como una notificación emergente al iniciar la exportación. La notificación incluye el mensaje de error específico para que pueda solucionarlo de inmediato.
- Exportaciones automáticas: el error aparece directamente en el gasto, ya que no hay ningún evento manual que active la notificación. Consulte el registro del gasto para ver el error de autenticación y los pasos a seguir.
En ambos casos, la exportación se bloquea por completo (sin fallos parciales ni silenciosos) y el mensaje mostrado coincide con una de las causas que se indican a continuación. Esta comprobación solo valida la autenticación. No detecta:
- Nombre de empresa, nombre de servicio web, instancia o URL base incorrectos.
- Errores tras una autenticación correcta, como fallos en la API de Azure AD a Business Central.
- Errores en la asignación de datos maestros.
Estos problemas se manifiestan como documentos de exportación defectuosos durante el proceso de exportación propiamente dicho.
Faltan credenciales
Por qué sucede: El ID de cliente o el secreto de cliente para la conexión de Business Central nunca se han guardado en Perk.
Qué hacer: Vaya a Configuración > Integraciones > Business Central y complete la configuración de credenciales ingresando el ID de cliente y el secreto de cliente.
Falta la configuración del inquilino de Azure AD.
Por qué sucede:
- Cloud Business Central: el campo ID de inquilino está vacío en la configuración de ERP.
- Business Central local: falta el ID de directorio en las credenciales.
Qué hacer:
- Nube: vaya a Configuración Integraciones Business Central [API] y verifique el ID de inquilino en la configuración de integración.
- En las instalaciones: vaya a Configuración Integraciones Business Central [API] y verifique el ID de directorio en la sección de credenciales.
Credenciales rechazadas por Azure AD.
Motivo del error: Azure AD rechazó las credenciales: el ID de cliente o el secreto de cliente pueden ser incorrectos o haber caducado, o bien, el registro de la aplicación en Azure AD puede haberse eliminado. El mensaje de error incluye el código de error y la descripción de Azure AD.
Qué hacer:
- Revise el código de error de Azure AD que aparece en el mensaje.
- Vaya a Configuración Integraciones Business Central y vuelva a conectarse utilizando credenciales válidas.
- Si se ha eliminado el registro de la aplicación, cree uno nuevo en Azure AD y actualice las credenciales en Perk.
La red o el cortafuegos están bloqueando el servicio de inicio de sesión de Microsoft.
Por qué sucede: Perk no puede acceder a login.microsoftonline.com: un firewall o la configuración de DNS está bloqueando la conexión. El error muestra el código de error POSIX (por ejemplo, ECONNREFUSED o ETIMEDOUT) y el punto final bloqueado.
Qué hacer: Comuníquese con su administrador de TI o de red y comparta el código de error y el punto final que se muestran en el mensaje. Asegúrese de que login.microsoftonline.com sea accesible.
Fallo inesperado durante la verificación de credenciales.
Por qué sucede: Se produjo un error inesperado durante la comprobación; por ejemplo, un error de análisis de la configuración o una excepción en tiempo de ejecución. Se muestra el mensaje de error sin procesar.
Qué hacer: Anote el mensaje de error completo y póngase en contacto con el servicio de asistencia. Los problemas de configuración de Business Central (como el nombre de la empresa o el nombre del servicio web) no se detectan con esta comprobación y pueden aparecer por separado como documentos de exportación fallidos.