The Background Jobs page helps you track system processes that run in the background, such as data imports and bulk operations. You can view job progress, check completion status, and resolve any errors to ensure your data remains accurate and your operations run smoothly.
Prerequisite - Roles required
Important: Ensure Warehouse Users have the following role ticked within BackgrondJobs role group AdminBackgroundJobView and (Optional) AdminBackgroundJobRetry.
Access Background Jobs
To view your background jobs:
Click Connect then Background Jobs.
You'll see all background jobs for your account.
What Background Jobs tracks
Background Jobs monitors these system processes:
Warehouse Upload: Bulk warehouse data imports and updates.
Product Upload: Bulk product catalogue imports and updates.
Job statuses
Background Jobs displays these statuses:
New: The job has been created and queued for processing but hasn't started yet.
In Progress: The job is currently running and the system is actively processing the data or operation.
Completed: The job has finished successfully and results can be downloaded if applicable.
Error: The job encountered an error during processing and failed to complete. You can retry the job from the Actions menu.
Job information
Each job entry shows:
ID: Unique identifier for the background job.
Job Type: The type of operation (Warehouse Upload, Product Upload, Delete Client).
Status: Current state of the job (New, In Progress, Completed, Error).
Created: Date and time when the job was initiated.
Created By: User who triggered the job.
Message: Status updates or error information.
Last Updated: Most recent update timestamp.
Updated By: Last user to interact with the job.
Actions: Available operations (View Details, Download Results, Retry).
Filter and search jobs
You can filter jobs using these options:
Job Status: Filter by New, In Progress, Completed, or Error status.
Job Type: Filter by Warehouse Upload, Product Upload, or Delete Client.
Created By User: Search for jobs created by a specific user.
Date Range: Filter jobs by creation date using From and To date pickers.
Job actions
Depending on the job status, different actions are available.
View Details
Available for all jobs. This opens a detailed view showing:
Job ID and Type.
Status badge with colour coding.
Creation and update timestamps.
User information.
Detailed message log.
Reference IDs (Client ID, User ID, Warehouse ID where applicable).
Parameters JSON showing the input data for the job.
Download Results
Available for completed jobs that produce output files. This downloads the results of the job processing.
Retry
Available for jobs with Error status. This allows you to restart a failed job after addressing the underlying issue.
Resolve failed jobs
Follow these steps to resolve background jobs with Error status.
Step 1: Identify the root cause
Click View Details on the failed job.
Review the error message in the Message field.
Check the parameters JSON to understand what data was being processed.
Review the timestamps to determine when the failure occurred.
Tip: Common causes include invalid or malformed data in upload files, missing required fields, system resource constraints, database connectivity issues, and permission or access problems.
Step 2: Correct the underlying issue
Act based on the job type and error:
For Warehouse Uploads
Verify the data format matches requirements.
Check that warehouse references are valid.
Ensure required fields are populated.
For Product Uploads
Validate SKU formats and uniqueness.
Confirm product data completeness.
Check for special character issues.
Step 3: Retry the job
Once you've resolved the issue:
Navigate back to the Background Jobs overview.
Locate the failed job.
Click the Retry action.
The job will be requeued and processed again.
Troubleshoot common issues
Jobs stuck in "In Progress" status
If a job remains in progress for an unusually long time:
Check the Last Updated timestamp to see if progress is being made.
Review system performance and resource availability.
Contact support if the job has been running for over 24 hours.
Repeated job failures
When a job fails multiple times after retry attempts:
Verify the source data format matches system requirements.
Check for data size limitations as very large uploads may timeout.
Consider breaking large operations into smaller batches.
Download Results not available
If completed jobs don't show download options:
Verify the job type produces downloadable results.
Check that the job fully completed (Status = Completed).
Ensure you have appropriate permissions to access results.
FAQ
Will email notification for upload results be removed?
No, email notifications for upload results will not be removed. The background jobs system for product and warehouse location uploads still sends email notifications when jobs complete.