get_item    [v 1.0.0]


Questa chiamata mostra il dettaglio di un prodotto


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_product

si

Id del prodoto ottenuto dalla chiamata a get_brand_items

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

    name

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

  • 0 - Slow
  • 1 - Standard
  • 2 - Express

    ean

si (se presente rows)

codice EAN

    currency

si (se presente rows)

Valuta con cui sono mostrati i prezzi

    icon_path

si (se presente rows)

Percorso FQDN dell'icona del prodotto

    image_path

si (se presente rows)

Percorso FQDN dell'immagine del prodotto

    image_last_update

si (se presente rows)

Mostra la data dell'ultimo aggiornamento delle immagini

    attributes

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_item",

    "id_product":  91969,

    "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"          => "VtKpudWnzRBioQeBKQXPBdSpamppUTw8",

               "api_version"  => "1.0.0",

               "request"      => "get_brand_items",

               "id_product"   => 91969,

               "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"1,

    "rows": [

        {

            "id_product""370532",

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

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

            "image_last_update""2020-03-18 16:58:01",

            "currency""€",

            "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: Produce Kindle eBooks easily