VAVANG INVOICE / DOCS / EN

Qonto

Status: Available. The current plugin ships a Qonto connector for the implemented capabilities below. This status does not imply support for every Qonto API feature.

Implemented capabilities

Capability Status Behavior
Connection test Available OAuth bearer validation, organization check and e-invoicing readiness check
Factur-X import Available imports the frozen Factur-X through Qonto client-invoice bulk import
E-invoice send Available in production sends the imported client invoice through Qonto's e-invoicing operation
Lifecycle tracking Available in production polls the client invoice and normalizes supported lifecycle statuses

Qonto's e-invoicing network send and lifecycle tracking are production-only in the current connector. Sandbox is used for safe connection/import validation and must not be interpreted as a full network-send environment.

Credentials and scopes

The plugin references an OAuth access token stored outside plugin configuration. The host application remains responsible for secure OAuth refresh-token storage and rotation when unattended processing is required.

The implemented flow uses provider permissions including organization.read, einvoicing.read, client_invoice.write and client_invoices.read according to the operation.

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

Credential values belong in the deployment secret store, not in this YAML file.

Operational boundary

The connector imports and sends the already validated/frozen document. It does not decide whether the merchant or transaction is legally eligible for the selected Qonto/e-invoicing flow. Qonto onboarding, provider permissions and the merchant's regulatory obligations remain external prerequisites.

The canonical implementation details are maintained in invoice-plugin/docs/qonto-connector.md and should be reviewed when upgrading the connector.