HaloPSA

HaloPSA Guides

Documentation to assist with the setup and configuration of the HaloPSA platform

Guides > Using QR Codes on PDF Templates

Using QR Codes on PDF Templates

When generating PDF templates in Halo, you can include some specific HTML in order to render a QR code, returning data of your choice.


The PDF Template Online Repository has an example of how this is implemented. From your PDF Templates (Configuration>Reporting>PDF Templates), you will find an option to head to our PDF Template Online Repository:



In here, you will find an invoice template: QR Code:



You can download the PDF Templates to your local reposiotry via clicking into the template, then selecting the below:



This template includes a separate page with a QR bill slip:



As far as HTML is concerned, there are a few key places to pay attention to.


Firstly, ensure you have the "<script>" tag present in the header of your HTML:



The QR Code itself is returned via the below HTML/JavaScript:



The 'Data' section of the above returns the text when scanning the QR code:



As you can see from this example, you can input $_variables into the data section of the QR code.


The Swiss QR Bill


The particular formatting of the QR code found in the Online Repository is compliant Swiss QR Bill requirements, with one key considerations: currently, the IBAN used must comply with the 'NON' reference type, denoting that there will not be a QR Reference or Creditor Reference included in the QR code. There is an option to provide additional details, but the formatting of these details will not necessarily follow the formatting required by the QR or Creditor Reference. Algorithms for calculating check digits for both QR and Creditor Reference's are currently being investigated & will be included in a future release of the template.


The Swiss QR bill requires some specific formatting of the data scanned, which can be addressed via the below points:

  • Your Company IBAN should be returned in the QR - this is handed via the $_orBankDetails1 variable in HaloPSA. This variable will populate the contents of the below field (Config>Organisation):Please ensure your IBAN is entered into this field.
  • OrganisationAddressLine1, OrAddressLine2, OrAddressLine3 & OrganisationAddressLine4 should be replaced with your Company address, formatted as per the Swiss QR Bill Implementation guidelines (if only 3 address lines are needed, simply remove OrganisationAddressLine4)


Popular Guides