# Statuts et raisons
> Les statuts d'un fichier et les raisons pour lesquelles il n'a pas été lu, et que faire pour chacun.
>
> Avant: [Envoyer un fichier et le lire](https://ocost.io/docs/fr/files.md)

Chaque fichier a un `status` qui dit où en est Ocost avec lui. Un fichier qui n'a pas été lu a aussi une `reason`. Décidez selon les deux.

## Statuts

| Statut | Signification | Que faire |
| --- | --- | --- |
| `received` | Stocké, pas encore lu. | Attendre. |
| `reading` | En cours de lecture. | Attendre. |
| `read` | Lu. `documents` liste ce qu'il contient. | Lire ses documents. |
| `not_read` | Stocké, mais pas lu. | Regarder `reason`. |
| `failed` | Ocost n'a pas pu le lire. | Regarder `reason`. |
| `needs_company` | Lu, mais la société du groupe reste à dire. `candidates` les liste. | Le `PATCH` avec `business_id`, ou attendre. Voir [Groupes de sociétés](https://ocost.io/docs/fr/groups.md). |

> [!NOTE]
> Tant qu'aucun service de lecture ne répond, un fichier reste `reading`. Ocost réessaie pendant un jour au plus.

## En attente de sa société

Un fichier envoyé avec la clé d'un groupe attend en `needs_company` quand son document nomme plusieurs sociétés du groupe, ou une autre par son seul nom. Chacun de ses `candidates` dit `why` : un identifiant imprimé sur le document, `name` ou `home`.

Dans Ocost, le propriétaire ou le comptable répond dans Aujourd’hui › Attribuer, ou dans Fichiers › Pas encore attribués. Ocost propose le premier candidat, sauf s'il est `home`. Le fichier passe alors dans cette société et y est lu. Un fichier envoyé à l'adresse propre du groupe attend dans la boîte du groupe jusqu'à ce que sa société soit claire. Aucune clé n'atteint cette boîte. [Groupes de sociétés](https://ocost.io/docs/fr/groups.md#attribuer-un-fichier-en-attente) montre la même réponse avec `PATCH`.

## Raisons

| Raison | Avec | Signification |
| --- | --- | --- |
| `limit` | `not_read` | Les documents du mois sont épuisés. Ocost lit le fichier de lui-même à la date `renews_on`. |
| `model_off` | `not_read` | Cette entreprise ne fait pas lire ses PDF et ses images. Les factures électroniques sont toujours lues. Dès qu'elle le fait, renvoyez les mêmes octets. |
| `nothing_found` | `not_read` | Le fichier ne contient aucun document. |
| `too_large` | `not_read` | Trop de pages, ou une image trop grande. |
| `damaged` | `failed` | Pas un fichier qu'Ocost peut ouvrir. |
| `unavailable` | `failed` | Aucun service de lecture n'a répondu pendant un jour. Renvoyez les mêmes octets pour réessayer. |
| `failed` | `failed` | La lecture a échoué ou a été refusée. Ocost retente une lecture échouée 10 et 60 minutes plus tard. Renvoyez les mêmes octets pour réessayer plus tôt. |
| `other` | l'un ou l'autre | Une raison que cette version de l'API ne nomme pas encore. |

## Le renvoyer

Renvoyer les mêmes octets renvoie le même fichier, avec le même `id`. Ocost le compte une seule fois. Dans trois cas, il relit le fichier à partir des octets qu'il garde, et le fichier passe en `reading` :

| Raison | Relu |
| --- | --- |
| `unavailable` | À chaque envoi. |
| `failed` | À chaque envoi, à partir d'une minute après l'échec. Un fichier refusé par le modèle est relu une fois. |
| `model_off` | Dès que l'entreprise a un modèle de lecture. |

Pour toute autre raison, le renvoyer ne change rien. Ne supprimez pas un fichier pour le renvoyer : un nouveau fichier est compté de nouveau. Un fichier lu garde sa lecture quand le lecteur d'Ocost s'améliore. Seul « Relire » dans Fichiers le relit.

## Un exemple

Un fichier envoyé après épuisement des documents du mois :

```json
{
  "id": "01a1b08c-6e3a-7562-8f4a-7924722667b1",
  "name": "invoice.pdf",
  "status": "not_read",
  "reason": "limit",
  "renews_on": "2026-12-01",
  "documents": []
}
```

Ocost le lit le 1er décembre, ou plus tôt si la formule augmente. Continuez d'interroger ou [restez synchronisé](https://ocost.io/docs/fr/sync.md), et il apparaît en `read`.

## Fichiers longs

Ocost ne lit que les premières pages d'un long PDF. `pages` compte les pages du fichier, et `pages_read` dit combien ont été lues. `pages_read` vaut `null` quand Ocost les a toutes lues.

## Voir aussi

- [Envoyer un fichier et le lire](https://ocost.io/docs/fr/files.md): Envoyer un fichier, le renvoyer sans risque, attendre qu'il soit lu, lire ses documents, récupérer l'original, le supprimer.
- [Limites et erreurs](https://ocost.io/docs/fr/limits.md): Les documents par mois de la formule, les limites de débit, les tailles, les erreurs RFC 9457, les nouvelles tentatives, et où les données sont gardées.
- [Groupes de sociétés](https://ocost.io/docs/fr/groups.md): Groupes de sociétés : les sociétés qu’une clé atteint, l’en-tête Ocost-Business, l’orientation par les identifiants du document, needs_company et les fichiers du groupe.
