Order group links

Mercur modules never reference each other directly, so an order group reaches carts and orders through module links. Two links start at the group. Two more, on the child orders, connect each order to its seller and each order line item to its offer. All four are defined in packages/core/src/links/, and checkout creates their rows when it splits a cart.

Order group to order

Connects a group to its child orders, one per seller.


Sides	`OrderGroup` (Seller module) and `Order` (Order module)
Cardinality	One group to many orders
Table	`order_group_order`
Defined in	`order-group-order-link.ts`

const { data: [group] } = await query.graph({
  entity: "order_group",
  fields: ["id", "display_id", "orders.id", "orders.total"],
  filters: { id: "og_01JD8Q1234567" },
})

To go from an order to its group, query the link entity directly:

const { data: [row] } = await query.graph({
  entity: "order_group_order",
  fields: ["order_group_id"],
  filters: { order_id: "order_01JD8Q1234568" },
})

Order group to cart

Exposes the completed cart a group was created from. The link is read-only: it reads the group’s cart_id column and has no table of its own.


Sides	`OrderGroup.cart_id` (Seller module) and `Cart` (Cart module)
Cardinality	One group to one cart
Table	None, `readOnly: true`
Defined in	`order-group-cart-link.ts`

const { data: [group] } = await query.graph({
  entity: "order_group",
  fields: ["id", "cart.id", "cart.email", "cart.completed_at"],
  filters: { id: "og_01JD8Q1234567" },
})

You can’t create or dismiss this link with link.create or link.dismiss. It changes only if cart_id changes, and Mercur never updates it.

Order to seller

Connects each child order to the seller who fulfills it.


Sides	`Order` (Order module) and `Seller` (Seller module)
Cardinality	Many orders to one seller
Link entity	`order_seller`
Defined in	`order-seller-link.ts`

const { data: [group] } = await query.graph({
  entity: "order_group",
  fields: ["id", "orders.id", "orders.seller.id", "orders.seller.name"],
  filters: { id: "og_01JD8Q1234567" },
})

getOrderGroupsListWorkflow reads orders.seller.id to trim each group to one seller when you pass sellerId.

Order line item to offer

Records which offer each order line item was bought from. Checkout copies it from the matching cart line item’s offer link.


Sides	`OrderLineItem` (Order module) and `Offer` (Offer module)
Cardinality	Many order line items to one offer
Defined in	`order-line-item-offer-link.ts`

const { data: [group] } = await query.graph({
  entity: "order_group",
  fields: ["id", "orders.items.id", "orders.items.offer.id"],
  filters: { id: "og_01JD8Q1234567" },
})

The line item side is a list, so one offer can back line items in any number of orders and groups.

Links checkout creates for each order

Besides the links above, completeCartWithSplitOrdersWorkflow creates these rows for every child order:

Order to cart: Medusa’s own link from each child order to the completed cart
Order to promotion: for each promotion owned by the order’s seller
Seller to customer: when the customer hasn’t bought from that seller before

Store

Catalog

Offer

Attribute

Product Edit

Order Group

Commission

Payout

Review

Order group to order

Order group to cart

Order to seller

Order line item to offer

Links checkout creates for each order

​Order group to order

​Order group to cart

​Order to seller

​Order line item to offer

​Links checkout creates for each order

Order group to order

Order group to cart

Order to seller

Order line item to offer

Links checkout creates for each order