Skip to main content
An offer is how a seller actually sells something. While products form a shared master catalog, an offer binds one seller to one product variant with the seller’s own commercial terms: SKU, price, stock, and shipping profile. Many sellers can hold offers against the same variant, each competing on price and availability.

​
Data model

The (seller_id, sku) pair is unique: a seller cannot list the same SKU twice.

​
Relationships

Offers sit at the center of the seller’s commercial graph. Module links connect each offer to:
  • Seller — the listing owner
  • Product and variant — the master catalog entry
  • Price — offer-scoped pricing (see below)
  • Inventory item — offer-scoped stock (see below)
  • Shipping profile — how the offer ships
  • Cart and order line items — which offer a purchased line came from

​
Offer-scoped pricing

Offers share the variant’s price set, scoped by an offer rule — each offer carries its own prices without duplicating the variant. The storefront computes a calculated_price per offer, so two sellers listing the same variant can show different prices side by side.

​
Offer-scoped inventory

Inventory is linked to the offer, not the variant. Each seller manages stock for their own listing independently; a variant has no marketplace-wide stock figure of its own.
When working with offer orders, read inventory through the offer link. The variant’s own inventory_items relation is empty for offer-based listings.

​
Offers at checkout

When a customer buys, the cart line item links to the specific offer that was purchased. The link is preserved onto the order line item, so fulfillment, commission calculation, and payouts all resolve to the right seller — even when several sellers list the same variant.

​
Discovery

The Store API exposes offers directly:
This powers “buy box”-style storefronts: fetch a product from the shared catalog, then list every seller’s offer against it with per-offer calculated prices.

​
Where offers appear

​
Next steps

Products

The shared master catalog offers are built on.

Order Groups

How multi-seller purchases split into per-seller orders.