Back

Multiple Barcodes

Multiple barcodes let you assign a different barcode to each unit of measure of a product, such as one barcode for the piece, another for the box, and another for the carton. When you scan any of them on an invoice or in the point of sale, the product is added automatically in the unit linked to the barcode, with the quantity and price set for it.

Example

A product named “Juice” uses a unit template with the base unit “Piece” and “Carton” = 24 pieces.
Barcode 6281000000011 → Piece unit, quantity 1, price 3.
Barcode 6281000000028 → Carton unit, quantity 1, price 65.
When you scan the second barcode on an invoice, “Juice” is added in the Carton unit, with quantity 1 and price 65.
Required permissionsAdd New Product to add a product with multiple barcodes, and Edit & Delete All Products or Edit & Delete His Own (Created) Products to edit it. Set them from Manage Employee Roles.
How to accessProducts & Services → add or edit a product → the Multiple link next to the Barcode field. Or from the main menu: Inventory → Products & Services.

Requirements for multiple barcodes

The Multiple link appears only when all of the following conditions are met:

Condition Where to set it
The Inventory app is enabled. Apps Manager.
The Multiple Units per Item option is enabled. Products Settings in Inventory Settings.
The item is a product or a bundle. It doesn’t appear for services or work items.
The tracking type isn’t Serial Number. The Tracking Type field on the product (when product tracking is enabled).

For the units to appear in the Unit Factor column, choose the right Unit Template for the product from Unit Templates.

Add a barcode for each unit

  1. Open Products & Services and add a new product, or open a product and click Edit.
  2. Choose the product’s Unit Template.
  3. Click the Multiple link above the Barcode field; the Product Item Barcodes section appears.
  4. In each row, choose the Unit Factor, and enter the Barcode of this unit, the Quantity, and the Selling Price Per Unit.
  5. Click Add to add a row for another unit, or the delete icon next to a row to remove it.
  6. Click Save (or Update when editing a product).

🛈

Note: The main Barcode field stays as it is; it’s the product barcode in its base unit. You can leave it empty and use the unit barcodes only.

⚠

Warning: The unit factor is required for every row. If you leave it empty, the message Unit Factor is required for each item barcode appears and the product isn’t saved. If you don’t want to add a row, delete it.

Barcode table fields

Field Description Required
Unit Factor The unit the product is added in when this barcode is scanned. The units of the product’s unit template appear, including the base unit. Yes
Barcode The barcode number for this unit. It can’t repeat another barcode (rules). Yes
Quantity The quantity added automatically when scanning in this unit, usually 1. Always enter it, because an empty value is saved as zero. The system doesn’t prevent leaving it empty
Selling Price Per Unit The selling price in this unit when scanned. If left empty, the product’s selling price is used. No

🛈

Note: The Selling Price Per Unit is stored internally in the base unit (price ÷ conversion factor) and always shown to you in the selected unit, so it may show small decimals after conversion.

What happens when you scan the barcode

Case Result
Scanning a unit barcode on an invoice, estimate, sales order, credit note, or refund receipt The product is added in the linked unit, with the set quantity and Selling Price Per Unit.
Scanning it in the point of sale The same result: the unit, quantity, and price set for the barcode.
Scanning it on purchase documents (purchase invoice, purchase order, purchase quotation), a requisition, a purchase request, a stock request, or a work order The product is added in the unit linked to the barcode, with the set quantity.
Scanning the same barcode again on an invoice A new line is added with the same unit, quantity, and price; it isn’t merged with the previous line.
Scanning the barcode of another unit of the same product A new line is added in the other unit, and it isn’t merged with the first unit’s line.
Scanning the product’s main barcode The product is added in its default sales units.
Typing part of a unit barcode in the search The product doesn’t appear in its unit; searching by a unit barcode requires the full, exact number.

🛈

Note: In the point of sale, a 13-digit barcode that starts with zero also matches the same barcode without the zero.

Print a barcode label for each unit

  1. Open the product page from Products & Services.
  2. Click Voucher, and choose a barcode label template, such as Barcode Label.
  3. Tabs appear at the top of the screen: Main Barcode, and a tab named after each unit that has a barcode.
  4. Choose the tab of the unit you need, then click Print. You can also click PDF or Send Email.

🛈

Note: The label shows the unit barcode and its price in the selected unit. You can edit the label design or add new labels from the printable templates.

Import barcodes from an Excel file

To add unit barcodes to a large number of products at once:

  1. Open Products & Services, and from the import menu choose Import Product Barcodes.
  2. Click Download Sample and fill it in, then upload it, choose the Delimiters, and click Next Step.
  3. In Fields Mapping, match each System Field with the Corresponding Field in File. You can enable Ignore errors while importing to import the valid rows and skip the rows with errors. Then click Import.
Column in the file Rule
Product Code Required, and it must be the code of an existing product.
Unit Factor Required when multiple units are enabled. Enter the unit name or its short name as in the product’s unit template, or the name of the base unit.
Barcode Required. It can’t repeat within the file or match an existing unit barcode in the system.
Quantity Required, a number greater than zero.
Selling Price Per Unit Optional, a number of zero or more. If left empty, the product’s selling price is used.

Example

Product Code | Unit Factor | Barcode | Quantity | Selling Price Per Unit
PEN-009 | Piece | 6281234567890 | 1 | 10
PEN-009 | Carton | 6281234567891 | 1 | 115

⚠

Warning: The import checks for duplicates against unit barcodes only, not against the products’ main barcodes, so make sure the barcode isn’t used as the main barcode of another product.

When the import finishes, the result shows the number of records Imported successfully., Updated successfully., and Records failed to import., with the error of each failed row.

Edit and delete barcodes

  • To edit a barcode, its price, or its quantity: open the product → Edit, edit the row, then click Update.
  • To delete a unit barcode: delete its row from the table, then click Update.
  • To turn off multiple barcodes completely: click Single at the top of the section, then click Update. All unit barcodes are deleted, and only the main barcode remains.
  • When you save, the system replaces all unit barcodes with the ones in the table.
  • Deleting the product deletes its unit barcodes.

Barcode uniqueness rules

Case Rule
Within the same product Don’t repeat the same barcode in two rows, and don’t repeat the main barcode in the units table.
With the main barcode of another product Not allowed.
With a unit barcode of another product Not allowed when editing a product or importing. When adding a new product, the system may not detect the duplicate, so review the barcode before saving.
With a product serial number Not allowed when editing, if product tracking is enabled.
Letter case When editing, the system doesn’t distinguish between uppercase and lowercase letters (ABC = abc).
Branches If products aren’t shared between branches, the unit barcode is compared only with the products of your current branch, while the main barcode is compared with all products.

🛈

Note: The main barcode must be at least 5 digits long, and there’s no minimum length for unit barcodes.

Error messages and solutions

Message Cause Solution
Unit Factor is required for each item barcode A row in the barcode table has no unit. Choose the unit, or delete the row.
Product barcodes must be unique. A barcode is repeated within the product or used by another product. Change the repeated barcode.
This barcode already used The main barcode is used by another product. Change the main barcode.
The barcode must be at least 5 digits long The main barcode is shorter than 5 digits. Enter a longer barcode.
Row (number): Barcode ‘(barcode)’ appears more than once in the file. The same barcode is in more than one row of the import file. Remove the duplicate from the file.
Row (number): Product code ‘(code)’ does not exist in the system. The product code is incorrect. Correct the product code.
Row (number): Unit factor is required for product ‘(code)’ because multi-units feature is enabled. The unit column is empty. Enter the unit.
Row (number): Product ‘(code)’ has no unit template assigned. The product has no unit template. Choose a unit template for the product first.
Row (number): Unit ‘(unit)’ is not assigned to product ‘(code)’. The unit isn’t in the product’s unit template. Enter the unit name as it appears in the template.
Invalid Data, (reason) at row #(number) For example, The quantity must be greater than 0. or The unit price must be greater than or equal 0., or the barcode already exists in the system. Correct the value in the file.

Important notes

  • The weight embedded barcode works only with the product’s main barcode, not with unit barcodes. Its format is set from Barcode Settings.
  • If you turn off Multiple Units per Item, the multiple barcodes section disappears from the product form.
  • Products tracked by serial number don’t support multiple barcodes, because each piece has its own serial number.
  • If the same unit barcode exists for more than one product, the product isn’t added automatically in the unit when scanned.

FAQs

Why doesn’t the Multiple link appear next to the barcode?

Because Multiple Units per Item isn’t enabled, the item is a service or work item, or the tracking type is Serial Number.

Why don’t units appear in the Unit Factor list?

Because the product has no unit template. Choose the Unit Template first.

Can I assign more than one barcode to the same unit?

Yes. Add more than one row with the same unit and different barcodes.

Why does the piece price appear when I scan the carton barcode?

Because the Selling Price Per Unit is empty for this barcode, so the product’s selling price is used. Enter the carton price in the row.

Can scanning add more than one piece?

Yes. Enter the number in Quantity, such as 6 for the barcode of a 6-piece pack in the base unit.

Can I import barcodes for many products?

Yes, from Import Product Barcodes.

How do I print the carton barcode label?

From the product page → Voucher → the label template → the carton tab → Print.

Can I restore multiple barcodes after turning them off by mistake?

No. Enter the barcodes again, or import them from a file.