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 Futuh Central 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/_health 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 Futuh Central, dentro del grupo Configuración, localiza el campo Token de autenticación.
  2. Pega el token. El campo se muestra enmascarado (tipo contraseña) mientras escribes.
  3. 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 y la ruta de origen en el Hub.
  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 aparece en pausa o con fallos, mira la última entrada del Histórico de syncs (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 canon diario (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 hubs (se ejecuta cada 4 horas), 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 localmente.
  4. Si más tarde quieres que el Hub vuelva a actualizar ese registro, la pestaña Sincronización canon trae el botón Restablecer canon (visible para administradores de federación cuando el registro está marcado como editado; requiere el cliente de federación 19.0.1.5.0 y el módulo de dominio actualizado — en incidencia, coop_advocacy 0.4.3). Al confirmar, la próxima sincronización sobrescribe el registro con el canon del Hub. En las fichas de parlamentarios el botón llega en una actualización próxima; para esos registros, de momento, contacta con el equipo Futuh.

Solución de problemas frecuentes

Section titled “Solución de problemas frecuentes”
  • 403 Forbidden en el Histórico de syncs → token caducado o revocado. Sustituye el token y fuerza una sincronización con Sincronizar ahora en una suscripción para comprobar que funciona.
  • 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”