Create a listing
Layer your shelf price on a network offer you are permitted to sell.
Create a listing
A listing is your shelf entry. It references an offer you are permitted to sell and adds your own
shelf_price. The offer's seller_price is untouched — the two prices are independent layers.
1. Find offers you may sell
curl "https://api.wine2you.shop/v1/offers?country=CH&page_size=50" \
-H "Authorization: Bearer $W2Y_KEY"
The API returns only offers your entity is permitted to see (shareable + country/seller permissions). If an offer is absent, you are not permitted — there is no way to force it.
2. Create the listing
curl -X POST https://api.wine2you.shop/v1/listings \
-H "Authorization: Bearer $W2Y_KEY" -H "Content-Type: application/json" \
-d '{
"offer_id": "off_...",
"shelf_price": { "amount": 24.90, "currency": "CHF" },
"channel_id": "ch_..."
}'
3. List your listings
curl "https://api.wine2you.shop/v1/listings?channel_id=ch_...&page_size=50" \
-H "Authorization: Bearer $W2Y_KEY"
Notes
- A listing without a permitted offer is rejected (
403). - Deleting an offer removes dependent listings (cascade) — handle the webhook
offer.deleted. - Listing state is per channel: the same offer may be listed in several channels at different shelf prices.