Skip to content
Last updated

French eInvoice - Service Activation (Organization Portal)

This guide describes the end-to-end portal flow used by an organization user to activate French eInvoice for a final customer.

The screenshots use the MASSON CONSULTING & FORMATION SAS partner organization and the final customer VIDAL SOLUTIONS INFORMATIQUES SAS.

Flow Summary

  1. Log in to the organization portal.
  2. Open the partner organization dashboard.
  3. Search the final customer.
  4. Create the final customer when it does not exist, using the correct French customer type.
  5. Create or reuse the legal representative as a private individual.
  6. Open contracts.
  7. Create an indirect contract and fill in the Service Activation Group (SAG) information.
  8. Add the French eInvoice contract item.
  9. Confirm the Service Activation Group (SAG).
  10. Verify the pending contract and contract item.

Prerequisites

  • The partner organization is selected in the left organization switcher.
  • A Distribution / resell contract is available for French eInvoice.
  • The final customer fiscal data is available: legal name, country, SIREN, SIRET, VAT, address, city, state, postal code, customer type, and email.
  • The legal representative or delegate data is available: full name, first name, last name, country, temporary SIREN (taxCode2), customer type, and email.
  • The Portail DT technical contact data is available when the service must collect it: email, first name, and last name.
  • The recipient email that will receive or complete the activation is known.

0. Login

Open the One Platform portal and log in with an organization user authorized to manage customers, contracts, and service activation.

One Platform organization portal login page

1. Open the Organization Dashboard

The home page confirms the active organization context and exposes the two menu areas used by this flow:

  • Consumers > Customers for final customers and legal representatives.
  • Business Assets > Contracts for contracts, contract items, and service activation.
One Platform organization dashboard

2. Search Customers

Open Consumers > Customers. Search by legal name, VAT, tax number, PA number, or another available identifier.

Use the customer list to avoid creating duplicates. In this example the first search returns no data.

Customers page with customer search

3. Create the Final Customer

Click Create customer and select the customer type that matches the French subject.

For the company flow shown here, select Corporate / Persona giuridica. The portal also exposes PrivateIndividual and ProfessionalIndividual; do not leave French customers in automatic or legacy Individual mode.

Fill in:

FieldExampleNotes
Legal nameVIDAL SOLUTIONS INFORMATIQUES SASOfficial company name.
CountryFRANCEFrench eInvoice requires a French customer.
Customer typeCorporateRequired for the final customer company.
SIREN573849262French company identifier; stored as taxCode2.
SIRET57384926200007Establishment identifier; stored as taxCode3.
VAT / TVAFR43573849262Intra-community VAT number; stored as taxCode1.
Emailcontact@vidal-solutions.frContact email.
BillableEnabledEnable this option to enter the customer's billing address.
Address12 RUE DES ARCHIVES, 75004 PARIS, ILE-DE-FRANCERegistered office address.
Custom datasiret_01 = 57384926200007Stored as additional metadata. You can add an arbitrary number of SIRET values using the siret_nn pattern, for example siret_01, siret_02, siret_03.
French tax code mapping

For French consumers, One Platform uses taxCode1 for the VAT / TVA number, taxCode2 for SIREN, and taxCode3 for SIRET.

When more than one identifier is provided, they must refer to the same SIREN: the first 9 digits of SIRET and the last 9 digits of TVA must match the SIREN.

When the final customer has multiple SIRET values, store the additional establishments in Custom data using composed keys with the siret_nn pattern, such as siret_01, siret_02, siret_03, and so on. taxCode3 contains the primary SIRET, while the custom data entries preserve the full SIRET list needed by the activation flow.

Create corporate customer form

After creation, the customer appears in the list with its type, tax codes, and country.

Customer search result after corporate customer creation

Open Details to verify the stored profile, tax details, billing details, contact information, and additional metadata.

Corporate customer detail page

The legal representative is also managed from Consumers > Customers, but the customer type is PrivateIndividual / Persona fisica privata.

Fill in:

FieldExampleNotes
Legal nameLaurent VidalFull display name.
First nameLaurentRequired for the person profile.
Last nameVidalRequired for the person profile.
CountryFRANCERepresentative country.
Customer typePrivateIndividualRequired by the v2 Organizations API for the representative in this flow.
Tax codeT0301KW15PGCJYHGWWYMJZGMK1MNHTemporary SIREN generated for this contract flow and stored as taxCode2. Do not send taxCode1 or taxCode3 for a French PrivateIndividual.
Emaillaurent.vidal@vidal-solutions.frRecipient or representative email.
Legal representative tax code

For the French eInvoice legal representative, the portal currently generates taxCode2 (temporary SIREN) as T03 followed by a ULID, for example T0301KW15PGCJYHGWWYMJZGMK1MNH.

Create individual legal representative form

After creation, both the corporate customer and the legal representative are available in the customer list.

Customer search result after legal representative creation

Open the legal representative detail page to verify type, country, tax details, residence information, and email.

Legal representative detail page

5. Open Contracts

Open Business Assets > Contracts. Use Issued contracts for contracts created by the selected partner organization.

Search the existing contracts before creating a new one.

Contracts list with issued contracts tab

6. Create the Contract

Click Create contract and create an Indirect contract.

FieldExampleNotes
Contract typeIndirectThe partner issues a final customer contract.
IssuerMASSON CONSULTING & FORMATION SASAuto-filled from the selected organization.
Start date2026-06-23Contract start date.
Contract numberVIDAL-FR-EINV-01Partner reference.
DescriptionFrench eInvoice activation - VIDAL SOLUTIONS INFORMATIQUES SASFree text.
SAG descriptionFrench eInvoice activation - VIDAL SOLUTIONS INFORMATIQUES SASDescription of the Service Activation Group created with the contract.
Resell contractDistribution (DF1234)Distribution contract used as source.
Legal representativeLaurent VidalPrivateIndividual created in the previous step.
Recipient's emaillaurent.vidal@vidal-solutions.frEmail used for the activation flow.
CustomerVIDAL SOLUTIONS INFORMATIQUES SASFinal customer.
Create new organizationOffEnable only when a customer-side organization must be created.
New indirect contract form
Delegate and technical contact

The contract can now carry the SAG activation information at creation time. You no longer need to open a separate action to update the SAG afterwards.

Use hasDelegate: true when the person involved in onboarding is a delegate rather than the legal representative. In the legal representative sub-screen, also fill in the technical contact with adminEmail, adminFirstName, and adminLastName only when the contract item includes the dt-portal feature.

The conditional rules are:

ConfigurationEffect in onboarding
hasDelegate disabled or absentThe person displayed and verified during onboarding is the legal representative.
hasDelegate: trueThe person displayed and verified during onboarding is a delegate. Labels and expected data must therefore match the delegate.
dt-portal feature selected in the contract itemadminEmail, adminFirstName, and adminLastName must be filled in to identify the Portail DT administrator.
dt-portal feature not selectedPortail DT administrator data is not required.

When hasDelegate is enabled, verify that the onboarding data correctly identifies the delegated person.

Delegate configuration for onboarding

If the dt-portal feature is present in the contract item, fill in the technical contact who will use the Portail DT, for example Camille Martin with camille.martin@vidal-solutions.fr. If dt-portal is not selected, these fields are not required.

Portail DT technical contact configuration

7. Add the French eInvoice Item

From the contract detail page, click Add item. The wizard is split into five steps.

Step 1 - Item Category

Select the available resell contract item. In the example the item is Fatturazione elettronica francese 1089000001.

New contract item step 1 item category

Step 2 - Features

Select the required service features. The French eInvoice SKU (1089000001) enables the core B2B and eReporting capabilities by default, and lets you add optional portal, editor, identification, and mandate capabilities when needed.

Feature IDEnglish labelItalian labelFrench labelDefaultNotes
out-b2bOut-B2B DomesticFatturazione attiva B2BFacturation electronique sortante B2B domestiqueYesEnables outgoing domestic B2B e-invoicing.
in-b2bIn B2BFatturazione passiva B2BFacturation electronique entrante B2BYesEnables incoming B2B e-invoicing.
e-reportingeReportingReportistica elettronicaDeclaration electroniqueYesEnables electronic reporting.
dt-portalPortal DTPortale DTPortail DTNoRequires at least one of in-b2b, out-b2b, or e-reporting.
editorEditorEditorEditeurNoRequires dt-portal.
identificationKYC/KYBKYC/KYBKYC/KYBNoRequires dt-portal.
multiple-mandateMultiple mandateMandato multiploMandat multipleNoRequires in-b2b.

The default feature set is:

  • out-b2b
  • in-b2b
  • e-reporting

Feature dependencies:

enables

enables

enables

required by

required by

required by

out-b2b
Out-B2B Domestic

in-b2b
In B2B

e-reporting
eReporting

dt-portal
Portal DT

editor
Editor

identification
KYC/KYB

multiple-mandate
Multiple mandate

dt-portal has an Any dependency rule: it can be selected when at least one among out-b2b, in-b2b, and e-reporting is selected. editor and identification require dt-portal; multiple-mandate requires in-b2b.

New contract item step 2 features

Step 3 - Item Details

Confirm the customer and set the item start date. The end date can be left empty when the item has no planned end.

New contract item step 3 item details

Step 4 - SKU Parameters

Set item-level activation flags and SKU parameters.

ControlMeaning
Already signedEnable only when the contract item is already signed outside the platform.
Already provisionedEnable only when provisioning has already been completed outside the platform.
SKU parametersOptional structured parameters required by the selected SKU or feature set.
New contract item step 4 SKU parameters

Step 5 - Create

The success screen confirms that the contract item has been created.

New contract item success screen

8. Confirm the SAG

Click Contract Confirmation. The portal asks for confirmation before allowing the recipient to view the contract and fill in any missing fields.

Confirm the action to move the contract out of Draft.

Confirm Service Activation Group

After confirmation, the contract can be Pending while data completion or provisioning is still required.

Pending contract detail page

The contract remains Pending until the recipient completes the required activation information and downstream provisioning finishes. The Completed status therefore belongs to the recipient/provisioning phase and is not produced by the organization-side steps in this guide.

9. Verify the Contract Item

Open the item details to verify:

  • customer and duration;
  • active features;
  • SKU parameters;
  • onboarding documents, when generated.

At this stage, the example item is Pending and contains the selected features Out-B2B Domestic, In B2B, and eReporting.

Pending French eInvoice contract item details