v
Home

Orders & inventory API reference

Orders, quotes, pickups, inventory and the network snapshot.

Orders & inventory API reference

Base URL: https://api.wine2you.shop · Auth: Authorization: Bearer <key>

Orders

Method Path Purpose
POST /v1/orders/quote-calculate landed-cost quote (duties + VAT included)
POST /v1/orders create an order
GET /v1/orders list orders your entity participates in
GET /v1/orders/{id} retrieve one order
POST /v1/orders/{id}/cancel cancel an order
GET /v1/orders/{id}/documents retrieve order documents

Pickups

Method Path Purpose
POST /v1/pickups request pickup for an order
POST /v1/pickups/{id}/accept accept a pickup

Inventory

Method Path Purpose
POST /v1/locations declare a stock location
POST /v1/inventory declare inventory for a variant at a location
PATCH /v1/inventory/{id} update quantity
GET /v1/inventory/network-snapshot whole-network node + stock + duty context — requires read:network

network-snapshot is the one whole-network read. Ordinary partner keys do not receive read:network; a key without it gets 403. Use the scoped list endpoints for normal integration work.

Quote response shape

{
  "currency": "CHF",
  "components": {
    "P_B2B": 18.50, "R_Recruiter": 1.20, "M_Curator": 2.10,
    "F_Platform": 0.90, "C_Freight": 6.00, "E_Excise": 0.00, "V_VAT": 2.48
  },
  "total": 31.18
}

Related

Edit this page on GitHub ↗