What is the SOAP payload to create a credit memo and apply it to an existing invoice in Oracle Fusion?

createCreditMemo — SOAP payload to credit an existing AR invoice | Oracle Fusion SOAP example

createCreditMemo — SOAP payload to credit an existing AR invoice

SOAP APIOracle Fusion · Financials · ARHigh confidenceCurated

CreditMemoService.createCreditMemo creates a standard Receivables credit memo. Crediting an existing invoice is done on the request itself: PreviousCustomerTransactionId points at the invoice's CUSTOMER_TRX_ID, and LinePercent / TaxPercent set how much of that invoice's lines and tax to credit (100 = full credit).

WSDL

SOAPhttps://<your-fusion-host>:443/fscmService/CreditMemoService?WSDL

POST the SOAP envelope to the same URL without ?WSDL. Replace <your-fusion-host> with your pod host.

Purpose

Create a credit memo against an existing customer transaction (invoice). Send the SOAP envelope by HTTP POST to https://<your-fusion-host>:443/fscmService/CreditMemoService (the WSDL URL without ?WSDL), with a WS-Security UsernameToken in the SOAP header for a user holding the Receivables credit memo privilege.

Parameters

BatchSourceSequenceIdrequiredBATCH_SOURCE_SEQ_ID of the transaction batch source to use (RA_BATCH_SOURCES_ALL). Controls numbering and defaulting.

PreviousCustomerTransactionIdrequiredCUSTOMER_TRX_ID of the invoice being credited (RA_CUSTOMER_TRX_ALL). This is what applies the credit memo to that invoice.

CustomerTransactionTypeSequenceIdrequiredCUST_TRX_TYPE_SEQ_ID of a Credit Memo transaction type (RA_CUST_TRX_TYPES_ALL).

GlDaterequiredAccounting date (YYYY-MM-DD) — must be in an open AR period.

TransactionDaterequiredCredit memo transaction date (YYYY-MM-DD).

LinePercentrequiredPercent of the original invoice's lines to credit. 100 = credit the whole invoice.

TaxPercentrequiredPercent of the original invoice's tax to credit. Usually matches LinePercent.

CurrencyCoderequiredTransaction currency — must equal the credited invoice's currency.

ReasonCoderequiredCredit memo reason (CREDIT_MEMO_REASON lookup), e.g. CANCELLATION.

TransactionNumberCredit memo number. Required when the batch source is not set to automatic numbering.

CommentsFree-text note stored on the credit memo header.

Example request

Request

<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:typ="http://xmlns.oracle.com/apps/financials/receivables/transactions/creditMemos/creditMemoService/types/"
    xmlns:cred="http://xmlns.oracle.com/apps/financials/receivables/transactions/creditMemos/creditMemoService/">
  <soapenv:Header/>
  <soapenv:Body>
    <typ:createCreditMemo>
      <typ:creditMemo>
        <cred:BatchSourceSequenceId>300000001234567</cred:BatchSourceSequenceId>
        <cred:Comments>Full credit for cancelled invoice INV-100045</cred:Comments>
        <cred:PreviousCustomerTransactionId>300000009876543</cred:PreviousCustomerTransactionId>
        <cred:CustomerTransactionTypeSequenceId>300000002345678</cred:CustomerTransactionTypeSequenceId>
        <cred:GlDate>2026-08-24</cred:GlDate>
        <cred:LinePercent>100</cred:LinePercent>
        <cred:TransactionDate>2026-08-24</cred:TransactionDate>
        <cred:CurrencyCode>USD</cred:CurrencyCode>
        <cred:TransactionNumber>INV-100045-CM</cred:TransactionNumber>
        <cred:ReasonCode>CANCELLATION</cred:ReasonCode>
        <cred:TaxPercent>100</cred:TaxPercent>
      </typ:creditMemo>
    </typ:createCreditMemo>
  </soapenv:Body>
</soapenv:Envelope>

Example response

Response

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
  <env:Body>
    <ns0:createCreditMemoResponse
        xmlns:ns0="http://xmlns.oracle.com/apps/financials/receivables/transactions/creditMemos/creditMemoService/types/">
      <ns0:result>
        <ns1:CustomerTransactionId
            xmlns:ns1="http://xmlns.oracle.com/apps/financials/receivables/transactions/creditMemos/creditMemoService/">300000012345999</ns1:CustomerTransactionId>
        <ns1:TransactionNumber
            xmlns:ns1="http://xmlns.oracle.com/apps/financials/receivables/transactions/creditMemos/creditMemoService/">INV-100045-CM</ns1:TransactionNumber>
      </ns0:result>
    </ns0:createCreditMemoResponse>
  </env:Body>
</env:Envelope>

Call lifecycle

01
WS-Security UsernameToken in the SOAP header.
- Same user needs the Receivables credit memo create privilege
- POST to the WSDL URL without ?WSDL
02
03
04
05