Produits

Parcourir tout le catalogue

GET /v1/products
vpn_key Permission read_products Compte comme une lecture

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 champ field nomme le paramètre.
  • 429 Quota dépassé. Codes : rate_limited, daily_quota_exceeded, too_many_failed_attempts. L'en-tête Retry-After indique combien de secondes attendre.

Voir toutes les erreurs

Une question ? contact@wanapos.com