{"openapi":"3.0.3","info":{"title":"API Wanapos","version":"1.0.0","description":"API réservée aux clients Wanapos, pour lire et gérer les données de leur compte depuis leurs propres outils ou depuis une IA.\n\n## Authentification\nChaque appel porte une clé d'API dans l'en-tête `Authorization: Bearer VOTRE_CLE`. Une clé se crée dans les paramètres du compte Wanapos, par le titulaire du compte. Elle commence par `wps_` et n'est affichée qu'une seule fois. Ne placez jamais une clé dans une URL : l'appel est refusé.\n\n## Permissions\nChaque clé porte une liste de permissions (par exemple `read_customers`). Seules les permissions listées dans cette documentation existent : chacune correspond à au moins une adresse disponible. Une donnée sans permission listée (le stock, par exemple) n'est pas encore accessible par l'API. Les ventes ne se lisent pour l'instant qu'à travers les achats d'un client. Un appel qui exige une permission absente de la clé renvoie l'erreur `missing_scope`, qui nomme la permission manquante. `GET /v1/me` liste les permissions de la clé utilisée.\n\n## Quotas\nLes quotas sont comptés par compte : 60 appels par minute, 5 000 lectures et 1 000 écritures par jour (remise à zéro à minuit, heure de Paris). Chaque réponse porte les en-têtes `RateLimit-Limit`, `RateLimit-Remaining` et `RateLimit-Reset` (secondes avant remise à zéro). Un dépassement renvoie le statut 429 avec l'en-tête `Retry-After` : attendez ce nombre de secondes avant de reprendre.\n\n## Format des réponses\nLes réponses sont en JSON, encodé en UTF-8, de même que le corps des appels qui en envoient un (avec l'en-tête `Content-Type: application/json`). Deux exceptions, qui décrivent l'API elle-même : `GET /v1/documentation.md` renvoie du texte (Markdown), et `GET /v1/openapi.json` renvoie du JSON sans l'enveloppe `data`.\n\nUn succès renvoie `{\"data\": …, \"meta\": {\"request_id\": \"…\"}}` : `data` porte le résultat (un objet ou une liste), `meta` les informations sur la réponse.\n\nUne erreur renvoie toujours la forme suivante, avec ces six champs :\n\n```json\n{\n  \"error\": {\n    \"code\": \"missing_scope\",\n    \"message\": \"Cette clé n'a pas la permission « export_customers » (« Exporter tout le fichier clients »).\",\n    \"hint\": \"Le titulaire du compte peut ajouter cette permission à la clé dans les paramètres de son compte Wanapos, ou créer une nouvelle clé qui la porte. Les permissions de la clé actuelle sont listées par GET /v1/me.\",\n    \"field\": \"export_customers\",\n    \"details\": [],\n    \"request_id\": \"3f9a1c0b7d2e4a61\"\n  }\n}\n```\n\n`code` est un texte stable, à tester dans un programme. `message` dit ce qui ne va pas et `hint` comment corriger, tous deux en français. `field` nomme le paramètre, le champ ou la permission en cause (chaîne vide sinon). `details` est une liste, vide le plus souvent : quand plusieurs champs d'un envoi sont refusés, elle porte un objet par champ, de la forme `{\"field\": \"…\", \"message\": \"…\"}`.\n\nAucune valeur n'est jamais `null` : une information absente vaut une chaîne vide, 0, false ou une liste vide. Les dates sont au format ISO 8601. Les champs des données métier (clients, produits…) portent les noms utilisés dans Wanapos, en français, identiques à ceux des événements sortants : un objet reçu par un événement et le même objet lu par l'API ont la même forme.\n\n## Écritures\nSeules les adresses dont la documentation dit qu'elles comptent comme une écriture modifient des données (aujourd'hui : la création et la modification de client, l'ajustement des points de fidélité, la création de produit). Toutes les autres lisent, sans rien modifier. Une écriture est enregistrée en entier ou pas du tout : en cas d'erreur, rien n'est modifié. Les appels qui modifient des données acceptent deux protections. Le paramètre `?dry_run=true` valide tout sans rien enregistrer. L'en-tête `Idempotency-Key` (un identifiant unique de votre choix) garantit qu'une requête renvoyée après une coupure n'est pas exécutée deux fois."},"servers":[{"url":"https://api.wanapos.com","description":"Production"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Compte","description":"Le compte, la clé utilisée, les magasins avec leurs points de caisse, et les utilisateurs."},{"name":"Clients","description":"Fichier clients du compte.","x-wanapos-object":"Customer","x-wanapos-object-label":"Le client"},{"name":"Fidélité","description":"Programme de fidélité du compte et points des clients. Le solde de points d'un client se lit dans sa fiche (`fidelite.points_actuels`)."},{"name":"Produits","description":"Catalogue du compte : produits, variantes, codes et prix. Le stock n'en fait pas partie.","x-wanapos-object":"Product","x-wanapos-object-label":"Le produit"},{"name":"Classements","description":"Ce qui sert à ranger les produits : fournisseurs, collections, catégories et listes personnalisées. Un produit désigne ses classements par leur identifiant. Ils se lisent avec la permission `read_products`, se créent et se modifient avec `write_products`. Il n'y a pas de suppression : un classement s'archive."},{"name":"Référentiels","description":"Listes de référence du compte : moyens de paiement, promotions, champs de la fiche client, pays. Elles servent à traduire les identifiants et les valeurs rencontrés dans les autres réponses."},{"name":"Technique","description":"Description technique de l'API."}],"paths":{"/v1/me":{"get":{"operationId":"getMe","x-wanapos-slug":"compte-et-cle","tags":["Compte"],"summary":"Compte, magasins, permissions et quotas de la clé utilisée","description":"Premier appel à faire. Indique à quel compte la clé est rattachée, la liste de ses magasins (leurs identifiants servent dans les autres appels), les permissions de la clé, l'état des quotas et les plafonds à respecter.\n\nAucune permission particulière n'est requise : toute clé valide peut appeler cette adresse. L'appel compte dans le quota de lecture.","responses":{"200":{"description":"Informations du compte et de la clé.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"},"example":{"data":{"account":{"id":1451,"name":"Ma boutique","currency":"EUR","timezone":"Europe/Paris"},"shops":[{"id":1,"name":"Magasin principal","active":true}],"api_key":{"name":"Mon assistant IA","hint":"wps_Ab3d…x9Kq","scopes":["read_customers"],"created_at":"2026-11-10T14:30:00+01:00"},"quotas":{"per_minute":{"limit":60,"remaining":59,"reset_at":"2026-11-10T14:31:00+01:00"},"reads_per_day":{"limit":5000,"remaining":4999,"reset_at":"2026-11-11T00:00:00+01:00"},"writes_per_day":{"limit":1000,"remaining":1000,"reset_at":"2026-11-11T00:00:00+01:00"}},"limits":{"max_page_size":100,"default_page_size":50,"max_items_per_write":50,"max_body_bytes":1048576},"api":{"version":"v1","documentation_url":"https://wanapos.com/api"}},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-wanapos-scope":"","x-wanapos-kind":"read"}},"/v1/customers":{"get":{"operationId":"listCustomersByEmail","x-wanapos-slug":"recherche-par-adresse-mail","tags":["Clients"],"summary":"Rechercher des clients par adresse mail","description":"Renvoie les clients du compte qui portent exactement cette adresse mail, sans tenir compte des majuscules ni des espaces autour.\n\nLa réponse est toujours une liste : dans Wanapos, une adresse mail n'est pas unique, plusieurs fiches clients peuvent la porter. Une liste vide signifie qu'aucun client ne correspond, ce n'est pas une erreur. Si plusieurs clients reviennent, ne choisissez pas au hasard : départagez-les avec leurs autres champs, ou demandez à l'utilisateur.\n\nLa liste est limitée à 50 clients. Si `meta.truncated` vaut `true`, plus de 50 fiches portent cette adresse mail (cas très rare) et la liste est incomplète : il n'existe pas de page suivante pour cette recherche. Pour obtenir toutes les fiches, parcourez le fichier avec `GET /v1/customers/export` et gardez celles dont le champ `email` correspond.\n\nLes clients supprimés dans l'application ne sont jamais renvoyés. Le paramètre `email` est obligatoire. Pour parcourir tout le fichier clients, utilisez `GET /v1/customers/export`.","x-wanapos-scope":"read_customers","x-wanapos-kind":"read","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string"},"description":"Adresse mail complète à rechercher (50 caractères au maximum). Pensez à l'encoder dans l'URL.","example":"claire.martin@exemple.com"}],"responses":{"200":{"description":"Liste des clients portant cette adresse mail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerListResponse"},"example":{"data":[{"id":1842,"civilite":"Mme","nom":"Martin","prenom":"Claire","nom_2":"","email":"claire.martin@exemple.com","tel":"","mobile":"0600000000","bc_ext":"","remise_pc":0,"notes":"","libre_1":"","libre_2":"","libre_3":"","custom_io_1":false,"custom_io_2":false,"custom_io_3":false,"custom_date_1":"","custom_date_2":"","custom_date_3":"","news_sms":false,"news_email":true,"fidelite_active":true,"actif":true,"id_shop_origin":1,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00","adresse":{"ligne1":"12 rue des Lilas","ligne2":"","cp":"69003","ville":"Lyon","id_pays":63,"pays_code":"FR","pays":"France","tva_intra":"","archived":false},"fidelite":{"points_actuels":120,"points_cumules":340,"nb_fois_pts_utilises":2,"last_pts_acquis":15,"total_ca":412.5,"total_qt":17,"total_pa":9},"champs_personnalises":[{"cle":"libre_1","libelle":"Customisé 1","type":"texte","affiche":false,"valeur":""},{"cle":"libre_2","libelle":"Customisé 2","type":"texte","affiche":false,"valeur":""},{"cle":"libre_3","libelle":"Customisé 3","type":"texte","affiche":false,"valeur":""},{"cle":"custom_io_1","libelle":"Customisé 1","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_2","libelle":"Customisé 2","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_3","libelle":"Customisé 3","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_date_1","libelle":"Customisé 1","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_2","libelle":"Customisé 2","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_3","libelle":"Customisé 3","type":"date","affiche":false,"valeur":""}]}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1,"truncated":false}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"createCustomer","x-wanapos-slug":"creation-d-un-client","tags":["Clients"],"summary":"Créer un client","description":"Crée un client et renvoie sa fiche complète. L'identifiant du nouveau client est dans `data.id` : conservez-le, c'est lui qui permet de relire ou de modifier ce client ensuite. Aucun champ n'est obligatoire à lui seul, mais il faut renseigner au moins un de ces champs : `nom`, `prenom`, `nom_2`, `email`, `mobile`, `tel`. Les champs absents prennent leur valeur par défaut.\n\nSi un client actif porte déjà l'adresse mail envoyée, la création est refusée avec l'erreur `duplicate_email`, qui donne les identifiants des clients existants. Ne contournez pas ce refus par réflexe : dans la plupart des cas, il faut modifier le client existant avec `PATCH /v1/customers/{id}`. Si ce sont bien deux personnes différentes qui partagent une adresse mail, renvoyez la requête avec `?allow_duplicate_email=true`. Il n'existe pas d'appel « créer ou mettre à jour » : une adresse mail n'étant pas unique dans Wanapos, l'API ne choisit jamais à votre place quelle fiche modifier.\n\nLes accords de communication `news_sms` et `news_email` valent `false` s'ils ne sont pas envoyés : n'envoyez `true` que si la personne a réellement donné son accord pour recevoir des SMS ou des mails. `fidelite_active` vaut `true` s'il n'est pas envoyé. La fidélité (points, cumuls), les dates et l'identifiant ne s'écrivent pas par cette adresse : les points s'ajustent par `POST /v1/customers/{id}/loyalty-points`.\n\nPour ne jamais créer deux fois le même client après une coupure réseau, envoyez un en-tête `Idempotency-Key`. Pour vérifier une requête sans rien enregistrer, ajoutez `?dry_run=true`.","x-wanapos-scope":"write_customers","x-wanapos-kind":"write","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"allow_duplicate_email","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour enregistrer même si un autre client actif porte déjà cette adresse mail. À n'utiliser qu'après avoir vérifié qu'il s'agit bien de deux personnes différentes."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerInput"},"example":{"email":"claire.martin@exemple.com","nom":"Martin","prenom":"Claire","civilite":"Mme","mobile":"0600000000","news_email":true,"adresse":{"ligne1":"12 rue des Lilas","cp":"69003","ville":"Lyon","pays_code":"FR"}}}}},"responses":{"201":{"description":"Le client créé, avec sa fiche complète.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerResponse"},"example":{"data":{"id":1842,"civilite":"Mme","nom":"Martin","prenom":"Claire","nom_2":"","email":"claire.martin@exemple.com","tel":"","mobile":"0600000000","bc_ext":"","remise_pc":0,"notes":"","libre_1":"","libre_2":"","libre_3":"","custom_io_1":false,"custom_io_2":false,"custom_io_3":false,"custom_date_1":"","custom_date_2":"","custom_date_3":"","news_sms":false,"news_email":true,"fidelite_active":true,"actif":true,"id_shop_origin":1,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00","adresse":{"ligne1":"12 rue des Lilas","ligne2":"","cp":"69003","ville":"Lyon","id_pays":63,"pays_code":"FR","pays":"France","tva_intra":"","archived":false},"fidelite":{"points_actuels":120,"points_cumules":340,"nb_fois_pts_utilises":2,"last_pts_acquis":15,"total_ca":412.5,"total_qt":17,"total_pa":9},"champs_personnalises":[{"cle":"libre_1","libelle":"Customisé 1","type":"texte","affiche":false,"valeur":""},{"cle":"libre_2","libelle":"Customisé 2","type":"texte","affiche":false,"valeur":""},{"cle":"libre_3","libelle":"Customisé 3","type":"texte","affiche":false,"valeur":""},{"cle":"custom_io_1","libelle":"Customisé 1","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_2","libelle":"Customisé 2","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_3","libelle":"Customisé 3","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_date_1","libelle":"Customisé 1","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_2","libelle":"Customisé 2","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_3","libelle":"Customisé 3","type":"date","affiche":false,"valeur":""}]},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/DuplicateEmail"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/customers/{id}":{"get":{"operationId":"getCustomer","x-wanapos-slug":"lecture-par-identifiant","tags":["Clients"],"summary":"Lire un client par son identifiant","description":"Renvoie la fiche complète d'un client : identité, coordonnées, adresse, consentements, fidélité et champs personnalisés.\n\nUn client supprimé dans l'application est introuvable : l'appel répond 404, comme si le client n'avait jamais existé.","x-wanapos-scope":"read_customers","x-wanapos-kind":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Identifiant du client (champ `id`).","example":1842}],"responses":{"200":{"description":"La fiche du client.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerResponse"},"example":{"data":{"id":1842,"civilite":"Mme","nom":"Martin","prenom":"Claire","nom_2":"","email":"claire.martin@exemple.com","tel":"","mobile":"0600000000","bc_ext":"","remise_pc":0,"notes":"","libre_1":"","libre_2":"","libre_3":"","custom_io_1":false,"custom_io_2":false,"custom_io_3":false,"custom_date_1":"","custom_date_2":"","custom_date_3":"","news_sms":false,"news_email":true,"fidelite_active":true,"actif":true,"id_shop_origin":1,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00","adresse":{"ligne1":"12 rue des Lilas","ligne2":"","cp":"69003","ville":"Lyon","id_pays":63,"pays_code":"FR","pays":"France","tva_intra":"","archived":false},"fidelite":{"points_actuels":120,"points_cumules":340,"nb_fois_pts_utilises":2,"last_pts_acquis":15,"total_ca":412.5,"total_qt":17,"total_pa":9},"champs_personnalises":[{"cle":"libre_1","libelle":"Customisé 1","type":"texte","affiche":false,"valeur":""},{"cle":"libre_2","libelle":"Customisé 2","type":"texte","affiche":false,"valeur":""},{"cle":"libre_3","libelle":"Customisé 3","type":"texte","affiche":false,"valeur":""},{"cle":"custom_io_1","libelle":"Customisé 1","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_2","libelle":"Customisé 2","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_3","libelle":"Customisé 3","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_date_1","libelle":"Customisé 1","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_2","libelle":"Customisé 2","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_3","libelle":"Customisé 3","type":"date","affiche":false,"valeur":""}]},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"patch":{"operationId":"updateCustomer","x-wanapos-slug":"modification-d-un-client","tags":["Clients"],"summary":"Modifier un client","description":"Modifie un client et renvoie sa fiche complète après modification.\n\nLa modification est partielle : seuls les champs envoyés changent, tous les autres sont conservés tels quels. N'envoyez donc que ce que vous voulez modifier, pas la fiche entière. Pour vider un champ texte, envoyez-le avec une chaîne vide. La même règle vaut à l'intérieur de `adresse` : envoyer seulement `adresse.ville` ne touche pas au code postal.\n\nIl faut l'identifiant exact du client : pour le trouver à partir d'une adresse mail, utilisez d'abord `GET /v1/customers?email=…`. Un client supprimé dans l'application est introuvable (404), il ne peut pas être modifié ni réactivé.\n\nRemplacer l'adresse mail par une adresse déjà portée par un autre client actif est refusé avec l'erreur `duplicate_email`, sauf avec `?allow_duplicate_email=true`. La fidélité (points, cumuls), les dates et l'identifiant ne s'écrivent pas par cette adresse : les points s'ajustent par `POST /v1/customers/{id}/loyalty-points`. Pour vérifier une requête sans rien enregistrer, ajoutez `?dry_run=true`.","x-wanapos-scope":"write_customers","x-wanapos-kind":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Identifiant du client (champ `id`).","example":1842},{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"allow_duplicate_email","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour enregistrer même si un autre client actif porte déjà cette adresse mail. À n'utiliser qu'après avoir vérifié qu'il s'agit bien de deux personnes différentes."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerInput"},"example":{"mobile":"0611223344","news_sms":true,"adresse":{"ville":"Villeurbanne","cp":"69100"}}}}},"responses":{"200":{"description":"Le client après modification, avec sa fiche complète.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerResponse"},"example":{"data":{"id":1842,"civilite":"Mme","nom":"Martin","prenom":"Claire","nom_2":"","email":"claire.martin@exemple.com","tel":"","mobile":"0600000000","bc_ext":"","remise_pc":0,"notes":"","libre_1":"","libre_2":"","libre_3":"","custom_io_1":false,"custom_io_2":false,"custom_io_3":false,"custom_date_1":"","custom_date_2":"","custom_date_3":"","news_sms":false,"news_email":true,"fidelite_active":true,"actif":true,"id_shop_origin":1,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00","adresse":{"ligne1":"12 rue des Lilas","ligne2":"","cp":"69003","ville":"Lyon","id_pays":63,"pays_code":"FR","pays":"France","tva_intra":"","archived":false},"fidelite":{"points_actuels":120,"points_cumules":340,"nb_fois_pts_utilises":2,"last_pts_acquis":15,"total_ca":412.5,"total_qt":17,"total_pa":9},"champs_personnalises":[{"cle":"libre_1","libelle":"Customisé 1","type":"texte","affiche":false,"valeur":""},{"cle":"libre_2","libelle":"Customisé 2","type":"texte","affiche":false,"valeur":""},{"cle":"libre_3","libelle":"Customisé 3","type":"texte","affiche":false,"valeur":""},{"cle":"custom_io_1","libelle":"Customisé 1","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_2","libelle":"Customisé 2","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_3","libelle":"Customisé 3","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_date_1","libelle":"Customisé 1","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_2","libelle":"Customisé 2","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_3","libelle":"Customisé 3","type":"date","affiche":false,"valeur":""}]},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/DuplicateEmail"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/customers/{id}/purchases":{"get":{"operationId":"listCustomerPurchases","x-wanapos-slug":"achats-d-un-client","tags":["Clients"],"summary":"Lire les achats d'un client","description":"Renvoie ce qu'un client a acheté : une ligne par article, de la plus récente à la plus ancienne. Cette adresse demande la permission `read_sales`, distincte de `read_customers` : lire les coordonnées d'un client ne donne pas accès à ses achats.\n\nChaque ligne est un article d'un ticket. Les articles d'un même passage en caisse portent le même `id_ticket` et le même `num_ticket` : regroupez-les par `id_ticket` pour reconstituer un ticket. Un retour apparaît comme une ligne avec une quantité `qt` et un montant `val` négatifs. Les ventes annulées n'apparaissent pas. Une carte cadeau apparaît sans détail (`type` vaut `carte_kdo`).\n\nLes montants sont dans la devise du compte. `val` est le montant TTC réellement payé pour la ligne, remise déduite : c'est lui qu'il faut additionner pour obtenir un total.\n\nLe parcours se fait par curseur : tant que `meta.has_more` vaut `true`, rappelez avec `after` égal à `meta.next_after`. Sans `since` ni `until`, tout l'historique du client est parcouru. Une liste vide signifie que le client n'a rien acheté sur la période, ce n'est pas une erreur. Un client supprimé ou inconnu renvoie 404.\n\nLes ventes ne se modifient pas par l'API : elles sont en lecture seule.","x-wanapos-scope":"read_sales","x-wanapos-kind":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Identifiant du client (champ `id`).","example":1842},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Nombre de lignes par page, de 1 à 100. 50 par défaut."},{"name":"after","in":"query","required":false,"schema":{"type":"integer"},"description":"Curseur de parcours. Absent ou 0 pour la première page, puis la valeur `next_after` de la réponse précédente."},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"Ne renvoie que les ventes à partir de cette date, incluse. Format `2026-01-01`."},{"name":"until","in":"query","required":false,"schema":{"type":"string"},"description":"Ne renvoie que les ventes jusqu'à cette date, incluse. Format `2026-12-31`."}],"responses":{"200":{"description":"Une page des achats du client.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerPurchasesResponse"},"example":{"data":[{"id":58214,"date":"2026-10-02","date_creation":"2026-10-02T16:05:12+02:00","id_ticket":9041,"num_ticket":3187,"id_shop":1,"id_point_caisse":1,"type":"product","id_product":412,"id_variante_product":1630,"designation":"Pull col rond","variante":"M / Bleu","qt":1,"pv_initial":59.9,"remise_pc":10.0,"remise_mt":5.99,"val":53.91,"val_ht":44.93,"tva_mt":8.98,"id_promotion":0,"promotion":"","remarque":""},{"id":58213,"date":"2026-10-02","date_creation":"2026-10-02T16:05:12+02:00","id_ticket":9041,"num_ticket":3187,"id_shop":1,"id_point_caisse":1,"type":"product","id_product":77,"id_variante_product":205,"designation":"Écharpe laine","variante":"","qt":1,"pv_initial":24.0,"remise_pc":0.0,"remise_mt":0.0,"val":24.0,"val_ht":20.0,"tva_mt":4.0,"id_promotion":0,"promotion":"","remarque":""}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":2,"has_more":false,"next_after":0}}}}},"404":{"$ref":"#/components/responses/NotFound"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/customers/export":{"get":{"operationId":"exportCustomers","x-wanapos-slug":"export-du-fichier-clients","tags":["Clients"],"summary":"Parcourir tout le fichier clients","description":"Renvoie les clients du compte page par page, par identifiant croissant, avec la même fiche complète que la lecture d'un client. Cette adresse demande la permission `export_customers`, distincte de `read_customers` : une clé de simple lecture ne peut pas parcourir tout le fichier.\n\nLe parcours se fait par curseur. Appelez d'abord sans `after`. Tant que `meta.has_more` vaut `true`, rappelez avec `after` égal à `meta.next_after`. Quand `has_more` vaut `false`, le parcours est terminé. Ne construisez pas le curseur vous-même et n'utilisez pas de numéro de page.\n\nPour tenir un autre outil à jour sans tout relire, passez `updated_since` : seules les fiches créées ou modifiées depuis cette date reviennent. Notez l'heure de début de votre parcours et réutilisez-la comme `updated_since` la fois suivante. Un changement de points de fidélité seul ne compte pas comme une modification de la fiche. Les clients supprimés dans l'application ne sont jamais renvoyés ici : `GET /v1/customers/deleted` donne leurs identifiants.","x-wanapos-scope":"export_customers","x-wanapos-kind":"read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Nombre d'éléments par page, de 1 à 100. 50 par défaut."},{"name":"after","in":"query","required":false,"schema":{"type":"integer"},"description":"Curseur de parcours : ne renvoie que les éléments dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur `next_after` de la réponse précédente."},{"name":"updated_since","in":"query","required":false,"schema":{"type":"string"},"description":"Ne renvoie que les fiches créées ou modifiées depuis cette date. Formats acceptés : `2026-11-01` (minuit, heure de Paris) ou `2026-11-01T08:30:00+01:00`. Sans fuseau, l'heure est celle de Paris. Pensez à encoder le `+` dans l'URL (`%2B`).","example":"2026-11-01"}],"responses":{"200":{"description":"Une page du fichier clients.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerExportResponse"},"example":{"data":[{"id":1842,"civilite":"Mme","nom":"Martin","prenom":"Claire","nom_2":"","email":"claire.martin@exemple.com","tel":"","mobile":"0600000000","bc_ext":"","remise_pc":0,"notes":"","libre_1":"","libre_2":"","libre_3":"","custom_io_1":false,"custom_io_2":false,"custom_io_3":false,"custom_date_1":"","custom_date_2":"","custom_date_3":"","news_sms":false,"news_email":true,"fidelite_active":true,"actif":true,"id_shop_origin":1,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00","adresse":{"ligne1":"12 rue des Lilas","ligne2":"","cp":"69003","ville":"Lyon","id_pays":63,"pays_code":"FR","pays":"France","tva_intra":"","archived":false},"fidelite":{"points_actuels":120,"points_cumules":340,"nb_fois_pts_utilises":2,"last_pts_acquis":15,"total_ca":412.5,"total_qt":17,"total_pa":9},"champs_personnalises":[{"cle":"libre_1","libelle":"Customisé 1","type":"texte","affiche":false,"valeur":""},{"cle":"libre_2","libelle":"Customisé 2","type":"texte","affiche":false,"valeur":""},{"cle":"libre_3","libelle":"Customisé 3","type":"texte","affiche":false,"valeur":""},{"cle":"custom_io_1","libelle":"Customisé 1","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_2","libelle":"Customisé 2","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_3","libelle":"Customisé 3","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_date_1","libelle":"Customisé 1","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_2","libelle":"Customisé 2","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_3","libelle":"Customisé 3","type":"date","affiche":false,"valeur":""}]}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1,"has_more":false,"next_after":0}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/customers/deleted":{"get":{"operationId":"listDeletedCustomers","x-wanapos-slug":"clients-supprimes","tags":["Clients"],"summary":"Lister les clients supprimés","description":"Renvoie les clients supprimés du compte : leur identifiant et la date de leur suppression, rien d'autre. Leurs coordonnées ne sont plus accessibles par l'API.\n\nCette adresse sert à tenir un autre outil à jour : après avoir relu les fiches modifiées avec `GET /v1/customers/export`, retirez de votre côté les identifiants renvoyés ici. Passez `since` pour ne recevoir que les suppressions depuis votre dernier passage.\n\nMême parcours par curseur que l'export : tant que `meta.has_more` vaut `true`, rappelez avec `after` égal à `meta.next_after`. Permission `export_customers`.","x-wanapos-scope":"export_customers","x-wanapos-kind":"read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Nombre d'éléments par page, de 1 à 100. 50 par défaut."},{"name":"after","in":"query","required":false,"schema":{"type":"integer"},"description":"Curseur de parcours : ne renvoie que les éléments dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur `next_after` de la réponse précédente."},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"Ne renvoie que les clients supprimés depuis cette date. Formats acceptés : `2026-11-01` (minuit, heure de Paris) ou `2026-11-01T08:30:00+01:00`. Sans fuseau, l'heure est celle de Paris. Pensez à encoder le `+` dans l'URL (`%2B`).","example":"2026-11-01"}],"responses":{"200":{"description":"Une page des clients supprimés.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedCustomersResponse"},"example":{"data":[{"id":1790,"date_suppression":"2026-11-03T18:12:45+01:00"}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1,"has_more":false,"next_after":0}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/loyalty-program":{"get":{"operationId":"getLoyaltyProgram","x-wanapos-slug":"programme-de-fidelite","tags":["Fidélité"],"summary":"Lire le programme de fidélité du compte","description":"Renvoie les réglages du programme de fidélité : comment un point se gagne, combien il en faut pour déclencher la récompense, et ce qu'elle apporte. Toute clé valide peut l'appeler.\n\nAppelez cette adresse avant de raisonner sur des points : un point n'a pas la même valeur d'un compte à l'autre. Selon `type`, un point correspond à une unité de monnaie dépensée (`ca`), à un article acheté (`qt`) ou à un passage en caisse (`pa`). Un client atteint la récompense quand son solde (`fidelite.points_actuels` dans sa fiche) est supérieur ou égal à `points_trigger`.\n\nSi `actif` vaut `false`, le programme est désactivé : les ventes ne rapportent pas de points, mais les soldes existants sont conservés.","x-wanapos-scope":"","x-wanapos-kind":"read","responses":{"200":{"description":"Le programme de fidélité du compte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoyaltyProgramResponse"},"example":{"data":{"actif":true,"type":"ca","points_trigger":500,"reward_type":"pourcentage","remise_pc_val":10,"include_reward_ticket":false,"promo_compte":false,"date_update":"2026-04-02T09:15:00+02:00"},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/customers/{id}/loyalty-points":{"post":{"operationId":"adjustLoyaltyPoints","x-wanapos-slug":"ajustement-des-points","tags":["Fidélité"],"summary":"Ajouter ou retirer des points de fidélité à un client","description":"Ajoute ou retire des points au solde de fidélité d'un client, et renvoie le solde avant et après. Cette adresse demande la permission `write_loyalty`, distincte de `write_customers`.\n\n`points` est un ajustement, pas un solde : envoyez `50` pour ajouter 50 points, `-20` pour en retirer 20. Vous n'avez pas à lire le solde avant, ni à calculer le nouveau. Un appel ne peut pas dépasser 1000 points, en plus comme en moins. Le solde ne peut pas devenir négatif ni dépasser 1 000 000 : un ajustement qui le ferait sortir de ces bornes est refusé avec l'erreur `points_out_of_range`, qui donne le solde actuel. Il n'est jamais arrondi à votre place.\n\nL'en-tête `Idempotency-Key` est obligatoire sur cette adresse. Comme l'ajustement s'ajoute au solde, une requête renvoyée après une coupure réseau sans cet identifiant ajouterait les points deux fois. Utilisez un identifiant nouveau pour chaque ajustement voulu, et le même identifiant si vous renvoyez la même requête.\n\n`motif` est obligatoire : dites en quelques mots pourquoi ces points sont ajoutés ou retirés (parrainage, geste commercial, correction). Le titulaire du compte le lit dans son journal des modifications.\n\nSeul le solde actuel change. Les points cumulés depuis l'origine, le nombre d'utilisations et les totaux d'achats reflètent l'activité réelle du client et ne se modifient pas. Les points que valent vos ajustements dépendent du programme du compte : voir `GET /v1/loyalty-program`. L'ajustement est accepté même si le programme est désactivé. Pour vérifier une requête sans rien modifier, ajoutez `?dry_run=true`.","x-wanapos-scope":"write_loyalty","x-wanapos-kind":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Identifiant du client (champ `id`).","example":1842},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"},"description":"Obligatoire. Identifiant unique de votre choix (8 à 100 caractères), nouveau pour chaque ajustement.","example":"parrainage-1842-2026-11-11"},{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien modifier : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoyaltyAdjustmentInput"},"example":{"points":50,"motif":"Parrainage"}}}},"responses":{"200":{"description":"L'ajustement est enregistré.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoyaltyAdjustmentResponse"},"example":{"data":{"id_client":1842,"ajustement":50,"points_avant":120,"points_actuels":170,"motif":"Parrainage"},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"400":{"$ref":"#/components/responses/IdempotencyKeyRequired"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/PointsOutOfRange"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/products":{"get":{"operationId":"listProducts","x-wanapos-slug":"parcours-du-catalogue","tags":["Produits"],"summary":"Parcourir tout le catalogue","description":"Renvoie les produits du compte page par page, par identifiant croissant, chacun avec ses variantes, ses codes et ses prix.\n\nCette adresse sert à lire tout le catalogue, par exemple pour tenir à jour une boutique en ligne ou un tableau de bord. Ce n'est pas une recherche : elle ne filtre ni par nom, ni par code, ni par fournisseur. Si vous connaissez l'identifiant d'un produit, appelez `GET /v1/products/{id}` ; si vous avez un code, une référence ou sa désignation exacte, appelez `GET /v1/products/lookup`.\n\nLe parcours se fait par curseur. Appelez d'abord sans `after`. Tant que `meta.has_more` vaut `true`, rappelez avec `after` égal à `meta.next_after`. Quand `has_more` vaut `false`, le parcours est terminé. Ne construisez pas le curseur vous-même et n'utilisez pas de numéro de page.\n\nLes produits archivés ne sont pas renvoyés, sauf avec `archived=true`. Un produit supprimé dans l'application est définitivement effacé : il disparaît simplement du parcours, sans liste des suppressions. Il n'existe pas de filtre « modifiés depuis » : pour vous synchroniser, relisez le catalogue en entier et comparez.\n\nLe stock ne fait pas partie du produit. Les codes (`bc_ext`, `ean_int`, `sku`) sont portés par les variantes : un produit sans variante en a une seule, la variante « produit seul ». Le prix payé en caisse se lit dans `variantes_product[].prix`, par magasin et hors promotion ; `pv_ttc` n'est que le prix de base. Cette permission donne aussi accès aux prix d'achat.","x-wanapos-scope":"read_products","x-wanapos-kind":"read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Nombre de produits par page, de 1 à 100. 50 par défaut."},{"name":"after","in":"query","required":false,"schema":{"type":"integer"},"description":"Curseur de parcours : ne renvoie que les produits dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur `next_after` de la réponse précédente."},{"name":"archived","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour inclure aussi les produits archivés. `false` par défaut : seuls les produits non archivés sont renvoyés.","example":true}],"responses":{"200":{"description":"Une page du catalogue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductListResponse"},"example":{"data":[{"id":312,"designation":"Tee-shirt col rond","description":"Coton bio, coupe droite.","notes":"","ref_four":"TS-8744","ref_interne":"","image_url":"https://api.wanapos.com/web/data_user/0001842/images/product/wanapos_312.jpg","gestion_stock":true,"variantes":true,"favorite":false,"archived":false,"pa_ht":12.5,"pv_ttc":29.9,"eco_ttc":0,"fournisseur":{"id":4,"name":"Atelier Textile"},"collec":{"id":2,"name":"Été 2026"},"categories":[{"niveau":1,"id":7,"name":"Vêtements"},{"niveau":2,"id":12,"name":"Hauts"}],"libre_1":"","libre_2":"","libre_3":"","id_custom_list_1":0,"id_custom_list_2":0,"id_custom_list_3":0,"custom_io_1":false,"custom_io_2":false,"custom_io_3":false,"custom_date_1":"","custom_date_2":"","custom_date_3":"","magasins":[{"id_shop":1,"impact_pv":0,"tva_taux":20},{"id_shop":2,"impact_pv":2,"tva_taux":20}],"variantes_product":[{"id":1048,"is_product":false,"name":"M","position":1,"bc_ext":"","ean_int":"2161018416004","sku":"TS-M","impact_pa":0,"pa_ht":12.5,"impact_pv":0,"prix":[{"id_shop":1,"pv_ttc":29.9},{"id_shop":2,"pv_ttc":31.9}],"actif":true,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-09-02T09:40:00+02:00"},{"id":1049,"is_product":false,"name":"XL","position":2,"bc_ext":"","ean_int":"2184253688944","sku":"TS-XL","impact_pa":0,"pa_ht":12.5,"impact_pv":3,"prix":[{"id_shop":1,"pv_ttc":32.9},{"id_shop":2,"pv_ttc":34.9}],"actif":true,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-09-02T09:40:00+02:00"}],"variantes_inactives":[],"champs_personnalises":[{"cle":"libre_1","libelle":"Customisé 1","type":"texte","affiche":false,"valeur":""},{"cle":"libre_2","libelle":"Customisé 2","type":"texte","affiche":false,"valeur":""},{"cle":"libre_3","libelle":"Customisé 3","type":"texte","affiche":false,"valeur":""},{"cle":"id_custom_list_1","libelle":"Customisé 1","type":"liste","affiche":false,"valeur":""},{"cle":"id_custom_list_2","libelle":"Customisé 2","type":"liste","affiche":false,"valeur":""},{"cle":"id_custom_list_3","libelle":"Customisé 3","type":"liste","affiche":false,"valeur":""},{"cle":"custom_io_1","libelle":"Customisé 1","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_2","libelle":"Customisé 2","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_3","libelle":"Customisé 3","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_date_1","libelle":"Customisé 1","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_2","libelle":"Customisé 2","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_3","libelle":"Customisé 3","type":"date","affiche":false,"valeur":""}],"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-09-02T09:40:00+02:00"}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1,"has_more":false,"next_after":0}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"createProduct","x-wanapos-slug":"creation-d-un-produit","tags":["Produits"],"summary":"Créer un produit","description":"Crée un produit, avec ses variantes s'il en a, et renvoie le produit complet tel que le donne `GET /v1/products/{id}`. Un seul produit par appel : pour en créer plusieurs, faites un appel par produit.\n\nAvant de créer, vérifiez que le produit n'existe pas déjà avec `GET /v1/products/lookup` (par code-barres, référence fournisseur ou désignation). L'API ne refuse pas deux produits de même nom ou de même référence.\n\nSeul `designation` est obligatoire. Sans `variantes_product`, le produit est créé sans variante et ses codes (`bc_ext`, `sku`) se donnent à la racine. Avec `variantes_product`, chaque variante porte ses propres codes et ses écarts de prix. Le code-barres interne `ean_int` n'est jamais envoyé : Wanapos le génère pour le produit et pour chaque variante.\n\nLe fournisseur, la collection, la catégorie et les valeurs de liste personnalisée se donnent par leur nom ou par leur identifiant, jamais les deux. Par son nom, un classement inconnu est créé au passage : la réponse liste ce qui a été créé dans `meta.created_listings`. Un nom est rapproché sans tenir compte des majuscules, des accents ni des espaces autour (`nike` retrouve `Nike`). Attention aux fautes de frappe : `Nikee` créerait un second fournisseur. Par son identifiant, un classement inconnu est refusé. La catégorie se donne par son chemin complet, du niveau le plus général au plus précis.\n\nUn code-barres externe (`bc_ext`) déjà porté par une variante en service d'un autre produit est refusé : l'erreur `duplicate_barcode` donne l'identifiant du produit qui le porte. Si deux produits partagent réellement ce code, renvoyez avec `?allow_duplicate_bc_ext=true`.\n\nLe produit est créé sans stock : le stock ne s'écrit pas par l'API. Il n'est envoyé vers aucune boutique en ligne reliée au compte. Son image, son écart de prix par magasin et ses produits liés se règlent dans l'application.\n\nCet appel compte comme une écriture. Utilisez `?dry_run=true` pour tout vérifier sans rien enregistrer, et l'en-tête `Idempotency-Key` pour qu'un envoi répété après une coupure ne crée pas le produit deux fois.","x-wanapos-scope":"write_products","x-wanapos-kind":"write","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"allow_duplicate_bc_ext","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour enregistrer même si un autre produit porte déjà un des codes-barres externes envoyés. À n'utiliser qu'après avoir vérifié qu'il s'agit bien de deux produits différents."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductInput"},"example":{"designation":"Tee-shirt col rond","description":"Coton bio, coupe droite.","ref_four":"TS-8744","pa_ht":12.5,"pv_ttc":29.9,"fournisseur":"Atelier Textile","collec":"Été 2026","categories":["Vêtements","Hauts"],"variantes_product":[{"name":"M","sku":"TS-M"},{"name":"XL","sku":"TS-XL","impact_pv":3}]}}}},"responses":{"201":{"description":"Le produit créé, complet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductCreatedResponse"},"example":{"data":{"id":312,"designation":"Tee-shirt col rond","description":"Coton bio, coupe droite.","notes":"","ref_four":"TS-8744","ref_interne":"","image_url":"","gestion_stock":true,"variantes":true,"favorite":false,"archived":false,"pa_ht":12.5,"pv_ttc":29.9,"eco_ttc":0,"fournisseur":{"id":4,"name":"Atelier Textile"},"collec":{"id":2,"name":"Été 2026"},"categories":[{"niveau":1,"id":7,"name":"Vêtements"},{"niveau":2,"id":12,"name":"Hauts"}],"libre_1":"","libre_2":"","libre_3":"","id_custom_list_1":0,"id_custom_list_2":0,"id_custom_list_3":0,"custom_io_1":false,"custom_io_2":false,"custom_io_3":false,"custom_date_1":"","custom_date_2":"","custom_date_3":"","magasins":[{"id_shop":1,"impact_pv":0,"tva_taux":20},{"id_shop":2,"impact_pv":2,"tva_taux":20}],"variantes_product":[{"id":1048,"is_product":false,"name":"M","position":1,"bc_ext":"","ean_int":"2161018416004","sku":"TS-M","impact_pa":0,"pa_ht":12.5,"impact_pv":0,"prix":[{"id_shop":1,"pv_ttc":29.9},{"id_shop":2,"pv_ttc":31.9}],"actif":true,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-03-14T10:22:00+01:00"},{"id":1049,"is_product":false,"name":"XL","position":2,"bc_ext":"","ean_int":"2184253688944","sku":"TS-XL","impact_pa":0,"pa_ht":12.5,"impact_pv":3,"prix":[{"id_shop":1,"pv_ttc":32.9},{"id_shop":2,"pv_ttc":34.9}],"actif":true,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-03-14T10:22:00+01:00"}],"variantes_inactives":[],"champs_personnalises":[{"cle":"libre_1","libelle":"Customisé 1","type":"texte","affiche":false,"valeur":""},{"cle":"libre_2","libelle":"Customisé 2","type":"texte","affiche":false,"valeur":""},{"cle":"libre_3","libelle":"Customisé 3","type":"texte","affiche":false,"valeur":""},{"cle":"id_custom_list_1","libelle":"Customisé 1","type":"liste","affiche":false,"valeur":""},{"cle":"id_custom_list_2","libelle":"Customisé 2","type":"liste","affiche":false,"valeur":""},{"cle":"id_custom_list_3","libelle":"Customisé 3","type":"liste","affiche":false,"valeur":""},{"cle":"custom_io_1","libelle":"Customisé 1","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_2","libelle":"Customisé 2","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_3","libelle":"Customisé 3","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_date_1","libelle":"Customisé 1","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_2","libelle":"Customisé 2","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_3","libelle":"Customisé 3","type":"date","affiche":false,"valeur":""}],"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-03-14T10:22:00+01:00"},"meta":{"request_id":"3f9a1c0b7d2e4a61","created_listings":[{"type":"categorie","id":12,"name":"Hauts"}]}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/DuplicateBarcode"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/products/lookup":{"get":{"operationId":"lookupProducts","x-wanapos-slug":"identification-exacte","tags":["Produits"],"summary":"Identifier un produit par un code, une référence ou sa désignation","description":"Renvoie les produits dont un identifiant vaut exactement la valeur donnée, sans tenir compte des majuscules, des accents ni des espaces autour. Deux usages : retrouver le produit d'un code ou d'une référence que vous avez en main (un code-barres scanné, une ligne de bon de commande), et vérifier qu'un produit existe déjà avant d'en créer un.\n\nDonnez un critère, et un seul, par appel : `designation`, `ref_four`, `ref_interne`, `bc_ext`, `ean_int`, `sku` ou `code`. Si vous avez un code sans savoir de quel type il est, utilisez `code` : il est comparé aux trois codes des variantes (`bc_ext`, `ean_int`, `sku`). Pour essayer plusieurs critères, faites un appel par critère.\n\nCe n'est pas une recherche par mots : la valeur doit correspondre en entier. `tee` ne trouve pas `Tee-shirt col rond`. Ce n'est pas non plus le parcours du catalogue : pour tout lire, utilisez `GET /v1/products`.\n\nLa réponse est toujours une liste : dans Wanapos, ni une désignation, ni une référence, ni même un code ne sont forcément uniques. Une liste vide signifie qu'aucun produit ne correspond, ce n'est pas une erreur. Si plusieurs produits reviennent, ne choisissez pas au hasard : départagez-les avec leurs autres champs, ou demandez à l'utilisateur.\n\nLes codes sont portés par les variantes : l'appel renvoie le produit entier, et la variante concernée est celle de `variantes_product` dont `bc_ext`, `ean_int` ou `sku` correspond. Seules les variantes en service comptent : le code d'une variante désactivée ne fait ressortir aucun produit.\n\nLes produits archivés sont renvoyés aussi (`archived` vaut `true`) : avant de créer un produit, regardez ce champ.\n\nLa liste est limitée à 50 produits. Si `meta.truncated` vaut `true`, plus de 50 produits correspondent et la liste est incomplète : il n'existe pas de page suivante. Parcourez alors le catalogue avec `GET /v1/products` et gardez les produits qui correspondent.","x-wanapos-scope":"read_products","x-wanapos-kind":"read","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string"},"description":"Un code dont vous ne connaissez pas le type : comparé à `bc_ext`, `ean_int` et `sku` des variantes en service (32 caractères au plus).","example":"3760000000022","x-wanapos-example":true},{"name":"bc_ext","in":"query","required":false,"schema":{"type":"string"},"description":"Code-barres externe d'une variante, celui du fabricant (32 caractères au plus).","example":"3760000000022"},{"name":"ean_int","in":"query","required":false,"schema":{"type":"string"},"description":"Code-barres interne d'une variante, généré par Wanapos (13 caractères au plus).","example":"2161018416004"},{"name":"sku","in":"query","required":false,"schema":{"type":"string"},"description":"Référence d'une variante, SKU (32 caractères au plus).","example":"TS-XL"},{"name":"ref_four","in":"query","required":false,"schema":{"type":"string"},"description":"Référence du produit chez le fournisseur (50 caractères au plus).","example":"TS-8744"},{"name":"ref_interne","in":"query","required":false,"schema":{"type":"string"},"description":"Référence interne du produit (50 caractères au plus).","example":"INT-0412"},{"name":"designation","in":"query","required":false,"schema":{"type":"string"},"description":"Nom complet du produit (50 caractères au plus). Pensez à l'encoder dans l'URL.","example":"Tee-shirt col rond"}],"responses":{"200":{"description":"Les produits correspondants.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductLookupResponse"},"example":{"data":[{"id":312,"designation":"Tee-shirt col rond","description":"Coton bio, coupe droite.","notes":"","ref_four":"TS-8744","ref_interne":"","image_url":"https://api.wanapos.com/web/data_user/0001842/images/product/wanapos_312.jpg","gestion_stock":true,"variantes":true,"favorite":false,"archived":false,"pa_ht":12.5,"pv_ttc":29.9,"eco_ttc":0,"fournisseur":{"id":4,"name":"Atelier Textile"},"collec":{"id":2,"name":"Été 2026"},"categories":[{"niveau":1,"id":7,"name":"Vêtements"},{"niveau":2,"id":12,"name":"Hauts"}],"libre_1":"","libre_2":"","libre_3":"","id_custom_list_1":0,"id_custom_list_2":0,"id_custom_list_3":0,"custom_io_1":false,"custom_io_2":false,"custom_io_3":false,"custom_date_1":"","custom_date_2":"","custom_date_3":"","magasins":[{"id_shop":1,"impact_pv":0,"tva_taux":20},{"id_shop":2,"impact_pv":2,"tva_taux":20}],"variantes_product":[{"id":1048,"is_product":false,"name":"M","position":1,"bc_ext":"","ean_int":"2161018416004","sku":"TS-M","impact_pa":0,"pa_ht":12.5,"impact_pv":0,"prix":[{"id_shop":1,"pv_ttc":29.9},{"id_shop":2,"pv_ttc":31.9}],"actif":true,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-09-02T09:40:00+02:00"},{"id":1049,"is_product":false,"name":"XL","position":2,"bc_ext":"","ean_int":"2184253688944","sku":"TS-XL","impact_pa":0,"pa_ht":12.5,"impact_pv":3,"prix":[{"id_shop":1,"pv_ttc":32.9},{"id_shop":2,"pv_ttc":34.9}],"actif":true,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-09-02T09:40:00+02:00"}],"variantes_inactives":[],"champs_personnalises":[{"cle":"libre_1","libelle":"Customisé 1","type":"texte","affiche":false,"valeur":""},{"cle":"libre_2","libelle":"Customisé 2","type":"texte","affiche":false,"valeur":""},{"cle":"libre_3","libelle":"Customisé 3","type":"texte","affiche":false,"valeur":""},{"cle":"id_custom_list_1","libelle":"Customisé 1","type":"liste","affiche":false,"valeur":""},{"cle":"id_custom_list_2","libelle":"Customisé 2","type":"liste","affiche":false,"valeur":""},{"cle":"id_custom_list_3","libelle":"Customisé 3","type":"liste","affiche":false,"valeur":""},{"cle":"custom_io_1","libelle":"Customisé 1","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_2","libelle":"Customisé 2","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_3","libelle":"Customisé 3","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_date_1","libelle":"Customisé 1","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_2","libelle":"Customisé 2","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_3","libelle":"Customisé 3","type":"date","affiche":false,"valeur":""}],"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-09-02T09:40:00+02:00"}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1,"truncated":false}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/products/{id}":{"get":{"operationId":"getProduct","x-wanapos-slug":"lecture-par-identifiant","tags":["Produits"],"summary":"Lire un produit par son identifiant","description":"Renvoie un produit complet : identité, classement, prix, variantes et champs personnalisés. L'identifiant est le champ `id` d'un produit, ou le `id_product` d'une ligne de vente.\n\nUn produit archivé reste lisible ici (`archived` vaut `true`). Un produit supprimé dans l'application est définitivement effacé : l'appel répond 404.\n\nLe stock ne fait pas partie du produit. Les codes (`bc_ext`, `ean_int`, `sku`) sont portés par les variantes : un produit sans variante en a une seule, la variante « produit seul ». Le prix payé en caisse se lit dans `variantes_product[].prix`, par magasin et hors promotion ; `pv_ttc` n'est que le prix de base. Cette permission donne aussi accès aux prix d'achat.","x-wanapos-scope":"read_products","x-wanapos-kind":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Identifiant du produit (champ `id`).","example":312}],"responses":{"200":{"description":"Le produit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResponse"},"example":{"data":{"id":312,"designation":"Tee-shirt col rond","description":"Coton bio, coupe droite.","notes":"","ref_four":"TS-8744","ref_interne":"","image_url":"https://api.wanapos.com/web/data_user/0001842/images/product/wanapos_312.jpg","gestion_stock":true,"variantes":true,"favorite":false,"archived":false,"pa_ht":12.5,"pv_ttc":29.9,"eco_ttc":0,"fournisseur":{"id":4,"name":"Atelier Textile"},"collec":{"id":2,"name":"Été 2026"},"categories":[{"niveau":1,"id":7,"name":"Vêtements"},{"niveau":2,"id":12,"name":"Hauts"}],"libre_1":"","libre_2":"","libre_3":"","id_custom_list_1":0,"id_custom_list_2":0,"id_custom_list_3":0,"custom_io_1":false,"custom_io_2":false,"custom_io_3":false,"custom_date_1":"","custom_date_2":"","custom_date_3":"","magasins":[{"id_shop":1,"impact_pv":0,"tva_taux":20},{"id_shop":2,"impact_pv":2,"tva_taux":20}],"variantes_product":[{"id":1048,"is_product":false,"name":"M","position":1,"bc_ext":"","ean_int":"2161018416004","sku":"TS-M","impact_pa":0,"pa_ht":12.5,"impact_pv":0,"prix":[{"id_shop":1,"pv_ttc":29.9},{"id_shop":2,"pv_ttc":31.9}],"actif":true,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-09-02T09:40:00+02:00"},{"id":1049,"is_product":false,"name":"XL","position":2,"bc_ext":"","ean_int":"2184253688944","sku":"TS-XL","impact_pa":0,"pa_ht":12.5,"impact_pv":3,"prix":[{"id_shop":1,"pv_ttc":32.9},{"id_shop":2,"pv_ttc":34.9}],"actif":true,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-09-02T09:40:00+02:00"}],"variantes_inactives":[],"champs_personnalises":[{"cle":"libre_1","libelle":"Customisé 1","type":"texte","affiche":false,"valeur":""},{"cle":"libre_2","libelle":"Customisé 2","type":"texte","affiche":false,"valeur":""},{"cle":"libre_3","libelle":"Customisé 3","type":"texte","affiche":false,"valeur":""},{"cle":"id_custom_list_1","libelle":"Customisé 1","type":"liste","affiche":false,"valeur":""},{"cle":"id_custom_list_2","libelle":"Customisé 2","type":"liste","affiche":false,"valeur":""},{"cle":"id_custom_list_3","libelle":"Customisé 3","type":"liste","affiche":false,"valeur":""},{"cle":"custom_io_1","libelle":"Customisé 1","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_2","libelle":"Customisé 2","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_io_3","libelle":"Customisé 3","type":"oui_non","affiche":false,"valeur":false},{"cle":"custom_date_1","libelle":"Customisé 1","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_2","libelle":"Customisé 2","type":"date","affiche":false,"valeur":""},{"cle":"custom_date_3","libelle":"Customisé 3","type":"date","affiche":false,"valeur":""}],"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-09-02T09:40:00+02:00"},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/suppliers":{"get":{"operationId":"listSuppliers","x-wanapos-slug":"fournisseurs","tags":["Classements"],"summary":"Lister les fournisseurs","description":"Renvoie les fournisseurs du compte, avec leurs coordonnées et leur adresse, par identifiant croissant. C'est ici que se traduit le `fournisseur.id` d'un produit.\n\nLe parcours se fait par curseur : tant que `meta.has_more` vaut `true`, rappelez l'adresse avec `after` égal à `meta.next_after`. Les éléments archivés ne sont renvoyés qu'avec `archived=true`.","x-wanapos-scope":"read_products","x-wanapos-kind":"read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Nombre d'éléments par page, de 1 à 100. 50 par défaut."},{"name":"after","in":"query","required":false,"schema":{"type":"integer"},"description":"Curseur de parcours : ne renvoie que les éléments dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur `next_after` de la réponse précédente."},{"name":"archived","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour inclure aussi les éléments archivés. `false` par défaut : seuls les éléments en service sont renvoyés.","example":true}],"responses":{"200":{"description":"Une page de fournisseurs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierListResponse"},"example":{"data":[{"id":7,"name":"Maison Verdier","commercial1":"Julie Arnaud","commercial2":"","tel":"0472000000","mobile":"","email":"contact@maison-verdier.example","tva_intra":"","notes":"","archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00","adresse":{"ligne1":"4 quai des Tanneurs","ligne2":"","cp":"69009","ville":"Lyon","id_pays":63,"pays_code":"FR","pays":"France"}}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1,"has_more":false,"next_after":0}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"createSupplier","x-wanapos-slug":"creation-d-un-fournisseur","tags":["Classements"],"summary":"Créer un fournisseur","description":"Crée un fournisseur et renvoie sa fiche. Seul `name` est obligatoire.\n\nUn nom déjà pris est refusé avec l'erreur `duplicate_name`, qui donne l'identifiant existant : réutilisez-le plutôt que de créer un doublon. La comparaison ne tient compte ni des majuscules, ni des accents, ni des espaces autour, et inclut les éléments archivés.\n\nPour rattacher ensuite un produit à ce fournisseur, donnez son identifiant ou son nom à la création du produit.","x-wanapos-scope":"write_products","x-wanapos-kind":"write","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierInput"},"example":{"name":"Maison Verdier","commercial1":"Julie Arnaud","tel":"0472000000","email":"contact@maison-verdier.example","adresse":{"ligne1":"4 quai des Tanneurs","cp":"69009","ville":"Lyon","pays_code":"FR"}}}}},"responses":{"201":{"description":"Le fournisseur créé.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierResponse"},"example":{"data":{"id":7,"name":"Maison Verdier","commercial1":"Julie Arnaud","commercial2":"","tel":"0472000000","mobile":"","email":"contact@maison-verdier.example","tva_intra":"","notes":"","archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00","adresse":{"ligne1":"4 quai des Tanneurs","ligne2":"","cp":"69009","ville":"Lyon","id_pays":63,"pays_code":"FR","pays":"France"}},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/DuplicateName"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/suppliers/{id}":{"get":{"operationId":"getSupplier","x-wanapos-slug":"un-fournisseur","tags":["Classements"],"summary":"Lire un fournisseur","description":"Renvoie un fournisseur par son identifiant, qu'il soit archivé ou non.","x-wanapos-scope":"read_products","x-wanapos-kind":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Identifiant du fournisseur (champ `id`).","example":7}],"responses":{"200":{"description":"Le fournisseur.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierResponse"},"example":{"data":{"id":7,"name":"Maison Verdier","commercial1":"Julie Arnaud","commercial2":"","tel":"0472000000","mobile":"","email":"contact@maison-verdier.example","tva_intra":"","notes":"","archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00","adresse":{"ligne1":"4 quai des Tanneurs","ligne2":"","cp":"69009","ville":"Lyon","id_pays":63,"pays_code":"FR","pays":"France"}},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"patch":{"operationId":"updateSupplier","x-wanapos-slug":"modification-d-un-fournisseur","tags":["Classements"],"summary":"Modifier un fournisseur","description":"Modifie un fournisseur et renvoie sa fiche après modification.\n\nLa modification est partielle : seuls les champs envoyés changent. Il n'existe pas de suppression : pour retirer un élément, archivez-le avec `archived` à `true`. Les produits qui le portent le gardent. Pour vider un champ texte, envoyez-le avec une chaîne vide.\n\nUn nom déjà pris est refusé avec l'erreur `duplicate_name`, qui donne l'identifiant existant : réutilisez-le plutôt que de créer un doublon. La comparaison ne tient compte ni des majuscules, ni des accents, ni des espaces autour, et inclut les éléments archivés.","x-wanapos-scope":"write_products","x-wanapos-kind":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Identifiant du fournisseur (champ `id`).","example":7},{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierInput"},"example":{"mobile":"0611223344","adresse":{"ville":"Villeurbanne","cp":"69100"}}}}},"responses":{"200":{"description":"Le fournisseur après modification.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierResponse"},"example":{"data":{"id":7,"name":"Maison Verdier","commercial1":"Julie Arnaud","commercial2":"","tel":"0472000000","mobile":"","email":"contact@maison-verdier.example","tva_intra":"","notes":"","archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00","adresse":{"ligne1":"4 quai des Tanneurs","ligne2":"","cp":"69009","ville":"Lyon","id_pays":63,"pays_code":"FR","pays":"France"}},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/DuplicateName"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/collections":{"get":{"operationId":"listCollections","x-wanapos-slug":"collections","tags":["Classements"],"summary":"Lister les collections","description":"Renvoie les collections du compte, par identifiant croissant. C'est ici que se traduit le `collec.id` d'un produit.\n\nLe parcours se fait par curseur : tant que `meta.has_more` vaut `true`, rappelez l'adresse avec `after` égal à `meta.next_after`. Les éléments archivés ne sont renvoyés qu'avec `archived=true`.","x-wanapos-scope":"read_products","x-wanapos-kind":"read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Nombre d'éléments par page, de 1 à 100. 50 par défaut."},{"name":"after","in":"query","required":false,"schema":{"type":"integer"},"description":"Curseur de parcours : ne renvoie que les éléments dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur `next_after` de la réponse précédente."},{"name":"archived","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour inclure aussi les éléments archivés. `false` par défaut : seuls les éléments en service sont renvoyés.","example":true}],"responses":{"200":{"description":"Une page de collections.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionListResponse"},"example":{"data":[{"id":3,"name":"Printemps 2027","archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00"}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1,"has_more":false,"next_after":0}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"createCollection","x-wanapos-slug":"creation-d-une-collection","tags":["Classements"],"summary":"Créer une collection","description":"Crée une collection et la renvoie.\n\nUn nom déjà pris est refusé avec l'erreur `duplicate_name`, qui donne l'identifiant existant : réutilisez-le plutôt que de créer un doublon. La comparaison ne tient compte ni des majuscules, ni des accents, ni des espaces autour, et inclut les éléments archivés.","x-wanapos-scope":"write_products","x-wanapos-kind":"write","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionInput"},"example":{"name":"Printemps 2027"}}}},"responses":{"201":{"description":"La collection créée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"},"example":{"data":{"id":3,"name":"Printemps 2027","archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00"},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/DuplicateName"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/collections/{id}":{"patch":{"operationId":"updateCollection","x-wanapos-slug":"modification-d-une-collection","tags":["Classements"],"summary":"Renommer ou archiver une collection","description":"Renomme ou archive une collection, et la renvoie après modification.\n\nLa modification est partielle : seuls les champs envoyés changent. Il n'existe pas de suppression : pour retirer un élément, archivez-le avec `archived` à `true`. Les produits qui le portent le gardent.\n\nUn nom déjà pris est refusé avec l'erreur `duplicate_name`, qui donne l'identifiant existant : réutilisez-le plutôt que de créer un doublon. La comparaison ne tient compte ni des majuscules, ni des accents, ni des espaces autour, et inclut les éléments archivés.","x-wanapos-scope":"write_products","x-wanapos-kind":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Identifiant de la collection (champ `id`).","example":3},{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionInput"},"example":{"name":"Printemps-été 2027"}}}},"responses":{"200":{"description":"La collection après modification.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"},"example":{"data":{"id":3,"name":"Printemps 2027","archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00"},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/DuplicateName"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/categories":{"get":{"operationId":"listCategories","x-wanapos-slug":"categories","tags":["Classements"],"summary":"Lister les catégories","description":"Renvoie les catégories du compte, tous niveaux confondus, par identifiant croissant. Les catégories forment une arborescence de 5 niveaux au plus : chacune donne son parent (`id_parent`), son niveau et son chemin complet depuis la racine (`chemin`). Pour reconstruire l'arbre, parcourez toute la liste puis regroupez par `id_parent`.\n\nLe parcours se fait par curseur : tant que `meta.has_more` vaut `true`, rappelez l'adresse avec `after` égal à `meta.next_after`. Les éléments archivés ne sont renvoyés qu'avec `archived=true`.","x-wanapos-scope":"read_products","x-wanapos-kind":"read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Nombre d'éléments par page, de 1 à 100. 50 par défaut."},{"name":"after","in":"query","required":false,"schema":{"type":"integer"},"description":"Curseur de parcours : ne renvoie que les éléments dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur `next_after` de la réponse précédente."},{"name":"archived","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour inclure aussi les éléments archivés. `false` par défaut : seuls les éléments en service sont renvoyés.","example":true}],"responses":{"200":{"description":"Une page de catégories.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryListResponse"},"example":{"data":[{"id":12,"name":"Chemises","id_parent":5,"niveau":3,"chemin":["Vêtements","Homme","Chemises"],"archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00"}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1,"has_more":false,"next_after":0}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"createCategory","x-wanapos-slug":"creation-d-une-categorie","tags":["Classements"],"summary":"Créer une catégorie","description":"Crée une catégorie et la renvoie. Sans `id_parent`, elle est créée au premier niveau ; avec `id_parent`, elle devient une sous-catégorie de cette catégorie. L'arborescence est limitée à 5 niveaux, et on ne crée rien sous une catégorie archivée.\n\nUn nom déjà pris est refusé avec l'erreur `duplicate_name`, qui donne l'identifiant existant : réutilisez-le plutôt que de créer un doublon. La comparaison ne tient compte ni des majuscules, ni des accents, ni des espaces autour, et inclut les éléments archivés. Pour une catégorie, le nom doit être unique parmi les catégories du même parent seulement.","x-wanapos-scope":"write_products","x-wanapos-kind":"write","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryInput"},"example":{"name":"Chemises","id_parent":5}}}},"responses":{"201":{"description":"La catégorie créée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryResponse"},"example":{"data":{"id":12,"name":"Chemises","id_parent":5,"niveau":3,"chemin":["Vêtements","Homme","Chemises"],"archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00"},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/DuplicateName"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/categories/{id}":{"patch":{"operationId":"updateCategory","x-wanapos-slug":"modification-d-une-categorie","tags":["Classements"],"summary":"Renommer ou archiver une catégorie","description":"Renomme ou archive une catégorie, et la renvoie après modification. Une catégorie ne change pas de parent.\n\nLa modification est partielle : seuls les champs envoyés changent. Il n'existe pas de suppression : pour retirer un élément, archivez-le avec `archived` à `true`. Les produits qui le portent le gardent.\n\nUne catégorie qui a des sous-catégories en service ne peut pas être archivée : archivez d'abord ses sous-catégories. À l'inverse, on ne remet pas en service une catégorie dont le parent est archivé.\n\nUn nom déjà pris est refusé avec l'erreur `duplicate_name`, qui donne l'identifiant existant : réutilisez-le plutôt que de créer un doublon. La comparaison ne tient compte ni des majuscules, ni des accents, ni des espaces autour, et inclut les éléments archivés.","x-wanapos-scope":"write_products","x-wanapos-kind":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Identifiant de la catégorie (champ `id`).","example":12},{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryInput"},"example":{"name":"Chemises et polos"}}}},"responses":{"200":{"description":"La catégorie après modification.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryResponse"},"example":{"data":{"id":12,"name":"Chemises","id_parent":5,"niveau":3,"chemin":["Vêtements","Homme","Chemises"],"archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00"},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/DuplicateName"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/custom-lists":{"get":{"operationId":"listCustomLists","x-wanapos-slug":"listes-personnalisees","tags":["Classements"],"summary":"Lister les listes personnalisées","description":"Chaque compte dispose de trois listes personnalisées pour classer ses produits selon ses propres critères (une matière, une saison, un rayon). Cette adresse renvoie les trois, avec le nom que le commerçant leur a donné : appelez-la pour savoir ce que signifient `id_custom_list_1`, `id_custom_list_2` et `id_custom_list_3` dans un produit.\n\nLes valeurs de chaque liste se lisent par `GET /v1/custom-lists/{list}/values`. Une liste dont `affiche` vaut `false` n'est pas utilisée par le commerçant. Le nom et l'affichage d'une liste se modifient par `PATCH /v1/custom-lists/{list}`.","x-wanapos-scope":"read_products","x-wanapos-kind":"read","responses":{"200":{"description":"Les trois listes personnalisées.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomListListResponse"},"example":{"data":[{"id_list":1,"champ":"id_custom_list_1","libelle":"Matière","affiche":true,"nb_values":8},{"id_list":2,"champ":"id_custom_list_2","libelle":"Customisé 2","affiche":false,"nb_values":0},{"id_list":3,"champ":"id_custom_list_3","libelle":"Customisé 3","affiche":false,"nb_values":0}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":3}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/custom-lists/{list}":{"patch":{"operationId":"updateCustomList","x-wanapos-slug":"modification-d-une-liste-personnalisee","tags":["Classements"],"summary":"Renommer ou afficher une liste personnalisée","description":"Donne son nom à l'une des trois listes personnalisées, ou change son affichage dans les fiches produit, et la renvoie après modification.\n\nC'est l'appel à faire pour mettre une liste en service : donnez-lui un `libelle` parlant (« Matière », « Saison ») et passez `affiche` à `true`, puis ajoutez ses valeurs par `POST /v1/custom-lists/{list}/values`. Avant de renommer une liste, lisez `GET /v1/custom-lists` : si elle porte déjà un nom choisi par le commerçant ou contient des valeurs, elle est utilisée, et la renommer changerait le sens de ce que portent ses produits.\n\nLa modification est partielle : seuls les champs envoyés changent. Il y a toujours exactement trois listes : on ne peut ni en créer ni en supprimer.","x-wanapos-scope":"write_products","x-wanapos-kind":"write","parameters":[{"name":"list","in":"path","required":true,"schema":{"type":"integer"},"description":"Numéro de la liste personnalisée : 1, 2 ou 3 (voir `GET /v1/custom-lists`).","example":1},{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomListInput"},"example":{"libelle":"Matière","affiche":true}}}},"responses":{"200":{"description":"La liste après modification.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomListResponse"},"example":{"data":{"id_list":1,"champ":"id_custom_list_1","libelle":"Matière","affiche":true,"nb_values":0},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/custom-lists/{list}/values":{"get":{"operationId":"listCustomListValues","x-wanapos-slug":"valeurs-d-une-liste-personnalisee","tags":["Classements"],"summary":"Lister les valeurs d'une liste personnalisée","description":"Renvoie les valeurs d'une des trois listes personnalisées, par identifiant croissant. C'est ici que se traduit l'identifiant porté par `id_custom_list_1`, `id_custom_list_2` ou `id_custom_list_3` dans un produit.\n\nLe parcours se fait par curseur : tant que `meta.has_more` vaut `true`, rappelez l'adresse avec `after` égal à `meta.next_after`. Les éléments archivés ne sont renvoyés qu'avec `archived=true`.","x-wanapos-scope":"read_products","x-wanapos-kind":"read","parameters":[{"name":"list","in":"path","required":true,"schema":{"type":"integer"},"description":"Numéro de la liste personnalisée : 1, 2 ou 3 (voir `GET /v1/custom-lists`).","example":1},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Nombre d'éléments par page, de 1 à 100. 50 par défaut."},{"name":"after","in":"query","required":false,"schema":{"type":"integer"},"description":"Curseur de parcours : ne renvoie que les éléments dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur `next_after` de la réponse précédente."},{"name":"archived","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour inclure aussi les éléments archivés. `false` par défaut : seuls les éléments en service sont renvoyés.","example":true}],"responses":{"200":{"description":"Une page de valeurs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomListValueListResponse"},"example":{"data":[{"id":4,"id_list":1,"name":"Coton bio","archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00"}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1,"has_more":false,"next_after":0}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"operationId":"createCustomListValue","x-wanapos-slug":"creation-d-une-valeur-de-liste","tags":["Classements"],"summary":"Ajouter une valeur à une liste personnalisée","description":"Ajoute une valeur à l'une des trois listes personnalisées et la renvoie.\n\nUn nom déjà pris est refusé avec l'erreur `duplicate_name`, qui donne l'identifiant existant : réutilisez-le plutôt que de créer un doublon. La comparaison ne tient compte ni des majuscules, ni des accents, ni des espaces autour, et inclut les éléments archivés. Le nom doit être unique dans la liste concernée.","x-wanapos-scope":"write_products","x-wanapos-kind":"write","parameters":[{"name":"list","in":"path","required":true,"schema":{"type":"integer"},"description":"Numéro de la liste personnalisée : 1, 2 ou 3 (voir `GET /v1/custom-lists`).","example":1},{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomListValueInput"},"example":{"name":"Coton bio"}}}},"responses":{"201":{"description":"La valeur créée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomListValueResponse"},"example":{"data":{"id":4,"id_list":1,"name":"Coton bio","archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00"},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/DuplicateName"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/custom-lists/{list}/values/{id}":{"patch":{"operationId":"updateCustomListValue","x-wanapos-slug":"modification-d-une-valeur-de-liste","tags":["Classements"],"summary":"Renommer ou archiver une valeur de liste","description":"Renomme ou archive une valeur d'une liste personnalisée, et la renvoie après modification. La valeur doit appartenir à la liste donnée dans l'adresse, sinon elle est introuvable.\n\nLa modification est partielle : seuls les champs envoyés changent. Il n'existe pas de suppression : pour retirer un élément, archivez-le avec `archived` à `true`. Les produits qui le portent le gardent.\n\nUn nom déjà pris est refusé avec l'erreur `duplicate_name`, qui donne l'identifiant existant : réutilisez-le plutôt que de créer un doublon. La comparaison ne tient compte ni des majuscules, ni des accents, ni des espaces autour, et inclut les éléments archivés.","x-wanapos-scope":"write_products","x-wanapos-kind":"write","parameters":[{"name":"list","in":"path","required":true,"schema":{"type":"integer"},"description":"Numéro de la liste personnalisée : 1, 2 ou 3 (voir `GET /v1/custom-lists`).","example":1},{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Identifiant de la valeur (champ `id`).","example":4},{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean"},"description":"`true` pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec `meta.dry_run` à `true`. L'identifiant renvoyé n'est alors pas réservé."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomListValueInput"},"example":{"archived":true}}}},"responses":{"200":{"description":"La valeur après modification.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomListValueResponse"},"example":{"data":{"id":4,"id_list":1,"name":"Coton bio","archived":false,"date_creation":"2026-03-14T10:22:00+01:00","date_update":"2026-10-02T16:05:00+02:00"},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/DuplicateName"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/AccountBusy"}}}},"/v1/shops":{"get":{"operationId":"listShops","x-wanapos-slug":"magasins","tags":["Compte"],"summary":"Lister les magasins et leurs points de caisse","description":"Renvoie tous les magasins du compte avec leur adresse, leur téléphone, leur taux de TVA par défaut et leurs points de caisse. Toute clé valide peut l'appeler.\n\nC'est ici que se traduisent les identifiants `id_shop` et `id_point_caisse` rencontrés ailleurs (lignes de vente, prix d'un produit par magasin, magasin d'origine d'un client). Les magasins archivés sont listés aussi, en fin de liste, pour que d'anciennes ventes restent lisibles : testez `archived` et `actif` avant de considérer qu'un magasin est en service.\n\nLa liste est courte et renvoyée en une seule fois, sans paramètre. `GET /v1/me` donne une version réduite de cette liste, limitée aux magasins non archivés.","x-wanapos-scope":"","x-wanapos-kind":"read","responses":{"200":{"description":"Les magasins du compte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopListResponse"},"example":{"data":[{"id":1,"name":"Magasin principal","tel":"0102030405","tva_taux":20,"actif":true,"archived":false,"date_creation":"2025-03-12T10:04:11+01:00","adresse":{"ligne1":"12 rue des Lilas","ligne2":"","cp":"69002","ville":"Lyon","id_pays":63,"pays_code":"FR","pays":"France"},"points_caisse":[{"id":1,"name":"Point de caisse 1","actif":true,"date_creation":"2025-03-12T10:04:11+01:00"}]}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/users":{"get":{"operationId":"listUsers","x-wanapos-slug":"utilisateurs","tags":["Compte"],"summary":"Lister les utilisateurs du compte","description":"Renvoie les utilisateurs du compte, c'est-à-dire les personnes qui se connectent à l'application : leur identifiant, le nom qu'elles se sont donné, leur profil et leur point de caisse principal. Permission requise : `read_users`.\n\nL'adresse mail d'un utilisateur n'est jamais renvoyée, pas plus qu'aucune donnée de connexion. `alias` est souvent vide pour le titulaire du compte : utilisez `titulaire` pour le reconnaître.\n\nLe profil indique le rôle de l'utilisateur. Le détail de ce qu'un profil autorise n'est pas encore disponible par l'API. Les utilisateurs archivés sont listés aussi, en fin de liste.\n\nLa liste est courte et renvoyée en une seule fois, sans paramètre.","x-wanapos-scope":"read_users","x-wanapos-kind":"read","responses":{"200":{"description":"Les utilisateurs du compte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserListResponse"},"example":{"data":[{"id":2137,"alias":"","titulaire":true,"id_profil":1,"profil":"admin","profil_personnalise":false,"id_point_caisse_principal":1,"archived":false,"date_creation":"2025-03-12T10:04:11+01:00"},{"id":2201,"alias":"Camille","titulaire":false,"id_profil":3,"profil":"vendeur","profil_personnalise":false,"id_point_caisse_principal":1,"archived":false,"date_creation":"2025-06-02T09:30:00+02:00"}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":2}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/payment-methods":{"get":{"operationId":"listPaymentMethods","x-wanapos-slug":"moyens-de-paiement","tags":["Référentiels"],"summary":"Lister les moyens de paiement","description":"Renvoie les moyens de paiement du compte : ceux d'origine (espèces, carte bancaire, chèque, avoir, crédit) et ceux que le commerçant a créés. Toute clé valide peut l'appeler.\n\n`actif` dit si le moyen de paiement est proposé au moment d'encaisser. Les moyens archivés sont listés aussi, en fin de liste.\n\nLa liste est courte et renvoyée en une seule fois, sans paramètre.","x-wanapos-scope":"","x-wanapos-kind":"read","responses":{"200":{"description":"Les moyens de paiement du compte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentMethodListResponse"},"example":{"data":[{"id":1,"name":"Espèces","actif":true,"is_default":true,"position":1,"archived":false},{"id":2,"name":"Carte bancaire","actif":true,"is_default":true,"position":2,"archived":false},{"id":6,"name":"Virement","actif":true,"is_default":false,"position":6,"archived":false}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":3}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/promotions":{"get":{"operationId":"listPromotions","x-wanapos-slug":"promotions","tags":["Référentiels"],"summary":"Lister les promotions","description":"Renvoie les promotions du compte, archivées comprises, par identifiant croissant. Toute clé valide peut l'appeler.\n\nC'est ici que se traduit l'`id_promotion` d'une ligne de vente. Une promotion est soit une remise en pourcentage (`mode` = `pc`), soit un prix fixe (`mode` = `pf`). Elle s'applique entre `start` et `end`, dans les magasins de `id_shops`. La liste des produits rattachés à une promotion n'est pas renvoyée.\n\nLe parcours se fait par curseur : tant que `meta.has_more` vaut `true`, rappelez l'adresse avec `after` égal à `meta.next_after`.","x-wanapos-scope":"","x-wanapos-kind":"read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Nombre d'éléments par page, de 1 à 100. 50 par défaut."},{"name":"after","in":"query","required":false,"schema":{"type":"integer"},"description":"Curseur de parcours : ne renvoie que les éléments dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur `next_after` de la réponse précédente."}],"responses":{"200":{"description":"Une page de promotions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromotionListResponse"},"example":{"data":[{"id":14,"name":"Soldes d'hiver","mode":"pc","start":"2027-01-06","end":"2027-02-02","remise_pc":30,"arrondi":"entier_inf","prix":0,"apply_impact_pv":false,"apply_impact_shop":false,"id_shops":[1,2],"archived":false,"date_creation":"2026-12-18T16:20:05+01:00","date_update":"2026-12-19T09:02:40+01:00"}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":1,"has_more":false,"next_after":0}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/customer-fields":{"get":{"operationId":"getCustomerFields","x-wanapos-slug":"champs-de-la-fiche-client","tags":["Référentiels"],"summary":"Lire la définition des champs de la fiche client","description":"Renvoie la liste des champs d'un client, avec le libellé que le commerçant voit dans ses écrans, et les valeurs acceptées pour la civilité. Toute clé valide peut l'appeler.\n\nAppelez cette adresse avant de créer ou de modifier des clients. Chaque compte dispose de neuf champs personnalisés (`libre_1` à `libre_3`, `custom_io_1` à `custom_io_3`, `custom_date_1` à `custom_date_3`) dont le sens est propre au commerçant : `libelle` dit ce qu'il y range. Un champ dont `affiche` vaut `false` n'est pas utilisé dans ses écrans : évitez de le remplir sans raison, même si l'API l'accepte.\n\n`champ` reprend exactement le nom du champ dans un client, avec un point pour un champ de l'adresse (`adresse.cp`).","x-wanapos-scope":"","x-wanapos-kind":"read","responses":{"200":{"description":"La définition des champs de la fiche client.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerFieldsResponse"},"example":{"data":{"civilites":["","M.","Mme","Mlle","Sct"],"champs":[{"champ":"nom","libelle":"Nom","type":"texte","affiche":true,"personnalise":false},{"champ":"adresse.cp","libelle":"CP","type":"texte","affiche":true,"personnalise":false},{"champ":"libre_1","libelle":"Pointure","type":"texte","affiche":true,"personnalise":true},{"champ":"custom_date_1","libelle":"Date d'anniversaire","type":"date","affiche":true,"personnalise":true}]},"meta":{"request_id":"3f9a1c0b7d2e4a61"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/countries":{"get":{"operationId":"listCountries","x-wanapos-slug":"pays","tags":["Référentiels"],"summary":"Lister les pays","description":"Renvoie la liste des pays connus de Wanapos, par ordre alphabétique. Elle est la même pour tous les comptes. Toute clé valide peut l'appeler.\n\n`pays_code` est la valeur à donner dans `adresse.pays_code` pour créer ou modifier un client. La liste compte environ deux cents lignes et est renvoyée en une seule fois, sans paramètre : inutile de la relire à chaque appel.","x-wanapos-scope":"","x-wanapos-kind":"read","responses":{"200":{"description":"Les pays.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountryListResponse"},"example":{"data":[{"id_pays":20,"pays_code":"BE","pays":"Belgique"},{"id_pays":63,"pays_code":"FR","pays":"France"}],"meta":{"request_id":"3f9a1c0b7d2e4a61","count":2}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/InvalidParameter"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/openapi.json":{"get":{"operationId":"getOpenApi","x-wanapos-slug":"description-openapi","tags":["Technique"],"summary":"Description technique de l'API (OpenAPI 3)","security":[],"description":"Renvoie ce document. Adresse ouverte sans clé : elle ne contient aucune donnée de compte. Le document est renvoyé tel quel, sans l'enveloppe `data`.","responses":{"200":{"description":"Le document OpenAPI.","content":{"application/json":{"schema":{"type":"object"}}}}},"x-wanapos-scope":"","x-wanapos-kind":"read"}},"/v1/documentation.md":{"get":{"operationId":"getDocumentationMarkdown","x-wanapos-slug":"documentation-markdown","tags":["Technique"],"security":[],"summary":"Documentation complète en texte brut (Markdown)","description":"Renvoie toute la documentation de l'API en Markdown, générée à partir de la description technique. Adresse ouverte sans clé. C'est le document à transmettre à un assistant IA pour qu'il sache utiliser l'API.","x-wanapos-scope":"","x-wanapos-kind":"read","responses":{"200":{"description":"La documentation en Markdown.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Clé d'API Wanapos, de la forme `wps_…`, envoyée dans l'en-tête `Authorization: Bearer VOTRE_CLE`."}},"responses":{"Unauthorized":{"description":"Clé absente, inconnue ou révoquée. Codes : `missing_key`, `invalid_key`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Appel refusé pour ce compte ou cette clé. Codes : `api_not_activated`, `account_not_eligible`, `access_blocked`, `missing_scope`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"TooManyRequests":{"description":"Quota dépassé. Codes : `rate_limited`, `daily_quota_exceeded`, `too_many_failed_attempts`. L'en-tête `Retry-After` indique combien de secondes attendre.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"ValidationFailed":{"description":"Données envoyées invalides. Code : `validation_failed`. Le champ `details` liste chaque erreur.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"L'élément demandé n'existe pas sur ce compte. Code : `resource_not_found`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"InvalidParameter":{"description":"Un paramètre est absent, inconnu ou invalide. Code : `invalid_parameter`. Le champ `field` nomme le paramètre.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"DuplicateEmail":{"description":"Un client actif porte déjà cette adresse mail. Code : `duplicate_email`. Le message et `details` donnent les identifiants des clients existants. Rien n'a été enregistré.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"AccountBusy":{"description":"Une autre écriture est en cours sur ce compte. Code : `account_busy`. Renvoyer la même requête après le délai de l'en-tête `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"PointsOutOfRange":{"description":"L'ajustement ferait passer le solde sous 0 ou au-dessus de 1 000 000. Code : `points_out_of_range`. Le message donne le solde actuel. Rien n'a été modifié.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"IdempotencyKeyRequired":{"description":"L'en-tête `Idempotency-Key` est absent ou mal formé. Codes : `idempotency_key_required`, `idempotency_key_invalid`, `invalid_json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"DuplicateBarcode":{"description":"Une variante en service d'un autre produit porte déjà ce code-barres externe, ou le même code est donné à deux variantes de l'envoi. Code : `duplicate_barcode`. Le message et `details` donnent les identifiants des produits concernés. Rien n'a été enregistré.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"DuplicateName":{"description":"Ce nom est déjà porté par un autre élément du même classement. Code : `duplicate_name`. Le message et l'indication donnent l'identifiant existant. Rien n'a été enregistré.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"schemas":{"Meta":{"type":"object","required":["request_id"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel, à communiquer à l'assistance en cas de problème."}}},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","hint","field","details","request_id"],"properties":{"code":{"type":"string","description":"Code stable de l'erreur, à utiliser dans un programme (exemple : `missing_scope`)."},"message":{"type":"string","description":"Ce qui ne va pas."},"hint":{"type":"string","description":"Ce qu'il faut faire pour corriger."},"field":{"type":"string","description":"Champ, paramètre ou permission concerné. Chaîne vide s'il n'y en a pas un seul."},"details":{"type":"array","description":"Liste détaillée des erreurs de validation.","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string"},"message":{"type":"string"}}}},"request_id":{"type":"string","description":"Identifiant de l'appel."}}}}},"Quota":{"type":"object","description":"État d'un quota.","required":["limit","remaining","reset_at"],"properties":{"limit":{"type":"integer","description":"Nombre d'appels autorisés sur la période."},"remaining":{"type":"integer","description":"Nombre d'appels encore disponibles sur la période en cours."},"reset_at":{"type":"string","format":"date-time","description":"Date et heure de remise à zéro du compteur (ISO 8601)."}}},"MeResponse":{"type":"object","required":["data","meta"],"properties":{"meta":{"$ref":"#/components/schemas/Meta"},"data":{"type":"object","required":["account","shops","api_key","quotas","limits","api"],"properties":{"account":{"type":"object","description":"Le compte Wanapos auquel la clé est rattachée.","required":["id","name","currency","timezone"],"properties":{"id":{"type":"integer","description":"Identifiant du compte."},"name":{"type":"string","description":"Nom du compte, tel que le commerçant l'a saisi."},"currency":{"type":"string","description":"Devise du compte, code ISO 4217 (exemple : EUR)."},"timezone":{"type":"string","description":"Fuseau horaire utilisé pour les dates et pour la remise à zéro des quotas."}}},"shops":{"type":"array","description":"Magasins du compte, hors magasins archivés.","items":{"type":"object","required":["id","name","active"],"properties":{"id":{"type":"integer","description":"Identifiant du magasin, à utiliser dans les autres appels."},"name":{"type":"string","description":"Nom du magasin."},"active":{"type":"boolean","description":"Le magasin est actif."}}}},"api_key":{"type":"object","description":"La clé utilisée pour cet appel.","required":["name","hint","scopes","created_at"],"properties":{"name":{"type":"string","description":"Nom donné à la clé par le titulaire du compte."},"hint":{"type":"string","description":"Début et fin de la clé, pour la reconnaître. Ne permet pas de la reconstituer."},"scopes":{"type":"array","description":"Permissions portées par la clé.","items":{"type":"string"}},"created_at":{"type":"string","description":"Date de création de la clé (ISO 8601)."}}},"quotas":{"type":"object","description":"État des quotas du compte, cet appel compris.","required":["per_minute","reads_per_day","writes_per_day"],"properties":{"per_minute":{"$ref":"#/components/schemas/Quota"},"reads_per_day":{"$ref":"#/components/schemas/Quota"},"writes_per_day":{"$ref":"#/components/schemas/Quota"}}},"limits":{"type":"object","description":"Plafonds à respecter dans les appels.","required":["max_page_size","default_page_size","max_items_per_write","max_body_bytes"],"properties":{"max_page_size":{"type":"integer","description":"Nombre maximal de résultats par page (paramètre `limit`)."},"default_page_size":{"type":"integer","description":"Nombre de résultats par page si `limit` n'est pas précisé."},"max_items_per_write":{"type":"integer","description":"Nombre maximal d'éléments dans un appel de création."},"max_body_bytes":{"type":"integer","description":"Taille maximale du contenu envoyé, en octets."}}},"api":{"type":"object","required":["version","documentation_url"],"properties":{"version":{"type":"string","description":"Version de l'API."},"documentation_url":{"type":"string","description":"Adresse de la documentation."}}}}}}},"Customer":{"type":"object","description":"Un client du compte. Les noms de champs sont ceux des événements sortants `client_create` et `client_update`.","required":["id","civilite","nom","prenom","nom_2","email","tel","mobile","bc_ext","remise_pc","notes","libre_1","libre_2","libre_3","custom_io_1","custom_io_2","custom_io_3","custom_date_1","custom_date_2","custom_date_3","news_sms","news_email","fidelite_active","actif","id_shop_origin","date_creation","date_update","adresse","fidelite","champs_personnalises"],"properties":{"id":{"type":"integer","description":"Identifiant du client."},"civilite":{"type":"string","description":"Civilité en clair (exemple : `Mme`). Chaîne vide si non renseignée."},"nom":{"type":"string","description":"Nom."},"prenom":{"type":"string","description":"Prénom."},"nom_2":{"type":"string","description":"Nom secondaire, facultatif. Chaîne vide si non renseigné."},"email":{"type":"string","description":"Adresse mail. Chaîne vide si non renseignée. Elle n'est pas unique : plusieurs clients peuvent porter la même."},"tel":{"type":"string","description":"Téléphone fixe."},"mobile":{"type":"string","description":"Téléphone mobile."},"bc_ext":{"type":"string","description":"Code-barres associé au client (carte de fidélité par exemple)."},"remise_pc":{"type":"integer","description":"Remise permanente accordée au client, en pourcentage."},"notes":{"type":"string","description":"Notes libres saisies par le commerçant."},"libre_1":{"type":"string","description":"Champ personnalisé texte n° 1. Son libellé est dans `champs_personnalises`."},"libre_2":{"type":"string","description":"Champ personnalisé texte n° 2."},"libre_3":{"type":"string","description":"Champ personnalisé texte n° 3."},"custom_io_1":{"type":"boolean","description":"Champ personnalisé oui/non n° 1."},"custom_io_2":{"type":"boolean","description":"Champ personnalisé oui/non n° 2."},"custom_io_3":{"type":"boolean","description":"Champ personnalisé oui/non n° 3."},"custom_date_1":{"type":"string","description":"Champ personnalisé date n° 1 (AAAA-MM-JJ). Chaîne vide si non renseignée."},"custom_date_2":{"type":"string","description":"Champ personnalisé date n° 2."},"custom_date_3":{"type":"string","description":"Champ personnalisé date n° 3."},"news_sms":{"type":"boolean","description":"Le client accepte de recevoir des SMS. À respecter avant tout envoi."},"news_email":{"type":"boolean","description":"Le client accepte de recevoir des mails. À respecter avant tout envoi."},"fidelite_active":{"type":"boolean","description":"Le client participe au programme de fidélité."},"actif":{"type":"boolean","description":"Toujours `true` : un client supprimé n'est jamais renvoyé par l'API."},"id_shop_origin":{"type":"integer","description":"Identifiant du magasin dans lequel le client a été créé (voir `shops` dans `GET /v1/me`). 0 si aucun."},"date_creation":{"type":"string","description":"Date de création de la fiche (ISO 8601)."},"date_update":{"type":"string","description":"Date de dernière modification de la fiche (ISO 8601)."},"adresse":{"type":"object","description":"Adresse postale du client.","required":["ligne1","ligne2","cp","ville","id_pays","pays_code","pays","tva_intra","archived"],"properties":{"ligne1":{"type":"string","description":"Adresse."},"ligne2":{"type":"string","description":"Complément d'adresse."},"cp":{"type":"string","description":"Code postal."},"ville":{"type":"string","description":"Ville."},"id_pays":{"type":"integer","description":"Identifiant interne du pays. 0 si non renseigné."},"pays_code":{"type":"string","description":"Code du pays sur deux lettres, ISO 3166-1 (exemple : `FR`). Chaîne vide si non renseigné."},"pays":{"type":"string","description":"Nom du pays."},"tva_intra":{"type":"string","description":"Numéro de TVA intracommunautaire."},"archived":{"type":"boolean","description":"L'adresse est archivée."}}},"fidelite":{"type":"object","description":"Fidélité et cumuls d'achats du client. Des zéros si le client n'a encore rien acheté.","required":["points_actuels","points_cumules","nb_fois_pts_utilises","last_pts_acquis","total_ca","total_qt","total_pa"],"properties":{"points_actuels":{"type":"integer","description":"Points disponibles aujourd'hui."},"points_cumules":{"type":"integer","description":"Total des points gagnés depuis l'origine."},"nb_fois_pts_utilises":{"type":"integer","description":"Nombre de fois où des points ont été utilisés."},"last_pts_acquis":{"type":"integer","description":"Points gagnés lors du dernier achat."},"total_ca":{"type":"number","description":"Montant total des achats du client, dans la devise du compte."},"total_qt":{"type":"integer","description":"Nombre total d'articles achetés."},"total_pa":{"type":"integer","description":"Nombre total de passages en caisse."}}},"champs_personnalises":{"type":"array","description":"Les neuf champs personnalisés du client, avec le libellé que le commerçant leur a donné. Mêmes valeurs que `libre_N`, `custom_io_N` et `custom_date_N`, présentées de façon lisible.","items":{"type":"object","description":"Un champ personnalisé.","required":["cle","libelle","type","affiche","valeur"],"properties":{"cle":{"type":"string","description":"Nom du champ dans l'objet client (exemple : `libre_1`)."},"libelle":{"type":"string","description":"Libellé choisi par le commerçant."},"type":{"type":"string","enum":["texte","oui_non","date"],"description":"Nature du champ."},"affiche":{"type":"boolean","description":"Le commerçant affiche ce champ dans son application."},"valeur":{"description":"Valeur du champ : texte, booléen ou date (AAAA-MM-JJ) selon `type`."}}}}}},"CustomerResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Customer"},"meta":{"$ref":"#/components/schemas/Meta"}}},"CustomerListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Clients correspondants, du plus ancien au plus récent. Liste vide si aucun.","items":{"$ref":"#/components/schemas/Customer"}},"meta":{"type":"object","required":["request_id","count","truncated"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre de clients renvoyés."},"truncated":{"type":"boolean","description":"`true` si la liste a été coupée à 50 clients : elle est alors incomplète, voir la description de l'adresse."}}}}},"CustomerExportResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Clients de la page, par identifiant croissant. Liste vide si aucun.","items":{"$ref":"#/components/schemas/Customer"}},"meta":{"type":"object","required":["request_id","count","has_more","next_after"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments dans cette page."},"has_more":{"type":"boolean","description":"`true` s'il reste une page à lire."},"next_after":{"type":"integer","description":"Valeur à passer dans `after` pour la page suivante. 0 quand le parcours est terminé."}}}}},"DeletedCustomersResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Clients supprimés, par identifiant croissant. Liste vide si aucun.","items":{"type":"object","required":["id","date_suppression"],"properties":{"id":{"type":"integer","description":"Identifiant du client supprimé."},"date_suppression":{"type":"string","description":"Date et heure de la suppression."}}}},"meta":{"type":"object","required":["request_id","count","has_more","next_after"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments dans cette page."},"has_more":{"type":"boolean","description":"`true` s'il reste une page à lire."},"next_after":{"type":"integer","description":"Valeur à passer dans `after` pour la page suivante. 0 quand le parcours est terminé."}}}}},"CustomerInput":{"type":"object","additionalProperties":false,"description":"Champs d'un client qui peuvent être écrits. Tout champ hors de cette liste est refusé.","properties":{"civilite":{"type":"string","description":"Civilité, parmi les valeurs exactes : chaîne vide, `M.`, `Mme`, `Mlle`, `Sct`. À la création, si elle est absente : la civilité par défaut réglée par le commerçant."},"nom":{"type":"string","description":"Nom. 40 caractères au maximum."},"prenom":{"type":"string","description":"Prénom. 40 caractères au maximum."},"nom_2":{"type":"string","description":"Nom secondaire, facultatif. Chaîne vide si non renseigné. 40 caractères au maximum."},"email":{"type":"string","description":"Adresse mail. Chaîne vide si non renseignée. Elle n'est pas unique : plusieurs clients peuvent porter la même. 50 caractères au maximum."},"tel":{"type":"string","description":"Téléphone fixe. 17 caractères au maximum."},"mobile":{"type":"string","description":"Téléphone mobile. 17 caractères au maximum."},"bc_ext":{"type":"string","description":"Code-barres associé au client (carte de fidélité par exemple). 32 caractères au maximum."},"remise_pc":{"type":"integer","description":"Remise permanente accordée au client, en pourcentage. Entier de 0 à 100."},"notes":{"type":"string","description":"Notes libres saisies par le commerçant. 5 000 caractères au maximum."},"libre_1":{"type":"string","description":"Champ personnalisé texte n° 1. Son libellé est dans `champs_personnalises`. 50 caractères au maximum."},"libre_2":{"type":"string","description":"Champ personnalisé texte n° 2. 50 caractères au maximum."},"libre_3":{"type":"string","description":"Champ personnalisé texte n° 3. 50 caractères au maximum."},"custom_io_1":{"type":"boolean","description":"Champ personnalisé oui/non n° 1."},"custom_io_2":{"type":"boolean","description":"Champ personnalisé oui/non n° 2."},"custom_io_3":{"type":"boolean","description":"Champ personnalisé oui/non n° 3."},"custom_date_1":{"type":"string","description":"Champ personnalisé date n° 1 (AAAA-MM-JJ). Chaîne vide si non renseignée. Format `AAAA-MM-JJ`. Chaîne vide pour effacer la date."},"custom_date_2":{"type":"string","description":"Champ personnalisé date n° 2. Format `AAAA-MM-JJ`. Chaîne vide pour effacer la date."},"custom_date_3":{"type":"string","description":"Champ personnalisé date n° 3. Format `AAAA-MM-JJ`. Chaîne vide pour effacer la date."},"news_sms":{"type":"boolean","description":"Le client accepte de recevoir des SMS. À respecter avant tout envoi. `false` à la création si absent : n'envoyez `true` que si la personne a donné son accord."},"news_email":{"type":"boolean","description":"Le client accepte de recevoir des mails. À respecter avant tout envoi. `false` à la création si absent : n'envoyez `true` que si la personne a donné son accord."},"fidelite_active":{"type":"boolean","description":"Le client participe au programme de fidélité. `true` à la création si absent."},"id_shop_origin":{"type":"integer","description":"Identifiant du magasin d'origine du client, parmi ceux listés par `GET /v1/me`. À la création, si absent : le premier magasin du compte."},"adresse":{"type":"object","description":"Adresse postale. Seuls les champs envoyés sont enregistrés ou modifiés.","additionalProperties":false,"properties":{"ligne1":{"type":"string","description":"Adresse. 50 caractères au maximum."},"ligne2":{"type":"string","description":"Complément d'adresse. 50 caractères au maximum."},"cp":{"type":"string","description":"Code postal. 9 caractères au maximum."},"ville":{"type":"string","description":"Ville. 30 caractères au maximum."},"pays_code":{"type":"string","description":"Code du pays à deux lettres (`FR`, `BE`, `CH`…). À la création, si absent : le pays du magasin d'origine."},"tva_intra":{"type":"string","description":"Numéro de TVA intracommunautaire. 32 caractères au maximum."}}}}},"SaleLine":{"type":"object","description":"Une ligne de vente : un article d'un ticket.","required":["id","date","date_creation","id_ticket","num_ticket","id_shop","id_point_caisse","type","id_product","id_variante_product","designation","variante","qt","pv_initial","remise_pc","remise_mt","val","val_ht","tva_mt","id_promotion","promotion","remarque"],"properties":{"id":{"type":"integer","description":"Identifiant de la ligne de vente."},"date":{"type":"string","description":"Date de la vente, au format `AAAA-MM-JJ`."},"date_creation":{"type":"string","description":"Date et heure d'enregistrement de la vente."},"id_ticket":{"type":"integer","description":"Identifiant du ticket auquel appartient la ligne. Toutes les lignes d'un même passage en caisse portent le même."},"num_ticket":{"type":"integer","description":"Numéro du ticket, tel qu'il est imprimé. 0 s'il est inconnu."},"id_shop":{"type":"integer","description":"Identifiant du magasin où la vente a eu lieu (voir `GET /v1/me`)."},"id_point_caisse":{"type":"integer","description":"Identifiant du point de caisse."},"type":{"type":"string","description":"Nature de la ligne : `product` pour un article, `carte_kdo` pour une carte cadeau."},"id_product":{"type":"integer","description":"Identifiant du produit. 0 pour une carte cadeau."},"id_variante_product":{"type":"integer","description":"Identifiant de la variante vendue. 0 pour une carte cadeau."},"designation":{"type":"string","description":"Désignation de l'article au moment de la vente. « Carte cadeau » pour une carte cadeau, sans autre détail."},"variante":{"type":"string","description":"Nom de la variante (taille, couleur…). Chaîne vide si le produit n'a pas de variante."},"qt":{"type":"integer","description":"Quantité. Négative pour un retour."},"pv_initial":{"type":"number","description":"Prix de vente unitaire TTC avant remise."},"remise_pc":{"type":"number","description":"Remise appliquée, en pourcentage."},"remise_mt":{"type":"number","description":"Montant de la remise, TTC."},"val":{"type":"number","description":"Montant TTC de la ligne, remise déduite. Négatif pour un retour."},"val_ht":{"type":"number","description":"Montant hors taxes de la ligne."},"tva_mt":{"type":"number","description":"Montant de TVA de la ligne."},"id_promotion":{"type":"integer","description":"Identifiant de la promotion appliquée. 0 si aucune."},"promotion":{"type":"string","description":"Nom de la promotion appliquée. Chaîne vide si aucune, ou si la promotion n'existe plus."},"remarque":{"type":"string","description":"Remarque saisie sur la ligne. Chaîne vide si aucune."}}},"CustomerPurchasesResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Lignes d'articles achetés, de la plus récente à la plus ancienne. Liste vide si le client n'a rien acheté sur la période.","items":{"$ref":"#/components/schemas/SaleLine"}},"meta":{"type":"object","required":["request_id","count","has_more","next_after"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre de lignes dans cette page."},"has_more":{"type":"boolean","description":"`true` s'il reste une page à lire."},"next_after":{"type":"integer","description":"Valeur à passer dans `after` pour la page suivante. 0 quand le parcours est terminé."}}}}},"LoyaltyProgram":{"type":"object","required":["actif","type","points_trigger","reward_type","remise_pc_val","include_reward_ticket","promo_compte","date_update"],"properties":{"actif":{"type":"boolean","description":"`true` si le programme de fidélité est activé sur le compte. S'il vaut `false`, les ventes ne rapportent aucun point."},"type":{"type":"string","description":"Comment un point se gagne : `ca` (un point par unité de monnaie dépensée), `qt` (un point par article acheté) ou `pa` (un point par passage en caisse)."},"points_trigger":{"type":"integer","description":"Nombre de points à atteindre pour déclencher la récompense."},"reward_type":{"type":"string","description":"Récompense accordée quand le seuil est atteint : `pourcentage` (une remise en pourcentage sur un ticket) ou `disabled` (aucune récompense automatique)."},"remise_pc_val":{"type":"integer","description":"Pourcentage de la remise accordée, quand `reward_type` vaut `pourcentage`."},"include_reward_ticket":{"type":"boolean","description":"`true` si le ticket qui utilise la récompense rapporte lui aussi des points."},"promo_compte":{"type":"boolean","description":"`true` si les articles en promotion ou en solde rapportent des points."},"date_update":{"type":"string","description":"Date du dernier réglage du programme. Chaîne vide si inconnue."}}},"LoyaltyProgramResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/LoyaltyProgram"},"meta":{"$ref":"#/components/schemas/Meta"}}},"LoyaltyAdjustmentInput":{"type":"object","additionalProperties":false,"required":["points","motif"],"properties":{"points":{"type":"integer","description":"Nombre de points à ajouter (positif) ou à retirer (négatif). Jamais 0. De -1000 à 1000 par appel."},"motif":{"type":"string","description":"Raison de l'ajustement, en quelques mots. Obligatoire, 100 caractères au maximum. Elle est inscrite dans le journal des modifications que le titulaire du compte consulte."}}},"LoyaltyAdjustment":{"type":"object","required":["id_client","ajustement","points_avant","points_actuels","motif"],"properties":{"id_client":{"type":"integer","description":"Identifiant du client."},"ajustement":{"type":"integer","description":"Nombre de points ajoutés (positif) ou retirés (négatif)."},"points_avant":{"type":"integer","description":"Solde de points avant l'ajustement."},"points_actuels":{"type":"integer","description":"Solde de points après l'ajustement."},"motif":{"type":"string","description":"Raison donnée pour l'ajustement."}}},"LoyaltyAdjustmentResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/LoyaltyAdjustment"},"meta":{"$ref":"#/components/schemas/Meta"}}},"ProductVariant":{"type":"object","description":"Une variante du produit. Un produit sans variante en a exactement une, la variante « produit seul » (`is_product` à `true`, `name` vide) : c'est elle qui porte ses codes et ses prix.","required":["id","is_product","name","position","bc_ext","ean_int","sku","impact_pa","pa_ht","impact_pv","prix","actif","date_creation","date_update"],"properties":{"id":{"type":"integer","description":"Identifiant de la variante. C'est le `id_variante_product` des lignes de vente."},"is_product":{"type":"boolean","description":"`true` pour la variante « produit seul » d'un produit sans variante."},"name":{"type":"string","description":"Nom de la variante (exemple : `M`, `Bleu / 42`). Chaîne vide pour la variante « produit seul »."},"position":{"type":"integer","description":"Rang d'affichage choisi par le commerçant."},"bc_ext":{"type":"string","description":"Code-barres externe, celui du fabricant (32 caractères au plus). Chaîne vide si non renseigné."},"ean_int":{"type":"string","description":"Code-barres interne, généré par Wanapos (13 chiffres). Chaîne vide si non renseigné."},"sku":{"type":"string","description":"Référence de la variante (SKU, 32 caractères au plus). Chaîne vide si non renseignée."},"impact_pa":{"type":"number","description":"Écart de prix d'achat de cette variante par rapport au `pa_ht` du produit. 0 le plus souvent."},"pa_ht":{"type":"number","description":"Prix d'achat hors taxes de cette variante : `pa_ht` du produit plus `impact_pa`."},"impact_pv":{"type":"number","description":"Écart de prix de vente de cette variante par rapport au `pv_ttc` du produit (exemple : 3 pour une taille vendue 3 de plus)."},"prix":{"type":"array","description":"Prix de vente de cette variante dans chaque magasin du compte, déjà calculé : `pv_ttc` du produit, plus `impact_pv` de la variante, plus `impact_pv` du magasin. Hors promotion. Une entrée par magasin, dans l'ordre de `magasins`.","items":{"type":"object","description":"Prix de vente dans un magasin.","required":["id_shop","pv_ttc"],"properties":{"id_shop":{"type":"integer","description":"Identifiant du magasin (voir `GET /v1/me`)."},"pv_ttc":{"type":"number","description":"Prix de vente toutes taxes comprises dans ce magasin, hors promotion."}}}},"actif":{"type":"boolean","description":"`true` pour une variante en service, `false` pour une variante désactivée."},"date_creation":{"type":"string","description":"Date de création, ISO 8601."},"date_update":{"type":"string","description":"Date de dernière modification de la variante, ISO 8601. Chaîne vide si inconnue."}}},"Product":{"type":"object","description":"Un produit du catalogue, avec ses variantes, ses codes et ses prix. Le stock n'en fait pas partie.","required":["id","designation","description","notes","ref_four","ref_interne","image_url","gestion_stock","variantes","favorite","archived","pa_ht","pv_ttc","eco_ttc","fournisseur","collec","categories","libre_1","libre_2","libre_3","id_custom_list_1","id_custom_list_2","id_custom_list_3","custom_io_1","custom_io_2","custom_io_3","custom_date_1","custom_date_2","custom_date_3","magasins","variantes_product","variantes_inactives","champs_personnalises","date_creation","date_update"],"properties":{"id":{"type":"integer","description":"Identifiant du produit. C'est le `id_product` des lignes de vente."},"designation":{"type":"string","description":"Nom du produit (50 caractères au plus)."},"description":{"type":"string","description":"Description du produit."},"notes":{"type":"string","description":"Notes internes du commerçant."},"ref_four":{"type":"string","description":"Référence du produit chez le fournisseur."},"ref_interne":{"type":"string","description":"Référence interne du commerçant."},"image_url":{"type":"string","description":"Adresse de l'image du produit (fichier JPEG), lisible sans clé. Chaîne vide si le produit n'a pas d'image. L'adresse ne change pas quand le commerçant remplace l'image."},"gestion_stock":{"type":"boolean","description":"`true` si le stock de ce produit est suivi."},"variantes":{"type":"boolean","description":"`true` si le produit se décline en variantes (tailles, couleurs…). `false` : il n'a que sa variante « produit seul »."},"favorite":{"type":"boolean","description":"`true` si le commerçant l'a placé dans ses favoris de caisse."},"archived":{"type":"boolean","description":"`true` si le produit est archivé : il n'est plus proposé à la vente, mais il reste lisible."},"pa_ht":{"type":"number","description":"Prix d'achat hors taxes du produit. Chaque variante peut s'en écarter (`impact_pa`)."},"pv_ttc":{"type":"number","description":"Prix de vente de base, toutes taxes comprises. Ce n'est pas forcément le prix payé en caisse : chaque variante et chaque magasin peuvent s'en écarter. Le prix réellement appliqué se lit dans `variantes_product[].prix`."},"eco_ttc":{"type":"number","description":"Montant de l'éco-participation, toutes taxes comprises, inclus dans le prix de vente. 0 s'il n'y en a pas."},"fournisseur":{"type":"object","description":"Fournisseur du produit.","required":["id","name"],"properties":{"id":{"type":"integer","description":"Identifiant du fournisseur. 0 si le produit n'en a pas."},"name":{"type":"string","description":"Nom du fournisseur. Chaîne vide si le produit n'en a pas."}}},"collec":{"type":"object","description":"Collection du produit.","required":["id","name"],"properties":{"id":{"type":"integer","description":"Identifiant de la collection. 0 si le produit n'en a pas."},"name":{"type":"string","description":"Nom de la collection. Chaîne vide si le produit n'en a pas."}}},"categories":{"type":"array","description":"Catégories du produit, du niveau le plus général au plus précis (cinq niveaux au plus). Liste vide si le produit n'est pas classé.","items":{"type":"object","description":"Une catégorie du produit.","required":["niveau","id","name"],"properties":{"niveau":{"type":"integer","description":"Niveau de la catégorie, de 1 (le plus général) à 5."},"id":{"type":"integer","description":"Identifiant de la catégorie."},"name":{"type":"string","description":"Nom de la catégorie."}}}},"libre_1":{"type":"string","description":"Champ personnalisé texte n° 1."},"libre_2":{"type":"string","description":"Champ personnalisé texte n° 2."},"libre_3":{"type":"string","description":"Champ personnalisé texte n° 3."},"id_custom_list_1":{"type":"integer","description":"Champ personnalisé liste n° 1 : identifiant de la valeur choisie, 0 si aucune. La valeur en clair est dans `champs_personnalises`."},"id_custom_list_2":{"type":"integer","description":"Champ personnalisé liste n° 2 : identifiant de la valeur choisie, 0 si aucune."},"id_custom_list_3":{"type":"integer","description":"Champ personnalisé liste n° 3 : identifiant de la valeur choisie, 0 si aucune."},"custom_io_1":{"type":"boolean","description":"Champ personnalisé oui/non n° 1."},"custom_io_2":{"type":"boolean","description":"Champ personnalisé oui/non n° 2."},"custom_io_3":{"type":"boolean","description":"Champ personnalisé oui/non n° 3."},"custom_date_1":{"type":"string","description":"Champ personnalisé date n° 1 (AAAA-MM-JJ). Chaîne vide si non renseigné."},"custom_date_2":{"type":"string","description":"Champ personnalisé date n° 2 (AAAA-MM-JJ). Chaîne vide si non renseigné."},"custom_date_3":{"type":"string","description":"Champ personnalisé date n° 3 (AAAA-MM-JJ). Chaîne vide si non renseigné."},"magasins":{"type":"array","description":"Ce que chaque magasin du compte change à ce produit : son écart de prix et son taux de TVA. Une entrée par magasin non archivé, dans l'ordre de `GET /v1/me`.","items":{"type":"object","description":"Réglages du produit dans un magasin.","required":["id_shop","impact_pv","tva_taux"],"properties":{"id_shop":{"type":"integer","description":"Identifiant du magasin (voir `GET /v1/me`)."},"impact_pv":{"type":"number","description":"Écart de prix de vente appliqué à ce produit dans ce magasin. 0 le plus souvent."},"tva_taux":{"type":"number","description":"Taux de TVA du produit dans ce magasin, en pourcentage (exemple : 20, 5.5)."}}}},"variantes_product":{"type":"array","description":"Variantes en service. Toujours au moins une : pour un produit sans variante, c'est sa variante « produit seul ». Les codes (`bc_ext`, `ean_int`, `sku`) et les prix par magasin sont ici, jamais sur le produit.","items":{"$ref":"#/components/schemas/ProductVariant"}},"variantes_inactives":{"type":"array","description":"Variantes désactivées : le commerçant les a retirées, Wanapos les conserve parce qu'elles ont déjà été vendues. Elles ne sont plus proposées à la vente et n'ont plus de stock. Liste vide le plus souvent. Utile pour retrouver le nom d'une variante citée dans une ancienne vente.","items":{"$ref":"#/components/schemas/ProductVariant"}},"champs_personnalises":{"type":"array","description":"Les douze champs personnalisés du produit, avec le libellé que le commerçant leur a donné. Mêmes valeurs que `libre_N`, `id_custom_list_N`, `custom_io_N` et `custom_date_N`, présentées de façon lisible. Pour une liste, `valeur` est la valeur choisie en clair.","items":{"type":"object","description":"Un champ personnalisé.","required":["cle","libelle","type","affiche","valeur"],"properties":{"cle":{"type":"string","description":"Nom du champ dans l'objet produit (exemple : `libre_1`)."},"libelle":{"type":"string","description":"Libellé choisi par le commerçant."},"type":{"type":"string","enum":["texte","liste","oui_non","date"],"description":"Nature du champ."},"affiche":{"type":"boolean","description":"Le commerçant affiche ce champ dans son application."},"valeur":{"description":"Valeur du champ : texte, valeur de liste en clair, booléen ou date (AAAA-MM-JJ) selon `type`."}}}},"date_creation":{"type":"string","description":"Date de création du produit, ISO 8601."},"date_update":{"type":"string","description":"Date de dernière modification de la fiche du produit, ISO 8601. Elle ne suit pas les changements de variantes ni de prix : ne vous en servez pas pour détecter ce qui a changé."}}},"ProductResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Product"},"meta":{"$ref":"#/components/schemas/Meta"}}},"ProductListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Produits de la page, par identifiant croissant. Liste vide si aucun.","items":{"$ref":"#/components/schemas/Product"}},"meta":{"type":"object","required":["request_id","count","has_more","next_after"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments dans cette page."},"has_more":{"type":"boolean","description":"`true` s'il reste une page à lire."},"next_after":{"type":"integer","description":"Valeur à passer dans `after` pour la page suivante. 0 quand le parcours est terminé."}}}}},"ProductLookupResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Produits correspondants, par identifiant croissant. Liste vide si aucun.","items":{"$ref":"#/components/schemas/Product"}},"meta":{"type":"object","required":["request_id","count","truncated"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre de produits renvoyés."},"truncated":{"type":"boolean","description":"`true` si plus de 50 produits correspondent : la liste est alors incomplète, voir la description de l'adresse."}}}}},"ProductInput":{"type":"object","additionalProperties":false,"required":["designation"],"description":"Champs d'un produit à créer. Tout champ hors de cette liste est refusé. Ne s'écrivent pas : l'identifiant, les dates, le code-barres interne `ean_int` (toujours généré par Wanapos), `archived`, `favorite`, l'image, l'écart de prix par magasin et le stock.","properties":{"designation":{"type":"string","description":"Nom du produit. Obligatoire, 50 caractères au maximum."},"description":{"type":"string","description":"Description. 1 500 caractères au maximum."},"notes":{"type":"string","description":"Notes internes. 500 caractères au maximum."},"ref_four":{"type":"string","description":"Référence du produit chez le fournisseur. 50 caractères au maximum."},"ref_interne":{"type":"string","description":"Référence interne. 50 caractères au maximum."},"gestion_stock":{"type":"boolean","description":"`true` pour suivre le stock de ce produit. Si absent : le réglage par défaut du commerçant."},"pa_ht":{"type":"number","description":"Prix d'achat hors taxes. 0 si absent."},"pv_ttc":{"type":"number","description":"Prix de vente de base, toutes taxes comprises. 0 si absent."},"eco_ttc":{"type":"number","description":"Éco-participation, toutes taxes comprises, incluse dans le prix de vente. 0 si absente."},"tva_taux":{"type":"number","description":"Taux de TVA du produit, en pourcentage (exemple : 20, 10, 5.5). Le taux doit exister dans Wanapos. Si absent : le taux de chaque magasin s'applique."},"fournisseur":{"type":"string","description":"Fournisseur, par son nom (3 à 50 caractères). Si aucun ne porte ce nom (sans tenir compte des majuscules, des accents ni des espaces autour), il est créé. Ne pas envoyer avec `id_fournisseur`."},"id_fournisseur":{"type":"integer","description":"Fournisseur, par son identifiant. Il doit exister. Ne pas envoyer avec `fournisseur`."},"collec":{"type":"string","description":"Collection, par son nom (3 à 50 caractères). Si aucune ne porte ce nom (sans tenir compte des majuscules, des accents ni des espaces autour), elle est créée. Ne pas envoyer avec `id_collec`."},"id_collec":{"type":"integer","description":"Collection, par son identifiant. Elle doit exister. Ne pas envoyer avec `collec`."},"categories":{"type":"array","description":"Catégorie du produit, donnée par son chemin complet, du niveau le plus général au plus précis (exemple : `[\"Vêtements\", \"Hauts\"]`). Un à cinq noms de 2 à 50 caractères. Les niveaux qui n'existent pas sont créés. Ne pas envoyer avec `id_categorie`.","items":{"type":"string"}},"id_categorie":{"type":"integer","description":"Catégorie la plus précise du produit, par son identifiant. Elle doit exister ; ses catégories parentes sont retrouvées seules. Ne pas envoyer avec `categories`."},"libre_1":{"type":"string","description":"Champ personnalisé texte n° 1. 50 caractères au maximum."},"libre_2":{"type":"string","description":"Champ personnalisé texte n° 2. 50 caractères au maximum."},"libre_3":{"type":"string","description":"Champ personnalisé texte n° 3. 50 caractères au maximum."},"custom_list_1":{"type":"string","description":"Champ personnalisé liste n° 1 : la valeur choisie, par son nom (2 à 50 caractères). Si la liste n° 1 ne contient pas cette valeur, elle y est ajoutée. Ne pas envoyer avec `id_custom_list_1`."},"custom_list_2":{"type":"string","description":"Champ personnalisé liste n° 2 : la valeur choisie, par son nom (2 à 50 caractères). Si la liste n° 2 ne contient pas cette valeur, elle y est ajoutée. Ne pas envoyer avec `id_custom_list_2`."},"custom_list_3":{"type":"string","description":"Champ personnalisé liste n° 3 : la valeur choisie, par son nom (2 à 50 caractères). Si la liste n° 3 ne contient pas cette valeur, elle y est ajoutée. Ne pas envoyer avec `id_custom_list_3`."},"id_custom_list_1":{"type":"integer","description":"Champ personnalisé liste n° 1 : la valeur choisie, par son identifiant. Elle doit exister dans cette liste."},"id_custom_list_2":{"type":"integer","description":"Champ personnalisé liste n° 2 : la valeur choisie, par son identifiant. Elle doit exister dans cette liste."},"id_custom_list_3":{"type":"integer","description":"Champ personnalisé liste n° 3 : la valeur choisie, par son identifiant. Elle doit exister dans cette liste."},"custom_io_1":{"type":"boolean","description":"Champ personnalisé oui/non n° 1. `false` si absent."},"custom_io_2":{"type":"boolean","description":"Champ personnalisé oui/non n° 2. `false` si absent."},"custom_io_3":{"type":"boolean","description":"Champ personnalisé oui/non n° 3. `false` si absent."},"custom_date_1":{"type":"string","description":"Champ personnalisé date n° 1, au format AAAA-MM-JJ."},"custom_date_2":{"type":"string","description":"Champ personnalisé date n° 2, au format AAAA-MM-JJ."},"custom_date_3":{"type":"string","description":"Champ personnalisé date n° 3, au format AAAA-MM-JJ."},"bc_ext":{"type":"string","description":"Code-barres externe (celui du fabricant) d'un produit SANS variante. 32 caractères au maximum. Refusé si `variantes_product` est envoyé : le code se donne alors sur chaque variante."},"sku":{"type":"string","description":"Référence SKU d'un produit SANS variante. 32 caractères au maximum. Refusé si `variantes_product` est envoyé."},"variantes_product":{"type":"array","description":"Variantes du produit (tailles, couleurs…), dans l'ordre d'affichage voulu. 1 à 100 variantes. Si ce champ est absent, le produit est créé sans variante. Chaque nom doit être différent.","items":{"type":"object","additionalProperties":false,"required":["name"],"description":"Une variante à créer.","properties":{"name":{"type":"string","description":"Nom de la variante (exemple : `M`, `Bleu / 42`). Obligatoire, 30 caractères au maximum."},"bc_ext":{"type":"string","description":"Code-barres externe de la variante. 32 caractères au maximum."},"sku":{"type":"string","description":"Référence SKU de la variante. 32 caractères au maximum."},"impact_pv":{"type":"number","description":"Écart de prix de vente par rapport au `pv_ttc` du produit (exemple : 3 pour une variante vendue 3 de plus). 0 si absent. Peut être négatif."},"impact_pa":{"type":"number","description":"Écart de prix d'achat par rapport au `pa_ht` du produit. 0 si absent. Peut être négatif."}}}}}},"ProductCreatedResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Product"},"meta":{"type":"object","required":["request_id","created_listings"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"dry_run":{"type":"boolean","description":"Présent et à `true` pour un essai à blanc : rien n'a été enregistré."},"created_listings":{"type":"array","description":"Fournisseur, collection, catégories et valeurs de liste créés au passage parce que leur nom était inconnu. Liste vide si tout existait déjà.","items":{"type":"object","required":["type","id","name"],"description":"Un classement créé au passage.","properties":{"type":{"type":"string","enum":["fournisseur","collec","categorie","custom_list_1","custom_list_2","custom_list_3"],"description":"Nature de ce qui a été créé."},"id":{"type":"integer","description":"Son identifiant."},"name":{"type":"string","description":"Son nom."}}}}}}}},"Shop":{"type":"object","required":["id","name","tel","tva_taux","actif","archived","date_creation","adresse","points_caisse"],"properties":{"id":{"type":"integer","description":"Identifiant du magasin. C'est la valeur des champs `id_shop` rencontrés ailleurs dans l'API."},"name":{"type":"string","description":"Nom du magasin."},"tel":{"type":"string","description":"Téléphone du magasin. Chaîne vide si non renseigné."},"tva_taux":{"type":"number","description":"Taux de TVA par défaut du magasin, en pourcentage (exemple : 20). Un produit sans taux propre prend celui-ci."},"actif":{"type":"boolean","description":"`true` si le magasin est en service."},"archived":{"type":"boolean","description":"`true` si le magasin a été archivé par le commerçant. Il reste listé pour que ses anciennes ventes restent lisibles."},"date_creation":{"type":"string","description":"Date de création du magasin."},"adresse":{"type":"object","required":["ligne1","ligne2","cp","ville","id_pays","pays_code","pays"],"properties":{"ligne1":{"type":"string","description":"Adresse, première ligne."},"ligne2":{"type":"string","description":"Complément d'adresse."},"cp":{"type":"string","description":"Code postal."},"ville":{"type":"string","description":"Ville."},"id_pays":{"type":"integer","description":"Identifiant du pays (voir `GET /v1/countries`). 0 si non renseigné."},"pays_code":{"type":"string","description":"Code du pays à deux lettres (exemple : `FR`). Chaîne vide si non renseigné."},"pays":{"type":"string","description":"Nom du pays en français."}},"description":"Adresse du magasin."},"points_caisse":{"type":"array","description":"Points de caisse du magasin. Liste vide s'il n'en a aucun.","items":{"type":"object","required":["id","name","actif","date_creation"],"properties":{"id":{"type":"integer","description":"Identifiant du point de caisse. C'est la valeur des champs `id_point_caisse` rencontrés ailleurs dans l'API."},"name":{"type":"string","description":"Nom du point de caisse."},"actif":{"type":"boolean","description":"`true` si le point de caisse est en service."},"date_creation":{"type":"string","description":"Date de création du point de caisse."}}}}}},"ShopListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Magasins du compte : d'abord ceux en service, puis les magasins archivés.","items":{"$ref":"#/components/schemas/Shop"}},"meta":{"type":"object","required":["request_id","count"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments renvoyés."}}}}},"User":{"type":"object","required":["id","alias","titulaire","id_profil","profil","profil_personnalise","id_point_caisse_principal","archived","date_creation"],"properties":{"id":{"type":"integer","description":"Identifiant de l'utilisateur."},"alias":{"type":"string","description":"Nom que l'utilisateur s'est donné dans l'application. Souvent vide pour le titulaire du compte."},"titulaire":{"type":"boolean","description":"`true` pour le titulaire du compte, la personne qui l'a créé. Il y en a un seul."},"id_profil":{"type":"integer","description":"Identifiant du profil de l'utilisateur."},"profil":{"type":"string","description":"Nom du profil. Les trois profils d'origine s'appellent `admin`, `responsable` et `vendeur`."},"profil_personnalise":{"type":"boolean","description":"`true` si le profil a été créé par le commerçant, `false` pour l'un des trois profils d'origine."},"id_point_caisse_principal":{"type":"integer","description":"Identifiant du point de caisse sur lequel l'utilisateur travaille par défaut (voir `GET /v1/shops`)."},"archived":{"type":"boolean","description":"`true` si l'utilisateur a été archivé : il ne peut plus se connecter, mais reste listé."},"date_creation":{"type":"string","description":"Date de création de l'utilisateur."}}},"UserListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Utilisateurs du compte : d'abord ceux en service, puis les utilisateurs archivés.","items":{"$ref":"#/components/schemas/User"}},"meta":{"type":"object","required":["request_id","count"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments renvoyés."}}}}},"PaymentMethod":{"type":"object","required":["id","name","actif","is_default","position","archived"],"properties":{"id":{"type":"integer","description":"Identifiant du moyen de paiement."},"name":{"type":"string","description":"Nom du moyen de paiement."},"actif":{"type":"boolean","description":"`true` si le moyen de paiement est proposé au moment d'encaisser."},"is_default":{"type":"boolean","description":"`true` pour un moyen de paiement d'origine (espèces, carte bancaire, chèque, avoir, crédit), `false` pour un moyen créé par le commerçant."},"position":{"type":"integer","description":"Ordre d'affichage dans l'application."},"archived":{"type":"boolean","description":"`true` si le moyen de paiement a été archivé par le commerçant."}}},"PaymentMethodListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Moyens de paiement du compte, dans l'ordre d'affichage, archivés en fin de liste.","items":{"$ref":"#/components/schemas/PaymentMethod"}},"meta":{"type":"object","required":["request_id","count"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments renvoyés."}}}}},"Promotion":{"type":"object","required":["id","name","mode","start","end","remise_pc","arrondi","prix","apply_impact_pv","apply_impact_shop","id_shops","archived","date_creation","date_update"],"properties":{"id":{"type":"integer","description":"Identifiant de la promotion. C'est la valeur du champ `id_promotion` d'une ligne de vente."},"name":{"type":"string","description":"Nom de la promotion."},"mode":{"type":"string","description":"`pc` : remise en pourcentage (voir `remise_pc` et `arrondi`). `pf` : prix fixe (voir `prix`)."},"start":{"type":"string","description":"Premier jour de la promotion, au format `2026-11-01`. Chaîne vide si non renseigné."},"end":{"type":"string","description":"Dernier jour de la promotion. Chaîne vide si non renseigné."},"remise_pc":{"type":"number","description":"Pourcentage de remise, en mode `pc`. 0 en mode `pf`."},"arrondi":{"type":"string","description":"Arrondi appliqué au prix remisé, en mode `pc` : `sans`, `entier_sup` (à l'entier supérieur) ou `entier_inf` (à l'entier inférieur). `sans` en mode `pf`."},"prix":{"type":"number","description":"Prix de vente pendant la promotion, en mode `pf`. 0 en mode `pc`."},"apply_impact_pv":{"type":"boolean","description":"En mode `pf` : `true` si l'écart de prix propre à une variante s'ajoute au prix fixe."},"apply_impact_shop":{"type":"boolean","description":"En mode `pf` : `true` si l'écart de prix propre à un magasin s'ajoute au prix fixe."},"id_shops":{"type":"array","description":"Identifiants des magasins rattachés à la promotion.","items":{"type":"integer"}},"archived":{"type":"boolean","description":"`true` si la promotion a été archivée par le commerçant."},"date_creation":{"type":"string","description":"Date de création de la promotion."},"date_update":{"type":"string","description":"Date de la dernière modification. Chaîne vide si inconnue."}}},"PromotionListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Promotions, par identifiant croissant. Liste vide si le compte n'en a aucune.","items":{"$ref":"#/components/schemas/Promotion"}},"meta":{"type":"object","required":["request_id","count","has_more","next_after"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments dans cette page."},"has_more":{"type":"boolean","description":"`true` s'il reste une page à lire."},"next_after":{"type":"integer","description":"Valeur à passer dans `after` pour la page suivante. 0 quand le parcours est terminé."}}}}},"CustomerFields":{"type":"object","required":["civilites","champs"],"properties":{"civilites":{"type":"array","description":"Valeurs acceptées pour le champ `civilite` d'un client. La chaîne vide signifie « aucune civilité ».","items":{"type":"string"}},"champs":{"type":"array","description":"Champs de la fiche client.","items":{"type":"object","required":["champ","libelle","type","affiche","personnalise"],"properties":{"champ":{"type":"string","description":"Nom du champ tel qu'il apparaît dans un client (exemples : `nom`, `adresse.cp`, `libre_1`)."},"libelle":{"type":"string","description":"Libellé que le commerçant voit dans ses écrans. Pour un champ personnalisé, c'est le nom qu'il lui a donné."},"type":{"type":"string","description":"Nature de la valeur : `texte`, `nombre`, `oui_non`, `date` ou `liste` (valeur à choisir dans une liste fermée)."},"affiche":{"type":"boolean","description":"`true` si le commerçant utilise ce champ dans ses écrans. Un champ non affiché reste lisible et modifiable par l'API."},"personnalise":{"type":"boolean","description":"`true` pour l'un des neuf champs personnalisés, dont le sens dépend du commerçant."}}}}}},"CustomerFieldsResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/CustomerFields"},"meta":{"$ref":"#/components/schemas/Meta"}}},"Country":{"type":"object","required":["id_pays","pays_code","pays"],"properties":{"id_pays":{"type":"integer","description":"Identifiant du pays."},"pays_code":{"type":"string","description":"Code du pays à deux lettres. C'est la valeur à donner dans `adresse.pays_code` pour créer ou modifier un client."},"pays":{"type":"string","description":"Nom du pays en français."}}},"CountryListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Pays, par ordre alphabétique.","items":{"$ref":"#/components/schemas/Country"}},"meta":{"type":"object","required":["request_id","count"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments renvoyés."}}}}},"Supplier":{"type":"object","required":["id","name","commercial1","commercial2","tel","mobile","email","tva_intra","notes","archived","date_creation","date_update","adresse"],"properties":{"id":{"type":"integer","description":"Identifiant du fournisseur. C'est la valeur de `fournisseur.id` dans un produit."},"name":{"type":"string","description":"Nom du fournisseur."},"commercial1":{"type":"string","description":"Nom du premier contact commercial."},"commercial2":{"type":"string","description":"Nom du second contact commercial."},"tel":{"type":"string","description":"Téléphone."},"mobile":{"type":"string","description":"Mobile."},"email":{"type":"string","description":"Adresse mail."},"tva_intra":{"type":"string","description":"Numéro de TVA intracommunautaire."},"notes":{"type":"string","description":"Notes libres du commerçant."},"archived":{"type":"boolean","description":"`true` si le fournisseur est archivé : il n'est plus proposé dans l'application, mais les produits qui le portent le gardent."},"date_creation":{"type":"string","description":"Date de création."},"date_update":{"type":"string","description":"Date de la dernière modification. Chaîne vide si inconnue."},"adresse":{"type":"object","required":["ligne1","ligne2","cp","ville","id_pays","pays_code","pays"],"properties":{"ligne1":{"type":"string","description":"Adresse, première ligne."},"ligne2":{"type":"string","description":"Complément d'adresse."},"cp":{"type":"string","description":"Code postal."},"ville":{"type":"string","description":"Ville."},"id_pays":{"type":"integer","description":"Identifiant du pays (voir `GET /v1/countries`). 0 si non renseigné."},"pays_code":{"type":"string","description":"Code du pays à deux lettres."},"pays":{"type":"string","description":"Nom du pays en français."}},"description":"Adresse du fournisseur."}}},"Collection":{"type":"object","required":["id","name","archived","date_creation","date_update"],"properties":{"id":{"type":"integer","description":"Identifiant de la collection. C'est la valeur de `collec.id` dans un produit."},"name":{"type":"string","description":"Nom de la collection."},"archived":{"type":"boolean","description":"`true` si la collection est archivée."},"date_creation":{"type":"string","description":"Date de création."},"date_update":{"type":"string","description":"Date de la dernière modification. Chaîne vide si inconnue."}}},"Category":{"type":"object","required":["id","name","id_parent","niveau","chemin","archived","date_creation","date_update"],"properties":{"id":{"type":"integer","description":"Identifiant de la catégorie. C'est la valeur de `categories[].id` dans un produit."},"name":{"type":"string","description":"Nom de la catégorie."},"id_parent":{"type":"integer","description":"Identifiant de la catégorie parente. 0 pour une catégorie de premier niveau."},"niveau":{"type":"integer","description":"Niveau dans l'arborescence, de 1 (racine) à 5."},"chemin":{"type":"array","description":"Noms des catégories depuis la racine jusqu'à celle-ci, elle comprise. Exemple : `[\"Vêtements\", \"Homme\", \"Chemises\"]`.","items":{"type":"string"}},"archived":{"type":"boolean","description":"`true` si la catégorie est archivée."},"date_creation":{"type":"string","description":"Date de création."},"date_update":{"type":"string","description":"Date de la dernière modification. Chaîne vide si inconnue."}}},"CustomListValue":{"type":"object","required":["id","id_list","name","archived","date_creation","date_update"],"properties":{"id":{"type":"integer","description":"Identifiant de la valeur. C'est ce que porte `id_custom_list_1`, `id_custom_list_2` ou `id_custom_list_3` dans un produit."},"id_list":{"type":"integer","description":"Numéro de la liste à laquelle la valeur appartient : 1, 2 ou 3."},"name":{"type":"string","description":"Libellé de la valeur."},"archived":{"type":"boolean","description":"`true` si la valeur est archivée."},"date_creation":{"type":"string","description":"Date de création."},"date_update":{"type":"string","description":"Date de la dernière modification. Chaîne vide si inconnue."}}},"CustomList":{"type":"object","required":["id_list","champ","libelle","affiche","nb_values"],"properties":{"id_list":{"type":"integer","description":"Numéro de la liste : 1, 2 ou 3. À utiliser dans l'adresse `/v1/custom-lists/{list}/values`."},"champ":{"type":"string","description":"Champ d'un produit qui porte une valeur de cette liste : `id_custom_list_1`, `id_custom_list_2` ou `id_custom_list_3`."},"libelle":{"type":"string","description":"Nom que le commerçant a donné à cette liste (exemples : « Matière », « Saison »)."},"affiche":{"type":"boolean","description":"`true` si le commerçant utilise cette liste dans ses fiches produit."},"nb_values":{"type":"integer","description":"Nombre de valeurs en service dans la liste."}}},"SupplierInput":{"type":"object","additionalProperties":false,"description":"Champs d'un fournisseur qui peuvent être écrits. Tout champ hors de cette liste est refusé. `name` est obligatoire à la création.","properties":{"name":{"type":"string","description":"Nom du fournisseur. De 3 à 50 caractères. Un nom déjà pris est refusé (`duplicate_name`), sans tenir compte des majuscules ni des accents."},"commercial1":{"type":"string","description":"Premier contact commercial. 100 caractères au maximum."},"commercial2":{"type":"string","description":"Second contact commercial. 100 caractères au maximum."},"tel":{"type":"string","description":"Téléphone. 17 caractères au maximum."},"mobile":{"type":"string","description":"Mobile. 17 caractères au maximum."},"email":{"type":"string","description":"Adresse mail. 50 caractères au maximum."},"tva_intra":{"type":"string","description":"Numéro de TVA intracommunautaire. 32 caractères au maximum."},"notes":{"type":"string","description":"Notes libres. 5 000 caractères au maximum."},"adresse":{"type":"object","additionalProperties":false,"description":"Adresse du fournisseur. Seuls les champs envoyés changent.","properties":{"ligne1":{"type":"string","description":"Adresse, première ligne. 50 caractères au maximum."},"ligne2":{"type":"string","description":"Complément d'adresse. 50 caractères au maximum."},"cp":{"type":"string","description":"Code postal. 9 caractères au maximum."},"ville":{"type":"string","description":"Ville. 30 caractères au maximum."},"pays_code":{"type":"string","description":"Code du pays à deux lettres (voir `GET /v1/countries`). À la création, s'il est absent : le pays du magasin principal."}}},"archived":{"type":"boolean","description":"À la modification seulement : `true` pour archiver, `false` pour remettre en service."}}},"CollectionInput":{"type":"object","additionalProperties":false,"description":"Champs d'une collection qui peuvent être écrits. `name` est obligatoire à la création.","properties":{"name":{"type":"string","description":"Nom de la collection. De 3 à 50 caractères. Un nom déjà pris est refusé (`duplicate_name`), sans tenir compte des majuscules ni des accents."},"archived":{"type":"boolean","description":"À la modification seulement : `true` pour archiver, `false` pour remettre en service."}}},"CategoryInput":{"type":"object","additionalProperties":false,"description":"Champs d'une catégorie qui peuvent être écrits. `name` est obligatoire à la création. Deux catégories peuvent porter le même nom si elles n'ont pas le même parent.","properties":{"name":{"type":"string","description":"Nom de la catégorie. De 2 à 50 caractères. Un nom déjà pris est refusé (`duplicate_name`), sans tenir compte des majuscules ni des accents."},"id_parent":{"type":"integer","description":"À la création seulement : identifiant de la catégorie parente. Absent ou 0 pour une catégorie de premier niveau. Le parent ne peut pas être changé ensuite."},"archived":{"type":"boolean","description":"À la modification seulement : `true` pour archiver, `false` pour remettre en service."}}},"CustomListValueInput":{"type":"object","additionalProperties":false,"description":"Champs d'une valeur de liste qui peuvent être écrits. `name` est obligatoire à la création.","properties":{"name":{"type":"string","description":"Nom de la valeur. De 2 à 50 caractères. Un nom déjà pris est refusé (`duplicate_name`), sans tenir compte des majuscules ni des accents."},"archived":{"type":"boolean","description":"À la modification seulement : `true` pour archiver, `false` pour remettre en service."}}},"SupplierResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Supplier"},"meta":{"$ref":"#/components/schemas/Meta"}}},"SupplierListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Une page, par identifiant croissant. Liste vide s'il n'y a rien.","items":{"$ref":"#/components/schemas/Supplier"}},"meta":{"type":"object","required":["request_id","count","has_more","next_after"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments dans cette page."},"has_more":{"type":"boolean","description":"`true` s'il reste une page à lire."},"next_after":{"type":"integer","description":"Valeur à passer dans `after` pour la page suivante. 0 quand le parcours est terminé."}}}}},"CollectionResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Collection"},"meta":{"$ref":"#/components/schemas/Meta"}}},"CollectionListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Une page, par identifiant croissant. Liste vide s'il n'y a rien.","items":{"$ref":"#/components/schemas/Collection"}},"meta":{"type":"object","required":["request_id","count","has_more","next_after"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments dans cette page."},"has_more":{"type":"boolean","description":"`true` s'il reste une page à lire."},"next_after":{"type":"integer","description":"Valeur à passer dans `after` pour la page suivante. 0 quand le parcours est terminé."}}}}},"CategoryResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Category"},"meta":{"$ref":"#/components/schemas/Meta"}}},"CategoryListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Une page, par identifiant croissant. Liste vide s'il n'y a rien.","items":{"$ref":"#/components/schemas/Category"}},"meta":{"type":"object","required":["request_id","count","has_more","next_after"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments dans cette page."},"has_more":{"type":"boolean","description":"`true` s'il reste une page à lire."},"next_after":{"type":"integer","description":"Valeur à passer dans `after` pour la page suivante. 0 quand le parcours est terminé."}}}}},"CustomListValueResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/CustomListValue"},"meta":{"$ref":"#/components/schemas/Meta"}}},"CustomListValueListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Une page, par identifiant croissant. Liste vide s'il n'y a rien.","items":{"$ref":"#/components/schemas/CustomListValue"}},"meta":{"type":"object","required":["request_id","count","has_more","next_after"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments dans cette page."},"has_more":{"type":"boolean","description":"`true` s'il reste une page à lire."},"next_after":{"type":"integer","description":"Valeur à passer dans `after` pour la page suivante. 0 quand le parcours est terminé."}}}}},"CustomListListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","description":"Les trois listes personnalisées, dans l'ordre.","items":{"$ref":"#/components/schemas/CustomList"}},"meta":{"type":"object","required":["request_id","count"],"properties":{"request_id":{"type":"string","description":"Identifiant de l'appel."},"count":{"type":"integer","description":"Nombre d'éléments renvoyés."}}}}},"CustomListInput":{"type":"object","additionalProperties":false,"description":"Champs d'une liste personnalisée qui peuvent être modifiés. Envoyez au moins l'un des deux.","properties":{"libelle":{"type":"string","description":"Nom de la liste, tel que le commerçant le verra dans ses fiches produit. De 1 à 50 caractères."},"affiche":{"type":"boolean","description":"`true` pour que la liste apparaisse dans les fiches produit, `false` pour la masquer. Masquer une liste ne supprime ni ses valeurs ni ce que portent les produits."}}},"CustomListResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/CustomList"},"meta":{"$ref":"#/components/schemas/Meta"}}}}},"x-wanapos-errors":[{"code":"not_found","status":404,"meaning":"L'adresse appelée n'existe pas."},{"code":"method_not_allowed","status":405,"meaning":"L'adresse existe, mais pas avec cette méthode HTTP. L'en-tête Allow liste les méthodes acceptées."},{"code":"resource_not_found","status":404,"meaning":"L'élément demandé n'existe pas sur le compte lié à la clé."},{"code":"https_required","status":400,"meaning":"L'appel a été fait en HTTP simple. Seul HTTPS est accepté."},{"code":"key_in_url","status":400,"meaning":"Une clé a été placée dans l'URL. Elle doit être envoyée dans l'en-tête Authorization, et la clé exposée doit être révoquée."},{"code":"api_disabled","status":503,"meaning":"L'API est momentanément indisponible. Réessayer plus tard."},{"code":"too_many_failed_attempts","status":429,"meaning":"Trop d'appels avec une clé invalide depuis la même adresse IP. Attendre le délai indiqué par Retry-After."},{"code":"missing_key","status":401,"meaning":"Aucune clé n'a été fournie."},{"code":"invalid_key","status":401,"meaning":"La clé est inconnue ou a été révoquée."},{"code":"api_not_activated","status":403,"meaning":"L'API n'est pas activée sur le compte. Le titulaire l'active dans son compte Wanapos."},{"code":"account_not_eligible","status":403,"meaning":"Le compte n'a pas d'abonnement actif."},{"code":"access_blocked","status":403,"meaning":"L'accès à l'API est suspendu sur ce compte."},{"code":"missing_scope","status":403,"meaning":"La clé n'a pas la permission exigée. Le champ field nomme la permission manquante."},{"code":"rate_limited","status":429,"meaning":"Trop d'appels dans la minute. Attendre le délai indiqué par Retry-After, puis espacer les appels."},{"code":"daily_quota_exceeded","status":429,"meaning":"Le quota journalier de lecture ou d'écriture est atteint. Il revient à zéro à minuit, heure de Paris."},{"code":"body_too_large","status":413,"meaning":"Le contenu envoyé dépasse la taille maximale. Découper l'envoi en plusieurs appels."},{"code":"unsupported_media_type","status":415,"meaning":"Le contenu envoyé n'est pas déclaré comme du JSON."},{"code":"invalid_json","status":400,"meaning":"Le contenu envoyé n'est pas un objet JSON valide."},{"code":"validation_failed","status":422,"meaning":"Des données envoyées sont invalides. Le champ details liste chaque erreur avec son champ. Rien n'a été enregistré."},{"code":"invalid_parameter","status":422,"meaning":"Un paramètre de l'URL est invalide. Le champ field le nomme."},{"code":"idempotency_key_required","status":400,"meaning":"Cet appel exige l'en-tête Idempotency-Key."},{"code":"idempotency_key_invalid","status":400,"meaning":"L'en-tête Idempotency-Key n'a pas la forme attendue (8 à 100 caractères : lettres, chiffres, tiret, tiret bas, point, deux-points)."},{"code":"idempotency_key_reused","status":422,"meaning":"Cet Idempotency-Key a déjà servi pour une requête différente. Utiliser un nouvel identifiant par nouvelle requête."},{"code":"request_in_progress","status":409,"meaning":"Une requête portant le même Idempotency-Key est en cours de traitement. Réessayer dans quelques secondes avec le même identifiant."},{"code":"account_busy","status":503,"meaning":"Une autre écriture est en cours sur ce compte. Rien n'a été enregistré : renvoyer la même requête après quelques secondes."},{"code":"duplicate_email","status":409,"meaning":"Un client actif porte déjà cette adresse mail. L'erreur donne les identifiants existants : modifier le client existant, ou renvoyer avec `?allow_duplicate_email=true`."},{"code":"duplicate_barcode","status":409,"meaning":"Un autre produit porte déjà ce code-barres externe (`bc_ext`). L'erreur donne les identifiants des produits concernés : vérifier que le produit n'existe pas déjà, ou renvoyer avec `?allow_duplicate_bc_ext=true`."},{"code":"duplicate_name","status":409,"meaning":"Un fournisseur, une collection, une catégorie ou une valeur de liste porte déjà ce nom. L'erreur donne l'identifiant existant : l'utiliser au lieu de créer un doublon, ou choisir un autre nom."},{"code":"points_out_of_range","status":409,"meaning":"L'ajustement ferait passer le solde de points sous 0 ou au-dessus du maximum. Le message donne le solde actuel. Rien n'a été modifié."},{"code":"internal_error","status":500,"meaning":"Erreur interne. Réessayer, puis contacter l'assistance en indiquant le request_id."}],"x-wanapos-scopes":[{"name":"read_users","group":"Compte","label":"Lire les utilisateurs du compte (nom et profil)"},{"name":"read_customers","group":"Clients","label":"Lire un client (par identifiant ou adresse mail)"},{"name":"export_customers","group":"Clients","label":"Exporter tout le fichier clients"},{"name":"write_customers","group":"Clients","label":"Créer et modifier des clients"},{"name":"write_loyalty","group":"Fidélité","label":"Ajuster les points de fidélité"},{"name":"read_sales","group":"Ventes","label":"Lire les ventes"},{"name":"read_products","group":"Catalogue","label":"Lire les produits, fournisseurs, collections et catégories"},{"name":"write_products","group":"Catalogue","label":"Créer des produits ; créer et modifier fournisseurs, collections et catégories"}]}