Address Book
Contents
1. Use Cases
Quick Links: Manage Multi-Merchant Addresses | Find Addresses by City | Batch Import Addresses | Export Addresses for Reconciliation
Scenario 1: Manage Receiver Addresses for Multiple Merchants
Situation: As a warehouse operator, you need to manage receiver addresses for multiple merchants, each with different delivery requirements.
How to do it:
- Create dedicated receiver addresses for each merchant in the address book
- Use the "Merchant" filter to quickly switch between merchants
- Set a clear Code for each address (e.g., SHOP-A-WH-01)
- When creating orders, select the corresponding receiver address based on the merchant
Result: Addresses of different merchants are clearly separated; you can quickly filter all addresses of a specific merchant and reduce the risk of selecting the wrong address.
Scenario 2: Quickly Find Receiver Addresses in a Specific City
Situation: You need to view all receiver addresses in Taipei City to plan delivery routes or analyze regional order volume.
How to do it:
- Use the "City" filter and enter "Taipei City"
- The list shows all addresses in Taipei City
- Further refine with the "Merchant" filter for a specific merchant
- Select the addresses you need and click "Export" to keep the results
Result: The list shows all receiver addresses in Taipei City, helping with delivery route planning and cost estimation.
Scenario 3: Batch Import Addresses for a New Merchant
Situation: A newly signed merchant provides a large list of receiver addresses that need to be created in the system quickly.
How to do it:
▸ Prepare the Import File
- Click the "Import" button and download the import template
- Fill in the address data provided by the merchant in Excel
▸ Run the Import
- Select the corresponding merchant and upload the completed Excel file
- Go to "Import Logs" to check the import result and confirm the data is correct
Result: Addresses are created in batch, greatly reducing manual input time, and the standardized format ensures data quality.
Scenario 4: Export a Merchant's Addresses for Reconciliation
Situation: A merchant requests a list of all their receiver addresses for internal verification or backup.
How to do it:
- Use the "Merchant" filter to select the target merchant
- The list shows all addresses of that merchant
- Select the addresses to export (select all is supported)
- Click the "Export" button
Result: When the export is finished the file downloads automatically; you can also click the "Background Jobs" icon in the top right corner to check progress and download the file.
2. Feature Guide
When creating orders manually, you often need to fill in receiver addresses. Entering them from scratch every time is tedious. Save frequently used receiver addresses here so you can simply select them when creating orders. You can also set default addresses for different channels to speed up order processing.
Quick Jump: Search & Filter | Data List | Batch Operations
2.1 Search & Filter
Location: Top of the page
Search box: Search by Code, Receiver Name, Receiver Phone, or Address (matches by leading text)
Filters:
| Filter | Description | Usage |
|---|---|---|
| Code | Enter a code for exact match | Multiple codes supported, one per line |
| Receiver Name | Enter the full name | Multiple names supported |
| Receiver Phone | Enter phone numbers | Multiple numbers supported |
| City | Enter city names | Multiple cities supported |
| Country | Enter countries | Multiple entries supported |
| Merchant | Select a specific merchant | Dropdown, multi-select |
| Default Merchant Channel | Select a specific channel | Dropdown, multi-select |
2.2 Data List
List Columns
| Column | Description | Notes |
|---|---|---|
| Code | Click to view details | Sortable |
| Merchant | Distinguishes addresses of different merchants | - |
| Receiver Name | Contact person for delivery | Sortable |
| Receiver Phone | Contact number for delivery | - |
| City | For regional logistics planning | - |
| District | Pinpoints the delivery area | - |
| Postal Code | Improves delivery efficiency | - |
| Country | Identifies the country for cross-border delivery | - |
| Address | Includes street number, floor, etc. | Full address content |
| Default Channel | Auto-fills addresses for orders | Shown as a blue tag |
| Created At | Tracks when the address was added | Sortable |
💡 Tip: Click the column settings button at the top right of the list to customize which columns are displayed.
2.3 Batch Operations
Top-Right Buttons
| Button | Function | Description |
|---|---|---|
| Import | Batch import from Excel | Template download available; supports overriding existing data |
| New | Create a new address | Opens the new address page |
Batch Operations
After selecting addresses, you can use:
| Button | Function | Description |
|---|---|---|
| Export | Export to Excel | Exports the selected addresses |
3. FAQ
3.1 FAQ
▪ Are there any rules or limits for the Code?
The Code identifies the address. Rules:
- Maximum 50 characters
- Must be unique within the same merchant
- We recommend combining letters, numbers, and hyphens with a meaningful naming convention, e.g., STORE-merchant code-sequence number
▪ Why is there a "Merchant" field?
The warehouse system may serve multiple merchants, so addresses need to be separated by merchant. The "Merchant" field lets you clearly identify which merchant each address belongs to and quickly filter a specific merchant's addresses.
▪ What is the Default Channel for?
The Default Channel associates an address with a specific sales channel. When creating orders, the system can automatically fill in the corresponding receiver address based on the channel, making channel addresses easier to manage and identify.
▪ How do I quickly find a specific address?
Three quick ways:
- Use the search box: Enter the beginning of the Code, name, phone, or address
- Use filters: Apply exact conditions such as "Code", "Receiver Name", or "Merchant"
- Sort: Click "Created At" to find the newest or oldest records
▪ What file format does the import support?
The import supports Excel (.xlsx); please download the template first. Required fields: Code, Receiver Name, Receiver Phone, Address. Other fields (City, District, Postal Code, Default Channel, etc.) are optional.
▪ Can I search multiple Codes at once?
Yes! Use the "Code" filter: enter the first code and press Enter, then continue with the second and third. The list shows all addresses matching those codes.
▪ What is the difference between search and filter?
- Search: Matches the beginning of text across multiple fields; useful when you only remember part of the information
- Filter: Exact match on specific fields; useful for precise conditions or combining multiple conditions
You can use search and filters together; the list shows results matching both.
▪ Can the merchant be changed after selection?
No. Each address must be associated with one merchant, and the merchant cannot be changed once set. You need to select the merchant when creating the address, so please confirm carefully before creating.
▪ Where can I check the import results?
After importing, go to "Import Logs" to check the results. Large files may take a few minutes to process.
▪ Where do I download the exported file?
When the export is finished the file downloads automatically; you can also click the "Background Jobs" icon in the top right corner to check progress and download the file.
3.2 Notices
⚠️ Important Reminders
- Merchant selection: Each address must be associated with one merchant, which cannot be changed once set
- Code uniqueness: Codes must be unique within the same merchant; use a meaningful naming convention
- Data completeness: Receiver Name, Receiver Phone, City, and Address are required; fill them in completely
- Download the template before importing: Using the template prevents import failures caused by missing fields
4. Related Features
| Feature | Description | Link |
|---|---|---|
| New Address | Create a new contact address | Go |
| Address Details | View complete address information | Go |
| Edit Address | Modify address content | Go |
| Import Logs | Check import results | Go |