Ecommerce
Unified read surface across e-commerce / storefront / OMS platforms. 176 adapters. Reference adapter: shopify.
Canonical schema
Section titled “Canonical schema”| Resource | Purpose |
|---|---|
Product |
Storefront products (parent SKUs). |
Variant |
Product variants / SKUs (size / colour / option permutations). |
Collection |
Product collections / categories used for merchandising. |
Location |
Warehouses / fulfilment locations / pickup points. |
InventoryLevel |
Stock-on-hand per (location, variant). |
Customer |
Storefront customers (the merchant’s buyers). |
Order |
Storefront orders. |
Fulfillment |
Order fulfilments / shipments. |
Refund |
Refunds against storefront orders. |
Transaction |
Payment transactions on storefront orders. |
Discount |
Discount codes / promotions. |
Endpoints
Section titled “Endpoints”| Verb | Path | Notes |
|---|---|---|
| GET | /v1/ecommerce/products |
Storefront products. |
| GET | /v1/ecommerce/variants |
Variants / SKUs. |
| GET | /v1/ecommerce/collections |
Categories. |
| GET | /v1/ecommerce/locations |
Fulfilment locations. |
| GET | /v1/ecommerce/inventory_levels |
Stock-on-hand. |
| GET | /v1/ecommerce/customers |
End customers. |
| GET | /v1/ecommerce/orders |
Orders. |
| GET | /v1/ecommerce/fulfillments |
Shipments. |
| GET | /v1/ecommerce/refunds |
Refunds. |
| GET | /v1/ecommerce/transactions |
Payments on orders. |
| GET | /v1/ecommerce/discounts |
Promotions. |
Distinct from inventory
Section titled “Distinct from inventory”Ecommerce models the storefront view (orders, customers, fulfilments) anchored to Shopify’s richer shapes. The inventory vertical models the stock-of-record view (PO → SKU → location quantities) anchored to inventory-management platforms. Both can coexist for a single merchant via separate connection_ids.
Refused at the schema level
Section titled “Refused at the schema level”- Product images / 3D assets / video files
- Storefront customer PII beyond name + email + shipping address
- Raw card / wallet payment data
- Storefront theme code / template files
Authentication
Section titled “Authentication”Tenant mode (Authorization: Bearer os_…). Each /v1/ecommerce/* request requires connection_id. Most platforms use OAuth 2.0; some use API key or Basic. See docs/dev-api.md.
opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.