Standard events for Zuora Billing
Describes the standard events supported by Zuora Billing.
|
Name |
Related Event |
Description |
|---|---|---|
|
Cancellation |
AmendmentProcessed |
A subscription cancelation amendment has been submitted and processed. |
|
NewProduct |
AmendmentProcessed |
An "add new product" amendment has been submitted and processed. |
|
Owner Transfer |
AmendmentProcessed |
An Owner Transfer amendment has been submitted and processed. |
|
RemoveProduct |
AmendmentProcessed |
A remove product amendment has been submitted and processed. |
|
Renewal |
AmendmentProcessed |
A renewal amendment has been submitted and processed. |
|
Resume Subscription |
AmendmentProcessed |
A Resume Subscription amendment has been submitted and processed. Note:
The AmendmentProcessed notification for Resume Subscription amendment is in Limited Availability. If you already have Suspend and Resume feature enabled, this notification is available automatically. Submit a request at Zuora Global Support only if you wish to have access to Suspend and Resume feature. |
|
Suspend Subscription |
AmendmentProcessed |
A Suspend Subscription amendment has been submitted and processed. Note:
The AmendmentProcessed notification for Suspend Subscription amendment is in Limited Availability. If you already have Suspend and Resume feature enabled, this notification is available automatically. Submit a request at Zuora Global Support only if you wish to have access to Suspend and Resume feature. |
|
TermsAndConditions |
AmendmentProcessed |
A term and condition amendment has been submitted and processed. |
|
UpdateProduct |
AmendmentProcessed |
An update product amendment has been submitted and processed. |
|
Completed Status |
Bill Run Completion |
A bill run has completed successfully. |
|
Error Status |
Bill Run Completion |
A bill run has not completed successfully. |
|
Completed Status |
Billing Preview Run Completion |
A billing preview run has completed successfully. |
|
Error Status |
Billing Preview Run Completion |
A billing preview run has completed with error. |
|
Day(s) Before/After Invoice Due Date |
Invoice Due |
This event sends a notification for each invoice that matches the criteria for the Invoice Due Date. You can choose the number of days before or after the invoice due date to send the notification, and you can create multiple notifications. For example, you can send notifications at 5, 7, and 10 days past due. This notification is triggered by a scheduled job at 4:15 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 4:15 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. Please also see Invoices Past Due, Account Summary notification for an Account-level notification of all overdue invoices on an account. |
|
Invoice Posted Manually |
Invoice Posted |
Generate an event when a draft invoice is posted manually from the invoice detail page. This event will trigger a notification when you click post in a Bill run page. This also allows you to manually trigger a notification when you click post invoice from the individual (draft) invoice's page in the Zuora UI. |
|
Invoice Posted via API |
Invoice Posted |
Generate an event when a draft invoice is posted via API. |
|
Invoice Posted within a Bill Run of Auto-Post |
Invoice Posted |
Trigger the notification when invoices are posted within a bill run and the bill run has auto-post. This is to support existing email notification behavior from within a bill run. |
|
Invoices past due, account summary |
Invoices Past Due, Account Summary |
Summary information of past due posted invoices of customer accounts, generally delivered on monthly basis. The invoice past due event applies to the account level, rather than the invoice level. The past due invoices will be checked first, and if any exist they will be included in a single notification. The past due calculation is performed according to the relevant date fields on invoices, not on the account. The time when the notification is sent is determined according to the account's billing day or a specific day of this month. To set a specific day of the month, edit the notification and set the Notification delivery day field. The Notification delivery day can be set up to 365 days after the invoice due date. This notification is triggered by a scheduled job at 3:00 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 3:00 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |
|
Contract Effective Date |
Key Dates |
A subscription notification is sent on the contract effective date. This event only monitors the Contract Effective Date field on the Subscription object. An Amendment or Order that changes an existing subscription but does not change the Contract Effective Date field will not trigger this event. This notification is triggered by a scheduled job at 9:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 9:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |
|
Customer Acceptance Date |
Key Dates |
A subscription notification is sent on the customer acceptance date. This notification is triggered by a scheduled job at 9:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 9:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |
|
Service Activation Date |
Key Dates |
A subscription notification is sent on the activation date for services or products within a subscription. This notification is triggered by a scheduled job at 9:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 9:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |
|
Subscription End Date |
Key Dates |
A subscription notification is sent on the subscription end date at 9:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 9:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |
|
Subscription Resume Date |
Key Dates |
A subscription notification is sent on the date when subscription resumption takes effect. The notification is triggered by a scheduled job at 9:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 9:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. Note:
The Key Date(s) notification for Resume Subscription is in Limited Availability. If you already have Suspend and Resume feature enabled, this notification is available automatically. Submit a request at Zuora Global Support only if you wish to have access to Suspend and Resume feature. |
|
Subscription Start Date |
Key Dates |
A subscription notification is sent on the subscription start date at 9:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 9:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. This is the term start date of the original subscription. For more information about data centers, see Zuora data centers. |
|
Subscription Suspend Date |
Key Dates |
A subscription notification is sent on the date when subscription suspension takes effect. The notification is triggered by a scheduled job at 9:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 9:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. Note:
The Key Date(s) notification for Suspend Subscription is in Limited Availability. If you already have Suspend and Resume feature enabled, this notification is available automatically. Submit a request at Zuora Global Support only if you wish to have access to Suspend and Resume feature. |
|
Term End Date |
Key Dates |
A subscription notification is sent on the term end date. This notification is triggered by a scheduled job at 9:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 9:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |
|
Term Start Date |
Key Dates |
A subscription notification is sent on the term start date. By default, the contract effective date is set to be the term start date. This notification is triggered by a scheduled job at 9:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 9:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |
|
Manual Email For Invoice |
Manual Email For Invoice |
Send email notification manually from invoice detail page. |
|
Active |
New Subscription Created |
A new subscription has been created and activated. |
|
Pending Acceptance |
New Subscription Created |
A new subscription has been created and is in Pending Acceptance status. |
|
Pending Activation |
New Subscription Created |
A new subscription has been created and is in Pending Activation status. |
|
Rate Plan Charge End Date |
Rate Plan Charge Key Dates |
A rate plan charge notification is sent on the date when a charge ends. The notification is triggered by a scheduled job at 8:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 8:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. If the subscription is cancelled before today's date, the notification will not be sent. For more information about data centers, see Zuora data centers. When creating or editing a notification, you can set when to notify your customers by offsetting the number of days in the Offset field. In this case, the key date refers to the date in your timezone on which you configure this Offset field. For example, if you configure this field on 2023-12-06 and the offset is set to 1 day after the key date, then rate plan charge notifications are sent for charges that end on 2023-12-07. This event type is only for subscriptions that are in PendingActivation, PendingAcceptance, Active, or Cancelled status. |
|
Rate Plan Charge Start Date |
Rate Plan Charge Key Dates |
A rate plan charge notification is sent on the date when a charge starts. The notification is triggered by a scheduled job at 8:45 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 8:45 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. If the subscription is cancelled before today's date, the notification will not be sent. For more information about data centers, see Zuora data centers. When creating or editing a notification, you can set when to notify your customers by offsetting the number of days in the Offset field. In this case, the key date refers to the date in your timezone on which you configure this overviewOffset field. For example, if you configure this field on 2023-12-06 and the offset is set to 1 day before the key date, then rate plan charge notifications are sent for charges that start on 2023-12-05. This event type is only for subscriptions that are in PendingActivation, PendingAcceptance, Active, or Cancelled status. |
|
Summary Statement Generated |
Summary Statement Generated |
A summary statement for a customer account is generated successfully. |
|
30 days before auto renewal |
Upcoming Renewal |
The subscription is within 30 days of its scheduled renewal and the subscription will be automatically renewed. This notification is triggered by a scheduled job at 00:01 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 00:01 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |
|
30 days before renewal |
Upcoming Renewal |
The subscription is within 30 days of its scheduled renewal. This notification is triggered by a scheduled job at 00:01 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 00:01 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |
|
60 days before renewal |
Upcoming Renewal |
The subscription is within 60 days of its scheduled renewal. This notification is triggered by a scheduled job at 00:01 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 00:01 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |
|
90 days before renewal |
Upcoming Renewal |
The subscription is within 90 days of its scheduled renewal. This notification is triggered by a scheduled job at 00:01 am UTC time for tenants in EU Cloud Data Center and US Cloud Data Center 1, or 00:01 am Los Angeles time (UTC-07:00 or UTC-08:00 depending on the time of the year) for tenants in US Cloud Data Center 2. For more information about data centers, see Zuora data centers. |