Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Initie la fiche métier carif-oref #1265

Merged
merged 27 commits into from
Dec 27, 2023
Merged
Show file tree
Hide file tree
Changes from 21 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
d1f0bb0
Initie la fiche métier carif-oref
DorineLam Oct 17, 2023
690980b
Changement du titre
Charlottecho Oct 17, 2023
095e447
Update _data/api/api_quiforme.md
Charlottecho Oct 17, 2023
00c1238
TODO
Charlottecho Oct 17, 2023
e5014e2
Ajoute section API Entreprise
DorineLam Oct 17, 2023
47bc876
revert commit
DorineLam Oct 17, 2023
3daf49a
Ajoute référence à API entreprise
DorineLam Oct 17, 2023
fef14b9
Contenu Fiche
Charlottecho Oct 18, 2023
8ae4305
Change le fournisseur de données
DorineLam Oct 18, 2023
d270bc9
Restructuration du tableau des données
DorineLam Oct 18, 2023
28e1ac1
Ajout url Swagger
Charlottecho Oct 20, 2023
494fe64
Ajoute champs manquants fiche API
DorineLam Oct 20, 2023
b8dd509
Complète fiche fournisseur
DorineLam Oct 20, 2023
e17756d
Ajoute les champs "page statistiques d'usage"
DorineLam Oct 24, 2023
d879b0b
Arbre éligibilité - chemin pour les éditeurs de logiciel
DorineLam Oct 24, 2023
6e63de4
Update _data/api/api_quiforme.md
DorineLam Oct 24, 2023
4ca8ab1
Update _data/api/api_quiforme.md
DorineLam Oct 24, 2023
36af945
Update _data/api/api_quiforme.md
DorineLam Oct 24, 2023
1804674
Update _data/api/api_quiforme.md
DorineLam Oct 24, 2023
4391adc
Update api_quiforme.md
Charlottecho Dec 4, 2023
910926d
Update api_quiforme.md
Charlottecho Dec 8, 2023
e8962ae
Apply suggestions from code review
Charlottecho Dec 19, 2023
85993de
Update carif-oref.md
Charlottecho Dec 19, 2023
6583492
FIX build
skelz0r Dec 19, 2023
331d8bd
Try to add to roadmap
skelz0r Dec 19, 2023
854dd9c
feat: add path to API
XavierJp Dec 19, 2023
914222b
API QuiForme has been released in january 2023
skelz0r Dec 22, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
144 changes: 144 additions & 0 deletions _data/api/api_quiforme.md
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@DorineLam : 2 questions stp pour que je puisse terminer cette fiche :
1- Sur le site api.gouv , on référence l'API directement distribuée par Cariforef et non pas celle sur API entreprise : on maintient Base sirene et BAN normalement selon moi ( selon leur doc métier )
2- Les 📍"to-do" que tu as inscrites : je m'en charge ?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1- Oui exactement
2- Oui je veux bien

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@DorineLam , voici les retours et questions que j'aies pour toi avant d' envoyer email au FD pour demandes infos supplémentaires :

  • 📍 Volumétrie maximale de votre API. => Peux tu vérifier stp si cela est dans le swagger ? selon moi , non

  • doc_tech_link: https://api-quiforme.intercariforef.org/docs#/ => OK

  • doc_tech_external: https://TODO # 📍 URL vers la documentation technique de l'API => c’est quoi ?

  • monitoring_link: https://TODO # 📍URL de la page de statut de l'API => Pas dispo de leur côté

  • themes: # 📍 Ajouter un ou plusieurs thèmes, qui permettront aux usagers de trouver votre API en filtrant le catalogue par thématique. Pour ajouter un thème ci-dessous, supprimer simplement le # (sans retirer des blancs.) => Est-ce que l’on peut rajouter des « nouveaux thèmes » ?

    • Administration
  • - Administration & législation

  • - Agriculture

  • - Culture

  • - Droit & Justice

  • - Education

  • - Emploi

  • - Energie

    • Entreprise
  • - Environnement

  • - Géographie

  • - Particulier

  • - Professionnels

  • - Santé

  • - Sécurité

  • - Transport

  • last_update: 10/10/2023 /TODO => Kesako ?

  • Sources de données

    • Le reférentiel UAI/SIRET de l'Onisep (MAJ DORINE : API référencée sur api.gouv est celle de cariforef en direct donc j'inclus la BAN ? )=> j’ai rajouté la base sirene + BAN
    • Base SIRENE
    • Base Adresse nationale
    • Certificats Qualiopi ( DGEFP , Liste OF )
    • Habilitations France compétences ( France Compétences, RNCP, RS )
      -Les modifications demandées par Sabrina ont été MAJ => peux tu vérif stp ?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@DorineLam , voici les retours et questions que j'aies pour toi avant d' envoyer email au FD pour demandes infos supplémentaires :

📍 Volumétrie maximale de votre API. => Peux tu vérifier stp si cela est dans le swagger ? selon moi , non

doc_tech_link: https://api-quiforme.intercariforef.org/docs#/ => OK

doc_tech_external: https://todo/ # 📍 URL vers la documentation technique de l'API => c’est quoi ?

monitoring_link: https://todo/ # 📍URL de la page de statut de l'API => Pas dispo de leur côté

themes: # 📍 Ajouter un ou plusieurs thèmes, qui permettront aux usagers de trouver votre API en filtrant le catalogue par thématique. Pour ajouter un thème ci-dessous, supprimer simplement le # (sans retirer des blancs.) => Est-ce que l’on peut rajouter des « nouveaux thèmes » ?

Administration

  • Administration & législation
  • Agriculture
  • Culture
  • Droit & Justice
  • Education
  • Emploi
  • Energie
    Entreprise
  • Environnement
  • Géographie
  • Particulier
  • Professionnels
  • Santé
  • Sécurité
  • Transport
    last_update: 10/10/2023 /TODO => Kesako ?

Sources de données
Le reférentiel UAI/SIRET de l'Onisep (MAJ DORINE : API référencée sur api.gouv est celle de cariforef en direct donc j'inclus la BAN ? )=> j’ai rajouté la base sirene + BAN
Base SIRENE
Base Adresse nationale
Certificats Qualiopi ( DGEFP , Liste OF )
Habilitations France compétences ( France Compétences, RNCP, RS )
-Les modifications demandées par Sabrina ont été MAJ => peux tu vérif stp ?

Original file line number Diff line number Diff line change
@@ -0,0 +1,144 @@
---
title: API QuiForme
tagline: Vérifiez si un établissement est habilité à former en récupérant ses certifications Qualiopi et habilitations France compétences
producer: Carif-Oref
contact_link: [email protected]/TODO
partners: # Vous pouvez ajouter ici la liste des co-producteurs de l'API si cela vous paraît cohérent.
# - insee
is_open: -1
datapass_link: https://datapass.api.gouv.fr/TODO
is_france_connected: -1
access_page:
- who:
- Un particulier
- Une entreprise
is_eligible: -1
description: |
Vous ne pouvez pas accèder à ces informations qui sont des données protégées.

<Button href="/rechercher-api">Rechercher une autre API</Button>
- who:
DorineLam marked this conversation as resolved.
Show resolved Hide resolved
- Un éditeur de logiciel
is_eligible: 0
description: |
En tant qu'éditeur de logiciel, vous êtes éligible à intégrer cette API si vous le faîtes pour le compte d'une entité publique (administrations, collectivités, etc.) dont vous êtes le prestataire.
Vous pouvez déposer une demande d'habilitation :
<Button href="https://datapass.api.gouv.fr/TODO">Demander un accès</Button>
- who:
- Une administration
is_eligible: 1
description: |
En tant que collectivité territoriale ou administration, vous êtes éligible à utiliser cette API selon votre cadre juridique. Vous pouvez déposer une demande d'habilitation :
<Button href="https://datapass.api.gouv.fr/TODO">Demander un accès</Button>
rate_limiting_resume: TODO appels / minute / IP # 📍 Volumétrie maximale de votre API.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Charlotte c'est ici qu'il te faut mettre la volumétrie maximale de l'API, autrement appelée "rate limiting"

Tu peux aussi compléter le "rate_limiting_description" (le champ suivant pour décrire par une phrase la volumétrie) ça apparaîtra comme ça dans la fiche métier :
image

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dorine : je vais demander au FD . On peut merger et MAJ l'info après ?

rate_limiting_description: |
L'API est disponible à hauteur de TODO appels par minute.
# Phrase descriptive de la volumétrie
doc_tech_link: https://api-quiforme.intercariforef.org/docs#/
doc_tech_external: https://TODO # 📍 URL vers la documentation technique de l'API -
Charlottecho marked this conversation as resolved.
Show resolved Hide resolved
monitoring_link: https://TODO # 📍URL de la page de statut de l'API
Charlottecho marked this conversation as resolved.
Show resolved Hide resolved
stats_detail_resume: Les statistiques sont disponibles en temps réel # Résumer en un titre à quoi peut s'attendre l'usager en termes de statistiques de consommation de l'API. Cette phrase suit le titre "Stats:" qui permet de déplier un volet avec les détails ci-dessous (description et lien) :
DorineLam marked this conversation as resolved.
Show resolved Hide resolved
stats_detail_description: |
Accédez au suivi des consommations de l'API
stats_detail_link: http://page-stats-dusage-de-lapi # URL de la page des statistiques d'usage de l'API
themes: # 📍 Ajouter un ou plusieurs thèmes, qui permettront aux usagers de trouver votre API en filtrant le catalogue par thématique. Pour ajouter un thème ci-dessous, supprimer simplement le # (sans retirer des blancs.)
- Administration
# - Administration & législation
# - Agriculture
# - Culture
# - Droit & Justice
# - Education
# - Emploi
# - Energie
- Entreprise
# - Environnement
# - Géographie
# - Particulier
# - Professionnels
# - Santé
# - Sécurité
# - Transport
keywords:
- Qualiopi
- France compétences
- Habilitations
- Certifications
- Organismes de formation
last_update: 10/10/2023 /TODO
---

Cette API, délivrée directement par le réseau des Carif-Oref, permet de vérifier si un établissement est habilité à délivrer un formation certifiante Qualiopi et/ou France compétences.
**La valeur ajoutée** de cette API opérée par le réseau des Carif-Oref est :

- De connaître les certificats Qualiopi des établissements et pas uniquement des unités légales ;
- De véritablement dire si un établissement est habilité à former ou à organiser des épreuves car elle indique également les habilitations France Compétences de l’établissement ;
- D’avoir une donnée plus fiable car le réseau des Carif-Oref effectue une double vérification en croisant ses bases et les bases du Ministère de l’Intérieur.
- En cas de détection d’anomalie, les Carif-Oref peuvent, grâce à leurs réseaux locaux, prendre contact avec l’établissement concerné et vérifier la situation.

Votre service a besoin d'autres API concernant les données des entreprises ou des associations ? Utilisez le bouquet [API entreprise](https://entreprise.api.gouv.fr/), distribué par la DINUM .

## Sources de données

- Le reférentiel UAI/SIRET de l'Onisep (MAJ DORINE : API référencée sur api.gouv est celle de cariforef en direct donc j'inclus la BAN ? )
Charlottecho marked this conversation as resolved.
Show resolved Hide resolved
- Base SIRENE
- Base Adresse nationale
- Certificats Qualiopi ( DGEFP , Liste OF )
- Habilitations France compétences ( France Compétences, RNCP, RS )

## Périmètre

### Entreprises ou associations concernées :

Cette API concerne ✅ tous les établissements quelque soit leur statut, publics, à but lucratif, associatifs, etc...
Une large majorité d’établissements sont concernés :
- ✅ établissements publics ;
- ✅ établissements privés ;
- ✅ associations ;

Les établissements suivants ne sont pas couverts par l’API /TODO
- ❌ établissements privés hors contrat ;
- ❌ lycées agricoles ;
- ❌ instruction dans la famille.

### Périmètre géographique :
- ✅ France métropolitaine
- ✅ DROM-COM

### Actualisation de la donnée
Les données sont mises à jour en majorité toutes les 24h mais ce délai peut parfois passer à 72h ou plus pour des cas spécifiques.

## Modalités d'appel
Cette API est appelé avec le SIRET de l'établissement recherché.

## Données

Cette API indique si un établissement est habilité à former.
Elle délivre les informations suivantes au format JSON :

| Nom | Exemple |Description |
| ----------- | -------------------- | ------------------- |
| **Siret de l'établissement** | `12000101100010` | Siret de l'établissement appelé. |
| **Code UAI de l'établissement** | `0123456A` | Code d'unité administrative immatriculée (code UAI) de l'établissement habilité ou agrée. <br/>Ce code unique, inscrit au répertoire national des établissements, est composé de 7 chiffres et d'une lettre ; les trois premiers chiffres correspondent au numéro de département de l'établissement. <br/><br/>Pour retrouver facilement le code UAI d'un établissement à partir d' informations plus facilement connues des usagers (commune, code postal, etc.), vous pouvez utiliser l'[API Annuaire de l'éducation nationale](../les-api/api-annuaire-education).<br/><br/>NB : L'établissement 0861288H (CNED Direction générale) n'existe pas dans l'API annuaire de l'éducation nationale, il faudra donc compléter la liste des établissements avec une ligne CNED à laquelle sera associée le code UAI qui sera en passé en entrée. |
| **Unités légales avec plusieurs NDA** | `true` ou `false` | Dans de rares cas, l'unité légale d'un établissement peut avoir plusieurs numéros de déclaration d'activité (NDA). Tous ces numéros d'activités (qui ne sont pas fournis par cette API délivrant uniquement les NDA d'un établissement) ne sont pas forcément propagés sur les établissements.|
| **Déclarations d'activité de l'etablissement** || Tableau des déclarations d'activité de l'établissement : (dans de rares cas, un établissement peut avoir plusieurs NDA environ 30 établissements sur 120 000)|
| Numéro de déclaration d'activité | `11910843391` | |
| Indique que le NDA est actif | `true` ou `false`| Ce champ indique le numéro de déclaration d'activité (NDA) de l'établissement est actif. Pour conserver un NDA valide, l'établissement doit remplir chaque année un bilan pédagogique et financier prévu à l'article L6352-11 du Code du travail. Sans cette démarche le numéro NDA devient inactif, l'établissement est retiré de la liste publique des organismes de formation. |
| Date de dernière déclaration | `2021-01-30` | Cette date indique le jour où l'établissement a transmi son bilan pédagogique et financier (BPF), indispensable pour maintenir actif le numéro de déclaration d'activité (NDA). Cette date est transmise au format AAAA-MM-DD. |
| Date de début d'exercice fiscal | `2021-01-30` | Cette date correspond à la fin du dernier exercice fiscal analysé pour le bilan pédagogique et financier. Cette date est transmise au format AAAA-MM-DD.|
| Certification qualiopi | `"action_formation": true` <br> `"bilan_competences": true` <br/>`"validation_acquis _experience": true` <br/> `"apprentissage": true` <br/>`"obtention_via _unite_legale": true` | **Certication Action Formation** : Indique si l'établissement est certifié Action Formation <br/> **Certification Bilan Compétences** : Indique si l'établissement est certifié Bilan Compétences <br/> **Certification Bilan Compétences** : indique si l'établissement est certifié Bilan Compétences <br/> **Certification VAE** : indique si l'établissement est certifié VAE (Validation des Acquis de l'Experience) <br/> **Certification Apprentissage** : indique si l'établissement est certifié Action de Formation par Apprentissage <br/> **Obtention via unité légale** : indique si le certificat Qualiopi est propagé depuis le SIREN de l'unité légale ex: true |
| Specialités | `"specialite_1": {` <br/> `"code": "313",` <br/> `"libelle": "Finances, banque, assurances"` <br/>`},` | Informations relatives aux spécialités relevant du numéro de déclaration d'activité et figurant dans le bilan pédagogique et financier. Un établissement peut ne pas avoir de spécialités, et l'API en transmet jusqu'à trois, leur ordre n'a pas d'importance. |
| **Habilitations France compétences** | |Tableau des habilitations France Compétences obtenues par l'établissement. La liste des habilitations France Compétences n'est pas figée et est mise à jour régulièrement par les organismes certificateurs. |
| Code de l'habilitation | `RNCP10013` | Code de l'habilitation France Compétences|
| Indique si l'habilitation est active | `true` ou `false`| |
| Date à laquelle l'habilitation est passée en état active | `2030-01-30` ||
| Date de fin d'enregistrement | `2030-01-30` ||
| Date de fin d'enregistrement de l'habilitation de l'établissement agrée | `2030-01-30` | Cette date est transmise au format AAAA-MM-DD |
| Date de décision | `2020-01-30` | Date de décision de l'habilitation de l'établissement agrée : Cette date est transmise au format AAAA-MM-DD |
| Habilitation à former | `true` ou `false` | Indique que cette habilitation autorise à former/préparer les candidats à une certification inscrite au répertoire national des compétences professionnelles (RNCP) ou au répertoire spécifique (RS). Cette habilitation vise à s'assurer que les organismes de formation proposant des offres de formation certifiantes, sont bien habilités à préparer des élèves à cette certification |
| Habilitation à organiser l'évaluation | `true` ou `false`| Indique que cette habilitation autorise à mettre en place des épreuves pour évaluer les compétences des candidats visant une certification inscrite au répertoire national des compétences professionnelles (RNCP) ou au répertoire spécifique (RS) |
|Siret des organismes certificateurs | `12345678901234` |Liste des SIRETs des organismes certificateurs ayant délivré à l'établissement les habilitations à former et/ou organiser l'évaluation de leur certification.|


## Vous avez besoin d'autres données sur les entreprises ou les associations ?

**Demander un accès au bouquet <External href='/les-api/api-entreprise'>API Entreprise</External>** opéré par la DINUM. Ce dernier vous permet d'obtenir de nombreuses données entreprises et associations avec une seule habilitation.
14 changes: 14 additions & 0 deletions _data/producteurs/carif-oref.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
name: Le réseau des Centres d’animation, de ressources et d’information sur la formation (Carif) et des Observatoires régionaux de l’emploi et de la formation (Oref)
acronym: Le réseau des Carif-Oref
logo: carif-oref.png
type: Association avec mission de service public
site: https://www.intercariforef.org/
short: Les Centres d’animation, de ressources et d’information sur la formation (Carif) et des Observatoires régionaux de l’emploi et de la formation (Oref) sont portés par l’État et les Régions et impliquent les partenaires sociaux. Ils sont principalement financés par l’État et les Conseils régionaux dans le cadre des Contrats de Plan. # Description courte répondant à la question "Qu'est ce que le «fournisseur de données» ?"
description: |
Pour en savoir plus sur les missions du réseau des Carif-Oref, consultez <External href="https://www.intercariforef.org/lassociation-intercariforef">le site</External>.
# Description longue répondant à la question "Quelle est sa mission de service public ?"
contact: https://contact.service.gouv.fr/ TODO # URL de la page de contact du fournisseur.
annuaire: https://lannuaire.service-public.fr/navigation/carif_oref #URL vers l'annuaire du service public
siteOpenData: https://www.data.gouv.fr/fr/organizations/reseau-des-carif-oref/ # URL du site dédié à l'OpenData du fournisseur de données, peut renvoyer vers le site data.gouv
---
Binary file added public/images/api-logo/carif-oref.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading