Title: Technical Guides | Commerce Cloud Integrations Source: https://www.commercecloudintegrations.com/guides Publisher: Commerce Cloud Integrations # Implementation guides 85 guides for teams that run SAP Commerce, down to the config, the query plan, and the failure mode. Search the guides [Upgrades and migration8](https://www.commercecloudintegrations.com/guides#upgrades) [Composable Storefront10](https://www.commercecloudintegrations.com/guides#storefront) [CCv2 and operations11](https://www.commercecloudintegrations.com/guides#ccv2) [Performance7](https://www.commercecloudintegrations.com/guides#performance) ## Start with these [Composable Storefront](https://www.commercecloudintegrations.com/guides/composable-storefront-ssr-incidents) ### [Composable Storefront SSR Incidents: Diagnose Timeouts, Hangs, and Memory Restarts](https://www.commercecloudintegrations.com/guides/composable-storefront-ssr-incidents) [A production runbook for Composable Storefront SSR timeouts, hung renders, Node heap growth, cache failures, and safe remediation.](https://www.commercecloudintegrations.com/guides/composable-storefront-ssr-incidents) [Advanced16 minJul 13, 2026](https://www.commercecloudintegrations.com/guides/composable-storefront-ssr-incidents) [Upgrades and migration](https://www.commercecloudintegrations.com/guides/sap-commerce-2211-upgrade-readiness) ### [SAP Commerce 2211 Upgrade Readiness Checklist](https://www.commercecloudintegrations.com/guides/sap-commerce-2211-upgrade-readiness) [A practical readiness model for moving legacy Hybris and SAP Commerce landscapes onto 2211-jdk21, now that Commerce Cloud blocks Java 17 builds.](https://www.commercecloudintegrations.com/guides/sap-commerce-2211-upgrade-readiness) [Advanced4 minSep 30, 2026](https://www.commercecloudintegrations.com/guides/sap-commerce-2211-upgrade-readiness) [Performance](https://www.commercecloudintegrations.com/guides/performance-engineering-for-sap-commerce) ### [Performance Engineering for SAP Commerce: Targets, Load Models, and the Tuning Loop](https://www.commercecloudintegrations.com/guides/performance-engineering-for-sap-commerce) [SAP Commerce performance engineering: NFRs, PI/s, user journeys, volumetrics, CCv2 load tests, and a repeatable tuning cycle.](https://www.commercecloudintegrations.com/guides/performance-engineering-for-sap-commerce) [Advanced9 minJul 11, 2026](https://www.commercecloudintegrations.com/guides/performance-engineering-for-sap-commerce) Topics - [Upgrades and migration8](https://www.commercecloudintegrations.com/guides#upgrades) - [Composable Storefront10](https://www.commercecloudintegrations.com/guides#storefront) - [CCv2 and operations11](https://www.commercecloudintegrations.com/guides#ccv2) - [Performance7](https://www.commercecloudintegrations.com/guides#performance) - [Integrations10](https://www.commercecloudintegrations.com/guides#integrations) - [Search4](https://www.commercecloudintegrations.com/guides#search) - [Data and catalog6](https://www.commercecloudintegrations.com/guides#data) - [Development8](https://www.commercecloudintegrations.com/guides#development) - [Security and identity7](https://www.commercecloudintegrations.com/guides#security) - [Architecture and strategy14](https://www.commercecloudintegrations.com/guides#architecture) ## Upgrades and migration From 6.x, 1905, or on-premise onto 2211-jdk21 on CCv2: the estimate, the tests, and the data move. 1. ### [SAP Commerce 2211 Upgrade Readiness Checklist](https://www.commercecloudintegrations.com/guides/sap-commerce-2211-upgrade-readiness) [A practical readiness model for moving legacy Hybris and SAP Commerce landscapes onto 2211-jdk21, now that Commerce Cloud blocks Java 17 builds.](https://www.commercecloudintegrations.com/guides/sap-commerce-2211-upgrade-readiness) [Advanced\ / 4 min read](https://www.commercecloudintegrations.com/guides/sap-commerce-2211-upgrade-readiness) 2. ### [Upgrading SAP Commerce from 6.x to 2211: The Stepping-Stone Walkthrough](https://www.commercecloudintegrations.com/guides/upgrading-from-6x-to-2211) [A multi-version upgrade reference: the per-hop validation matrix, the recurring failure classes, the JDK and Spring jumps, and compressing the stepping stones.](https://www.commercecloudintegrations.com/guides/upgrading-from-6x-to-2211) [Expert\ / 8 min read](https://www.commercecloudintegrations.com/guides/upgrading-from-6x-to-2211) 3. ### [Estimating an SAP Commerce Upgrade: The Hands-On Assessment Method](https://www.commercecloudintegrations.com/guides/sap-commerce-upgrade-effort-analysis) [Estimate SAP Commerce upgrades with git overlays, five evidence-based analysis phases, and practices that reduce the next upgrade.](https://www.commercecloudintegrations.com/guides/sap-commerce-upgrade-effort-analysis) [Advanced\ / 8 min read](https://www.commercecloudintegrations.com/guides/sap-commerce-upgrade-effort-analysis) 4. ### [Migrating to SAP Commerce Cloud: Assessment, Planning, and the Technical Gap List](https://www.commercecloudintegrations.com/guides/migrating-to-ccv2-planning-and-assessment) [Plan an on-premise SAP Commerce to CCv2 move: assessment, environment sequencing, and adaptations for SMTP, ImageMagick, and caches.](https://www.commercecloudintegrations.com/guides/migrating-to-ccv2-planning-and-assessment) [Advanced\ / 9 min read](https://www.commercecloudintegrations.com/guides/migrating-to-ccv2-planning-and-assessment) 5. ### [Executing an SAP Commerce Upgrade: Testing, Deployment, and the First Two Weeks After](https://www.commercecloudintegrations.com/guides/upgrade-execution-testing-and-deployment) [Execute SAP Commerce upgrades with reloadable test data, rehearsed deployment and rollback, regression coverage, and post-go-live support.](https://www.commercecloudintegrations.com/guides/upgrade-execution-testing-and-deployment) [Advanced\ / 10 min read](https://www.commercecloudintegrations.com/guides/upgrade-execution-testing-and-deployment) 6. ### [CCv2 Data and Media Migration: DB Sync, AzCopy, and Choosing Your Code Freeze](https://www.commercecloudintegrations.com/guides/ccv2-data-and-media-migration) [CCv2 data and media migration using SAP Commerce DB Sync, AzCopy, verification, rollback practice, and code-freeze planning.](https://www.commercecloudintegrations.com/guides/ccv2-data-and-media-migration) [Advanced\ / 10 min read](https://www.commercecloudintegrations.com/guides/ccv2-data-and-media-migration) 7. ### [Testing a CCv2 Migration: The Two Extra Test Dimensions That Decide Success](https://www.commercecloudintegrations.com/guides/migration-testing-strategy) [Why migrating to Commerce Cloud needs more than regression: the sequenced plan, data and media validation, integration re-validation, and production data.](https://www.commercecloudintegrations.com/guides/migration-testing-strategy) [Intermediate\ / 7 min read](https://www.commercecloudintegrations.com/guides/migration-testing-strategy) 8. ### [Migrating Legacy Promotions to the Promotion Engine Without Breaking Old Orders](https://www.commercecloudintegrations.com/guides/migrating-legacy-promotions-to-promotion-engine) [Migrate legacy SAP Commerce promotions to rule-engine equivalents, with cart handling, order recalculation, and integrity checks.](https://www.commercecloudintegrations.com/guides/migrating-legacy-promotions-to-promotion-engine) [Advanced\ / 8 min read](https://www.commercecloudintegrations.com/guides/migrating-legacy-promotions-to-promotion-engine) ## Composable Storefront Spartacus in production: SSR, OCC contracts, runtime configuration on CCv2, and the move off Accelerator. 1. ### [Composable Storefront SSR Incidents: Diagnose Timeouts, Hangs, and Memory Restarts](https://www.commercecloudintegrations.com/guides/composable-storefront-ssr-incidents) [A production runbook for Composable Storefront SSR timeouts, hung renders, Node heap growth, cache failures, and safe remediation.](https://www.commercecloudintegrations.com/guides/composable-storefront-ssr-incidents) [Advanced\ / 16 min read](https://www.commercecloudintegrations.com/guides/composable-storefront-ssr-incidents) 2. ### [Composable Storefront Engineering: Production Practices for Angular, CMS, and SSR](https://www.commercecloudintegrations.com/guides/composable-storefront-production-engineering) [Production practices for Composable Storefront code: CMS boundaries, facades, lifecycle ownership, SSR-safe APIs, rendering policy, and release gates.](https://www.commercecloudintegrations.com/guides/composable-storefront-production-engineering) [Advanced\ / 15 min read](https://www.commercecloudintegrations.com/guides/composable-storefront-production-engineering) 3. ### [Composable Storefront on CCv2: Build, Runtime Configuration, and OCC Connectivity](https://www.commercecloudintegrations.com/guides/composable-storefront-ccv2-runtime-configuration) [Deploy Composable Storefront on CCv2 with reproducible artifacts, runtime OCC configuration, CORS, private API access, and browser/SSR verification.](https://www.commercecloudintegrations.com/guides/composable-storefront-ccv2-runtime-configuration) [Advanced\ / 14 min read](https://www.commercecloudintegrations.com/guides/composable-storefront-ccv2-runtime-configuration) 4. ### [Composable Storefront OCC Contract Hardening](https://www.commercecloudintegrations.com/guides/composable-storefront-occ-contracts) [How to keep Spartacus and custom composable storefronts stable while SAP Commerce OCC endpoints evolve behind them.](https://www.commercecloudintegrations.com/guides/composable-storefront-occ-contracts) [Advanced\ / 4 min read](https://www.commercecloudintegrations.com/guides/composable-storefront-occ-contracts) 5. ### [Composable Storefront: How It Actually Works Under the Hood](https://www.commercecloudintegrations.com/guides/composable-storefront-getting-started) [Composable storefront foundations: CMS page composition, CmsConfig mapping, OCC product-page calls, SSR, and required team skills.](https://www.commercecloudintegrations.com/guides/composable-storefront-getting-started) [Intermediate\ / 7 min read](https://www.commercecloudintegrations.com/guides/composable-storefront-getting-started) 6. ### [Migrating an Accelerator Storefront to Composable: The Inventory-Driven Method](https://www.commercecloudintegrations.com/guides/accelerator-to-composable-migration) [A practical migration method for CMS inventory, component gap analysis, API-first OCC development, and console-warning-led implementation.](https://www.commercecloudintegrations.com/guides/accelerator-to-composable-migration) [Advanced\ / 9 min read](https://www.commercecloudintegrations.com/guides/accelerator-to-composable-migration) 7. ### [Untangling a Legacy Accelerator Storefront: The Customization Archaeology Before Any Storefront Decision](https://www.commercecloudintegrations.com/guides/modernizing-legacy-accelerator-storefronts) [The customization archaeology before any storefront decision: the pure-versus-customized diff, the layer-by-layer risk map, and the debt that decides the path.](https://www.commercecloudintegrations.com/guides/modernizing-legacy-accelerator-storefronts) [Advanced\ / 14 min read](https://www.commercecloudintegrations.com/guides/modernizing-legacy-accelerator-storefronts) 8. ### [Storefront Strategy After the Accelerator: Your Options and the Clock](https://www.commercecloudintegrations.com/guides/storefront-strategy-after-accelerator-deprecation) [Choose a post-Accelerator SAP Commerce storefront: composable, custom headless, or a managed transition while the OCC add-on removals approach.](https://www.commercecloudintegrations.com/guides/storefront-strategy-after-accelerator-deprecation) [Intermediate\ / 8 min read](https://www.commercecloudintegrations.com/guides/storefront-strategy-after-accelerator-deprecation) 9. ### [Headless Commerce with SAP Commerce: Decoupling Without Losing Your Head](https://www.commercecloudintegrations.com/guides/headless-commerce-architecture) [A working definition of headless for SAP Commerce: OCC as the seam, the many-headed reality, readiness over rewrites, and the auth, cache, and CMS traps.](https://www.commercecloudintegrations.com/guides/headless-commerce-architecture) [Intermediate\ / 8 min read](https://www.commercecloudintegrations.com/guides/headless-commerce-architecture) 10. ### [Web Analytics on SAP Commerce: GA4, Tag Manager, and the DataLayer Done Right](https://www.commercecloudintegrations.com/guides/web-analytics-ga4-integration) [Implement SAP Commerce GA4 with dataLayer architecture, journey events, consent integration, and revenue-data QA.](https://www.commercecloudintegrations.com/guides/web-analytics-ga4-integration) [Intermediate\ / 9 min read](https://www.commercecloudintegrations.com/guides/web-analytics-ga4-integration) ## CCv2 and operations Builds, deployments, networking, logs, Dynatrace, scaling, and go-live on SAP Commerce Cloud. 1. ### [Your First SAP Commerce Cloud Build and Deployment, Done Right](https://www.commercecloudintegrations.com/guides/first-ccv2-build-and-deployment) [First CCv2 build and deployment: repository and manifest setup, endpoint security, initial release, and Cloud Portal API automation.](https://www.commercecloudintegrations.com/guides/first-ccv2-build-and-deployment) [Introductory\ / 9 min read](https://www.commercecloudintegrations.com/guides/first-ccv2-build-and-deployment) 2. ### [The Cloud Portal Operations Handbook: Environments, Builds, Backups, and Self-Service](https://www.commercecloudintegrations.com/guides/cloud-portal-operations-handbook) [Operating a CCv2 subscription: the three environments and sizing, the manifest-driven build, the ephemeral-storage rule, and backup versus disaster recovery.](https://www.commercecloudintegrations.com/guides/cloud-portal-operations-handbook) [Intermediate\ / 8 min read](https://www.commercecloudintegrations.com/guides/cloud-portal-operations-handbook) 3. ### [Continuous Delivery for SAP Commerce Cloud: Your Pipeline in Front of Theirs](https://www.commercecloudintegrations.com/guides/continuous-delivery-for-ccv2) [CCv2 continuous delivery with fast and full builds, quality gates, Cloud Portal API automation, and controlled production deployment.](https://www.commercecloudintegrations.com/guides/continuous-delivery-for-ccv2) [Advanced\ / 8 min read](https://www.commercecloudintegrations.com/guides/continuous-delivery-for-ccv2) 4. ### [Go-Live Readiness for SAP Commerce Cloud: The Checks That Decide the Weekend](https://www.commercecloudintegrations.com/guides/go-live-readiness-for-sap-commerce-cloud) [SAP Commerce go-live readiness: rehearsed deployment, type-system rollback, DNS and SEO cutover, user migration, and monitoring.](https://www.commercecloudintegrations.com/guides/go-live-readiness-for-sap-commerce-cloud) [Intermediate\ / 8 min read](https://www.commercecloudintegrations.com/guides/go-live-readiness-for-sap-commerce-cloud) 5. ### [Logging and Diagnostics on CCv2: From Ephemeral Nodes to Searchable Signal](https://www.commercecloudintegrations.com/guides/logging-and-diagnostics-on-ccv2) [Seeing what your solution does with ephemeral disks and no shell: centralized aggregation, log-level discipline, correlation IDs, and runtime diagnostics.](https://www.commercecloudintegrations.com/guides/logging-and-diagnostics-on-ccv2) [Intermediate\ / 8 min read](https://www.commercecloudintegrations.com/guides/logging-and-diagnostics-on-ccv2) 6. ### [Dynatrace on SAP Commerce Cloud: The Troubleshooting Workflows That Matter](https://www.commercecloudintegrations.com/guides/dynatrace-observability-on-ccv2) [CCv2 Dynatrace workflows for slow sites, database hotspots, failing pages, exceptions, thread analysis, and retention limits.](https://www.commercecloudintegrations.com/guides/dynatrace-observability-on-ccv2) [Intermediate\ / 7 min read](https://www.commercecloudintegrations.com/guides/dynatrace-observability-on-ccv2) 7. ### [CCv2 Web and Network Architecture: Endpoints, CDN Integration, and VPN](https://www.commercecloudintegrations.com/guides/ccv2-web-and-network-architecture) [What you can and cannot configure in the CCv2 web and network layers: endpoints, IP filters, certificates and mTLS, CDN and WAF integration, DNS, and VPN.](https://www.commercecloudintegrations.com/guides/ccv2-web-and-network-architecture) [Intermediate\ / 8 min read](https://www.commercecloudintegrations.com/guides/ccv2-web-and-network-architecture) 8. ### [Instance Strategy for SAP Commerce Cloud: One Global, Many Regional, or Something Between](https://www.commercecloudintegrations.com/guides/ccv2-regions-and-global-deployment) [The four instance strategies for global SAP Commerce estates, the factors that decide between them, and the honest costs of running multiple instances.](https://www.commercecloudintegrations.com/guides/ccv2-regions-and-global-deployment) [Advanced\ / 8 min read](https://www.commercecloudintegrations.com/guides/ccv2-regions-and-global-deployment) 9. ### [CCv2 Aspects, Clustering, and Scaling: Designing Inside a Fixed Footprint](https://www.commercecloudintegrations.com/guides/platform-clustering-and-scaling) [How the CCv2 cluster is shaped: the aspect model, why backgroundProcessing has a fixed budget, writing bulk jobs that respect it, and horizontal scaling.](https://www.commercecloudintegrations.com/guides/platform-clustering-and-scaling) [Advanced\ / 8 min read](https://www.commercecloudintegrations.com/guides/platform-clustering-and-scaling) 10. ### [Web Sessions on CCv2: Sticky Routing, Cart Binding, Cookies, and the Headless Shift](https://www.commercecloudintegrations.com/guides/web-session-management-ccv2) [How sessions behave on CCv2: HTTP versus Jalo sessions, sticky routing, cart binding and merge-on-login, cookie security, timeouts, and the headless shift.](https://www.commercecloudintegrations.com/guides/web-session-management-ccv2) [Advanced\ / 8 min read](https://www.commercecloudintegrations.com/guides/web-session-management-ccv2) 11. ### [On-Premise SAP Commerce Infrastructure: The Complete Hardening and Tuning Guide](https://www.commercecloudintegrations.com/guides/on-premise-infrastructure-guide) [For self-hosted estates: cluster topology, load balancer stickiness traps, Apache tuning, current JVM and G1 settings, database rules, and hardening.](https://www.commercecloudintegrations.com/guides/on-premise-infrastructure-guide) [Expert\ / 10 min read](https://www.commercecloudintegrations.com/guides/on-premise-infrastructure-guide) ## Performance Caching, locking, promotions, media, and peak traffic, measured before and after. 1. ### [Performance Engineering for SAP Commerce: Targets, Load Models, and the Tuning Loop](https://www.commercecloudintegrations.com/guides/performance-engineering-for-sap-commerce) [SAP Commerce performance engineering: NFRs, PI/s, user journeys, volumetrics, CCv2 load tests, and a repeatable tuning cycle.](https://www.commercecloudintegrations.com/guides/performance-engineering-for-sap-commerce) [Advanced\ / 9 min read](https://www.commercecloudintegrations.com/guides/performance-engineering-for-sap-commerce) 2. ### [Preparing SAP Commerce Cloud for High-Traffic Events](https://www.commercecloudintegrations.com/guides/preparing-for-high-traffic-events) [SAP Commerce peak-event readiness with Dynatrace baselines, SAP lead time, controlled releases, cronjob freezes, and promotion hygiene.](https://www.commercecloudintegrations.com/guides/preparing-for-high-traffic-events) [Intermediate\ / 9 min read](https://www.commercecloudintegrations.com/guides/preparing-for-high-traffic-events) 3. ### [Persistence and Caching in SAP Commerce: Region Caches, the Type Cache, and CCv2 Sizing](https://www.commercecloudintegrations.com/guides/persistence-and-caching-architecture) [The cache hierarchy that serves most requests: entity and query regions, cluster invalidation, heap-relative sizing with SpEL, and the measurement loop.](https://www.commercecloudintegrations.com/guides/persistence-and-caching-architecture) [Advanced\ / 7 min read](https://www.commercecloudintegrations.com/guides/persistence-and-caching-architecture) 4. ### [Promotion Engine Performance: Ten Fixes for a Slow Drools Rule Base](https://www.commercecloudintegrations.com/guides/promotion-engine-performance) [Promotion Engine performance: rule base statistics, discount rows, virtual categories, KIE splits, expired-rule cleanup, and fewer evaluations.](https://www.commercecloudintegrations.com/guides/promotion-engine-performance) [Advanced\ / 9 min read](https://www.commercecloudintegrations.com/guides/promotion-engine-performance) 5. ### [Transactions and Locking in SAP Commerce: Keeping Them Short, Correct, and Deadlock-Free](https://www.commercecloudintegrations.com/guides/transactions-and-locking) [The transaction discipline behind a checkout that holds: short transactions, no remote calls inside them, optimistic-locking retries, deadlock avoidance.](https://www.commercecloudintegrations.com/guides/transactions-and-locking) [Expert\ / 7 min read](https://www.commercecloudintegrations.com/guides/transactions-and-locking) 6. ### [Media Management in SAP Commerce: Storage, Conversion, Secure Access, and the CDN](https://www.commercecloudintegrations.com/guides/media-management-architecture) [How media works: the Media and MediaContainer model, cloud format conversion, secure access, why ephemeral storage means cloud storage, and CDN delivery.](https://www.commercecloudintegrations.com/guides/media-management-architecture) [Intermediate\ / 7 min read](https://www.commercecloudintegrations.com/guides/media-management-architecture) 7. ### [Non-Functional Requirements for Commerce: The ISO 25010 Catalog That Prevents Scope Fights](https://www.commercecloudintegrations.com/guides/nfr-catalog-for-commerce-projects) [The NFRs that decide production-readiness, organized by ISO 25010: capacity and time behavior with real numbers, testable definitions, and out-of-scope.](https://www.commercecloudintegrations.com/guides/nfr-catalog-for-commerce-projects) [Intermediate\ / 9 min read](https://www.commercecloudintegrations.com/guides/nfr-catalog-for-commerce-projects) ## Integrations OData, the Integration API, webhooks, Kyma events, hot folders, and email, with the failure paths. 1. ### [Integration Options for SAP Commerce Cloud: Choosing the Right Channel in 2026](https://www.commercecloudintegrations.com/guides/integration-options-for-sap-commerce) [SAP Commerce 2211 integration choices: Integration APIs, OData, webhooks, OutboundSync, Integration Suite, Kyma, Hot Folders, and ImpEx.](https://www.commercecloudintegrations.com/guides/integration-options-for-sap-commerce) [Intermediate\ / 10 min read](https://www.commercecloudintegrations.com/guides/integration-options-for-sap-commerce) 2. ### [Integration Objects and OData: The Hands-On Guide to Commerce Integration APIs](https://www.commercecloudintegrations.com/guides/integration-objects-odata-deep-dive) [Modeling Integration Objects that hold up: item and attribute definitions, inbound OAuth channels, virtual and runtime attributes, the MetaAPI, and monitoring.](https://www.commercecloudintegrations.com/guides/integration-objects-odata-deep-dive) [Advanced\ / 7 min read](https://www.commercecloudintegrations.com/guides/integration-objects-odata-deep-dive) 3. ### [Webhooks at Scale: Commerce Event Notifications That Survive Production Traffic](https://www.commercecloudintegrations.com/guides/webhooks-at-scale) [Webhook integrations that survive production traffic: the ack-fast-queue-later consumer, signature verification, dedupe, ordering, and reconciliation.](https://www.commercecloudintegrations.com/guides/webhooks-at-scale) [Advanced\ / 7 min read](https://www.commercecloudintegrations.com/guides/webhooks-at-scale) 4. ### [Integration Monitoring and Alerting: Nobody Watches Dashboards at 3 a.m.](https://www.commercecloudintegrations.com/guides/integration-monitoring-and-alerting) [Turning integration monitoring into alerts someone receives: the four signal sources, the freshness principle, a timer-driven alert flow, and alert design.](https://www.commercecloudintegrations.com/guides/integration-monitoring-and-alerting) [Intermediate\ / 7 min read](https://www.commercecloudintegrations.com/guides/integration-monitoring-and-alerting) 5. ### [Custom Events and Side-by-Side Extensions: Commerce to BTP Kyma End to End](https://www.commercecloudintegrations.com/guides/event-driven-extensions-custom-events-kyma) [An event-driven SAP Commerce pattern: define a custom event, export it to Kyma, and call back through Integration API and OCC.](https://www.commercecloudintegrations.com/guides/event-driven-extensions-custom-events-kyma) [Expert\ / 8 min read](https://www.commercecloudintegrations.com/guides/event-driven-extensions-custom-events-kyma) 6. ### [Side-by-Side Extensibility: Deciding What Leaves the Platform, and Building It](https://www.commercecloudintegrations.com/guides/side-by-side-extensibility-patterns) [The decision framework for in-platform versus side-by-side extensions, the integration seams that make external apps safe, and low-code with real governance.](https://www.commercecloudintegrations.com/guides/side-by-side-extensibility-patterns) [Intermediate\ / 7 min read](https://www.commercecloudintegrations.com/guides/side-by-side-extensibility-patterns) 7. ### [Local Kyma Development for Commerce Extensions: Mocks, Wiring, and the Fast Loop](https://www.commercecloudintegrations.com/guides/local-kyma-development-environment) [Building commerce extensions without shared environments: a local Kyma cluster, the commerce mock, the certificate and DNS wiring, and where the tooling moved.](https://www.commercecloudintegrations.com/guides/local-kyma-development-environment) [Advanced\ / 7 min read](https://www.commercecloudintegrations.com/guides/local-kyma-development-environment) 8. ### [Cloud Hot Folders: Migration, Configuration, and Troubleshooting](https://www.commercecloudintegrations.com/guides/cloud-hot-folders-complete-guide) [Cloud Hot Folders with Azure Blob, legacy Spring migration, external imports, local Azurite testing, and failure diagnosis.](https://www.commercecloudintegrations.com/guides/cloud-hot-folders-complete-guide) [Advanced\ / 9 min read](https://www.commercecloudintegrations.com/guides/cloud-hot-folders-complete-guide) 9. ### [Transactional Email on SAP Commerce Cloud: Providers, Protocols, and Deliverability](https://www.commercecloudintegrations.com/guides/transactional-email-on-ccv2) [CCv2 transactional email with SMTP or REST APIs, EmailSendStrategy, SPF/DKIM/DMARC, bounce handling, and delivery testing.](https://www.commercecloudintegrations.com/guides/transactional-email-on-ccv2) [Intermediate\ / 8 min read](https://www.commercecloudintegrations.com/guides/transactional-email-on-ccv2) 10. ### [Amazon SES for SAP Commerce Email: Setup, Deliverability, and Closing the Bounce Loop](https://www.commercecloudintegrations.com/guides/amazon-ses-for-commerce-email) [Running Amazon SES behind SAP Commerce: the IAM, SNS, and SQS wiring, the SPF/DKIM/DMARC trinity, bounce handling, and testing with the mailbox simulator.](https://www.commercecloudintegrations.com/guides/amazon-ses-for-commerce-email) [Intermediate\ / 11 min read](https://www.commercecloudintegrations.com/guides/amazon-ses-for-commerce-email) ## Search Solr indexing, relevance tuning, scaling, and the search settings business users own. 1. ### [Solr Search in SAP Commerce: Architecture and Indexing Done Right](https://www.commercecloudintegrations.com/guides/solr-search-architecture-and-indexing) [SAP Commerce search indexing: indexed types, full and partial runs, two-phase commits, value providers, and safe scheduling.](https://www.commercecloudintegrations.com/guides/solr-search-architecture-and-indexing) [Advanced\ / 9 min read](https://www.commercecloudintegrations.com/guides/solr-search-architecture-and-indexing) 2. ### [Solr Query Tuning and Troubleshooting in SAP Commerce](https://www.commercecloudintegrations.com/guides/solr-query-tuning-and-troubleshooting) [Tune SAP Commerce Solr queries, boosts, and query builders; use the admin console to diagnose stale data, facets, 404s, and scores.](https://www.commercecloudintegrations.com/guides/solr-query-tuning-and-troubleshooting) [Advanced\ / 10 min read](https://www.commercecloudintegrations.com/guides/solr-query-tuning-and-troubleshooting) 3. ### [Solr Infrastructure for SAP Commerce: Topology, Sizing, and Tuning](https://www.commercecloudintegrations.com/guides/solr-infrastructure-and-scaling) [Solr Cloud and standalone architecture: ZooKeeper quorum, shards, replicas, JVM sizing, solrconfig tuning, and CCv2 boundaries.](https://www.commercecloudintegrations.com/guides/solr-infrastructure-and-scaling) [Advanced\ / 9 min read](https://www.commercecloudintegrations.com/guides/solr-infrastructure-and-scaling) 4. ### [Search Merchandising in SAP Commerce: The Business-User Levers on Solr](https://www.commercecloudintegrations.com/guides/search-configuration-for-business-users) [The search levers a merchandiser owns without code: indexed attributes and weighting, the search bar, stopwords and synonyms, redirects, and Adaptive Search.](https://www.commercecloudintegrations.com/guides/search-configuration-for-business-users) [Intermediate\ / 9 min read](https://www.commercecloudintegrations.com/guides/search-configuration-for-business-users) ## Data and catalog ImpEx, catalog sync, the type system, content catalogs, and data retention. 1. ### [ImpEx: The Working Reference for People Who Load Data for a Living](https://www.commercecloudintegrations.com/guides/impex-complete-reference) [Header modes and modifiers, macros and config-driven scripts, document IDs, media and user rights, the resolver and dump files, and distributed ImpEx.](https://www.commercecloudintegrations.com/guides/impex-complete-reference) [Intermediate\ / 8 min read](https://www.commercecloudintegrations.com/guides/impex-complete-reference) 2. ### [Data Loading Strategies: Essential, Sample, and Production Data Without Conflicts](https://www.commercecloudintegrations.com/guides/data-loading-strategies) [SAP Commerce data loading with AutoImpEx conventions, environment-specific imports, release data, anonymization, and migration paths.](https://www.commercecloudintegrations.com/guides/data-loading-strategies) [Intermediate\ / 10 min read](https://www.commercecloudintegrations.com/guides/data-loading-strategies) 3. ### [Catalog Synchronization: How It Works and How to Make It Fast](https://www.commercecloudintegrations.com/guides/catalog-synchronization-deep-dive) [SAP Commerce catalog sync triggers, filtering, merge semantics, failure diagnosis, and production tuning for reliable synchronization.](https://www.commercecloudintegrations.com/guides/catalog-synchronization-deep-dive) [Advanced\ / 14 min read](https://www.commercecloudintegrations.com/guides/catalog-synchronization-deep-dive) 4. ### [Data Modeling with the SAP Commerce Type System: Decisions That Age Well](https://www.commercecloudintegrations.com/guides/type-system-data-modeling-guide) [Design durable SAP Commerce items.xml changes: extension or subtype, deployment tables, typecodes, relations, dynamic attributes, and debt.](https://www.commercecloudintegrations.com/guides/type-system-data-modeling-guide) [Intermediate\ / 9 min read](https://www.commercecloudintegrations.com/guides/type-system-data-modeling-guide) 5. ### [Content Catalog Design: Single, Shared, and Multi-Layered Strategies](https://www.commercecloudintegrations.com/guides/content-catalog-design-strategies) [WCMS content catalog topology for multi-site SAP Commerce: reuse, restrictions, country layering, and SmartEdit approvals.](https://www.commercecloudintegrations.com/guides/content-catalog-design-strategies) [Intermediate\ / 7 min read](https://www.commercecloudintegrations.com/guides/content-catalog-design-strategies) 6. ### [Data Maintenance and Cleanup: Retention Rules That Keep Commerce Fast](https://www.commercecloudintegrations.com/guides/data-maintenance-and-cleanup) [SAP Commerce cleanup for audit data, cronjobs, ImpEx media, sessions, business processes, carts, purges, and sanecleanup.](https://www.commercecloudintegrations.com/guides/data-maintenance-and-cleanup) [Intermediate\ / 11 min read](https://www.commercecloudintegrations.com/guides/data-maintenance-and-cleanup) ## Development FlexibleSearch, the service layer, code review, testing, cronjobs, HAC, and a working local setup. 1. ### [FlexibleSearch Mastery: From Syntax to Query Plans](https://www.commercecloudintegrations.com/guides/flexiblesearch-mastery) [The query language every developer writes daily: type-aware joins, localized attributes, session context, the query cache contract, and slow-query tuning.](https://www.commercecloudintegrations.com/guides/flexiblesearch-mastery) [Advanced\ / 7 min read](https://www.commercecloudintegrations.com/guides/flexiblesearch-mastery) 2. ### [Service Layer Patterns in SAP Commerce: Services, Facades, Converters, and Interceptors Done Right](https://www.commercecloudintegrations.com/guides/service-layer-patterns) [The patterns that keep custom code maintainable: service-and-facade layering, converters and populators, interceptors versus events, and injectable design.](https://www.commercecloudintegrations.com/guides/service-layer-patterns) [Advanced\ / 8 min read](https://www.commercecloudintegrations.com/guides/service-layer-patterns) 3. ### [The SAP Commerce Code Review Playbook: Process and Checklist](https://www.commercecloudintegrations.com/guides/sap-commerce-code-review-playbook) [A SAP Commerce code review system for pull requests, automation, models, interceptors, FlexibleSearch, cronjobs, sessions, and Backoffice.](https://www.commercecloudintegrations.com/guides/sap-commerce-code-review-playbook) [Intermediate\ / 12 min read](https://www.commercecloudintegrations.com/guides/sap-commerce-code-review-playbook) 4. ### [Coding Standards and Automated Quality Gates for SAP Commerce](https://www.commercecloudintegrations.com/guides/coding-standards-and-code-quality) [SAP Commerce naming, layering, null and exception discipline, plus SonarQube quality profiles and sonarcheck enforcement.](https://www.commercecloudintegrations.com/guides/coding-standards-and-code-quality) [Intermediate\ / 9 min read](https://www.commercecloudintegrations.com/guides/coding-standards-and-code-quality) 5. ### [A Testing Strategy for SAP Commerce: The Pyramid, the Platform Specifics, and the Gates](https://www.commercecloudintegrations.com/guides/testing-strategy-for-sap-commerce) [Testing so quality is built in, not inspected: the pyramid applied to the platform, ImpEx fixtures, the CCv2 pipeline gates, and non-functional testing.](https://www.commercecloudintegrations.com/guides/testing-strategy-for-sap-commerce) [Intermediate\ / 9 min read](https://www.commercecloudintegrations.com/guides/testing-strategy-for-sap-commerce) 6. ### [CronJobs Done Right: Authoring, Scheduling, and Surviving the Cloud](https://www.commercecloudintegrations.com/guides/cronjobs-and-task-automation) [The full lifecycle of background work: JobPerformable anatomy, triggers, node groups and aspects, abortable resumable jobs, log retention, and monitoring.](https://www.commercecloudintegrations.com/guides/cronjobs-and-task-automation) [Intermediate\ / 7 min read](https://www.commercecloudintegrations.com/guides/cronjobs-and-task-automation) 7. ### [The hAC Power User Guide: Consoles, Diagnostics, and the Tricks Support Uses](https://www.commercecloudintegrations.com/guides/hac-power-user-guide) [The Hybris Administration Console beyond the basics: the consoles, cache and cluster diagnostics, live log levels, JDBC logging, and the tricks support uses.](https://www.commercecloudintegrations.com/guides/hac-power-user-guide) [Intermediate\ / 8 min read](https://www.commercecloudintegrations.com/guides/hac-power-user-guide) 8. ### [Local Development Environment for SAP Commerce Cloud: Full CCv2 Parity](https://www.commercecloudintegrations.com/guides/local-development-environment-for-sap-commerce) [A CCv2-aligned local SAP Commerce setup with SQL Server in Docker, the correct JDK, manifest reuse, and cloud constraints.](https://www.commercecloudintegrations.com/guides/local-development-environment-for-sap-commerce) [Introductory\ / 10 min read](https://www.commercecloudintegrations.com/guides/local-development-environment-for-sap-commerce) ## Security and identity Hardening, GDPR, SSO with SAML and OIDC, B2B identity, 2FA, and user rights. 1. ### [Security Hardening for SAP Commerce: The Application-Layer Checklist Pen Testers Start With](https://www.commercecloudintegrations.com/guides/security-hardening-for-sap-commerce) [The security work that stays yours on CCv2: password encoding and TAE keys, the init lock, cockpit access, CORS and cookies, secure media, and the OWASP list.](https://www.commercecloudintegrations.com/guides/security-hardening-for-sap-commerce) [Advanced\ / 7 min read](https://www.commercecloudintegrations.com/guides/security-hardening-for-sap-commerce) 2. ### [Data Protection in SAP Commerce: Consent, Erasure, Encryption, and Anonymization](https://www.commercecloudintegrations.com/guides/data-protection-in-sap-commerce) [SAP Commerce GDPR engineering: consent, erasure and reporting, attribute encryption, anonymization, and authentication hardening.](https://www.commercecloudintegrations.com/guides/data-protection-in-sap-commerce) [Advanced\ / 9 min read](https://www.commercecloudintegrations.com/guides/data-protection-in-sap-commerce) 3. ### [SAML SSO for SAP Commerce: Storefront, Backoffice, and the Flows Between](https://www.commercecloudintegrations.com/guides/storefront-sso-with-saml) [Federation without the folklore: SP versus IdP-initiated login, mapping assertions to customers and employees, the RelayState and domain traps, SAML or OIDC.](https://www.commercecloudintegrations.com/guides/storefront-sso-with-saml) [Advanced\ / 7 min read](https://www.commercecloudintegrations.com/guides/storefront-sso-with-saml) 4. ### [OIDC Login for Commerce Storefronts: Tokens, Flows, and the Commerce Session Bridge](https://www.commercecloudintegrations.com/guides/oidc-login-for-commerce-storefronts) [OIDC as the storefront auth backbone: the authorization code flow with PKCE, the three tokens, the commerce session bridge, cart merge, and logout semantics.](https://www.commercecloudintegrations.com/guides/oidc-login-for-commerce-storefronts) [Advanced\ / 11 min read](https://www.commercecloudintegrations.com/guides/oidc-login-for-commerce-storefronts) 5. ### [B2B Identity for Commerce: Delegated Administration, BYOI, and Just-in-Time Provisioning](https://www.commercecloudintegrations.com/guides/b2b-identity-and-jit-provisioning) [Why B2B login is an org problem: onboarding orgs versus users, delegated administration, login identifiers, bring-your-own-identity, JIT provisioning, and PBAC.](https://www.commercecloudintegrations.com/guides/b2b-identity-and-jit-provisioning) [Advanced\ / 9 min read](https://www.commercecloudintegrations.com/guides/b2b-identity-and-jit-provisioning) 6. ### [Storefront 2FA and Session Security: Risk-Based Auth in a Post-Third-Party-Cookie World](https://www.commercecloudintegrations.com/guides/storefront-2fa-and-session-security) [Securing logins without strangling conversion: the two-factor ladder, risk-based triggers, credential stuffing defense, and SSO after third-party cookies died.](https://www.commercecloudintegrations.com/guides/storefront-2fa-and-session-security) [Intermediate\ / 7 min read](https://www.commercecloudintegrations.com/guides/storefront-2fa-and-session-security) 7. ### [User and Rights Management in SAP Commerce: Groups, Inheritance, and the Deny Trap](https://www.commercecloudintegrations.com/guides/user-and-rights-management-guide) [The Backoffice access model projects postpone and regret: groups and inheritance, type and attribute permissions, the standard groups, and the deny trap.](https://www.commercecloudintegrations.com/guides/user-and-rights-management-guide) [Intermediate\ / 9 min read](https://www.commercecloudintegrations.com/guides/user-and-rights-management-guide) ## Architecture and strategy Platform decisions: multi-site, marketplace, omnichannel, pricing, personalization, markets, and team shape. 1. ### [SAP Commerce Cloud Architecture Overview](https://www.commercecloudintegrations.com/guides/sap-commerce-cloud-architecture-overview) [SAP Commerce Cloud architecture: platform services, CCv2 aspects, deployment pipelines, cluster topology, and integration patterns.](https://www.commercecloudintegrations.com/guides/sap-commerce-cloud-architecture-overview) [Intermediate\ / 12 min read](https://www.commercecloudintegrations.com/guides/sap-commerce-cloud-architecture-overview) 2. ### [Writing a Solution Architecture Definition for SAP Commerce: The Views That Actually Communicate](https://www.commercecloudintegrations.com/guides/solution-architecture-definition-guide) [Documenting a commerce architecture without a doorstop: the multi-view structure, the reference-not-repeat discipline, and mapping decisions to the NFRs.](https://www.commercecloudintegrations.com/guides/solution-architecture-definition-guide) [Intermediate\ / 8 min read](https://www.commercecloudintegrations.com/guides/solution-architecture-definition-guide) 3. ### [Multi-Site and Multi-Storefront Architecture on SAP Commerce Cloud](https://www.commercecloudintegrations.com/guides/multi-site-and-multi-storefront-architecture) [Multi-site SAP Commerce architecture with BaseSite, BaseStore, catalogs, storefront resolution, CCv2 apps, webroots, cookies, and DNS.](https://www.commercecloudintegrations.com/guides/multi-site-and-multi-storefront-architecture) [Advanced\ / 7 min read](https://www.commercecloudintegrations.com/guides/multi-site-and-multi-storefront-architecture) 4. ### [Running a Marketplace on SAP Commerce: Vendors, Suborders, and Controlling an Experience You Do Not Own](https://www.commercecloudintegrations.com/guides/marketplace-commerce-architecture) [The architecture and operating model for a marketplace: the vendor portal, content governance, order splitting into suborders, and the support triangle.](https://www.commercecloudintegrations.com/guides/marketplace-commerce-architecture) [Advanced\ / 8 min read](https://www.commercecloudintegrations.com/guides/marketplace-commerce-architecture) 5. ### [Omnichannel Architecture on SAP Commerce: From Strategy Slide to Working System](https://www.commercecloudintegrations.com/guides/omnichannel-commerce-architecture) [Turning omnichannel ambition into SAP Commerce mechanics: the data domains that must unify first, cross-channel services, customer identity, and ASM.](https://www.commercecloudintegrations.com/guides/omnichannel-commerce-architecture) [Intermediate\ / 7 min read](https://www.commercecloudintegrations.com/guides/omnichannel-commerce-architecture) 6. ### [Inventory Models and Availability in SAP Commerce: Deposit, Dropship, Consignment, Cross-Dock](https://www.commercecloudintegrations.com/guides/inventory-and-availability-strategies) [How the inventory model becomes sourcing logic and stock feeds: deposit, dropship, consignment, and cross-dock, the multi-model reality, and platform mechanics.](https://www.commercecloudintegrations.com/guides/inventory-and-availability-strategies) [Intermediate\ / 9 min read](https://www.commercecloudintegrations.com/guides/inventory-and-availability-strategies) 7. ### [Store-Specific Pricing: From Variant Workaround to Price Engine Customization](https://www.commercecloudintegrations.com/guides/store-specific-pricing) [Store-specific SAP Commerce pricing with variant products or custom price-engine work across storefront context, OCC, PDTRow, and Solr.](https://www.commercecloudintegrations.com/guides/store-specific-pricing) [Expert\ / 9 min read](https://www.commercecloudintegrations.com/guides/store-specific-pricing) 8. ### [Personalization in SAP Commerce: Customizations, Segments, and Who Decides What a Shopper Sees](https://www.commercecloudintegrations.com/guides/personalization-in-sap-commerce) [The native personalization module explained: customizations, variations, and triggers, segment providers, SmartEdit, the cache cost, and rule-based versus AI.](https://www.commercecloudintegrations.com/guides/personalization-in-sap-commerce) [Advanced\ / 8 min read](https://www.commercecloudintegrations.com/guides/personalization-in-sap-commerce) 9. ### [Product Recommendations for SAP Commerce: Scenarios, Algorithms, and Making Them Earn Their Placement](https://www.commercecloudintegrations.com/guides/intelligent-selling-services-recommendations) [Recommendations as a measured program: mapping scenarios to the buyer journey, the algorithm families, data quality, Intelligent Selling Services, and caching.](https://www.commercecloudintegrations.com/guides/intelligent-selling-services-recommendations) [Intermediate\ / 10 min read](https://www.commercecloudintegrations.com/guides/intelligent-selling-services-recommendations) 10. ### [The Unified Customer Profile: Architecture for Knowing Who Your Customer Actually Is](https://www.commercecloudintegrations.com/guides/unified-customer-profile-strategy) [Why the 360-degree customer view is a data-architecture decision: the silo problem, a governed profile at the center, consent, and online-to-offline identity.](https://www.commercecloudintegrations.com/guides/unified-customer-profile-strategy) [Intermediate\ / 9 min read](https://www.commercecloudintegrations.com/guides/unified-customer-profile-strategy) 11. ### [B2B Commerce Adoption: Why Buyers Ignore the Portal You Built, and How to Fix It](https://www.commercecloudintegrations.com/guides/b2b-commerce-adoption-playbook) [The three differences that make B2B digital hard (committee buying, job-performance stakes, layered security) and the commerce capabilities that clear each.](https://www.commercecloudintegrations.com/guides/b2b-commerce-adoption-playbook) [Introductory\ / 7 min read](https://www.commercecloudintegrations.com/guides/b2b-commerce-adoption-playbook) 12. ### [Internationalization in SAP Commerce: Global Versus Local, Decided Per Concern](https://www.commercecloudintegrations.com/guides/internationalization-in-sap-commerce) [SAP Commerce internationalization for catalogs, content, pricing, taxes, payments, fulfilment, search, and country architecture.](https://www.commercecloudintegrations.com/guides/internationalization-in-sap-commerce) [Advanced\ / 10 min read](https://www.commercecloudintegrations.com/guides/internationalization-in-sap-commerce) 13. ### [SAP Commerce for the Chinese Market: A Different Project, Not a Different Locale](https://www.commercecloudintegrations.com/guides/sap-commerce-for-the-chinese-market) [Why China is an architecture decision, not a locale: data residency, ICP filing, marketplace strategy, WeChat, Alipay and WeChat Pay, and Baidu SEO.](https://www.commercecloudintegrations.com/guides/sap-commerce-for-the-chinese-market) [Advanced\ / 9 min read](https://www.commercecloudintegrations.com/guides/sap-commerce-for-the-chinese-market) 14. ### [Staffing a SAP Commerce Project: The Roles You Need and When You Need Them](https://www.commercecloudintegrations.com/guides/staffing-a-sap-commerce-team) [Who has to be on a commerce delivery team: oversight, day-to-day and SME roles, the business representative who decides, and how team shape shifts by phase.](https://www.commercecloudintegrations.com/guides/staffing-a-sap-commerce-team) [Introductory\ / 7 min read](https://www.commercecloudintegrations.com/guides/staffing-a-sap-commerce-team)