Relevés bancaires
Les fichiers de relevé téléversés dans une entreprise, et la révision de ce qu'une extraction y a lu. UN FICHIER, UN RELEVÉ : un téléversement multipart répond une collection, une ligne par fichier, chacune avec son propre compte, son propre état et sa propre erreur, si bien qu'un fichier en échec n'entraîne jamais ses voisins avec lui. Une extraction produit des lignes qu'un opérateur corrige - les lignes et les deux soldes du relevé se corrigent en un seul appel atomique - et reconciliation_errors sur cet appel est un avertissement porté par un 200, qui vous dit que le relevé ne s'équilibre plus. UNE EXTRACTION TRANSMET LE FICHIER À UN PRESTATAIRE OCR EXTERNE (Mistral AI) ; l'opération de téléversement énonce le parcours en entier, et le mode archive est celui sous lequel le fichier est stocké, et rien de plus.
Lister les relevés bancaires d'une entreprise
Retourne les relevés téléversés dans l'entreprise, du plus récent au plus ancien. Interrogez cette liste - ou la lecture d'un relevé unique - après un téléversement : un 202 signifie que les fichiers existent et qu'ils sont à vous pour être suivis, jamais que l'extraction est terminée.
Téléverser des relevés bancaires
Téléverse un ou plusieurs fichiers de relevé dans une entreprise. **Un fichier, un relevé** : ce 202 répond donc une COLLECTION - une ligne par fichier, dans l'ordre de la requête, chacune avec son propre compte, son propre état et sa propre erreur - et vous interrogez N identifiants plutôt qu'un seul. Un fichier dont l'extraction échoue n'entraîne jamais ses voisins avec lui. Une partie nommant un compte que vous ne pouvez pas atteindre est un cas différent : c'est une requête mal formée, donc le téléversement entier est refusé et rien n'est stocké.
Lire un relevé bancaire
Retourne un relevé. C'est le point à interroger après un téléversement ou une relance, et `state` est le champ à lire. `started_at` et `finished_at` sont désormais les horloges propres de l'extraction : un fichier en `processing` publie un début et pas de fin, et tous deux restent null sur un fichier qu'aucune passe n'a pris en charge.
Supprimer un relevé bancaire
Supprime le relevé et le fichier stocké. Autorisé uniquement AVANT l'enregistrement des opérations, et c'est `committed` qui porte cette frontière - PAS la réconciliation. `committed` passe à true dès que l'extraction enregistre des opérations - les LIGNES elles-mêmes, qui sont écrites avant `operations_count` -, donc lisez-le avant d'appeler : un relevé qui rapporte `committed: true` est refusé quel que soit son `state`. En pratique, ce point de terminaison annule un import qui n'a rien produit - un relevé encore à `committed: false`, dans n'importe quel état. Un relevé `archived` est refusé aussi. Le corps de la réponse est le relevé tel qu'il était au moment où vous en avez demandé la suppression - sérialisé avant la suppression, parce qu'ensuite son fichier n'existe plus pour être décrit.
Relancer l'extraction d'un relevé
Relance l'extraction sur un fichier dont la première tentative n'a pas abouti. Lisez `retryable` sur le relevé avant d'appeler : l'indication et ce point de terminaison lisent la même règle. Le 202 retourne le relevé remis à `pending`, l'erreur précédente effacée.
Comptabiliser un relevé bancaire révisé
Comptabilise les lignes extraites du relevé au grand livre et clôt sa révision. Le 200 retourne le relevé en `posted`, avec `committed` à true.
Router un relevé vers un compte bancaire
Résout un routage AMBIGU en nommant le compte auquel le fichier appartient, et enregistre qu'un humain l'a choisi : `account_detection` passe à `manual`.
Exclure un relevé de la comptabilisation de son dépôt
Retire le fichier de la comptabilisation du dépôt dont il fait partie. Le 200 retourne le relevé avec `excluded` à true et `excluded_at` renseigné.
Réintégrer un relevé dans la comptabilisation de son dépôt
Remet un fichier exclu dans la comptabilisation de son dépôt. Le 200 retourne le relevé avec `excluded` à false et `excluded_at` à null.
Lister les lignes extraites d'un relevé
Retourne les lignes lues par l'extraction, dans l'ordre du relevé (`operation_date` croissant, puis `id`) - l'ordre dans lequel un relevé se lit. C'est ce qu'un opérateur relit avant que les chiffres ne soient comptabilisés.
Réviser les lignes et les soldes d'un relevé
Corrige les lignes extraites et, dans le MÊME appel, les deux soldes du relevé - il n'existe pas de `PATCH /bank_statements/{id}`, et corriger un solde est le même acte de révision que corriger une ligne. La soumission est atomique : un seul chiffre mal formé refuse l'ensemble et n'écrit rien, si bien que vous ne vous retrouvez jamais avec un relevé à moitié modifié derrière un 422.