v

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.

Next steps

Edit this page on GitHub โ†—