API Wino : documentation développeurs

L'API pour

Gérer le catalogue et le stock

Lisez et modifiez les boutiques, les produits, les variantes, les prix et les niveaux de stock, avec l'historique de chaque mouvement de stock.

Les produits, les variantes et leurs prix
Les niveaux et les mouvements de stock
Les fournisseurs et les variantes qu'ils fournissent

Découvrir le catalogue →

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

L'API pour

Suivre les ventes et les caisses

Lisez les tickets, les factures et les avoirs de chaque boutique, et les rapports de clôture de chaque caisse.

Les tickets, devis, factures et avoirs
Les clients et leurs points de fidélité
Les mouvements de caisse et les rapports de clôture

Découvrir les documents de vente →

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 }
    }
  }
}

L'API pour

Être notifié dès qu'une donnée change

Abonnez-vous aux webhooks : Wino envoie une requête à votre URL chaque fois qu'un produit, un client ou une vente change.

Un abonnement par boutique
Choisissez les types de données à suivre
Un secret à vous dans chaque notification

Configurer les 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>"
}