# What is eCH-0217?

eCH-0217 is the Swiss e-government standard that defines the XML format of an electronic VAT return, so accounting software can export a return that the Federal Tax Administration's online application accepts when it is uploaded.

- Source: https://finray.tech/intelligence/glossary/ech-0217/
- Published: 2026-11-21
- Updated: 2026-11-21
- Publisher: Finray Technologies Ltd, Cyprus Companies Registry HE 445903

---

## What is eCH-0217?

eCH-0217, titled Spezifikation E-MWST, is a standard of the Swiss association eCH. It describes the format for submitting a value added tax return electronically by uploading an XML file to the Federal Tax Administration's application for VAT returns. It is aimed at the makers of ERP and accounting software: the document describes the structure of the export so that every vendor produces the same file.

The approved version is 2.0.0. It replaces version 1.0.1, which the German edition marks as superseded. The package accompanying the standard contains an XML schema (eCH-0217-2-0-0.xsd) and example files for each reporting method.

## What does the standard cover?

Version 2.0.0 covers the three accounting methods defined in Swiss VAT law: the effective method, the net tax rate method and the flat tax rate method. It also covers three types of submission: a first filing, a corrective return, and an annual reconciliation. The annual reconciliation corrects errors found while preparing the annual accounts, and contains only the differences from the full return of the tax period.

The standard deals only with the format of the return under the Act. It does not describe the transmission channel or the technical architecture of the ESTV application. It points to the ESTV's own publications for explanations of the methods.

## How is the XML structured?

The root element is VATDeclaration. Its main children are listed below.

| Element | Meaning | Paper form reference |
| --- | --- | --- |
| generalInformation | Taxable person (UID), organisation name, generation time, reporting period, type of submission, form of reporting, business reference ID, sending application | header |
| turnoverComputation | Total consideration and deductions from it | Ziffer 2xx |
| effectiveReportingMethod | Elements specific to the effective method, mainly input tax | Ziffer 205, 3xx to 4xx |
| netTaxRateMethod, flatTaxRateMethod | For periods up to 31 December 2024 | Ziffer 3xx to 4xx |
| simpleTaxRateMethod | Combined element for net and flat tax rates, for periods from 1 January 2025 | Ziffer 3xx to 4xx |
| payableTax | Amount payable, or credit if negative | Ziffer 500 or 510 |
| otherFlowsOfFunds | Other flows of funds | Ziffer 9xx |

There is no explicit flag for the accounting method. It follows from which method element is present. Within generalInformation, two coded values matter for bookkeeping: typeOfSubmission (1 first filing, 2 corrective return, 3 annual reconciliation) and formOfReporting (1 agreed, 2 received). In the effective method, grossOrNet states whether turnover is given net (1) or gross (2); the standard notes that the ESTV recommends net values where possible.

## What formatting rules apply?

The standard prescribes UTF-8 without a byte order mark, no empty XML elements (an irrelevant optional element is omitted), and coordinated universal time for all dates and times. Amounts are decimals with at least two decimal places, positive or negative. Percentage values lie between 0 and 100. The five standard XML escape sequences are the only ones used.

## What checks must the sending system perform?

Section 7 of the standard lists plausibility checks that the vendor system must run before sending, and the ESTV application repeats them on upload. Examples are: the file must be valid against the schema; the method in the file must match the method registered with the ESTV; the reporting period must match the registered period; only one first filing is allowed for a period; the taxable turnover must equal the sum of the supplies by rate; payableTax must be computed without rounding intermediate steps; and only published tax rates may be used. Each check has an error code such as MWST-0001 for a schema violation (TVA-0001 in the French edition). A violation leads to rejection of the file.

## Worked example (illustrative, synthetic numbers)

A quarterly return on agreed consideration, effective method, net values, for a fictitious company with UID CHE-000.000.000. The file carries these values:

| Element | Value |
| --- | --- |
| reportingPeriodFrom, reportingPeriodTill | 2026-07-01, 2026-09-30 |
| typeOfSubmission | 1 |
| formOfReporting | 1 |
| grossOrNet | 1 |
| suppliesPerTaxRate | 120,000.00 at 8.1, 20,000.00 at 2.6 |
| inputTaxMaterialAndServices | 3,100.00 |
| inputTaxInvestments | 1,150.00 |
| payableTax | 5,990.00 |

The standard's calculation for net values multiplies each turnover by its rate divided by 100: 9,720.00 plus 520.00 gives tax owed of 10,240.00, from which the two input tax elements are deducted to reach 5,990.00. If the sending software calculated a different payableTax from the same elements, the ESTV application would reject the file under the check on calculation logic.

## What controls apply?

| Risk | Control | Owner |
| --- | --- | --- |
| Schema-invalid file | Validate against the published XSD before every export | Software and preparer |
| Return does not match the registered method or period | Compare the file header with the ESTV registration | Preparer |
| Figures differ from the ledger | Map each element to ledger accounts and keep drill-down to the source documents | Preparer |
| Unreviewed submission | Second-person review of the prepared return before export | Finance lead |
| Duplicate first filing | Record what was uploaded and when; use a corrective return for changes | Finance lead |
| Old rates in a new period | Keep rates with valid-from dates and check against the ESTV list | Finance |

## How does Corebanq Accounting relate to eCH-0217?

Today, Corebanq Accounting exports the VAT return as an eCH-0217 XML file that has been validated against the XSD. The flow is: prepare the return from the ledger with figures mapped to the ESTV form boxes, have an independent second person review it, export the file, and the user uploads it in the ESTV portal. The product supports the effective method on agreed consideration. It does not prepare net tax rate returns, does not support accounting on received payments, and does not file directly with the ESTV. See [Corebanq Accounting](/platforms/corebanq-accounting/).

## Related terms

[VAT effective method (Switzerland)](/intelligence/glossary/vat-effective-method-switzerland/), [net tax rate method](/intelligence/glossary/net-tax-rate-method/) and [QR-bill](/intelligence/glossary/qr-bill/). The note [Swiss VAT effective method in software](/notes/swiss-vat-effective-method-ech-0217/) walks through the path from ledger to file.

## Frequently asked questions

### Who publishes eCH-0217?

The association eCH publishes it. The standard states that it was prepared in the Swiss e-government project SP-8 e-VAT, that the Federal Tax Administration is the only recipient of the data, and that it addresses vendors of ERP and accounting solutions.

### Which version is current?

Version 2.0.0 carries the status approved and replaces version 1.0.1, which the German edition marks as superseded. Its schema is named eCH-0217-2-0-0.xsd and its XML namespace is http://www.ech.ch/xmlns/ech-0217/2.

### Does eCH-0217 let software submit the return directly to the ESTV?

The standard describes the export of a file that is uploaded manually in the ESTV application for VAT returns. It mentions a later machine-to-machine interface as a further step and says that this would mainly change the transport layer and the acknowledgement, not the data itself.

### What happens if the XML file is not valid?

The standard requires the vendor system to run plausibility checks before sending, among them validation against the schema, and says that the ESTV application performs the same checks after upload. A violation leads to rejection of the file.

### Does the file contain the Ziffer numbers of the paper form?

The XML uses named elements, and the standard maps each element to the corresponding Ziffer of the paper return. Some intermediate totals of the form, such as Ziffer 399, are not transmitted as their own elements.

## Sources

- [eCH-0217 Spezifikation E-MWST, version 2.0.0, status approved (German original)](https://www.ech.ch/sites/default/files/imce/eCH-Dossier/eCH-Dossier_PDF_Publikationen/Hauptdokument/STAN_d_DEF_2025_06_30_eCH-0217_V2.0.0_E-MWST.pdf)
- [eCH-0217 Spezifikation E-MWST, version 1.0.1 (German, status superseded)](https://www.ech.ch/sites/default/files/imce/eCH-Dossier/eCH-Dossier_PDF_Publikationen/Hauptdokument/STAN_d_REP_2024_02_09_eCH-0217_V1.0.1_E-MWST.pdf)
- [Federal Act on Value Added Tax (MWSTG, SR 641.20) on fedlex.admin.ch: Art. 36, 37, 39](https://www.fedlex.admin.ch/eli/cc/2009/615/de)
