How to Use Barcodes
If you need a way to include barcodes in your email or receipt templates, you can do so with Order Desk and some Twig.
IN THIS GUIDE
Adding QR Codes
To add a QR Code to a template using Twig, use this filter:
|qrcode
or:
|qrcode(300)
for a larger size. The default size is 150.
Example:
<img src="{{ order.source_id|qrcode }}">
Adding Barcodes
To add a barcode, use this Twig filter:
|barcode
or:
|barcode(type, width, height)
Replace (type, width, height) with the values needed. The default values are ("C128", 2, 80).
Example:
<img src="{{ order.source_id|barcode("C39", 2, 80) }}">
Barcode Types
Available barcode options are
C39
C39+
C39E
C39E+
C93
S25
S25+
I25
I25+
C128
C128A
C128B
C128C
EAN2
EAN5
EAN8
EAN13
UPCA
UPCE
MSI
MSI+
POSTNET
PLANET
RMS4CC
KIX
IMB
CODABAR
CODE11
PHARMA
PHARMA2T
Using Barcode Scanners
Order Desk can listen for your USB scanner input. Depending on how your barcodes are set up, you can do one of three things with a scanner.
Enable this functionality by adding USBSCANNER to the feature tag section of your Store Settings page.
Access Order Detail Page
This works with regular QR codes or barcodes.
Example code to pull up the order number:
<img src="{{ ("^#^" ~ order.id)|barcode("C128", 1, 40) }}">
Move Order to Different Folder
This works with regular QR codes or barcodes.
Example code for moving an order to folder 300:
<img src="{{ ("^F300^" ~ order.id)|barcode("C128", 1, 40) }}">
Execute Button Action or Integration Submission
In order to execute a button action from Order Desk using your QR code and scanner you will need to use the following code (using a button called "Blue" as an example):
<img src="{{ ("^submit_to_blue_zvoxh9^" ~ order.id)|qrcode(100) }}">
Please note: You have to have the Order Desk app open and in focus to ensure this works. Also, the output from the QR code must end in a new line.
If you wish to test this we recommend opening a text-editor, such as notepad, scanning a QR code and you should see the output to the text-editor as below, with a new line at the end.
^submit_to_blue_zvoxh9^<order-id>
If you are not using a USB Scanner but just wish to use your phone to generate links that can be pressed to activate buttons, you need to be logged in on your phone and use the code below:
<img src="{{ ("https://app.orderdesk.me/act/scanner?input=^submit_to_blue_zvoxh9^" ~ order.id)|qrcode(100) }}">
Note: For best results, we recommend using a WoneNice USB Laser Barcode Scanner. Additionally, your keyboard language must be US.
Sample Barcode Email Template
The following code is an example of an email template you can use in Order Desk that would send the customer a receipt and create barcodes on the spot. The variable field names are slightly different from the receipt template itself.
In this example a barcode is generated for every item on the order, and the barcode will read the item's unique ID.
If you don't see the code, please click the expand button above to open this article in a full-size window.