Background tasks (workers) are automated processes that run in Sapera without user interaction. They handle repetitive and time-consuming operations such as synchronizing prices, invoice handling, sending and receiving emails and SMS, updating stock data and integration between the different parts of the system.
The screen provides a combined status insight across all Sapera services: Financial, Inventory, Accounting, Actors, Communication, Pos, Reports, WebShop and Payments. It is a pure monitoring and troubleshooting tool — nothing can be edited from here.
The screen is exclusively visible to users with admin permissions. The menu item only appears in the navigation if your user has the necessary access level.
Open Financial and select Setup in the menu on the left. Then click Background tasks.
If you cannot see the menu item, you probably do not have permission for it. Contact support.
When the screen loads, the status is automatically fetched from all 9 backend services. The overview shows one row per worker (background process). The appearance of the rows reflects the worker's current state:
Rows with active or pending tasks are highlighted with bold green text, so they are easy to spot.
Rows without any ongoing or pending activity are shown with italic, gray text, signaling that the worker is currently inactive.
Refresh — reloads the status from all 9 services immediately. Use this button if you suspect the overview is outdated, or after you have made changes in the system and want to see the updated state. The button is always active.
Show tenants — a toggle button that switches the display between combined and per-tenant view. When Show tenants is enabled, each worker row is expanded into one separate row per tenant, so you can see activity and queue size for the individual tenant. When it is disabled, the combined figures across tenants are shown. The button is always active.
Services: Indicates which backend service the worker belongs to. Possible values are Financial, Inventory, Accounting, Actors, Communication, Pos, Reports, WebShop and Payments. The field gives an overview of which part of Sapera a given task operates in.
Display name: The worker's technical name, which uniquely identifies the specific background process. Examples are SyncSalesPricesWorker (synchronization of sales prices) and EmailStatusWorker (handling of email status).
Tenant being processed: Comma-separated list of the tenants (identified by domain name) that are currently being actively processed by this worker. The field is empty (null) if the worker is not currently processing any tenant.
Tenant: Shows the tenant's name. The column is only visible and relevant when Show tenants is enabled. It identifies which single tenant the row in question concerns.
Run count: Shows the number of pending batches or tasks in the worker's queue. A higher number means there is a backlog of tasks awaiting processing. The value is normally shown as a number, but for certain services it can be shown as some if the service in question does not support an exact count — this means there is pending work, but the exact number is not known.
The screen is primarily useful in two situations.
If an expected automatic action does not seem to have taken place — for example that prices have not been synchronized, or that invoices have not been sent — you can check here whether the relevant worker is active at all, and whether there are pending tasks in the queue.
If the system feels slow, and you suspect that background queues are building up, you can check the Run count for the relevant services. High numbers can indicate that the system is under high load, or that a service has problems running its tasks.
Use the Refresh button regularly during monitoring, as the status display does not update itself automatically.
If you have any questions, you are welcome to contact support.
Want to know more?
Read more in these related articles:
Activity log
The activity log in Sapera records system events across the organization. Here you can search, filter and view details about what has happened in the system and when.
Sync
This article covers the setup of webshop synchronization in Sapera
