6.3.11.1 Which Data is used in Swiss QR Code Generation?

Challenge

To understand and correctly configure data for successful QR code generation during invoicing for the relevant invoices.

Solution

The following data will be used for the QR code and payment section generation of Swiss Invoices. To ensure complete and accurate creation of the QR code and payment section, please verify that all fields are populated and comply with the relevant validations.

Data Structure	Element Name	General Definition	Field Definition	ADvendio Field/object	Validations

Data Structure	Element Name	General Definition	Field Definition	ADvendio Field/object	Validations
QRCH +Header	Header		Mandatory Data Group
QRCH +Header ++QRType	QR Type	Fixed value "SPC" (Swiss Payments Code)	Fixed length: three-digit, alphanumeric	SPC¶
QRCH +Header ++Version	Version	Fixed value of "0200” for Version 2.0	Fixed length: four-digit, numeric	0200¶
QRCH +Header ++Coding	Coding	Fixed value 1 (indicates UTF-8 restricted to the Latin character set)	Fixed length: one-digit, numeric	1¶
QRCH +CdtrInf	CdtrInf	Creditor Information/Account payable to	Mandatory Data Group
QRCH +CdtrInf ++IBAN	IBAN	IBAN IBAN or QR-IBAN of the creditor.	Fixed length: 21 alphanumeric characters, only IBANs with CH or LI country code permitted.	ADvendio__MediaCampaign__r.LegaLEntity__r.Iban__c¶	max 21 characters
QRCH +CdtrInf ++Cdtr	Cdtr	Creditor	Mandatory Data Group
QRCH +CdtrInf ++Cdtr +++AdrTp	AdrTp	The following codes are defined: "S" - structured address "K" - combined address elements (2 lines)	Fixed length: one-digit, alphanumeric	K¶
QRCH +CdtrInf ++Cdtr +++Name	Name	The creditor's name or company according to the account name. Comment: always matches the account holder (New field??)	Maximum 70 characters permitted First name (optional, sending is recommended, if available) + last name or company name	ADvendio__MediaCampaign__r.LegaLEntity__r.Name¶	max 70 characters
QRCH +CdtrInf ++Cdtr +++StrtNmOrAdrLine1	StrtNmOrAdrLine1	Structured Address: Street/P.O. Box from the creditor’s address Combined address elements: Address line 1 including street and building number or P.O. Box	Maximum 70 characters permitted	ADvendio__MediaCampaign__r.LegaLEntity__r.Street__c¶	max 70 characters
QRCH +CdtrInf ++Cdtr +++BldgNbOrAdrLine2	BldgNbOrAdrLine2	Structured Address: Street/P.O. Box from the creditor’s address Combined address elements: Address line 1 including street and building number or P.O. Box	Maximum 70 characters permitted	ADvendio__MediaCampaign__r.LegaLEntity__r.PostalCode__c, ADvendio__MediaCampaign__r.LegaLEntity__r.State__c¶	max 70 characters
QRCH +CdtrInf ++Cdtr +++PstCd	PstCd	Postal code from creditor’s address	Maximum 16 characters permitted The postal code is must be provided without a country code prefix. Combined address elements: must not be provided	¶
QRCH +CdtrInf ++Cdtr +++TwnNm	TwnNm	Town Town from creditor’s address	Maximum 35 characters permitted Combined address elements: must not be provided	¶
QRCH +CdtrInf ++Cdtr +++Ctry	Ctry	Country from creditor’s address	Two-digit country code according to ISO 3166-1	ADvendio__MediaCampaign__r.LegaLEntity__r.CountryIsoCode__c¶	two characters
QRCH +UltmtCdtr	UltmtCdtr	Ultimate Creditor In favour of Information about the ultimate creditor	Optional data group; may only be used in agreement with the creditor’s financial institution This whole data group must not be filled in for the time being (for Future Use)	(Not currently in use)
QRCH +UltmtCdtr ++AdrTp	AdrTp	codes are defined: "S" - structured address "K" - combined address elements (2 lines)	Fixed length: one-digit, alphanumeric	¶
QRCH +UltmtCdtr ++Name	Name	The ultimate creditor's name or company	Maximum 70 characters permitted First name (optional, sending is recommended, if available) + last name or company name	¶
QRCH +UltmtCdtr ++StrtNmOrAdrLine1	StrtNmOrAdrLine1	Structured Address: Street/P.O. Box from ultimate creditor’s address Combined address elements: Address line 1 including street and building number or P.O. Box	Maximum 70 characters permitted	¶
QRCH +UltmtCdtr ++BldgNbOrAdrLine2	BldgNbOrAdrLine2	Structured Address: Building number from ultimate creditor’s address Combined address elements: Address line 2 including postal code and town from ultimate creditor’s address	Structured Address: max. 16 characters allowed Combined address elements: maximum 70 characters permitted Must be provided for address type "K".	¶
QRCH +UltmtCdtr ++PstCd	PstCd	Postal code from ultimate creditor’s address	Maximum 16 characters permitted The postal code is must be provided without a country code prefix. Combined address elements: must not be provided	¶
QRCH +UltmtCdtr ++TwnNm	TwnNm	Town from ultimate creditor’s address	Maximum 35 characters permitted Combined address elements: must not be provided	¶
QRCH +UltmtCdtr ++Ctry	Ctry	Country of the ultimate creditor’s address	Two-digit country code according to ISO 3166-1	¶
QRCH +CcyAmt	CcyAmt	Payment amount information	Mandatory Data Group
QRCH +CcyAmt ++Amt	Amt	Payment Amount	The amount element is to be entered without leading zeroes, including decimal separators and two decimal places. Decimal, maximum 12-digits permitted, including decimal separators. Only decimal points (".") are permitted as decimal separators.	ADvendio__Invoice__ESRAmount__c¶	max 12 digits
QRCH +CcyAmt ++Ccy	Ccy	Currency The payment currency, 3-digit alphanumeric currency code according to ISO 4217	Only CHF and EUR are permitted.	ADvendio__Invoice__CurrencyIsoCode¶
QRCH +UltmtDbtr	UltmtDbtr	Ultimate Debtor/ Payable by	Optional Data group
QRCH +UltmtDbtr ++AdrTp	AdrTp	The address type is specified using a code. The following codes are defined: "S" - structured address "K" - combined address elements (2 lines)	Fixed length: one-digit, alphanumeric	K¶
QRCH +UltmtDbtr ++Name	Name	The ultimate debtor's name or company	Maximum 70 characters permitted First name (optional, sending is recommended, if available) + last name or company name	ADvendio__ RecipientName__ c¶	max 70 characters
QRCH +UltmtDbtr ++StrtNmOrAdrLine1	StrtNmOrAdrLine1	Structured Address: Street/P.O. Box from ultimate debtor’s address Combined address elements: Address line 1 including street and building number or P.O. Box	Maximum 70 characters permitted	ADvendio__RecipientBillingStreets__ c¶	max 70 characters
QRCH +UltmtDbtr ++BldgNbOrAdrLine2	BldgNbOrAdrLine2	Structured Address: Building number from ultimate debtor’s address Combined address elements: Address line 2 including postal code and town from ultimate debtor’s address	Structured Address: max. 16 characters allowed Combined address elements: maximum 70 characters permitted Must be provided for address type "K".	ADvendio__RecipientBillingPostalCode__c, ADvendio__RecipientBillingState__c¶	max 70 characters
QRCH +UltmtDbtr ++PstCd	PstCd	Postal code from ultimate debtor’s address	Maximum 16 characters permitted The postal code is must be provided without a country code prefix. Combined address elements: must not be provided	¶
QRCH +UltmtDbtr ++TwnNm	TwnNm	Town from ultimate debtor’s address	Maximum 35 characters permitted Combined address elements: must not be provided	¶
QRCH +UltmtDbtr ++Ctry	Ctry	Country from ultimate debtor’s address	Two-digit country code according to ISO 3166-1	ADvendio__RecipientBillingCountry__c¶	Two characters
QRCH +RmtInf	RmtInf	Payment Reference	Mandatory Data Group
QRCH +RmtInf ++Tp	Tp	Reference type Reference type (QR, ISO) The following codes are permitted: QRR – QR reference SCOR – Creditor Reference (ISO 11649) NON – without reference	Maximum four characters, alphanumeric Must contain the code QRR where a QR-IBAN is used; where the IBAN is used, either the SCOR or NON code can be entered	QRR¶
QRCH +RmtInf ++Ref	Ref	Note: The structured reference is either a QR reference or an ISO 11649 Creditor Reference	Maximum 27 characters, alphanumeric; must be filled if a QR-IBAN is used. QR reference: 27 characters, numeric, check sum calculation according to Modulo 10 recursive (27th position of the reference) Creditor Reference (ISO 11649): max 25 characters, alphanumeric The element may not be filled for the NON reference type. Banks do not distinguish between upper and lower case capitalization	ADvendio__ESRReferenceNumber__c¶	Max 27 characters
QRCH +RmtInf ++AddInf	AddInf	Additional information	Unstructured message and Booking instructions may contain a common total of up to 140 characters
QRCH +RmtInf ++AddInf +++Ustrd	Ustrd	Unstructured information can be used to indicate the payment purpose or for additional textual information about payments with a structured reference.	Maximum 140 characters permitted	¶
QRCH +RmtInf ++AddInf +++Trailer	Trailer	Fixed value "EPD" (End Payment Data).	Fixed length: three-digit, alphanumeric	EPD¶
QRCH +RmtInf ++AddInf +++StrdBkgInf	StrdBkgInf	Bill information contain coded information for automated booking of the payment. The data is not forwarded with the payment.	Maximum 140 characters permitted Use of the information is not part of the standardization. In the Annex you will find the version of Swico‘s "Recommendations on the structure of information from the biller for QR-bills" that is valid at the time of publication of these Implementation Guidelines. The element «Billing information»contains coded information of the biller for the bill recipient. This information may be used for automating accounts payable processes, for instance. The data is not forwarded with the payment but it is printed on the payment part. The coding of the element always begins with «//» (slash slash) followed by the double-digit, abbreviated name of the proposed version of the «Structured information for the bill issuer» that is being used	(Not currently supported)
QRCH +AltPmtInf	AltPmtInf	Alternative schemes Parameters and data of other supported schemes	Optional data group with a variable number of elements	(Not currently supported)
QRCH +AltPmtInf ++AltPmt	AltPmt	Parameter character chain of the alternative scheme according to the syntax definition in the “Alternative scheme” section	A maximum of two occurrences may be provided. Maximum 100 characters per occurrence permitted	(Not currently supported)

Setup

N/A