ZenotiHelp

Product barcodes and codes

ZTZenoti Docs Team Updated September 23, 2026 4 min readGuide

Manage barcodes and identification codes for products, including multiple barcodes per product, barcode scanning, and special codes like HSN and CSI.

Audience: Administrators who manage the product catalog.

Before you begin

Permission: Edit (under Products) — Required to manage barcodes.

  • The product must already exist. See Create and manage products.
  • The CSI item code field is only visible when the CSI integration is active for your organization.

Steps

Add a barcode to a product

  1. Go to Inventory > Products.
  2. Open the product you want to configure. The product opens on the GENERAL tab.
  3. Next to Product Barcodes, select Define Product Barcodes. The Product Barcodes dialog opens.
  4. In Barcode, enter the barcode value.
  5. If this barcode should be the primary barcode for the product, select the Primary checkbox.
  6. Close the dialog, and then select Save on the GENERAL tab.

Note: Barcodes must be unique across your organization. If your organization uses zone-level product management, uniqueness is checked within the zone instead, so the same barcode can exist in two different zones. If you enter a barcode that already belongs to another live product in scope, the save is rejected with "A product with the same barcode already exists."

Deactivating a product does not free its barcode — an inactive product keeps every barcode assigned to it, so reusing that code on a new product is still rejected. To free a barcode, remove it from the old product in the Product Barcodes dialog, or delete the old product. Using a different code is the third option.

Important: When you add a barcode that another live product already owns, the product record itself can still save while the barcode is silently not attached. Nothing reports this at the time. After adding a barcode, reopen the Product Barcodes dialog and confirm the barcode is listed before relying on it at the scanner.

Set the primary barcode

A product can have multiple barcodes, but only one can be designated as the primary barcode. The primary barcode is used for default barcode scanning and lookup.

  1. Open the product, and then select Define Product Barcodes on the GENERAL tab.
  2. In Barcode, enter the barcode you want to make primary.
  3. Select the Primary checkbox.
  4. Close the dialog, and then select Save.

The Product Barcodes dialog lists every barcode on the product under the BARCODE and PRIMARY columns, so you can confirm which barcode is currently primary. Use the delete icon beside a row to remove a barcode.

Scan a barcode for product lookup

At the POS (Point of Sale), scanning a product barcode automatically looks up the product and adds it to the transaction. The system searches all barcodes (not only the primary one) for a match.

Add an HSN code

HSN (Harmonized System Nomenclature) codes are used for tax classification:

  1. Open the product. The product opens on the GENERAL tab.
  2. Enter the code in HSN.
  3. Select Save.

Add a CSI item code

If your organization has the CSI integration active, the CSI item code field appears on the product:

  1. Open the product. The product opens on the GENERAL tab.
  2. Enter the CSI item code in the designated field.
  3. Click Save.

Note: The CSI item code field is only visible when the CSI integration is enabled for your organization. Contact your administrator if you do not see this field.

Import barcodes in bulk

To assign or update barcodes across many products at once, use the barcode bulk import in Configuration > Import/Export or via Inventory > Products > Import.

The page is Import bulk data (Configuration > Business details > Business setup > Import bulk data, center scope). Under the Products group, choose the Product Barcode import type. The template columns are RowId, ZoneName, ProductCode, Barcode, IsPrimary, CreatedOnDate and Action (Add or Delete); RowId, ProductCode, Barcode and IsPrimary are required, and a barcode can be at most 10 characters. Your role needs the ProductBarcodeImport check box under DataIO in the Administrator section of the security role.

Before you import:

  • Download the barcode import template from the Import/Export page to get the correct column structure.
  • Barcodes are unique at the organization level — a barcode that already belongs to another product in your organization will be rejected on import. If your organization uses zone-level product management, the check is made within the zone instead.

IsPrimary field behavior: The import file includes an IsPrimary column that controls which barcode is designated as the primary barcode for each product:

  • A product can have multiple barcodes, but only one can be IsPrimary = true.
  • If you are adding a new barcode that should become the primary, set IsPrimary to true in that row.
  • IsPrimary is a required column — every row must carry a value.

Import errors:

  • Duplicate barcode: A barcode value already exists on another product in the organization (or, with zone-level product management, in the same zone). Each barcode must be unique within that scope — correct or remove the duplicate row before re-importing.
  • Product not found: The product code in the row does not match an existing product. Verify the product code and correct the row.

Note: The Product Barcode import is accepted only when every row is valid — a file with any invalid row is rejected as a whole. Review the import results to identify the flagged rows, correct them, and import the file again.

Tips

  • You can add multiple barcodes per product to accommodate different barcode formats or packaging sizes for the same product.
  • Barcode uniqueness is enforced at the organization level — the same barcode cannot be assigned to two different live products in the same organization. With zone-level product management enabled, uniqueness is enforced within the zone, so the same barcode can exist in two different zones.
  • Use bulk operations to manage barcodes across many products at once. See Bulk operations.
Was this article helpful?
Your feedback helps us improve our documentation.