Overview
View the history of all sync jobs — product syncs, order syncs, and full syncs. Monitor status, timing, and error details.
Sync Job Types
| Type | Description | Trigger |
|---|
| Product Sync | Syncs products and inventory from Shopify | Manual (Products page Sync button) or auto-sync |
| Order Sync | Syncs orders and builds sales history | Manual (Orders page) or auto-sync |
| Full Sync | Products + orders together | Cron job (every hour) |
Job Status
| Status | Color | Description |
|---|
| Completed | Green | Sync finished successfully |
| Processing | Yellow | Sync currently running |
| Failed | Red | Sync encountered an error |
| Pending | Yellow | Queued but not yet started |
Job Details
| Field | Description |
|---|
| Type | Product, Order, or Full sync |
| Status | Current state of the job |
| Products Synced | Count of products processed |
| Orders Synced | Count of orders processed |
| Sales Synced | Count of sales history records created |
| Error Message | Details if the job failed |
| Started At | When the job began |
| Completed At | When the job finished |
Automatic Sync
Cron Job
A cron job runs every hour to sync products from Shopify in the background. This keeps inventory levels up to date without manual intervention.
| Setting | Description | Default |
|---|
| Auto-sync | Enable automatic scheduled sync | Disabled |
| Auto-sync Interval | Hours between syncs | 4 |
API Endpoints
| Endpoint | Method | Description |
|---|
/api/jobs | GET | List sync jobs |
/api/jobs/{id} | GET | Get job details |
/api/jobs/process | POST | Process pending jobs |
/api/products/sync | POST | Trigger product sync |
/api/orders/sync | POST | Trigger order sync |
Troubleshooting: If a sync job is stuck in "processing" status, check the error message. Common issues include: Shopify API rate limits (auto-retry after 2s), invalid tokens, or database connection errors. Failed jobs can be retried by clicking Sync again.