- If you set up our Shopify integration after July 11th, 2023, please refer to the latest steps here
- If you set up our Shopify integration before July 11th, 2023 and are currently using multiple locations:
- We are currently in the process of migrating you over to the newer Shopify Fulfillment V2 API settings. This supports multi-managed inventory (MMI) out of the box and you will no longer need to create and manage locations yourself
- After we migrate you to the newer Shopify settings (expected before August 31st, 2023; you will be notified):
- If you previously had a merchant-managed location called "Deliverr USA", we will automatically rename it to "Deliverr"
- Warning: If you have any custom logic set with Deliverr locations inside Shopify Admin (e.g. with the Shopify Flow app or Shopify API), please check your settings to confirm your orders are being routed correctly
- Deliverr is the former name of Flexport, and the Flexport Portal. However, there are applications which still have to retain the name Deliverr
- We apologize for any confusion caused and please feel free to reach out to our support team anytime
One way that you can set up the Shopify connection to import orders is to use Shopify's Multiple Locations feature. Each Shopify location is a fulfillment center (either real or virtual) that can track inventory levels for your SKUs. When new orders are created, Shopify will assign an order to a location depending on the location priority and availability of the SKUs in that order. If you wish to use this configuration, "Deliverr USA" should be one of the locations in this list.
Multiple locations is ideal if you want:
- To route orders to your own fulfillment center if out of stock in your fulfillment locations
- Orders for certain locations (such as international orders) to route to your own fulfillment center/method, and the rest to route to Flexport
- If, instead, you want to use Flexport to fulfill international orders, please see Fulfilling international orders
- You want to accept preorders in Shopify, and fulfill them at a later date
If one or more of those criteria apply to you, then follow the steps below to set up Shopify Multiple Locations. If you're not sure, then please see Which Shopify Configuration Should I Use? to decide which configuration is right for you.
Additional notes:
- You must use the Shopify direct connection
- Using this feature replaces the need for any other Shopify plugins such as Location Based Fulfillment.
- This feature is not compatible with Shopify's Fulfillment by Amazon (FBA) feature.
- This means that if you use Shopify-FBA for some SKUs, then you can't also stock them with Flexport.
- Consider using other listing tools such as Pipe 17 to more fully integrate with FBA and to avoid split orders.
- If your order is split between 2 or more locations, and part of the order has been imported, you will not be able to change the location to "Deliverr USA" for the unfulfilled items in the order. You would need to fulfill the remaining items yourself. This is because we will only import orders once and will not look for updates to an order after it has already been imported. Need time to edit orders before they import? Please see Order Import Delays.
Setup Instructions
1) Disable automatic fulfillment
Login to your Shopify Account at accounts.shopify.com/store-login. Under Settings > Checkout > Order processing > After an order has been paid > enable Do not automatically fulfill any of the order's line items.
Don't worry -- the "Deliverr USA" location will automatically import any unfulfilled orders.
2) Create a new 'Deliverr USA' location
Note: Deliverr is Flexport's former name.
In Shopify, go to Settings > Locations.
Click 'Enable inventory at locations' if you see this option in your Shopify settings. This step is necessary so each location can have different inventory quantities. Read Enabling multiple locations in the Shopify help docs for more information.
Notes:
- Most Shopify stores should have 'Enable inventory at locations' already enabled, and so won't see this as a visible option. You may see this option if you are using an older Shopify version, or if you are using Shopify with a POS (point of sale solution). Read Getting started with locations in the Shopify help docs for more information.
- Tracking different inventory quantity levels at different locations is irreversible change. However, it is a necessary change if you plan to use Flexport, Shopify, and multiple locations together as stated in the introduction.
Click Add Location to create a new location for Flexport called "Deliverr USA".
Input this exact information from this table to create a location. Use this information exactly as it appears, including being case-sensitive and no spaces. This is so Flexport can properly recognize that you've created this location. Hit 'Save' when done.
Location Name | Deliverr USA |
Address | 760 Market Street |
Apartment, suite, etc | 8th Floor |
City | San Francisco |
Country/Region | United States |
State | California |
ZIP code | 94104 |
3) Set 'Deliverr USA' as the default location and the top priority
Set 'Deliverr USA' as the default location. This will ensure that orders are routed to Flexport by default if no other option is specified or available.
Recommended: Set 'Deliverr USA' as the top location in the priority list. This means that if multiple locations are able to fulfill a given order (the locations have available inventory for all of the SKUs on the order), then Shopify will assign the order to Flexport.
Optional: Change the priority list as desired to match the preferred order in which you want locations to fulfill orders. See the Shopify Help Center for more details.
4) Create a dummy location for stockouts (Optional)
Optional. Complete this step only if you plan to accept backorders AND if those orders will ultimately be fulfilled by another 3PL (who does not already have a location in Shopify).
Stockouts happen when a specific location is out of stock (has 0 inventory) for a given SKU. The intended behavior for stockouts is:
- When the Deliverr USA location is out of stock, the order will automatically be assigned to other locations (warehouses) based on the priority. These other locations will fulfill the order if their inventory levels have the inventory in stock to fulfill the order.
- If all of your other locations also out of stock, then Deliverr USA (the app location) will automatically ingest the order. To avoid this ingestion (and us subsequently canceling the order), we recommend you create a dummy location and assign it 10,000 units for each product.
This dummy location can be virtual just to hold onto the backorders without cancelling them. It can also be a real location (your own warehouse or another 3PL partner) who actually has the item in stock. This is up to you, the merchant, on how you plan to fulfill orders outside of Flexport.
Once orders are assigned to the dummy location, you can either:
A) Assign to your other warehouse or fulfillment provider to fulfill. This process is up to you, the merchant to setup a partner and process for orders that do not plan to fulfill via Flexport.
B) After you have inbounded new units into Flexport and confirmed that we have those units in stock, then delete the dummy location and reassign those orders to the "Deliverr USA" location.
- Please confirm in the Flexport Portal that we have available units for those SKUs. If they are not available yet, then we will import and subsequently cancel the orders.
Note: Do not enable the 'Continue selling while out of stock' option feature in Shopify.
5) Enable in Flexport Portal
Go to Sales Channels > Shopify in the Flexport Portal. In Shopify Settings, select Multiple Locations and save your changes.
- This checks to see if you created the "Deliverr USA" location as described above. If there is a typo in the location's name or address, please fix and save changes again.
Once enabled, Flexport will automatically import all orders assigned to the "Deliverr USA" location and to "Deliverr USA" by design, so that we can fulfill those orders as soon as possible. There is no need to mark an order as fulfilled within Shopify, as we will still import and fulfill that order regardless.
Preorders
Read our help center article How to handle preorders in Shopify for more details.
Split Orders
With multiple locations in Shopify, split shipments are a possibility. This means that orders may have line items that are fulfilled from different locations/warehouses with different tracking information.
Split shipments is not default behavior. Split shipments only happen if no Shopify locations exist with the ability to fulfill the entire order. If one location has the units to fulfill the entire order (whether that is "Deliverr USA" or another one), then Shopify will route the order to that location. Learn more in Shopify help docs.
In the example below, Flexport picked up "Original Flexport Product" (SKU: ABC) because we had this SKU in stock. However, since "Other Warehouse Product" in stock, Shopify split the order and passed it to the next location in the priority list (577 Howard Street).
To see which orders are assigned to which warehouses, go to the Orders section in Shopify and filter by location. In the example image below:
- "Deliverr USA" is the new location that you created in the setup steps above.
- 'Deliverr' is the app location.
- '760 Market Street' is the dummy location.
Additional Notes
1) You must use the Shopify direct connection
- Read this article about how to setup the Shopify direct connection.
2) Do not manually hit Mark Fulfilled on orders in Shopify
- We will not pick up any orders that are marked as already fulfilled.
- Hitting the Mark Fulfilled button is unnecessary since all unfulfilled orders assigned to the "Deliverr USA" location will be automatically be ingested.
3) Check that every location has a shipping rate
- This is done by default when you create a new location as done above.
- Accidental changes to these shipping rates, or changes to these shipping rates by other Shopify plugins can cause a location or a SKU to not have a shipping rate. This can cause orders not to properly import from Shopify.
- Learn more about how to troubleshoot missing rates.
4) This multiple locations feature is not compatible with Shopify's Fulfillment by Amazon (FBA) feature.
- This means that if you use Shopify-FBA for some SKUs, then you can't also stock them in Flexport.
- Consider using other listing tools such as Pipe 17 to more fully integrate with FBA and to avoid split orders.