home

Zuora Billing

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Billing

Usage billing

Handle usage import failure

Learn how to handle usage import failures and configure notifications for error details.

In some cases, you might see a status message similar to this one, after uploading a usage file: 1 usage import is still not completed as of 12/3/12 3:20 PM. If you wait for a while and refresh the page, the message disappears.

In this case, the upload process encountered errors and the usage data was not uploaded successfully. Zuora has a notification that you can configure to provide more details about the error.

To enable this email notification, complete the following steps:

  1. Navigate to Extension Studio > Events & Notifications in the left navigation menu.
  2. Locate the Failed Status notification defined on the Import Processed event and click the Edit icon Edit icon.
  3. Enable the Active option and click Save.
  4. Upload your usage data again.
    Make sure the length of the usage file name is less than 50 characters. If the upload fails, you will receive an email notification that gives you more information about the upload errors.

Zuora recommends that you also enable the Completed Status notification defined on the Import Processed event, which will tell you when your usage upload has completed successfully.

Last updated: November 6, 2025