Now accepting guest editorial from SAP, Oracle, Workday and ServiceNow practitioners.Pitch a guide
The Sign-Off Table

Lesson 5 of 6

B2B monitoring and operations

10 min

Listen to this lesson

0:00 / 16:20

A partner is only live when someone can see its traffic, explain a failure and fix it without a developer. Integration Suite gives B2B scenarios their own monitor on top of the normal message processing log, and it is the screen Contoso's support desk will live in after the move.

The B2B monitor

Go to Monitor > B2B Scenarios. Two tiles open, both showing the last 24 hours by default: Interchanges, for interchanges that were assigned to a partner or transaction, and Unassigned Interchanges, for interchanges where an error during metadata extraction meant no business document could be attached. Interchanges are kept for 90 days.

In the Interchanges list you filter by status, processing status, creation time, error category, sender, receiver, direction, relation type and custom search attributes. Selecting an interchange shows its header (status, processing status, and where they apply the sender technical acknowledgment status, sender functional acknowledgment status and receiver functional acknowledgment status), its general data including the agreement and Usage Indicator (Test or Production), the sender and receiver AS2 message IDs, an events section and the payloads.

  1. Event 1Sender Interchange ReceivedStep 1 accepted the file from the partner.
  2. Event 2Technical Acknowledgment SentThe AS2 MDN went back for the received sender interchange.
  3. Event 3Sender Interchange MappedStep 2 validated and mapped the message.
  4. Event 4Receiver Interchange AssembledThe outgoing structure, such as an ORDERS05 IDoc, was built.
  5. Event 5Receiver Interchange SentStep 3 delivered it to the receiver.
The events the B2B monitor records for a healthy inbound interchange; each links to the message processing log of the flow involved.
The Sign-Off Table · thesignofftable.com/academy/sap-edi-301

Each event has a Monitoring Reference link that opens the message processing log of that integration flow run, so you can move from business view to technical detail in one click. Failed interchanges also show an Error Information section and a Check Agreements button.

Statuses and error categories

Interchange statuses are Failed, Retry, Processing, Completed, Waiting for Acknowledgment, Acknowledgment Overdue and Canceled. Failed and unassigned interchanges carry an error category: Initial Decryption Failed, Signature Validation Failed, Agreement Configuration Access Failed, Interchange Validation Failed, Interchange Mapping Failed, Interchange Transmission Failed, Acknowledgment Overdue, or Unspecified Error. The category is the first clue in any triage.

A simplified view of interchange statuses in the B2B monitor and the operator actions that move them; exact transitions depend on the scenario.
The Sign-Off Table · thesignofftable.com/academy/sap-edi-301
Error categoryTypical causeFirst check
Initial Decryption FailedWrong private key alias, or company inbound decryption configuration not activatedCompany profile security and the manually activated decryption configuration
Signature Validation FailedPartner signed with a new or unknown certificatePartner profile certificates and signature verification settings
Agreement Configuration Access FailedEnvelope IDs or message version don't match an active agreementIdentifiers, type system version, Copy PID versus runtime values
Interchange Validation FailedMessage breaks the MIG: missing mandatory segment, bad code valueThe 997 or CONTRL errors and the partner's MIG
Interchange Mapping FailedMapping can't handle the contentThe MAG and the payload
Interchange Transmission FailedReceiver unreachable or rejected the messageReceiver channel, Cloud Connector, target system

First-line triage by error category.

Restart, retry, duplicate and cancel

Select interchanges and open Actions. Restart works on Failed interchanges and resets the sender payload to Step 1b, so mapping runs again: use it after you correct a mapping or agreement. Retry also works on Failed interchanges but resets the receiver payload to Step 3, bypassing mapping: use it when the receiver was down. Duplicate and Retry works only on Completed interchanges and processes a copy as a new interchange while the original keeps its status. Each action asks for a reason, can't be reversed and keeps the original interchange ID with new events appended. These actions need generic flow version 2.3.7 or later and a BTP destination named B2BTPM_Reprocess_Endpoint. Cancel is permanent and is available for Failed, Retry, Processing, Waiting for Acknowledgment and Acknowledgment Overdue interchanges.

  1. Did the interchange fail before or during mapping?Yes → fix the agreement or MAG, then Restart · No → next question
  2. Did it fail sending to the receiver, for example CMQ was down?Yes → fix the connection, then Retry · No → next question
  3. Did it complete, but the receiver lost the result?Yes → Duplicate and Retry, after confirming no duplicate document will be created · No → next question
  4. Should it never be processed, such as a partner test file sent to production?Yes → Cancel with a reason · No → escalate to the integration team
Choosing the right operator action for a problem interchange.
The Sign-Off Table · thesignofftable.com/academy/sap-edi-301

Alerts in SAP Cloud ALM and the operations hand-off

TPM can publish interchange data to SAP Cloud ALM for statistics and alerting by partner or message type. SAP notes that after enabling data collection it can take up to 12 hours before publishing starts, the first publication covers only the latest hour, and each new interchange takes about 5 minutes to sync. To show business document numbers in Cloud ALM, define a custom search attribute named Document ID in the Configuration Manager and assign it to the agreement activity; for the IDoc receiver adapter SAP suggests the source type Parameter with the value SAP_TPM_IDocNumber.

Contoso's hand-off from Theo's team to the support desk is a short runbook per partner: the agreement name, the partner contacts, the expected daily volume, the cut-off times, how to tell a test interchange from a production one, the error-category table above, and who may cancel. The support desk gets the business expert role in production; developers keep design rights only in the development tenant (CMC_DEV).

What would you do?

On Monday morning the support desk sees 14 Great Lakes 850s in status Failed with category Interchange Transmission Failed. Sam confirms CMP had a 40-minute outage overnight, now fixed. What should the desk do?

Key points
  • Monitor > B2B Scenarios has Interchanges and Unassigned Interchanges tiles, 24-hour default view, 90-day retention.
  • Error categories point to the first check: decryption, signature, agreement lookup, validation, mapping or transmission.
  • Restart reruns mapping from Step 1b; Retry resends from Step 3; Duplicate and Retry copies a completed interchange; Cancel is permanent.
  • Publish interchange data to SAP Cloud ALM for alerting, and hand over with a per-partner runbook.

Check your understanding · not graded

Lesson check

  1. 1. An interchange failed because the MAG had a wrong qualifier mapping. After fixing the MAG, which action reprocesses it correctly?

  2. 2. What does the Unassigned Interchanges tile show?

  3. 3. Which prerequisite must exist before Restart, Retry and Duplicate and Retry work?

  4. 4. How long are interchanges retained in the B2B monitor?