SAP Community - Cloud Integration

Trading Partner Management in SAP Integration Suite: ANSI X12 EDI Integration

2025-12-18T17:25:35.617000+01:00

Introduction

Trading Partner Management (TPM) in SAP Integration Suite enables enterprises to manage B2B integrations with partners using standards like ANSI X12. It provides a centralized way to define partner profiles, agreements, connectivity, certificates, and mappings, ensuring smooth exchange of EDI documents with SAP backend systems via IDocs.

Step 1: Company Profile

Define your own organization in TPM.
Include identifiers such as DUNS number, GLN, or custom IDs.
This profile represents your company in all agreements.

Step 2: Partner Profile

Create a profile for each trading partner.
Capture identifiers (ISA/GS segments in ANSI X12), contact details, and communication channels.
Profiles standardize partner metadata for reuse across agreements.

Step 3: Agreements

Agreements connect your company profile with a partner profile.
Define:

Transaction sets (ANSI X12 types).
Protocols (AS2, SFTP).
Certificates for encryption/signing.

Agreements govern how messages are exchanged, validated, and acknowledged.

Step 4: Connectivity (AS2 & SFTP)

AS2: Configure partner endpoint, certificates, MDN settings, and encryption/signature algorithms.
SFTP: Define host, port, authentication (password or SSH key), and inbound/outbound directories.
Connectivity ensures secure, reliable transport of EDI files.

Step 5: Certificates

Upload partner public certificates for AS2 encryption/signing.
Maintain your own private/public key pairs.
Monitor expiry dates to avoid disruptions.

Step 6: Mapping

Use Integration Advisor or Cloud Integration to map ANSI X12 transaction sets to SAP IDocs.
Example: X12 810 (Invoice) → INVOIC02 IDoc.
Mapping ensures semantic consistency between external EDI formats and SAP internal structures.

Common ANSI X12 Transaction Sets and SAP IDoc Types

| ANSI X12 Transaction Set | SAP IDoc Type | Functionality |
|--------------------------|---------------|---------------|
| 850 – Purchase Order | ORDERS05 | Customer purchase orders |
| 810 – Invoice | INVOIC02 | Supplier invoice processing |
| 856 – Ship Notice/Manifest | DESADV05 | Shipment and delivery notifications |
| 820 – Payment Order/Remittance Advice | PEXR2002 / REMADV01 | Payment instructions and remittance advice |
| 940 – Warehouse Shipping Order | SHPMNT05 | Warehouse shipment details |
| 945 – Warehouse Shipping Advice | SHPMNT05 | Confirmation of goods shipped |
| 997 – Functional Acknowledgment | CONTRL | Acknowledgment of EDI messages |
| 844 – Product Transfer Account Adjustment | GSVERF01 | Adjustments in product accounts |
| 832 – Price/Sales Catalog | PRICAT01 | Exchange of product price catalogs |
| 830 – Planning Schedule with Release Capability | DELFOR02 | Forecast of deliveries |
| 846 – Inventory Inquiry/Advice | INVRPT01 | Inventory reporting |

Additional Considerations

Message Implementation Guidelines (MIGs): Define partner-specific rules for each transaction set.
Monitoring: Use TPM dashboards to track message flows, acknowledgments, and errors.
Migration: Existing SAP PI/PO EDI scenarios can be migrated to TPM using Integration Advisor.
Compliance: Ensure mappings align with SAP Note 104606 for ANSI X12 compatibility.

Conclusion

By configuring company profiles, partner profiles, agreements, connectivity, certificates, and mappings, enterprises can seamlessly integrate ANSI X12 EDI flows with SAP IDocs in Integration Suite. TPM reduces onboarding complexity, enforces compliance, and accelerates B2B integration projects.

🤖 Tutorial: How to use Gemini AI to Debug SAP CPI Errors Automatically

2025-12-19T18:10:36.062000+01:00

🤖 Tutorial: How to use Gemini AI to Debug SAP CPI Errors Automatically 🤖

Body: Why settle for cryptic stack traces? I recently built a custom Exception Subprocess in SAP Integration Suite that catches failures and asks Google's Gemini AI to explain them in plain English.

Here is the exact step-by-step configuration I used to build the "CPI-GEMINI" flow:

Step 1: The Exception Subprocess Strategy I moved the error handling logic out of the main process into a dedicated Exception Subprocess. This ensures that any failure in the main "Happy Path" immediately triggers this recovery logic.

Step 2: Constructing the AI Prompt (Content Modifier) To talk to the API, we need to format the request perfectly. I used a Content Modifier with two key parts:

Headers: Set Content-Type to application/json and Authorization to your Google API Key.

Body: This is where the magic happens. I wrapped the standard ${exception.message} variable inside the required Gemini JSON schema: {"contents": [{"parts":[{"text": "In cpi iflow following error encounter:${exception.message}"}]}]}.

Step 3: Calling the Model (HTTP Adapter) I used the standard HTTP Receiver adapter to POST the payload to the Gemini 2.5 Flash endpoint.

Address: https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent

Method: POST.

Step 4: Handling the Response (JSON to XML & Filter) The AI response is a large JSON object. To extract just the answer:

JSON to XML Converter: I converted the response and added a custom root element named root.

Filter: I used an XPath expression to drill down to the exact text node: /root/candidates/content/parts/text.

Step 5: Logging the Insight (Groovy Script) Finally, I used a simple Groovy script to grab the filtered AI explanation and attach it to the Message Processing Log (MPL).

Code: messageLog.addAttachmentAsString("Error_Body_Payload", body, "text/plain").

The Result: Instead of just seeing "System Error," the monitoring log now contains an attachment where Gemini explains the likely cause of the failure based on the error context.

https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key={YOUR_API_KEY}

<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="root">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="candidates">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="content">
                <xs:complexType>
                  <xs:sequence>
                    <xs:element name="parts">
                      <xs:complexType>
                        <xs:sequence>
                          <xs:element type="xs:string" name="text"/>
                        </xs:sequence>
                      </xs:complexType>
                    </xs:element>
                    <xs:element type="xs:string" name="role"/>
                  </xs:sequence>
                </xs:complexType>
              </xs:element>
              <xs:element type="xs:string" name="finishReason"/>
              <xs:element type="xs:float" name="avgLogprobs"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element name="usageMetadata">
          <xs:complexType>
            <xs:sequence>
              <xs:element type="xs:byte" name="promptTokenCount"/>
              <xs:element type="xs:short" name="candidatesTokenCount"/>
              <xs:element type="xs:short" name="totalTokenCount"/>
              <xs:element name="promptTokensDetails">
                <xs:complexType>
                  <xs:sequence>
                    <xs:element type="xs:string" name="modality"/>
                    <xs:element type="xs:byte" name="tokenCount"/>
                  </xs:sequence>
                </xs:complexType>
              </xs:element>
              <xs:element name="candidatesTokensDetails">
                <xs:complexType>
                  <xs:sequence>
                    <xs:element type="xs:string" name="modality"/>
                    <xs:element type="xs:short" name="tokenCount"/>
                  </xs:sequence>
                </xs:complexType>
              </xs:element>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element type="xs:string" name="modelVersion"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

import com.sap.gateway.ip.core.customdev.util.Message
import com.sap.it.api.msglog.MessageLogFactory

def Message processData(Message message) {
    // 1. Access the Message Log
    def messageLog = messageLogFactory.getMessageLog(message)
    
    // 2. Get the current Body as a String
    // This captures whatever payload is currently in the flow (Error response or Request)
    def body = message.getBody(String.class)
    
    if (messageLog != null) {
        // 3. Attach it to the Monitoring Log
        // "Error_Body_Payload" is the name of the link that will appear in the Monitor
        if (body != null && !body.isEmpty()) {
            messageLog.addAttachmentAsString("Error_Body_Payload", body, "text/plain")
        } else {
            messageLog.addAttachmentAsString("Error_Body_Payload", "Body was empty.", "text/plain")
        }
    }
    
    return message
}

How to post attachment and body in HTTP in sap cpi

2025-12-23T08:17:09.623000+01:00

Hi Team,

I have requirment where i need to post an attachment along withthe body which is json payload in sap cpi, same case i have exceuted successfully in Bruno using multiform and i got 202 good response and same thing i need to design an interface in sap cpi to get a file from SFTP and post to API along with body section, how i can design this in sap cpi.

Please refer below screenshot from bruno which is successful.

Thanks in advance.

SAP Integration Suite

Create Onboardee using API in ONB 2.0

2025-12-25T20:39:08.561000+01:00

I am working on building a CPI interface which will take some values like FN, LN, Position ID, Email.....,,, but, I do not have Person ID or Requesition ID (application id).

I followed few SAP help notes and previous posts, unfortunately not able to derive proper methodology. I understand at the high level that I will have to create Person ID, which I did then I need to use API to createOnboardee which I think is a HTTP (link to a receiver) but how do i define it's body, also steps followed by this stage.

Thanks,

Ali

Replication in SAP S4HANA Public Cloud

2025-12-30T14:41:22.885000+01:00

Hello Experts,

I am trying to retrigger the replication for some interface [initializations ] in order to resend all the records using the “Replicate by Replication Model” option.

Since the number of records is very large, I selected the Background Mode checkbox to avoid a dump. However, nothing appears in the message dashboard after triggering it.

PS: I have already tried triggering it several times, and the communication arrangements are properly set up and active.

Could you please help me resolve this issue?

Kind regards

Safa

SAP CI integration with Cloud ALM monitoring

2026-01-01T01:22:24.624000+01:00

Hi Experts,

we will be using SAP Cloud ALM in the future (as successor for Solution Manager), among other tasks also for system and interface monitoring. Could Please guide about approach to integrate Integration Suite with Cloud ALM in order to monitor Integration Suite using Cloud ALM,including the main technical steps needed. How would you plan the implementation, which stakeholders would you involve and which challenges do you see? Please also give an outlook for additional ideas which you see as worthwhile for improving Integration Suite monitoring and operations.

Regards,

Ramu.

Getting 403 error while trying to download the deployed iflow using REST API

2026-01-13T15:26:05.602000+01:00

Hello Experts,

I am trying to download the deployed artifact using below url through browser and i can able to download a zip file.

Trying the same from postman with oauth giving me 403 - Forbidden error. I understand it lacks a permission as this is the same oauth used for accessing MessageProcessingLogs which is working.

can someone help how do i achieve this so that i can replicate the same in python for internal work.

https://xxx.hana.ondemand.com/api/v1/IntegrationPackages('Testcicd')/$value

OAuth with NodeManager.read and IntegrationOperationServer.read permission

Trading Partner Management: Indentification problems

2026-01-15T09:04:19.852000+01:00

Hello Colleagues,

I'm exploring the first time with SAP Integration Advisor - TPM configuration and I'm struggling to make the aggremment generate a correct trading partner ID reflect the reallity, after active the agreement, look the configuration below:

I'm testing the SOAP cenario Inbound in SAP CPI and I created the soap envelop with flat-file of ODETTE EDIFACT A96 S3 ORDERS:

Manually created SOAPEnvelop with FLAT FILE CDATA:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
    <soapenv:Header/>
    <soapenv:Body>
        <n0:PurchaseOrderERPRequest_In>
            <MessageHeader>
                <ID>MSG_ODETTE_2026_999</ID>
                <CreationDateTime>2026-01-14T12:00:00Z</CreationDateTime>
                <SenderParty>
                    <InternalID schemeID="N/A" schemeAgencyID="ZZ" schemeAgencyName="ODETTE_EDIFACT">EXT.EDI</InternalID>
                </SenderParty>
                <RecipientParty>
                    <InternalID schemeID="N/A" schemeAgencyID="" schemeAgencyName="SAP">SAP</InternalID>
                </RecipientParty>
                <BusinessScope>
                    <TypeCode>PROCESS_ID</TypeCode>
                    <InstanceID>ODETTE_D96A_S3</InstanceID>
                </BusinessScope>
            </MessageHeader>
            <PurchaseOrder>
                <Payload>
                    <![CDATA[UNA:+.? '
UNB+UNOA:2+EXT.EDI:ZZ+SAP+260114:1830+REF12345'
UNH+1+ORDERS:D:96A:UN:S3'
BGM+220+PO999888777+9'
DTM+137:20260114:102'
PAI+:::42'
FTX+ZZZ+1++INSTRUCTIONS'
RFF+ON:4500001234'
NAD+BY+ID007::92'
NAD+SU+I008::92'
CUX+1:EUR:9'
LIN+1++PART-12345:IN'
QTY+21:1000:PCE'
DTM+2:202602011000:203'
UNS+S'
UNT+15+1'
UNZ+1+REF12345']]>
                </Payload>
            </PurchaseOrder>
        </n0:PurchaseOrderERPRequest_In>
    </soapenv:Body>
</soapenv:Envelope>

Header: UNB+UNOA:2+EXT.EDI:ZZ+SAP+260114:1830+REF12345'

Company Dummy:

I already setup the system and communication channel.

The indentifiers from the company

Indentifiers from the partner:

Created the agreement and active the agreement:

Agrement with MIG Sender, MAG and MIG Receiver:

The receiver channel in SAP basicalling I'm sending the result of the mapping in another endpoint in SAP CPI.

Agreement unic ID from trading partner:

SOAP-ODETTE_EDIFACT--D.96A S3-EXT.EDI-ZZ----EXT.EDI-ZZ----ORDERS - Wrong, it's always failed in the 2 Iflow Stantard

Error:

javax.script.ScriptException: java.lang.Exception: java.lang.IllegalStateException: Partner ID SAP_TPM_467257935cff5475cbc45359b4ba5bc7 is not available.

It's like opositive way but I can't find the reason.

Partner Directory Lookup Keys:

SOAP-ODETTE_EDIFACT--D.96A S3-EXT.EDI-ZZ----SAP-----ORDERS

Agremment Plan ID:

SOAP-ODETTE_EDIFACT--D.96A S3-EXT.EDI-ZZ----EXT.EDI-ZZ----ORDERS

Someone could provide me support ?

Regards,

Viana

SAP CPI: Can we use a JAR which has classes expecting input parameters as file path

2026-01-16T11:20:24.032000+01:00

Hi,

In CPI, we have a requirement to add a JAR file.

Classes inside jar are making API calls , fetching some key pairs and storing those in a local directory when used on local system.

Can this jar be used somehow in cloud integration somehow?

Thanks & Regards,

Mayank

SuccessFactors Custom Portlet Notifications via CPI to Microsoft Teams

2026-01-23T12:12:32.954000+01:00

Detailed Problem Description / Question

I’m looking for guidance (or an SAP KBA reference) around sending notifications from SAP SuccessFactors to Microsoft Teams via SAP CPI, specifically when the source is a custom portlet.

In our scenario, we have a custom portlet in SuccessFactors that displays an alert or status message on the SuccessFactors home page. Unlike standard SuccessFactors Teams notifications, this custom portlet does not automatically trigger a Teams notification.

The requirement is as follows:

A notification or alert occurs in a custom SuccessFactors portlet
This event should be picked up by SAP CPI
CPI should then send a notification to a Microsoft Teams channel (webhook)

At this stage, we understand that:

SuccessFactors does not natively generate MS Teams notifications for custom portlets
Any notification would likely require custom integration logic (e.g. OData, Integration Center extract, or custom API trigger)
CPI would be responsible for transforming the message and forwarding it to Microsoft Teams

My questions are:

Is there an official SAP KBA or documentation that confirms custom portlets do not support native notifications?
Are there recommended or supported approaches for enabling CPI to detect an event or change from a custom portlet?
Has anyone successfully implemented a CPI → Microsoft Teams notification for a custom SuccessFactors object or portlet, and if so, what approach was used?

Best Regards

Adele Beets

Looking for Expert and Community Insights on My SAP Technical Journey

2026-01-23T15:59:27.074000+01:00

Hello everyone,

I hope you are all doing well.

I would like to kindly ask for your feedback and professional insights regarding my current learning journey within the SAP Technical domain. My goal is to continuously improve my technical profile and ensure that my learning path aligns well with real-world SAP projects and current market expectations.

Below is a brief overview of my learning direction and the reasoning behind each focus area.

SAP Technical Learning Direction At this stage, my primary focus is on pursuing the SAP Technical track. I am currently concentrating on SAP Basis, aiming to build a strong and solid foundation in SAP system administration, core architecture, and operational concepts.
In parallel, I am expanding my knowledge across several complementary technical areas, as outlined below:

SAP HANA
My objective is to gain a clear and comprehensive understanding of SAP HANA database architecture and how SAP systems interact with the database layer in terms of structure, performance optimization, and system integration.

SAP ABAP
I am working on building a solid understanding of the ABAP stack, with a focus on how development processes are designed and implemented within SAP systems. This helps me better understand system logic, debugging, and collaboration with development teams from a technical perspective.

SAP CPI (Cloud Integration)
My focus includes understanding SAP’s transition from traditional on-premise environments to cloud-based platforms, along with cloud integration concepts such as internal (A2A) and external (B2B) integration scenarios.

Additionally, I have complemented this learning path with the Apache Camel Framework, due to its importance and relevance within SAP integration solutions.

SAP UI5 / Fiori & SAP BTP CAPM
Recently, SAP introduced important updates related to both frontend and backend development models. I have been exploring these updates and following commonly recommended learning resources to better understand the modern SAP development approach, including CAP-based application development.

Learning Approach
Overall, I am intentionally following a structured and methodical learning sequence to build a holistic understanding of SAP Architecture as an integrated enterprise platform, rather than focusing on individual tools or isolated technologies.

Current Learning Path & Courses
Below are the main courses I am currently following (via Udemy):

SAP NetWeaver Fundamentals

SAP Basis Administration

SAP HANA Administration

Apache Camel Framework with Spring Boot

SAP Cloud Integration (CI / CPI), including API Management and Event Mesh

SAP UI5 / Fiori Full Stack with TypeScript / JavaScript using SAP BTP RAPM / CAPM

I would truly appreciate your feedback on whether this learning path is well-structured and aligned with real-world SAP implementations, and whether there are any key areas you would recommend adding, adjusting, or prioritizing differently.

Thank you in advance for your time and valuable insights.

Best regards,

Is there any purchasing units import API in SAP Ariba

2026-01-26T09:05:20.080000+01:00

I want to import purchasing units data from third-party system to Ariba system. I know that we can use import purchasing units task to import csv file to Ariba through ITK, But i think ITK have some disadvantage. I want to implement this business scenario through an API call. Do you have some best practices ?

SAP CPI - RFC Receiver interface does not works with BAPI_TRANSACTION_COMMIT

2026-01-28T17:21:13.592000+01:00

Hello All,

I am working on an RFC receiver interface in SAP Cloud Integration where I am calling BAPI in SAP to create Orders. And I need to use the BAPIs "BAPI_TRANSACTION_COMMIT" to commit the transaction for creation of Orders in SAP or "BAPI_TRANSACTION_ROLLBACK" to rollback in case of errors.
But even though I receive successful response during the BAPI call for Order creation, it seems like the COMMIT does not works. I searched on internet and I understood that this is most likely because of the two BAPI(creation and commit) calls are being made in different sessions. I need a little help to understand the possible options with RFC receiver adapter to handle this situation.
To add more about the scenario, the input to SAP CI might result in more than one different Orders and I need to COMMIT only after all these Orders are successful.
I have observed that the "Send Confirm Transaction" option in RFC adapter works, but it is committing individual Order creation, whereas I need to commit only after all Orders are successfully created otherwise "BAPI_TRANSACTION_ROLLBACK" should be triggered.
Any help will be appreciated. Thanks!

Regards,
Faisal

Need a help in CPI Mapping

2026-01-29T16:37:37.479000+01:00

Hello Experts,

Need a help in achieving the below as values are coming as expected a step before the final field(Target) currently being Suppressed.

if E1EDK14/QUALF is 015 and E1EDK14/ORGID for values (ZS1, ZS10, ZS2, ZS6, ZS7, ZS8) then Prefix Minus Symbol (-) before E1EDS01/SUMME value
for E1EDS01/SUMID equals 010, 011 and 005 or else E1EDS01/SUMME.

Disabling a pallete

2026-02-02T14:12:18.581000+01:00

Is there a way to actually disable a pallet while using SAP Cloud Integration ? I am new to SAP and have tried to search for this but haven't found anything thar leads me in this direction.

Above is a very simple example of my use case. I want that at a time I could either use the groovy script or the HTTP call.
I know I could use Router in productive scenarios. This is just for testing purpose.

Interface is in ABANDONED status

2026-02-03T10:02:32.550000+01:00

Dear All,

There is a Interface in NEO tenant and the Same interface runs everyday day - every hour. We have noticed that the Interface is in ABANDONED status 3 to 4 times in a day due to:

Error Details

Message processing was abandoned because of inactivity timeout of 24 hours

Please help us to identify the issue and its resolution.

Kindly let us know for any additional information and clarification?

Thanks in advance,

Yashodeep

Pricing Integration using BAdI

2026-02-05T00:27:10.418000+01:00

Hi Team,

A pricing engine company would like to integrate their system to SAP S/4HANA Cloud Private Edition and they would like to have their system integration to adhere to clean core principles of SAP for certification.

Originally it was setup for ECC which later converted to S/4HANA On Prem by using PRCD_ELEMENTS table manipulation to update the pricing in Sales Order but realize that this is not clean core compliant.

Due to time limitation, they are not able to create a new integration from scratch using SAP Cloud API and planning to use BAdI SD_SLS_MODIFY_ITEM to update the pricing conditions in sales orders.

So the question would be, is this possible? And if it is, will this be clean core compliant?

Thank you.

Third party integration document posting limitation

2026-02-07T09:51:24.965000+01:00

Dear All,

We are in public cloud environment, using a point of sale system thirdparty, middleware of custom build,

Purpose of middleware, all my point of sale system invoices will flow to middleware, from middleware we developed API and posting all the sale entiers, Customer, Sale order, Batch, Serial, PGI, Delivery, Invoice happened through scheduling, Payment thorugh API.

At present in a day we can only post 1300 documents, more than that for example, currently on week end we got 3000 invoices which it take 2 days to complete the posting. we need the best solution to hanlde it , if we want to manage up to 7000 documents.

I am not able to open any of my iflows created in Integration suite and it gives me an error

2026-02-09T20:06:03.105000+01:00

hello experts,

I am not able to open any of my iflows and it gives me an error " The Content given is not a valid Integration Flow Bundle content" . I can see there is a note - 2691717 which mentions there might not be enough space in the tenant node and that one case has to be raised in component BC-CP-IS-OPS. Can someone guide me how to do this?

Italy SDI B2G invoice send failing – cert status error 0010 (S4/CPI)

2026-02-12T13:29:20.850000+01:00

Hi team,

We have an issue. When we send invoices to Italy SDI (Italy Send Invoice) for B2G through S4/CPI, we receive the following error message "Invalid Certificate Status" error code 0010. However, all certificates are valid according to CPI Monitoring. Receiving invoices is still working.

Can anyone please help with this? How can we fix this issue?