Introduction

Imagine a EDI Landscape where you exchange B2B messages across various Partners. In some cases, you are the Customer and in some cases you are the Supplier. Imagine wanting to know,

  • What messages you exchange with a CustomerX
  • What are the formats of your messages to/from ERP
  • What are the Partners involved in your OrderToCash Business Process Cycle and so on.

As you have seen in your TPM Journey there are multiple objects created in your TPM. A few critical components are

  • Trading Partners
  • Message Implementation Guidelines – MIGs
  • Agreement Template
  • Agreements

It is essential that you name these objects right. When your EDI Landscape grows with 100s and 1000s of Trading Partners, your naming convention will provide answers to the above questions. This post provides you with a high level Naming Conventions Guidelines for your TPM on Integration Suite. We look at usage of these Guidelines with some practical examples.

TPM Naming Convention Cheat Sheet

ObjectNaming ConventionExample
Message Implementation Guideline MIGBusinessProcess PartnerName/OwnSystem TypeSystem MessageType Version DirectionOrderToCash Customer1 UN/EDIFACT ORDERS D96A Sender
Agreement TemplateBusinessProcessOrderToCash
Agreement Template Transactions##) BusinessProcess – Direction – MessageExchange01) OrderToCash – Inbound – Create Sales Order
AgreementsBusinessProcess – PartnerNameOrderToCash – CUSTOMER1
TPM Naming Convention Cheat Sheet

Business Process

The first step of your TPM Naming Convention is to identify the Business Process for your EDI Integrations and the respective Transactions. SAP on api.sap.com provides a list of standard SAP Business Processes. That could be your starting point to identify what Business Process your EDI Integrations are going to be built in. In our case in this post, we look at below Business Process (subset of the SAP Processes ) for a fictious Company – SELF_COMPANY

  • Order To Cash
  • Procure To Pay
  • Forecast To Plan
  • Demand To Delivery

If you have worked on typical EDI Integrations, this is not a comprehensive list, there are much more with 3PL, Warehouse Management Systems and other EDI Integrations but it is essential to identify the Business Processes for your Company.

Transactions / Message Exchanges in your Business Process

For the Business Processes identified in previous section, identify the list of Transactions / Messages you will exchange. Also identify direction with respect to your Company – COMPANY_SELF See below table ( Note this is just a example and not a comprehensive list)

Business ProcessTransactions / Message ExchangeDirection
Order To CashCreate Sales OrderInbound
Order To CashOrder ConfirmationOutbound
Order To CashDelivery Notification – ASNOutbound
Order To CashInvoiceOutbound
Forecast To PlanCreate Delivery Forecast – DELFORInbound
Forecast To PlanSend ASNOutbound
Forecast To PlanProcess Self Billing InvoiceInbound
Demand To DeliverProcess Delivery Forecast – DELJITInbound
Demand To DeliverSend ASNOutbound
Demand To DeliverProcess Self Billing InvoiceInbound
Message Exchanges for your Business Process – An Example

Message Implementation Guideline – MIG – BusinessProcess PartnerName/OwnSystem TypeSystem MessageType Version Direction

As you would have realised in your EDI Journey using TPM, MIGs are the first object you create. A MIG typically contains the below details

  • Message Type
  • Type System
  • Type System Version
  • Direction

Examples,

  • OrderToCash Customer1 UN/EDIFACT ORDERS D96A Sender
  • OrderToCash Customer2 UN/EDIFACT ORDERS D96B Sender
  • OrderToCash Customer3  ASC X12 850 4010 Sender
  • OrderToCash ERP S/4HANA ORDERS.ORDERS05 Receiver
  • OrderToCash Customer1 UN/EDIFACT DESADV D97A Receiver
  • OrderToCash Customer2 UN/EDIFACT DESADV D96A Receiver
  • OrderToCash ERP S/4HANA DESADV.DELVRY03 Sender
  • OrderToCash Customer1 UN/EDIFACT INVOIC D97A Receiver
  • OrderToCash Customer2 UN/EDIFACT INVOIC D96A Receiver
  • OrderToCash ERP S/4HANA INVOIC.INVOC02 Sender
  • ForecastToPlan Customer4 UN/EDIFACT DELFOR D96B Sender
  • ForecastToPlan ERP S/4HANA DELFOR.DELFOR01
  • ForecastToPlan Customer4 UN/EDIFACT DESADV D97A Receiver
  • ForecastToPlan Customer5 UN/EDIFACT DESADV D96A Receiver
  • ForecastToPlan ERP S/4HANA DESADV.DELVRY05 Sender
  • DemandToDelivery Customer4 UN/EDIFACT DELJIT D96B Sender
  • DemandToDelivery ERP S/4HANA DELJIT.DELFOR02 Receiver
  • DemandToDelivery ERP S/4HANA DESADV.DESADV03 Sender
MIGs example with Naming Convention

Agreement Templates

Agreement Template: BusinessProcess

Examples,

  • OrderToCash
  • ProcureToPay
  • ForecastToPlan
  • DemandToDeliver
Agreement Template

Agreement Template Business Transaction: ##) BusinessProcess – Direction – MessageExchange

Examples,

  • 01) OrderToCash – Inbound – Create Sales Order
  • 02) OrderToCash – Outbound – Order Confirmation
  • 03) OrderToCash – Outbound- Delivery Notification ASN
  • 04) OrderToCash – Outbound – Invoice
  • 01) ForecastToPlan – Inbound – Create Delivery Forecast – DELFOR
  • 02) ForecastToPlan – Outbound – Send ASN
  • 03) ForecastToPlan – Inbound – Process Self Billing Invoice
Agreement Template Business Transaction Examples for Naming Convention

Agreements:BusinessProcess – PartnerName

  • OrderToCash – CUSTOMER2
  • ProcureToPay – SUPPLIER1
  • ForecastToPlan – Customer 4
  • OrderToCash – CUSTOMER1
Agreements Naming Convention Example
Agreements Naming Convention Example

How Does This Help?

Search MIGs used by a Partner

Simply search with Partner Name ( Example: CUSTOMER2) in MIGs

If you want to find MIGs used by a partner, simply search by Partner Name

Search MIGs by Message Type

Simply search with Message TypeName ( Example: DESADV) in MIGs

Search MIGs by Message Type

Search MIGs by Own System

Simply search with Own System Name ( Example: ERP) in MIGs

Search MIGs by Own System

Search TPM Agreements By Partner

Search TPM Agreements by Partner : CUSTOMER1

Search TPM Agreements By Partner

Final Thoughts

A landscape where you have 100s of Partners using TPM, can become very difficult to manage if you do not follow naming conventions right at the beginning of your project. Following these ( or adapted version of these conventions) can make your EDI Integration using TPM a easy journey.

This is in no way a 100% TPM Naming Convention guide. There are more objects for which you can define naming conventions , Parameters, Custom Search Attributes and so on. But those are not as critical in the scheme of things and depend on the context in which they are being used.

Additional Blog Posts from this Series