get_brand_items [v 1.1.0]
Questa chiamata mostra tutti i prodotti disponibili in uno specifico brand.
Chiamata parametri:
Parametro |
Obbligatorio |
Note |
uid |
si |
Id cliente |
pid |
si |
Id Portale |
lid |
si |
id Lingua |
key |
si |
Codice di autenticazione |
api_version |
si |
Versione API. |
request |
si |
Nome della funzione richiesta |
id_brand |
si |
Id del brand ottenuto dalla chiamata a get_brands |
display_brand_name |
no |
nome del brand a cui appartiene il prodotto |
display_reference |
no |
codice referenza del prodotto |
display_name |
no |
nome del prodotto |
display_stock |
no |
quantità disponibile in magazzino |
display_weight |
no |
peso del prodotto |
display_retail_price |
no |
prezzo casa madre |
display_discount |
no |
sconto store |
display_price |
no |
prezzo di vendita |
display_id_supplier |
no |
id fornitore - campo numerico che indica l'ID del fornitore del prodotto |
display_speed_shipping |
no |
Mostra la velocità di consegna del fornitore |
display_ean |
no |
Codice Ean |
display_currency |
no |
mostra la valuta in uso |
display_icon_path |
no |
mostra il percorso FQDN dell'icona del prodotto |
display_image_path |
no |
mostra il percorso FQDN dell'immagine del prodotto |
display_image_last_update |
no |
mostra la data dell'ultimo aggiornamento delle immagini |
display_attributes |
no |
mostra gli attributi del prodotto dove presenti. Nota: se non esplicitamente richiesto indicando display_attributes = true , questo campo non viene diffuso |
I campi non obbilgatori sono dei filtri utilizzati per ridurre il traffico e le informazioni non necessarie o non desiderate.
Sono tutti attivi di default, quindi la loro assenza nella stringa di richiesta comporta comunque la visualizzazione del campo nel flusso dati
Risposta parametri:
Parametro |
Sempre Pesente |
Note |
success |
si |
true o false, indica se l'operazione ha avuto buon esito o meno |
rc |
si |
return code. |
message |
si |
Messaggio di errore |
num_rows |
no |
Indica il numero di record trovati quando non ci sono errori durante l'elaborazione |
rows |
no |
Contiene il dettaglio dei prodotti disponibili se non ci sono errori durante l'elaborazione |
id_product |
si (se presente rows) |
id del prodotto secondo la classificazione wwt |
reference |
si (se presente rows) |
nome referenza indicato dalla casa madre |
brand_name |
si (se presente rows) |
nome catalogo di appartenenza |
si (se presente rows) |
nome prodotto |
|
stock |
si (se presente rows) |
quantità disponibile in magazzino |
weight |
si (se presente rows) |
peso |
retail_price |
si (se presente rows) |
prezzo casa madre |
discount |
si (se presente rows) |
sconto |
price |
si (se presente rows) |
prezzo |
id_supplier |
si (se presente rows) |
id fornitore WWT |
speed_shipping |
si (se presente rows) |
Mostra la velocità di consegna del fornitore
|
ean |
si (se presente rows) |
codice EAN |
currency |
si (se presente rows) |
Valuta con cui sono mostrati i prezzi |
images |
si (se presente rows) |
Elenco delle immagini del prodotto |
- icon_path |
si (se presente rows) |
Percorso FQDN dell'icona del prodotto |
- image_path |
si (se presente rows) |
Percorso FQDN dell'immagine del prodotto |
si (se presente rows) |
Mostra la data dell'ultimo aggiornamento delle immagini |
|
si (se presente rows) |
Dove presente, mostra l'elenco descrittivo degli attributi di un prodotto. |
attributes_array |
yes (if present in rows) |
Elenco dettagliato attributi |
- group_id |
yes (if present in rows) |
ID del gruppo a cui appartiene l'attributo |
- group_name |
yes (if present in rows) |
Etichetta del gruppo di attributi. Questo campo viene valorizzato in base alla lingua scelta (lid) |
- value_id |
yes (if present in rows) |
ID dell'attributo |
- value_name |
yes (if present in rows) |
Etichetta dell'attributo. Questo campo viene valorizzato in base alla lingua scelta (lid) |
Struttura Json di richiesta:
{ "uid": 12345, "pid": 2, "lid": 1, "key": "VtKpudWnzRBioQeBKQXPBdSpamppUTw8", "api_version": "1.0.0", "request": "get_brand_items", "id_brand": 240, "display_brand_name": true, "display_reference": true, "display_name": true, "display_stock": true, "display_weight": true, "display_retail_price": true, "display_discount": true, "display_price": true, "display_id_supplier": true, "display_speed_shipping": true, "display_ean": true, "display_currency": true, "display_icon_path": true, "display_image_path": true, "display_image_last_update": true, "display_attributes": true // per poter visualizzare gli attributi è necessario che questo campo sia presente e valga "true"; } } |
Esempio di chiamata php:
$data = array( "uid" => 12345, "pid" => 2, "lid" => 1, "key" => "VtKpud***********************************************ppUTw8", "api_version" => "1.0.0", "request" => "get_brand_items", "id_brand" => 240, "display_brand_name" => true, "display_reference" => true, "display_name" => true, "display_stock" => true, "display_weight" => true, "display_retail_price" => true, "display_discount" => true, "display_price" => true, "display_id_supplier" => true, "display_speed_shipping" => true, "display_ean" => true, "display_currency" => true, "display_icon_path" => true, "display_image_path" => true, "display_image_last_update" => true, "display_attributes" => true
); $data = array('data' => json_encode($data)); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://dev.dropshippingb2b.com/api/"); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER,FALSE); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST,2); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); $ce = curl_exec($ch); // in $ce la risposta alla chiamata echo $ce; curl_close($ch); |
Esempio di Risposta positiva con prodotti nel catalogo
{ "success": true, "rc": 0, "message": "", "num_rows": 12, "rows": [ { "id_product": "370529", "brand": "DIESEL ON", "reference": "DZT2001", "brand_name": "DIESEL ON", "name": "DIESEL ON Mod. DZT2001", "stock": "3", "weight": "200", "retail_price": 349, "discount": "55.00", "price": 157.05, "id_supplier": 68, "speed_shipping": "2", "ean": "4053858930803", "currency": "€", "images": [ { "icon_path": "https://static.wwt.it/store/1/DIESEL%20ON/icona_DZT2001.jpg", "image_path": "https://static.wwt.it/store/1/DIESEL%20ON/DZT2001.jpg", "last_update": "2019-06-07 14:14:04" }, { "icon_path": "https://static.wwt.it/store/loghi/DIESEL%20ON.jpg", "image_path": "https://static.wwt.it/store/loghi/DIESEL%20ON.jpg", "last_update": "2020-12-07 12:22:35" } ], "attributes": "WR: 3 ATM - Cassa: 48 mm - Genere: Uomo - Materiale Cassa: Acciaio Inossidabile - Materiale Cinturino: Pelle - Movimento: Quarzo - Funzioni: Multifunzione - Vetro: Minerale - Tipo Prodotto: Smartwatch - Confezione: Scatola Ufficiale", "attributes_array": [ { "group_id": 1, "group_name": "WR", "value_id": "67", "value_name": "3 ATM" }, { "group_id": 10, "group_name": "Cassa", "value_id": "76", "value_name": "48 mm" }, { "group_id": 18, "group_name": "Genere", "value_id": "19", "value_name": "Uomo" }, { "group_id": 23, "group_name": "Materiale Cassa", "value_id": "24", "value_name": "Acciaio Inossidabile" }, { "group_id": 36, "group_name": "Materiale Cinturino", "value_id": "43", "value_name": "Pelle" }, { "group_id": 48, "group_name": "Movimento", "value_id": "93", "value_name": "Quarzo" }, { "group_id": 55, "group_name": "Funzioni", "value_id": "60", "value_name": "Multifunzione" }, { "group_id": 61, "group_name": "Vetro", "value_id": "63", "value_name": "Minerale" }, { "group_id": 236, "group_name": "Tipo Prodotto", "value_id": "241", "value_name": "Smartwatch" }, { "group_id": 319, "group_name": "Confezione", "value_id": "320", "value_name": "Scatola Ufficiale" } ] }, { "id_product": "370530", "brand": "DIESEL ON", "reference": "DZT1011", "brand_name": "DIESEL ON", "name": "DIESEL ON Mod. DZT1011", "stock": "4", "weight": "200", "retail_price": 299, "discount": "55.00", "price": 134.55, "id_supplier": 68, "speed_shipping": "2", "ean": "4053858924123", "currency": "€", "images": [ { "icon_path": "https://static.wwt.it/store/1/DIESEL%20ON/icona_DZT1011.jpg", "image_path": "https://static.wwt.it/store/1/DIESEL%20ON/DZT1011.jpg", "last_update": "2018-10-10 07:20:02" }, { "icon_path": "https://static.wwt.it/store/loghi/DIESEL%20ON.jpg", "image_path": "https://static.wwt.it/store/loghi/DIESEL%20ON.jpg", "last_update": "2020-12-07 12:22:35" } ], "attributes": "Tipo Prodotto: Hybrid", "attributes_array": [ { "group_id": 236, "group_name": "Tipo Prodotto", "value_id": "747", "value_name": "Hybrid" } ] }, { "id_product": "370532", "brand": "DIESEL ON", "reference": "DZT2006", "brand_name": "DIESEL ON", "name": "DIESEL ON Mod. FULL GUARD", "stock": "123", "weight": "300", "retail_price": 349, "discount": "55.00", "price": 157.05, "id_supplier": 68, "speed_shipping": "2", "ean": "4053858990074", "currency": "€", "images": [ { "icon_path": "https://static.wwt.it/store/1/DIESEL%20ON/icona_DZT2006.jpg", "image_path": "https://static.wwt.it/store/1/DIESEL%20ON/DZT2006.jpg", "last_update": "2020-03-18 16:58:01" }, { "icon_path": "https://static.wwt.it/store/1/DIESEL%20ON/icona_DZT2006_1590229906.jpg", "image_path": "https://static.wwt.it/store/1/DIESEL%20ON/DZT2006_1590229906.jpg", "last_update": "2020-05-23 12:53:40" }, { "icon_path": "https://static.wwt.it/store/1/DIESEL%20ON/icona_DZT2006_1590230025.jpg", "image_path": "https://static.wwt.it/store/1/DIESEL%20ON/DZT2006_1590230025.jpg", "last_update": "2020-05-23 12:53:40" }, { "icon_path": "https://static.wwt.it/store/1/DIESEL%20ON/icona_DZT2006_1590231207.jpg", "image_path": "https://static.wwt.it/store/1/DIESEL%20ON/DZT2006_1590231207.jpg", "last_update": "2020-05-23 12:53:36" }, { "icon_path": "https://static.wwt.it/store/loghi/DIESEL%20ON.jpg", "image_path": "https://static.wwt.it/store/loghi/DIESEL%20ON.jpg", "last_update": "2020-12-07 12:22:35" } ], "attributes": "WR: Impermeabile agli schizzi - Cassa: 48 mm - Genere: Uomo - Materiale Cassa: Acciaio Inossidabile trattamento IP Gun - Materiale Cinturino: Silicone - Movimento: Quarzo Digitale - Funzioni: Multifunzione - Vetro: Minerale - Tipo Prodotto: Smartwatch - Confezione: Scatola Ufficiale", "attributes_array": [ { "group_id": 1, "group_name": "WR", "value_id": "340", "value_name": " Impermeabile agli schizzi" }, { "group_id": 10, "group_name": "Cassa", "value_id": "76", "value_name": "48 mm" }, { "group_id": 18, "group_name": "Genere", "value_id": "19", "value_name": "Uomo" }, { "group_id": 23, "group_name": "Materiale Cassa", "value_id": "83", "value_name": "Acciaio Inossidabile trattamento IP Gun" }, { "group_id": 36, "group_name": "Materiale Cinturino", "value_id": "79", "value_name": "Silicone" }, { "group_id": 48, "group_name": "Movimento", "value_id": "50", "value_name": "Quarzo Digitale" }, { "group_id": 55, "group_name": "Funzioni", "value_id": "60", "value_name": "Multifunzione" }, { "group_id": 61, "group_name": "Vetro", "value_id": "63", "value_name": "Minerale" }, { "group_id": 236, "group_name": "Tipo Prodotto", "value_id": "241", "value_name": "Smartwatch" }, { "group_id": 319, "group_name": "Confezione", "value_id": "320", "value_name": "Scatola Ufficiale" } ] } ] } |
Esempio di Risposta positiva con catalogo vuoto
{ "success": true, "rc": 0, "message": "", "num_rows":0," "rows": null } |
Una risposta Json negativa possibile:
{ "success": false, "rc": -4, "message”: "Fatal Error: There was an internal Error. Please retry or contact webmaster@wwt.it" } |
Questo Messaggio può avere come messaggi d'errore
- -2 Access Denied
- -4 Fatal Error: There was an internal Error. Please retry or contact webmaster@wwt.it
Created with the Personal Edition of HelpNDoc: Create help files for the Qt Help Framework