Configure templates
Learn how to configure dynamic request templates using the Liquid Template Language for tax systems in Zuora.
The Dynamic Request Template is the body of the request where Zuora populates invoice information that can be configured based on your needs. Templates are dynamically rendered using the Liquid Template Language and are provided in the Text/XML or Application/JSON format.
To configure a dynamic request template:
- Launch the created Tax instance and click the TEMPLATE CONFIGURATION tab.
- Select the tax engine for which you want to configure templates from the Tax Engine dropdown list.
- Select the tab for the template (Standard or taxVoid) you want to configure. Zuora provides you with two templates, the Standard template and the taxVoid template; but only the Standard template is required to be completed. Tax systems have many configuration options. The template does not have to use all the options and must be configured based on the required information of the request. Templates can include more fields than the required set of fields in the request. Refer to your tax vendor's API documentation or contact their support to learn more about how their fields are formatted. In the case of a failed payment where rollback of the Subscribe call and deleting the invoice is desired, a taxVoid template is necessary to send a request to the tax vendor to also void the invoice and subsequent tax records from their system. For more information, see Configure the taxVoid template.
- Add a new template or modify the default template in the text box.
To view all available fields and corresponding values that can be used in the template:
-
When you complete the configuration, click
and then select Preview Template to preview the configured template. If you want to start over, you can click
and select Revert Template to Default .
- Click Save Both Template below the text box to save the template configurations.