Sync pending or failed
Veldriq Field
Symptom: Pending stays, or Needs attention is greater than zero.
Screen path: Sync tab. Healthy is Up to date and Attention 0 (FIELD-009). That screenshot is not an error. Native Field is not the Field PWA.
Preconditions
Section titled “Preconditions”Queued work exists, or a row was rejected. There is no periodic sync while the app is killed.
- Read Status. If Sign in again to continue sync, sign in — do not hammer Sync now.
- Restore the radio. Tap Sync now once. Wait for Syncing… to finish.
- Open the attention row. Classify network / 401 / validation / form version / media.
- Retry pending uses the same id. Do not tap Complete job or consume again to force it.
- Failed photos: Failed uploads. Recapture only if The file is missing on this device. HEIC is not accepted.
Likely cause
Section titled “Likely cause”App killed before push; network; 401 frozen; validation; form version changed; parent row Waiting on another item.
What works / does not work
Section titled “What works / does not work”| Works | Does not work | |
|---|---|---|
| Keep the app open | Engine runs | Killed-app periodic sync |
| Attention 0 + Up to date | Healthy | Calling that state Needs Attention |
| Clear app data | Destroys pending | “Fix sync” |
Resolution: keep the app open; Sync now; sign in again if session expired; read the row on Sync Center. Do not hammer Sync.