Troubleshooting Billing SOAP APIs

Refer to this topic for descriptions of API error messages thrown by Salesforce and suggested actions to take. An exception is an error caused during code execution. There are a number of built-in Apex exceptions as well as custom exceptions provided by Conga.

The following exceptions thrown by Salesforce that can be handled by Conga and converted to custom error messages:

System.Exception: Exception thrown under most circumstances.
System.CalloutException: Exception thrown when communicating with external systems.
DMLException: Exception thrown when performing CRUD ('Create', 'Read', 'Update', 'Delete') actions.

Refer to the following table for a list of custom error messages provided by Conga for some SOAP APIs, included suggested actions to take to resolve the exception.

API	Error Message	Suggested Action
applyLateFeesToInvoices	Late Fee Id cannot be null.	Ensure that you provide the correct Late Fee ID.
	The specified Late Fee (Id={0}) does not exist.	Ensure that you provide the correct Late Fee ID.
	A Late Fee has already been applied to the Invoice.	Apply a late fee that is not already applied to the invoice.
	To apply/cancel a Late Fee to/for an Invoice the Status ({0}) must be Approved.	Ensure that the invoice is already Approved.
	Cannot apply/cancel a Late Fee to an Invoice with a Payment Status of Paid.	Ensure that you do not apply the late fee to an invoice with Status as Paid.
	A Late Fee can only be applied to an Invoice when the Due Date ({0}) is less than the current Date ({1}).	Ensure that the Due Date is greater than the Current Date.
cancelInvoiceLateFees	The specified Related A/R Transaction (Id={0}) does not exist.	Ensure that you provide a valid Related A/R Transaction ID.
	The specified Related A/R Transaction ({0}) exists but it does not pertain to a Late Fee.	Ensure that the Related A/R Transaction is related to a late fee.
	The specified Related A/R Transaction ({0}) exists but it pertains to a Late Fee Transaction ({1}) that has already been canceled.	Ensure that the Late Fee is not already in a canceled state.
	Invoice Id cannot be null.	Ensure that you provide a valid Invoice ID.
	To apply/cancel a Late Fee to/for an Invoice the Status ({0}) must be Approved.	Ensure that the invoice is already Approved.
	Cannot apply/cancel a Late Fee to an Invoice with a Payment Status of Paid.	Ensure that you do not cancel the late fee applied to an invoice with Status as Paid.
createCreditMemoDocuments	You do not have the level of access necessary to perform the operation you requested. Please contact the owner of the record or your administrator if access is necessary. ({0})	Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.
createInvoiceDocuments	You do not have the level of access necessary to perform the operation you requested. Please contact the owner of the record or your administrator if access is necessary. ({0})	Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.
createInvoicesForOrder	You do not have the level of access necessary to perform the operation you requested. Please contact the owner of the record or your administrator if access is necessary. ({0})	Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.
createInvoices	You do not have the level of access necessary to perform the operation you requested. Please contact the owner of the record or your administrator if access is necessary. ({0})	Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.
createInvoices	Invalid Credit Memo Creation Option value given in input.	Ensure that you provide a valid credit memo creation option.
forecastBilling	Proposal Id is missing	Ensure that you provide a valid Proposal ID.
	Non-null and non-empty list of proposal Ids required	Ensure that you provide a valid Proposal ID.
	Proposal Id or Configuration line items are missing	Ensure that you provide a valid Proposal ID or Configuration ID.
processPendingUsageInput	You do not have the level of access necessary to perform the operation you requested. Please contact the owner of the record or your administrator if access is necessary. ({0})	Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.
	Invalid Asset Number	Ensure that you provide a valid Asset Number.
	Invalid Unit Of Measure	Ensure that you provide a valid Unit of Measure.
	Invalid Usage Date	Ensure that you provide a valid usage date.
	Quantity is required to process UsageInput.	Ensure that you provide the appropriate quantity.
	No Asset Line Item could be found for the specific Asset Number {0}.	Ensure that you provide a valid Asset Number.
	No Usage Schedule could be found for the specified Asset Number {0} and Usage Date {1}.	Ensure that usage schedules corresponding to the specified asset number and the usage date exist.
processRatedUsageInput	You do not have the level of access necessary to perform the operation you requested. Please contact the owner of the record or your administrator if access is necessary. ({0})	Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.
	No Asset Line Item could be found for the specific Asset Number {0}.	Ensure that you provide a valid Asset Number.
	No Usage Schedule could be found for the specified Asset Number {0} and Usage Date {1}.	Ensure that corresponding usage schedules are created for the specified Asser Number and the Usage Date.

The following are standard Salesforce exceptions that cannot be handled or changed:

LimitException
UnexpectedException
AssertException
NoAccessException
NoDataFoundException
SerializationException
VisualforceException

You can learn more about these exceptions and recommended actions to take by consulting Salesforce documentation.