Prodotti Endpoint

Modelli di URL

A partire dalla v2.122.12, il segmento secondo /product o /products è un numero intero o un intervallo con limiti interi; inviare l’ID senza decimali e senza segno. Tutte le regole: API di esportazione, sezione «Segmento di percorso».

Parametri di query

A partire dalla v2.122.10, valori non validi e valori di elenco come ?limit[]=50 generano un errore HTTP 400 INVALID_FILTER_VALUE con details[].

A partire dalla v2.122.12, gli spazi vuoti ai margini non vengono conteggiati: ?bundles=%201 (così come marketplaces e bonus_free_features) restituisce il blocco; fino alla v2.122.11 mancava silenziosamente in quel punto. Un valore vuoto significa «non impostato».

A partire dalla v2.122.11, un valore composto esclusivamente da virgole su products_model, products_ean o seo_name genera un errore HTTP 400 INVALID_FILTER_VALUE (“holds no value”), così come un filtro di data composto esclusivamente da segni di punteggiatura come ?last_modified=.. In precedenza veniva restituito l’elenco non filtrato o solo le modifiche apportate da quel momento in poi. Gli altri filtri (status, categories_id, ean_prefix, last_modified …) sono disponibili nella sezione Export API, mentre la ricerca tramite l’indirizzo del negozio si trova nella sezione SEO History.

Richieste di esempio

# 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"

Campi della risposta

Ogni prodotto contiene:

• 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[] - Immagini dei prodotti con ordinamento. Gli articoli senza immagine principale non generano più una voce vuota con images_id 0 v2.122.10
• categories[] - ID delle categorie
• groups[] - Prezzi per gruppi di clienti
• customers_prices[] - Prezzi personalizzati per cliente
• specials[] - Prezzi speciali
• extra_fields[] - Campi aggiuntivi
• badges[] - Badge dei prodotti
• xsells[] - Prodotti di cross-selling, completi e conformi a sort_order v2.122.9
• upsells[] - Suggerimenti nel carrello ("Abbinamenti consigliati") v2.18.0+
• tabs[] - Schede prodotto
• bonus_free_features - solo con ?bonus_free_features=1: status_bonus, bonus_points (prezzo in punti per pezzo), max_bonus, status_free, bonus_value (valore della merce per ogni articolo gratuito), max_free, auto_free; solo in lettura bonus_date_added, bonus_last_modified, date_status_changed. Senza dati null v2.122.10
• bundle - solo con ?bundles=1: impostazioni e componenti di un bundle, senza bundle null v2.122.11
• marketplaces[] - solo con ?marketplaces=1: una voce per canale con interruttore e stato v2.122.11
• videos[] - Video dei prodotti
• suppliers[] - Fornitori: suppliers_id e products_model (codice articolo del fornitore). L’elenco sostituisce tutte le assegnazioni dell’articolo; una voce senza products_model azzera il numero.
• storages[] - Stock per magazzino v2.63.0+
• languages{} - Nome, descrizione, SEO per lingua:
  • 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à per lingua, se specificata; se non specificata, "vuoto" anziché " null " v2.122.9
• options{} - Caratteristiche senza gruppo di caratteristiche (nome opzione + valori per lingua, dati SKU per valore)
• option_groups[] - gruppi di caratteristiche combinati (ad es. «colore + taglia» abbinati), dati SKU per ogni combinazione v2.58.0+
• contenteditor{} - Dati ContentEditor per lingua

Altri campi del prodotto

Oltre ai campi sopra indicati, l’esportazione fornisce le altre colonne dell’articolo; a partire dalla v2.105.0, la maggior parte di esse è anche modificabile. Per questi campi, il nome può trarre in inganno o la loro funzione va oltre quanto ci si aspetterebbe:

Selezione dei campi (?fields=) v2.122.11

A /products, /product/{ID}, /products/{ID} e nelle sezioni, ?fields= elenca le chiavi per ciascun prodotto come elenco separato da virgole. Il negozio carica solo i dati relativi a queste: una pagina con 250 articoli pesava nel test 4,3 MB senza e 52 KB con 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}, …]

• Sono valide le chiavi del livello superiore del record del prodotto: ogni colonna del prodotto (comprese le colonne personalizzate del negozio), manufacturers_id e le chiavi dei blocchi dall’elenco sottostante. products_id è sempre incluso; l’ordine corrisponde a quello del record.
• Nomi da a–z, 0–9 e _, ciascuno fino a 64 caratteri. Massimo 100 elementi nell’elenco; si contano anche quelli vuoti e duplicati; un duplicato conta una sola volta. Un fields= vuoto o composto solo da virgole (fields=,) è considerato non impostato.
• Mancanza totale anziché valore vuoto: nella risposta manca una chiave non specificata; non compare mai [] o null. Allo stesso modo manca una chiave specificata che l’articolo non possiede, ad esempio special senza prezzo speciale. È quindi possibile restituire una selezione tramite PUT, anche con ?_strict=true, modificando solo ciò che contiene.
• La colonna shipping_profile fornisce solo l’ID del profilo; la risoluzione va specificata con shipping_profile_effective, shipping_profile_name, shipping_profile_step o shipping_profile_text.
• bundle, bonus_free_features e marketplaces: con ?fields= il nome richiede il blocco senza flag. Un flag senza il nome non ha quindi alcun effetto (avviso SWITCH_IGNORED).
• Senza ?fields= la risposta rimane invariata. L'esportazione XML non riconosce il parametro.

Chiave del blocco: un blocco viene caricato solo se viene specificata una delle sue chiavi. A ogni chiave corrisponde un contenuto; se la chiave manca:

• groups – Prezzi per gruppo di clienti, gruppo 0 dal prodotto
• manufacturers – Nomi dei produttori per manufacturers_id
• languages – Testi per lingua, comprese le unità di misura
• customers_prices – Prezzi per cliente; se manca, non viene visualizzato alcun prezzo per il cliente
• restricted_customer_groups – gruppi di clienti bloccati; se mancanti, senza blocco
• import_blocks – Blocchi di importazione; se mancanti, senza blocco
• categories – Assegnazioni alle categorie; se mancanti, non viene visualizzato
• images – Immagini principali e aggiuntive; [] senza immagine
• extra_fields – Campi aggiuntivi; [] e senza campo solo con sistema di magazzino avanzato, altrimenti manca
• badges – Badge; mancanti se non presenti
• xsells – Cross-selling; mancante se non inserito
• upsells – Up-selling; mancante se non inserito
• tabs – Schede in tutte le lingue; assenti senza schede
• special – Prezzo speciale; non disponibile senza prezzo speciale
• options – Caratteristiche senza gruppo; mancante senza caratteristica
• option_groups – Gruppi di caratteristiche combinati; mancanti senza gruppo
• videos – Video; non disponibile senza video
• suppliers – Fornitori; mancante senza assegnazione
• shipping_profile_effective, shipping_profile_name, shipping_profile_step, shipping_profile_text – Profilo a semaforo (un unico blocco per tutti e quattro): il profilo in vigore, il suo nome, il livello relativo alle scorte attuali e il testo relativo ai tempi di consegna; i quattro elementi mancano se il negozio non dispone di profili a semaforo
• quicksearch – Numero di voci di ricerca rapida per lingua ({} = non indicizzato)
• options_rules – Regole delle opzioni del configuratore; mancanti se non sono presenti regole
• contenteditor – Dati del ContentEditor relativi alla descrizione; solo con licenza xoContentEditor e dati
• storages – Righe di magazzino; solo con sistema di magazzino avanzato
• bundle – Pacchetti, null senza pacchetti; senza ?fields= solo con ?bundles=1
• bonus_free_features – Dati relativi a bonus e omaggi, null senza voce; senza ?fields= solo con ?bonus_free_features=1
• marketplaces – una voce per canale; senza ?fields= solo con ?marketplaces=1

Caratteristiche (opzioni)

A seconda del tipo di caratteristica, l’esportazione fornisce due strutture diverse:

Ci sono volutamente due campi: per ogni gruppo di caratteristiche esiste uno SKU per ogni combinazione (“nero / L” = un EAN), non per ogni singolo valore. Una fusione dei campi genererebbe codici articolo inesistenti. Un prodotto può contenere entrambi i campi.

"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[] sono nell’ordine di visualizzazione;combinations[].values[] segue lo stesso ordine — la posizione 0 è sempre il primo membro del gruppo.
• detail_id: 0 I campi SKU vuoti indicano che per questa combinazione non è stato inserito nulla (non è un errore).
• L’importazione continua a richiedere il formato options[] non gerarchico (v2.39.0) — convertire lato client per i roundtrip.

POST crea nuovi prodotti, PUT aggiorna quelli esistenti.

Prezzi personalizzati per cliente (customers_prices[]) v2.57.0

Per ogni prodotto è possibile importare prezzi diversi per singoli clienti. Il cliente viene identificato tramite customers_id o customers_id_extern (numero cliente 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"}
    ]
  }]
}

• Partial Upsert: vengono scritte solo le colonne inviate. Disponibili: customers_price (alias price), products_price1…products_price12 + products_price1_qty…products_price12_qty (prezzi scalari), products_qty_blocks, products_min_qty, products_max_qty.
• Indirizzamento dei clienti: tramite customers_id o customers_id_extern — il numero cliente del sistema di gestione delle merci deve essere univoco; i numeri ambigui generano un avviso e la voce viene saltata.
• _action: "delete" rimuove il prezzo del cliente in questione.
• customers_prices_replace: true = Sincronizzazione completa: prima vengono cancellati tutti i prezzi cliente del prodotto, poi vengono scritti quelli inviati. Se customers_prices: [] è vuoto, vengono rimossi tutti i prezzi cliente del prodotto.
• Impostazioni predefinite per l’inserimento: se manca customers_price, viene utilizzato il prezzo attuale del prodotto; blocchi di quantità e quantità minima = 1.
• customers_price ≤ 0 viene ignorato (avviso) — La rimozione avviene esclusivamente tramite _action: "delete".

Scorte di magazzino e livelli di allerta per magazzino (storages[]) v2.45.0

Quando il sistema multimagazzino è attivo, vengono gestiti le giacenze, le scorte di sicurezza, i livelli di allerta e gli spazi di stoccaggio per ciascun magazzino (tabella products_to_storages). L'array è presente dalla v2.34.0; a partire dalla v2.45.0 vengono scritti solo i campi effettivamente trasmessi — un payload parziale (ad es. solo products_reorder_level) non imposta più le restanti colonne di quel magazzino su 0.

Impostare solo il livello di segnalazione di un magazzino — tutti gli altri valori di questo magazzino rimangono invariati:

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

Esempio completo con due magazzini, una giacenza per caratteristica e una giacenza totale impostata separatamente:

{
  "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}
    ]
  }]
}

• Aggiornamento parziale (a partire dalla v2.45.0): vengono scritti solo i campi presenti nel payload (INSERT … ON DUPLICATE KEY UPDATE). Fino alla v2.44.0, la riga del magazzino veniva sostituita tramite REPLACE — le colonne omesse venivano inserite in 0.
• Chiave per ogni riga di magazzino: (storages_id, products_id, options_id). Se la tripla è uguale, viene aggiornata la riga esistente; altrimenti viene inserita una nuova riga.
• Nessuna replica completa: le righe di magazzino non presenti nell’array rimangono invariate. Non esistono né storages_replace né _action: "delete" — la rimozione delle righe di magazzino è possibile solo nel backend.
• No-Op senza dati utente: una voce che contiene solo la chiave non scrive nulla e, in particolare, non crea una riga con valori pari a zero.
• null Non è “invariato”: un campo con il valore null è considerato trasmesso e scrive 0. Se un valore deve rimanere invariato, omettete il campo.
• Nuova riga di magazzino: inviare anche le giacenze. Se per la tripla non esiste ancora una riga, questa viene creata solo dai campi trasmessi. Pertanto, durante il primo popolamento, inviate products_quantity e products_safe_quantity con — altrimenti il server del database potrebbe rifiutare il record in base alla configurazione, senza che la risposta segnali un errore.
• options_id: Impostazione predefinita 0. I valori > 0 gestiscono le giacenze di una combinazione di caratteristiche/varianti in questo magazzino; le giacenze di prodotto e di caratteristica sono righe separate.
• Il separatore decimale è il punto: "50.5" è valido, "50,5" viene letto come 50.
• Prerequisito EXTENDED_STORAGE_SYSTEM = 'true': se il sistema di magazzino esteso è disattivato, storages viene completamente ignorato; la risposta contiene l’avviso STORAGE_SYSTEM_DISABLED.
• Magazzino sconosciuto o inattivo: un storages_id che non esiste o il cui magazzino non è attivo genera l’avviso STORAGE_NOT_FOUND; la voce viene saltata, mentre le voci rimanenti vengono elaborate.
• Attenzione — l’assenza di storages_id viene silenziosamente ignorata: le voci prive di storages_id/warehouse_id o con un valore ≤ 0 vengono saltate senza avviso. L’importazione segnala quindi esito positivo, sebbene non sia stato registrato alcun stock.

Richiesta di esempio

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"
        }
      }
    }]
  }'

Composizione e impostazioni di un bundle sul prodotto, ambiti products:read e products:write. Fino alla v2.122.10 l’API REST non riconosceva il campo: un bundle inviato veniva ignorato come UNKNOWN_FIELD, ?bundles=1 segnalava UNKNOWN_FILTER.

Esportazione

Solo su richiesta: GET /products?bundles=1, anche /product/{ID} e aree (solo 0 o 1, altrimenti HTTP 400 INVALID_FILTER_VALUE). Con questo parametro, ogni prodotto della pagina porta la chiave: null senza bundle, altrimenti le impostazioni e items[] esattamente nella forma in cui vengono lette dall’importazione. Con ?fields=, il nome bundle richiede il blocco; ?bundles=1 senza il nome non funziona (avviso SWITCH_IGNORED).

Importazione

{ "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 } ] } } ] }

Tutto o niente per ogni record: la struttura, le impostazioni e ogni componente vengono verificati prima della scrittura. Un componente sconosciuto, un riferimento a se stesso, una quantità non valida, una selezione degli attributi o un’impostazione fanno fallire il record con INVALID_BUNDLE; details[] indica i motivi e non viene scritto nulla, nemmeno il prezzo dello stesso record.

Impostazioni

Valori: 1/0, true/false, ja/nein, yes/no, on/off; null = non specificato. Gli altri pulsanti di un nuovo pacchetto sono disattivati.

Componenti (items[])

Le voci identiche (prodotto e selezione) vengono unite in una riga con la quantità sommata. Un componente non può essere il pacchetto stesso.

Risposta

• records[].bundle: written, settings, removed o none. stats.bundles con processed, written, settings e removed, se la pila recava l’indicazione « bundle ».
• INVALID_BUNDLE con details[], ad esempio item 2: NOCOMPONENT SHIRT-9, item 1: QTY 0 o SETTING bundle_cart_listing.

La scheda «Piattaforme di vendita» della schermata dell’articolo abilita un articolo per ciascun canale; l’elenco degli articoli multicanale mostra lo stato di caricamento, lo stato di verifica e lo stato «attuale» o «in sospeso». A partire dalla v2.122.11 è possibile leggere, scrivere e filtrare questi dati tramite API. Fino alla v2.122.10 l’API non riconosceva questo blocco.

Lettura

Solo su richiesta: GET /products?marketplaces=1, anche /product/{ID}, /products/{ID} e le sezioni (solo 0 o 1, altrimenti HTTP 400 INVALID_FILTER_VALUE). Ogni articolo presenta una voce per ogni canale del negozio, in ordine crescente secondo marketplace_id, anche se non pubblicato (in tal caso status 0). Con ?fields=, il nome marketplaces richiede il blocco; ?marketplaces=1 senza il nome non funziona (avviso 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}]}
 ]}

I canali Mirakl non necessitano di un ID offerta: in questo caso lo stato confronta solo i momenti temporali e una riga salvata non è mai not_listed. L’interruttore status non viene applicato in sync_state.

Scrivere

POST/PUT /products con la chiave marketplaces imposta l’interruttore per ciascun canale (ambito products:write). Cambiano solo i canali inviati; se la chiave manca, tutto rimane invariato. Una voce identifica il canale tramite code o marketplace_id e contiene status: 1/0, true/false o "1"/"0". I campi di lettura dell’esportazione vengono ignorati: un’esportazione con ?marketplaces=1 viene restituita invariata, così come con ?_strict=true. La scrittura avviene solo per i canali con licenza presenti nello shop.

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"}]

Gli avvisi non interrompono nulla: il record e le sue restanti voci continuano a funzionare, l’impostazione salvata rimane invariata. Una voce con 0 per un canale senza autorizzazione non crea nulla. La risposta segnala per ogni record records[].marketplaces (written o unchanged) e in batch stats.marketplaces.

• Timbro: un PUT contenente solo l'ID articolo (products_id, products_model) e marketplaces non modifica la data di modifica dell'articolo; non compare nel delta ?last_modified. Ogni riga del canale modificata riceve last_updated 1970-01-01 00:00:00 e, alla successiva esecuzione, sincronizza proprio quel canale. Se è presente un'offerta (su Mirakl anche senza), mostra quindi sync_state pending ; in assenza di offerta rimane not_listed. Se il record contiene altri campi modificati, l'articolo viene contrassegnato come in precedenza.
• Effetto sul canale (al successivo allineamento, non in tempo reale): su Amazon, eBay, Kaufland e Idealo, 1 crea un’offerta, mentre 0 la rimuove. I canali Mirakl come Manor o Decathlon trasmettono solo con dati Mirakl aggiornati (brand, category) e non rimuovono l’articolo. OTTO e Galaxus seguono il prossimo export completo; Shöpping.at inserisce l’articolo con il prossimo feed, ma non lo rimuove. Il negozio non trasmette Check24, Etsy e le inserzioni senza collegamento.
• Idealo: un ritiro (0) rimane valido, anche in presenza di scorte. Se il negozio ha disattivato autonomamente un’offerta a causa di scorte pari a 0, la ripristina al rifornimento del magazzino, purché per l’articolo sia attivata l’opzione «Riattiva automaticamente al rifornimento del magazzino»; l’invio di un status 0 non modifica questa impostazione. Un'offerta disattivata dal filtro, ad esempio perché priva di immagine, non viene ripristinata automaticamente una volta risolto il problema: inviare nuovamente status 1.

Filtri del marketplace

«Tutti gli articoli Idealo non aggiornati» in un’unica richiesta anziché in tutto il catalogo: ?marketplace= indica il canale (ID o code, elenco separato da virgole fino a 100 valori), a cui si aggiunge almeno una condizione. ?marketplaces=1 non è necessario in questo caso. Fino alla versione v2.122.10 i nomi venivano ignorati come UNKNOWN_FILTER e l’elenco veniva restituito senza filtri.

# 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

• Tutte le condizioni si applicano allo stesso canale; se vengono indicati più canali, ne basta uno. I valori di un elenco sono alternativi.
• Il filtro « sync_state » non è attivo: « pending » individua anche un articolo disattivato la cui offerta è ancora presente. Per «in sospeso», come nell’elenco degli articoli, occorre quindi aggiungere « marketplace_status=1 » e « status=1 ».
• Un articolo senza riga salvata per il canale conta come 0 su status, mentre su upload_status, none e sync_state conta rispettivamente come not_listed o not_tracked.
• mirakl non indica alcun canale; i canali Mirakl hanno codici propri.
• stats.total conta i risultati. L’elenco degli articoli nel backend nasconde inoltre gli articoli che il confronto non trasferisce, ad esempio quelli senza immagine o con EAN duplicato; tali articoli sono presenti nella risposta, ma non nell’elenco.

Codici

Il prodotto viene identificato tramite il proprio ID nel percorso: DELETE /xpanel/xoport/delete/json/products/{ID}. Senza ID, l'API risponde con un codice HTTP 400 MISSING_ID.

Esempio

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