sap-btp-master-data-integration

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

SAP Master Data Integration (MDI) is a central master data hub on SAP BTP that enables applications to synchronize local master data databases with a centralized repository.

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

Term	Definition
Tenant	Isolated MDI environment per subaccount with own database and configs
Client	Application that integrates with MDI (producing or consuming)
Producing Client	Sends change requests to MDI (upstream/writing client)
Consuming Client	Receives change events from MDI (downstream/reading client)
Distribution Model	Configuration controlling which data replicates where
Change Token	Unique identifier per change request (max 36 chars)

Integration Models (SAP One Domain Model)

Business Partner - v2.1.1, v3.3.0 (multiversion support restricted for address data) Finance - Cost Center v3.1.0, Exchange Rate v4.0.0, Bank v3.0.0 Workforce - Person v5.0.0, Job Classification v4.0.0, Organizational Unit v4.0.0 Procurement - Purchasing Organization v4.0.0, Purchasing Group v6.0.0 Assets - Equipment v5.1.0, Functional Location v5.0.0 Products - Product v5.0.0, Product Group v5.0.0

For complete list see 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

Limit	Value
Change Request Size	256 KB (512 KB for Business Partner)
Master Data Record Size	512 KB
Change Token Length	36 characters max
Delta Token Validity	28 days
SOAP Payload Size	10 MB
Change Token Characters	a-z, A-Z, 0-9, -, _

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

Base URL: [https://one-mds.cfapps.{region}.hana.ondemand.com/businesspartner/v0/soap/](https://one-mds.cfapps.{region}.hana.ondemand.com/businesspartner/v0/soap/`)

Purpose	Endpoint
BP Inbound	BusinessPartnerBulkReplicateRequestIn
BP Confirmation	BusinessPartnerBulkReplicateRequestConfIn
BP Relationship Inbound	BusinessPartnerRelationshipBulkReplicateRequestIn
BP Relationship Confirmation	BusinessPartnerRelationshipBulkReplicateRequestConfirmIn
Key Mapping Inbound	KeyMappingBulkReplicateRequestIn
Key Mapping Confirmation	KeyMappingBulkReplicateRequestConfirmIn

Authentication: Basic (clientid:clientsecret with tenantId param) or OAuth

Destination Naming Convention (SOAP)

For business system ID 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.

For detailed integration guides see 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)

Clients must perform initial load if unable to sync within 28 days.

Change Request Rejected (Size)

Reduce payload size below 256 KB (512 KB for Business Partner).

Missing Mandatory Partner Function

Configure partner determination logic in MDI for C4C → S/4HANA scenarios. Template available in SAP Note 2987243.

Platform Status

Check SAP Trust Center: https://www.sap.com/about/cloud-trust-center/

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

4. references/integration-models.md (3.4K lines) - Complete ODM types and versions for all supported master data
5. references/integration-guides.md (6.8K lines) - System-specific setup guides for S/4HANA, SuccessFactors, Ariba, and more
6. references/soap-api-reference.md (17.7K lines) - Complete SOAP web services reference with field mappings

Advanced Topics

7. references/security-and-privacy.md (7.7K lines) - Security guidelines, data protection, and filtering configurations
8. references/extensibility.md (4.5K lines) - Custom extensions, field definitions, and WSDL generation
9. references/monitoring.md (7.3K lines) - Business Data Orchestration monitoring and troubleshooting

Documentation Sources

Primary Documentation: https://help.sap.com/docs/master-data-integration GitHub Source: https://github.com/SAP-docs/sap-btp-master-data-integration API Catalog: https://api.sap.com (filter: SAP Master Data Integration) SAP Discovery Center: https://discovery-center.cloud.sap/serviceCatalog/master-data-integration