Statuts et raisons
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. |
Remarque
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 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 :
{
"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é, 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.