Skip to main content

​
Sync Failures

​
Partial sync (inventory uploaded but prices not imported)

The sync pipeline has multiple steps. Inventory upload is the critical step. Orders, sales reports, and price imports are non-fatal. If they fail, the agent logs the error and continues. Check the terminal output for lines like: 
Order export failed (non-fatal): ...
Sales report download failed (non-fatal): ...
Import prices failed: ...
These usually resolve on the next sync cycle.

​
”Upload failed” errors

Upload failed: API error 413: ...
The inventory CSV may be too large. This is rare but can happen with very large inventories (50,000+ items). Contact support@tryhoard.com if you hit this.

​
Sync takes too long

A normal sync takes 2-3 minutes. If it’s taking longer:
  1. First sync — The initial sync exports full order history back to 2020. This can take 5-10 minutes. Subsequent syncs only pull the last 90 days.
  2. Price imports — Uploading prices back to TCGplayer involves a multi-step process (validate, confirm, move to live). This can take 1-2 minutes.
  3. Slow internet — Large CSV exports need a stable connection.

​
Dashboard shows “Synced X ago” but data looks old

Check that:
  1. The agent is still running (check terminal)
  2. Auto-sync is enabled in Settings
  3. The sync schedule hasn’t been set too infrequently

​
Sync lock stuck

If a sync crashes mid-run, the server may still think a sync is in progress. The lock auto-clears after 5 minutes. If it persists:
  1. The agent will log “Waiting: in_progress”
  2. Wait 5 minutes for auto-clear
  3. If still stuck, contact support@tryhoard.com