Produits

Identifier un produit par un code, une référence ou sa désignation

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

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.

Donnez 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.

Ce 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.

La 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.

Les 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.

Les produits archivés sont renvoyés aussi (archived vaut true) : avant de créer un produit, regardez ce champ.

La 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.

Paramètres

code Facultatif 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).
bc_ext Facultatif Code-barres externe d'une variante, celui du fabricant (32 caractères au plus).
ean_int Facultatif Code-barres interne d'une variante, généré par Wanapos (13 caractères au plus).
sku Facultatif Référence d'une variante, SKU (32 caractères au plus).
ref_four Facultatif Référence du produit chez le fournisseur (50 caractères au plus).
ref_interne Facultatif Référence interne du produit (50 caractères au plus).
designation Facultatif Nom complet du produit (50 caractères au plus). Pensez à l'encoder dans l'URL.

Exemple d'appel

curl "https://api.wanapos.com/v1/products/lookup?code=3760000000022" \
  -H "Authorization: Bearer VOTRE_CLE"

Réponse en cas de succès (statut 200)

Les produits correspondants.

Champ Type Description
data liste d'objets Produits correspondants, 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 de produits renvoyés.
meta.truncated booléen true si plus de 50 produits correspondent : la liste est alors incomplète, voir la description de l'adresse.
{
    "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
    }
}

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