Skip to main content

Set up and test eInvoicing (France)

This page covers the prerequisites for eInvoicing in the French (FR) market, how to enable it in the fiskaltrust.Portal, and how to validate the flow against a sandbox before production. For scope, regulatory status, and the delivery flow, see the Overview.

What setup means in France

eInvoicing rides on calls you already make. Setup is about configuration — the output format and the fiskaltrust.Middleware's French locale. Delivery via /issue to the merchant's Plateforme Agréée is optional. There is no new connection or credential.

Prerequisites​

RequirementDetail
fiskaltrust account + fiskaltrust.MiddlewareAn active account with a configured fiskaltrust.Middleware. See Portal registration.
Existing fiscalization integrationYour POS already fiscalizes in France via /sign.
fiskaltrust.Middleware country configurationThe fiskaltrust.Middleware's country configuration is set to the French locale.
PosSystem API (v2)eInvoicing features are exposed through the PosSystem API (v2). If you are on the v0 interface, plan your migration first.
Merchant's Plateforme AgrééeConfirm the merchant has, or is choosing, a Plateforme Agréée — nothing else matters until this is settled.
Default output formatDecide the default: UBL or CII for platform routing, Factur-X as a bridge where needed.

Enable eInvoicing in the Portal​

eInvoicing is enabled by configuration: the output format (UBL / CII / Factur-X) and the fiskaltrust.Middleware's French locale. No new integration is required on the POS side.

Draft — Portal steps to be confirmed

The exact steps to enable eInvoicing in the fiskaltrust.Portal (output-format configuration, French locale) are being verified and will be documented here. Do not treat this section as final until the flow has been confirmed.

Sandbox validation​

Validate the end-to-end flow against a sandbox-scoped fiskaltrust.Middleware — using non-production x-cashbox-id and x-cashbox-accesstoken credentials — before enabling it on a production fiskaltrust.Middleware. Run one document through the sandbox end to end before the first live document.

  1. Provision a sandbox fiskaltrust.Middleware in the fiskaltrust.Portal — this yields the x-cashbox-id and x-cashbox-accesstoken used on every request. See Portal registration.
  2. Confirm your integration against the Integration checklist.
  3. Run one invoice through the full flow below: /sign → (optionally) /issue → poll for delivery status.

End-to-end example​

Run it against the sandbox at https://possystem-api-sandbox.fiskaltrust.eu/v2. The API is request/response and idempotent — there is no status webhook; the x-operation-id header is the idempotency key that makes retries safe. Every request carries the standard headers:

x-cashbox-id: <sandbox fiskaltrust.Middleware ID>
x-cashbox-accesstoken: <sandbox access token>
x-possystem-id: <registered POS system ID>
x-operation-id: <fresh UUID per operation>

Step 1 — Sign (/sign) — produces the eInvoice

Call /sign as you do today, with the buyer's master data, using the B2B invoice receipt case. The response carries the fiscalized receipt and the EN 16931 document (UBL, CII, or Factur-X, per your fiskaltrust.Middleware configuration).

// POST https://possystem-api-sandbox.fiskaltrust.eu/v2/sign
{
  "ftReceiptCase": 35184372092930,
  "cbReceiptReference": "FR-EINV-SANDBOX-0001",
  "cbReceiptMoment": "2026-09-01T10:00:00Z",
  "cbCustomer": {
    "CustomerVATId": "FR12345678901",
    "CustomerName": "Exemple SARL",
    "CustomerStreet": "1 Rue de l'Exemple",
    "CustomerZip": "75001",
    "CustomerCity": "Paris",
    "CustomerCountry": "FR"
  },
  "cbChargeItems": [
    { "Quantity": 1, "Description": "Consulting services", "Amount": 1200.00, "VATRate": 20, "ftChargeItemCase": 35184372088851 }
  ],
  "cbPayItems": [
    { "Description": "Bank transfer", "Amount": 1200.00, "ftPayItemCase": 35184372088842 }
  ]
}

Try it: developer.fiskaltrust.eu → FR → sign → B2BInvoice. The output format (UBL / CII / Factur-X) comes from the fiskaltrust.Middleware configuration, not this payload — see Enable eInvoicing in the Portal. For French buyers, include the SIRET in the buyer master data.

Step 2 — Issue (/issue) — optional, register for delivery

To make the receipt available for delivery, call /issue with the original /sign request and its response (ReceiptRequest + ReceiptResponse). The response returns the ftQueueID / ftQueueItemID used by the delivery and status calls.

// POST https://possystem-api-sandbox.fiskaltrust.eu/v2/issue
{
  "ReceiptRequest":  { "...": "the /sign request from Step 1" },
  "ReceiptResponse": { "...": "the /sign response from Step 1" }
}

Try it: developer.fiskaltrust.eu → FR → issue.

Step 3 — Deliver to a channel — optional

Deliver the document with PUT /issue/{queueId}/{queueItemId}, choosing a delivery method: IssueUpdateSend (email/SMS), IssueUpdatePrint, IssueUpdateDownload, IssueUpdateUpload, or IssueUpdateLink. Delivery to the merchant's Plateforme Agréée uses one of the upload/send methods — confirm the exact delivery target with product.

Step 4 — Check delivery status

Poll GET /issue/{queueId}/{queueItemId} for the status until it reports delivered. There is no callback or webhook.

See the POS System API reference for the full /issue request/response schemas.