Shopify Gateway

Shopify Gateway

Connect your Shopify store and sync everything automatically

The Shopify Gateway flow runs on the Gateway Integrations screen. It uses the gateway web components (Add New Store, marketplace cards for Shopify, and the Integration settings panel) and the ShipEdge gateway API so your account can connect a Shopify store and sync orders and inventory.

Use it when you need a direct Shopify connection instead of only CSV templates or other integration types on Integrations.

Quick Start

Orders → Integrations → Gateway Integrations → Add New Store → Shopify, then complete Shopify install and sign in to ShipEdge with your warehouse URL.

Why Use the Shopify Gateway?

Central gateway UI

Add and open stores from one place: integration cards on the left and Integration settings on the right after you connect.

Orders and inventory

Use Import Orders, Execute Get Orders, Sync Inventory, and scheduling once the Shopify connection is in place.

Multiple stores

Add New Store opens the marketplace list so you can add more than one connection when your account allows it.

---

Shopify Set Up

Use it when you need a custom app in Shopify Admin and later enter API Key, Admin API Access Token, and Hostname in ShipEdge (for example with Channel Automation). It is separate from installing the ShipEdge app through Gateway Integrations, but both paths need a working Shopify app with the right permissions.

Create your App on Shopify

1. Log in to Shopify

   Open your Shopify admin and sign in. In the left-hand menu, click on Settings and then open Apps.

2. Start developing apps

   Click Develop apps to create a new app integration.

3. Build Apps in the Dashboard

   Click in Build apps in Dev Dashboard to open the Dev Dashboard.

4. Create an app

   Click in Create app to start building your app.

5. Name the app and create

   Enter an app name, then click Create. Shopify opens the new app’s configuration view.

Grant permissions

ShipEdge needs specific Admin API scopes. If they are missing, the connection will not work.

1. Open Admin API integration

   In your new app, go to the Versions tab → Select scopes to grant the required scopes to ShipEdge.

2. Select the required scopes

   Enable the scopes ShipEdge needs for orders, inventory, and tracking. The guide lists at least the following (turn on each one that appears in your Shopify admin):

   • read_locations
   • read_assigned_fulfillment_orders
   • write_assigned_fulfillment_orders
   • write_customers
   • read_customers

3. Save

   Click Done to save the scopes.

4. Return to the Home page

   Click on the Home tab to return to the home page.

5. Install the app

   Click Install app (upper right) to install the app on your store.

6. Select the store you want to connect

   Click on the store you want to connect to ShipEdge.

7. Install the app

   Click Install button to confirm the installation.

---

Connect Shopify Store to ShipEdge

1. Open Integrations

   Go to Orders and open Integrations

2. Open Gateway Integrations

   On the Integrations page, click Gateway Integrations.

3. Add New Store

   On the Gateway Integrations screen, click Add New Store.

4. Select Shopify in Marketplace

   In the Add New Store window, find Marketplace, use Search if needed, and click Shopify.

5. Select your Shopify store

   On the Shopify side (Welcome back), use Search if you have many stores. Click the store you want to connect (your *.myshopify.com store).

6. Enter Redirect URI

   On Integrate with Shopify, paste your Redirect URI: the full URL you use to log in to ShipEdge, including https:// (for example https://your-warehouse.shipedge.com). This is the callback URL Shopify uses for the integration.

7. Log in

   Click LOGIN to authenticate with ShipEdge and continue the connection.

8. Finish configuration in ShipEdge

   When you are back in ShipEdge, select your store in the list if needed. Use Settings, Orders, Update Tracking, and Sync Inventory on the same screen to complete setup.

---

Import Orders

1. Open your store

   In Gateway Integrations, click the integration card for the store you want. Confirm the Orders column is visible next to Settings.

2. Enable Import Orders

   In the Orders section, select the Import Orders checkbox so the integration can pull orders from Shopify.

3. Run a manual import

   Click Execute Get Orders when you want to trigger a request immediately instead of waiting for the next scheduled run.

4. Set the import schedule

   Configure how often the integration calls Shopify to get orders (for example Every day, hour, and minute). Save the schedule with Update when the UI offers it.

5. Order Status

   Use the Order Status dropdown to choose which Shopify order statuses you want to import into ShipEdge.

6. Initial Date

   Set Initial Date to the starting point for the first import run (the date used for the first retrieval of orders from the store).

7. Fulfillment Status

   Use Fulfillment Status to limit which fulfillment states are imported (for example Unfulfilled).

8. Financial Status

   Use Financial Status to limit which payment or financial states are imported (for example Paid).

9. Optional order options

   • Archive Orders Once Imported — Archives orders in Shopify after they are imported, if you enable it.
   • Tags (comma separated) — Restrict or label imports using Shopify tags (for example tag1,tag2).
   • Exclude Tax Paid Metadata — Exclude tax-related metadata (such as taxes_paid and shipping_tax_amount) when enabled.

10. Webhooks — Order created

    Under Webhooks, turn on Order created if you want Shopify to push new orders in near real time. When this toggle is on, it can take the place of relying only on the scheduled import.

11. Save Changes

    Click Save Changes to apply all import settings.

---

Update tracking

After you ship in ShipEdge, tracking and fulfillment updates can be sent back to Shopify.

1. Open your store

   In Gateway Integrations, select the store integration so the Update Tracking section appears on the right.

2. Enable Sync Update Tracking

   Turn on Sync Update Tracking so ShipEdge can send tracking information to Shopify for your shipped orders.

3. Run a manual update

   Click Execute Update Tracking when you want to push tracking immediately instead of waiting for the next scheduled run.

4. Set the update schedule

   Configure how often the integration calls Shopify to update tracking (for example Every day, hour, and minutes). Click Update to save the schedule. Use Cancel or Delete while editing.

5. Fulfillment Email Notify

   Enable Fulfillment Email Notify if you want Shopify to send a fulfillment confirmation email to the customer when the order is marked fulfilled.

6. Save Changes

   Click Save Changes to apply your tracking update settings.

---

Sync Inventory

1. Open your store

   In Gateway Integrations, select the store integration so the Sync Inventory section is visible.

2. Enable Sync Inventory

   Turn on Sync Inventory so ShipEdge can send your available inventory levels to your Shopify store.

3. Run a manual sync

   Click Execute Sync Inventory when you want to push inventory immediately instead of waiting for the next scheduled run.

4. Set the sync schedule

   Configure how often the integration calls Shopify to sync inventory (for example Every day, hour, and minutes). Click Update to save the schedule.

5. Location Id

   Open Location Id and select the Shopify location you want inventory to sync with.

6. Tags (comma separated)

   Optionally enter tags (for example tag1,tag2) so inventory sync applies only to items that match those tags.

7. Sync SKUs and Sync Synsets

   • Enable Sync SKUs to update inventory levels for SKUs.
   • Enable Sync Synsets to update inventory levels for synsets.

8. Save Changes

   Click Save Changes to apply your inventory sync settings.

---

Shopify integration settings in ShipEdge (after you connect)

When your Shopify store is selected, the Integration panel includes sections such as:

Section	What you can do
Settings	Integration Name (for example your *.myshopify.com name) and Shop Host (store subdomain).
Orders	Turn on Import Orders and use Execute Get Orders to pull orders when needed.
Sync Inventory	Turn on Sync Inventory, use Execute Sync Inventory, and set a schedule (for example daily at a chosen hour).
Tracking / fulfillment	Controls tied to update tracking in the gateway (push tracking and fulfillment updates back to Shopify).
Webhooks	Options such as Order created so Shopify can notify ShipEdge when new orders appear.

---

Best Practices

One store at a time

If you have several connections, select the correct card before changing settings so updates apply to that integration.

Full warehouse URL

For the Redirect URI step, use the complete ShipEdge URL including https:// so the bridge links Shopify to the right warehouse.

Keep Integrations as the hub

Use Integrations for CSV templates and related tools; use Gateway Integrations for Shopify and other gateway-based stores.

---

Troubleshooting

Problem	What to try
No integrations found	Click Add New Store and complete the Shopify connection flow, or confirm you are logged in with access to Orders → Integrations.
Page stays on Loading Gateway	Check network access for gateway initialization and the gateway script; the page needs a successful session token before listing stores.
Add New Store does nothing	Reload after signing in; confirm gateway services are available for your environment.
Wrong ShipEdge account after install	Check the Redirect URI uses the correct https://…shipedge.com host for your warehouse.

---

Related Links

Next steps: Integrations Overview · Setting Up Integrations