Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents


Excerpt

The payment with the ESR payment slip is very common in Switzerland and is already provided by SecuTix. However, the ESR is intended to be replaced by the new Swiss QR invoice and won't be valid anymore after the 30th of September 2022. From now on, you can migrate to the Swiss QR invoice and benefit from following advantages:

  • Get more detailed payment information in electronic form, since the QR code contains more information than the coding line of the ESR slip
  • QR codes are easier to scan, thus reducing the error rate
  • QR invoices may be printed on standard blank paper

...

Administrative values

You need to define two several administrative numbers:

  1. QR IBAN
  2. Postal account (not used actively, but needed)
  3. Deadline ISR (number of days for the payment)

The QR invoice uses a separate IBAN, called QR-IBAN. This number has to be stored in the corresponding administrative number as shown below. Please contact your bank if you don't have a QR-IBAN.

...

Create a new interface of type Payment integration and subtype BVR import:

Set the parameters highlighted in the red boxes  in figure below. Of course, you are free to name the sales channel, point of sales and payment method code as you want.Image Removed

Image Added

Payment value date

The payment value date is determined with the following rules:

  • Either it is found in the XML file using the XPath parameter called (name of the parameter)
  • If not found, it is taking the day of integration + 1 day.


Warning
titleCamt 054 payment XML file format

The XML file published by the bank depends heavily of the bank. The XPath parameters (framed in green in picture above) are used to indicate to the system where to find the valid information. If the default setup provided with the system does not accommodate the file format, do not hesitate to ask for help from SecuTix and support. Provide them with a valid file example.


Warning
titleValue date in XML file

Value date (often named ValDt Camt 054 files) is not by default inside of the payment node, so make sure XML parameters are entered correctly to handle value dates even if they are not that are not inside the payment node.


Warning
titleWarningCustom Parameters
In the "Custom parameters", add ignorePointOfSaleRelatedToOrderignorePointOfSalesRelatedToOrder=true to allow to always take the pointOfSale of the batch instead of the one of the order. This allows the batch to work if the client chose "BVR" pending account on a ticketshop.

...

Warning
titlePerform a full test cycle before going live

SecuTix strongly recommends to perform the whole test cycle before sending a large number of QR invoices:

  1. Create a sales order (for example with a voucher)
  2. Print the QR invoice
  3. Pay the invoice in your mobile banking app by scanning the QR code
  4. Wait for the bank to provide you the payment file
  5. Import the payment file

Indeed, this test will ensure that the whole setting has been done properly and that the file generated by your bank may be read by SecuTix.


Red square problem

In some cases, the QR is printed with some red color on it, when printed directly from the BoxOffice. This red makes it not standard and refused by the Swiss Post.

Image Added

Open the local configuration file  C:\Users\%Username%\secutix\devicedrivers\devicedrivers.properties and add this line to it:

TnPD.printAsImage=PrinterName

If the file does not exist, you may need to create it.

"PrinterName" needs to be replaced by the name of the logical name of the printer.

Beware that the PrinterName must not include spaces (!!...), so the client may need to rename the printer in the windows preferences (replacing for example with underscores, like HP_LJPro_MFP_M477_PCL6) and then also fix this logical name in the workstation (in SECUTIX).