sap-btp-master-data-integration skill by secondsky

SAP BTP Master Data Integration

sap-btp-cloud-platform: Use for subaccount, entitlement, and service instance setup
sap-btp-connectivity: Use for destination and authentication configuration around connected systems
sap-btp-integration-suite: Use for MDI Adapter and broader integration orchestration scenarios
sap-api-style: Use when documenting MDI SOAP/API contracts and integration behavior

When to Use This Skill

Use this skill when setting up MDI tenants, connecting SAP applications, configuring distribution models, choosing MDI service plans, integrating business partner SOAP APIs, handling One Domain Model versions, or troubleshooting master data replication.

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?

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

3. Connect Application

4. Configure Distribution 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

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/

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

Always use HTTPS - All MDI and XSUAA communications
Validate certificates - Never disable certificate validation
Rotate compromised credentials - Delete service key, create new one
Minimal permissions - Grant only necessary writePermissions
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

references/setup-guide-complete.md (12.2K lines) - Complete setup guide with prerequisites, tenant management, client configuration, and version history
references/glossary-and-pricing.md (7.3K lines) - Comprehensive glossary, pricing tiers, qualifying applications, and maintenance windows
references/features-complete.md (11.6K lines) - All MDI features including REST/SOAP events, Local ID APIs, and data privacy

Integration Resources

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

Advanced Topics

references/security-and-privacy.md (7.7K lines) - Security guidelines, data protection, and filtering configurations
references/extensibility.md (4.5K lines) - Custom extensions, field definitions, and WSDL generation
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