Shopline
Shopline integration
Quick Summary: Connect a Shopline store to import orders, send fulfillment and tracking updates, and optionally sync inventory. For: Clients Level: Beginner
Overview
Use the Shopline integration to connect a Shopline store to FedEx. The connection can import new and changed orders, send fulfillment and tracking updates to Shopline, and update inventory at mapped locations.
Available controls depend on your access and the settings shown. A new connection does not provide a complete import of older order history.
Before you start
- Confirm that Integrations is available to your user.
- You need write access to add a connection or select Save.
- Have access to the Shopline store that will install the app.
- Confirm that matching SKUs exist for products you want to import.
If +, Save, or an edit control is missing, ask your company administrator for write access.
Quick start
In the username menu at the top right, select Account Management, then select Integrations.
- Select +, then select Shopline.
- Select Continue.
- In the Shopline app store, select Install.
- Review the requested access, then select Install app.
- Review the settings, then select Save.
If Shopline is missing from the store list, ask your Account Manager to verify availability.
Note: The connection does not import complete order history. It starts from the point when the integration is registered.
Setup and authorization
Continue opens the Shopline app store in a new window. Install the app there and approve the requested access. After approval, the integration settings open in FedEx.
If authorization fails, start again from Integrations. Contact support if the same error continues and include the Shopline store name.
Settings
Select Save after changing a field. Mapping changes save after selection.
Status
Active allows future order, fulfillment, and inventory work. Inactive stops scheduled processing and asks Shopline to remove the connection's webhooks. Existing portal orders remain available.
Last Orders Sync is a source order-update watermark. It only advances when the order poll finds a newer Shopline update.
Order import
| Setting | What it controls |
|---|---|
| Sync Payment Statuses | Limits imports to selected Shopline financial statuses |
| Ignore non-shipping items | Leaves non-shipping or non-fulfillable lines out |
| Ignore not found items | Leaves unmatched SKUs out of the imported order |
| Split Sales Order by Location | Creates separate portal orders for different Shopline locations |
| Pull Customs Value From | Selects Portal or Shopline as the customs-value source |
Sync Payment Statuses accepts these exact values:
| Value | Meaning |
|---|---|
unpaid |
Payment has not been received. |
authorized |
Payment is authorized but not captured. |
pending |
Payment is still being processed. |
partially_paid |
Part of the payment has been received. |
paid |
Means fully paid. This is the default. |
partially_refunded |
Part of the order has been refunded. |
refunded |
Means fully refunded. |
Ignore non-shipping items is Yes by default. Ignore not found items is No by default. When enabled, unmatched lines are omitted. Verify the portal catalog before enabling it.
Split Sales Order by Location is No by default. Enable it only when mapped Shopline locations should become separate portal orders.
Pull Customs Value From defaults to Portal. Shopline uses line prices from the Shopline order for customs values.
Fulfillment
| Setting | What it controls |
|---|---|
| Mark Fulfillments | Sends shipment status and tracking to Shopline |
| Send fulfillment notification | Chooses whether Shopline sends its customer notification |
Mark Fulfillments is Yes by default. When No, fulfillment and tracking updates for this connection are not sent to Shopline.
Send fulfillment notification has three choices:
- Yes: Shopline requests a customer notification.
- No: Shopline is asked not to send a notification.
- Use default setting: Shopline applies its store default.
A successful Save stores this preference. It does not prove that Shopline delivered an email.
Inventory and locations
| Setting | What it controls |
|---|---|
| Sync Inventory | Sends portal stock levels to mapped Shopline locations |
| Inventory Threshold | Reserves a quantity for all products |
Sync Inventory is No by default. Inventory updates move from the portal to Shopline. Stock maintained directly in Shopline is not imported into the portal.
Inventory Threshold defaults to 0. The reserve is subtracted from available stock before inventory is sent. The field appears only when Sync Inventory is enabled.
Locations Mapping appears for an existing connection. Map each Shopline location to the relevant warehouses or location addresses. A warehouse or address can be assigned to only one Shopline location. Inventory sync requires at least one mapped location.
When Sync Inventory is enabled, Inventory Thresholds can reserve stock for individual products. A product threshold replaces the global threshold for that SKU.
Returns
| Setting | What it controls |
|---|---|
| Sync return orders | Creates portal return orders from eligible Shopline returns |
| Sending return orders | Sends eligible portal returns to Shopline |
| Close return order | Closes the Shopline return for selected portal return states |
Sync return orders is No by default. It requires return permissions in the connection.
Sending return orders is No by default. It can send a return when the parent order came from Shopline or the return came from an Embedded Form. A return does not qualify when both conditions are absent.
Close return order can use Received and Rejected. Shopline closes the linked return when the portal return enters a selected state.
Filters
Use Filters to limit which Shopline orders are imported. Sales orders can use Shipping Country, Shipping Option, and Item SKU.
| Rule | Import condition |
|---|---|
| Only listed values allowed | Every order value must be listed. The order does not need every listed value. |
| Matches the list exactly | The order values exactly match the list. |
| No listed values allowed | The order contains none of the listed values. |
| All listed values required | The order contains every listed value. Extra values are allowed. |
For Shipping Country and Shipping Option, the required-values condition displays Matches a listed value and accepts any listed value. Matches the list exactly cannot match these single-value fields.
Re-authorization
Re-Authorize appears when the saved connection lacks permissions required by current features. It opens a Shopline authorization window. Complete the prompt in Shopline, then reopen the connection.
How synchronization works
Order sync
Shopline sends supported order, refund, fulfillment, and return events through webhooks. The portal also polls recently updated orders to recover events missed by webhooks.
An order must match its Sync Payment Statuses selection and other import rules. Existing portal orders prevent the same Shopline order from being imported again.
Fulfillment sync
When Mark Fulfillments is Yes, the portal can mark mapped Shopline order lines fulfilled and add tracking after shipment. The portal order needs a tracking number and a usable location mapping.
Customer email behavior depends on Send fulfillment notification and Shopline's store settings.
Inventory sync
When Sync Inventory is Yes, active portal integrations send stock for matching SKUs to mapped Shopline locations. The global or product threshold is applied before the stock value is sent.
Return sync
When Sync return orders is Yes, eligible Shopline returns can create portal return orders. Sending return orders handles eligible portal returns in the other direction. Close return order applies the selected state rules.
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Shopline is missing from the store list | Shopline app access is not configured for this environment. | Ask your Account Manager to verify availability. |
| Authorization does not finish | The app install was closed, declined, or rejected. | Start again from Integrations, then finish both Shopline prompts. |
| Orders do not import | The connection is inactive or the order does not match selected statuses or filters. | Check Status, Sync Payment Statuses, and Filters. |
| Re-Authorize appears | The connection lacks permissions needed by current settings. | Complete authorization, then reopen the connection. |
| Last Orders Sync does not move | The poll found no newer source order updates. | Treat it as a source watermark. Ask support to inspect diagnostics. |
| Fulfillments do not appear in Shopline | Fulfillment updates are off, tracking is missing, or no location is mapped. | Check Mark Fulfillments, tracking, and Locations Mapping. |
| Inventory does not update | Inventory sync is off, no location is mapped, or no SKU matches. | Check Sync Inventory, Locations Mapping, and product SKUs. |
| Return settings cannot be saved | The connection lacks required return permissions. | Select Re-Authorize, approve access, then save again. |
| Checkout rates do not appear | Courier rates are off or Carrier Calculated Rates are unavailable. | Enable courier rates and verify the Shopline checkout setup. |
| Insurance cannot be enabled | Insurance access is not available for the account. | Ask your Account Manager to review insurance access. |
| Older orders are missing | The connection does not backfill earlier order history. | Ask support whether a supported recovery is available. |
For broader diagnosis, see Integration Troubleshooting.