This article presents troubleshooting tips for the common problems that you may encounter while customizing quote templates.
|Zuora quote templates must be .doc files.||If you are using Word 2007 or newer version, you must save the template with the .doc extension. Zuora does not register templates that have a .docx extension.|
|You changed a merge field, but data does not appear in the field .|| |
You may have modified the field without using Edit Field.
To fix the issue:
|There is an additional field displayed on the quote.||There is a hidden merge field. |
Press ALT + F9 on Windows or Fn + ALT + F9 on Mac to display all merge fields codes, and then remove the hidden field.
|A merge field in quote template is not replaced with the corresponding value.|| |
This merge field is not supported in quote templates, and the value could not be retrieved from Salesforce. See Supported Merge Fields for Quote Templates for lists of supported merge fields.
|You want to use custom fields on the QuoteRatePlanCharge object for Amendment or Renewal quotes.|| |
Link the ChargeSummary and QuoteRatePlanCharge objects, e.g. ChargeSummary.QuoteRatePlanCharge.MyCustomFieldName__c.
|A query exception returns.|| |
The table sort fields may not be valid merge fields.
|An error message about an invalid field appears during a PDF/Word generation process.||A merge field cannot be accessed or found during the PDF generation process. Make the appropriate change to the template.|
A warning message returns when uploading the quote template:
Merge fields display a different font depending on whether field codes are toggled on or off. For example, the field value below is shown in Arial whereas the field code is shown in Times New Roman.
To fix the issue:
If the format code is not supported, there are validation errors when uploading the template.
A merge field is not allowed to contain both a formatting string ,e.g., "
For example, if you do not remove "
To fix the issue, remove the switch,"