Test Environment

France is currently available in the xTool test environment. It is connected to the official French qualification (QAS) infrastructure, so you can run end-to-end tests: register your company in the test Annuaire, then send and receive invoices through the same path that production will use — without touching real SIREN/SIRET numbers or the live directory.

Registration below is the first step of that flow. Once your address is active in QAS, you can exchange test invoices with counterparties that are also registered in the qualification environment.

Why you need QAS test numbers

The French tax administration does not allow real SIREN or SIRET numbers in the qualification environment. Real company identifiers belong to the live Annuaire and must not be used for testing.

Instead, Chorus Pro QAS provides fictitious SIREN/SIRET numbers that already exist in the test Annuaire. You use those numbers when registering in xTool. Without them you cannot complete registration, and you cannot send or receive test invoices against QAS.

Get test SIREN / SIRET numbers

1. Go to qualif.chorus-pro.gouv.fr → Entreprise (Company) → Créer mon compte (Create my account).
   Use a real email address — Chorus Pro sends the registration confirmation and password setup link to it.
2. Open the Initialisation de mot de passe Chorus Pro email (password setup) and set your password. The link is valid for about 60 minutes.
3. Sign in → Domaines (Domains) → Matelas de données (data set) → Générer un matelas de données (Generate a data set) and confirm.
4. Open Consultation du matelas de données (View data set). Wait until both statuses show Disponible (Available):
5. Statut pour Chorus Pro (status for Chorus Pro)
6. Statut pour l’annuaire de facturation PPF (status for the PPF invoicing directory)
   This usually takes a few minutes. Refresh the page if needed.
7. Click Générer et télécharger le fichier CSV du matelas structures et utilisateurs (Generate and download the CSV of structures and users).

Choosing identifiers from the CSV

Near the end of the file you will find SIREN rows similar to this (examples only — use the numbers from your CSV):

1
2
3
4

119000001;SIREN;SIREN_119000001;siren;Privée;
256000002;SIREN;SIREN_256000002;siren;Privée;
346000003;SIREN;SIREN_346000003;siren;Privée;
419000004;SIREN;SIREN_419000004;siren;Privée;

The first column is the SIREN (9 digits). Use only rows marked Privée (private sector). Public entries are not valid for this registration.

To test both sending and receiving, register two different SIRENs in xTool as two companies. Then send a test invoice from one company to the other — both must be registered in the QAS Annuaire.

• Use the SIREN value from the first column when registering in xTool.
• Do not invent random numbers — only identifiers from this CSV work reliably in the test Annuaire.

Register in xTool

1. Sign in to the xTool test environment and select your organisation.
2. Open Channels → France.
3. Click Add configuration.

Fields to fill in

Company details (some fields may be prefilled from your organisation):

• Company name
• Address, city, ZIP code
• Province (optional)
• Tax contact email

Electronic address

In the test environment, use SIREN only (9 digits from your CSV). Other address types (SIRET, suffix, routing code) are not supported for testing yet.

Tax settings

Start date — tomorrow or a later date (today is not allowed). This is an Annuaire requirement: the directory needs time to publish the address (often up to about 24 hours), so activation cannot start on the same day as registration. Tax reporting and activation follow the date you choose.

Tax report mode

For send-and-receive tests between two companies, choose Full for both.

The following fields are required in Full mode:

Operation type — main activity of the company for tax reporting:

Pick what best matches the company you are simulating. For a generic test, Services is a common choice.

NAF code — first 2 digits of the French NAF/APE activity code (Nomenclature d’activités française). On a real company this appears on the Kbis extract or on sirene.fr. In the test environment any valid 2-digit section is fine (for example 62 for IT / software).

Enterprise size — company size category (INSEE-style). Choose the closest fit for your test company:

VAT regime — how the company reports VAT. For testing, Réel normal (mensuel / décades) is a safe default.

Then submit the form.

What to expect after submit

Publication in the Annuaire is handled by the French tax administration. It is not instant.

The start date must be at least the next day. The Annuaire requires this delay: registration is submitted today, directory publication can take up to about 24 hours, and activation only begins on the date you chose.

What you should plan for

• Choose a start date of tomorrow or later — this is required by the Annuaire process, not optional.
• After submitting, status often stays on Directory pending. Plan to check again the next day.
• You can click Refresh status on the configuration at any time.
• Once the directory confirms the address and the start date is still in the future, status becomes Scheduled.
• On or after the start date, status becomes Active.

You can also look up the address in the QAS Annuaire: qas.facturation.chorus-pro.gouv.fr/annuaire.

Quick checklist

1. Download a QAS matelas and pick Privée SIREN values (register two if you want to test send and receive).
2. In xTool test, open Channels → France and add a configuration.
3. Enter company details, identifiers, mode, and a start date of tomorrow or later.
4. Wait for Annuaire publication (often until the next day); refresh status if needed.
5. Confirm Scheduled, then Active once the start date is reached.

See also France e-invoicing.