EC Integration: Shopline
Table of Contents
- Section 1: Use Cases — 2 Application Examples
- Section 2: Feature Guide — Connection / API Key / Settings
- Section 3: FAQ — 7 FAQs + Notes
- Section 4: Related Features
Section 1: Use Cases
Quick Links: Connect a Brand Store | Update the Key
Scenario 1: Connect a Shopline Brand Store
Situation: A merchant runs their brand website on Shopline and wants website orders imported into the warehouse system automatically.
How to Do It:
▸ Create the Account and Test the Connection
- Ask the merchant to obtain an API key from the Shopline admin
- Click "New" on the "EC Integrations" page
- Select the merchant this account belongs to
- Choose "Shopline" as the "E-commerce Platform", fill in the "Display Name", and select the "Channel Name"
- Paste the key into "貨主金鑰"
- Click "Test Connection" and confirm "Connection Successful" appears
▸ Complete the Settings
- In the "Settings" panel on the right, enable "Fetch Orders" and select the "Fetch Schedule"
- Configure the "Shipping Type Mappings"
- Click "Save"
Result: The system fetches Shopline orders automatically at the scheduled times; check them in the Orders list.
Scenario 2: Merchant Replaced the Key, Update Settings
Situation: The merchant regenerated the key in the Shopline admin; the old key stopped working and orders stopped importing.
How to Do It:
- Find the account in the "EC Integrations" list and open it for editing
- Paste the new key into "貨主金鑰"
- Click "Test Connection" and confirm it succeeds
- Click "Save"
Result: The connection is restored and order fetching resumes.
Section 2: Feature Guide
Shopline is an independent e-commerce platform that merchants use to quickly build brand websites. Once integrated, the system fetches new orders from the Shopline store on schedule, automatically sends tracking numbers back to Shopline after shipment, and can optionally push stock to the store when inbound completes. Shopline integrates via a key obtained from the Shopline admin.
Quick Links: Connection Info | Key Setup | Settings
2.1 Connection Info
| Field | Description | Required |
|---|---|---|
| Merchant | The merchant this account belongs to (selected first when creating) | ✓ |
| E-commerce Platform | Select "Shopline"; cannot be changed after creation | ✓ |
| Display Name | Custom account name for identification (e.g., Brand Website) | ✓ |
| Channel Name | Select the corresponding sales channel; if missing, create it under Sales Channels first | ✓ |
2.2 Key Setup
How to Get a Shopline API Key
- Log in to the Shopline store admin
- Go to "Settings" → "Integrations" or "API Settings"
- Find or create an API key
- Copy the key; if you cannot find the setting, contact Shopline support
| Field | Description | Required |
|---|---|---|
| Merchant Key | API key obtained from the Shopline admin | ✓ |
Test Connection: After entering the key, click "Test Connection". The settings panel on the right unlocks only after "Connection Successful" appears.
2.3 Settings
Order Fetching
| Field | Description |
|---|---|
| Fetch Orders | When enabled, the system fetches orders automatically |
| Fetch Schedule | Up to 3 time slots; at least 1 is required when order fetching is enabled |
Stock Push
| Field | Description |
|---|---|
| Inbound Push | When enabled, stock is pushed to the Shopline store when inbound completes |
| Push Percentage | Percentage of stock pushed to the platform when inbound completes (0–100%) |
Shipping Type Mappings
Shopline shipping codes must be mapped to warehouse shipping types:
- Click "Add Mapping"
- Enter the Shopline-side shipping code in "Platform Code"
- Select the warehouse shipping method in "Warehouse Shipping Type"
Create a mapping for each shipping option the merchant configured in Shopline; orders with unmapped shipping methods may not be processed correctly.
Section 3: FAQ
3.1 FAQ
▪ How do I get an API key from the Shopline admin?
- Log in to the Shopline store admin
- Go to "Settings" → "Integrations" or "Apps"
- Find the API settings section, create or view an existing key
- Copy the key into this system
If you cannot find the setting, contact Shopline support.
▪ What if the connection test fails?
Check in order:
- Was the key copied correctly (watch for leading/trailing spaces)?
- Is the key enabled?
- Is the Shopline store operating normally?
The "Connection Failed" notice on screen shows the failure reason for troubleshooting.
▪ Why are orders not being fetched automatically?
Check in order:
- Is "Fetch Orders" enabled?
- Is a "Fetch Schedule" set?
- Is the connection status "Connected"?
▪ How do I set up shipping mappings?
Every Shopline shipping method needs a mapping to a warehouse shipping type:
- Based on the shipping options the merchant configured in Shopline
- Create each mapping under "Shipping Type Mappings"
- Orders with unmapped shipping methods may not be processed correctly
▪ Can I set up multiple Shopline stores?
Yes. If a merchant has multiple Shopline stores, create a separate account for each with its own key.
▪ Does the key expire?
Shopline keys generally do not expire automatically. However, if the key is regenerated in the Shopline admin, the old key becomes invalid — update the settings in this system and test the connection again.
▪ How do I push stock to Shopline?
Enable "Inbound Push" and set the "Push Percentage" in the "Settings" panel. Once enabled, the system pushes stock to Shopline products when inbound completes.
3.2 Notes
⚠️ Important Reminders
- Key security: Keep the key safe and do not share it with others
- Complete all shipping mappings: Every shipping method used in Shopline needs a mapping
- Test before enabling: Test the connection successfully before enabling order fetching
- Watch the push percentage: When the combined push percentage across platforms reaches 100% or more, the system warns of potential overselling
Section 4: Related Features
| Feature | Description | Link |
|---|---|---|
| Order List | View orders fetched from Shopline | Go |
| Shipping Types | Configure warehouse shipping methods | Go |
| Sales Channels | Manage merchant sales channel settings | Go |