HaloITSM

HaloITSM Guides

Documentation to assist with the setup and configuration of the HaloITSM 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 Header:



You can download PDF Templates to your local reposiotry via the template:



This template includes a section returning the QR code from within the header of the Invoice:



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:



Arguably the most important part of the QR code is the data it returns when scanned. This is all held within the 'data' section itself:



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 two key considerations: 


  • 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.
  • Invoices must have the 'Currency' field blanked out, as the variable in Halo returning the invoice sub-total will automatically add the currency to it (which is not compatible with the Swiss QR Bill formatting). This is an open development point, however, and should only be a consideration for the near future.


Popular Guides

Pin It on Pinterest