Dunning Letters Error Codes

When you use the dunning features provided by the Dunning Letters SuiteApp, error messages are shown on the UI or in the script execution log.

Dunning User Errors

The following error messages are shown on the UI:

Error Code	Message	Cause	Action
DUNNING_PERMISSION_ERROR	You do not have privileges to view this page.	You tried to access the Bulk Update Customer Records page and the Dunning Bulk Assignment page using a role that does not have the required permission. Only Dunning Director roles can access the Bulk Update and Bulk Assignment pages.	Make sure you are logged in using the Dunning Director, Accountant, or Administrator role. If you are using a custom role, an administrator must grant the role the required permission. See Dunning Permissions and Access.
FOR_DUNNING_DIRECTOR_ACCOUNTANT_ADMIN_ACCESS_ONLY	Only the Administrator, Dunning Director, and Accountant roles can create and modify this type of record.	You tried to create or edit one of the following dunning custom records using a role that does not have the required permission: Dunning Configuration Dunning Level Rule Dunning Priority Dunning Procedure	Make sure you are logged in using the Dunning Director, Accountant, or Administrator role. If you are using a custom role, an administrator must grant the role the required permission. See Dunning Permissions and Access.
DUNNING_DELETE_PERMISSION_FOR_ADMIN_ONLY	Only the Administrator role can delete this type of record.	You tried to delete one of the following dunning custom records using a role that does not have the required permission: Dunning Configuration Dunning Evaluation Result Dunning Priority	Make sure you are logged in using the Administrator role. See Dunning Permissions and Access.
DUNNING_FOR_ADMINISTRATOR_ACCESS_ONLY	Only the Administrator role can create and modify this type of record.	You tried to create or modify the following dunning custom record using a role that does not have the required permission: Dunning Evaluation Result	Make sure you are logged in using the Administrator role. See Dunning Permissions and Access.
DUNNING_DELETE_PERMISSION_FOR_ADMIN_DD_ACCOUNTANT_ONLY	Only the Administrator, Dunning Director, and Accountant roles can delete this type of record.	You tried to delete the following dunning custom record using a role that does not have the required permission: Dunning Template	Make sure you are logged in using the Administrator, Dunning Director, or Accountant role. If you are using a custom role, an administrator must grant the role the required permission. See Dunning Permissions and Access.
DUNNING_PROC_TYPE_MODIFICATION_NOT_ALLOWED	You are not allowed to edit dunning procedure type.	You tried to edit the Applies To field on the dunning procedure record. The field indicates whether the dunning procedure is intended to be assigned to customers or to invoices. After the dunning procedure record has been saved, the Applies To field can no longer be edited.	Create a new dunning procedure with the desired dunning procedure type.
DUNNING_CUSTOMER_BULK_UPDATE_SS_DEPLOYMENT_NOT_FOUND	No deployment found for Customer Dunning Bulk Update SS.	There is no deployment for the Customer Bulk Update scheduled script.	An administrator must create a script deployment for the scheduled script, Dunning bulk Updater – Customer, with the following details: ID: customdeploy_3805_bulk_updater_cust STATUS: Not Scheduled EXECUTE AS ROLE: Administrator
DUNNING_CUSTOMER_VALIDATION_FAILED	The error message shown depends on the specific field or record where the validation error occurred. The error message can be any of the following: The following dunning letter recipients do not have an email address on their contact records: {CONTACTNAMES}. The record cannot be saved. The Allow Letters To Be Emailed box is checked, but there is no email address or dunning recipient to send letters to. To save this record, the following conditions must be true: The Dunning Recipients subtab has at least one contact with an email address. The Email field on the customer record has an email address. Note: The customer's email address is required only if the Do Not Send Letters to Customer Email box is not checked. There is no email address on the customer record, and there is no dunning letter recipient specified for this customer. Enter an email address on the customer record, or select on the Dunning subtab at least one dunning letter recipient that has an email address. The record cannot be saved. The Allow Letters To Be Emailed box is checked, but there is no dunning recipient to send letters to. To save this record, the Dunning Recipients subtab must have at least one contact with an email address. Note: The customer's email address is required only if the Do Not Send Letters to Customer Email box is not checked.	These errors are validation errors that can occur when creating or editing records.	Edit the fields or subtabs that contain invalid or missing values.

Error Code

Message

Cause

Action

DUNNING_PERMISSION_ERROR

You do not have privileges to view this page.

You tried to access the Bulk Update Customer Records page and the Dunning Bulk Assignment page using a role that does not have the required permission. Only Dunning Director roles can access the Bulk Update and Bulk Assignment pages.

Make sure you are logged in using the Dunning Director, Accountant, or Administrator role. If you are using a custom role, an administrator must grant the role the required permission.

See Dunning Permissions and Access.

FOR_DUNNING_DIRECTOR_ACCOUNTANT_ADMIN_ACCESS_ONLY

Only the Administrator, Dunning Director, and Accountant roles can create and modify this type of record.

You tried to create or edit one of the following dunning custom records using a role that does not have the required permission:

Dunning Configuration
Dunning Level Rule
Dunning Priority
Dunning Procedure

Make sure you are logged in using the Dunning Director, Accountant, or Administrator role. If you are using a custom role, an administrator must grant the role the required permission.

See Dunning Permissions and Access.

DUNNING_DELETE_PERMISSION_FOR_ADMIN_ONLY

Only the Administrator role can delete this type of record.

You tried to delete one of the following dunning custom records using a role that does not have the required permission:

Dunning Configuration
Dunning Evaluation Result
Dunning Priority

Make sure you are logged in using the Administrator role.

See Dunning Permissions and Access.

DUNNING_FOR_ADMINISTRATOR_ACCESS_ONLY

Only the Administrator role can create and modify this type of record.

You tried to create or modify the following dunning custom record using a role that does not have the required permission:

Dunning Evaluation Result

Make sure you are logged in using the Administrator role.

See Dunning Permissions and Access.

DUNNING_DELETE_PERMISSION_FOR_ADMIN_DD_ACCOUNTANT_ONLY

Only the Administrator, Dunning Director, and Accountant roles can delete this type of record.

You tried to delete the following dunning custom record using a role that does not have the required permission:

Dunning Template

Make sure you are logged in using the Administrator, Dunning Director, or Accountant role. If you are using a custom role, an administrator must grant the role the required permission.

See Dunning Permissions and Access.

DUNNING_PROC_TYPE_MODIFICATION_NOT_ALLOWED

You are not allowed to edit dunning procedure type.

You tried to edit the Applies To field on the dunning procedure record. The field indicates whether the dunning procedure is intended to be assigned to customers or to invoices.

After the dunning procedure record has been saved, the Applies To field can no longer be edited.

Create a new dunning procedure with the desired dunning procedure type.

DUNNING_CUSTOMER_BULK_UPDATE_SS_DEPLOYMENT_NOT_FOUND

No deployment found for Customer Dunning Bulk Update SS.

There is no deployment for the Customer Bulk Update scheduled script.

An administrator must create a script deployment for the scheduled script, Dunning bulk Updater – Customer, with the following details:

ID: customdeploy_3805_bulk_updater_cust
STATUS: Not Scheduled
EXECUTE AS ROLE: Administrator

DUNNING_CUSTOMER_VALIDATION_FAILED

The error message shown depends on the specific field or record where the validation error occurred. The error message can be any of the following:

The following dunning letter recipients do not have an email address on their contact records: {CONTACTNAMES}.
The record cannot be saved. The Allow Letters To Be Emailed box is checked, but there is no email address or dunning recipient to send letters to. To save this record, the following conditions must be true:
- The Dunning Recipients subtab has at least one contact with an email address.
- The Email field on the customer record has an email address.
Note: The customer's email address is required only if the Do Not Send Letters to Customer Email box is not checked.
There is no email address on the customer record, and there is no dunning letter recipient specified for this customer. Enter an email address on the customer record, or select on the Dunning subtab at least one dunning letter recipient that has an email address.
The record cannot be saved. The Allow Letters To Be Emailed box is checked, but there is no dunning recipient to send letters to. To save this record, the Dunning Recipients subtab must have at least one contact with an email address.

Note: The customer's email address is required only if the Do Not Send Letters to Customer Email box is not checked.

These errors are validation errors that can occur when creating or editing records.

Edit the fields or subtabs that contain invalid or missing values.

Script Errors for Dunning

Errors can be encountered when the system runs the dunning scripts. For these errors, contact Support. Be sure to provide details such as the error code and error message found in the script execution log.

Error Code	Message	Cause	Action
DUNNING_METRICS_COLLECTOR_CLASS_NOT_IMPLEMENTED	Please implement a MetricsCollector.	The MetricsCollector implementing class is missing.
DUNNING_UNAUTHORIZED_USE_OF_ABSTRACT_PARSER_CLASS	Please use a subclass of AbstractParser.	AbstractParser class used is unauthorized.
DUNNING_AUTO_ASSIGN_PROCEDURE_SEARCH_HANDLER_CLASS_NOT_IMPLEMENTED	Please implement a logic for handling the results.	AutoAssignProcedureSearchHandler implementing class is missing.
DUNNING_QUEUE_ACTION_CLASS_NOT_IMPLEMENTED	Please implement a dunning queue action.	DunningQueueAction implementing class is missing.
DUNNING_STATEMENT_GENERATION_INPUT_REQUIRED	Method dunning.app.StatementGenerator.generateStatement requires an input parameter of type DunningLevelStatementGeneratorInput.	Input parameter for method dunning.app.StatementGenerator.generateStatement is missing.
DUNNING_FORM_TITLE_MISSING	Provide a form title using setTitle.	Form title is not set in the FormBuilder class.
DUNNING_CURRENCY_CONVERTER_PARAMETER_REQUIRED	CurrencyConverter Input is a mandatory constructor parameter.	The constructor parameter of the CurrencyConverter class (currency wrapper) may be null or undefined.
DUNNING_SEARCH_COLUMN_WRAPPER_PARAMETER_REQUIRED	SearchColumn requires a columnDefinition constructor parameter.	The constructor parameter of the SearchColumn class may be null or undefined.
DUNNING_SEARCH_FILTER_WRAPPER_PARAMETER_REQUIRED	SearchFilter requires a filterDefinition constructor parameter.	The constructor parameter of the SearchFilter class may be null or undefined.
DUNNING_MESSAGE_LOADER_ERROR	An error has occurred in the MessageLoader class.	The MessageLoader class may be sending the request to an incorrect message loader service.
DUNNING_HOME_FOLDER_CREATION_ERROR	An error has occurred in creating dunning letters home folder in the file cabinet.	An error occurred during the creation of the home folder for the dunning letter files in the file cabinet. The record type and field name/value pairs may be incorrect.
DUNNING_PDF_SUBFOLDER_CREATION_ERROR	An error has occurred in creating dunning letters pdf subfolder in the file cabinet.	An error occurred during the creation of the PDF subfolder for the dunning letter PDF files in the file cabinet. The record type and field name/value pairs may be incorrect.
DUNNING_TEMPLATE_BUILDER_RECORD_ADDITION_ERROR	An error has occurred while adding a record to the template builder.	Failure in adding a record to the template builder. The ns_wrapper.TemplateRenderer.addRecord method has invalid parameters.
DUNNING_TEMPLATE_BUILDER_SEARCHRESULT_ADDITION_ERROR	An error has occurred while adding a search result to the template builder.	Failure in adding the search result to the template builder. The ns_wrapper.TemplateRenderer.addSearchResults method has invalid parameters.
DUNNING_LOCALIZATION_VARIABLE_LIST_LOADER_ERROR	An error has occurred in the LocalizationVariableListLoader class.	The LocalizationVariableListLoader class may be sending the request to an incorrect localization variable loader service.
DUNNING_FIELD_API_WRAPPER_SUBMITFIELD_ERROR	An error has occurred in Field API Wrapper -ns_wrapper.api.field.submitField.	The parameters supplied to the ns_wrapper.api.field.submitField method may be incorrect.
DUNNING_REC_API_WRAPPER_ATTACHREC_ERROR	An error has occurred in Record API Wrapper -ns_wrapper.api.record.attachRecord.	The parameters supplied to the ns_wrapper.api.record.attachRecord method may be incorrect.
DUNNING_SUBLIST_API_WRAPPER_COMMIT_LINEITEM_ERROR	An error has occurred in Sublist API Wrapper -ns_wrapper.api.sublist.commitLineItem.	The parameters supplied to the ns_wrapper.api.sublist.commitLineItem method may be incorrect.
DUNNING_MAILER_ERROR	An error has occurred in sending email.	The object parameter supplied to the suite_l10n.communication.Mail constructor may be incorrect.
DUNNING_TEMPLATE_BUILDER_MESSAGE_RENDER_ERROR	An error has occurred while rendering the message.	The object parameter supplied to the dunning.app.TemplateBuilder constructor may be incorrect.
DUNNING_TEMPLATE_BUILDER_SUBJECT_RENDER_ERROR	An error has occurred while rendering the subject.	The object parameter supplied to the dunning.app.TemplateBuilder constructor may be incorrect.
DUNNING_PARSER_ERROR	An error has occurred in AbstractParser class.	The doParse method in the subclasses of AbstractParser has invalid parameters.
DUNNING_CUSTOMER_VALIDATION_FAILED	The error message shown depends on the specific field or record where the validation error occurred. The error message can be any of the following: The following dunning letter recipients do not have an email address on their contact records: {CONTACTNAMES}. The record cannot be saved. The Allow Letters To Be Emailed box is checked, but there is no email address or dunning recipient to send letters to. To save this record, the following conditions must be true: The Dunning Recipients subtab has at least one contact with an email address. The Email field on the customer record has an email address. Note: The customer's email address is required only if the Do Not Send Letters to Customer Email box is not checked. There is no email address on the customer record, and there is no dunning letter recipient specified for this customer. Enter an email address on the customer record, or select on the Dunning subtab at least one dunning letter recipient that has an email address. The record cannot be saved. The Allow Letters To Be Emailed box is checked, but there is no dunning recipient to send letters to. To save this record, the Dunning Recipients subtab must have at least one contact with an email address. Note: The customer's email address is required only if the Do Not Send Letters to Customer Email box is not checked.	These errors are validation errors that can occur when creating or editing records.	Edit the fields or subtabs that contain invalid or missing values.

Error Code

Message

Cause

Action

DUNNING_METRICS_COLLECTOR_CLASS_NOT_IMPLEMENTED

Please implement a MetricsCollector.

The MetricsCollector implementing class is missing.

DUNNING_UNAUTHORIZED_USE_OF_ABSTRACT_PARSER_CLASS

Please use a subclass of AbstractParser.

AbstractParser class used is unauthorized.

DUNNING_AUTO_ASSIGN_PROCEDURE_SEARCH_HANDLER_CLASS_NOT_IMPLEMENTED

Please implement a logic for handling the results.

AutoAssignProcedureSearchHandler implementing class is missing.

DUNNING_QUEUE_ACTION_CLASS_NOT_IMPLEMENTED

Please implement a dunning queue action.

DunningQueueAction implementing class is missing.

DUNNING_STATEMENT_GENERATION_INPUT_REQUIRED

Method dunning.app.StatementGenerator.generateStatement requires an input parameter of type DunningLevelStatementGeneratorInput.

Input parameter for method dunning.app.StatementGenerator.generateStatement is missing.

DUNNING_FORM_TITLE_MISSING

Provide a form title using setTitle.

Form title is not set in the FormBuilder class.

DUNNING_CURRENCY_CONVERTER_PARAMETER_REQUIRED

CurrencyConverter Input is a mandatory constructor parameter.

The constructor parameter of the CurrencyConverter class (currency wrapper) may be null or undefined.

DUNNING_SEARCH_COLUMN_WRAPPER_PARAMETER_REQUIRED

SearchColumn requires a columnDefinition constructor parameter.

The constructor parameter of the SearchColumn class may be null or undefined.

DUNNING_SEARCH_FILTER_WRAPPER_PARAMETER_REQUIRED

SearchFilter requires a filterDefinition constructor parameter.

The constructor parameter of the SearchFilter class may be null or undefined.

DUNNING_MESSAGE_LOADER_ERROR

An error has occurred in the MessageLoader class.

The MessageLoader class may be sending the request to an incorrect message loader service.

DUNNING_HOME_FOLDER_CREATION_ERROR

An error has occurred in creating dunning letters home folder in the file cabinet.

An error occurred during the creation of the home folder for the dunning letter files in the file cabinet. The record type and field name/value pairs may be incorrect.

DUNNING_PDF_SUBFOLDER_CREATION_ERROR

An error has occurred in creating dunning letters pdf subfolder in the file cabinet.

An error occurred during the creation of the PDF subfolder for the dunning letter PDF files in the file cabinet. The record type and field name/value pairs may be incorrect.

DUNNING_TEMPLATE_BUILDER_RECORD_ADDITION_ERROR

An error has occurred while adding a record to the template builder.

Failure in adding a record to the template builder. The ns_wrapper.TemplateRenderer.addRecord method has invalid parameters.

DUNNING_TEMPLATE_BUILDER_SEARCHRESULT_ADDITION_ERROR

An error has occurred while adding a search result to the template builder.

Failure in adding the search result to the template builder. The ns_wrapper.TemplateRenderer.addSearchResults method has invalid parameters.

DUNNING_LOCALIZATION_VARIABLE_LIST_LOADER_ERROR

An error has occurred in the LocalizationVariableListLoader class.

The LocalizationVariableListLoader class may be sending the request to an incorrect localization variable loader service.

DUNNING_FIELD_API_WRAPPER_SUBMITFIELD_ERROR

An error has occurred in Field API Wrapper -ns_wrapper.api.field.submitField.

The parameters supplied to the ns_wrapper.api.field.submitField method may be incorrect.

DUNNING_REC_API_WRAPPER_ATTACHREC_ERROR

An error has occurred in Record API Wrapper -ns_wrapper.api.record.attachRecord.

The parameters supplied to the ns_wrapper.api.record.attachRecord method may be incorrect.

DUNNING_SUBLIST_API_WRAPPER_COMMIT_LINEITEM_ERROR

An error has occurred in Sublist API Wrapper -ns_wrapper.api.sublist.commitLineItem.

The parameters supplied to the ns_wrapper.api.sublist.commitLineItem method may be incorrect.

DUNNING_MAILER_ERROR

An error has occurred in sending email.

The object parameter supplied to the suite_l10n.communication.Mail constructor may be incorrect.

DUNNING_TEMPLATE_BUILDER_MESSAGE_RENDER_ERROR

An error has occurred while rendering the message.

The object parameter supplied to the dunning.app.TemplateBuilder constructor may be incorrect.

DUNNING_TEMPLATE_BUILDER_SUBJECT_RENDER_ERROR

An error has occurred while rendering the subject.

The object parameter supplied to the dunning.app.TemplateBuilder constructor may be incorrect.

DUNNING_PARSER_ERROR

An error has occurred in AbstractParser class.

The doParse method in the subclasses of AbstractParser has invalid parameters.

DUNNING_CUSTOMER_VALIDATION_FAILED

The error message shown depends on the specific field or record where the validation error occurred. The error message can be any of the following:

The following dunning letter recipients do not have an email address on their contact records: {CONTACTNAMES}.
The record cannot be saved. The Allow Letters To Be Emailed box is checked, but there is no email address or dunning recipient to send letters to. To save this record, the following conditions must be true:
- The Dunning Recipients subtab has at least one contact with an email address.
- The Email field on the customer record has an email address.
Note: The customer's email address is required only if the Do Not Send Letters to Customer Email box is not checked.
There is no email address on the customer record, and there is no dunning letter recipient specified for this customer. Enter an email address on the customer record, or select on the Dunning subtab at least one dunning letter recipient that has an email address.
The record cannot be saved. The Allow Letters To Be Emailed box is checked, but there is no dunning recipient to send letters to. To save this record, the Dunning Recipients subtab must have at least one contact with an email address.

Note: The customer's email address is required only if the Do Not Send Letters to Customer Email box is not checked.

These errors are validation errors that can occur when creating or editing records.

Edit the fields or subtabs that contain invalid or missing values.

General Notices