Lire un relevé bancaire
GET/api/v1/bank_statements/:id
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.
Un pending qui ne bouge pas ne travaille pas forcément. pending signifie stocké et pas encore révisable, et un fichier y reste que son extraction ait été mise en file, qu'elle ait été refusée au téléversement (meta.unqueued_statement_ids sur le 202), ou qu'elle n'ait jamais eu à tourner parce que l'extraction par IA est désactivée pour l'entreprise. processing est l'état qui, lui, signifie que le travail tourne. Bornez donc votre interrogation : un relevé qui reste pending est un relevé à relancer par POST /bank_statements/{id}/retry, pas un relevé à attendre plus longtemps - lorsque son retryable vaut true. Un pending dont le retryable vaut false appartient à une entreprise dont l'extraction par IA est désactivée : la relance est refusée avec operation_failed tant que le réglage n'a pas été activé dans Scribee.
Request
Responses
- 200
- 401
- 403
- 404
The bank statement.
La requête ne porte aucun jeton bearer, ou en porte un qui est invalide ou expiré. doorkeeper_authorize! est le premier contrôle de la chaîne, si bien que la réponse est rendue avant que l'espace de travail, l'entreprise, le drapeau de fonctionnalité et le relevé ne soient résolus - et avant qu'une Idempotency-Key ne soit revendiquée.
Le jeton n'est pas autorisé à effectuer cet appel. Sur un GET, le scope est read, que tout jeton détient : ce qui répond ici est donc l'un des trois autres contrôles de la chaîne partagée, à savoir l'HABILITATION sur l'espace de travail, le DRAPEAU DE FONCTIONNALITÉ bank_reconciliation ou le contrôle Pundit propre à l'action. Tous rendent le même corps, message est donc ce qui les distingue. L'exemple ci-dessous est refusé par le drapeau.
Aucun relevé portant cet identifiant n'est atteignable par les habilitations du jeton. Un relevé appartenant à un autre espace de travail répond de la même manière, si bien que la réponse ne permet pas d'en sonder l'existence.