# Qonto — banque, transactions et justificatifs Comptes, mouvements, pièces et factures fournisseurs : un contrat de collecte pour la trésorerie et le rapprochement. Référence API consultée le 9 septembre 2026. Les sections « contrat HOLCO » décrivent la spécification de collecte et les critères de recette ; le catalogue effectif du compte se découvre via tools/list. ## API et accès La **Qonto Business API** utilise la base `https://thirdparty.qonto.com/v2`. Elle propose une authentification par clé API ou OAuth 2.0 selon le scénario. Un raccordement partenaire délégué doit préciser l’organisation consentante et les scopes demandés. Ne pas confondre les identifiants d’un compte bancaire avec ceux de l’organisation. [Introduction à l’authentification](https://docs.qonto.com/get-started/business-api/authentication/introduction). Cette fiche couvre les lectures de banque et de pièces. Le contrat HOLCO vise la trésorerie, les justificatifs manquants et le rapprochement comptable. Une capacité d’initiation de paiement constitue un contrat d’action séparé, avec des habilitations et validations propres. ## Organisation et comptes bancaires `GET /v2/organization` fournit l’organisation authentifiée et ses comptes. Collecter l’identité de l’organisation, les identifiants de comptes, les coordonnées bancaires et les informations de devise et de solde exposées. Les anciennes routes contenant le slug de l’organisation sont dépréciées ; utiliser la route singulière actuelle. [Organisation et comptes](https://docs.qonto.com/api-reference/business-api/accounts-organizations/organizations/retrieve-the-authenticated-organization-and-list-bank-accounts). Le contrat HOLCO distingue solde bancaire, solde tenant compte des opérations en attente et solde reconstitué sur une période. Afficher l’horodatage et la définition du solde utilisé. Un agrégat de plusieurs comptes nécessite une règle explicite de devise et de périmètre. ## Transactions et enrichissements `GET /v2/transactions` utilise notamment le scope `organization.read`. Sélectionner le compte par identifiant ou IBAN, puis le statut et la fenêtre temporelle. Le résultat comporte par défaut les opérations terminées ; demander explicitement les autres états si le cas d’usage en a besoin. Les filtres portent notamment sur `updated_at_from`, `updated_at_to`, `settled_at_from`, `settled_at_to`, `side` et les types d’opération. [Transactions](https://docs.qonto.com/api-reference/business-api/transactions-statements/transactions/list-transactions). Le modèle HOLCO vise l’identité du mouvement, le compte, le sens, le montant, la devise, le libellé, les dates et le statut. Les labels, détails de TVA et pièces sont des enrichissements reliés au mouvement. Conserver la TVA déclarée comme donnée source ; elle ne constitue pas à elle seule un contrôle fiscal de la facture. ## Pièces jointes et factures fournisseurs Les pièces peuvent être jointes à la lecture des transactions. Conserver leur identifiant durable ; leur URL signée de téléchargement expire après 30 minutes. Pour un téléchargement ultérieur, récupérer une nouvelle URL via `GET /v2/attachments/{id}`. Éviter de persister l’URL temporaire comme référence documentaire permanente. [Synchroniser transactions et pièces](https://docs.qonto.com/get-started/business-api/use-cases/sync-transactions). `GET /v2/supplier_invoices` permet de parcourir les factures fournisseurs. Relier la facture à son `attachment_id` lorsqu’il existe et récupérer la pièce correspondante. Le contrat HOLCO vise fournisseur, numéro, dates, montants, échéance et état présents dans la réponse, avec un lien de provenance distinct pour le PDF. Ne pas supposer que toutes les factures sont payées ni que chaque débit bancaire possède une facture. [Synchroniser les factures fournisseurs](https://docs.qonto.com/get-started/business-api/use-cases/sync-supplier-invoices). ## Pagination et quotas La pagination repose sur `page` et `per_page`, avec 100 éléments par défaut et au maximum. Suivre `meta.next_page` jusqu’à la fin pour les ressources utilisant ce contrat. Une liste vide sur un compte n’autorise pas à conclure que les autres comptes sont vides. [Pagination](https://docs.qonto.com/get-started/general/pagination). La documentation publie des plafonds de 1 000 requêtes par 10 secondes et 10 000 par 10 minutes. Le dépassement produit une réponse 429 ; une accumulation d’erreurs 401 peut également conduire à une limitation. L’adaptateur doit partager son budget entre tâches d’une même connexion et borner les reprises. Ces valeurs sont des limites éditeur, pas un engagement de débit HOLCO. [Rate limits](https://docs.qonto.com/get-started/general/rate-limitations). ## Webhooks et synchronisation incrémentale Qonto permet la création d’abonnements via `POST /v2/webhook_subscriptions`. Le scope `webhook` se combine avec les scopes requis pour les événements sélectionnés, par exemple `organization.read` pour les transactions. Le périmètre événementiel doit être choisi explicitement. [Abonnements webhook](https://docs.qonto.com/api-reference/business-api/webhooks/create-a-webhook-subscription). Le contrat cible HOLCO traite un événement comme un déclencheur de relecture de la ressource autorisée. Il exige validation de l’origine selon le contrat Qonto, déduplication, contrôle du périmètre, reprise après indisponibilité et réconciliation périodique par API. Ne pas faire dépendre l’exhaustivité du seul nombre de notifications reçues. ## Exemple de lecture éditeur ```http GET /v2/transactions?bank_account_id=COMPTE_DEMO&page=1&per_page=100 HTTP/1.1 Host: thirdparty.qonto.com Authorization: Bearer Accept: application/json ``` La requête illustre une lecture OAuth. Compléter la sélection de statuts et de dates selon le périmètre métier ; les valeurs d’exemple ne désignent aucun compte réel. ## Contrat HOLCO de rapprochement Conserver une clé composée de l’organisation, du compte et de l’identifiant de transaction. Reprendre les modifications avec une fenêtre de recouvrement, puis appliquer un upsert idempotent. Un mouvement en attente qui devient terminé doit mettre à jour la même identité lorsqu’elle est conservée par la source. Un changement de statut ne constitue pas une nouvelle recette. Le rapprochement avec Pennylane, Sage ou Cegid est une relation explicite : montant, devise, date, référence et pièce soutiennent une proposition de correspondance. Deux opérations de même montant ne suffisent pas à prouver un lien. Garder les correspondances ambiguës et les opérations sans pièce visibles dans la restitution. ## Recette technique Tester plusieurs comptes et pages, des mouvements en attente et terminés, une pièce absente, une URL expirée, un événement dupliqué, un consentement révoqué et une limitation 429. Comparer les variations de solde sur une fenêtre cohérente et conserver les différences de date de règlement. Les fichiers indexés doivent garder leur rattachement au compte et au dossier autorisés.