Membership Importer

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 spreadsheet. If you're migrating from another system or have a list of customers to enroll, prepare the member details in Excel and upload them here.

When to use this: When you need to add or update many member records at once from a spreadsheet (e.g., migrating from another system).

Prerequisites

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

Membership Importer

📝 General Description

This importer creates new membership records or updates existing ones from a CSV file. Each row represents one member. The system validates membership numbers, email addresses, and phone numbers during import.


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

10.3.1 Template Columns

ColumnRequiredDescription
MembershipNo✅ YesUnique member ID. If exists → update; if new → create.
Name✅ YesMember's full name
MembershipGroupName✅ YesMust match an existing Membership Group (e.g., "REGULAR", "VIP")
DateOfBirthNoFormat: DD/MM/YYYY
GenderNoM = Male, F = Female
EmailNoEmail address
MobileNoNoPhone number with country code (e.g., "+6591234567")
AddressNoPhysical address
PostalCodeNoPostal/ZIP code
CountryNoCountry name or code
ExpiryDateNoMembership expiry date (format: DD/MM/YYYY)
PointsNoOpening point balance (for migration only)
RemarkNoInternal notes

Sample Template

MembershipNoNameMembershipGroupNameDateOfBirthGenderEmailMobileNo
MEM001Sarah TanREGULAR15/03/1990Fsarah@email.com+6591234567
MEM002David LimVIP22/08/1985Mdavid@email.com+6598765432

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

10.3.2 How to Import Members

  1. Navigate to Data Importer → Membership Importer.

2. Click Download Template to get the CSV template.

3. Open in Excel and fill in member data (one row per member).

4. Ensure MembershipGroupName values match exactly with groups configured in Membership Group (Section 3.2). 5. Save as CSV. 6. Click Browse → Select your CSV file.

7. Click Upload to start the import.

  1. Review the results:
    • Created: New member records created.
    • 🔄 Updated: Existing members updated with new data.
    • Error: Invalid data — check the error details for each failed row.

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

10.3.3 Validation Rules

RuleDescription
MembershipNo must be uniqueDuplicate numbers within the file are rejected
MembershipGroupName must existMust match an existing group in the system
Email format validationInvalid email formats are rejected
Date format validationDates must be in DD/MM/YYYY format
Phone number formatShould include country code prefix

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

10.3.4 Import Behavior

ScenarioWhat Happens
New MembershipNoA new member record is created
Existing MembershipNoThe existing record is updated with the CSV data
Missing optional fieldsExisting values are preserved (not overwritten with blank)
Points columnOnly used for initial migration — does not add/deduct from existing balance

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

💡 Example

Scenario: A retailer migrates 5,000 members from an old CRM system to EQuip.

Steps:

  1. Export member data from the legacy CRM.
  2. Format it into the EQuip template (map old fields to EQuip columns).
  3. Ensure the MembershipGroupName column uses groups that already exist in EQuip (create them first if needed).
  4. Import in batches of 1,000 rows for easier troubleshooting.
  5. After import, verify by checking the Membership List (Section 3.1).

[!WARNING] The Points column should only be used during initial migration to set opening balances. For ongoing point adjustments, use the membership edit form or point adjustment features.

[!TIP] Before importing a large batch, test with 5–10 rows first to catch formatting issues early. Fix any errors, then import the full batch.


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 Data

  1. Navigate to Data Importer & Exporter → Membership Importer from the sidebar menu.

  1. Click Download Template to get the Excel template with correct column headers.

  2. Open the template and fill in your data according to the column headers.

  1. Save the completed Excel file.
  2. Click Choose File and select your completed template.
  3. Click Import to upload and process the file.
  4. Review the validation results — fix any errors and re-upload if needed.
  5. Click Confirm Import to finalize.

Expected Result: Data is imported and available in the system.


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

    • 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 ...
    • 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 ...
    • 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 ...
    • Low Qty Importer

      ? Backend — EQuipWebRetail ModeData Importer & Exporter Chapter 10: Data Importer — 10.6 Low Qty Importer Use Importer to manage and configure this feature in your EQuipWeb system. Use the Low Qty Importer to set stock alert levels for many products ...
    • Supplier Product Importer

      ? Backend — EQuipWebRetail ModeData Importer & Exporter Chapter 10: Data Importer — 10.5 Supplier Product Importer Use Importer to manage and configure this feature in your EQuipWeb system. Use the Supplier Product Importer to link many products to ...