Data Flow Architecture

Complete visualization of how data moves through the NULogic SFCC Headless Pro ecosystem

Commerce Data Flow Map

Interactive diagram showing all data entities and how they flow through the headless commerce platform.

Product Data Flow

Product catalog, images, variations, and pricing flow from SFCC Business Manager through SCAPI to the PWA frontend, with CDN caching for fast delivery.

Customer Data Flow

Customer profiles, addresses, preferences, and payment methods are securely transmitted through SCAPI with session-based caching for authentication.

Order Data Flow

Order creation, basket management, shipments, and returns flow bidirectionally, with real-time updates ensuring consistency across all touchpoints.

Analytics Data Flow

Page views, events, conversions, and session data flow from PWA to analytics platforms and data warehouse for insights and personalization.

API Endpoint Map

Interactive table showing all critical SCAPI endpoints used by the NULogic accelerator with data flow and caching strategies.

API / Endpoint	Method	Data Flow	Caching	Used By	Details
ShopperProducts /products/{id}	GET	SFCC → SCAPI → PWA	CDN 5min	PDP, PLP, Search Results	View Details ↓
Request: GET /products/PRODUCT123?expand=images,variations,prices Response: { id, name, description, price, imageGroups[], variationAttributes[], custom: {...} } Rate Limit: 500 req/min \| Auth: OAuth2 \| NULogic: Used for PDP render, cached for performance
ShopperSearch /product-search	GET	SFCC → SCAPI → PWA	CDN 2min	PLP, Search Page, Facets	View Details ↓
Request: GET /product-search?q=shoes&facets=size,color&limit=20&offset=0 Response: { total, offset, count, hits[], facets[], sortingOptions[] } Rate Limit: 400 req/min \| Auth: OAuth2 or JWT \| NULogic: Integrates with Algolia/Bloomreach for enhanced search
ShopperBaskets /baskets	GET/POST	Bidirectional ↔ Real-time	No cache	Cart, Checkout, Mini-cart	View Details ↓
Requests: POST /baskets/{basketId}/items PUT /baskets/{basketId}/items/{itemId} Response: { basketId, agent_id, currency_code, customerInfo, items[], totals[], shippingMethods[] } Rate Limit: 100 req/min \| Auth: OAuth2 + Guest \| NULogic: Real-time cart state synced to Ask Alex iframe
ShopperCustomers /customers/{id}	GET	SFCC → SCAPI → PWA	Session cache	Account Page, Profile, Orders	View Details ↓
Request: GET /customers/CUSTOMER123?expand=addresses,payment_instruments Response: { id, login, firstName, lastName, email, addresses[], payment_instruments[], custom: {...} } Rate Limit: 300 req/min \| Auth: OAuth2 (requires login) \| NULogic: Used for account dashboard, cached for authenticated sessions
ShopperOrders /orders	GET	SFCC → SCAPI → PWA	No cache	Order History, Order Details	View Details ↓
Request: GET /orders?customerId=CUSTOMER123&expand=product_items,shipments Response: { hits: [ { orderNo, orderDate, status, product_items[], shipments[], totals[] } ] } Rate Limit: 200 req/min \| Auth: OAuth2 \| NULogic: Real-time order tracking, never cached to ensure current status
ShopperLogin /authorize	POST	Bidirectional ↔ Real-time	No cache	Authentication, JWT Generation	View Details ↓
Request: POST /authorize { type: 'credentials', username: 'user@example.com', password: '*' } Response: { access_token, expires_in, refresh_token, customerId, ... } Rate Limit: 50 req/min \| Auth: Client Credentials \| NULogic:** Manages OAuth2 flow, tokens stored securely in httpOnly cookies
Einstein Recommendations /recommendations	GET	SFCC → PWA	CDN 10min	PDP Recs, Home Banners, Email	View Details ↓
Request: GET /recommendations?recommenderName=pdp_recs&productId=PRODUCT123&limit=4 Response: { recommendedProducts: [ { id, name, image, price, ... } ] } Rate Limit: 600 req/min \| Auth: Einstein API Key \| NULogic: Powers personalized recommendations, cached to reduce API calls to Einstein

Caching Strategy Visualization

Multi-layer caching architecture ensuring optimal performance at every level of the data stack.

Layer 1: Browser Cache

Service Worker

PWA shell, static assets

React Query

API responses, 5min TTL

Local Storage

Cart state, user session

IndexedDB

Offline product data

Layer 2: CDN Edge Cache (Managed Runtime)

SSR HTML

ISR: 60s (category), 300s (home)

Static Assets

JS, CSS, images: 1 year

API Proxy

SCAPI responses: 2-5min

Geo-distributed

Served from nearest edge

Layer 3: SCAPI Cache

Product Data

5-10min TTL

Search Index

2min TTL

Einstein Models

10min TTL

Catalog Metadata

30min TTL

Layer 4: SFCC Application Cache

Business Manager

Object cache, system-wide

Custom Caches

Partitioned by domain

Session Cache

Per-user auth data

Database Cache

Query results, indexed

Cache Hit vs. Miss Flow

Real-Time Data Sync

Animated visualization showing how data stays in sync across the entire platform.

Scenario 1: Product Price Update

< 5 minutes

Step 1

Merchandiser updates product price in SFCC Business Manager admin console

Step 2 (immediate)

SFCC invalidates product cache for all related SKUs and catalog categories

Step 3 (< 1min)

Next SCAPI ShopperProducts request gets fresh data from SFCC

Step 4 (1-2min)

CDN edge cache expires (TTL), serves fresh product data on next request

Step 5 (2-5min)

PWA Kit re-renders product pages, customers see updated price on next page load

Scenario 2: Customer Adds to Cart

< 200ms

Step 1 (0ms)

Customer clicks "Add to Cart" button on PWA Kit product page

Step 2 (1ms)

React dispatches Redux/Zustand action, optimistic update shows item in cart

Step 3 (5ms)

SCAPI ShopperBaskets.addItemToBasket() called with authentication token

Step 4 (50-100ms)

SFCC processes request, creates/updates basket, returns updated totals and items

Step 5 (150ms)

PWA mini-cart updates with confirmed item count, totals, and user notification

Step 6 (200ms)

NULogic AI Agent Bridge syncs cart state to Ask Alex iframe for live assistance

Integration Data Flows

How external systems integrate and exchange data with the headless commerce platform.

💳

Payment Processing

Secure payment tokenization and processing

Browser → Stripe/Adyen

PWA → SCAPI → Gateway

SCAPI → SFCC

Card data never touches SFCC. Token passed to gateway for auth/capture.

📊

Analytics & Tracking

Comprehensive event tracking and analytics

PWA Events → GA4

Analytics Layer → GTM

Events → DW Analytics

Page views, ecommerce events, custom conversions tracked in real-time.

🔍

Search Platform

Powered search and faceting

SFCC Catalog → Feed Export

Algolia → PWA Queries

Results → Faceted Display

Syncs every product update. Powers search, filtering, autocomplete.

📝

Headless CMS

Content creation and delivery

CMS Content → API

PWA Build/Runtime → Fetch Content

React Components → Rendered Pages

Contentful, Sanity, or Strapi. Fetched at build time or runtime.

✉️

Email & Marketing

Marketing automation and email delivery

SFCC Events → Service

Klaviyo/SendGrid → Segmentation

Automation → Customer Inbox

Order confirmations, abandoned cart, post-purchase campaigns.

🤖

AI & Personalization

ML-driven recommendations and personalization

Einstein AI → Recommendations

Behavioral Data → Models

Ask Alex → Live Assistance

Powers product recommendations, personalized experiences, AI chatbot.

Performance & Optimization Insights

Fastest Paths

✓ Browser cache hit: ~10ms
✓ Add to cart (optimistic): ~200ms
✓ CDN served HTML: ~50-100ms
✓ Static asset delivery: ~20-30ms

Critical Optimizations

• ISR for category pages (60s refresh)
• React Query caching for API responses
• Service Worker offline support
• CDN edge caching for API proxies

Real-Time Capabilities

• Basket updates: bidirectional sync
• Order tracking: zero cache TTL
• Payment processing: direct gateway
• Analytics: event dispatch on action

Data Freshness SLAs

• Product data: < 5 minutes
• Search index: < 2 minutes
• Order status: real-time
• Pricing: < 1 minute

This diagram represents the complete data flow architecture for NULogic's SFCC Headless Pro implementation. All timings are typical values and may vary based on network conditions and system load.

Last updated: 2026-03-30 | Architecture v2.0