Produits

Lire un produit par son identifiant

GET /v1/products/{id}
vpn_key Permission read_products Compte comme une lecture

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.

Un produit archivé reste lisible ici (archived vaut true). Un produit supprimé dans l'application est définitivement effacé : l'appel répond 404.

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

id Obligatoire Identifiant du produit (champ id).

Exemple d'appel

curl "https://api.wanapos.com/v1/products/312" \
  -H "Authorization: Bearer VOTRE_CLE"

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

Le produit.

Champ Type Description
data objet Un produit du catalogue, avec ses variantes, ses codes et ses prix. Le stock n'en fait pas partie. Voir tous les champs
meta objet
meta.request_id texte Identifiant de l'appel, à communiquer à l'assistance en cas de problème.
{
    "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"
    }
}

Erreurs possibles

  • 404 L'élément demandé n'existe pas sur ce compte. Code : resource_not_found.
  • 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