Guía técnica: Gestión de los límites de la API en la sincronización entre Sage 200 y Zoho CRM
Al conectar un ERP como Sage 200 con Zoho CRM, la transferencia de información entre ambos sistemas se realiza a través de la API de Zoho. Comprender cómo funciona esta interfaz y, sobre todo, cómo gestiona los límites de consumo es fundamental para garantizar que la sincronización de datos no se interrumpa en momentos críticos de la operativa diaria.
A continuación, explicamos en detalle cómo se calculan estos límites, qué acciones pueden agotarlos y cómo solucionar posibles bloqueos.
1. El sistema de créditos de la API de Zoho CRM
La API de Zoho CRM no permite un número ilimitado de peticiones. Funciona mediante un sistema de créditos diarios que determina cuántas llamadas o acciones se pueden realizar contra la base de datos en un periodo de 24 horas.
El límite exacto de créditos asignado a cada entorno de Zoho CRM varía en función de dos factores:
-
La edición o tipo de licencia contratada (por ejemplo, versión Enterprise).
-
El número de usuarios activos en la plataforma.
El consumo y límite de tu API dentro de Zoho CRM se ve en «configuración» opción «Centro de desarrolladores», opción «Las API y Los SDK»
En esta pantalla del panel de configuración de Zoho CRM puedes consultar el volumen total de créditos API que tu sistema tiene asignados diariamente.
2. El impacto de las actualizaciones masivas en Sage 200
El escenario más habitual en el que se produce un consumo excesivo de la API de Zoho CRM no proviene del uso diario normal, sino de las actualizaciones masivas dentro del ERP.
Cuando se realizan modificaciones en bloque en Sage 200 —por ejemplo, en los módulos de clientes o de artículos—, la acción de guardar esos registros desencadena el proceso del sincronizador. Aunque los datos modificados no sean campos críticos, el sistema detecta que el registro en su totalidad ha cambiado.
El flujo es el siguiente:
- El sincronizador detecta la actualización masiva en Sage 200.
- Se envían las señales individuales de actualización por cada registro modificado.
- La API de Zoho CRM recibe estas peticiones y comienza a actualizar los datos correspondientes, consumiendo un crédito por cada acción o bloque de acciones.
3. Monitorización del consumo de la API
Para prevenir cortes en el servicio, es recomendable auditar de dónde provienen las llamadas a la API. Zoho CRM dispone de un panel de control donde se detalla el gasto de estos recursos.
En este panel puedes auditar el consumo en tiempo real: cuántas llamadas a la API se han ejecutado y qué aplicación, método o usuario específico las ha consumido.
4. Límite de créditos excedido: Consecuencias y soluciones
Si debido a una carga masiva en Sage 200 se agotan todos los créditos disponibles en Zoho CRM, el sistema de protección de la API bloqueará las peticiones adicionales.
¿Qué ocurre entonces?
Tendrás que esperar un ciclo de 24 horas para que el contador de créditos se regenere automáticamente. Durante este periodo de bloqueo, la sincronización entre el ERP y el CRM dejará de actualizar.
Cómo solventarlo puntualmente
Si la interrupción del servicio de sincronización ocurre en un momento crítico de la jornada laboral y no es viable esperar 24 horas, Zoho CRM ofrece una solución de emergencia. Es posible adquirir un aumento temporal de créditos API para reanudar el flujo de datos de manera inmediata.
Desde esta sección de la configuración puedes gestionar la compra de créditos adicionales para ampliar el límite de la API de forma puntual y desbloquear la sincronización.
Recomendación: Para optimizar la integración entre ambos sistemas, aconsejamos planificar las importaciones o actualizaciones masivas de datos en Sage 200 fuera del horario de máxima actividad o realizarlas en lotes controlados para no saturar el límite de la API de Zoho CRM.
Es posible para de igual manera la tarea programada en el servidor de SAGE para que no envie la señal de mofdificación hasta que hayamos terminado los cambios.