The Swiss Implementation Guidelines QR-Bill allowed two types of address types: Only Structured Address is allowed after november 2025.
Structured Address
Combined Address
The Combined Address has been deprecated and may not be used after version 2.3 of the Implementation Guidelines QR-Bill gets valid on 21. November 2025.**
The following table compares them
| Example: Structured | Exampled: Combined | Remarks | |
|---|---|---|---|
Address type |
«S» |
«K» |
«S» - Structured address «K» - Combined address |
Name |
Pia-Maria Rutschmann-Schnyder |
Pia-Maria Rutschmann-Schnyder |
|
Street or address line 1 |
Grosse Marktgasse |
Grosse Marktgasse 28 |
«S» - Street/P.O. Box «K» - Street and building number of P.O. Box |
Building number or address line 2 |
28 |
9400 Rorschach |
«S» - Building number «K» - Postal code and town |
Postal code |
9400 |
«S» - Postal code «K» - Do not fill in |
|
Town |
Rorschach |
«S» - Town «K» - Do not fill in |
|
Country |
CH |
CH |
Source: Swiss Implementation Guidelines QR-bill - version 2.0, Chapter 4.4.1, Table 8
The QR Invoice library provides an easy way to either use the structured or the combined address type.
import ch.codeblock.qrinvoice.model.QrInvoice;
import ch.codeblock.qrinvoice.model.builder.QrInvoiceBuilder;
final QrInvoice qrInvoice = QrInvoiceBuilder
.create()
.ultimateDebtor(d -> d
.structuredAddress()
.name("Pia-Maria Rutschmann-Schnyder")
.streetName("Grosse Marktgasse")
.houseNumber("28")
.postalCode("9400")
.city("Rorschach")
.country("CH")
)
// ...
.build();=== Combined Address
import ch.codeblock.qrinvoice.model.QrInvoice;
import ch.codeblock.qrinvoice.model.builder.QrInvoiceBuilder;
final QrInvoice qrInvoice = QrInvoiceBuilder
.create()
.ultimateDebtor(d -> d
.combinedAddress()
.name("Pia-Maria Rutschmann-Schnyder")
.addressLine1("Grosse Marktgasse 28")
.addressLine2("9400 Rorschach")
.country("CH")
)
// ...
.build();