C1-ReleaseHoldRequest Business Service
The Release Hold Request (C1-ReleaseHoldRequest) business service enables you to release an existing hold request which is in the Active status. You can call this business service from an external system through an inbound web service. At present, you can release a hold request through an inbound web service only when it has a single entity (i.e., a particular person, account, or bill) in the hold request. If you want to send the hold release request in the XML and/or JSON format, you need to ensure that you create a REST based inbound web service in Oracle Revenue Management and Billing. However, if you want to send the hold release request in the XML format, you can create a SOAP or REST based inbound web service in Oracle Revenue Management and Billing.
While sending the hold release request, you need to specify the following details:
-
Hold Request ID
-
Hold release reason and comments, if any
You must specify a reason which is already defined for the Released status of the C1-HoldRequest business object through the Status Reason screen.
You can release a hold request through an inbound web service only when the release approval process is not configured on the respective hold request type.
You cannot release a hold request through an inbound web service when the hold request start date is later than the system date or when the system date is later than the hold request end date.
If you want to release a hold request with multiple entities, you can opt to update the end date of each entity in the hold request through C1-UpdateHoldRequest business service by calling it separately for each entity of the hold request. Once the end date of all the entities in the hold request is updated through an inbound web service, you can then execute the C1-HLMON batch for necessary updates. For more information about the batch, see Oracle Revenue Management and Billing Batch Guide. Alternatively, you can release a hold request with multiple entities from the user interface.
Once the hold request is released through an inbound web service, the status of the hold request is set to Released. In addition, the hold request end date is set to the system date. If an error occurs while releasing the hold request, the system sends the error message in the response. The system enables you to track the hold release response sent to the external system using the Inbound Web Service History feature.
For more information, see Inbound Web Service History.
Related Topics
| For more information on... | See... |
|---|---|
| Hold Release Request in the XML Format | Hold Release Request in the XML Format |
| Hold Release Response in the XML Format | Hold Release Response in the XML Format |
| Hold Release Request in the JSON Format | Hold Release Request in the JSON Format |
| Hold Release Response in the JSON Format | Hold Release Response in the JSON Format |
| Hold Release Request and Response - Tags in XML Format | Hold Release Request and Response - Tags in XML Format |
| Hold Release Request and Response - Attribute/Value Pairs in JSON Format | Hold Release Request and Response - Attribute/Value Pairs in JSON Format |
| Sample Hold Release Request and Response in the XML Format | Sample Hold Release Request and Response in the XML Format |
| Sample Hold Release Request and Response in the JSON Format | Sample Hold Release Request and Response in the JSON Format |
Parent Topic: Hold Request Creation, Modification, Release, and View Through Inbound Web Service