Configure accounting sync schedules
Scheduled jobs move data between Zenoti and the accounting provider without anyone selecting a button. Each job has its own interval, delay, and order, and can be paused or disabled independently. This article explains the jobs, how to add and tune them on the Sync Schedule panel, and when a manual sync is still needed.
On this page
- Before you begin
- Jobs you can schedule
- Add and schedule jobs
- Job columns
- Run a manual sync
- Failure path (scheduling)
- Related articles
Before you begin
Permission: You need organization administrator access to configure accounting sync schedules.
- The provider must be chosen, saved, and authorized. See Connect an accounting provider.
- Mapping must be complete for the data a job posts. Sales jobs need item and payment mappings; location-based posting needs the Locations panel completed. See Configure accounting data mapping.
- The sync start date in Configuration must be set. Jobs never look further back than that date.
Jobs you can schedule
Jobs fall into two groups. Master-data jobs pull reference records from the provider so that Zenoti can map to them; posting jobs push Zenoti transactions to the provider. Which jobs are offered depends on the provider.
| Group | Jobs |
|---|---|
| Master data (pull) | Locations, Tax Items, Non-Inventory Items, Other Charge Items, PaymentMethods, All Items, All Vendors, Process Customers |
| Posting (push) | Post Sales & Refunds, Post Payments, Miscellaneous Journal Entries, Post Inventory Orders, Post Inventory Adjustments |
| Export | Schedule Data Extract (the Manual provider only) |
Posting jobs are per center, so the same job can run on a different schedule for each center. Master-data jobs run for the organization.
Add and schedule jobs
- Navigate to Configuration > Integrations > Integration settings, expand Accounting, and open Sync Schedule.
- Under Schedule Jobs, choose a job in Select Job and select Add. It appears as a row in the job grid.
- In the row, set the interval, the delay, the sync date, and whether the job is enabled. Intervals are chosen from a fixed list of minutes (for example 60, 240, 1440, or 2880); an interval of zero is rejected because the job would run continuously for the same day.
- Set the order in which posting jobs run when several are due at the same time. Master data should run before posting.
- Select Save, or Update Sync Schedule for a single row. Update All Centers copies the row's schedule to every center; it is not available for the data-posting jobs, which stay center-specific.
Pause suspends every job without changing its settings; use it during a month-end close or a chart-of-accounts change, then resume.
Under Financial Lock Approval, the panel also lets you choose the Roles that can approve financial lock change requests when posting into locked periods.
Job columns
| Column | Meaning |
|---|---|
| Job | The job name. |
| Last Run Time | When the job last ran. |
| Sync Date | The business date the next run processes. It cannot be earlier than the sync start date. |
| Next Run Time | When the job runs next, derived from the interval and delay. |
| Schedule | The interval, in minutes. Master-data jobs expect 1440; population jobs accept 720 or 1440. |
| Delay | How long after the business day closes the job waits before posting. |
| EnableJob | Whether the job runs at all. |
| Status | The result of the last run. |
| Order | The run order among jobs due together. |
| Actions | Edit or view the row's change history. |
Select a row's history action to open the sync schedule configuration history, which lists the job name, the column that changed, the old and new value, who changed it, and when, for the last six months.
Run a manual sync
The Manual Sync panel covers two situations: the initial pull of master data, and a one-off catch-up after a mapping change or an outage. Its note says that once sync schedules are set up there is no need for a manual sync.
- Open Manual Sync.
- To refresh reference data, select Get on the relevant row (Locations, Accounts, Payment Methods, Customers, Taxes, All Items, Suppliers, Journals, and the provider's other master-data rows).
- To re-post transactions, pick the business date in Choose a date and select Post on the row (Sales and Refunds, Payments, Miscellaneous Journal Entries, Purchase Orders, Transfer Orders, or Inventory Adjustments). A manual post processes one date at a time.
Manual runs share the provider's API limits with the scheduled jobs. Let a large backfill finish before the next scheduled run.
Failure path (scheduling)
| Symptom | Cause | Resolution |
|---|---|---|
Select a valid Schedule. / Select a valid Delay. / Select a valid Date. |
The row was saved with an empty or invalid value. | Choose an interval from the list, a delay, and a sync date on or after the sync start date. |
Sync Date cannot be less than Sync Start date. |
The sync date was moved before the start date in Configuration. | Move the sync date forward, or change the sync start date first. |
Schedule can't be 0, the job will be running for the same day continuously. |
Interval set to zero. | Pick a non-zero interval. |
Location should be active when the settings and job are active. |
A posting job is enabled for a center whose location mapping is inactive. | Activate the mapping in Locations, or disable the job for that center. |
No Location is mapped for the <center> |
The center has no mapped location. | Map it in Locations. |
Maintenance Job is missing from the Center |
A required maintenance job was never added for the center. | Add it from the job list and enable it. |
Bulk Update is not supported for Data Posting Jobs |
Update All Centers was used on a posting job. | Update posting jobs one center at a time. |
job already exists |
The job was added twice. | Edit the existing row instead. |