How to troubleshoot ESL linking issues with Type-2 UPCs

This article explains common issues with Type-2 UPC formatting that can lead to ESL linking issue, and how to fix them.

Introduction

The Vusion Link app requires Type 2 UPCs to follow a very specific 12‑digit format. If an ESL shows “Not on file,” the product’s UPC in Back Office likely doesn’t meet that format. This article shows you how to spot mis‑formatted Type 2 UPCs and correct them—either on the store handheld or in Back Office.

Not-on-file ESL example

If linking a code to an ESL shows a blank screen with a ? icon, the code isn’t in the store’s product file—or it’s a Type-2 UPC in a format the Vusion Link app doesn’t recognize.

Recognizing a Type-2 UPC formatting error

The Vusion Link app only recognizes Type-2 UPC's in the following format:

✏️ Note - Each of the 4 distinct sections of a Type-2 UPC have strict length requirements.

For example, Type-2 PLU codes are already 5 digits.

If the on-file product code does not match this formatting, the ESL will not recognize the product code.

Commonly rejected Type-2 UPC Formats

Problem	Example of bad code	What to enter instead
PLU only (5 digits)	`00054`	Enter the full 12‑digit Type 2 UPC, e.g. `200054000005`
Short PLU (1–4 digits)	`54` → assumed `00054`	Pad the PLU to 5 digits with leading zeros, then build the full UPC: `200054000005`
Wrong check digit	`200054000009`	Let Vori auto‑generate the last digit.

Correcting a Type-2 UPC's format in Back Office

Open dash.vori.com and log in.
On the lefthand menu, select the Products tab then Products Catalog from the dropdown menu.
Search for the product by entering its product code in the search field on the top right corner of the screen.
Open the product's detail page by clicking the arrow to the far right of the product's row.
Select the Product Details tab on product's page.
In the Barcode field, re-enter the product's UPC in the correct format.
1. For check digit, enter the number prompted on-screen.
Hit Save at the bottom of the product's page.

Correcting a Type-2 UPC's format in Back Office

Log into the Vori OS app on the store handheld.
Tap into the Search Products field at the bottom of the main screen.
Type in the product's code, then select it from the search results below.
Select Edit Product Details at the bottom of the screen.
Select the Details tab within the product's page.
Tap into the Barcode field to begin editing the barcode.
Re-enter the barcode in the correct Type-2 formatting, then hit Save.
1. For check digit, enter the number prompted on-screen.
Tap Save on the product's page to commit the barcode update.