# Dossiers

Vérifier chaque pièce ne suffit pas toujours : un faux dossier de location peut être fait de pièces toutes plausibles une à une, mais incohérentes entre elles (nom, adresse, employeur, montants, dates). La **vérification de dossier** recoupe toutes les pièces d'un même envoi et rend un verdict global.

## Demander une vérification de dossier

Ajoutez `final_check` à l'envoi, avec **toutes les pièces du dossier dans le même envoi** :

```bash
curl -X POST https://france-verification.com/api/v1/submissions \
  -H "Authorization: Bearer $FV_API_KEY" \
  -F "final_check=dossier_location" \
  -F "files[]=@cni-recto-verso.pdf" \
  -F "files[]=@bulletins.pdf" \
  -F "files[]=@avis-imposition.pdf" \
  -F "files[]=@rib.pdf"
```

## Instructions disponibles

La liste à jour, avec le coût en crédits de chacune, est renvoyée par [GET /document-types](/developpeurs/compte-et-referentiels) (tableau `final_checks`).

| `final_check` | Ce qui est recoupé |
|---|---|
| `dossier_location` | Identité, adresses, employeur, revenus, dates, complétude du dossier. |
| `capacite_financiere` | Titulaire, salaires réellement crédités, régularité, cohérence avec l'avis d'imposition, incidents. |
| `dossier_embauche` | Identité, droit au travail, titulaire du RIB, numéro de sécurité sociale, diplômes, périodes. |
| `identite` | Même personne sur toutes les pièces, recto et verso, validité, bande MRZ, droit au séjour. |
| `dossier_copropriete` | Convocation, quorum et tantièmes, mandats, majorités, appels de fonds. |

## Le résultat

L'envoi porte un objet `final_check` :

```json
"final_check": {
  "type": "dossier_location",
  "status": "completed",
  "result": {
    "id": "chk_52830",
    "type": "final_check",
    "status": "completed",
    "verdict": "SUSPECT",
    "confidence_score": 0.48,
    "document_type": "dossier_location",
    "document_label": "Vérifier un dossier de location",
    "...": "..."
  }
}
```

| `final_check.status` | Signification |
|---|---|
| `pending` | Les pièces sont encore en cours d'analyse. |
| `processing` | Le recoupement est en cours. |
| `completed` | `result` porte le verdict du dossier. |
| `failed` | Le recoupement a échoué ; les verdicts de chaque pièce restent valables. |
| `skipped` | Aucune pièce exploitable : le recoupement n'a pas eu lieu et son crédit est rendu. |

Deux règles de cohérence : le verdict du dossier n'est **jamais meilleur** que celui de sa pire pièce, et son score reste cohérent avec son verdict.

L'envoi ne passe à `completed` (et le webhook ne part) qu'une fois le recoupement terminé.