Qonto
Statut : Disponible. Le plugin actuel livre un connecteur Qonto pour les capacités implémentées ci-dessous. Ce statut ne signifie pas que toutes les fonctionnalités de l’API Qonto sont supportées.
Capacités implémentées
| Capacité | Statut | Comportement |
|---|---|---|
| Test de connexion | Disponible | validation du bearer OAuth, contrôle de l’organisation et de l’état e-invoicing |
| Import Factur-X | Disponible | importe le Factur-X figé via l’import en masse des factures clients Qonto |
| Envoi e-invoice | Disponible en production | demande l’envoi de la facture client importée via l’opération e-invoicing Qonto |
| Suivi du cycle de vie | Disponible en production | relit la facture client et normalise les statuts supportés |
L’envoi sur le réseau e-invoicing Qonto et le suivi du cycle de vie sont réservés à la production dans le connecteur actuel. La sandbox sert à valider sans risque la connexion et l’import ; elle ne doit pas être assimilée à un environnement complet d’envoi réseau.
Credentials et permissions
Le plugin référence un token d’accès OAuth stocké hors de sa configuration. Lorsque le traitement doit être autonome, l’application hôte reste responsable du stockage sécurisé et de la rotation du refresh token OAuth.
Le flux implémenté utilise selon l’opération des permissions fournisseur telles que organization.read, einvoicing.read, client_invoice.write et client_invoices.read.
sylius_invoice:
platform:
active: qonto
environment: SANDBOX
organization_id: '%env(QONTO_ORGANIZATION_ID)%'
credentials:
oauth_access_token: QONTO_OAUTH_ACCESS_TOKEN
staging_token: QONTO_STAGING_TOKEN
transmission:
mode: MANUAL
Les valeurs des credentials doivent rester dans le gestionnaire de secrets du déploiement, pas dans ce fichier YAML.
Limite opérationnelle
Le connecteur importe et transmet le document déjà validé et figé. Il ne décide pas si le marchand ou la transaction est juridiquement éligible au flux Qonto/e-invoicing sélectionné. L’onboarding Qonto, les permissions fournisseur et les obligations réglementaires du marchand restent des prérequis externes.
Les détails canoniques d’implémentation sont maintenus dans invoice-plugin/docs/qonto-connector.md et doivent être relus lors d’une mise à niveau du connecteur.