dossierfacile-read-profile

name	dossierfacile-read-profile
description	Lit et interprète le profil d'un locataire DossierFacile via GET /api/tenant/profile. Utilise ce skill pour connaître l'état d'avancement d'un dossier, identifier les sections manquantes ou refusées, et déterminer ce qu'il reste à compléter.

Lecture du profil locataire DossierFacile

Environnement : lire dossierfacile-config/environments.md et résoudre ${API_URL} selon l'environnement cible (preprod par défaut).

Appel API

GET ${API_URL}/api/tenant/profile
Authorization: Bearer <access_token>

Paramètres optionnels (non requis pour la consultation de base) :

• source, utm_source, utm_medium, utm_campaign — données d'acquisition marketing, ignorer.

Interprétation de la réponse

La réponse est un objet JSON représentant le profil complet du locataire. Voir profile-schema.md pour le schéma détaillé.

Champs clés à vérifier

Informations personnelles :

Champ	Présent si...
firstName	Le nom a été renseigné (POST /api/register/names)
lastName	idem
zipCode	idem (null si abroad: true)

Type de candidature :

Champ	Valeur attendue
applicationType	"ALONE" — si null, l'étape POST /api/register/application/v2 n'a pas été faite

Documents — vérifier pour chaque catégorie :

documents[].documentCategory  ∈ { IDENTIFICATION, RESIDENCY, PROFESSIONAL, FINANCIAL, TAX }
documents[].documentStatus    ∈ { TO_PROCESS, VALIDATED, DECLINED, INCOMPLETE }
documents[].noDocument        — true si l'usager a déclaré ne pas avoir de document

Un document est considéré valide si documentStatus === "VALIDATED".
Un document est considéré présent si la catégorie apparaît dans documents[] (quel que soit le statut).

Déclaration sur l'honneur :

Champ	Valeur
honorDeclaration	true si la déclaration finale a été soumise

Statut global du dossier :

Valeur	Signification
INCOMPLETE	Des sections sont manquantes
TO_PROCESS	Dossier complet, en attente de vérification
VALIDATED	Dossier validé par un opérateur
DECLINED	Dossier refusé

Algorithme : ce qui manque

Pour un dossier ALONE sans garant, vérifier dans cet ordre :

1. firstName et lastName présents ?              → sinon : POST /api/register/names
2. applicationType === "ALONE" ?                 → sinon : POST /api/register/application/v2
3. Document IDENTIFICATION présent ?             → sinon : POST /api/register/documentIdentification
4. Document RESIDENCY présent ?                  → sinon : POST /api/register/documentResidency
5. Document PROFESSIONAL présent ?               → sinon : POST /api/register/documentProfessional
6. Document FINANCIAL présent ?                  → sinon : POST /api/register/documentFinancial
7. Document TAX présent ?                        → sinon : POST /api/register/documentTax
8. honorDeclaration === true ?                   → sinon : POST /api/register/honorDeclaration

Les étapes 3 à 7 peuvent être réalisées dans n'importe quel ordre.

Cas particulier : document refusé

Si documentStatus === "DECLINED", le document existe mais a été rejeté par un opérateur.
Lire documentDeniedReasons pour connaître le motif, en informer l'usager, et soumettre un nouveau document via le même endpoint POST.

Référence du schéma JSON

Voir profile-schema.md pour la structure complète et des exemples de réponses.