Parcourir tout le catalogue
/v1/products
Renvoie les produits du compte page par page, par identifiant croissant, chacun avec ses variantes, ses codes et ses prix.
Cette 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.
Le 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.
Les 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.
Le 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.
Paramètres
limit |
Facultatif | Nombre de produits par page, de 1 à 100. 50 par défaut. |
after |
Facultatif | 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. |
archived |
Facultatif | true pour inclure aussi les produits archivés. false par défaut : seuls les produits non archivés sont renvoyés. |
Exemple d'appel
curl "https://api.wanapos.com/v1/products" \ -H "Authorization: Bearer VOTRE_CLE"
Réponse en cas de succès (statut 200)
Une page du catalogue.
| Champ | Type | Description |
|---|---|---|
data |
liste d'objets | Produits de la page, par identifiant croissant. Liste vide si aucun. Voir tous les champs |
meta |
objet | |
meta.request_id |
texte | Identifiant de l'appel. |
meta.count |
entier | Nombre d'éléments dans cette page. |
meta.has_more |
booléen |
true s'il reste une page à lire. |
meta.next_after |
entier |
Valeur à passer dans after pour la page suivante. 0 quand le parcours est terminé. |
{
"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
}
}
Erreurs possibles
-
401
Clé absente, inconnue ou révoquée. Codes :
missing_key,invalid_key. -
403
Appel refusé pour ce compte ou cette clé. Codes :
api_not_activated,account_not_eligible,access_blocked,missing_scope. -
422
Un paramètre est absent, inconnu ou invalide. Code :
invalid_parameter. Le champfieldnomme le paramètre. -
429
Quota dépassé. Codes :
rate_limited,daily_quota_exceeded,too_many_failed_attempts. L'en-têteRetry-Afterindique combien de secondes attendre.
Une question ? contact@wanapos.com
