Manage Billing Document Configuration
Zuora offers the ability to configure whether to automatically generate files for billing documents through the Zuora UI. Billing documents include invoices, credit memos, and debit memos. Credit and debit memos are available only if you have the Invoice Settlement feature enabled.
To generate files for billing documents, you can select the Enable the billing document generation check box after navigating to Billing > Manage Billing Document Configuration. By default, this check box is selected, indicating Zuora generates files for billing documents.
If the function of automatically generate files for billing documents is enabled, you can easily create and manage your billing document templates. The billing document templates are used to generate PDF invoices for your bills. You can also customize the format of the numbers for billing documents.
Navigation: click your username at the top right and navigate to Billing > Manage Billing Document Configuration.
Disable Billing Document File Generation
To disable the function of automatically generating files for billing documents, perform the following steps:
- Click your username at the top right and navigate to Billing > Manage Billing Document Configuration.
- On the page that is displayed, clear the Enable the billing document generation check box.
Only the Document Filename Patterns tab is displayed on the page.
The following table lists the expected behaviors upon trigger events after the function of automatically generating files for billing documents is disabled.
| Trigger | Expected behavior |
|---|---|
Invoice events: changes on invoices or invoice items
|
No files are generated for invoices. |
| UI: view invoice PDF files |
|
| UI: view invoice Word files | On the invoice details page, view > Invoice Word is unavailable, indicating that no Word files can be downloaded for the invoice. |
| UI: regenerate PDF file for an invoice | On the invoice details page, more > Regenerate Invoice PDF is unavailable, indicating that no PDF files can be generated for the invoice. |
| API: Synchronously or asynchronously create orders with Billing = True | No files are generated for invoices. |
| UI/API: email invoice files |
If any files exist for an invoice and a notification is defined to include an invoice file, the last existing file is attached in the notification email. Otherwise, email invoice and more > Email Invoice are unavailable on the invoice details page. The emailing action fails with the API option for emailing invoice files. |
| API: regenerate files for invoices | If you call the corresponding API operation, a message “The request cannot be done because billing document generation is disabled”. is returned. |
| API: query invoice body | The last existing file for the invoice is downloaded if any. Otherwise, null is returned. |
| API: get invoice file from Zuora 360 package in SFDC | The last existing PDF file for the invoice is downloaded if any. Otherwise, a message "No invoice was found" is returned. |
| Export invoices | The last existing file for the invoice is downloaded if any. Otherwise, null is returned. |
| Email notifications with invoice or payment attachments | If any files exist for an invoice and a notification is defined to include an invoice file, the last existing file is attached in the notification email. Otherwise, the “The notification cannot be sent” message is returned. |
Credit memos: same triggers as invoice
|
Same as invoices. |
Debit memos: same triggers as invoice
|
Same as invoices. |
Manage Billing Document Templates
From the Manage Invoice Rules and Templates tab, you can view your list of existing invoice templates and create new templates. If you have the Invoice Settlement feature enabled, the Manage Invoice, Credit/Debit Memo Templates tab is displayed. You can also manage credit and debit memo templates in this setting.
You can use template Actions to set a template as your default, edit, preview, or remove a template. You can also show the ID of a template. Template IDs are used with the Zuora API. Billing document templates are set at the customer level, not at the product level.
See Creating a Custom Invoice Template for more information about managing invoice templates. See Generate Memo PDFs with Custom Memo Template for more information about managing memo templates.
Prepare Templates for New Invoice File Generation Service
See Upgrade to New Invoice File Generation Service for more information.
Prefix & Numbering
See Prefix and Numbering Configuration for Billing Documents for more information.