French Invoicing API
These APIs are currently in Beta. Please note that some features are not yet available as they are under active development.
Welcome to the official A-Cube documentation dedicated to the French market.
As an accredited platform (Plateforme Agréée), A-Cube stands as the ideal intermediary to guide your business and your customers through the complexities of the digital transition in France. We have designed this suite of APIs to offer you native, end-to-end coverage, capable of seamlessly and automatically managing every single stage of the invoice lifecycle and all compliance requirements related to E-Reporting.
Integrating with our services will allow you to govern the entire process through four fundamental macro-stages:
- Company Creation: The initial registration and configuration of Legal Entities within the A-Cube context.
- KYC and Claim on the Annuaire: The guided KYB/KYC verification workflow for customer identification and the subsequent official association of A-Cube as the authorized intermediary in the French Central Directory (Annuaire central).
- Invoice Issuance and Reception: The complete management of outbound and inbound invoicing, both for the French domestic market (supporting CII, UBL, and Factur-X formats) and for international transactions.
- E-Reporting: The electronic transmission of sales and payment data for all operations excluded from the standard B2B electronic invoicing mandate.
To get started:
- Register on [A-Cube API Platform] (https://www.acubeapi.com/) to get your username and password for the authentication
- Get a valid token, see here
- Onboard the company (
LegalEntity), see here - Prepare and send a new document, see here
- Receive the
uuididentifier for the newly created document as response and store it - Receive information about the delivery to your configured webhook, match against the previously stored identifier.
Environments
- sandbox is the environment where you can test the entire platform without paying at any time. The base URL is https://fr-sandbox.api.acubeapi.com
- production is the environment where documents exchange happens. The base URL is https://fr.api.acubeapi.com
Authentication
You can find all the information about the authentication here.
API orchestration and webhooks
You can configure via API your webhooks where to receive information in real-time, as soon as an event happens.
A-Cube France API supports three types of events:
legal_entity.onboardingit is dispatched to inform your webhook about a legal Entity onboarding statusinvoice.inboundit is dispatched when an incoming document has been delivered to your accountinvoice.outboundit is dispatched when a new document is deliveredinvoice.statusis dispatched when an AFNOR status update is received for both inbound and outbound invoices.
You can find more information about webhooks here.