Skip to content
In the news TRM Labs × Finray — audit-ready crypto transaction monitoring for banking
Finray

Glossary · Swiss accounting

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.

Updated · Abbreviation eCH-0217

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.

ElementMeaningPaper form reference
generalInformationTaxable person (UID), organisation name, generation time, reporting period, type of submission, form of reporting, business reference ID, sending applicationheader
turnoverComputationTotal consideration and deductions from itZiffer 2xx
effectiveReportingMethodElements specific to the effective method, mainly input taxZiffer 205, 3xx to 4xx
netTaxRateMethod, flatTaxRateMethodFor periods up to 31 December 2024Ziffer 3xx to 4xx
simpleTaxRateMethodCombined element for net and flat tax rates, for periods from 1 January 2025Ziffer 3xx to 4xx
payableTaxAmount payable, or credit if negativeZiffer 500 or 510
otherFlowsOfFundsOther flows of fundsZiffer 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:

ElementValue
reportingPeriodFrom, reportingPeriodTill2026-07-01, 2026-09-30
typeOfSubmission1
formOfReporting1
grossOrNet1
suppliesPerTaxRate120,000.00 at 8.1, 20,000.00 at 2.6
inputTaxMaterialAndServices3,100.00
inputTaxInvestments1,150.00
payableTax5,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?

RiskControlOwner
Schema-invalid fileValidate against the published XSD before every exportSoftware and preparer
Return does not match the registered method or periodCompare the file header with the ESTV registrationPreparer
Figures differ from the ledgerMap each element to ledger accounts and keep drill-down to the source documentsPreparer
Unreviewed submissionSecond-person review of the prepared return before exportFinance lead
Duplicate first filingRecord what was uploaded and when; use a corrective return for changesFinance lead
Old rates in a new periodKeep rates with valid-from dates and check against the ESTV listFinance

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.

VAT effective method (Switzerland), net tax rate method and QR-bill. The note Swiss VAT effective method in software 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

Published · Updated · All terms

Certificate of Registration NQA · UKAS Management Systems
ISO/IEC 27001:2022 Certificate of Registration issued by NQA to Finray Technologies Ltd, certificate number 215646, valid 21 October 2025 to 21 October 2028
Search
Type to search across Finray, products, company, and journal.

    Press Esc to close · ↵ to open the highlighted result.

    Book a briefing Step 1 of 3

    Your details

    Who is requesting the briefing.