Errores conocidos
Esta sección ofrece una referencia resumida de las incidencias más habituales del sistema, junto con sus causas técnicas y pautas de resolución. Su finalidad es apoyar un diagnóstico rápido y garantizar una gestión eficiente de errores.
- Error 401 Unauthorized
- Etiquetas Duplicadas en PLEO
- Error 429: Demasiadas peticiones (Too Many Requests)
Error 401 Unauthorized
Cuando nos sale el Error 401 Unauthorized. Lo más probable es que el token que se generó en Pleo para que BC se conecte esté caducado.
Para solucionarlo debemos crear un nuevo token en Pleo.
Con un usuario que pueda realizar configuración en PLEO y nos dirigimos a "Ajustes - Claves de API - Ir a tokens de OpenAPI":
Creamos un nuevo Token y copiamos el valor, el cual pegamos en "Token", en la pantalla de "Configuración de la conexión" que tenemos abierta en BC.
Podemos probar que conecta utilizando la acción correspondiente:
Etiquetas Duplicadas en PLEO
Existe un error poco frecuente que provoca la duplicación de determinadas dimensiones sincronizadas con Pleo. Para mitigar este comportamiento, se ha implementado un proceso específico en Business Central destinado a corregirlo.
Configuración de Negocio Pleo - Relacionado - Corregir Etiquetas duplicadas en Pleo
Este proceso ejecuta una tarea en segundo plano que analiza las dimensiones existentes en Pleo y las compara con las registradas en Business Central. Cuando detecta dimensiones presentes en Pleo que no existen en Business Central, procede a marcarlas como ocultas para evitar inconsistencias y prevenir futuras duplicaciones.
Se puede consultar el estado del proceso en "Mov. cola trabajo", el proceso lo lleva a cabo la codeunit 7257592 "GDSIHP Fix Duplicated Tags".
No se deben crear ni modificar valores de dimensión de aquellas dimensiones que están sincronizadas con PLEO mientras se realiza esta tarea.
Error 429: Demasiadas peticiones (Too Many Requests)
Error
El error 429 - Too Many Requests se produce cuando una API limita las solicitudes recibidas en un periodo de tiempo.
Cuando se produce este error, la integración de Pleo no puede completar la operación solicitada y mostrará un mensaje similar al siguiente:
Causa
Este comportamiento se debe a que la API de Pleo implementa un sistema de seguridad para evitar que se sature con demasiadas peticiones. Cuando se alcanza el límite de peticiones establecido por Pleo, la API devuelve un error 429 y rechaza temporalmente nuevas solicitudes.
Dado que los límites aplicados por la API de Pleo no están documentados, no hemos podido implementar un sistema que evite este error de forma eficaz, pero hemos incluido un método para intentar solucionarlo.
Mitigación del problema
Para minimizar el impacto de esta limitación, la integración incorpora un mecanismo de reintentos configurable y tiempo de espera desde la pantalla Configuración de Conexión, accesible desde Conciliaciones Pleo o desde Dynasoft Centro de Integraciones.
Los siguientes parámetros permiten ajustar el comportamiento ante errores 429:
- Número de reintentos
Indica cuántas veces se volverá a intentar la conexión cuando la API devuelva un error 429. - Segundos a esperar entre reintentos
Indica el tiempo de espera entre cada intento de conexión.
Resolución
Si los errores 429 se producen de forma recurrente, se recomienda aumentar progresivamente los valores configurados:
- Aumentar el campo Segundos a esperar entre reintentos de segundo en segundo.
- Si el problema persiste, aumentar el Número de reintentos.
- Ejecutar nuevamente la operación y verificar el resultado.
Según hemos observado, incrementar los segundos a esperar a 2 soluciona el problema... si no fuera así, recomendamos aumentar el nº de reintentos (dejando el tiempo de espera a 2 segundos).