ApplyReceiptService using SOAP UI in Oracle Integration Cloud

 Step-by-Step: Apply Receipt via SOAP UI in OIC

========================================================

To apply a receipt amount using SOAP UI in Oracle Integration Cloud (OIC), you must invoke the ApplyReceiptService SOAP operation with the correct payload structure and authentication. This complements your REST-based receipt creation and ensures the receipt is applied to invoices in Oracle Receivables Cloud.

1. Locate the WSDL

Use the ApplyReceiptService WSDL:

https://fusionURL/finReceivablesReceiptsService/ApplyReceiptService?WSDL

Import into SOAP UI or OIC SOAP Adapter.

2. Understand Required Fields

Typical payload includes:

ReceiptNumber: From REST API response.

ApplicationAmount: Amount to apply.

InvoiceNumber: Target invoice.

CustomerAccountNumber (optional but recommended).

Sample Request Payload 1:

-------------------------------

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

                  xmlns:typ="http://xmlns.oracle.com/apps/financials/receivables/receipts/receiptsService/types/">

   <soapenv:Header/>

   <soapenv:Body>

      <typ:applyReceipt>

         <typ:receiptNumber>RCPT12345</typ:receiptNumber>

         <typ:applicationDetails>

            <typ:applicationAmount>1000</typ:applicationAmount>

            <typ:invoiceNumber>INV56789</typ:invoiceNumber>

         </typ:applicationDetails>

      </typ:applyReceipt>

   </soapenv:Body>

</soapenv:Envelope>

-------------------------------

Sample Request Payload 2

Request Payload

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

 <soap:Body>

 <ns1:createAndApplyReceiptAsync

xmlns:ns1="http://xmlns.oracle.com/apps/financials/receivables/receipts/s

hared/createAndApplyReceiptService/commonService/types/">

 <ns1:createAndApplyReceipt

xmlns:ns2="http://xmlns.oracle.com/apps/financials/receivables/receipts/s

hared/createAndApplyReceiptService/commonService/">

 <ns2:BusinessUnitName> Vision Operations</ ns2:BusinessUnitName>

 <ns2:ReceiptMethodName>Check - BofA-ED</ns2:ReceiptMethodName>

 <ns2:ReceiptNumber>Rec_1163</ns2:ReceiptNumber>

 <ns1:CurrencyCode>USD</ns1:CurrencyCode>

 <ns2:Amount>362.80</ns2:Amount>

 <ns2:CustomerName>AR_Customer</ns2:CustomerName>

 <ns2:CustomerAccountNumber>1001</ns2:CustomerAccountNumber>

 <ns2:TransactionNumber>1163</ns2:TransactionNumber>

 </ns1:createAndApplyReceipt>

 </ns1:createAndApplyReceiptAsync>

 </soap:Body>

</soap:Envelope>

----------------------------------

Sample Response Payload 2

The Response payload will contain the receipt number if the invocation is

successful.

<ns0:createAndApplyReceiptAsyncResponse xmlns=""

xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:ns0="http://xmlns.oracle.com/apps/financials/receivables/receipts/s

hared/createAndApplyReceiptService/commonService/types/"

xmlns:wsa="http://www.w3.org/2005/08/addressing"

xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wsswssecurity-utility-1.0.xsd">

<ns2:result xmlns:ns0="http://xmlns.oracle.com/adf/svc/types/"

xmlns:ns1="http://xmlns.oracle.com/apps/financials/receivables/receipts/s

hared/createAndApplyReceiptService/commonService/"

xmlns:ns2="http://xmlns.oracle.com/apps/financials/receivables/receipts/s

hared/createAndApplyReceiptService/commonService/types/"

xmlns:tns="http://xmlns.oracle.com/adf/svc/errors/"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:type="ns1:CreateAndApplyReceiptResult"><ns1:Value>

 <ns2:BusinessUnitName> Vision Operations</ ns2:BusinessUnitName>

<ns1:ReceiptMethodName> Check - BofA-ED</ns1:ReceiptMethodName>

<ns1:ReceiptNumber>Rec_1163</ns1:ReceiptNumber>

<ns1:ReceiptDate/><ns1:GlDate xsi:nil="true"/>

<ns1:Amount>435.35</ns1:Amount>

<ns1:CustomerName>AR_Customer</ns1:CustomerName>

<ns1:CustomerAccountNumber>10011</ns1:CustomerAccountNumber>

<ns1:CurrencyCode>USD</ns1:CurrencyCode>

<ns1:TransactionNumber>1163</ns1:TransactionNumber>

</ns1:Value>

</ns2:result>

</ns0:createAndApplyReceiptAsyncResponse>

-------------------

4. Authentication

Use Basic Auth with Fusion credentials.

Ensure the user has Receivables Manager or equivalent role.

5. Test in SOAP UI

Send the request and validate the response.

Check Fusion UI: Receivables → Manage Receipts → Search by Receipt Number.

----------------------

Automate in Oracle Integration Cloud

====================================

1. Use SOAP Adapter.

2. Configure with the WSDL.

3. Choose applyReceipt operation.

4. Map fields from REST response (Ex:-ReceiptNumber, Amount, InvoiceNumber).

Integration Flow

Trigger: REST receipt creation.

Stage Variables: Capture receipt details.

Invoke SOAP Adapter: Apply receipt.

Error Handling: Log faults (Ex:-invalid invoice, insufficient amount).

Audit Trail: Store response in ATP DB or log file.