Cómo eliminar la configuración de seguimiento de tiempo en Zoho Desk

Eliminar la configuración de seguimiento de tiempo en Zoho Desk se realiza mediante una única llamada a la API DELETE al endpoint de configuración de seguimiento de tiempo; no se requiere cuerpo en la solicitud más allá de parámetros de consulta opcionales.

Por qué esto es importante

Si tu equipo de soporte ha configurado reglas de seguimiento de tiempo que ya no son relevantes —por ejemplo, tras un cambio en el modelo de facturación o una reestructuración departamental— puede que necesites eliminar completamente esa configuración en lugar de simplemente actualizarla. Conocer el endpoint correcto y el alcance OAuth necesario evita tiempo de depuración innecesario y errores de permisos accidentales. Esto es especialmente útil para desarrolladores que automatizan la gestión de configuración de Zoho Desk mediante scripts o pipelines de CI.

Paso a paso

Paso 1. Confirma que tu token OAuth incluye el alcance correcto de Zoho Desk antes de realizar cualquier llamada a la API relacionada con la configuración. El alcance que necesitas es Desk.settings.DELETE (o el más amplio Desk.settings.ALL). Sin este alcance presente en tu token, la solicitud será rechazada en la capa de autorización. ^[2]

Paso 2. Asegúrate de que tu cliente esté inicializado con un token de acceso válido y el orgId correcto para tu organización de Zoho Desk. Si el orgId falta o está desactualizado, la capa de la API no puede enrutar la solicitud al portal correcto. Puedes obtener el ID de tu organización llamando al endpoint de lista de organizaciones y leyendo el campo id del primer resultado. ^[7]

Paso 3. Envía una solicitud DELETE al siguiente endpoint:

DELETE /api/v1/timetracking/settings

No se necesita cuerpo JSON. Puedes pasar parámetros de consulta opcionales mediante el diccionario p si tu capa de integración lo admite. ^[1]

Paso 4. Si estás utilizando el wrapper de Python que envuelve el cliente de Zoho Desk, llama al método como se muestra a continuación:

response = api.delete_time_track_settings(p=None)

Pasa un diccionario a p solo si necesitas proporcionar parámetros de cadena de consulta; de lo contrario, None es aceptable. ^[1]

Paso 5. Inspecciona el código de estado HTTP de la respuesta. Una eliminación exitosa devolverá un estado 2xx. Si recibes un error 4xx, revisa tus alcances OAuth (Paso 1) y la configuración de tu orgId (Paso 2). Si recibes un error 5xx, el problema está en el servidor de Zoho Desk y puede ser transitorio; reintenta con retroceso exponencial.

Paso 6. Si solo deseas modificar configuraciones específicas de seguimiento de tiempo en lugar de eliminarlas por completo, utiliza PATCH /api/v1/timetracking/settings con un payload de datos. Esta es la operación de actualización y acepta tanto un cuerpo data como parámetros de consulta opcionales p. ^[5]

Errores comunes

• Alcance faltante: La causa más frecuente de una respuesta 403 Forbidden es un token OAuth generado sin Desk.settings.DELETE. Vuelve a autorizar el flujo OAuth e incluye explícitamente este alcance (o Desk.settings.ALL) en tu cadena de alcances. ^[2][3]
• orgId incorrecto o faltante: Zoho Desk es compatible con múltiples organizaciones. Si el encabezado orgId está ausente o es incorrecto, la API no puede identificar la configuración de qué portal eliminar. Siempre descubre y persiste automáticamente el orgId desde el endpoint de organizaciones antes de realizar llamadas de configuración. ^[7]
• Confundir DELETE con PATCH: La llamada DELETE elimina la configuración de seguimiento de tiempo, mientras que PATCH /api/v1/timetracking/settings la actualiza. Asegúrate de estar usando el verbo correcto según tu intención. ^[1][5]

Qué verificar

• Verificación del alcance: Confirma que Desk.settings.DELETE o Desk.settings.ALL aparece en la lista de alcances del token OAuth activo antes de ejecutar la llamada. ^[2]
• Presencia del orgId: Verifica que tu cliente de Zoho Desk esté inicializado con una cadena orgId no vacía, obtenida del endpoint de organizaciones si no está ya almacenada. ^[7]
• Estado de la respuesta: Tras la llamada DELETE, comprueba que el código de estado HTTP esté en el rango 2xx para confirmar que la configuración se eliminó correctamente. ^[1]

---

*Beam Help ofrece soporte experto independiente para productos Zoho. No somos el soporte oficial de Zoho; para problemas a nivel de plataforma, contacta también directamente con Zoho.*