New France e-invoicing mandate goes live September 2026 — our implementation is ready. See all mandates →
E-Invoicing

Country fields and behaviour

The send endpoint, statuses, reasons and webhooks are the same in every country. For most countries you send the same payload and nothing else. This page lists the few exceptions, and says for each whether the field is required or only an optional override of a default you set once in Setup and master data (entity defaults, customer references, credentials).

CountryRequired to sendOptional overrides
ItalyEntity Regime Fiscale (set once).countryData.it.*: recipient code and PEC. Looked up if omitted.
PolandKSeF token (set once). Supplier and customer NIP, taken from taxId. On a correction, originalInvoiceRef.countrySpecific.pl.* NIP overrides, GTU codes. Split payment is required only for Annex 15 transactions over PLN 15,000.
GermanyFor XRechnung, an electronic address for both parties (taken from stored data). For public-sector customers, the Leitweg-ID. Sending over Peppol: see Peppol countries.countrySpecific.de.invoiceFormat: overrides the customer and entity defaults. leitwegId: overrides the stored one.
FranceRegistered VAT number and platform connection (set once).None on the request.
PortugalAT credentials (set once).None on the request.
GreeceAADE credentials (set once).None on the request.
Peppol countriescustomer.electronicAddress for NL, SK, AT, IS, NZ, AE, CH. Derived from taxId elsewhere.None.
MexicoReceive-only: no send. Choose an ingestion mode (set once).None.

To check which countries and mandates are covered, and their status (live, beta, coming_soon, not_supported or no_mandate), call GET /v1/coverage. It needs no API key, and each entry carries the mandate go-live date where it is confirmed (goLiveDate, otherwise null). A country that is not listed has no confirmed status yet. A 503 with code COVERAGE_UNAVAILABLE is temporary and safe to retry. The same list is the list_country_coverage MCP tool, client.listCountryCoverage() in the SDK and clearvo coverage in the CLI.

Behaviour that is the same everywhere (statuses and reasons, polling, receiving invoices, attachments) is in the main E-Invoicing page, not repeated here.

Country

Italy

Italian invoices go through the SDI. Set the entity's Regime Fiscale once (set-up); the optional countryData.it fields are in Country-specific fields.

The reason UNDELIVERED (status WAITING_FOR_PLATFORM) means the SDI accepted the invoice but could not deliver it. The SDI retries for 10 days, exposed as mcDeadline. After that the invoice is still legally valid, but tell the customer by other means. Do not void and reissue: the SDI rejects duplicate numbers.

Country

Poland

Register the KSeF token once (set-up). Send with country: "PL" and the NIPs as taxId with the PL prefix. An invalid NIP, or a supplier NIP that does not match the registered credentials (NIP_MISMATCH), is stored as a rejection without contacting KSeF.

An accepted invoice returns ksefNumber, upoAvailable and clearedAt. Put the ksefNumber on the invoice PDF you give your customer; Clearvo stores the UPO (keep it 10 years).

For a correction send documentType: "credit_note" with originalInvoiceRef; the correction type is set for you. If the original is not stored in Clearvo, add originalInvoiceRef.ksefNumber.

Country

Germany

Germany has no clearance step: XRechnung and ZUGFeRD are COMPLETED as soon as they are generated, and Peppol goes PENDING then COMPLETED on delivery. Nothing about format is required on the request. The format is resolved in this order, and the response reports it in documentFormat and formatResolvedFrom:

  1. countrySpecific.de.invoiceFormat on the request (optional override: ZUGFERD, XRECHNUNG or PEPPOL)
  2. The customer's stored format
  3. The entity's defaultDeInvoiceFormat (entity defaults)
  4. The platform default, ZUGFERD

Set the default once and you never need the field. When the format is PEPPOL the Peppol rules apply, exactly as for any other country: see Peppol countries. What is genuinely needed for the other formats:

  • Leitweg-ID for public-sector invoices: countrySpecific.de.leitwegId, the top-level buyerReference, or the LEITWEG_ID stored on the customer, in that order.
  • An electronic address for both parties on XRechnung: the one you send, else a stored Peppol ID, Leitweg-ID, contact email or German VAT ID. If none exists the invoice is blocked with MISSING_CUSTOMER_ELECTRONIC_ADDRESS or MISSING_SUPPLIER_ELECTRONIC_ADDRESS.
Country

France

Send French invoices like any other country. Register the VAT number and connect the company once (set-up); sales to consumers and to businesses outside France are e-reporting, see E-Reporting: France.

Record the buyer's decision on a received invoice with PATCH /v1/invoices/{id}/business-status; the allowed next steps are in the invoice's businessStatusActions. For an invoice you issued, your customer's decisions sync automatically; the one you record yourself is PAYMENT_RECEIVED.

StatusNeeds
APPROVED, PAYMENT_SENT, other next stepsNo reason.
PARTIALLY_APPROVED, DISPUTED, REFUSEDA reason in rejectionDetail.
SUSPENDEDA code in rejectionDetail.reason: JUSTIF_ABS, SIRET_ERR, COORD_BANC_ERR, CMD_ERR or REF_CT_ABSENT.

If the connection is unusable the call answers 422 (FR_PLATFORM_ACTIVATION_PENDING, FR_PLATFORM_NOT_CONNECTED or FR_PLATFORM_RECONNECT_REQUIRED), and 502 if the network refuses the decision; the status does not change in either case. A reference matching several documents gives 409 AMBIGUOUS_REFERENCE: use the Clearvo id.

Country

Portugal

Clearvo issues Portuguese documents (hash chain, ATCUD, QR) and returns COMPLETED immediately. Set the AT credentials once (set-up); the request has no extra fields. documentType invoice, credit_note or debit_note is issued as FT, NC or ND.

The communication to AT is tracked separately in ptReportingDetail and the webhooks invoice.reported and invoice.report_rejected; a rejection does not change the issued document. The monthly SAF-T is GET /v1/pt/saft?period=2026-08 (add format=summary for a JSON manifest). See also E-Reporting: Portugal.

Country

Greece

Greece reports to AADE after the invoice is issued. Register the credentials once (credentials) and send normally. AADE's registration mark returns as referenceId; print it on the invoice. If AADE is unavailable the invoice stays PENDING and is retried. Tax codes map to myDATA categories:

RateTax codemyDATA vatCategory
24%S1
13%AA2
6%AB3
0% exemptE4
0% zero-ratedZ5
0% reverse chargeAE7
Country

Peppol countries

Your payload is the same as for any country; Clearvo finds the customer's Access Point and delivers over AS4. The only input that varies is the customer's Peppol ID: send customer.electronicAddress (value with schemeId), or let Clearvo derive it from customer.taxId where that is reliable. For countries marked Explicit below, always send it.

CountryEAS Scheme IDIdentifier formatExampleResolution
BE0208KBO/BCE company number0208:0420429272Auto
DK0184CVR number (with DK prefix)0184:DK12345678Auto
NO0192Organisation number0192:123456789Auto
FI0216OVT code (0037 followed by the 8-digit business ID)0216:003712345678Auto
SE0007Organisation number0007:1234567890Auto
HR9934Croatian VAT number (HR prefix plus 11-digit OIB)9934:HR12345678901Auto
IE9935VAT number (with IE prefix)9935:IE1234567AAuto
LU9938VAT number (with LU prefix)9938:LU12345678Auto
SI9949VAT number (with SI prefix)9949:SI12345678Auto
EE0191Registrikood0191:12345678Auto
LV0218Unified registration number0218:12345678901Auto
LT0200LIS company code0200:123456789Auto
AU0151ABN0151:51824753556Auto
JP0221IIN0221:T1234567890123Auto
SG0195UEN0195:200000177WAuto
NL0106KvK number (without NL prefix)0106:37340183Explicit
SK9950Slovakia VAT number (the official list also has 0245 for the DIČ tax ID)—Explicit
AT9914 / 99159914: Austrian VAT number (UID). 9915: public-administration identifier (Verwaltungskennzeichen)9914:ATU12345678Explicit
IS0196Kennitala0196:5503760649Explicit
NZ0088NZBN0088:9429041866977Explicit
AE0235UAE Tax Identification Number (TIN)0235:100123456789003Explicit
CH0183UID (without CHE prefix)0183:123456789Explicit

Your own entity needs a confirmed Peppol ID (entity defaults). In Germany the customer's ID is never derived from a VAT number: send it or store it on the customer. Self-billed documents are not yet supported over Peppol for Germany. If no endpoint can be found, the invoice waits as WAITING_FOR_YOU with reason: UNROUTABLE and is stored. Check first with GET /v1/participants/lookup, and retry with POST /v1/invoices/{id}/deliver. For Germany a customer without a Peppol ID waits with PEPPOL_CUSTOMER_UNREACHABLE and a list of alternatives[] to resend as another format. Send dryRun: true to check content rules and reachability without storing anything.

Country

Mexico

Mexico is receive-only; Clearvo does not issue CFDI. Choose the ingestion mode once (set-up). With sat_pull Clearvo polls SAT hourly; with client_push you send each CFDI as POST /v1/mx/inbound/cfdi (Content-Type: application/xml, idempotent on the CFDI UUID). Received invoices then behave like any other (Receiving invoices). A CFDI SAT shows as cancelled is stored as CANCELLED and does not fire invoice.received; one SAT cannot find yet stays PENDING and is rechecked. The supplier cancellation accept/reject workflow is not implemented.