Zoho Books devuelve un "Error de servidor interno" (HTTP 500) al enviar declaraciones de Making Tax Digital (MTD) cuando el servidor no puede procesar la solicitud. Este error es genérico y significa que la solicitud llegó a Zoho, pero algo falló dentro del servicio en lugar de un problema de validación del lado del cliente. [1][3]
Qué significa
Un "Error de servidor interno" HTTP 500 durante una presentación de MTD significa que Zoho Books aceptó tu solicitud, pero el backend encontró una condición inesperada al manejarla. En la práctica, esto puede ocurrir dentro de Zoho Books, el conector MTD o un paso de envío anterior de HMRC. El error es reportado por la API como {"code":"INTERNAL_ERROR","message":"Internal Server Error"} sin detalles a nivel de campo. [1][2]
Causas comunes
- Interrupción temporal del backend o servicio degradado que afecta al pipeline de envío de MTD. [4]
- Campos requeridos mal formados o ausentes en la carga útil de MTD que desencadenan una excepción no manejada en el lado del servidor. [1]
- Problemas de autenticación o token de sesión donde la solicitud se autenticó pero la autorización falló en un servicio posterior. [2]
- Condiciones de carrera o ediciones concurrentes en el mismo registro fiscal mientras una presentación está en curso. [1]
Cómo solucionarlo
- Reintenta la presentación después de 30-60 segundos. Si el error provino de un problema transitorio del backend, un solo reintento a menudo tiene éxito. [2][4]
- Reproduce con una carga útil mínima conocida como correcta. Envía una presentación para un período simple que hayas presentado con éxito anteriormente para confirmar que este error es específico de un registro. Si una carga útil mínima tiene éxito, compara las diferencias para encontrar campos mal formados. [1]
- Valida la autenticación y los ámbitos. Confirma que la organización está conectada en Configuración > Integraciones > HMRC/MTD y que el token OAuth está actualizado. Vuelve a conectar la integración o actualiza los tokens si es necesario. [2]
- Consulta el estado y los anuncios de Zoho Books. Busca incidentes conocidos o mantenimiento que afecten los puntos finales de MTD o de presentación antes de escalar. [4]
- Recopila diagnósticos: anota la marca de tiempo de la solicitud, el ID de la organización, el período de presentación, el punto final exacto de la API o la acción de Books, y cualquier ID de correlación de los registros o errores de la interfaz de usuario. Incluye la carga útil sin procesar (redactando secretos) y el cuerpo completo de la respuesta. Usa esto al contactar al soporte. [1]
Cuándo escalar
Si los reintentos y la validación de la carga útil fallan y el error persiste durante múltiples intentos de presentación o afecta a varias organizaciones, escala al Soporte de Zoho con los diagnósticos recopilados. Proporciona marcas de tiempo, ID de organización, carga útil de ejemplo y cualquier ID de correlación para que los ingenieros puedan rastrear la falla del backend. [1][4]
[1]: Error de servidor interno en la automatización de Zoho Creator.
[2]: Errores de importación de seguimiento de tiempo TimeBro/Memtime (ejemplos de HTTP 500).
[3]: Zoho Books da un giro completo con MTD para el impuesto sobre la renta (contexto MTD del producto).
[4]: Error interno al acceder a la bandeja de entrada del equipo (ejemplo de interrupción del servicio).