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.

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.
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| Element | Type | Function |
|---|---|---|
| Export Template | Button | Downloads a blank template file with the correct column headers |
| Import | Button | Opens file picker to select a completed template for upload |
| Import History | Data Grid | Shows past import batches with success/failure counts |
Use Importer to manage and configure this feature in your EQuipWeb system.
| Column | Required | Description |
|---|---|---|
| ItemNo | ✅ Yes | The existing product's item number (must already exist in the system) |
| AltBarcode | ✅ Yes | The alternative barcode value to associate with this product |
| Description | No | Optional description for the barcode (e.g., "Outer Carton", "Supplier UPC") |
| UOM | No | Unit of measurement for the barcode variant (e.g., "CTN" for carton, "PCS" for pieces) |
| QtyPerUOM | No | Quantity per unit — how many individual items are in this barcode's unit (e.g., 12 for a carton of 12) |
| ItemNo | AltBarcode | Description | UOM | QtyPerUOM |
|---|---|---|---|---|
| SKU001 | 8901234567890 | Supplier UPC | PCS | 1 |
| SKU001 | 8901234567891 | Carton Barcode | CTN | 12 |
| SKU002 | 4901234567893 | JP Import Barcode | PCS | 1 |
Use Importer to manage and configure this feature in your EQuipWeb system.
The system validates each row during import:
| Validation | Error If... |
|---|---|
| Item Exists | ItemNo does not match any existing product → "Item Not Found" |
| Barcode Unique | AltBarcode already exists on another product → "Duplicate Barcode" |
| Barcode Not Empty | AltBarcode column is blank → "Barcode Required" |
| Format Valid | Barcode contains invalid characters → "Invalid Barcode Format" |
| Column | Description |
|---|---|
| Import Date | When the import was processed |
| File Name | Uploaded file name |
| Total Rows | Number of rows in the file |
| Success | Number of rows imported successfully |
| Failed | Number of rows that failed validation |
| Status | Overall status: Complete, Partial, or Failed |
| Download Log | Download the detailed error log for failed rows |
Use Importer to manage and configure this feature in your EQuipWeb system.
Once imported, alternative barcodes work seamlessly at the POS:
| Action | Result |
|---|---|
| Scan alt barcode | Resolves to the original product (same as scanning primary barcode) |
| Qty conversion | If QtyPerUOM is set, scanning a carton barcode auto-adjusts quantity (e.g., scanning 1 carton = 12 pieces) |
| Search | Alt barcodes are searchable in the POS item search |
| Reports | Sales are attributed to the primary product regardless of which barcode was scanned |
Use Importer to manage and configure this feature in your EQuipWeb system.
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:

3. Fill in:

| ItemNo | AltBarcode | Description | UOM | QtyPerUOM |
|---|---|---|---|---|
| SNACK-001 | 4901234567890 | JP Barcode | PCS | 1 |
| SNACK-002 | 4901234567891 | JP Barcode | PCS | 1 |
| BEVER-003 | 4901234567892 | JP Carton | CTN | 24 |
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.
| Role | View | Create | Edit | Delete |
|---|---|---|---|---|
| Admin | Yes | Yes | Yes | Yes |
| Supervisor | Yes | Yes | Yes | No |
| Cashier | No 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.
Expected Result: Alternate barcodes are linked to the specified products. Scanning either the original or alternate barcode at POS will find the same product.
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.
| Issue | Possible Cause | Solution |
|---|---|---|
| Upload fails with error | File format is not .xlsx or file is corrupted | Download a fresh template, re-enter data, and try again |
| Validation errors on rows | Missing required fields or invalid data format | Check the error details column for specific row issues |
| "Duplicate record" warning | Data already exists in the system | Check if the record exists and decide whether to update or skip |
| Import shows 0 records processed | File is empty or wrong template version | Verify the file has data rows and uses the latest template |
| Error 404 on upload | File too large or server timeout | Split the file into smaller batches (max 500 rows recommended) |
| Data imported but not visible | Filters hiding the new records | Clear all filters and search for the imported records |
Use Importer to manage and configure this feature in your EQuipWeb system.
Use Importer to manage and configure this feature in your EQuipWeb system.
[!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 | Required | Description |
|---|---|---|
| Name / Title | Yes | The display name for this record |
| Status / Active | — | Whether this record is active in the system |
| Created Date | Auto | System-generated creation timestamp |
| Modified Date | Auto | System-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.