Wino API: developer documentation

The API to

Manage the catalog and the stock

Read and update shops, products, variants, prices and stock levels, with a history of every stock movement.

Products, variants and their prices
Stock levels and stock movements
Suppliers and the variants they supply

catalog.graphql
query VariantStock {
  variant(id: "96835dcb-…") {
    name
    stock {
      rawQuantity
    }
    stockActivities(first: 10) {
      edges {
        node { kind quantity comment }
      }
    }
  }
}

The API to

Follow the sales and the cash registers

Read the receipts, invoices and credit notes of every shop, and the closing reports of each cash register.

Receipts, quotes, invoices and credit notes
Customers and their loyalty points
Cash movements and closing reports

Read about sales documents →

sales.graphql
query SalesOfPeriod(
  $shopId: String!
  $from: Datetime!
  $to: Datetime!
) {
  salesReceipts(
    first: 50
    filterBy: {
      shopIds: { _in: [$shopId] }
      createdAt: { _between: [$from, $to] }
    }
  ) {
    edges {
      node { name createdAt totalAmountIncludingTaxes }
    }
  }
}

The API to

Be notified as soon as data changes

Subscribe to webhooks and Wino sends a request to your URL each time a product, a customer or a sale changes.

One subscription per shop
Choose the kinds of data you follow
A secret of yours in every notification

Set up webhooks →

POST https://example.com/wino-webhooks
{
  "kind": "Variant",
  "source": {
    "shopId": "20258224-…",
    "deviceId": "b1fd5f30-…"
  },
  "data": {
    "id": "4e584c64-…",
    "…": "the properties of the variant"
  },
  "clientState": "<a secret of yours>"
}