Skip to Content
Technical Articles
Author's profile photo Wesley Yin

Guidelines for Journal Entry by Ledger – Post (Asynchronous)

In this blog post you will learn some constraints, help information about Journal Entry by Ledger – Post (Asynchronous)

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

1. Usage

Journal Entry by Ledger – Post (Asynchronous) is delivered in CE2102, which provides asynchronous SOAP API that enable remote systems to post journal entries on specific ledger in SAP S/4HANA Cloud asynchronously.

Response message can be checked in Application Interface Framework (AIF) monitor on SAP S/4 HANA system or sent to receiver system if receiver system is provided in communication system and XML request.

This service contains importing parameter tables for:

  • JournalEntry
  • Items

To learn more about the information of importing parameters at SAP Help Journal Entry by Ledger – Post (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

Besides, we also provide Outbound API Journal Entry – Create (Asynchronous) Confirmation , which is the outbound service of API Journal Entry – Post (Asynchronous) as well as Journal Entry by Ledger – Post (Asynchronous). By means of this outbound service, the execution result can be sent to the sender system proactively.

Regarding how to enable outbound API in communication arrangement and how to fill in data request, please refer Guidelines for Enabling Outbound API Journal Entry – Change Confirmation (Asynchronous). This Guideline mainly introduce the procedure to use Outbound API Journal Entry – Change Confirmation (Asynchronous), which are the same as Outbound API Journal Entry – Create Confirmation (Asynchronous).

As the outbound API is used by both Journal Entry – Post (Asynchronous) API and Journal Entry by Ledger – Post (Asynchronous) API, you can tell which is the source API by the attribute <ConfirmationInterfaceOrignName>  in outbound API XML request.

 

5. Constraints and Consulting Questions

5.1    Constraints

Journal Entry by Ledger – Post (Asynchronous) API has the following limitations:

  • Only support G/L items
  • Not support tax items, AR/AP items
  • Not support reversal

6.Appendix

  1. SAP Help Page

Journal Entry by Ledger – Post (Asynchronous)

  1. SAP API Business Hub

Journal Entry by Ledger – Post (Asynchronous)

  1. Example Payload
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sfin="http://sap.com/xi/SAPSCORE/SFIN">
   <soapenv:Header/>
   <soapenv:Body>
      <sfin:JournalEntryBulkLedgerCreateRequest>
         <MessageHeader>
            <!--Optional:-->
            <ID schemeID="?" schemeAgencyID="?">0L-BKPFF-WBS</ID>
            <CreationDateTime>2018-07-18T12:00:00.1234567Z</CreationDateTime>
            <TestDataIndicator>false</TestDataIndicator>
            <SenderBusinessSystemID>SHGMA04_LEDGER</SenderBusinessSystemID>
         </MessageHeader>
         <!--1 or more repetitions:-->
         <JournalEntryCreateRequest>
            <MessageHeader>
               <!--Optional:-->
               <ID>SUB_MSG_1</ID>
               <CreationDateTime>2018-07-18T12:00:00.1234567Z</CreationDateTime>
            </MessageHeader>
            <JournalEntry>
               <OriginalReferenceDocumentType>BKPFF</OriginalReferenceDocumentType>
               <!--Optional:-->
               <OriginalReferenceDocument>Ord123</OriginalReferenceDocument>
               <!--Optional:-->
               <OriginalReferenceDocumentLogicalSystem>ER9</OriginalReferenceDocumentLogicalSystem>
               <BusinessTransactionType>RFBU</BusinessTransactionType>
               <AccountingDocumentType>SA</AccountingDocumentType>
               <LedgerGroup>0L</LedgerGroup>
               <!--Optional:-->
               <DocumentReferenceID>Ref123</DocumentReferenceID>
               <!--Optional:-->
               <DocumentHeaderText>Ledger Posting</DocumentHeaderText>
               <CreatedByUser>YINWES</CreatedByUser>
               <CompanyCode>1010</CompanyCode>
               <DocumentDate>2020-10-04</DocumentDate>
               <PostingDate>2020-10-04</PostingDate>
               <!--Zero or more repetitions:-->
               <Item>
                  <GLAccount listID="?">11001000</GLAccount>
                  <AmountInTransactionCurrency currencyCode="CNY">-100</AmountInTransactionCurrency>
                  <!--Optional:-->
                  <AmountInCompanyCodeCurrency currencyCode="EUR">-1000</AmountInCompanyCodeCurrency>
                  <!--Optional:-->
                  <AmountInGroupCurrency currencyCode="USD">-10000</AmountInGroupCurrency>
                  <!--Optional:-->
                  <DebitCreditCode>H</DebitCreditCode>
                  <!--Optional:-->
                  <DocumentItemText>BS Item</DocumentItemText>
                  <!--Optional:-->
                  <AssignmentReference>BS Assignment</AssignmentReference>
                  <!--Optional:-->
                  <FinancialTransactionType>900</FinancialTransactionType>
                  <!--Optional:-->
                  <TradingPartner>1710</TradingPartner>
                  <!--Optional:-->
                  <ValueDate>2020-11-04</ValueDate>
                  <!--Optional:-->
                  <HouseBank>DEBK1</HouseBank>
                  <!--Optional:-->
                  <HouseBankAccount>USDAC</HouseBankAccount>
               </Item>
               <Item>
                  <GLAccount listID="?">63009000</GLAccount>
                  <AmountInTransactionCurrency currencyCode="CNY">100</AmountInTransactionCurrency>
                  <!--Optional:-->
                  <AmountInCompanyCodeCurrency currencyCode="EUR">1000</AmountInCompanyCodeCurrency>
                  <!--Optional:-->
                  <AmountInGroupCurrency currencyCode="USD">10000</AmountInGroupCurrency>
                  <!--Optional:-->
                  <DebitCreditCode>S</DebitCreditCode>
                  <!--Optional:-->
                  <DocumentItemText>Expense Item</DocumentItemText>
                  <!--Optional:-->
                  <AssignmentReference>Expense Assignment</AssignmentReference>
                  <!--Optional:-->
                  <FinancialTransactionType>900</FinancialTransactionType>
                  <!--Optional:-->
                  <TradingPartner>1710</TradingPartner>
                  <!--Optional:-->
                  <ValueDate>2020-11-04</ValueDate>
                  <!--Optional:-->
                  <HouseBank>DEBK2</HouseBank>
                  <!--Optional:-->
                  <HouseBankAccount>DEAC2</HouseBankAccount>
                  <!--Optional:-->
                  <AccountAssignment>
                     <ProfitCenter>YB101</ProfitCenter>
                     <!--Optional:-->
                     <PartnerProfitCenter>YB102</PartnerProfitCenter>
                     <!--Optional:-->
                     <Segment>1000_B</Segment>
                     <!--Optional:-->
                     <PartnerSegment>1000_C</PartnerSegment>
                     <!--Optional:-->
                     <CostCenter>10101101</CostCenter>
                     <!--Optional:-->
                     <WBSElement>A/BILLING/V2-1</WBSElement>
                     <!--Optional:-->
                     <SalesOrder>11</SalesOrder>
                     <!--Optional:-->
                     <SalesOrderItem>10</SalesOrderItem>
                     <!--Optional:-->
                     <FunctionalArea>YB30</FunctionalArea>
                  </AccountAssignment>
                  <AdditionalAttributes>
                     <!--Optional:-->
                     <PersonnelNumber>50002554</PersonnelNumber>
                  </AdditionalAttributes>
               </Item>
            </JournalEntry>
         </JournalEntryCreateRequest>
      </sfin:JournalEntryBulkLedgerCreateRequest>
   </soapenv:Body>
</soapenv:Envelope>

Assigned tags

      Be the first to leave a comment
      You must be Logged on to comment or reply to a post.