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.
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.
Be aware of short identifiers
Cannabis producers in Washington sometimes use a "short identifier" instead of the full lot number/global ID when creating barcode labels. A short identifier is the last seven characters, after the period:
Green Bits will always import the full global ID from Leaf Data Systems. If the vendor barcode includes only the short identifier, the barcode won't scan in Green Bits unless the SKU field is edited to include only the short identifier as well. Vendors using short identifiers should be sure to inform Green Bits users that they'll need to edit the SKU field accordingly.
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.