Contrats · calcul.autonomie.v1
APA à domicile
Démonstrateur APA à domicile : plafond, participation et reste à charge d'un mois, chaque ligne sourcée ; informations manquantes et contrôles.
Schéma JSON (draft 2020-12) : https://mcp.reperes.bmse.fr/api/v1/schemas/calcul.autonomie.v1.json. Les champs sont listés à plat : lignes[].source désigne la source de chaque ligne.
| Champ | Type | Description |
|---|---|---|
controlesrequis | liste de objet | Contrôles des conditions d'accès (âge, GIR, domicile), avec leur statut. |
idrequis | texte | Identifiant du contrôle (age, gir, domicile…). |
libellerequis | texte | Condition contrôlée. |
statutrequis | texte | ok, non, inconnu ou a_verifier. |
detail | texte | null | Précision ou orientation (interlocuteur, vérification à faire) ; absente sinon. |
daterequis | texte | Date de calcul (AAAA-MM-JJ) : barèmes et valeurs en vigueur à cette date. |
financementrequis | objet | Montants clés du mois, en euros ; null quand ils ne peuvent pas être établis (motif dans indisponibles). |
apa_estimee | texte | null | APA estimée du mois, versée par le département, en euros. |
base_utilisee | texte | null | Base prise en charge par l'APA : heures couvertes par le plan × tarif de prise en charge, en euros. |
cout_net_fiscal_potentiel | texte | null | Reste à payer moins le crédit d'impôt potentiel, en euros. |
credit_impot_potentiel | texte | null | Crédit d'impôt potentiel pour l'emploi à domicile sur le reste à payer, dans la limite du plafond disponible, en euros ; perçu l'année suivante. |
depassement | texte | null | Part du prix du service au-delà du tarif de prise en charge, sur les heures couvertes, en euros. |
facture_brute | texte | null | Facture brute du service pour le mois (heures réalisées × prix horaire), en euros. |
hors_plan | texte | null | Coût des heures réalisées hors du plan d'aide, au prix du service, en euros. |
participation | texte | null | Participation du bénéficiaire sur la base prise en charge, en euros. |
plan_accepte | texte | null | Montant mensuel du plan d'aide accepté (aide humaine au tarif de prise en charge et autres postes), en euros. |
reste_avant_fiscalite | texte | null | Reste à payer du mois : facture brute moins APA, en euros. |
taux_participation | texte | null | Taux de participation du bénéficiaire, en % (notifié, ou calculé selon CASF R. 232-11). |
heuresrequis | objet | Rapprochement des heures prévues, réalisées et hors plan du mois. |
besoin_estime | texte | null | Besoin d'heures estimé pour le mois, s'il est renseigné. |
hors_plan | texte | null | Heures réalisées hors du plan, y compris celles au-delà de la ligne du plan. |
non_realisees | texte | null | Heures prévues non réalisées dans le mois. |
prevues | texte | null | Heures d'aide humaine prévues par le plan pour le mois. |
realisees_dans_plan | texte | null | Heures réalisées couvertes par le plan (au plus les heures prévues). |
indisponiblesrequis | liste de objet | Montants non établis et leur motif. |
idrequis | texte | Montant concerné (clé de financement : apa_estimee, participation…). |
motifrequis | texte | Raison (information manquante, condition non remplie). |
informations_manquantesrequis | liste de objet | Informations à demander, la plus utile d'abord, avec les montants qu'elles permettent de calculer. |
debloquerequis | liste de texte | Montants que la réponse permet de calculer. |
idrequis | texte | Identifiant de l'information (champ du scénario à renseigner). |
questionrequis | texte | Question à poser pour l'obtenir. |
moisrequis | liste de objet | Décomposition du mois. |
idrequis | texte | Identifiant stable de la ligne (élément du modèle, cotisation, montant), pour la retrouver d'un calcul à l'autre. |
libellerequis | texte | Libellé de la ligne, à afficher tel quel. |
montantrequis | texte | Montant mensuel (euros, deux décimales ; négatif pour une déduction). |
base | texte | null | Assiette ou base (montant), si la ligne est un taux ou un nombre de points. |
hypothese | texte | null | Hypothèse dont dépend la ligne (réponse par défaut, montant saisi, règle appliquée), à restituer avec le montant ; absente sinon. |
regime | texte | null | Attribution d'un élément conventionnel : de_droit, possible (soumis à une condition ou à la décision de l'employeur) ou accord (ouvert par un accord collectif d'entreprise ou une décision de l'employeur, jamais supposé par le simulateur) ; absent pour une cotisation. |
source | objet | null | Source de la ligne : texte conventionnel cité, ou paramètre d'Étalon lu (parametre) ; absente pour un montant saisi ou un total. |
parametre | texte | null | Paramètre d'Étalon lu. |
reference | texte | null | Article ou référence précise dans le texte. |
titre | texte | null | Titre du texte cité (convention collective, avenant, décret, code…). |
url | texte | null | Lien vers le texte quand il est accessible en ligne ; absent sinon. |
taux | texte | null | Taux (%), nombre de points ou quantité, selon unite. |
unite | texte | null | Unité de taux : %, points, coefficient ou unité d'une quantité (heure, nuit, jour…) ; absente pour un montant direct. |
participationrequis | liste de objet | Calcul du taux de participation (notifié ou R. 232-11). |
idrequis | texte | Identifiant stable de la ligne (élément du modèle, cotisation, montant), pour la retrouver d'un calcul à l'autre. |
libellerequis | texte | Libellé de la ligne, à afficher tel quel. |
montantrequis | texte | Montant mensuel (euros, deux décimales ; négatif pour une déduction). |
base | texte | null | Assiette ou base (montant), si la ligne est un taux ou un nombre de points. |
hypothese | texte | null | Hypothèse dont dépend la ligne (réponse par défaut, montant saisi, règle appliquée), à restituer avec le montant ; absente sinon. |
regime | texte | null | Attribution d'un élément conventionnel : de_droit, possible (soumis à une condition ou à la décision de l'employeur) ou accord (ouvert par un accord collectif d'entreprise ou une décision de l'employeur, jamais supposé par le simulateur) ; absent pour une cotisation. |
source | objet | null | Source de la ligne : texte conventionnel cité, ou paramètre d'Étalon lu (parametre) ; absente pour un montant saisi ou un total. |
parametre | texte | null | Paramètre d'Étalon lu. |
reference | texte | null | Article ou référence précise dans le texte. |
titre | texte | null | Titre du texte cité (convention collective, avenant, décret, code…). |
url | texte | null | Lien vers le texte quand il est accessible en ligne ; absent sinon. |
taux | texte | null | Taux (%), nombre de points ou quantité, selon unite. |
unite | texte | null | Unité de taux : %, points, coefficient ou unité d'une quantité (heure, nuit, jour…) ; absente pour un montant direct. |
plafondrequis | liste de objet | Plafond du GIR et repères, à part du plan personnel. |
idrequis | texte | Identifiant stable de la ligne (élément du modèle, cotisation, montant), pour la retrouver d'un calcul à l'autre. |
libellerequis | texte | Libellé de la ligne, à afficher tel quel. |
montantrequis | texte | Montant mensuel (euros, deux décimales ; négatif pour une déduction). |
base | texte | null | Assiette ou base (montant), si la ligne est un taux ou un nombre de points. |
hypothese | texte | null | Hypothèse dont dépend la ligne (réponse par défaut, montant saisi, règle appliquée), à restituer avec le montant ; absente sinon. |
regime | texte | null | Attribution d'un élément conventionnel : de_droit, possible (soumis à une condition ou à la décision de l'employeur) ou accord (ouvert par un accord collectif d'entreprise ou une décision de l'employeur, jamais supposé par le simulateur) ; absent pour une cotisation. |
source | objet | null | Source de la ligne : texte conventionnel cité, ou paramètre d'Étalon lu (parametre) ; absente pour un montant saisi ou un total. |
parametre | texte | null | Paramètre d'Étalon lu. |
reference | texte | null | Article ou référence précise dans le texte. |
titre | texte | null | Titre du texte cité (convention collective, avenant, décret, code…). |
url | texte | null | Lien vers le texte quand il est accessible en ligne ; absent sinon. |
taux | texte | null | Taux (%), nombre de points ou quantité, selon unite. |
unite | texte | null | Unité de taux : %, points, coefficient ou unité d'une quantité (heure, nuit, jour…) ; absente pour un montant direct. |
schema_versionrequis | texte | Version du contrat : calcul.autonomie.v1. |
signalementsrequis | liste de texte | Avertissements à restituer (simulation non opposable, plan non notifié, report d'heures, contrôles de cohérence). |
statutrequis | texte | ok, partiel (montants non établis faute d'information) ou erreur (voir message).
|
valeursrequis | liste de objet | Valeurs d'Étalon lues par le calcul, chacune une fois, avec leur date d'effet et leur source. |
daterequis | texte | Date pour laquelle la valeur a été lue (AAAA-MM-JJ). |
parametrerequis | texte | Identifiant du paramètre d'Étalon (ex. smic.mensuel), lisible par GET /api/v1/valeurs/{id}. |
valeurrequis | texte | Valeur lue, décimal exact en texte, dans l'unité du paramètre. |
valide_durequis | texte | Date d'effet de la valeur lue (AAAA-MM-JJ). |
coordonnees | objet | Coordonnées de la valeur lue quand le paramètre en a (GIR, part, tranche…) ; absent sinon. |
source | objet | null | Source primaire de la valeur ; absente si la valeur n'en porte pas. |
titrerequis | texte | Titre du texte ou de la publication qui fixe la valeur. |
reference | texte | null | Article ou référence précise dans le texte ; absente sinon. |
url | texte | null | Lien vers le texte quand il est accessible en ligne ; absent sinon. |
message | texte | null | Explication de l'erreur (scénario invalide) ; absent sinon. |
periode | texte | null | Mois du plan considéré (AAAA-MM) ; absent s'il n'est pas précisé. |