Skip to Content
Technical Articles

Guidelines for API Journal Entry – Clearing (Asynchronous)

In this blog post you will learn some constraints, help information about API Journal Entry – Clearing (Asynchronous).

To learn more about Journal Entry APIs at Guidelines for API Journal Entry – Post.

1. Usage

Journal Entry – Clearing (Asynchronous) was delivered in CE1908, which provides asynchronous SOAP API which enable remote systems to clear journal entries in SAP S/4HANA Cloud asynchronously. The service supports G/L account clearing, customer account clearing, and vendor account clearing.

This service contains importing parameter tables for:

  • JournalEntry
  • GLItems
  • APARItems

To learn more about the information of importing parameters at SAP Help Journal Entry – Clearing (Asynchronous).

2. Prerequisite

In order to use this API, you need to firstly configure communication arrangement for communication scenario Finance – Posting Integration (SAP_COM_0002).

Read more at Guidelines for Configuring Communication Scenario Finance – Posting Integration (SAP_COM_0002)

3. How to Test

This  API is SOAP service. I suggest to test it with SOAPUI.

Read more at Guidelines for Testing Journal Entry API with SOAPUI and Checking Response Message

4. How to Check Response Message

As this is asynchronous API, you need to check the response message via Fiori App Message Dashboard.

Read more at Guidelines for Testing Journal Entry API with SOAPUI and Checking Response Message

5. Constraints and Consulting Questions

5.1    Constraints

Journal Entry – Clearing API has the following limitations:

  • Only full clearing is supported. Partial clearing and residual clearing are not supported.

 

6.Appendix

  1. SAP Help Page

Journal Entry – Clearing (Asynchronous)

  1. SAP API Business Hub

Journal Entry – Clearing (Asynchronous)

  1. Example Payload
Clear Vendor Invoice with Outgoing Payment and Down Payment

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sfin="http://sap.com/xi/SAPSCORE/SFIN">
   <soapenv:Header/>
   <soapenv:Body>
      <sfin:JournalEntryBulkClearingRequest>
         <MessageHeader>
            <!--Optional:-->
            <ID>MSG_2019-04-28_4.7</ID>
            <CreationDateTime>2019-04-12T12:00:00.1234567Z</CreationDateTime>
            <TestDataIndicator>false</TestDataIndicator>
         </MessageHeader>
         <!--1 or more repetitions:-->
         <JournalEntryClearingRequest>
            <MessageHeader>
               <!--Optional:-->
               <ID>SUB_MSG_2019-04-16_01</ID>
               <CreationDateTime>2019-04-10T12:00:00.1234567Z</CreationDateTime>
               <!--Optional:-->
               <TestDataIndicator/>
            </MessageHeader>
            <JournalEntry>
               <CompanyCode>1010</CompanyCode>
               <AccountingDocumentType>AB</AccountingDocumentType>
               <DocumentDate>2019-04-26</DocumentDate>
               <PostingDate>2019-04-26</PostingDate>
               <CurrencyCode>EUR</CurrencyCode>
               <DocumentHeaderText>Test for Clearing</DocumentHeaderText>
               <CreatedByUser>DAVID</CreatedByUser>
               <!--<AccountingDocument>?</AccountingDocument>-->
               <!--<CurrencyTranslationDate>?</CurrencyTranslationDate>-->
               <!--<FiscalPeriod>?</FiscalPeriod>-->
               <!--<ExchangeRate>?</ExchangeRate>-->
               <DocumentHeaderText>Test for Clearing</DocumentHeaderText>
               <!--<ReferenceDocument>?</ReferenceDocument>-->
               <CreatedByUser>DAVID</CreatedByUser>
               <APARItems>
                  <ReferenceDocumentItem>1</ReferenceDocumentItem>
                  <!--<CompanyCode></CompanyCode>-->
                  <AccountType>K</AccountType>
                  <APARAccount>S10300901</APARAccount>
                  <FiscalYear>2019</FiscalYear>
                  <AccountingDocument>1900000959</AccountingDocument>
                  <AccountingDocumentItem>1</AccountingDocumentItem>
               </APARItems>
               <APARItems>
                  <ReferenceDocumentItem>2</ReferenceDocumentItem>
                  <!--<CompanyCode></CompanyCode>-->
                  <AccountType>K</AccountType>
                  <APARAccount>S10300901</APARAccount>
                  <FiscalYear>2019</FiscalYear>
                  <AccountingDocument>1500000241</AccountingDocument>
                  <AccountingDocumentItem>2</AccountingDocumentItem>
               </APARItems>
               <APARItems>
                  <ReferenceDocumentItem>3</ReferenceDocumentItem>
                  <!--<CompanyCode></CompanyCode>-->
                  <AccountType>K</AccountType>
                  <APARAccount>S10300901</APARAccount>
                  <FiscalYear>2019</FiscalYear>
                  <AccountingDocument>1500000243</AccountingDocument>
                  <AccountingDocumentItem>2</AccountingDocumentItem>
               </APARItems>
            </JournalEntry>
         </JournalEntryClearingRequest>
      </sfin:JournalEntryBulkClearingRequest>
   </soapenv:Body>
</soapenv:Envelope>

 

Clear G/L Accounting Documents

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sfin="http://sap.com/xi/SAPSCORE/SFIN">
   <soapenv:Header/>
   <soapenv:Body>
      <sfin:JournalEntryBulkClearingRequest>
         <MessageHeader>
            <!--Optional:-->
            <ID>MSG_2019-04-30_4.9</ID>
            <CreationDateTime>2019-04-12T12:00:00.1234567Z</CreationDateTime>
            <TestDataIndicator>false</TestDataIndicator>
         </MessageHeader>
         <!--1 or more repetitions:-->
         <JournalEntryClearingRequest>
            <MessageHeader>
               <!--Optional:-->
               <ID>SUB_MSG_2019-04-16_01</ID>
               <CreationDateTime>2019-04-10T12:00:00.1234567Z</CreationDateTime>
               <!--Optional:-->
               <TestDataIndicator/>
            </MessageHeader>
            <JournalEntry>
               <CompanyCode>1010</CompanyCode>
               <AccountingDocumentType>AB</AccountingDocumentType>
               <DocumentDate>2019-04-26</DocumentDate>
               <PostingDate>2019-04-26</PostingDate>
               <CurrencyCode>EUR</CurrencyCode>
               <DocumentHeaderText>Test for Clearing</DocumentHeaderText>
               <CreatedByUser>DAVID</CreatedByUser>
               <!--<AccountingDocument>?</AccountingDocument>-->
               <!--<CurrencyTranslationDate>?</CurrencyTranslationDate>-->
               <!--<FiscalPeriod>?</FiscalPeriod>-->
               <!--<ExchangeRate>?</ExchangeRate>-->
               <DocumentHeaderText>Test for Clearing</DocumentHeaderText>
               <!--<ReferenceDocument>?</ReferenceDocument>-->
               <CreatedByUser>DAVID</CreatedByUser>
               <GLItems>
                  <ReferenceDocumentItem>1</ReferenceDocumentItem>
                  <!--<CompanyCode>?</CompanyCode>-->
                  <GLAccount>11001010</GLAccount>
                  <FiscalYear>2019</FiscalYear>
                  <AccountingDocument>100003875</AccountingDocument>
                  <AccountingDocumentItem>1</AccountingDocumentItem>
               </GLItems>
               <GLItems>
                  <ReferenceDocumentItem>2</ReferenceDocumentItem>
                  <!--<CompanyCode>?</CompanyCode>-->
                  <GLAccount>11001010</GLAccount>
                  <FiscalYear>2019</FiscalYear>
                  <AccountingDocument>100003877</AccountingDocument>
                  <AccountingDocumentItem>1</AccountingDocumentItem>
               </GLItems>
            </JournalEntry>
         </JournalEntryClearingRequest>
      </sfin:JournalEntryBulkClearingRequest>
   </soapenv:Body>
</soapenv:Envelope>
Be the first to leave a comment
You must be Logged on to comment or reply to a post.