Lister les opérations bancaires d'une entreprise
GET/api/v1/workspaces/:workspace_id/companies/:company_id/bank_operations
Retourne les opérations bancaires de l'entreprise, de la date d'opération la plus récente à la plus ancienne. Les opérations ne se créent pas par cette API - une ligne arrive d'une synchronisation, ou de l'extraction d'un relevé importé, que ce relevé ait été validé depuis ou non - et elles ne s'y corrigent ni ne s'y archivent pas davantage.
Hors l'entreprise du chemin, aucun filtre n'est appliqué par défaut, archived compris. Tous les statuts de rapprochement sont rendus tant que vous n'en demandez pas un en particulier, ce qui compte surtout pour partially_matched : une ligne à moitié imputée reste listée jusqu'à ce que son reste soit imputé ou écarté, si bien qu'une file construite sur cet endpoint ne peut pas en perdre une silencieusement. Les lignes archivées sont rendues elles aussi - un archived absent ne restreint rien, ?archived=false est la façon de demander les lignes actives, et chaque ligne publie archived pour que vous puissiez aussi les séparer vous-même.
Une valeur de filtre non reconnue restreint le résultat à rien plutôt que d'être refusée ou ignorée, ce qui est la convention de toute cette surface : ?direction=sideways rend une page vide, pas une erreur 4xx.
Request
Responses
- 200
- 400
- 401
- 403
- 404
Les opérations bancaires de l'entreprise, de la date d'opération la plus récente à la plus ancienne.
Le paramètre de requête page n'est pas un entier supérieur ou égal à 1, ou il désigne une page au-delà de la dernière pour ce filtre. per_page n'est PAS concerné : une valeur illisible retombe sur la valeur par défaut plutôt que de provoquer une erreur.
The request carries no bearer token, or one that is invalid or expired. doorkeeper_authorize! is the first gate of the chain, so this is answered before the workspace, the company and the feature flag are ever resolved.
Trois portes répondent ici de la même manière, si bien que message est ce qui les distingue. D'ABORD LE SCOPE OAuth : un GET exige read, et un jeton portant seulement write ou destroy est refusé avant même que l'espace de travail, l'entreprise et la fonctionnalité soient examinés. Ensuite l'HABILITATION de votre application sur cet espace de travail, puis la FONCTIONNALITÉ bank_reconciliation pour celui-ci. L'exemple ci-dessous est refusé faute d'habilitation.
Aucune entreprise portant cet identifiant n'appartient à l'espace de travail résolu. Une entreprise d'un AUTRE espace de travail répond de la même manière - y compris quand votre jeton porte aussi une habilitation sur celui-là - si bien que la réponse ne permet pas d'en sonder l'existence.