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).
| Country | Required to send | Optional overrides |
|---|---|---|
| Italy | Entity Regime Fiscale (set once). | countryData.it.*: recipient code and PEC. Looked up if omitted. |
| Poland | KSeF 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. |
| Germany | For 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. |
| France | Registered VAT number and platform connection (set once). | None on the request. |
| Portugal | AT credentials (set once). | None on the request. |
| Greece | AADE credentials (set once). | None on the request. |
| Peppol countries | customer.electronicAddress for NL, SK, AT, IS, NZ, AE, CH. Derived from taxId elsewhere. | None. |
| Mexico | Receive-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.
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.
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.
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:
countrySpecific.de.invoiceFormaton the request (optional override:ZUGFERD,XRECHNUNGorPEPPOL)- The customer's stored format
- The entity's
defaultDeInvoiceFormat(entity defaults) - 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-levelbuyerReference, or theLEITWEG_IDstored 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_ADDRESSorMISSING_SUPPLIER_ELECTRONIC_ADDRESS.
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.
| Status | Needs |
|---|---|
APPROVED, PAYMENT_SENT, other next steps | No reason. |
PARTIALLY_APPROVED, DISPUTED, REFUSED | A reason in rejectionDetail. |
SUSPENDED | A 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.
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.
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:
| Rate | Tax code | myDATA vatCategory |
|---|---|---|
| 24% | S | 1 |
| 13% | AA | 2 |
| 6% | AB | 3 |
| 0% exempt | E | 4 |
| 0% zero-rated | Z | 5 |
| 0% reverse charge | AE | 7 |
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.
| Country | EAS Scheme ID | Identifier format | Example | Resolution |
|---|---|---|---|---|
| BE | 0208 | KBO/BCE company number | 0208:0420429272 | Auto |
| DK | 0184 | CVR number (with DK prefix) | 0184:DK12345678 | Auto |
| NO | 0192 | Organisation number | 0192:123456789 | Auto |
| FI | 0216 | OVT code (0037 followed by the 8-digit business ID) | 0216:003712345678 | Auto |
| SE | 0007 | Organisation number | 0007:1234567890 | Auto |
| HR | 9934 | Croatian VAT number (HR prefix plus 11-digit OIB) | 9934:HR12345678901 | Auto |
| IE | 9935 | VAT number (with IE prefix) | 9935:IE1234567A | Auto |
| LU | 9938 | VAT number (with LU prefix) | 9938:LU12345678 | Auto |
| SI | 9949 | VAT number (with SI prefix) | 9949:SI12345678 | Auto |
| EE | 0191 | Registrikood | 0191:12345678 | Auto |
| LV | 0218 | Unified registration number | 0218:12345678901 | Auto |
| LT | 0200 | LIS company code | 0200:123456789 | Auto |
| AU | 0151 | ABN | 0151:51824753556 | Auto |
| JP | 0221 | IIN | 0221:T1234567890123 | Auto |
| SG | 0195 | UEN | 0195:200000177W | Auto |
| NL | 0106 | KvK number (without NL prefix) | 0106:37340183 | Explicit |
| SK | 9950 | Slovakia VAT number (the official list also has 0245 for the DIČ tax ID) | — | Explicit |
| AT | 9914 / 9915 | 9914: Austrian VAT number (UID). 9915: public-administration identifier (Verwaltungskennzeichen) | 9914:ATU12345678 | Explicit |
| IS | 0196 | Kennitala | 0196:5503760649 | Explicit |
| NZ | 0088 | NZBN | 0088:9429041866977 | Explicit |
| AE | 0235 | UAE Tax Identification Number (TIN) | 0235:100123456789003 | Explicit |
| CH | 0183 | UID (without CHE prefix) | 0183:123456789 | Explicit |
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.
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.