Shelf price
Set your retail-facing price and understand how it relates to the offer's seller price.
Shelf price
Your shelf price is what your customers see. It sits on the listing and is entirely yours โ the
Originator's seller_price is a separate value that feeds the platform's landed-cost formula.
Two prices, never conflated
| Price | Lives on | Set by | Purpose |
|---|---|---|---|
seller_price |
offer | Originator | the P_B2B input to the pricing formula |
shelf_price |
listing | Seller | your retail-facing price |
Set or update
curl -X PATCH https://api.wine2you.shop/v1/listings/lst_... \
-H "Authorization: Bearer $W2Y_KEY" -H "Content-Type: application/json" \
-d '{"shelf_price": { "amount": 27.50, "currency": "CHF" }}'
Pricing guidance
If you want the platform to compute a compliant landed cost (duties + VAT included), use the quote endpoint and add your margin on top:
curl -X POST https://api.wine2you.shop/v1/orders/quote-calculate \
-H "Authorization: Bearer $W2Y_KEY" -H "Content-Type: application/json" \
-d '{"offer_id":"off_...","quantity":6,"destination":{"country":"CH"},"origin_location_id":"loc_..."}'
The response breaks down P_B2B + R_Recruiter + M_Curator + F_Platform + C_Freight + E_Excise + V_VAT so you can
price transparently.