This guide is intended to help Green Bits users and their vendors avoid and troubleshoot common scanning issues with vendor-generated barcode labels.
For information about creating labels directly in Green Bits, see Print labels from the Back Office.
The Green Bits Register app supports the following Socket Mobile Bluetooth barcode scanner models:
- CHS 7Qi
- CHS 7Xi
- Durascan D750
- Durascan D760
The Green Bits Back Office web app is scanner-agnostic and works with any scanner that's compatible with your computer.
Supported barcode types and symbologies
Green Bits supports 1D and 2D barcodes and QR codes in all common symbologies, however for best results we recommend that vendors use Code 128 or Code 39 when generating barcodes for retailers that use Green Bits.
Label and SKU must match exactly
Green Bits imports product information directly from Metrc and Leaf Data Systems, including unique product identifiers (also referred to as "package IDs" or "tags" in Metrc; "lots" or "global IDs" in Leaf Data Systems).
Unique identifiers from Metrc and Leaf Data Systems are automatically populated into the SKU field in Green Bits. The value in the SKU field must exactly match the identifier encoded on the physical barcode label in order for Green Bits to read it.
If you scan a barcode label and the scanner beeps, but the Register app doesn't respond, this indicates that the label is readable but doesn't match the SKU field in Green Bits. No beep indicates that the scanner can't read the label at all.
The SKU field in Green Bits is editable. Green Bits users who discover a mismatch between a physical barcode label and the unique identifier imported from their traceability system should either:
- Edit the SKU field in Green Bits to match the barcode label
- Print new barcode labels from Green Bits and stick them on top of the vendor-generated barcode
Use a smartphone app to test barcodes
To verify whether a vendor-generated barcode label is readable and matches the SKU field in Green Bits, scan the barcode with your smartphone using one of the many barcode reader apps available in your app store. Green Bits recommends Scandit, which is available for iPhone, Android, and Windows Phones.
Some newer smartphones and smartphone operating systems have barcode scanning capabilities built into the camera and do not require a third-party app.
Alternatively, use the Socket Mobile barcode scanner in HID mode to scan and verify vendor barcodes.
Be aware of short identifiers (Washington only)
If an item doesn't scan at the Register, it might be because the barcode on the item is a short identifier and the SKU in Green Bits is the full lot number/global ID. A short identifier is the last seven characters, after the period:
To change the SKU in Green Bits to match the short identifier on the barcode:
- Check the barcode on the item with a smartphone app to see if it is a short identifier.
- If it is, go to Inventory and select the Product that you were scanning.
- Select the Inventory tab and find the SKU that wouldn't scan.
- Go to Actions > Edit.
- Enter or scan the short identifier into SKU on the manifest.
- Select Save.
Avoid resizing barcodes
The exact spacing and proportions of a barcode are essential for successful scanning. If a vendor needs to change the size of a barcode, they should re-generate the barcode in the desired dimensions rather than enlarging or shrinking an existing barcode.
Avoid non-standard characters
Green Bits supports numbers, uppercase letters, and periods. Avoid creating barcodes that include any other characters, especially tilde (~).
Because the SKU field in Green Bits can't be edited to include non-standard characters, if you encounter a barcode that includes such a character, print new barcode labels from Green Bits and stick them on top of the vendor-generated barcode.
Include white space
Vendors should include a generous margin of white space around their barcodes. Insufficient white space to the left or right may prevent the barcode from scanning, especially if the area beyond the margin is dark or reflective.
Make sure SKUs are set to For Sale in Green Bits
Even if a barcode label and SKU meet all of the above guidelines, the Register won't recognize it unless the SKU is marked For Sale.