How To Fix EDOCUMENT166 - Unable to cancel document; Check method RESTRICT_CANCEL (BAdI ES_ADAPTOR)

SAP Error Message - Details

• Message type: E = Error

• Message class: EDOCUMENT - eDocument: Messages

• Message number: 166

• Message text: Unable to cancel document; Check method RESTRICT_CANCEL (BAdI ES_ADAPTOR)

What causes this issue?

You are trying to cancel a document for which a corresponding eDocument
exists. However, this action is not allowed if you are using the
eDocument Basic Enablement.

System Response

The system does not allow you to cancel the source document.

How to fix this error?

Check if an implementation of the
<DS:IO.IF_EDOC_ADAPTOR RESTRICT_CANCEL>Restrict
cancellation of source document</>(RESTRICT_CANCEL) method of the
eDocument Adaptor BAdI (EDOC_ADAPTOR) exists and if it allows the
cancellation of the source document.

The system issues an error message and will not allow you to continue with this transaction until the error is resolved.

Procedure for System Administrators

Error message extract from SAP system. Copyright SAP SE.

Smart SAP Assistant

• What is the cause and solution for SAP error message EDOCUMENT166 - Unable to cancel document; Check method RESTRICT_CANCEL (BAdI ES_ADAPTOR) ?

  The SAP error message EDOCUMENT166 indicates that there is an issue with canceling a document due to restrictions defined in the BAdI (Business Add-In) ES_ADAPTOR. This error typically arises when the system checks for conditions that prevent the cancellation of a document, and those conditions are not met.
  Cause:
  
  Business Logic Restrictions: The BAdI ES_ADAPTOR may have implemented custom logic that restricts the cancellation of certain documents based on specific criteria (e.g., document status, related documents, etc.).
  Document Status: The document you are trying to cancel may be in a status that does not allow for cancellation (e.g., already processed, posted, etc.).
  Configuration Issues: There may be configuration settings in the system that enforce restrictions on document cancellation.
  
  Solution:
  
  Check BAdI Implementation: Review the implementation of the BAdI ES_ADAPTOR to understand the specific conditions that are preventing the cancellation. You may need to consult with your ABAP developer or SAP consultant to analyze the logic.
  Document Status Verification: Verify the status of the document you are trying to cancel. If it is in a status that does not allow cancellation, you may need to take appropriate actions to change its status or follow the correct procedure for cancellation.
  Consult Documentation: Check the SAP documentation or notes related to the eDocument framework and the specific BAdI for any known issues or additional configuration settings that may affect cancellation.
  Error Handling: If the cancellation is critical, consider implementing error handling or alternative workflows to manage the document lifecycle without violating the restrictions.
  SAP Support: If you are unable to resolve the issue, consider reaching out to SAP Support for assistance, especially if this is a recurring issue or if you suspect a bug in the BAdI implementation.
  
  Related Information:
  
  BAdI ES_ADAPTOR: This BAdI is part of the eDocument framework in SAP and is used to adapt the behavior of document processing, including cancellation.
  SAP Notes: Search for relevant SAP Notes that may provide additional insights or patches related to this error message.
  Transaction Codes: Use transaction codes like SE18 (for BAdI implementation) and SE19 (for BAdI implementation management) to analyze and modify the BAdI behavior if necessary.
  
  By following these steps, you should be able to identify the cause of the error and implement a solution to resolve it.