Documentation

Qonto — banque et facturation électronique

Ce guide décrit la connexion de asso-services au compte Qonto de l’association : pointage des opérations et factures électroniques.

Prérequis côté Qonto (à faire une fois)

1. Compte association sur Qonto (ou sandbox développeur).
2. Clé API : Qonto → Intégrations et partenariats → Clé API → noter le login et le secret.

- Doc : API key

1. (Optionnel) Application OAuth sur developers.qonto.com si vous utilisez le flux OAuth :

- Copier `src/config/qonto.config.local.php.example` → `qonto.config.local.php` - Renseigner `oauthclientid`, `oauthclientsecret`, éventuel `stagingtoken` - Redirect URI : `https://VOTREDOMAINE/treasury/qonto/oauth/callback` - `public_url` HTTPS dans `app.config.local.php`

1. E-facturation dans Qonto :

- Émission : SIREN, adresse de facturation, statut PA - Réception : demande d’activation (peut rester en cours quelques jours) — statut API `receivingstatus` = `pendingcreation` puis `enabled`

Accès dans asso-services

Menu Comptabilité → Qonto (droit Configurer et synchroniser Qonto).

Sur cette page, le bloc Facturation électronique affiche les statuts Émission / Réception lorsque l’API le permet.

Configuration

1. Cochez Activer l’intégration Qonto
2. Saisissez login + secret API
3. Optionnel : ID de compte bancaire ou IBAN (sinon le premier compte Qonto est utilisé)
4. Enregistrer, puis Synchroniser les transactions

Pointage

Page Pointage :

• Importe les mouvements bancaires Qonto
• Propose un rapprochement avec les mouvements de trésorerie (montant + date ±7 jours)
• Auto-pointer : lie automatiquement les cas uniques
• Créer un mouvement : crée une entrée/sortie « passé en banque » depuis Qonto
• Un pointage réussi peut cocher Passé en banque sur le mouvement lié (écriture 512)

Factures électroniques émises

Sur une facture émise (module Facturation) :

1. Bouton Envoyer via Qonto (e-facture)
2. asso-services tente d’abord l’import PDF (`POST /v2/client_invoices/bulk`) — à terme, préférer un PDF Factur-X pour conserver le XML
3. En secours : création structurée de la facture dans Qonto (Factur-X généré par Qonto)
4. Envoi réseau : `POST .../sendbyeinvoice`
5. Actualiser le statut pour suivre le cycle de vie (`GET /v2/client_invoices/{id}`)

Le destinataire doit être joignable sur le réseau (`einvoicingreachable`).

Factures fournisseurs reçues

Page Comptabilité → Qonto → Factures fournisseurs :

1. Attendre que Qonto valide la réception (`receiving_status` = activée)
2. Synchroniser pour importer les factures reçues via Qonto (Plateforme Agréée)
3. En régime patrimonial : créer une écriture d’engagement (compte de charge + 401)
4. Lier paiement : rattacher un débit Qonto non pointé au même montant (marque la transaction comme pointée)

Si la sync échoue alors que la demande est encore en cours, le message indique clairement que la réception n’est pas encore active — ce n’est pas un bug asso-services.

Checklist jour J (dès validation Qonto)

1. Déployer le package à jour si besoin
2. Comptabilité → Qonto : vérifier le statut Réception (si visible)
3. Factures fournisseurs → Synchroniser
4. Vérifier qu’au moins une facture apparaît
5. Si régime patrimonial : Créer engagement (charge + 401)
6. Après paiement bancaire : Lier paiement au débit Qonto
7. Contrôler le journal / le pointage

API utilisées

Référence : docs.qonto.com