ERP sync stuck? Before you call — read the error. 90% of cases are things you can fix yourself in 2 minutes.
| Error | Cause | What to do |
|---|---|---|
| 401 / Unauthorized | Token expired | Settings → Integrations → reconnect |
| 422 / Validation | Missing customer details | Add tax ID / business ID / address on the customer record |
| 2422 (your ERP) | Wrong VAT calculation | Check vatType — must be 0 from POS |
| 404 / Item not found | SKU doesn't exist in ERP | Create the item in your ERP first, or remove the line |
| 500 / Server error | ERP is down | Wait an hour and retry. Check your ERP/your ERP status pages |
| Timeout | Slow response from ERP | Retry "Sync" — usually goes through on the second try |
Settings → Integrations → Sync queue. You'll see the list of stuck documents, the specific error for each, and an individual "Retry" button.
If 20+ documents are stuck — that's a broader issue. Don't click "Retry" 20 times.