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:
- Station Verification: Confirmed the KDS screen is actively configured as an Expeditor Station, which should inherently push fulfillment updates (“Ready”) back to the server.
- 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.
- 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.