SAP BTP Master Data Integration

Table of Contents

• Quick Reference
• Core Concepts
• Decision Trees
• Setup Workflow
• System Limitations
• Client Configuration
• SOAP Endpoints
• Common Integration Scenarios
• Security Best Practices
• Troubleshooting
• Bundled Resources

Quick Reference

What MDI Does

• Replicates master data between connected applications
• Supports 34 master data types via SAP One Domain Model
• Provides filtering to control data distribution scope
• Enables extensibility with custom fields

What MDI Does NOT Do

• Consolidation (use SAP Master Data Governance)
• Data quality control
• Central governance workflows
• Referential integrity validation

Core Concepts

Key Terms

Integration Models (SAP One Domain Model)

references/integration-models.md

Decision Trees

Which Service Plan?

Is application SAP-branded cloud?
├─ Yes → sap-integration plan (FREE)
└─ No → Is it SAP S/4HANA On-Premise?
         ├─ Yes → s4hana-onpremise plan (PAID - storage + bandwidth)
         └─ No → Use SAP Integration Suite with MDI Adapter

Which Authentication Method?

Mutual-TLS with X.509 certificates available?
├─ Yes → Use mTLS (RECOMMENDED)
│        credential-type: x509
│        Configure validity: DAYS/MONTHS/YEARS
└─ No → Use Client Credentials Grant (DEFAULT)
         Uses client_id/client_secret pairs

REST vs SOAP API?

Master data type is Business Partner?
├─ Yes → SOAP API available for:
│        - Business Partner replication
│        - BP Relationship replication
│        - Key Mapping replication
│        - Confirmations
└─ No → REST API (Events API, Requests API, KeyMapping API)

Setup Workflow

1. Prerequisites

• SAP BTP global enterprise account (no trial/free tier)
• Subaccount in supported region: EU10, US10, AP10, AP11
• Cloud Foundry space within subaccount
• User with BusinessConfigurationAdmin role

2. Create Tenant

1. Create subaccount in available region
2. Subscribe to SAP Master Data Integration Tenant application
3. One tenant maximum per subaccount
4. Separate tenants for dev/test/prod recommended

3. Connect Application

1. Create service instance (one per application - MANDATORY)
2. Choose service plan (sap-integration or s4hana-onpremise)
3. Set 'application' attribute (e.g., "s4" for S/4HANA Cloud)
4. Create service binding for credentials
5. Configure writePermissions for entity types

4. Configure Distribution Model

1. Access Business Data Orchestration UI
2. Create distribution model (provider → consumer)
3. Set filters (object selection + data scope)
4. Activate model

System Limitations

Client Configuration Attributes

businessSystemId

• Required for SOAP API integration
• Max 60 characters, unique per tenant
• Must match SenderBusinessSystemID in SOAP messages

writePermissions

"writePermissions": [
  { "entityType": "sap.odm.finance.costobject.CostCenter" },
  { "entityType": "sap.odm.businesspartner.BusinessPartner" }
]

globalTenantId

• Identifies last significant writer on Events API
• 1-40 characters: alphanumeric, -, ., _, ~
• Configure only if application documentation requires it

logSys

• Logical system of last significant writer
• Max 10 characters
• Configure only if application documentation requires it

SOAP Endpoints

[https://one-mds.cfapps.{region}.hana.ondemand.com/businesspartner/v0/soap/

Destination Naming Convention (SOAP)

SYSTEMID

• SYSTEMID_BPOUTBOUND

  - Business Partner replication

• SYSTEMID_BPCONFIRM

  - Business Partner confirmation

• SYSTEMID_BPRELOUTBOUND

  - Relationship replication

• SYSTEMID_BPRELCONFIRM

  - Relationship confirmation

• SYSTEMID_KMOUTBOUND

  - Key Mapping replication

• SYSTEMID_KEYMAPCONFIRM

  - Key Mapping confirmation

Common Integration Scenarios

SAP S/4HANA Cloud

• 20 supported objects including Business Partner, Cost Center, Product
• Communication Arrangement: SAP_COM_0659 (MDI), SAP_COM_0594 (BDO)
• Single system cannot connect to multiple MDI tenants

SAP S/4HANA On-Premise

• 14 supported objects
• Uses drfimg transaction for configuration
• Outbound implementation: 986_3 for BP/REL via Services
• Requires SAP Note 3065614

SAP SuccessFactors

• Employee Central: Bank, Company Code, Cost Center, Workforce
• Employee Central Payroll: Cost Center, Public Sector Management

SAP Ariba

• 9 categories: Business Partner-Supplier, Company Code, Cost Center, etc.

references/integration-guides.md

Security Best Practices

1. Always use HTTPS - All MDI and XSUAA communications
2. Validate certificates - Never disable certificate validation
3. Rotate compromised credentials - Delete service key, create new one
4. Minimal permissions - Grant only necessary writePermissions
5. Separate subaccounts - Isolate MDI from unrelated BTP services

Troubleshooting

Delta Token Expired (28 days)

Change Request Rejected (Size)

Missing Mandatory Partner Function

Platform Status

Support Component

BC-CP-CF-ONEMDS

Bundled Resources

Core Documentation

1. references/setup-guide-complete.md

   (12.2K lines) - Complete setup guide with prerequisites, tenant management, client configuration, and version history

2. references/glossary-and-pricing.md

   (7.3K lines) - Comprehensive glossary, pricing tiers, qualifying applications, and maintenance windows

3. references/features-complete.md

   (11.6K lines) - All MDI features including REST/SOAP events, Local ID APIs, and data privacy

Integration Resources

1. references/integration-models.md

   (3.4K lines) - Complete ODM types and versions for all supported master data

2. references/integration-guides.md

   (6.8K lines) - System-specific setup guides for S/4HANA, SuccessFactors, Ariba, and more

3. references/soap-api-reference.md

   (17.7K lines) - Complete SOAP web services reference with field mappings

Advanced Topics

1. references/security-and-privacy.md

   (7.7K lines) - Security guidelines, data protection, and filtering configurations

2. references/extensibility.md

   (4.5K lines) - Custom extensions, field definitions, and WSDL generation

3. references/monitoring.md

   (7.3K lines) - Business Data Orchestration monitoring and troubleshooting

Documentation Sources