New: the AI assistant diagnoses sync issues from your own logsRead more →
DocsOrder Splitting by Location

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:

OrderLocationValueLine itemsMoves stock
Primary orderYour default locationThe full order total: every item at its real price, shipping, fees, discounts and taxAll items. Lines picked by another location are labelled "(fulfilled by <location name>)"Only the items the default location supplies
Fulfillment orderEach other location that supplies items$0.00Only the items that location supplies, at their real quantitiesYes, 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.

When every item is available at the default location, no split happens and a single ordinary order is created.

Enable order splitting

  1. Go to SquareSync > Settings > Orders
  2. Find the Order Splitting section
  3. Toggle on Split orders by product location
  4. Click Save Changes

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:

PriorityRule
1Draw from the default location first, as much as it has in stock
2Draw the remainder from the other locations that have stock
FallbackIf 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.