Parameter Settings > Point of Sale > Documents Tab
This Tab is used for defining "footer" messages and/or QR (Quick Response) Code that can be optionally printed near the bottom of some Point of Sale documents.
![](../Resources/Images/Parameters_POS_Documents_RSM.png)
Leave the text areas blank (empty) if you do not wish to use a particular message area or generate a QR Code image. Otherwise, type in the text for the message or that will be used to generate a code. Space is limited for textual messages and text areas only allow the number of characters that a footer message can display. If you include a QR Code in addition to a message, the message area will be reduced in size (width) displaying fewer characters than the usual allowed limit. The size of the text area is expanded to full size when no QR Code is indicated. If you decide to add a QR code, it's important to view a document to ensure that (a) any existing footer message remains visible and (b) to test the QR Code to make sure it works as intended.
The maximum text length for footer messages is 256-characters.
QR Codes are not saved with document data. When your company changes or removes your QR Codes, those changes will immediately affect current documents as well as any previous documents you view or print. Previously emailed copies of any documents (PDF) would not be affected, however.
What is a QR Code?
QR stands for "Quick Response" and is used to describe 2-dimensional barcodes (see the example below). These barcodes can be scanned by most smart devices equipped with a camera. Scanning may require that you install an app on your device. Free apps are widely available for this purpose. The black and white areas of the code are translated into text which may represent a number of different things such as a web site address, SMS (Text) Message, phone number, geographical map location (coordinates), email address, or contact information. You can use a QR Code to provide a link to your company's web site or social media page, contact information for a store manager, or geolocation information for a branch location, for example.
![http://sprucecomputer.com http://sprucecomputer.com](qr_code.jpg)
QR Code Example
QR Codes are currently capable of representing up to 4,296 text characters; however, the longer the text used to generate the code, the greater the complexity of the image will be. Devices can have difficulty reading complex codes if they are printed too small. We mention this because the area on a document that is available for the QR Code to be printed is relatively small (see below). Overly complex codes (longer text values) may not work as well or may only work with some devices. If you compare the codes in the images shown below, you can see how the addition of more information (top) changes the QR Code.
Regardless of the length of the text, you should always test any changes or addition of QR Codes with documents immediately. No validation is performed on the QR Text entered. QR Codes will be generated and displayed on documents regardless of whether the text value of the code actually does something! The only way to be sure the code functions properly is to scan the code using a smart device.
![QR Code Comparison QR Code Comparison](document_footer_qr.jpg)
QR Code Comparison
What text do I specify for a QR Code?
The software will generate the image on a document for you; however, the actual text used must be indicated by your company. Any information you specify will be interpreted/translated by the user's device (and app they are using). Some devices may not recognize certain formats or support some features.
There are a wide number of free QR Code generators available on-line; however, these usually provide a code that could be used on a web site which also displays the image of the barcode. This is not necessary here because the application creates the image for you. If you paste a web generated "<img src=" type tag/link into the text areas, the QR Code generated will not work properly. We do not suggest using any on-line QR Code generators for this reason even if you attempt to remove the image references.1
1On-line generators also tend to make a URL "friendly" string by replacing certain characters (line feeds, spaces, slashes, ampersands, etc.) which are invalid in a URL/URI with hexadecimal values (a set of characters prefixed with a % followed by letters and/or digits that are recognized as the original character by a browser). These hexadecimal values would also need to be removed from the text generated.
It's also important to understand what happens when someone scans a QR Code with their device. The device/app decodes the QR Code back to text and looks for clues (tags) within the text that may indicate the code's purpose. Any text that isn't recognized is typically just treated as plain text and displayed for the device user to see. When a smart device scans a QR Code linked to a web site address, it should ask the device user whether they want to visit (browse) the web site. An Email address should prompt similarly as to whether the user wants to send an Email. QR Codes don't do anything unless the text is formatted properly, recognized/supported by both the device and app, and the person scanning the codes decides to continue (browse the web site, send an Email, add a contact, etc.).
Here are some basic examples to assist you with the text values:
QR Code Function |
Text Example |
Format/Description |
---|---|---|
Web Site (URL/URI) |
http://mysite.com/index.html |
{url} |
|
mailto:anyone@anywhere.com |
mailto:{email} |
Phone Number |
tel:+18007778235 |
tel:+1{phone number} (+1 for United States) |
Text Message (SMS) |
sms:6543210:Hello |
sms:{mobile number or short code}:{subject} |
Contact Information (http://en.wikipedia.org/wiki/VCard) |
BEGIN:VCARD
|
BEGIN:VCARD
|
Geographical Location |
geo:42.758113,-73.822973,100 |
geo:{Latitude},{Longitude},{Altitude} |
Plain Text |
Hi There |
{text} |
It's important to point out that the space (length) for the QR Code text is limited. Our example for contact information would not fit in the space allowed and even if reduced would produce a fairly complex code image. We included the longer contact text in order to show more of the tags that can be used (there are quite a few beyond what we've shown). In addition, we should point out that there are a number of different contact formats available. Remember, the device and app being used will determine what's compatible and what isn't. This can change on device-by-device basis. For this reason, it's probably best to keep your QR Codes as simple as possible.
If you need help with your mobile device or have additional questions about QR Codes, please research your answers on-line or reach out to either your company's IT provider or your device provider. Below are a few links to help you get started:
•https://code.google.com/p/zxing/wiki/BarcodeContents
•http://en.wikipedia.org/wiki/QR_code
*We are unable to guarantee the usability of any QR Code generated along with any particular device or app. Software support for the product does not include assistance with determining the text values to use for QR Codes.
Are QR Codes Printed on All Document Formats/Styles?
No. QR Codes are only printed on invoice, order, ticket, and quote styles that normally print the invoice/ticket, order, or quote footer messages. Document styles that do not normally print the message will also not print the QR Code.
Invoice & Ticket Document Footer
This text box allows entry of a short text to be printed or displayed at the bottom of invoices, charge returns, and open tickets type documents.
Invoice/Open Ticket QR Code
Enter the text that will be used to generate a QR Code to print next to the footer message on invoices, charge returns, and ticket (aka. Advice Notes) type documents.
Use this text box for any message that should print or display at the bottom of customer order documents.
Customer Order QR Code
Enter the text that will be used to generate a QR Code to print next to the footer message on customer order type documents.
The text entered is printed and displayed at the bottom of Point of Sale Quote documents.
Customer Quote QR Code
Enter the text that will be used to generate a QR Code to print next to the footer message on quote type documents.