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).

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.
| Column | Required | Description |
|---|---|---|
| MembershipNo | ✅ Yes | Unique member ID. If exists → update; if new → create. |
| Name | ✅ Yes | Member's full name |
| MembershipGroupName | ✅ Yes | Must match an existing Membership Group (e.g., "REGULAR", "VIP") |
| DateOfBirth | No | Format: DD/MM/YYYY |
| Gender | No | M = Male, F = Female |
| No | Email address | |
| MobileNo | No | Phone number with country code (e.g., "+6591234567") |
| Address | No | Physical address |
| PostalCode | No | Postal/ZIP code |
| Country | No | Country name or code |
| ExpiryDate | No | Membership expiry date (format: DD/MM/YYYY) |
| Points | No | Opening point balance (for migration only) |
| Remark | No | Internal notes |
| MembershipNo | Name | MembershipGroupName | DateOfBirth | Gender | MobileNo | |
|---|---|---|---|---|---|---|
| MEM001 | Sarah Tan | REGULAR | 15/03/1990 | F | sarah@email.com | +6591234567 |
| MEM002 | David Lim | VIP | 22/08/1985 | M | david@email.com | +6598765432 |
Use Importer to manage and configure this feature in your EQuipWeb system.
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.

Use Importer to manage and configure this feature in your EQuipWeb system.
| Rule | Description |
|---|---|
| MembershipNo must be unique | Duplicate numbers within the file are rejected |
| MembershipGroupName must exist | Must match an existing group in the system |
| Email format validation | Invalid email formats are rejected |
| Date format validation | Dates must be in DD/MM/YYYY format |
| Phone number format | Should include country code prefix |
Use Importer to manage and configure this feature in your EQuipWeb system.
| Scenario | What Happens |
|---|---|
| New MembershipNo | A new member record is created |
| Existing MembershipNo | The existing record is updated with the CSV data |
| Missing optional fields | Existing values are preserved (not overwritten with blank) |
| Points column | Only used for initial migration — does not add/deduct from existing balance |
Use Importer to manage and configure this feature in your EQuipWeb system.
Scenario: A retailer migrates 5,000 members from an old CRM system to EQuip.
Steps:

[!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.
| 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.

Click Download Template to get the Excel template with correct column headers.
Open the template and fill in your data according to the column headers.

✅ Expected Result: Data is imported and available in the system.
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.