Tariff 595: Swiss health invoices and XML
With Tariff 595, you can create reimbursement documents in edoobox for outpatient health promotion services in Switzerland. Alongside their invoice, participants receive a standardised document for their supplementary health insurer. edoobox adds the reimbursement document and a QR code sheet to the PDF and provides the structured invoice data as a separate XML file.
Which standard does edoobox support?
edoobox generates generalInvoiceRequest 5.0 in accordance with the Forum Datenaustausch invoicing standard and validates the XML against the corresponding schema. Service items use tariff type 595 – Outpatient health promotion services under VVG. The official tariff list is available in the Forum Datenaustausch reference data; the reviewed edoobox catalogue is based on the edition of 3 June 2026 and takes account of whether items are valid at the start of the service period.
| Term | Meaning in the edoobox workflow |
|---|---|
| Tariff 595 | A catalogue for assigning the billed health service to a tariff item. The tariff number is neither a price nor a commitment to insurance cover. |
| XML 5.0 | Structured invoice data for machine processing. edoobox uses VVG, outpatient, prevention and Tiers Garant. |
| Reimbursement document and QR code sheet | Additional PDF pages for submission to the insurer. The QR codes contain data from the health invoice. |
The Tariff 595 XML is provided as a separate file. A successful technical check confirms the file structure; the insurer still assesses recognition, coverage and reimbursement.
Where and from when is Tariff 595 mandatory?
From 1 January 2027, participating health insurers and certification bodies require reimbursement documents compliant with Tariff 595 and the XML 5.0 invoicing standard for the health promotion services concerned. These replace the previous subscription confirmations; the form must be created using suitable software. The announcement is aimed particularly at course providers, fitness and health centres, movement studios and other sports promotion facilities. The basis is the joint announcement on Tariff 595.
Participating insurers include CONCORDIA, CSS, EGK, Groupe Mutuel, Helsana, Sanitas, Sympany, SWICA, Visana and ÖKK. The requirement applies to the reimbursement process for health promotion services under supplementary insurance governed by VVG. It does not establish a general XML requirement for every invoice issued by a Swiss course provider, nor does it mean that all services are covered by basic health insurance under KVG.
| Situation | What does this mean for you? |
|---|---|
| A reimbursement document issued from 1 January 2027 for a recognised health service with a participating insurer | Provide a reimbursement document in the required standard; an ordinary course or subscription confirmation is no longer sufficient for this purpose. |
| A document issued before 2027, or submission to another insurer | Clarify the applicable transitional and acceptance conditions. A later submission date alone does not mean that an older document must be reissued. The involvement of individual insurers does not imply an identical rule for all insurers. |
| An ordinary language course, corporate training or fully self-funded participation without an insurance reimbursement claim | The Swiss place of invoicing alone does not trigger the Tariff 595 requirement described here. |
| Electronic transmission using electronic Tiers Garant (eTG) | Agree the transmission procedure separately with the insurer or service provider. A local XML file does not confirm successful submission. |
The official Tariff 595 FAQ explain the transition for documents issued from 2027. Helsana already requires Tariff 595 for eTG before that date; the electronic transmission method itself remains optional.
Check recognition of your service and organisation before setup. A suitable tariff item does not replace any required recognition or the individual insurance conditions. QualiCert explains the changeover, recognition and how to obtain GLN and ZSR numbers.
Distinction from complementary medicine: The FAQ, section 5 generally assign complementary medicine services to Tariff 590, including preventive group or individual sessions. Do not therefore use Tariff 595 solely because the word prevention applies. Separate service areas with their own ZSR numbers require separate invoices.
What information is required?
The Tariff 595 settings are displayed for accounts with CHF as the account currency, provided the feature is available in the edoobox version in use. Open System settings → Payment systems → Invoice → Tariff 595. If the tab is missing despite CHF being selected, ask support to check availability for your account.
| Area | Information required in edoobox | Preparation |
|---|---|---|
| Invoice issuer and service provider | Full name and address, IBAN, provider GLN, location GLN and ZSR number. | Use the identifiers actually assigned to you. GLN numbers are administered through Refdata and ZSR numbers through SASIS; your certification body can assist with the application. |
| Service | A valid tariff item with its description, quantity rule, canton of treatment and the correct course or billing period. | Choose the tariff item according to the service, delivery method and unit. If you have multiple locations, check the canton used on the document. |
| Participant | Surname, first name, address, date of birth, AHV number and the salutation/gender information required for output. | Record the actual booked participant. The person paying may be someone else. |
| The person's supplementary health insurance | GLN, name, street, postcode and city of the relevant insurer; optionally the policy/insured person number. | Check the details applicable to this supplementary insurance with the insurer. The AHV number, policy number and insurer GLN are different pieces of information. |
Setup links data fields; the values must also be complete and correct for each person concerned. In the current workflow, insurer data is read from the assigned participant fields. Do not therefore enter the same health insurer for all participants by default.
Step 1: Prepare participant data fields
- Open participant data fields, using Open participant data fields in the Tariff 595 tab if applicable.
- Create or check an active field for the AHV number. Use the dedicated AHV field type; an existing suitable text field can also be assigned. The date of birth requires an active date field.
- Provide five separate active text fields for insurer GLN, insurer name, street, postcode and city. Use another text field for the optional policy number.
- Assign each field to its corresponding purpose in the Tariff 595 tab. Use each field for one purpose only. A custom field name alone does not establish a mapping to the XML.
- Define how the participants concerned should provide the information through the form supplied or have it entered by an administrator. Explain that the data is being collected for the reimbursement document. Check the required details before creating the invoice.
An AHV number must be a valid Swiss number; a placeholder will not pass validation. When testing, do not use fictitious personal identifiers on real invoices. Only show AHV and insurance details to people who need them for the invoicing workflow.
Step 2: Complete and activate invoice settings
- First check the general invoice settings, particularly the invoice issuer, address and IBAN.
- Under Tariff 595, enter the provider GLN, location GLN and ZSR number. The two GLN fields refer to different roles; use the details assigned to those roles.
- Select a default tariff item from the catalogue. Keep the prescribed description. A custom, factually accurate description is entered only for free-text item 9999; do not use it to bypass a suitable regular tariff item.
- Select the quantity rule appropriate to the tariff item and the canton of treatment. Then check the participant and insurance field mappings from step 1.
- Check that all entries have been saved. The switch can only be enabled once the required configuration is complete. Then set Tariff 595 to Active.
Activation does not confirm that every existing invoice is suitable. Missing personal data, unsuitable tariff items or an inappropriate combination of items on the invoice can still prevent XML output.
Step 3: Assign offers, categories and quantities correctly
Open Tariff assignments for offers and categories and select Add assignment. Assign a tariff item and quantity rule to the required offer or category, then save. edoobox first uses the offer's own assignment, then the nearest parent category, and finally the default.
For mixed course programmes, use Use Tariff 595 only for assigned offers where needed. The default then does not automatically apply to offers without their own or an inherited assignment. In this mode, an invoice containing both assigned and unassigned services does not receive a partial Tariff 595 XML: it remains a normal invoice with a corresponding notice. Plan the contents of the invoice before issuing it.
| Quantity rule | Check before use |
|---|---|
| Fixed quantity of 1 | For a service that is genuinely billed as one unit. For a monthly or annual tariff, the period must correspond to exactly one complete period of that type. |
| By lessons | Check the underlying item or lesson quantity. This does not automatically split a flat course fee into lessons. The quantity also does not confirm actual attendance or a minimum attendance requirement set by the insurer. |
| By months | Use a monthly tariff and a matching complete billing period. Incomplete or contradictory periods can prevent output. |
| By years | Use an annual tariff and complete annual periods. Multi-year periods are split into annual items. |
The quantity rule determines quantities and, where applicable, annual items within the existing invoice amount. The total amount and invoicing date remain unchanged. Check the tariff description, unit, service start date, quantity and amount together. The Tariff 595 guidance explains how to select the appropriate items. What matters is the actual service, not just the promotional course title.
Step 4: Check the reimbursement document and XML
- Create an invoice for exactly one actual booked participant with complete data and suitable services. A different billing address, such as a parent's, does not replace participant data. Multiple people on a collective invoice are not combined into one insured person.
- Open the invoice. In the invoice overview, check for the Tariff 595 XML | Invoice number download. It is offered when an XML file is available. A PDF download alone does not confirm this.
- Download the actual invoice PDF. Check the additional pages: reimbursement document and QR code sheet. The QR code sheet must remain fully legible.
- Compare the person, insurer, provider identifiers, canton, service period, tariff items, quantities, amounts and payments already taken into account against the booking. In particular, check that the participant's supplementary health insurer is entered.
- Check the configured invoice delivery in the outbox. When Tariff 595 generation succeeds, the PDF and separate XML are attached for the intended invoice recipients. A booking confirmation includes the XML only if it also contains the invoice PDF.
- Before first use, agree with the intended recipient how the complete documents should be submitted and accepted. Keep any response with the corresponding invoice.
Tariff 595 output supports German, French and Italian. For English and other unsupported languages, this supplement falls back to German; the normal invoice can still be issued in its configured language.
How participants use the document
- Check cover in advance: Ask your supplementary health insurer whether the specific provider and course are recognised, what contribution is available and whether evidence such as proof of attendance or payment is required.
- Provide your details: Give the course provider the correct personal details and information about the relevant supplementary health insurance through the designated channel. If someone else pays, the participant's name, date of birth and AHV number remain the relevant details.
- Receive the documents: Keep the invoice email or files supplied by the provider. If the reimbursement document, QR code sheet or an expressly required XML file is missing, ask the administrator for the complete documents.
- Pay the invoice: The Tiers Garant workflow used in edoobox requires the customer to pay the provider. Reimbursement is then arranged with the insurer.
- Submit all documents: Submit the reimbursement document, including all associated QR code pages, through the insurer's designated channel, such as its app or portal. Observe the file types accepted by the insurer: having an XML file does not mean that every app accepts XML uploads. Send the XML only through a channel intended to receive it.
- Check the response: The insurer makes its decision based on the policy and its conditions. Do not send an electronic submission that has already been confirmed again as a new claim. If there are queries, give the administrator the document number and the specific error message.
edoobox provides the files through this workflow. Activating Tariff 595 or downloading the XML alone does not transmit anything to the health insurer. A separately agreed eTG process must confirm transmission and its status. For the difference between Tiers Garant and optional eTG, see Helsana's information on health promotion.
If the XML or reimbursement document is missing
| Observation | Next step |
|---|---|
| The Tariff 595 tab is missing | Have the CHF account currency and availability in the account checked. |
| Activation is not possible | Check the IBAN, both GLN numbers, ZSR, tariff item, canton and all required data field mappings. A saved field mapping and a completed participant value are two separate requirements. |
| A normal invoice exists, but the XML is missing | Read the specific notice on the invoice. Check participant data, insurer details, identifiers, the service period and tariff validity. The normal PDF does not replace the missing Tariff 595 document. |
| Multiple people or a mixture of assigned and unassigned offers | Check the supported combinations of items on an invoice. edoobox does not create partial XML covering only part of the invoice for these cases. |
| Missing or unmappable salutation/gender information | Check the existing personal data. The reviewed output option requires a gender value that can be mapped; contact support for unsupported cases and do not enter incorrect details. |
| The tariff catalogue or assignments cannot be saved | Reopen the dialog and check the current selection. If other administrators have made changes in the meantime, reload the assignments. |
| The insurer rejects the document | Distinguish a technical format error from missing recognition, missing evidence or lack of insurance cover. The specific reason will clarify whether the issue concerns data, the file or entitlement to reimbursement. |
Correct invoices already issued
First correct the underlying participant, insurance or service data. An existing invoice and its XML are not automatically replaced by changes to master data. Downloading again provides the version saved when the invoice was issued. Later template or catalogue changes do not rewrite it. Use the designated invoice correction process.
Update invoice cancels the existing invoice and creates a new invoice number, even if no data has changed. Check the confirmation dialog carefully. Update payment status is a different action and does not replace this correction process. A new Tariff 595 XML is created only if all required information is valid.
For cancellation invoices, the reviewed Tariff 595 output option does not create a separate new XML file. If the original reimbursement document has already been submitted, clarify with the insurer how to notify it of the cancellation and replacement document. Tell the person concerned which document is valid to avoid a duplicate reimbursement claim.
Example: Health course with one participant
A provider runs a recognised health course in Switzerland and invoices in CHF. The administrator assigns the offer the appropriate tariff item that is valid at the start of the course. They choose a quantity rule matching the tariff item, check the canton and enter the participant's complete personal and supplementary insurance details.
After issuing the invoice, the administrator checks the unchanged invoice total, tariff items and all additional PDF pages. The configured invoice delivery provides the PDF and XML. The participant pays the invoice and submits the complete reimbursement document according to their insurer's requirements. The insurer assesses the claim; the use of Tariff 595 alone does not determine the reimbursement amount.
Official resources and further guides
- Forum Datenaustausch: Invoice, XML schema and documentation version 5.0.
- Forum Datenaustausch: Tariff types and Tariff 595.
- Joint announcement: Changeover on 1 January 2027.
- QualiCert: Tariff 595, recognition, identifiers and downloads.
- Guidance: Professional application and invoice form.
- Participant data fields, different billing address and payments and invoices overview.