🤓Introduction technique

Vous trouverez ci-dessous une introduction aux différents concepts et entités métiers DossierFacile.

Qu'est-ce qu'un dossier chez DossierFacile ?

DossierFacile est un service public numérique permettant à des usagers en recherche de location immobilière d'être accompagné à la constitution d'un dossier de location numérique, unique et vérifié sur une plateforme sécurisée de l'Etat. Une fois leur dossier constitué et vérifié par nos opérateurs, l'usager peut partager son dossier à des potentiels bailleurs ou propriétaires.

Il y a plusieurs manières de partager un dossier de location :

  • Par partage d'un lien simple, au format https://locataire.dossierfacile.logement.gouv.fr/file/{uuid}

  • Par mail en précisant une adresse mail. Le destinataire reçoit alors un mail contenant un lien vers le dossier de location (suivant le même format que précédemment).

  • Par intégration API avec des sites partenaires. Pour cela une méthode d'intégration DossierFacileConnect (DFC) a été mise en oeuvre. Voir documentation DossierFacile Connect

🚩 Les principaux concepts

1. Le dossier de candidature (entité apartment_sharing)

C'est le concept central de DossierFacile. Un dossier de candidature regroupe les différents dossiers locataires.

La propriété type permet de différencier les types de dossier :

  • ALONE, il s'agit d'un dossier de candidature comprenant un seul dossier locataire. C'est le cas le plus simple.

  • COUPLE, il s'agit d'un dossier de candidature comprenant 2 dossiers locataires. Un dossier est considéré comme "principal" et l'autre comme "joint". L'utilisateur du dossier principal peut inviter par email un autre utilisateur à compléter le dossier joint. L'utilisateur du dossier principal accède aux 2 dossiers et peut les compléter simultanément dans le parcours DossierFacile.

  • GROUP, il s'agit d'un dossier de candidature comprenant plusieurs dossiers locataires (cas d'un colocation). Un dossier est considéré comme "principal" et les autres comme "joint". L'utilisateur du dossier principal peut inviter par email d'autres utilisateurs à compléter leur dossier joint. L'utilisateur du dossier principal ne peut pas compléter les dossiers de autres colocataires.

Le dossier de candidature est considéré comme étant complet et validé lorsque :

  • tous les dossiers locataires ont été complétés

  • tous les dossiers locataires ont été validés par nos opérateurs

Lorsqu'un utilisateur partage son dossier, il partage le dossier de candidature auquel il est associé. Dans le cas des types de candidature COUPLE et GROUP, il partage également à cette occasion le dossier individuel de tous les autres participants au dossier.

2. Le dossier locataire (entité tenant)

Un dossier locataire individuel (tenant) est rattaché à un dossier de candidature (apartment_sharing).

Limitations : Il ne peut y avoir qu'un dossier locataire par compte utilisateur DossierFacile. Un utilisateur ne peut donc participer qu'à un seul dossier de candidature.

La propriété type permet de distinguer si le dossier locataire est le dossier principal d'un candidature :

  • CREATE, il s'agit du dossier locataire principal (tenant) d'un dossier de candidature (apartment_sharing)

  • JOIN, il s'agit d'un dossier invité dans un dossier de candidature (de type COUPLE ou GROUP)

Un dossier locataire est constitué de 5 catégories de documents. Ces catégories sont définies par le décret n° 2015-1437 du 5 novembre 2015 fixant la liste des pièces justificatives pouvant être demandées au candidat à la location et à sa caution.

  • 🆔 Justificatif d'identité (IDENTIFICATION)

  • 🏠 Justificatif de domicile (RESIDENCY)

  • 💼 Justificatif de situation professionnelle (PROFESSIONAL)

  • 💸 Justificatif de ressources (FINANCIAL)

  • 📄 Avis d'imposition (TAX)

Un dossier locataire est considéré comme complet lorsque :

  • les informations (nom, prénom) ont été complétées.

  • les 5 documents correspondants aux catégories précédemment mentionnées ont été déposés.

  • la déclaration sur l'honneur attestant de la véracité des informations transmises a été réalisée par l'utilisateur.

Un dossier locataire peut contenir des garants (guarantor)

3. Le dossier garant (entité guarantor)

Un ou plusieurs dossiers garants (guarantor) peuvent être rattachés à un dossier locataire (tenant). Les garants se portent caution du bail.

Il y a 3 types de garants différents :

  • Garant physique (jusqu'à 2 possibles), type NATURAL_PERSON

  • Garant organisme (type Visale), type ORGANISM

  • Garant moral, type NATURAL_PERSON

Des documents peuvent également constituer un dossier garant. On retrouve par exemple pour le garant physique les mêmes catégories de documents que pour un dossier locataire (Justificatifs d'identité, domicile, situation professionnelle, ressources, avis d'imposition)

4. Les documents (entité documents)

Un document représente une pièce justificative associée à un dossier locataire (tenant) ou un dossier garant (guarantor). Un document est défini par :

  • une catégorie, parmi les 5 catégories définies précédemment

  • une sous-catégorie, qui précise la nature plus précise de la pièce justificative (ex: FRENCH_IDENTITY_CARD pour une carte nationale d'identité)

Un document est constitué de la fusion des fichiers déposés dans un champ du formulaire de constitution de dossier DossierFacile. Si un utilisateur dépose 3 bulletins de paie sous la forme de 3 fichiers .pdf, son justificatif de revenu professionnel sera disponible sous la forme d'un seul document filigrané (catégorie FINANCIAL)

5. Les fichiers (entité files)

Un fichier (file) représente un fichier déposé dans un champ du formulaire de constitution de dossier DossierFacile. Un fichier ou plusieurs fichiers composent un document

Un fichier peut être en format JPG, PNG ou PDF et est soumis à des critères de poids, de nombre de pages.

Une fois tous les fichiers déposés dans une des 5 catégories du formulaire. Un processus asynchrone vient réaliser la fusion des fichiers et l'apposition d'un filigrane afin de constituer un document filigrané.

☑️ Les différents statuts

Les entités apartment_sharing, tenant et document sont toutes les 3 définies par une propriété status qui représente le statut de progression du dossier ou de la pièce justificative dans le processus de vérification DossierFacile.

INCOMPLETE

Le dossier de candidature (apartment_sharing) ou locataire (tenant) est incomplet. Certains documents ou informations requises sont manquants.

🔄 TO_PROCESS

Lorsqu'un dossier locataire est complet, il est prêt a être vérifié par nos opérateurs, son statut ainsi que le statut de tous les documents qu'il comprend passent en TO_PROCESS. Cela signifie pour les utilisateurs que le dossier est en cours de traitement. Les opérateurs DossierFacile et les systèmes de vérifications automatiques vont permettre de traiter le dossier.

DECLINED

Certains documents fournis dans le dossier locataire ne sont pas conformes et n'ont pas été acceptés. Ils doivent alors faire l'objet d'une modification de la part des utilisateurs. Une fois les modifications effectuées et le dossier de nouveau soumis, le statut passe automatiquement en TO_PROCESS.

Sur un document, le statut DECLINED est associé à une ou plusieurs raisons de refus (propriété documentDeniedReasons)

VALIDATED

L'ensemble des documents du dossier locataire a été vérifié et validé.

Si l'ensemble des dossiers locataires contenant un dossier de candidature ont été validés (status VALIDATED) alors le dossier de candidature est considéré comme VALIDATED également.

📦 ARCHIVED

Au bout de 3 mois d'inactivité (sans connexion et sans validation du mail informant de l'archivage à venir), les documents du candidat sont supprimés. Le dossier locataire passe alors dans un status ARCHIVED.

📩 Notifications utilisateurs

Des mails automatiques sont envoyés aux utilisateurs lors de certaines actions : la création du compte, la modification demandée de certaines pièces justificatives, la validation du dossier, l'archivage d'un compte…

🔗 Intégration avec les partenaires

2 types d'intégrations techniques existent permettant le partage de dossiers entre votre service et DossierFacile.

📍Lien simple tracké🔗DossierFacile Connect

Last updated

Was this helpful?