---
title: Statuts des factures
description: Les treize statuts qu’un document peut avoir, ce qui l’y fait entrer, ce qui l’en fait sortir, et lesquels sont comptés dans votre volume mensuel inclus
section: Reference
order: 20
sourceHash: f9ee62993d6f
translation: machine
---

# Statuts des factures

Chaque document dans inletAP a exactement un statut, et ce statut est la réponse honnête à la question « que se passe-t-il avec cette facture? ». Cette page est la référence pour les treize statuts : ce que chacun signifie, ce qui y place un document, ce qui l’en fait sortir, et si le document a été compté dans votre forfait.

![La boîte de réception, qui liste chaque document avec le fournisseur, le numéro de facture, la date d’échéance, le montant, l’immeuble, le statut et le niveau de confiance.](/screens/inbox.png "Chaque document, quel que soit son état. La colonne du statut utilise le même vocabulaire que ce guide.")

Consultez-la quand un document s’est arrêté là où vous ne l’attendiez pas, ou avant d’écrire une règle qui dépend de l’endroit où les factures aboutissent.

## Les treize statuts

Les noms ci-dessous sont les valeurs qu’utilisent l’API et ce guide. **Trois d’entre eux partagent un même libellé dans la boîte de réception :** `new`, `parsed` et `extracted` s’affichent tous comme **Nouvelle**, parce que, du point de vue de la personne qui lit, un document arrivé qui n’a pas encore atteint quelqu’un est une seule et même chose. `held_quota` s’affiche comme **En suspens** : cet état ne se règle pas tout seul, il a donc son propre libellé. Quand le libellé diffère du nom, la colonne « Affiché comme » le donne.

| Statut | Affiché comme | Ce qu’il signifie | Y entre quand | En sort vers | Compté dans votre volume inclus |
| --- | --- | --- | --- | --- | --- |
| `new` | Nouvelle | La valeur par défaut de la colonne du statut. En pratique, vous ne la verrez pas : l’analyseur crée chaque document déjà à `parsed` ou à `needs_review`. | Rien dans le traitement ne l’écrit. | s.o. | Non |
| `parsed` | Nouvelle | Les pièces jointes et le texte du corps ont été extraits de la structure MIME. | L’analyseur a terminé avec le message. | `extracted`, `held_quota`, `needs_review`, `filtered`, `quarantined`. | Non |
| `held_quota` | En suspens | Analysé, prêt, et en attente parce que le volume inclus du forfait est épuisé. | Le volume inclus est épuisé au moment où l’extraction devrait s’exécuter. | `extracted` une fois libéré, ou retour à `parsed`. | Pas encore — il est compté quand il est libéré et extrait |
| `extracted` | Nouvelle | Les champs ont été lus dans le document, chacun avec un score de confiance. | L’étape d’extraction se termine. | `needs_review` ou `ready_for_approval`. | Oui, compté ici |
| `needs_review` | À examiner | Une personne doit intervenir avant que le document puisse aller plus loin. | Une confiance sous le seuil, un renvoi à un niveau supérieur, une approbation refusée ou une extraction qui a complètement échoué. | `ready_for_approval`, `duplicate`, `filtered`, `quarantined`. | Oui, au plus tard quand une personne termine son examen |
| `ready_for_approval` | En attente d’approbation | Imputé et en attente d’une décision. | L’extraction est suffisamment sûre, une règle l’approuve automatiquement, ou une personne qui l’examine le transmet. | `approved`, retour à `needs_review` en cas de refus, ou `quarantined`. | Oui |
| `approved` | Approuvée | Le quorum d’approbation de son palier est atteint. | La dernière approbation requise est donnée. | `exported`. | Oui |
| `exported` | Exportée | Livré à votre logiciel comptable ou écrit dans un fichier d’exportation. | Le lot d’exportation réussit. | Nulle part où vous pouvez le déclencher. Voir plus bas. | Oui |
| `partially_exported` | Partiellement exportée | Une partie d’une facture répartie a atteint votre logiciel comptable, et une autre partie non. | Un document comptabilisé dans plusieurs sociétés du logiciel comptable réussit dans certaines et est mis de côté dans d’autres. | Retour à `exported` quand une relance ultérieure du même lot aboutit dans toutes les sociétés. [Exportations](/app/exports) indique quelle société reste en suspens. | Oui |
| `failed_export` | Échec de l’exportation | L’exportation a été tentée et ne s’est pas terminée. | Un lot d’exportation échoue, ou l’élément est mis de côté avant la comptabilisation. | Relancer le lot d’exportation fait une nouvelle tentative pour l’élément. Le statut du document ne se remet pas en arrière à la main. | Oui |
| `duplicate` | Doublon | Une personne a confirmé que ce document est une copie d’un document que vous avez déjà. | Une personne qui examine le document appuie sur **Marquer comme doublon** et choisit l’original. Jamais automatique. | Nulle part pour l’instant. Il n’existe aucune action pour annuler un doublon; le document garde le statut et le lien. | Seulement s’il a été extrait avant d’être marqué |
| `filtered` | Filtrée | Jugé comme n’étant pas une facture du tout. | Le tri reconnaît une infolettre, une réponse automatique, un retour de courriel non livré, une invitation de calendrier, ou un courriel sans pièce jointe dont le corps ne contient rien de financier. | `parsed`, en le restaurant. | Non, et c’est justement le but |
| `quarantined` | En quarantaine | Une mise en attente pour raison de sécurité. | Une règle avec une action de mise en quarantaine correspond, ou quelqu’un l’y place. | Nulle part pour l’instant. Un document en quarantaine y reste; il n’existe pas encore d’action pour l’en sortir. | Dépend du chemin qu’il avait déjà parcouru |

Le document n’est jamais supprimé à aucune de ces étapes. Le message d’origine, les pièces jointes et le texte extrait sont tous conservés, y compris pour les statuts qui ressemblent à un cul-de-sac.

Marquer un document comme doublon n’est pas réversible dans l’application pour l’instant. Rien n’est perdu pour autant : le document garde son lien vers l’original et tout son historique de vérification, la facture peut encore être lue, et les preuves exportées la nomment toujours. Si vous avez besoin de changer le statut lui-même, communiquez avec l’assistance en donnant le numéro du document.

## Filtré, en quarantaine et en suspens : les trois qu’on confond

Ces trois statuts veulent tous dire « ce document n’ira pas plus loin pour l’instant », et ils sont délibérément gardés distincts, parce que les confondre rendrait les trois plus difficiles à comprendre.

`filtered` est une décision d’acheminement. Quelque chose qui n’est pas une facture est arrivé, et il a été détourné **avant** l’extraction — il ne coûte donc rien, ne consomme rien du volume inclus, et peut être remis en circulation en une seule action. Le restaurer ramène le document à `parsed` et le remet dans la file, exactement là où il aurait été s’il n’avait jamais été détourné.

Dans le doute, le filtre laisse passer. Un message qui contient à la fois un libellé de facture et un montant n’est jamais filtré par une règle statistique, même si son enveloppe ressemble beaucoup à du marketing, parce qu’un faux positif vous coûte une demande d’assistance et qu’un faux négatif coûte quelques cents de traitement.

`quarantined` est un incident. Il signifie qu’une règle que vous avez écrite a dit « mettez celui-ci en attente », et que le document attend une personne qui a l’autorité de l’examiner. Ce n’est pas un jugement sur le contenu du fichier; c’est un jugement sur l’expéditeur, le montant ou le libellé, que vous avez vous-même encodé. Il n’existe pas d’action pour l’en sortir pour l’instant : un document en quarantaine reste où il est, visible, avec le nom de sa règle.

`held_quota` n’est ni l’un ni l’autre. Le document est une facture parfaitement valable et le volume inclus du mois est épuisé, alors il s’arrête juste avant l’étape d’extraction — l’étape qui coûte de l’argent. Le texte source analysé est déjà conservé, alors libérer un document en suspens n’a qu’à lancer l’extraction; rien n’est récupéré ni analysé deux fois.

## `partially_exported`, et pourquoi c’est un statut distinct

La plupart des factures deviennent une seule facture fournisseur. Une facture répartie entre des entités propriétaires qui tiennent des sociétés distinctes dans le logiciel comptable devient une facture fournisseur par société, et ces comptabilisations peuvent réussir ou échouer indépendamment les uns des autres : deux factures fournisseurs comptabilisées, une mise de côté.

Appeler cela `exported` affirmerait que de l’argent se trouve dans votre logiciel comptable alors qu’il n’y est pas. L’appeler `failed_export` affirmerait le contraire, et inviterait à relancer des factures fournisseurs déjà comptabilisées. Il a donc son propre statut, l’écran [Exportations](/app/exports) affiche une rangée par société avec son propre résultat, et la relance vise la société qui a échoué. Voir [comptabiliser dans plusieurs sociétés](/docs/posting-to-several-companies).

## Ce qui est compté dans votre volume inclus

Une facture traitée est un document dont inletAP a extrait les champs. Le compteur est inscrit sur le document une seule fois, jamais deux, quel que soit le chemin que le document prend ensuite.

Il peut être inscrit à deux endroits :

- L’extraction. Le cas habituel, et la raison pour laquelle `filtered` et `held_quota` ne coûtent rien : les deux s’arrêtent avant elle.
- Une personne qui termine l’examen d’un document que l’extracteur n’a pas pu lire — une facture manuscrite photographiée, par exemple — et qui l’envoie à l’approbation. Le travail a été fait et la facture est réelle, alors elle est comptée.

Un document qui revient à l’examen, qui est extrait de nouveau, ou qui est refusé puis approuvé de nouveau n’est toujours compté qu’une fois. Relancer le traitement ne vous facture pas une deuxième fois.

Voir [forfaits et limites](/docs/plans-and-limits) pour savoir ce qui arrive quand le volume inclus est épuisé, selon le forfait.

## Quels passages sont permis

Les statuts ne changent pas librement, mais la contrainte vient du chemin du code plutôt que d’un contrôle général : chaque étape du traitement n’écrit que les statuts dont elle est responsable, et le tableau ci-dessus liste ce que chaque étape peut produire. Il n’existe aucun service distinct de machine à états qui refuse un passage arbitraire, alors lisez ce tableau comme la description de ce qui se passe plutôt que comme une règle de validation sur laquelle vous pouvez compter.

Trois passages méritent d’être connus, parce que les gens les cherchent :

| Vous voulez | Le passage |
| --- | --- |
| Annuler un filtrage | De `filtered` à `parsed`. La restauration est le seul moyen de sortir de `filtered`, et elle remet l’extraction dans la file. |
| Relancer une exportation échouée | Relancez le **lot** d’exportation. Le lot passe de `failed` à `pending` et l’élément est tenté de nouveau. Il n’existe aucune action par document pour « le remettre à approuvé ». |
| Terminer une exportation partielle | Relancez le lot. Seule la société mise de côté est tentée de nouveau; les factures fournisseurs déjà comptabilisées ne sont pas touchées. Surveillez [Exportations](/app/exports), pas le badge de la boîte de réception. |

`exported` n’a aucune sortie que vous pouvez déclencher. La seule exception est interne : pendant qu’un lot à plusieurs sociétés est encore en cours de traitement, un document peut passer de `exported` à `partially_exported` et inversement, à mesure que les sociétés restantes rendent compte. Une fois qu’une facture fournisseur existe dans votre logiciel comptable, la correction se fait dans le logiciel comptable — inletAP ne fera pas comme si la comptabilisation n’avait jamais eu lieu, et la [piste de vérification](/docs/audit-trail) consigne l’identifiant externe qu’il a reçu.

## Ce que veut dire « une exception » quand vous lisez un rapport

Dans une liste de statuts, `needs_review` et `quarantined` décrivent où se trouve une facture **maintenant**. Dans [Rapports](/app/reports), le mot `exception` a un sens plus étroit et plus utile : une facture qui a **déjà** eu l’un de ces deux statuts, rapportée aux factures arrivées pendant la même période.

La différence compte, parce que les deux réponses évoluent en sens contraire. Le nombre de factures en attente à cet instant baisse à mesure que l’équipe vide la file, si bien qu’une équipe rapide paraît meilleure qu’une équipe lente qui détient les mêmes factures — c’est une mesure de la charge de travail, pas de la qualité. Le chiffre rapporté est fixé une fois la période passée.

Une conséquence visible : une facture envoyée à l’examen, lue, puis approuvée sans qu’un seul caractère soit modifié est une exception **et** elle est traitée automatiquement. Les deux chiffres de la page des rapports ne sont pas des opposés, et la [référence des mesures](/docs/metrics-reference) donne la définition complète de chacun.

## Pour aller plus loin

- [Comment ça fonctionne](/docs/how-it-works) — le traitement que ces statuts décrivent.
- [Référence des mesures](/docs/metrics-reference) — ce que chaque statut compte une fois qu’il arrive dans un rapport.
- [Confiance de l’extraction](/docs/extraction-confidence) — ce qui décide entre `needs_review` et `ready_for_approval`.
- [Référence des exportations](/docs/exports-reference) — ce que `exported` et `failed_export` signifient en pratique.
- [Comptabiliser dans plusieurs sociétés](/docs/posting-to-several-companies) — d’où vient `partially_exported`.
- [Pourquoi ma facture n’est-elle pas apparue?](/docs/invoice-not-appearing) — pour les documents qui n’ont jamais atteint de statut.