Sample Hold Request Update Request and Response in the XML Format

Using the below example, you can update all the fields in an active hold request where the hold request ID is 10000252262623

Sample Hold Request Update Request in the XML Format

<C1-UpdateHoldRequest>
    <sourceSystem>SMALL_NSC_PRIME</sourceSystem>
    <externalTransactionId>ETI22</externalTransactionId>
    <externalSourceId>ESI99</externalSourceId>
    <holdRequestId>10000252262623</holdRequestId>
    <holdComments>Update the fields based on the request ID</holdComments>
    <holdEndDate>2022-01-31</holdEndDate>
    <entityId>0122334455</entityId>
    <entityEndDate>2022-01-25</entityEndDate>
    <holdProcessData>
        <holdProcess>BILL</holdProcess>
        <holdProcessEndDate>2022-01-23</holdProcessEndDate>
    </holdProcessData>
    <holdProcessData>
        <holdProcess>FNDG</holdProcess>
        <holdProcessEndDate>2022-01-23</holdProcessEndDate>
    </holdProcessData>
    <characteristics>
        <action>Update</action>
        <characteristicType>INVOICE_TYPE</characteristicType>
        <characteristicValue>CMR</characteristicValue>
        <effectiveDate>2022-01-01</effectiveDate>
    </characteristics>
    <characteristics>
        <action>DELETE</action>
        <characteristicType>INVOICE_HOLD_REASON</characteristicType>
        <characteristicValue>CMDP</characteristicValue>
        <effectiveDate>2022-01-01</effectiveDate>
    </characteristics>
 </C1-ReleaseHoldRequest>

Sample Hold Request Update Response in the XML Format

The following information is received as response when the hold request update request is processed successfully.

<C1-UpdateHoldRequest>
    <requestProcessStatus>Success</requestProcessStatus>
    <sourceSystem>SMALL_NSC_PRIME</sourceSystem>
    <externalTransactionId>ETI22</externalTransactionId>
    <externalSourceId>ESI99</externalSourceId>
    <holdRequestId>10000252262623</holdRequestId>
    <holdComments>Update the fields based on the request ID</holdComments>
    <holdEndDate>2022-01-31</holdEndDate>
    <entityId>0122334455</entityId>
    <entityEndDate>2022-01-25</entityEndDate>
    <holdProcessData>
        <holdProcess>BILL</holdProcess>
        <holdProcessEndDate>2022-01-23</holdProcessEndDate>
    </holdProcessData>
    <holdProcessData>
        <holdProcess>FNDG</holdProcess>
        <holdProcessEndDate>2022-01-23</holdProcessEndDate>
    </holdProcessData>
    <characteristics>
        <action>UPDATE</action>
        <characteristicType>INVOICE_TYPE</characteristicType>
        <characteristicValue>CMR</characteristicValue>
        <effectiveDate>2022-01-01</effectiveDate>
    </characteristics>
 </C1-UpdateHoldRequest>

The following information is received from the hold request when the hold request is not longer present in the Active status.

<C1-UpdateHoldRequest>
    <requestProcessStatus>Failure</requestProcessStatus>
    <sourceSystem>SMALL_NSC_PRIME</sourceSystem>
    <externalTransactionId>ETI22</externalTransactionId>
    <externalSourceId>ESI99</externalSourceId>
    <holdRequestId>10101252262623</holdRequestId>
    <holdComments>Update the fields based on the request ID</holdComments>
    <holdEndDate>2022-01-31</holdEndDate>
    <entityId>1133224455</entityId>
    <entityEndDate>2022-01-25</entityEndDate>
    <holdProcessData>
        <holdProcess>BILL</holdProcess>
        <holdProcessEndDate>2022-01-23</holdProcessEndDate>
    </holdProcessData>
    <holdProcessData>
        <holdProcess>FNDG</holdProcess>
        <holdProcessEndDate>2022-01-23</holdProcessEndDate>
    </holdProcessData>
    <characteristics>
        <action>UPDATE</action>
        <characteristicType>STATE_OF_ISSUE</characteristicType>
        <characteristicValue>TX</characteristicValue>
        <effectiveDate>2022-01-01</effectiveDate>
    </characteristics>
    <errormsg>The hold request is not in the active status.</errormsg>
 </C1-UpdateHoldRequest>

Note: We have given the above request and response samples to illustrate how the tags should be nested while sending a hold update request from the external system. However, you should not seamlessly use this request sample in your environment because the required pre-requisite data may not be available in your environment. In such case, the system will give erroneous results.

Related Topics

For more information on...	See...
Hold Request Update Request and Response - Tags in XML Format	Hold Request Update Request and Response - Tags in XML Format