Urgent Engineering Escalation Request: KDS Fulfillment Sync Bug / Orders Not Marking "Ready" (Ticket Open 6+ Months)

Issue Description:
Our business is experiencing a persistent, system-wide failure where clearing or closing an order on the Square KDS screen does not update the order fulfillment status to “Ready for Pickup.” The ticket vanishes from the KDS layout screen, but remains in an open, unfulfilled state on both the Square POS and the online Square Dashboard.

This issue affects 100% of our orders (including first-party online orders and third-party delivery marketplace orders). We were informed by Support over six months ago that this was an engineered-side bug, but the issue remains completely unresolved.

Technical Troubleshooting Completed:
To save time and rule out standard device issues, we have already performed the following troubleshooting steps with zero success:

  1. Station Verification: Confirmed the KDS screen is actively configured as an Expeditor Station, which should inherently push fulfillment updates (“Ready”) back to the server.
  2. Full Device Re-sync: Logged out of the KDS app, completely deleted the device profile inside the Square Dashboard, generated a brand-new device code, and re-linked the hardware.
  3. Firmware & App Audit: Verified all hardware (POS terminals and KDS tablets) are fully updated to the latest identical software build versions.

Root Cause Hypothesis / Engineering Request:
Because device-level resets do not fix the issue, this is a server-side account schema error or a broken API webhook pipeline. The KDS completion event is failing to mutate the fulfillment.status state to PREPARED in the Square Orders API for our specific merchant ID.

Please immediately escalate this case directly to the Square KDS Product Engineering / Core Order Pipeline Team to audit our account’s webhooks and manually clear the stuck database state.

Thanks for documenting the troubleshooting you’ve already completed.

One additional setting worth confirming is Automatically send order updates, under Settings → Device management → Kitchen settings → Order settings in Square Dashboard. Expeditor configuration and automatic order updates are separate settings. Square covers this in its KDS documentation.

This forum focuses on developers building with Square’s APIs and SDKs. Since the behavior you’ve described involves Square’s built-in KDS workflow, Square Support is the right team to investigate it through your existing case.

If that setting is already on, I recommend adding a recent affected order to your support case, including the time you completed it on the Expeditor, the time zone, and screenshots showing the unchanged order status.