Order Splitting by Location
Fulfil one website order from more than one Square location while Square counts it as a single sale.
Order splitting lets a website order be picked and shipped from more than one Square location, based on where the stock actually is, without the sale being counted more than once in Square.
What you will see in Square
For every website order that needs stock from more than one location, SquareSync creates:
| Order | Location | Value | Line items | Moves stock |
|---|---|---|---|---|
| Primary order | Your default location | The full order total: every item at its real price, shipping, fees, discounts and tax | All items. Lines picked by another location are labelled "(fulfilled by <location name>)" | Only the items the default location supplies |
| Fulfillment order | Each other location that supplies items | $0.00 | Only the items that location supplies, at their real quantities | Yes, at that location |
The payment is attached to the primary order, so Square's sales reports, taxes and fees record exactly one sale. The $0.00 fulfillment order is a pick ticket: it gives the other location's staff an order to work from and deducts that location's stock.
Do not cancel the $0.00 order. It is not a duplicate and not an error. It is the other location's pick list for a sale that has already been paid on the primary order. If staff at that location cancel it, the items are not shipped and the stock movement is lost.
When every item is available at the default location, no split happens and a single ordinary order is created.
Enable order splitting
- Go to SquareSync > Settings > Orders
- Find the Order Splitting section
- Toggle on Split orders by product location
- Click Save Changes
Enabling order splitting automatically enables Combine All Location Stock, so the website sells from the total stock across your locations.
How items are assigned to locations
When the order is placed, SquareSync checks the live stock of every item at each Square location it is sold at and assigns quantities in this order:
| Priority | Rule |
|---|---|
| 1 | Draw from the default location first, as much as it has in stock |
| 2 | Draw the remainder from the other locations that have stock |
| Fallback | If no location can cover the quantity, the remainder lands on the default location (its stock goes negative, which is the oversell behaviour) |
So an item is only ever sent to another location when the default location does not hold enough of it.
Staff instructions
At the default location: the primary order lists the whole basket. Pick and ship the lines without a "(fulfilled by …)" label. The labelled lines belong to another location and are on that location's $0.00 order.
At the other locations: the $0.00 order lists only the items you hold. Pick and ship those. The customer has already paid; the amount is on the primary order at the default location.
The WooCommerce order gets a note listing every Square order that was created and which location each belongs to.
Shipping from more than one location
A split order means more than one parcel, one from each location that supplies items. If you would rather ship every order from one place, turn Split orders by product location off. Every order then goes to the default location only, Square deducts stock there, and stock for items held at another location will show as negative at the default location until you transfer it.
Requirements
- Products are linked to Square, so their locations and stock are known
- More than one Square location is configured
- Inventory tracking is enabled in Square for the items
Limitations
Local pickup orders
Order splitting is disabled for local pickup orders. The entire order goes to the pickup location.
Payment gateway
Use SquareSync's own Square card gateway at checkout. The card payment then attaches directly to the primary order and the sale is counted once.
When another gateway takes the payment (including the WooCommerce Square payment gateway), SquareSync still creates the primary order but records the payment on it as an external payment, because the money was taken elsewhere. If that other gateway also writes its own payment into Square, the sale appears twice in Square's transactions.
Background processing
The primary order is created during checkout. The $0.00 fulfillment orders for the other locations are created in the background a short while later, so they may appear in Square a minute or two after the sale.
Example
Customer orders:
- 2 × Widget A (in stock at the default location)
- 1 × Widget B (in stock at Location 2 only)
Result:
- Primary order, default location: 2 × Widget A, 1 × Widget B "(fulfilled by Location 2)", shipping, discounts and tax. Total = the WooCommerce total. Payment attached. Stock for Widget A deducted here.
- Fulfillment order, Location 2: 1 × Widget B at $0.00. Stock for Widget B deducted at Location 2.
Troubleshooting
A $0.00 order appeared at one of my locations
That is the fulfillment order for a split sale. See What you will see in Square. The paid order is at the default location.
Orders are not splitting
- Verify Split orders by product location is enabled
- Check that the products are linked to Square and have location data
- Confirm more than one location is configured in Square
- Review the sync log for errors on the order
Items went to the wrong location
- Check the stock levels at each location in Square at the time of the order; the default location is always drawn from first
- Verify the default location is the one configured in SquareSync > Settings
The fulfillment order was not created
The WooCommerce order gets a note when the background job could not create a fulfillment order. The sale itself is unaffected: the payment and the primary order are complete, and the job retries automatically.