---
title: "Resolve order product quantity sync errors"
source: https://support.storeconnect.com/articles/resolve-order-product-quantity-sync-errors
type: article
format: markdown
site: StoreConnect Support — product and developer documentation for StoreConnect
site_index: https://storeconnect.com/llms.txt
docs_index: https://support.storeconnect.com/llms.txt
note: Append .md to any page or article URL on this site to get its Markdown form.
---
# Resolve order product quantity sync errors

## Symptoms

You see a sync error in the [sync error tool](sync-error-tool) with the status code **FIELD_INTEGRITY_EXCEPTION** and a message similar to one of the following:

- "Can't save order products with quantities of zero: Quantity"
- "Can't save order products with negative quantities: Quantity"

The affected object is **Order Product** (`OrderItem`).

## Cause

Salesforce rejects Order Products with a quantity of zero or a negative quantity unless the matching setting is enabled in **Order Settings**. Both settings are off by default, so the first order that contains one of these lines fails to sync.

Both kinds of line come from the point of sale:

- **Zero quantity**: a line cancelled on an open order. Cancelling a line sets its quantity to `0` and mirrors that to the linked Order Product, so the cancelled line stays on the order as a record of what was removed rather than disappearing. An order whose lines were all cancelled has every Order Product at quantity `0`.
- **Negative quantity**: a return or refund line. Returns are written as negative-quantity lines that reduce the order total.

The online store cannot produce either. Zero and negative quantity items are removed from the cart before checkout.

## Resolution

### Step 1: Enable the relevant setting in Order Settings

1. In Salesforce, go to **Setup**.
2. In the Quick Find box, search for **Order Settings**.
3. Open **Order Settings**.
4. Check the setting that matches the error message:
   - For "quantities of zero", check **Enable Zero Quantity**.
   - For "negative quantities", check **Enable Negative Quantity**.
5. Click **Save**.

:::note
You can turn these settings back off later, but Salesforce then refuses to activate any order that still contains a zero or negative quantity line. Existing records stay visible and editable. Leave the settings on for as long as your registers can cancel lines or process returns.
:::

### Step 2: Re-sync the failed records

1. Go to the [sync error tool](sync-error-tool) in StoreConnect.
2. Select the checkbox next to all affected Order Product records.
3. Click the **Re-sync** button.

The records should now sync successfully.

:::tip
Select all records in the Sync Errors list when re-syncing, not just the first one. Related downstream errors (such as `INVALID_FIELD` on order item taxes or payment items) will also clear once the root Order Product records sync.
:::

## Verification

1. Confirm the sync errors no longer appear in the [sync error tool](sync-error-tool).
2. Open the affected order in Salesforce and confirm the Order Products are present with the expected quantities, including any cancelled lines at quantity `0`.

## Prevention

- **Enable both settings before you take POS orders**: a register can cancel a line or process a return at any time, so check **Enable Zero Quantity** and **Enable Negative Quantity** in **Order Settings** as part of your initial configuration.
- **Check the sync error tool after your first cancellation or return**: a rejected Order Product also blocks the order item tax and payment item records behind it, so catching the setting early keeps one order from producing a page of errors.

---

## Follow StoreConnect

- [Email Newsletter](https://storeconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://storeconnect.com/partners)
- [Become a Partner](https://storeconnect.com/become-a-partner)
- [News](https://storeconnect.com/articles/news)
- [Events](https://storeconnect.com/articles/events)
- [Live Events](https://storeconnect.com/live-events)
- [Feature Comparison](https://storeconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://storeconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

## Machine-readable

- [Site index for agents](https://storeconnect.com/llms.txt): curated map of the StoreConnect site in llms.txt format
- [Documentation index for agents](https://support.storeconnect.com/llms.txt): full technical and product documentation map

Every page and article on this site has a Markdown rendering: append `.md` to its URL.

Continue in Markdown: [Help documentation](https://support.storeconnect.com/help-documentation.md) · [Developer reference](https://support.storeconnect.com/developer-reference.md) · [Videos & tutorials](https://support.storeconnect.com/videos-tutorials.md) · [Release notes](https://support.storeconnect.com/release-notes.md)

---

StoreConnect Support — https://support.storeconnect.com/articles/resolve-order-product-quantity-sync-errors