Saltearse al contenido

Conectar tu instancia al Hub Central

Configurar el endpoint del Hub Central

Section titled “Configurar el endpoint del Hub Central”

El cliente trae preconfigurado un registro que apunta al Hub Central operado por Asamblea de Cooperación Por la Paz. En la mayoría de los casos no hace falta tocarlo: lo verificas y sigues.

  1. Abre Federación Futuh → Configuración Federación → Hubs configurados.
  2. Verifica que existe un registro con nombre Hub Central Futuh y URL https://hub.futuh.coop.
  3. Comprueba que el campo Activo está marcado.
  4. Si vas a federarte contra un Hub alternativo (caso raro: pilotos, pruebas), edita la URL. Debe responder al endpoint /api/v1/canon/healthcheck con código 200.

Introducir el token de autenticación

Section titled “Introducir el token de autenticación”

El Hub comprueba que tu instancia tiene cuota Futuh activa mediante un token Bearer en cada petición. El token llega por correo al renovar la cuota.

  1. En el registro Hub Central Futuh, abre la pestaña Autenticación.
  2. Pega el token en el campo Token de federación. El campo es de tipo contraseña y se cifra en base de datos.
  3. Pulsa Probar conexión. Debe aparecer el mensaje Conexión correcta · Hub responde con canon_version X.Y.Z.
  4. Guarda.

Revisar las suscripciones canon activas

Section titled “Revisar las suscripciones canon activas”

Tu instancia se suscribe automáticamente a los tipos canon que necesitan los módulos instalados. Si tienes Radar llegan bases reguladoras BDNS y adjudicaciones; si tienes Incidencia Política llegan parlamentarios y comisiones.

  1. Abre Federación Futuh → Configuración Federación → Subscriptions activas.
  2. Revisa la lista. Cada suscripción declara el modelo destino, la URL de origen y la frecuencia de sincronización.
  3. Verifica que los modelos consumidos por tus módulos aparecen como Activos (cuatro o más en una instalación típica).
  4. Si una suscripción figura como Pausada, mira la última entrada del registro de sincronización (suele ser token caducado o cambio mayor de versión canon).

Configurar la frecuencia del cron de pull

Section titled “Configurar la frecuencia del cron de pull”

La sincronización canon se ejecuta vía una acción planificada diaria. En la mayoría de instancias esto basta, pero el intervalo es ajustable.

  1. Abre Ajustes → Técnico → Acciones planificadas.
  2. Localiza Futuh Federation: Pull diario canon hubs (nombre interno _cron_federation_pull_all).
  3. Verifica intervalo Cada día y estado Activo.
  4. Si necesitas actualizaciones más frecuentes (campaña con plazos diarios), cambia el intervalo a Cada hora. La carga sobre el Hub es modesta.
  5. La segunda acción, Futuh Federation: Healthcheck cada 4h, avisa al administrador tras tres fallos consecutivos. Déjala como viene.

Marcar manualidades sobre datos canon

Section titled “Marcar manualidades sobre datos canon”

Cuando tu organización edita a mano un registro que vino del Hub (por ejemplo, corriges el correo de un parlamentario que el Hub aún no tiene), Futuh marca el registro como editado manualmente y deja de sobrescribirlo en sincronizaciones posteriores.

  1. Abre cualquier registro federado (por ejemplo, un parlamentario en Contactos → Parlamentarios).
  2. Edita el campo y guarda.
  3. Verifica que en la pestaña Sincronización canon aparece el badge Editado manualmente.
  4. Si más tarde quieres aceptar lo que diga el Hub, pulsa Restablecer canon: el siguiente cron sobrescribirá tus cambios.

Solución de problemas frecuentes

Section titled “Solución de problemas frecuentes”
  • 403 Forbidden en el registro de sincronización → token caducado o revocado. Sustituye el token y pulsa Probar conexión.
  • 404 Not Found en un modelo concreto → la suscripción apunta a un canon que el Hub ya no publica (sucedió un cambio mayor de versión). Revisa el aviso en la pestaña Mensajes del registro: lleva enlace a la nota de upgrade del módulo origen.
  • Cron en estado fallido tras una instalación reciente → tras instalar un módulo que añade crons, hay que reiniciar el contenedor Odoo para que el registro recargue. Si no puedes reiniciar, lanza el cron a mano una vez desde Acciones planificadas.

Próximos pasos

Section titled “Próximos pasos”