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

MAJ FAQ API QF #1788

Open
wants to merge 13 commits into
base: develop
Choose a base branch
from
Open
Changes from all commits
Commits
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
39 changes: 30 additions & 9 deletions config/endpoints/api_particulier/cnaf_msa_quotient_familial_v2.yml
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@
description: |+
**Cette API délivre** :
- **la composition familiale** du particulier, [en savoir plus](#faq_entry_answer_2_api_particulier_endpoint_cnav_quotient_familial_v2) ;
- **le quotient familial CAF ou MSA** du particulier. Par défaut, le quotient familial du **mois en cours** est transmis. Le QF de l'allocataire est disponible pour les 24 mois précédents en précisant le mois et l'année dans l'appel ;
- **le quotient familial CAF ou MSA** du particulier. Par défaut, le quotient familial du **mois précédent, M-1** est transmis. Le QF de l'allocataire est disponible pour les 24 mois précédents en précisant le mois et l'année dans l'appel ;
- **l'adresse** du particulier au format de La Poste. ⚠️ Cette adresse est déclarative. Si l'usager a changé d'adresse et n'a pas actualisé son adresse auprès de la CAF ou de la MSA, l'information sera donc obsolète.

{:.fr-highlight}
Expand Down Expand Up @@ -125,10 +125,13 @@
- q: Variations du quotient familial au cours du temps et dates de calcul
a: |+
**Le quotient familial CAF ou MSA d'un même mois peut changer**. Il est recalculé fréquemment au cours du temps par la CAF et la MSA. En effet, la situation de la personne peut évoluer : _perte d'un emploi, évolution des ressources, arrivée d'un enfant, majorité d'un enfant, modification de la législation, évolution des allocations logement etc._
**Cette variation apparaît notamment entre le quotient familial du mois en cours appelé en début de mois ou en fin de mois**.
**Cette variation apparaît notamment entre le quotient familial du mois appelé en début de mois ou en fin de mois**. **Le mois remonté par l'API est, par défaut, le mois M-1.**
Miryad3108 marked this conversation as resolved.
Show resolved Hide resolved

**Deplus, la date du calcul du quotient familial diffère** selon qu'il s'agit du quotient de la CAF ou de la MSA.
- La CAF effectue une sauvegarde des quotients recalculés uniquement lorqu'un changement subvient du côté de l'allocataire.
**De plus, la date du calcul du quotient familial diffère** selon qu'il s'agit du quotient de la CAF ou de la MSA. La fréquence et la date de mise à jour sont également différentes :
- La MSA met à jour les données en temps réel, à chaque changement ;
- La CAF effectue une sauvegarde des quotients recalculés uniquement lorsqu'un changement subvient du côté de l'allocataire. De plus, elle met à jour les données pour le mois M-1 le premier week-end du mois. Par exemple, pour le quotient familial du mois de janvier 2025, les données seront mises à jour le week-end du 8 février 2025.

- La MSA met à jour les données en temps réel, à chaque changement.
Miryad3108 marked this conversation as resolved.
Show resolved Hide resolved

{:.fr-highlight.fr-highlight--example}
> Par exemple, un appel le 28 juin 2023, du quotient du mois en cours (juin 2023) : La CAF renverra le QF qu'elle a en mémoire, par exemple calculé le 19 juin 2023.
Expand All @@ -153,12 +156,30 @@
> C'est le cas d'un enfant ayant quitté le foyer de ses parents et ayant ouvert son propre dossier d'allocataire pour bénéficier d'une aide (par exemple les APL ou le RSA), mais qui souhaite tout de même être rattaché à la déclaration fiscale de ses parents.
> _Cet enfant appartiendra au même foyer fiscal que ses parents au sens de l'administration fiscale, mais à une famille différente selon la CAF ou la MSA._

- q: Dans quels cas les deux parents sont-ils associés à un même compte ?
a: |+
Les deux parents sont associés à un même compte, **lorsqu'ils sont mariés, pacsés ou concubins ET à partir de la déclaration de ce changement par l'allocataire**, sur le site caf.fr ou sur l’application « Caf -Mon Compte ». Cette déclaration induit de loger au même domicile, exception faite du cas d'un conjoint vivant à l'étranger dont la vie maritale est tout de même enregistrée auprès de la CAF ou la MSA.

- q: Les enfants majeurs sont-ils renvoyés par l’API lorsque l'appel est effectué avec l'identité du parent ?
a: |+
Oui, si l'enfant est toujours à la charge des parents. Cette charge est modulée en fonction de la rémunération de l'enfant, le cas échéant. 
Copy link
Contributor

Choose a reason for hiding this comment

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

C'est-à-dire "modulée en fonction de la rémunération de l'enfant ?" ?
Est-ce qu'on aurait pas une doc qui précise les conditions et qu'on pourrait mentionner, je suppose qu'il y a un âge limité sauf enfant handicapés.

La composante âge de l'enfant doit être prise en compte puisqu'elle détermine le terme de certaines prestations.
Il est à noter que cette limite est variable et exclut le mois de l'atteinte de l'âge limite (d'où la précision "xx ans et 11 mois"): La limite d'âge est de 16 à 19 ans et 11 mois pour l'ensemble des prestations sauf exceptions ci dessous:
- jusqu'à 20 ans et 11 mois pour le forfait Allocation Familiale (AF, le Complément familiale (Cf) dans l'hexagone et les aides au logement ;
- jusqu'à 21 ans et 11 mois pour l'Allocation de logement familiale (ALF) dans les Départements et régions d'Outre-Mer.

- q: Dans le cas d’une famille recomposée, les enfants des deux parents sont-ils remontés sur un même compte ? 
Copy link
Contributor

Choose a reason for hiding this comment

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

ici préciser de quel appel on parle ? Appel sur le compte du parent ? du beau-parent ?

a: |+
L'enfant sera uniquement rattaché au parent qui en a la charge. Dans le cas d'une situation de résidence alternée qui induit un partage de la charge, l'enfant apparaitra sur les deux comptes uniquement si la "résidence alternée avec partage des allocations" est déclarée à la caisse d'allocation. 

- q: Les enfants décédés sont-ils remontés par l’API ? ?
a: |+
Les enfants décédés ne sont plus considérés à charge le mois suivant le décès et ne sont donc plus remontés par l'API.

- q: Les parents associés à un même compte peuvent-ils être rattachés à la MSA et à la CAF en même temps ?
a: |+
Les parents qui sont associés à un même compte, sont gérés par une seule caisse, la CAF ou la MSA. Selon la situation de l'allocataire, un organisme sera priorisé par rapport à l'autre. 

**Pour chacune des personnes de cette « famille » au sens de la CAF ou de la MSA**, cette API renvoie les informations suivantes :
- Nom d'usage ;
- Prénoms ;
- Jour, mois et année de naissance ;
- Sexe.
- q: <a name="renseigner-lieu-de-naissance"></a> Appel avec l'identité pivot, comment renseigner le lieu de naissance ?
a: |+
Lorsque l'API est appelée avec l'identité pivot, pour identifier correctement le particulier, le système d'information a besoin de récupérer le lieu de naissance du particulier.
Expand Down