Identifier un produit par un code, une référence ou sa désignation
/v1/products/lookup
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 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
