Enterprise Resource Planning Blogs by SAP
Get insights and updates about cloud ERP and RISE with SAP, SAP S/4HANA and SAP S/4HANA Cloud, and more enterprise management capabilities with SAP blog posts.
cancel
Turn on suggestions
Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type.
Showing results for 
Search instead for 
Did you mean: 

Guidelines for Journal Entry by Ledger - Post (Asynchronous)

Wesley
Participant
‎02-03-2021 10:57 AM
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>
Popular Blog Posts