Produits Endpoint

Modèles d'URL

Depuis la v2.122.12, le segment correspondant à /product ou /products est un nombre entier ou une plage délimitée par des nombres entiers ; envoyez l’ID sans décimales et sans signe. Toutes les règles : API d’exportation, section « Segment de chemin ».

Paramètres de requête

Depuis la v2.122.10, les valeurs non valides et les valeurs de liste telles que ?limit[]=50 génèrent une erreur HTTP 400, tandis que INVALID_FILTER_VALUE avec details[] fonctionne.

Depuis la v2.122.12, les espaces en bordure ne sont plus pris en compte : ?bundles=%201 (ainsi que marketplaces et bonus_free_features) renvoie le bloc ; jusqu’à la v2.122.11, celui-ci était tacitement absent. Une valeur vide signifie « non défini ».

Depuis la v2.122.11, une valeur composée uniquement de virgules sur products_model, products_ean ou seo_name renvoie une erreur HTTP 400 INVALID_FILTER_VALUE (« holds no value »), tout comme un filtre de date composé uniquement de signes de ponctuation, tel que ?last_modified=.. Auparavant, on obtenait la liste non filtrée ou uniquement les modifications apportées depuis ce moment-là. Les autres filtres (status, categories_id, ean_prefix, last_modified …) se trouvent sous « Export API », tandis que la recherche par adresse de boutique se trouve sous « SEO History ».

Exemples de requêtes

# Einzelprodukt abrufen
curl -X GET "https://shop.de/xpanel/xoport/export/json/product/123" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Alle Produkte paginiert
curl -X GET "https://shop.de/xpanel/xoport/export/json/products?limit=50&offset=0" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# ID-Range
curl -X GET "https://shop.de/xpanel/xoport/export/json/products/100:200" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Champs de réponse

Chaque produit contient :

• products_id, products_model, products_ean
• products_price, products_weight, products_quantity, products_cost
• manufacturers_id, products_status
• contract, contract_use_current_price, contract_option v2.5.0
• products_inventory_management, products_min_qty, products_max_qty, products_qty_blocks, products_base_price v2.5.0
• service, sitemap, non_cart, non_price, products_free_shipping v2.5.0
• shipping_profile, products_unit_id, base_unit_id, products_sort_order v2.5.0
• images[] - Images des produits avec tri. Les articles sans image principale ne génèrent plus d'entrée vide avec images_id 0 v2.122.10
• categories[] - Identifiants de catégories
• groups[] - Tarifs par groupes de clients
• customers_prices[] - Prix personnalisés par client
• specials[] - Prix spéciaux
• extra_fields[] - Champs supplémentaires
• badges[] - Badges de produits
• xsells[] - Produits de vente croisée, complets et conformes à la norme « sort_order » v2.122.9
• upsells[] - Compléments au panier (« À associer ») v2.18.0+
• tabs[] - Onglets de produits
• bonus_free_features - Uniquement avec ?bonus_free_features=1: status_bonus, bonus_points (prix en points par unité), max_bonus, status_free, bonus_value (valeur marchande par article gratuit), max_free, auto_free; en lecture seule bonus_date_added, bonus_last_modified, date_status_changed. Sans données null v2.122.10
• bundle - uniquement avec ?bundles=1: paramètres et composants d'un bundle, sans bundle null v2.122.11
• marketplaces[] - uniquement avec ?marketplaces=1: une entrée par canal avec interrupteur et état v2.122.11
• videos[] - Vidéos des produits
• suppliers[] - Fournisseurs : suppliers_id et products_model (référence du fournisseur). La liste remplace toutes les affectations de l'article ; une entrée sans products_model efface la référence.
• storages[] - Stock par entrepôt v2.63.0+
• languages{} - Nom, description, référencement naturel par langue :
  • products_name, products_description, products_short_description
  • products_head_title_tag, products_head_desc_tag, products_head_keywords_tag
  • seo_name, products_url, products_checkout_description, products_image_title
• languages.<code>.unit_single, unit_multi, unit_base - Unité par langue, renseignée ; si aucune unité, laisser vide au lieu de null v2.122.9
• options{} - caractéristiques sans groupe de caractéristiques (nom de l'option + valeurs par langue, données SKU par valeur)
• option_groups[] - groupes de caractéristiques combinés (par ex. « couleur + taille » couplées), données SKU par combinaison v2.58.0+
• contenteditor{} - Données ContentEditor par langue

Autres champs du produit

Outre les champs ci-dessus, l’exportation fournit les autres colonnes de l’article ; depuis la v2.105.0, la plupart sont également modifiables. Pour ces champs, le nom peut être trompeur ou leur portée va plus loin que prévu :

Sélection des champs (?fields=) v2.122.11

Pour /products, /product/{ID}, /products/{ID} et les sections, ?fields= indique les clés de chaque produit sous forme de liste séparée par des virgules. La boutique ne charge que ces données : lors d’un test, une page comportant 250 articles pesait 4,3 Mo sans et 52 Ko avec fields=products_model,products_price,products_quantity,products_status.

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://shop.de/xpanel/xoport/export/json/products?status=1&limit=250&fields=products_model,products_price,products_quantity"
# → "data": [{"products_id": 28, "products_model": 8624000, "products_price": 12.5, "products_quantity": 3}, …]

• Les clés valides sont celles du niveau supérieur de l'enregistrement de données du produit : chaque colonne du produit (y compris les colonnes propres à la boutique), manufacturers_id et les clés de bloc figurant dans la liste ci-dessous. products_id est toujours inclus, l'ordre correspond à celui de l'enregistrement.
• Noms issus de a–z, 0–9 et _, 64 caractères maximum chacun. 100 éléments de liste au maximum ; les éléments vides et les doublons sont comptabilisés ; un doublon n’est pris en compte qu’une seule fois. Un fields= vide ou ne contenant que des virgules (fields=,) est considéré comme non défini.
• Absence totale au lieu de valeur vide : une clé non mentionnée est absente de la réponse ; on n’y trouve jamais [] ou null. De même, une clé mentionnée mais que l’article ne possède pas est absente, par exemple special sans prix spécial. Une sélection peut donc être renvoyée via PUT, y compris avec ?_strict=true, et ne modifie que ce qu’elle contient.
• La colonne shipping_profile ne fournit que l’ID du profil ; vous indiquez la résolution avec shipping_profile_effective, shipping_profile_name, shipping_profile_step ou shipping_profile_text.
• bundle, bonus_free_features et marketplaces: avec ?fields=, le nom demande le bloc, sans commutateur. Un commutateur sans ce nom ne fonctionne alors pas (avertissement SWITCH_IGNORED).
• Sans ?fields=, la réponse reste inchangée. L'exportation XML ne reconnaît pas ce paramètre.

Clé de bloc : un bloc n’est chargé que si l’une de ses clés est mentionnée. Le contenu varie en fonction de la clé, et lorsque la clé est manquante :

• groups – Prix par groupe de clients, groupe 0 issu du produit
• manufacturers – Noms des fabricants vers manufacturers_id
• languages – Textes par langue, y compris les unités
• customers_prices – Prix clients ; absent s’il n’y a pas de prix client
• restricted_customer_groups – groupes de clients bloqués ; s’il manque, aucun blocage
• import_blocks – Blocages d’importation ; s’il n’y en a pas, pas de blocage
• categories – Affectations de catégories ; manquant sans affectation
• images – Images principales et supplémentaires ; [] en l’absence d’image
• extra_fields – Champs supplémentaires ; sans champ, l’ [] n’est possible qu’avec un système de gestion des stocks avancé, sinon il est manquant
• badges – Badges ; manquant s’il n’y a pas de badge
• xsells – Vente croisée ; absent sans entrée
• upsells – Vente incitative ; manquant s’il n’y a pas d’entrée
• tabs – Onglets dans toutes les langues ; absents sans onglets
• special – Prix spécial ; absent sans prix spécial
• options – Caractéristiques sans groupe ; manquant sans caractéristique
• option_groups – Groupes de caractéristiques combinés ; manquant sans groupe
• videos – Vidéos ; manquant sans vidéo
• suppliers – Fournisseurs ; manquant sans attribution
• shipping_profile_effective, shipping_profile_name, shipping_profile_step, shipping_profile_text – Profil « feu tricolore » (un bloc commun pour les quatre) : le profil en vigueur, son nom, le niveau correspondant au stock actuel et le texte relatif au délai de livraison ; les quatre éléments sont absents si la boutique ne dispose pas de profils « feu tricolore »
• quicksearch – Nombre d’entrées de recherche rapide par langue ({} = non indexé)
• options_rules – Règles d’options du configurateur ; absent s’il n’y a pas de règle
• contenteditor – Données ContentEditor de la description ; uniquement avec la licence xoContentEditor et les données
• storages – Lignes de stock ; uniquement avec le système de gestion des stocks étendu
• bundle – Lot, null sans lot ; sans ?fields= uniquement avec ?bundles=1
• bonus_free_features – Données relatives aux bonus et aux articles gratuits, « null » sans entrée ; sans « ?fields= », uniquement avec ?bonus_free_features=1
• marketplaces – une inscription par chaîne ; sans ?fields=, uniquement avec ?marketplaces=1

Caractéristiques (options)

Selon le type de caractéristique, l'exportation fournit deux structures différentes :

Il y a délibérément deux champs : pour un groupe de caractéristiques, il existe une référence par combinaison (« noir / L » = un code EAN), et non par valeur individuelle. Une fusion entraînerait la création de références qui n’existent pas. Un produit peut comporter ces deux champs.

"option_groups": [
  {
    "group": 1,
    "options": [
      { "id": 27, "languages": { "de": { "name": "Farbe" } } },
      { "id": 26, "languages": { "de": { "name": "Größe" } } }
    ],
    "combinations": [
      {
        "detail_id": 2344,
        "values": [
          { "options_id": 27, "options_values_id": 2483, "languages": { "de": { "name": "schwarz" } } },
          { "options_id": 26, "options_values_id": 304,  "languages": { "de": { "name": "L" } } }
        ],
        "model": "MS-01-0040-001-L",
        "ean": "4001",
        "quantity": "5",
        "price": "0.0000",
        "sort_id": 1
      }
    ]
  }
]

• options[] s’affiche dans l’ordre d’affichage; combinations[].values[] suit le même ordre — la position 0 correspond toujours au premier élément du groupe.
• detail_id: 0 Des champs SKU vides signifient : pour cette combinaison, aucune donnée n’est renseignée (ce n’est pas une erreur).
• L’importation attend toujours le format plat « options[] » (v2.39.0) — convertir côté client pour les allers-retours.

POST crée de nouveaux produits, PUT met à jour ceux qui existent déjà.

Prix personnalisés par client (customers_prices[]) v2.57.0

Pour chaque produit, il est possible d’importer des prix différents pour des clients individuels. Le client est identifié via customers_id ou customers_id_extern (numéro de client WaWi).

{
  "type": "products",
  "data": [{
    "products_model": "ABC-123",
    "customers_prices": [
      {"customers_id": 48, "customers_price": "9,99", "products_price1": 9.5, "products_price1_qty": 10},
      {"customers_id_extern": "20074", "customers_price": 8.88},
      {"customers_id": 55, "_action": "delete"}
    ]
  }]
}

• Upsert partiel : seules les colonnes transmises sont écrites. Disponibles : customers_price (alias price), products_price1…products_price12 + products_price1_qty…products_price12_qty (prix échelonnés), products_qty_blocks, products_min_qty, products_max_qty.
• Identification du client : via customers_id ou customers_id_extern — le numéro client du système de gestion commerciale doit être unique ; les numéros ambigus génèrent un avertissement et l'entrée est ignorée.
• _action: "delete" Supprime le prix client correspondant à ce client.
• customers_prices_replace: true = Synchronisation complète : tous les prix client du produit sont d’abord supprimés, puis ceux fournis sont enregistrés. Si le champ « customers_prices: [] » est vide, tous les prix client du produit sont supprimés.
• Valeurs par défaut d’insertion : si customers_price est manquant, le prix actuel du produit est repris ; blocs de quantité et quantité minimale = 1.
• customers_price ≤ 0 est ignoré (avertissement) — la suppression s’effectue exclusivement via _action: "delete".

Stocks et seuils de réapprovisionnement par entrepôt (storages[]) v2.45.0

Lorsque le système multi-entrepôts est activé, le stock, le stock de sécurité, le point de commande et l'emplacement sont gérés pour chaque entrepôt (table products_to_storages). Ce tableau existe depuis la v2.34.0 ; depuis la v2.45.0, seuls les champs effectivement transmis sont enregistrés — une charge utile partielle (par exemple, uniquement products_reorder_level) ne définit plus les colonnes restantes de ce magasin sur 0.

Définir uniquement le seuil de réapprovisionnement d’un entrepôt — toutes les autres valeurs de cet entrepôt restent inchangées :

{
  "type": "products",
  "data": [{
    "products_model": "ABC-123",
    "storages": [
      {"storages_id": 3, "products_reorder_level": 10}
    ]
  }]
}

Exemple complet avec deux entrepôts, un stock par caractéristique et un stock total défini séparément :

{
  "type": "products",
  "data": [{
    "products_model": "ABC-123",
    "products_quantity": 42,
    "storages": [
      {"storages_id": 1, "products_quantity": 30, "products_safe_quantity": 2, "products_reorder_level": 10, "products_storage_text": "Regal A-04"},
      {"storages_id": 3, "products_quantity": 12, "products_reorder_level": 5},
      {"storages_id": 3, "options_id": 2483, "products_quantity": 4}
    ]
  }]
}

• Mise à jour partielle (à partir de la v2.45.0) : seules les zones présentes dans la charge utile (INSERT … ON DUPLICATE KEY UPDATE) sont écrites. Jusqu’à la v2.44.0, la ligne de stock était remplacée par REPLACE — les colonnes omises étaient alors remplacées par 0.
• Clé par ligne de stock : (storages_id, products_id, options_id). Si le triplet est identique, mise à jour de la ligne existante ; sinon, insertion.
• Pas de synchronisation complète : les lignes de stock qui ne figurent pas dans le tableau restent inchangées. Il n’y a ni storages_replace ni _action: "delete" — la suppression de lignes de stock n’est possible que dans le backend.
• Opération vide sans données utiles : une entrée ne contenant que la clé n’écrit rien et ne crée notamment pas de ligne avec des valeurs nulles.
• null n’est pas « inchangé » : un champ dont la valeur est null est considéré comme transmis et écrit 0. Si une valeur doit rester inchangée, omettez le champ.
• Nouvelle ligne de stock : envoyer le stock. Si aucune ligne n’existe encore pour le triplet, celle-ci est créée uniquement à partir des champs transmis. Lors du premier remplissage, envoyez donc products_quantity et products_safe_quantity avec — sinon, le serveur de base de données peut rejeter l’enregistrement en fonction de la configuration, sans que la réponse ne signale d’erreur.
• options_id: Valeur par défaut 0. Les valeurs > 0 gèrent le stock d’une combinaison caractéristique/variante dans ce magasin ; le stock produit et le stock caractéristique font l’objet de lignes distinctes.
• Le séparateur décimal est le point : « "50.5" » est valide, « "50,5" » est lu comme « 50 ».
• Condition préalable EXTENDED_STORAGE_SYSTEM = 'true': si le système de stock étendu est désactivé, storages est entièrement ignoré ; la réponse contient l'avertissement STORAGE_SYSTEM_DISABLED.
• Entité inconnue ou inactive : uneentité storages_id qui n’existe pas ou dont l’entité n’est pas active génère l’avertissement STORAGE_NOT_FOUND; l’entrée est ignorée, les entrées restantes continuent à être traitées.
• Attention — les storages_id manquantes sont ignorées en silence : les entrées sans storages_id/warehouse_id ou dont la valeur est ≤ 0 sont ignorées sans avertissement. L’importation signale alors qu’elle s’est déroulée avec succès, bien qu’aucun stock n’ait été enregistré.

Exemple de requête

curl -X POST "https://shop.de/xpanel/xoport/import/json/products" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "products",
    "data": [{
      "products_model": "TEST-001",
      "products_price": 99.99,
      "products_quantity": 50,
      "manufacturers_id": 1,
      "contract": 1,
      "contract_use_current_price": 1,
      "products_ean": "4012345678901",
      "categories": [5, 12],
      "groups": [
        {"customers_group_id": 2, "customers_group_price": 1975.00},
        {"customers_group_id": 3, "customers_group_price": 1975.00}
      ],
      "suppliers": [{"suppliers_id": 3, "products_model": "LF-4711"}],
      "specials": [{
        "customers_group_id": 0,
        "discount_percent": 10,
        "specials_price_name": {"de": "Muttertag", "en": "Mother Day"},
        "status": 1,
        "specials_begin": "2026-05-05 00:00:00",
        "specials_end": "2026-05-11 23:59:59"
      }],
      "languages": {
        "de": {
          "products_name": "Testprodukt",
          "products_description": "Beschreibung...",
          "products_head_title_tag": "SEO Titel",
          "products_head_desc_tag": "Meta Description",
          "seo_name": "testprodukt"
        }
      }
    }]
  }'

Composition et paramètres d’un bundle associé à un produit, portées products:read et products:write. Jusqu’à la version v2.122.10, l’API REST ne reconnaissait pas ce champ : un bundle envoyé était ignoré et traité comme UNKNOWN_FIELD, tandis que ?bundles=1 renvoyait l’erreur UNKNOWN_FILTER.

Exportation

Uniquement sur demande : GET /products?bundles=1, ainsi que /product/{ID} et les sections (uniquement 0 ou 1, sinon HTTP 400 INVALID_FILTER_VALUE). Avec ce paramètre, chaque produit de la page porte la clé : null sans bundle, sinon les paramètres et items[] exactement sous la forme lue par l’importation. Avec ?fields=, le nom bundle demande le bloc ; ?bundles=1 sans le nom ne fonctionne alors pas (avertissement SWITCH_IGNORED).

Importation

{ "type": "products", "data": [ { "products_model": "SET-100",
  "bundle": { "bundle_status": 1, "bundle_cart_listing": 1,
    "items": [ { "products_model": "SHIRT-1", "qty": 1, "options_name": "Farbe > Größe", "options_value": "Rot > XL" },
               { "uprid": "4711{3}12{5}40", "qty": 2 } ] } } ] }

Tout ou rien par enregistrement : la structure, les paramètres et chaque composant sont vérifiés avant l'écriture. Un composant inconnu, une auto-référence, une quantité invalide, une sélection d'attributs ou un paramètre entraîne l'échec de l'enregistrement avec INVALID_BUNDLE; details[] indique les raisons, et rien n'est écrit, pas même le prix de cet enregistrement.

Paramètres

Valeurs : 1/0, true/false, ja/nein, yes/no, on/off; null = non spécifié. Les autres boutons d’un nouveau bundle sont désactivés.

Composants (items[])

Les entrées identiques (produit et sélection) sont regroupées en une seule ligne avec une quantité cumulée. Un composant ne peut pas être le lot lui-même.

Réponse

• records[].bundle: written, settings, removed ou none. stats.bundles avec processed, written, settings et removed, si le lot portait la référence bundle.
• INVALID_BUNDLE avec details[], par exemple item 2: NOCOMPONENT SHIRT-9, item 1: QTY 0 ou SETTING bundle_cart_listing.

L’onglet « Places de marché » du masque de produit active un produit par canal ; la liste des produits multicanal affiche à cet effet le statut de téléchargement, le statut de vérification et l’état « actuel » ou « en attente ». Depuis la v2.122.11, ces informations peuvent être lues, écrites et filtrées via l’API. Jusqu’à la v2.122.10, l’API ne prenait pas en charge ce bloc.

Lecture

Uniquement sur demande : GET /products?marketplaces=1, ainsi que /product/{ID}, /products/{ID} et les sections (uniquement 0 ou 1, sinon HTTP 400 INVALID_FILTER_VALUE). Chaque article comporte une entrée pour chaque canal de la boutique, classées par ordre croissant selon marketplace_id, même sans validation (dans ce cas, status 0). Avec ?fields=, le nom marketplaces demande le bloc ; ?marketplaces=1 sans le nom ne fonctionne alors pas (avertissement SWITCH_IGNORED).

GET /xpanel/xoport/Export/JSON/product/4711?marketplaces=1
{"products_id": 4711, "products_model": "ART-1", "…": "…",
 "marketplaces": [
  {"marketplace_id": 2, "code": "idealo", "name": "Idealo", "licensed": true, "adapter": true,
   "status": 1, "upload_status": "done", "verify_status": null, "sync_state": "pending",
   "last_updated": "2026-10-13 23:00:00", "last_error_at": null,
   "external_id": "ART-1", "external_link": null, "asin": null, "live": null, "messages": []},
  {"marketplace_id": 9, "code": "amazon", "name": "Amazon", "licensed": true, "adapter": true,
   "status": 1, "upload_status": "failed", "verify_status": null, "sync_state": "in_sync",
   "last_updated": "2026-10-14 11:00:00", "last_error_at": "2026-10-14 11:00:00",
   "external_id": "SKU-4711", "external_link": "https://www.amazon.de/dp/B0C1234567", "asin": "B0C1234567", "live": null,
   "messages": [{"code": "90220", "message": "Das Attribut brand fehlt.", "field": null}]}
 ]}

Les canaux Mirakl n’ont pas besoin d’ID d’offre : là-bas, le statut compare uniquement les moments, et une ligne enregistrée n’est jamais not_listed. Le commutateur status ne s’applique pas à sync_state.

Écrire

POST/PUT /products avec la clé marketplaces active le commutateur pour chaque canal (portée products:write). Seuls les canaux envoyés changent ; si la clé est absente, tout reste inchangé. Une entrée désigne le canal via code ou marketplace_id et contient status: 1/0, true/false ou "1"/"0". Les champs de lecture de l’exportation sont ignorés : une exportation avec ?marketplaces=1 est renvoyée telle quelle, de même qu’avec ?_strict=true. L’écriture ne concerne que les canaux disposant d’une licence dans la boutique.

PUT /xpanel/xoport/Import/JSON/products
{"type": "products", "data": [{"products_id": 4711, "marketplaces": [
  {"code": "idealo", "status": 1},
  {"marketplace_id": 9, "status": false},
  {"code": "manor", "status": "1"}
]}]}

→ "stats": {"…": "…", "marketplaces": {"processed": 1, "written": 1, "unchanged": 0, "skipped": 0}},
  "records": [{"index": 1, "products_id": 4711, "status": "updated", "marketplaces": "written"}]

Les avertissements n’interrompent rien : l’enregistrement et ses autres entrées continuent de fonctionner, le commutateur enregistré reste inchangé. Une entrée avec 0 pour un canal non validé ne crée rien. La réponse signale pour chaque enregistrement records[].marketplaces (written ou unchanged) et dans le lot stats.marketplaces.

• Marquage : un « PUT » comportant uniquement le code article (products_id, products_model) et marketplaces ne modifie pas la date de modification de l’article ; il n’apparaît pas dans le delta ?last_modified. Chaque ligne de canal modifiée reçoit last_updated 1970-01-01 00:00:00 et synchronise précisément ce canal lors de la prochaine exécution. Avec une offre (sur Mirakl, même sans), elle affiche alors sync_state pending ; sans offre, elle reste not_listed. Si l’enregistrement comporte d’autres champs modifiés, l’article est horodaté comme auparavant.
• Effet sur le canal (lors de la prochaine synchronisation, pas d’appel immédiat) : sur Amazon, eBay, Kaufland et Idealo, 1 crée une offre, tandis que 0 la supprime. Les canaux Mirakl tels que Manor ou Decathlon ne transmettent que des données Mirakl mises à jour (brand, category) et ne suppriment pas les articles. OTTO et Galaxus suivent le prochain export complet ; Shöpping.at intègre l’article lors du prochain flux, mais ne le retire pas. La boutique ne transmet pas les données relatives à Check24, Etsy et aux annonces sans connexion.
• Idealo : un retrait (0) reste valable, même si le produit est en stock. Si la boutique a elle-même désactivé une offre en raison d’un stock égal à 0, elle la réactive dès le réapprovisionnement, à condition que l’option « Réactiver automatiquement lors du réapprovisionnement » soit activée pour l’article ; l’envoi d’un status 0 n’y change rien. Une offre désactivée par le filtre, par exemple en raison de l’absence d’image, ne réapparaît pas automatiquement une fois le problème résolu : renvoyez la requête status 1.

Filtres de la place de marché

« Tous les articles Idealo non à jour » en une seule requête plutôt que sur l’ensemble du catalogue : ?marketplace= indique le canal (ID ou code, liste séparée par des virgules jusqu’à 100 valeurs), auquel s’ajoute au moins une condition. ?marketplaces=1 n’est pas nécessaire pour cela. Jusqu’à la version v2.122.10, les noms étaient ignorés ( UNKNOWN_FILTER ) et la liste était renvoyée sans filtrage.

# alle nicht aktuellen Idealo-Artikel
GET /Export/JSON/products?marketplace=idealo&marketplace_sync_state=pending&limit=250
# „ausstehend“ der Artikelliste: freigegeben und aktiv
GET /Export/JSON/products?marketplace=idealo&marketplace_status=1&marketplace_sync_state=pending&status=1
# Amazon-Artikel mit fehlgeschlagenem Upload („fehlgeschlagen“ der Artikelliste)
GET /Export/JSON/products?marketplace=amazon&marketplace_upload_status=error,failed
# freigegeben, aber noch nie übertragen (ohne Upload-Status), auf einem der Mirakl-Kanäle
GET /Export/JSON/products?marketplace=manor,decathlon&marketplace_status=1&marketplace_upload_status=none

• Toutes les conditions s’appliquent au même canal ; si plusieurs canaux sont mentionnés, un seul suffit. Les valeurs d’une liste constituent des alternatives.
• Le filtre « sync_state » ne s’applique pas : « pending » trouve également un article désactivé dont l’offre est encore enregistrée. Pour les articles « en attente » comme dans la liste des articles, il faut donc ajouter « marketplace_status=1 » et « status=1 ».
• Un article sans ligne enregistrée pour le canal compte pour 0 avec status, et pour not_listed ou not_tracked avec upload_status, none et sync_state.
• mirakl ne mentionne aucun canal ; les canaux Mirakl ont leurs propres codes.
• stats.total compte les résultats. La liste d’articles dans le backend masque en outre les articles que la synchronisation ne transfère pas, par exemple ceux sans image ou avec un code EAN en double ; ces articles figurent dans la réponse, mais pas dans la liste.

Codes

Le produit est identifié par son ID dans le chemin d'accès : DELETE /xpanel/xoport/delete/json/products/{ID}. Sans ID, l'API renvoie une réponse HTTP 400 MISSING_ID.

Exemple

curl -X DELETE "https://shop.de/xpanel/xoport/delete/json/products/123" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"