Shopline
Shopline Integration
Quick Summary: Connect your Shopline store using OAuth to import orders, push fulfillment updates, and manage returns.
Overview
The Shopline integration connects your Shopline store to Floship using Shopline's secure OAuth authorization. Once connected, orders are imported automatically, fulfillment updates with tracking numbers are pushed when orders ship, and return requests can be imported.
Quick Start
- Navigate to Integrations and click Add New Integration
- Select Shopline
- Enter your Shopline store domain and click Continue
- Log in to Shopline and authorize the connection
- Configure sync settings on the integration detail page
- Click Save
Before You Connect
Make sure you have:
- Merchant admin access to your Shopline store
- Your Shopline store domain (the subdomain part before
.myshopline.com) - Matching SKUs already created in Floship
- Correct product customs values in Floship, if Floship should use portal customs data
Connecting Your Shopline Store
Step 1: Start the Connection
-
Click your profile icon → Account Management → Integrations
-
Click Add New Integration
- Select Shopline from the platform list
- Enter your Shopline store domain when prompted
- Click Continue to begin authorization
Step 2: Log In and Authorize
You will be redirected to the Shopline login page. Enter your Shopline account credentials and sign in. Review the permissions requested and click Authorize and Install to complete the connection.
Step 3: Configure Settings
After successful authorization, you will be redirected back to Floship. The integration shows as Active. Review and adjust the settings described below, then click Save.
Tip: Orders will start importing automatically within minutes of connecting.
Integration Settings
Status
Toggle between Active and Inactive. When inactive, no orders are imported and no sync occurs. When you re-activate a previously inactive integration, the system reconnects and resumes order import automatically.
Order Sync Settings
| Setting | Description |
|---|---|
| Sync Payment Statuses | Choose which Shopline payment statuses trigger order import |
| Ignore non-shipping items | Skip line items that do not require physical shipping |
| Ignore not found items | Continue importing an order when an item cannot be matched |
| Split sales order by location | Create separate orders in Floship based on Shopline locations |
| Mark Fulfillments | Push tracking numbers and fulfillment status back to Shopline when orders ship |
| Send fulfillment notification | Control whether Shopline sends shipping notification emails to your customers |
| Pull Customs Value From | Choose where customs values come from for international shipments |
Inventory Sync Settings
| Setting | Description |
|---|---|
| Sync Inventory | Push inventory levels from Floship to your Shopline store |
| Inventory Threshold | A reserved quantity to subtract from available stock before pushing to Shopline |
When Sync Inventory is enabled, you can also configure per-product thresholds for specific SKUs. Use the Inventory Thresholds section on the integration detail page to set reserves for high-demand items.
Return Order Settings
| Setting | Description |
|---|---|
| Sync Return Orders | Import Shopline return requests into Floship |
| Sending return orders | Create return records in Shopline for eligible returns started in Floship |
| Close return order | Choose which return statuses close the return in Shopline |
Filters
Use filters to control which orders are imported from your Shopline store. Set rules based on Shipping Country, Shipping Option, or Item SKU to import only the orders you want Floship to process.
Location Mapping
When Split sales order by location is enabled or when using inventory sync, you can map Shopline locations to Floship warehouses. Use the Locations Mapping section on the integration detail page to assign each Shopline location to a ship-from warehouse.
Re-Authorization
If your Shopline connection expires or permissions change, you may need to re-authorize:
- Open your Shopline integration in Floship
- Click the Re-Authorize button
- Complete the authorization flow in Shopline
- Your integration reconnects automatically
How Order Sync Works
- Real-time: Shopline sends notifications when orders are created, updated, cancelled, or paid
- Scheduled: The system also checks your store regularly for any orders the real-time updates may have missed
- Orders matching your filter rules and payment status settings are imported
- The Last Orders Sync timestamp shows when orders were last imported
How Fulfillment Sync Works
When an order is shipped from Floship:
- The tracking number and carrier information are pushed to Shopline
- The Shopline order is marked as fulfilled
- If Send fulfillment notification is enabled, Shopline emails the customer with tracking details
How Inventory Sync Works
When Sync Inventory is enabled:
- Floship monitors stock level changes
- Updated quantities (minus any threshold) are pushed to your Shopline store
- If location mapping is configured, stock is updated at the correct Shopline location
- Per-product thresholds override the global threshold for specific SKUs
Tip: Inventory sync is one-way: from Floship to Shopline. Changes made directly in Shopline will be overwritten on the next sync.
How Return Order Sync Works
When Sync Return Orders is enabled:
- Shopline return requests are imported into Floship
- Eligible returns started in Floship can be sent back to Shopline
- Return status updates are managed through the standard returns process
Actions
| Button | Description |
|---|---|
| Re-Authorize | Reconnect your Shopline store if authorization has expired |
| Save | Save your current settings |
| Close | Return to the integrations list without saving |
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Orders not importing | Integration inactive or payment status filter mismatch | Check that the integration is Active and review Sync Payment Statuses — ensure the correct statuses are selected |
| "Re-Authorize" banner appears | Shopline authorization token expired | Click Re-Authorize and complete the OAuth flow |
| Fulfillments not appearing in Shopline | Fulfillment sync disabled | Ensure Mark Fulfillments is enabled |
| Wrong orders importing | Filter rules too broad | Review your Filters settings to ensure only the desired orders are included |
| Duplicate orders | Multiple integrations for same store | Check that you have only one active Shopline integration per store domain |
| Return orders not importing | Sync Return Orders is disabled | Enable Sync Return Orders in the integration settings |
| Issue | Cause | Solution |
| ------- | ------- | ---------- |
| Inventory not updating in Shopline | Sync disabled or location mapping missing | Verify Sync Inventory is enabled and check that location mappings are configured correctly |
For more troubleshooting help, see Integration Troubleshooting.