El error "La facturación electrónica no se pudo habilitar ya que el portal FTA no está disponible actualmente" aparece durante la configuración de la facturación electrónica en Zoho Books cuando Books no puede acceder al punto final del gobierno (FTA/EmaraTax/PEPPOL) necesario para vincular y habilitar la facturación electrónica para su organización [2]. Detiene el paso final de activación en Configuración > Facturación electrónica.
Qué significa
Zoho Books debe conectarse al FTA externo (o a una pasarela de facturación electrónica local como EmaraTax/PEPPOL) para registrar su organización, intercambiar credenciales y habilitar la firma/envío de facturas electrónicas. El error significa que el apretón de manos HTTP/API falló: Books intentó llamar al punto final del FTA y no obtuvo respuesta o recibió un error a nivel de red en lugar de la respuesta de registro esperada [2][5]. La interfaz de usuario de Zoho muestra el fallo durante el paso final de habilitación y ofrece acciones de reintento en flujos de integración similares [3].
Causas comunes
- Interrupción temporal del portal gubernamental o mantenimiento programado que bloquea las respuestas de la API [5].
- Reglas de red o firewall de su lado que bloquean las llamadas salientes a la pasarela FTA (puertos o rangos de IP) [7].
- Selección incorrecta de país/inquilino o configuración de cuenta en Configuración > Facturación electrónica, lo que hace que Books apunte al punto final incorrecto [2].
- Credenciales de API o consentimiento obsoletos o faltantes entre Zoho Books y la pasarela FTA (el enlace nunca se completó) [2][7].
Cómo solucionarlo
- Verifique primero el estado del FTA/servicio. Visite la página de estado de FTA/EmaraTax/PEPPOL o las notificaciones de la autoridad local; si informan de una interrupción, espere y vuelva a intentarlo.
- Vuelva a intentarlo desde Zoho Books: vaya a Configuración > Facturación electrónica y haga clic en "Reintentar" o reinicie el flujo de enlace. La interfaz de usuario de Books tiene un patrón de reintento para fallos de integración [3].
- Confirme la configuración de su cuenta: verifique el país/inquilino seleccionado, el número de GST/IVA/registro y que completó cualquier paso de consentimiento del portal externo que se mostró durante la configuración [2].
- Verifique el acceso a la red: permita HTTPS saliente (puerto 443) a las IP/nombres de host de la pasarela FTA utilizados por su país. Verifique las reglas del firewall corporativo, proxy o VPN y pruebe temporalmente desde una red sin restricciones. Registre cualquier fallo de conexión.
- Vuelva a autorizar las credenciales: desvincule y vuelva a vincular la conexión EmaraTax/FTA desde Configuración > Facturación electrónica, siguiendo exactamente las indicaciones de consentimiento del portal; si el portal requiere un inicio de sesión de portal separado, complételo y confirme que el enlace muestra "vinculado" en Books [2].
- Capture los detalles del error: si el reintento falla, reproduzca el error y anote la hora exacta, el ID de la organización de Zoho Books, los errores de la consola del navegador y cualquier código de estado HTTP devuelto por el portal. Estos datos aceleran la resolución de problemas.
Cuándo escalar
Escale a Soporte de Zoho y, si es posible, a su equipo de soporte de FTA cuando (a) el portal informe de un servicio saludable pero Books aún no pueda conectarse después de las verificaciones de red y de volver a vincular, o (b) tenga registros detallados (marcas de tiempo, códigos de estado) que muestren fallos repetidos. Proporcione las marcas de tiempo, el ID de la organización y las capturas de pantalla para que el soporte pueda rastrear el intercambio del lado del servidor.
[2]: Hilo de la comunidad de Zoho Books que informa del error exacto durante la configuración de la facturación electrónica.
[3]: Artículo de ayuda de Zoho que muestra el patrón "Reintentar" y las razones de fallo para las integraciones.
[5]: Publicaciones de la comunidad que describen interrupciones más amplias de PEPPOL/FTA y problemas regionales de facturación electrónica.
[7]: Guía de integración de Zoho FSM que muestra causas comunes de fallos de integración y remedios.