> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/xoroerp-1/connected-apps/shopify/splitting-shopify-orders-by-fulfillment-location/shopify-fulfillment-as-split-orders.md).
# Shopify Fulfillment as Split Orders
### Overview
Shopify Fulfillment as Split Orders allows a single Shopify order to be fulfilled from multiple locations. When different items in an order are assigned to different Shopify locations, the order can be split based on its fulfillment locations during import into Xoro.
Xoro creates a separate Sales Order for each fulfillment while retaining the same Shopify order reference. To uniquely identify the split Sales Orders, Xoro appends a sequential suffix to the **Third Party Ref No**, such as **-1** and **-2**.
This allows each fulfillment to be processed independently based on the location responsible for shipping the items, while maintaining the connection to the original Shopify order.
### Workflow
**Step 1:** Before importing split fulfillments, configure the required settings in the Shopify channel. Go to the Shopify channel and open **Account Settings > Orders**.
**Step 2:** In the **Warehousing** section of the **Orders** tab, select **Orders** on the **Invoices/Orders** toggle to process Shopify orders as Sales Orders in Xoro.
**Step 3:** Enable the **Split orders** setting. The **Split Order Start Date** field appears. Enter the date from which Shopify orders should be split. Only orders placed on or after the specified date are split.
Under **Ship Store Location Mappings**, configure the mapping between the Shopify **Ship Store**, Xoro **Location**, and corresponding **Third Party Location**.
**Step 4:** Go to the **Products & Inventory** tab in the **Account Settings** page.
**Step 5:** In the **Inventory** section, under **Store Mapping**, configure the Shopify stores with the corresponding locations used in the **Ship Store Location Mappings**.
For example, if a Shopify store is mapped to the **HQ** location under **Ship Store Location Mappings**, make sure the same store is mapped to **HQ** under **Store Mapping**.
**Step 6:** In the **Advanced Settings** section, enable **Split orders to all available locations**.
When enabled, Xoro can split the order quantity across the selected locations when the required quantity is not available at a single location.
**Step 7:** In Shopify, create an order containing two items.
**Step 8:** In the **Unfulfilled** section, click the menu represented by the **three horizontal dots**. Select **Change location**.
**Step 9:** Select one of the items and assign it to a different fulfillment location. Click **Change location**.
For example, one item can remain assigned to **4388 Still Creek Dr**, while the other item is assigned to **HQ**.
Once the location is changed, Shopify separates the items into different fulfillment groups. The original order now contains multiple fulfillment sections, with each section showing the items assigned to its respective location.
**Step 10:** In the Xoro Shopify channel, go to **Orders** and import the Shopify order. The order is processed based on its separate fulfillment locations.
**Step 11:** After the import is completed, go to the **Sales Order Centre** module in Xoro. Xoro creates separate Sales Orders for the different Shopify fulfillments.
Both Sales Orders retain the same **Ref No**, linking them to the original Shopify order. The **Third Party Ref No** in the Other tab is uniquely suffixed with **-1**, **-2**, and so on to distinguish the individual split orders.
{% hint style="info" %}
* Inventory must be available at the respective mapped locations before importing the Shopify order.
* The locations used for fulfillment must be correctly configured in both Ship Store Location Mappings and Store Mapping.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.xorosoft.com/xoroerp-1/connected-apps/shopify/splitting-shopify-orders-by-fulfillment-location/shopify-fulfillment-as-split-orders.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
