SYNC331: Local record diverged
What this means
This device's copy of a record doesn't match your store's. Nothing you entered is affected.
In Store health → Database, use Clear & re-download on that list to replace this device's copy with the store's. Until then, the record may show an out-of-date price or stock. Check first that nothing is waiting to send — see Troubleshoot.
Your data
No sales or unsent changes are affected. This device's copy of the record may show an out-of-date price or stock until it is replaced. If this keeps happening, use Copy debug info on the Logs tab and contact WCPOS support.
Troubleshoot
- Keep selling. Open Store health → Database: the record is named at the top — "… can't download from your store" for a record whose copy differs, or "… must be removed from this device" for one your store has deleted.
- Before selling that item, check its price and stock against the shelf or with whoever manages the store (they can compare it with WP Admin).
- Before clearing anything, check in Store health → Database that changes waiting to send is 0 and that no "… changes never reached your server" or "… changes were held" panel is showing — those changes exist only on this device, and clearing their list can lose them. Wait for the count to reach 0, and settle any listed change first (SYNC201, SYNC221). Before clearing Orders, also save every open cart on this device with Save to Server (or finish it) — a cart never saved to your store exists only on this device and is not counted in any of these checks, so clearing Orders deletes it. If a cart cannot be saved, skip the Orders row and contact support. Then open the ⋮ menu on the record's list (for example Products) and choose Clear & re-download… — the device drops its copy and fetches the store's, and a deleted record is removed. The entry can stay listed until the next background check; judge by whether the price and stock now match. If the callout then names a record in a different list, repeat this step — checks first — for that list.
- Site admin: if the same records keep coming back after a re-download, the cause is usually a bulk change that bypassed WooCommerce's save hooks — a CSV import, a migration plugin, WP-CLI or direct SQL. Prefer editing through WooCommerce, which keeps the till's checks accurate; WCPOS rebuilds its integrity data by itself once the same difference keeps repeating.
- If the till keeps showing a wrong price or stock after a re-download, use Copy debug info on the Logs tab and contact support.