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/ 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