Shopify Legacy Connector (SLC)

Appearance

Shopify Legacy Connector (SLC) ​

SLC — Shopify Legacy Connector

Contract-only documentation for the Shopify Legacy Connector (SLC).

Status ​

  • Implementation: complete (all 24 admin actions, outbound sync, inbound events, operational scheduled jobs)
  • OpenAPI: /slc/openapi.yaml

Scope ​

  • Connects g3nretailstack to Shopify stores via two channel types: Standard (full product lifecycle) and Custom (variant-level updates only).
  • Config-driven: ~45 behavioral flags per standard channel replace legacy SVP/Primary flavour split.
  • Outbound: event-driven PVM/ICS/PPM → Shopify sync via SQS.
  • Inbound: Shopify EventBridge order/restock events → ICS stock card adjustments.
  • Operational: daily credential health checks, drift detection.

Clarifications ​

  • Channel types: Standard creates/updates/archives full Shopify products (tags, options, pricing, inventory). Custom updates variant-level fields only (price, inventory, cost, barcode).
  • Credential modes: Static (legacy non-expiring tokens) and Expiring (Shopify Dec 2025 feature — 1h access + 90d refresh tokens).
  • Variant scope: Explicit (inclusion list) or Rules-based (supplier/category rules).
  • Throttle handling: Lambda exits on Shopify throttle, changes SQS visibility timeout, retries later.
  • Audit trail: DDB (queryable, 90d TTL) + S3 (full payloads, 1yr lifecycle).