Journal runs
Know about journal runs
With the 2023.11.R1 release, Zuora has enhanced the performance of Journal Run by processing financial data before a Journal Run is triggered at month-end. This design can significantly reduce the processing time. All new tenants on Performance Booster or Performance Booster Elite will have the enhanced Journal Run enabled by default. Existing Performance Booster and Performance Booster Elite customers will be upgraded to Journal Run with improved performance beginning 2023.11.R1. If you need enhanced Journal Run enabled in your tenant quickly, contact Zuora Global Support. For more information, see Performance Booster and Performance Booster Elite.
Because data is prepared in advance under the new design, in the case of subsequent changes to segmentation rules and currency conversion settings, the system has the following behaviors by design:
-
Segmentation rule change: Prepared data will be refreshed to use the new segmentation rule.
-
Currency conversion setting change (depending on the type of the change):
-
Set home currency: Prepared data will be refreshed to use the newly set home currency.
-
Other changes: Prepared data will NOT be refreshed. Original settings will be used to create journal entries.
-
Canceling a journal run will take longer once the new design is enabled in your tenant.
Overview
Journal runs auto-create summary journal entries that are suitable for importing into your General Ledger (GL) system. This article explains how to create, cancel, and delete journal runs.
A journal entry in Zuora is a summary of all Zuora transactions, such as account receivables, credit balance adjustment, and revenue. A journal run auto-creates journal entry objects from Zuora transactions. A journal run is similar to a Zuora billing run or payment run.
Finance permissions are required to manage journal runs. See Finance Roles for more information.
The following sections provide information on journal runs:
Manage journal runs
You can:
-
Create a journal run .
-
View and manage summary journal entries .
-
Cancel and delete a journal run .
Navigation: Click Finance > Journal Runs.
Run status
The following table describes the Zuora statuses for journal runs.
|
Status |
Description |
|---|---|
|
Pending |
The journal run in the queue for processing. This status appears upon starting a journal run. |
|
Processing |
The journal run is processing all transactions and summary journal entries. |
|
Completed |
The journal run completed successfully. Journal entries are auto-created and available for review and export. |
|
Cancel in progress |
Canceling the journal run is in progress. |
|
Cancelled |
The journal run is canceled. You can cancel a run when the status is either Pending or Completed. |
|
Delete in progress |
Deleting a canceled journal run is in progress. You must cancel a journal run before you can delete it. |
|
Error |
An exception happened during the journal run where some journal entries might be generated successfully. You can run a journal run for the same accounting period again to catch the failed transactions after the issue causing the error is resolved. |
Cancel and delete a journal run
Occasionally, you may want to cancel a journal run, such as to rerun an entire batch of summary journal entries. Once canceled, the transactions in all journal entries associated with the run are released and available for update. Alternately, you can cancel a single journal entry. See Cancel and Delete a Journal Entry .
You can cancel a journal run when the run status is "pending" or "completed". You can only delete canceled journal runs. After you cancel a journal run, the status changes to Cancel in progress and to Cancelled after the cancellation is complete. If an error occurs, the cancellation process status returns to its original state (pending or completed).
Cancel a Run from the Journal Run List View
Click cancel from the view list when the journal run has a "pending" or "completed" status.
Delete a Run from the Journal Run List View
Click delete from the view list when the journal run has a "cancelled" status.
You can also cancel a completed journal run or delete a canceled run from the journal entry page.