Router un relevé vers un compte bancaire
POST/api/v1/bank_statements/:id/route_account
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.
Quand vous en avez besoin. L'extracteur lit l'IBAN du document et le rapproche des comptes de l'entreprise. Quand il ne correspond à aucun, ou à plusieurs, le fichier est publié account_detection: ambiguous - et toute comptabilisation le refuse tant que cet appel n'a pas tranché la question. Lisez account_detection après l'extraction plutôt que de découvrir le refus au moment de comptabiliser.
Ce qu'il déplace. Le relevé et toutes ses lignes sont repointés sur le compte que vous nommez, et toute comptabilité déjà projetée contre l'ancien compte est retirée - la comptabilisation reposera sur le nouveau. Les CHIFFRES extraits ne sont pas touchés, si bien qu'une révision déjà confirmée le reste et qu'aucune seconde confirmation n'est nécessaire entre cet appel et la comptabilisation.
Aucune Idempotency-Key n'est requise : router deux fois vers le même compte, c'est le même fichier au même endroit. Nommer un compte DIFFÉRENT une seconde fois est un second routage et sera effectué - l'en-tête ne vous en protège pas, lire la réponse si.
Request
Responses
- 200
- 401
- 403
- 404
- 422
The file was routed. It comes back on the chosen account, with account_detection now manual.
La requête ne porte aucun jeton, ou un jeton invalide ou expiré.
Le jeton n'est pas autorisé à effectuer cet appel : le scope OAuth déduit du verbe (write), l'habilitation sur l'espace de travail, le drapeau de fonctionnalité bank_reconciliation, ou le contrôle Pundit propre à l'action. L'exemple ci-dessous est refusé sur le scope.
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.
The routing was refused, and details is what tells the two families apart.
Without details - statement_not_reviewable: the FILE is not open to routing. It is archived, still extracting, already posted, was stored in archive mode, or its routing was never ambiguous in the first place (account_detection is auto). Nothing you send can change that; read the statement.
With details.bank_account_id - the ACCOUNT you named is not a destination for this file: it belongs to another company, is synced from an aggregation provider, is archived, or the move was refused because this file's lines already carry reconciliation work. Resend with another account.