Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.

download

Troubleshooting Order Management 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 are 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

Apttus_Config2.CustomerPOWebService. acceptOrder

Add one or more PO Items to accept PO

Ensure that you have added at least one PO item.

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Customer Purchase Order with id: customer PO Id Does not exist ·

Ensure that you have provided the correct PO Id.

Accept is only allowed when Customer Purchase order status is Draft, In Amendment, or Pending Cancellation.

Ensure that your customer purchase order status is Draft, In Amendment, or Pending Cancellation to accept the order.

Apttus_Config2.CustomerPOWebService. amendCustomerPO

Amend is only allowed when Customer Purchase order status is Accepted or Partially Processed.

Ensure that the status of the Customer Purchase Order is Accepted or Partially Processed.

Only customer purchase orders in Accepted status can be canceled.

Ensure that the status of the Customer Purchase Order is Accepted status to cancel the order.

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Apttus_Config2.CustomerPOWebService. cloneCustomerPO

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Apttus_Config2.CustomerPOWebService. UndoAmendCustomerPO

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Only customer purchase order in Pending Cancellation or In Amendment status can be undone

Ensure that the status of the Customer Purchase Order is either Pending Cancellation or In Amendment status to undone the Customer PO.

Apttus_Config2.CustomerPOWebService. cancelCustomerPO

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Apttus_Config2.OrderWebService.amendOrder

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Inflight Order Change is not enabled in Order System Properties

Ensure that you have enabled the "Inflight Order change" in Order System Properties.

Amend is only allowed when delayed asset creation is enabled for the orders.

Ensure that you have enabled the "Create Asset On Order Activation" in Order System Properties.

Assets are already created/updated for this order so it cannot be amended.

Ensure that Assets are not created for the order in case of amend operation.

Only order in Pending, In Fulfillment, and Partially Fulfilled status can be amended.

Ensure that the status of the Order is Pending, In Fulfillment, and Partially Fulfilled before amending an order.

Apttus_Config2.OrderWebService.cancelOrder

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Inflight Order Change is not enabled in Order System Properties

Ensure that you have enabled the "Inflight Order change" in Order System Properties.

Amend is only allowed when delayed asset creation is enabled for the orders.

Ensure that you have enabled the "Create Asset On Order Activation" in Order System Properties.

Assets are already created/updated for this order so it cannot be amended.

Ensure that Assets are not created for the order in case of cancel operation.

Apttus_Config2. OrderWebServic e.undoCancelOrder

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Undo Cancel is available for orders in Pending Cancellation status.

Ensure that the status of the order is Pending Cancellation.

Inflight Order Change is not enabled in Order System Properties.

Ensure that you have enabled the "Inflight Order change" in Order System Properties.

Apttus_Config2.OrderWebService.splitOrder

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Split is only allowed when order is in Draft or Pending status with a Finalized Cart.
  • Invalid input parameter(s) - OrderId=orderId
  • Invalid input parameter(s) - OrderId=[]
  • Invalid input parameter(s) - OrderLineNumbers=[]
  • Invalid input parameter(s) - OrderLineNumbers= orderLineNumber

Ensure that the status of the order is draft or Pending with a finalized cart or provide valid input parameters.

Apttus_Config2.OrderWebService.createRollupData

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Apttus_Config2.OrderWebService.deleteRollupData

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Apttus_Config2.OrderWebService.commitIncentiveData

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Apttus_Config2.OrderWebService.commitIncentiveLimitData

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Apttus_Config2.OrderWebService.commitIncentiveBenefitData

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

Apttus_Config2.OrderWebService.createConfigurationRequest

You do not have the level of access necessary to perform the operation you requested. Contact the owner of the record or your administrator if access is necessary.

Authentication or access (system permissions) issue. Contact an administrator or check the appropriate topic for authentication instructions.

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.