Skip to content

Ajouter une nouvelle collectivité

Caillou edited this page Oct 3, 2024 · 19 revisions

Ajouter une nouvelle collectivité

Il y a deux moyens d'entrer dans le process :

  • Une collectivité sans éditeur répond au sondage sur hubee, et nous lui envoyons le lien datapass à la main, et on lui demande de préciser qu'elle veut accéder aux données via FQF.
  • Une collectivité avec éditeur passe par le datapass API particulier prérempli de son éditeur.

Recevoir une demande dapatass

Quand une collectivité nous envoie une demande datapass pour accéder au QF :

  • Si elle nous précise vouloir utiliser Formulaire QF ou quotient-familial.numerique.gouv.fr
  • Si elle nous précise vouloir recevoir le QF sur Hubee.
  • Si elle nous précise travailler avec un éditeur qu'on sait utiliser Formulaire QF
    • 3DOuest ✔️ (intégration terminée)
    • Agedi ❌ (pas terminé)

Vérifier/Créer l'éditeur dans HubEE

Si l'éditeur n'utilise pas encore HubEE, il faut qu'il fasse tout le process de qualification HubEE. Une fois que c'est fait, il doit être ajouté à la liste des éditeurs par l'équipe HubEE.

Désactiver le jeton api particulier pour les collectivités sans éditeurs

Si la collectivité ne compte jamais faire de requête à API particulier elle-même mais toujours passer par FQF, alors il faut révoquer le jeton qui lui a été créé lors de l'acceptation de la demande Datapass. Demander à l'équipe technique de Datapass

C'est globalement le cas de toutes les communes sans éditeur ni développeurs.

Faire tourner le script de JB

Il "active" la commune :

  • Crée la commune dans Hubee à partir des données INSEE
    • l'email de contact utilisé est celui du demandeur du datapass
  • Crée l'abonnement à FQF dans HubEE, et active l'abonnement en le relie à l'éditeur
  • Crée la commune dans la liste du site FQF

Toute la suite est désormais inutile car automatisée.


Trouver le Code COG de la collectivité

En cas de communauté de communes, il n'y a pas de code COG. Mettre 0000.

Créer la commune dans Hubee

Demander à l'équipe Hubee si la collectivité existe déjà dans leur système, et la créer si non. Possiblité de faire la création via API sinon : https://github.com/etalab/admin_api_entreprise/pull/1579

Données nécessaires :

  • Nom de la collectivité
  • Siret de la collectivité
  • Code COG de la collectivité
  • Email de Contact

On utilise cette spreadsheet pour communiquer ces données à Hubee.

Créer un abonnement dans Hubee

Ajouter un abonnement à FormulaireQF pour la collectivité concernée. Il est possible que l'abonnement existe déjà, créé par la team Hubee. Dans ce cas il faut juste l'activer.

Activer l'abonnement

Si la collectivité travaille avec un éditeur, ou a ses propres devs, créer l'abonnement

  • Choisir la modalité d'accès API
  • Renseigner l'Editeur.
  • Enregistrer l'abonnement
  • Activer l'abonnement (avec la date d'aujourd'hui)

Créer la commune dans la base de données

Récupérer le département pour le mettre en parenthèses dans le nom de la commune

Sur le serveur de production, run :

collectivity = {
  name: "Hauteluce (73)",
  siret: "21730132400018",
  code_cog: "73132",
  status: :active,
}

Collectivity.create(**collectivity)