Using Barcodes on Invoice Templates

Knowledge Center > Billing and Payments > Invoices > Creating a Custom Invoice Template > Using Barcodes on Invoice Templates

Using Barcodes on Invoice Templates

Barcode Merge Fields on Invoice Templates

In order to have a barcode on your invoice, you need to use a barcode merge field in your template. Currently, Zuora supports up to five barcode merge fields per invoice template.

Use the following format for your barcode merge field:

{MERGEFIELD "Image:{BarCode field}, Value:[{Value}], CodeTextPosition:{CodeTextPosition}, ImageWidth:{image width in point}, ImageHeight: {image height in point}, DpiX:{dpi value horizontally}, DpiY:{dpi value vertically}" * MERGEFORMAT}

Parameter Possible Values
BarCode field
  • BarCode.Code128
  • BarCode.AustraliaPost
Value

This can contain a string, a Customer Account or Invoice custom field, or a merge field from:

CodeTextPosition

This is an optional field that defines the text position of the barcode:

  • Below (default)
  • Above
  • None 
ImageWidth

The width of the barcode, measured by points (1/72 inch).

The value is an integer not greater than 3,200.

ImageHeight

The hight of the barcode, measured by points (1/72 inch).

The value is an integer not greater than 3,200.

DpiX

The horizontal resolution of the barcode, measured by dots per inch (DPI).

The value is an integer not greater than 500.

DpiY

The vertical resolution of the barcode, measured by dots per inch (DPI).

The value is an integer not greater than 500.

Example

The following example will return a barcode of the bill to contact's postal code:

{MERGEFIELD “Image:BarCode.Code128, Value:[{MERGEFIELD BillToContact.PostalCode \* MERGEFORMAT}]” \* MERGEFORMAT}

Example Invoice Template:

invoice_template_example.png

 Returned Example Invoice:

 invoice_example.png

Last modified

Tags

Classifications

(not set)