Alt Barcode Importer

Alt Barcode Importer

🌐 Backend — EQuipWebRetail ModeData Importer & Exporter

Chapter 11: Data Importer & Exporter — 11.5 Alt Barcode Importer

Use Importer to manage and configure this feature in your EQuipWeb system.

Use the Alt Barcode Importer to assign additional barcodes to your products in bulk. Some products have multiple barcodes (different pack sizes, supplier codes, or regional variants) — upload them all at once from a spreadsheet.

When to use this: When you need to add multiple alternative barcodes to existing products at once using a spreadsheet.

Prerequisites

  • User must have appropriate role permissions (see Access & Permissions above)

Alt Barcode Import

📝 General Description

This importer uses the standard EQuip import workflow: download a template, fill in the data offline, then upload the completed file. Each row maps one alternative barcode to an existing product. Once imported, all alternative barcodes function identically to the primary barcode at the POS — scanning any barcode resolves to the same product.


Use Importer to manage and configure this feature in your EQuipWeb system.

11.5.1 Import Workflow

Step 1: Export Template → Download blank CSV/Excel template
Step 2: Fill Data     → Enter product item numbers + alternative barcodes
Step 3: Import        → Upload the completed file
Step 4: Review        → Check the import history grid for success/error status

UI Elements

ElementTypeFunction
Export TemplateButtonDownloads a blank template file with the correct column headers
ImportButtonOpens file picker to select a completed template for upload
Import HistoryData GridShows past import batches with success/failure counts

Use Importer to manage and configure this feature in your EQuipWeb system.

11.5.2 Template Columns

ColumnRequiredDescription
ItemNo✅ YesThe existing product's item number (must already exist in the system)
AltBarcode✅ YesThe alternative barcode value to associate with this product
DescriptionNoOptional description for the barcode (e.g., "Outer Carton", "Supplier UPC")
UOMNoUnit of measurement for the barcode variant (e.g., "CTN" for carton, "PCS" for pieces)
QtyPerUOMNoQuantity per unit — how many individual items are in this barcode's unit (e.g., 12 for a carton of 12)

Example Template Data

ItemNoAltBarcodeDescriptionUOMQtyPerUOM
SKU0018901234567890Supplier UPCPCS1
SKU0018901234567891Carton BarcodeCTN12
SKU0024901234567893JP Import BarcodePCS1

Use Importer to manage and configure this feature in your EQuipWeb system.

11.5.3 Import Validation

The system validates each row during import:

ValidationError If...
Item ExistsItemNo does not match any existing product → "Item Not Found"
Barcode UniqueAltBarcode already exists on another product → "Duplicate Barcode"
Barcode Not EmptyAltBarcode column is blank → "Barcode Required"
Format ValidBarcode contains invalid characters → "Invalid Barcode Format"

Import History Grid

ColumnDescription
Import DateWhen the import was processed
File NameUploaded file name
Total RowsNumber of rows in the file
SuccessNumber of rows imported successfully
FailedNumber of rows that failed validation
StatusOverall status: Complete, Partial, or Failed
Download LogDownload the detailed error log for failed rows

Use Importer to manage and configure this feature in your EQuipWeb system.

11.5.4 POS Behavior After Import

Once imported, alternative barcodes work seamlessly at the POS:

ActionResult
Scan alt barcodeResolves to the original product (same as scanning primary barcode)
Qty conversionIf QtyPerUOM is set, scanning a carton barcode auto-adjusts quantity (e.g., scanning 1 carton = 12 pieces)
SearchAlt barcodes are searchable in the POS item search
ReportsSales are attributed to the primary product regardless of which barcode was scanned

Use Importer to manage and configure this feature in your EQuipWeb system.

💡 Example

Scenario: A supermarket receives a shipment of products from a new Japanese supplier. The products have both local SG barcodes (already in the system) and original Japanese barcodes on the packaging. Cashiers need to scan either barcode.

Setup:

  1. Navigate to Alt Barcode Importer → Click Export Template.

  1. Open the template in Excel.

3. Fill in:

ItemNoAltBarcodeDescriptionUOMQtyPerUOM
SNACK-0014901234567890JP BarcodePCS1
SNACK-0024901234567891JP BarcodePCS1
BEVER-0034901234567892JP CartonCTN24
  1. Save the file and click Import.

5. Check the import history — all 3 rows should show "Success".

6. Now cashiers can scan either the SG barcode or the JP barcode for these products.

[!TIP] Use the QtyPerUOM field when importing carton or multi-pack barcodes. This way, scanning a carton barcode at the POS automatically sets the quantity to the correct number of individual items — saving time during bulk receiving.

[!WARNING] Each barcode must be globally unique across the entire system. If you try to import a barcode that already belongs to another product, the import will fail for that row. Check for duplicates before importing.


Use Importer to manage and configure this feature in your EQuipWeb system.

Access & Permissions

RoleViewCreateEditDelete
AdminYesYesYesYes
SupervisorYesYesYesNo
CashierNo backend access

[!NOTE] Exact permissions depend on the Privileges Setup configured for each role. Contact your administrator if you cannot access this page.


Use Importer to manage and configure this feature in your EQuipWeb system.

How to Import Alternate Barcodes

  1. Navigate to Data Importer & Exporter > Alternate Barcode Importer from the sidebar menu.
  2. Click Download Template to get the Excel template.
  3. Fill in the data: Item Number (existing product) and the Alternate Barcode value.
  4. Save the completed file.
  5. Click Choose File and select your completed template.
  6. Click Import to upload.
  7. Review the validation results — ensure all Item Numbers match existing products.
  8. Click Confirm Import to finalize.

Expected Result: Alternate barcodes are linked to the specified products. Scanning either the original or alternate barcode at POS will find the same product.


FAQ

Q: What file format should I use for import? A: Use .xlsx (Excel) format. Download the blank template from the importer page to ensure correct column structure.

Q: Can I undo an import? A: No. Imports cannot be automatically reversed. You would need to manually correct or delete the imported records.

Q: Why does my import show validation errors? A: Check the error details for each row. Common issues include: missing required fields, duplicate codes, invalid date formats, or referencing categories/departments that don't exist yet.


Use Importer to manage and configure this feature in your EQuipWeb system.

Troubleshooting

IssuePossible CauseSolution
Upload fails with errorFile format is not .xlsx or file is corruptedDownload a fresh template, re-enter data, and try again
Validation errors on rowsMissing required fields or invalid data formatCheck the error details column for specific row issues
"Duplicate record" warningData already exists in the systemCheck if the record exists and decide whether to update or skip
Import shows 0 records processedFile is empty or wrong template versionVerify the file has data rows and uses the latest template
Error 404 on uploadFile too large or server timeoutSplit the file into smaller batches (max 500 rows recommended)
Data imported but not visibleFilters hiding the new recordsClear all filters and search for the imported records

Use Importer to manage and configure this feature in your EQuipWeb system.

  • Product Setup > Product List — imported product destination
  • Membership Setup > Membership List — imported member destination
  • Master Data > Supplier Setup — supplier data reference

Use Importer to manage and configure this feature in your EQuipWeb system.

Open Questions / Confirmation Needed

[!NOTE] The following items may vary depending on your system version and configuration:

  • Exact permission settings depend on your Privileges Setup configuration
  • Sync timing to POS terminals depends on network conditions and sync schedule
  • Some features may require additional licensing or module activation
  • Field behavior may differ between EQuip versions

If you encounter behavior not described in this manual, contact your system administrator or EQuip support team.

Expected Result: Changes are saved successfully and reflected across the system after the next POS sync.


Field Reference

FieldRequiredDescription
Name / TitleYesThe display name for this record
Status / ActiveWhether this record is active in the system
Created DateAutoSystem-generated creation timestamp
Modified DateAutoSystem-generated last modification timestamp

[!NOTE] Additional fields specific to this page are documented in the sections above. The table above shows common fields present across most pages.

    • Related Articles

    • Barcode Printing

      ? Backend — EQuipWebRetail ModeProduct Setup Chapter 2: Product Setup — 2.8 Barcode Printing Use Barcode Printing to generate and print barcode labels for your products. Select the products you need labels for, choose your label size, and print — ...
    • Product Importer

      ? Backend — EQuipWebRetail ModeData Importer & Exporter Data Importer & Exporter — 11.1 Step-by-step guide to bulk importing products, download template, import modal controls, and troubleshooting import errors Use Importer to manage and configure ...
    • Promotion Importer

      ? Backend — EQuipWebRetail ModeData Importer & Exporter Chapter 10: Data Importer — 10.4 Promotion Importer Use Importer to manage and configure this feature in your EQuipWeb system. Use the Promotion Importer to create or update many promotions at ...
    • Membership Importer

      ? Backend — EQuipWebRetail ModeData Importer & Exporter Chapter 10: Data Importer — 10.3 Membership Importer Use Importer to manage and configure this feature in your EQuipWeb system. Use the Membership Importer to add many members at once from a ...
    • Material Importer

      ? Backend — EQuipWebRetail ModeData Importer & Exporter Chapter 11: Data Importer & Exporter — 11.6 Material Importer Use Importer to manage and configure this feature in your EQuipWeb system. Use the Material Importer to upload raw material and ...