Create an offer

Attach stock and a seller price to a canonical wine.

Create an offer

An offer is your willingness to sell a wine: how much stock, at what price, and under what conditions. It is distinct from the wine (descriptive) and from a listing (a Seller's shelf price).

curl -X POST https://api.wine2you.shop/v1/offers \
  -H "Authorization: Bearer $W2Y_KEY" -H "Content-Type: application/json" \
  -d '{
    "wine_id": "win_...",
    "stock": 120,
    "seller_price": { "amount": 18.50, "currency": "EUR" },
    "network_shareable": true,
    "permissions": { "allowed_countries": ["DE","CH"], "named_sellers": [], "default": "none" }
  }'

The seller price

seller_price is the price you are willing to sell at — the value that feeds the platform's pricing formula as P_B2B. It is not the end-consumer price; downstream layers (recruiter/curator margin, platform fee, freight, excise, VAT) are added by the pricing engine.

`network_shareable`

Set true to make the offer visible on the network at all. An offer that is not shareable is invisible to every partner that is not your own entity — this is enforced on the read path, not just in the UI. See Data-exposure controls.

`permissions`

Who may sell this offer, and where — see Set permissions. Defaults to default: "none" if you omit it, which means only named sellers / allowed countries may sell.

Update stock

curl -X PATCH https://api.wine2you.shop/v1/offers/off_... \
  -H "Authorization: Bearer $W2Y_KEY" -H "Content-Type: application/json" \
  -d '{"stock": 84}'

Next steps

Set permissions
Data-exposure controls — how sharing is enforced

Edit this page on GitHub ↗