Is Heartwood a plateforme agréée?

No. Heartwood is not a plateforme agréée (the accredited invoicing platform status defined by French law since the 2026 finance law) and will not become one. It never transmits an invoice, routes nothing, and has no fiscal role. Connecting to a plateforme agréée remains indispensable and separate.

Which compliance profile is applied by default?

The EXTENDED-CTC-FR profile (AFNOR standard XP Z12-012) is applied by default to all validations. You can obtain EN 16931 by adding the ?profile=EN16931 parameter to your request.

Do I need an account to use the public validator?

No. The public validator is free, with no signup and no credit card. An anti-abuse cap applies: 10 documents per IP address and per day. Not to be confused with the Découverte tier, which requires a key and allows 20 documents per month.

What happens to documents sent to the API?

No document is ever written to disk: processing happens entirely in memory. One exception to know: if you send the Idempotency-Key header, the response is kept for 24 hours so it can be replayed identically, and that response contains the document for calls that produce one. Not sending that header is enough to guarantee nothing persists. Beyond that, only the usage log is kept: a SHA-256 fingerprint, never the content. Details at /en/docs/politique-conservation.md.

Your compliant electronic invoices, one HTTP call away

Generate, validate, convert and read Factur-X, UBL 2.1 and CII invoices — the three formats of the French core standard, compliant with the EXTENDED CTC-FR profile (AFNOR standard XP Z12-012), itself based on the European standard EN 16931. A REST API, not weeks of XML specifications to decode.

Read the documentation Try without an account

Two deadlines, two needs

Receiving — mandatory from 1 September 2026

All French companies liable for VAT must be able to receive structured electronic invoices, regardless of their size. Receiving means reading and checking — two operations that require no plateforme agréée (the legally defined status for France's government-accredited invoicing platforms) status at all.

POST /v1/extract — a Factur-X, a CII or a UBL document goes in, a normalized JSON comes out. The format is detected automatically.
POST /v1/validate — compliance checked against the official rules, each violation cited by its BR-* code for precise feedback to the supplier.

Issuing — 1 September 2027 for SMEs and micro-businesses

From 1 September 2026, large companies and mid-caps (ETI) will have to issue structured, compliant invoices. From 1 September 2027, SMEs, micro-businesses and sole traders will have to do the same. If your software issues invoices, it will have to produce compliant structured documents.

POST /v1/generate/facturx — an invoice JSON goes in, a PDF/A-3 with an embedded CII comes out.
POST /v1/generate/ubl — UBL 2.1, fr-socle and peppol-bis variants.
POST /v1/convert — CII ↔ UBL, CII → Factur-X packaging.

Get started without asking us for anything

The public validator is free, with no signup and no credit card. Upload an invoice, and you get a compliance report citing the official rules applied.

curl -X POST "https://heartwood.canopee.digital/public/v1/validate" \
  --data-binary @ma-facture.xml

Documents up to 20 MB. The EXTENDED-CTC-FR profile (mandatory in France) is applied by default; get EN 16931 by adding ?profile=EN16931. Anti-abuse cap with no account required: 10 documents per day and per IP address. For regular use, a free API key lifts this limit.

What the compliance claim rests on

Validation is not a homemade heuristic: it runs the official FNFE-MPE rule packs — compiled XSD schemas and schematrons from the French reference repository.

EXTENDED-CTC-FR profile (AFNOR standard XP Z12-012) and EN 16931 profile (the underlying European standard) — the two profiles of the French minimum core standard.
BR-* rules actually executed, in both CII and UBL — not just schema validation.
Versioned rule packs: every response indicates which one was applied. A compliance verdict without a dated reference repository is worthless.

OpenAPI specification Getting started guide

Where Heartwood works across Europe

Heartwood is no longer limited to France: it generates and validates electronic invoices across several European markets — with a strict distinction between what is validated against official rules and what is only generated.

France — generation and validation

Factur-X (CII) and UBL are generated and validated against the official FNFE-MPE rule packs, in the EN 16931 and EXTENDED-CTC-FR profiles.

Belgium — Peppol generation and validation

B2B electronic invoicing has been mandatory in Belgium since 1 January 2026, via the Peppol network. Heartwood generates and validates Peppol BIS Billing 3.0 invoices (ubl-peppol-bis-3.0.20 rule pack, PEPPOL-EN16931-R* rules actually executed).

Heartwood is not a Peppol access point: it never transmits anything on the network. Connecting to a Peppol access point remains indispensable and separate.

Germany — XRechnung generated, not validated

Germany has required receiving structured electronic invoices since 2025, and will require issuing them from 2027 for companies with more than €800,000 in revenue, then from 2028 for all companies. Heartwood generates XRechnung (UBL) and reads hybrid ZUGFeRD PDFs on extraction.

No validation against Germany's national rules: with no official schematron integrated yet, this is not an XRechnung certification.

Peppol details for Belgium · XRechnung details for Germany

What Heartwood is not

Not a plateforme agréée

Heartwood is not a plateforme agréée — the term the French tax administration uses since the 2026 finance law for the government-accredited platforms that will carry e-invoices — and will not become one. It never transmits an invoice, routes nothing, and has no fiscal role. Connecting to a plateforme agréée remains indispensable and separate.

That is also what makes it usable right away: no third-party account to open, no KYC, no network onboarding. You call an API, you get a compliant document. Useful during development, to check before sending, to read received invoices, or to convert historical data.

Pricing

Heartwood tiers and pricing
Tier	Documents included / month	Price
Découverte	20 (hard cap)	Free
Starter	200	€29/month
Pro	1 000	€79/month
Éditeur	5 000	€199/month

Beyond the included volume: on the Découverte tier, calls are refused until the following month. On a paid tier, they keep being processed and the extra documents are billed by usage — your integration never stops overnight. Your account dashboard shows your usage in real time, key by key.

Self-service signup and subscription, by credit card. Cancel any time from your account dashboard. No sales contact required — neither to start nor to leave.

Create a free key Tier details