get_basket_items


Questa chiamata mostra gli elementi contenuti nel basket.


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_basket

si

L'id del basket.


Il campo id_basket permette di cercare all'interno del basket:

  1. Un solo Item inserendo il suo ID,
  2. Item multipli, inserendo gli ID separati da  ;
  3. Tutti gli items  inserendo nel campo un *




Risposta parametri:

La risposta prevede due tipi di visualizzazioni diversi.


1 Viene restituito dalle chiamate 1 e 2 e mostra l'esito generale della chiamata più il dettaglio di ogni singola chiamata.

2 Risposta alla chiamata 3 mostra l'esito della chiamata e successivamente tutti gli items presenti nel basket.


Risposta Parte generale comune a tutte le chiamate


Parametro

Sempre Presente

Note

success

si

true o false, indica se tutte le operazioni eseguite hanno  avuto buon esito o meno

rc

si

return code.

message

si

Messaggio di errore

id_basket

no - solo per chiamate con id_basket = *

reminder della ricerca eseguita

num_rows

no - solo per chiamate con id_basket = *

numero dei record trovati nel basket

Items

si ( se rc != -4)

Nodo Padre dell'elenco prodotti


Questo parte del 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
  • -11 One or more errors occurred while processing your request.



Nel caso  di errori  -2 o -4, non sarà presente  il campo items e quindi neppure il dettaglio dei singoli messaggi.



Risposta Parte Dettagliata  alle chiamate di tipo 1 e 2


Parametro

Sempre Presente

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

id_basket

si

id del basket per cui si è chiesta la visualizzazione

item

si  (se rc != -4)

Dettaglio del prodotto nel basket

    id_basket

si  (se rc != -4)

id del basket presente nel db. Viene inserito anche in questa visualizzazione per mantenere omogenea la struttura dati con tutti e 3 i tipi di chiamate

    id_catalog

si (se rc = 0)

id del catologo di appartenenza del prodotto

    catalog_name

si (se rc = 0)

nome catalogo

    bundle

si (se rc = 0)

codice bundle

    id_supplier

si (se rc = 0)

id Fornitore

    speed_shipping

si (se rc = 0)

Mostra la velocità di consegna del fornitore

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

    id_product

si (se rc = 0)

id del prodotto inserito nel basket

    reference

si (se rc = 0)

quantità richiesta

    product_name

si (se rc = 0)

Nuova quantità disponibile nello store WWT dopo aver riservato la qty richiesta

    ean

si (se rc = 0)

Codice EAN

    weight

 (se rc = 0)

peso

    qty_reserved

si (se rc = 0)

Quantità riservata.

    retail_price

si (se rc = 0)

Prezzo a listino

    discount

si (se rc = 0)

sconto

    price

si (se rc = 0)

prezzo di vendita

    extra_discount

si (se rc = 0)

sconto percentuale extra nel caso sia stata raggiunta la soglia extra_discount_threshold_value

    net_price

si (se rc = 0)

Prezzo di vendita dopo l'extra sconto. Questo valore è almeno uguale a price, anche se extra_discount = 0

    user_id_order

si (se rc = 0)

id ordine utente finale

    user_id_user

si (se rc = 0)

id_cliente di riferimento inserito nello store del partner

    user_company_name

si (se rc = 0)

ragione sociale o titolo dell'utente finale (Mr., Ms., Sig. , Sig.ra, dott., etc..  )

    user_first_name

si (se rc = 0)

nome utente finale

    user_last_name

si (se rc = 0)

cognome utente finale

    user_address

si (se rc = 0)

indirizzo utente finale

    user_city

si (se rc = 0)

città utente finale

    user_country

si (se rc = 0)

cap utente finale

    user_zipcode

si (se rc = 0)

nazione utente finale

    user_state

si (se rc = 0)

telefono utente finale

    user_mobile

si (se rc = 0)

cellulare utente finale

    user_mail

si (se rc = 0)

indirizzo mail  utente finale

    user_retail_price

si (se rc = 0)

prezzo retail utente finale

    user_discount

si (se rc = 0)

prezzo scontato utente finale

    user_price

si (se rc = 0)

prezzo finale utente finale

    user_cod

si (se rc = 0)

Pagamento in contrassegno (cod: Cache on Delivery ). Due soli valori ammessi:

  • 1 - Si
  • 0 - No

Default : 0

    user_note

si (se rc = 0)

note inserite dall'utente finale

    internal_note

si (se rc = 0)

note inserite dal partner per WWT




Risposta Parte Dettagliata  alle chiamate di tipo 3



Parametro

Sempre Presente

Note

  id_basket

si  (se esiste almeno un record)

id del basket presente nel db

  id_catalog

si  (se esiste almeno un record)

id del catologo di appartenenza del prodotto

  catalog_name

si  (se esiste almeno un record)

nome catalogo

  id_supplier

si  (se esiste almeno un record)

id Fornitore

  speed_shipping

si  (se esiste almeno un record)

Mostra la velocità di consegna del fornitore

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

    id_product

si  (se esiste almeno un record)

id del prodotto inserito nel basket

    reference

si  (se esiste almeno un record)

quantità richiesta

    product_name

si  (se esiste almeno un record)

Nuova quantità disponibile nello store WWT dopo aver riservato la qty richiesta

    ean

si  (se esiste almeno un record)

Codice EAN

    weight

si  (se esiste almeno un record)

peso

    qty_reserved

si  (se esiste almeno un record)

Quantità riservata.

    retail_price

si  (se esiste almeno un record)

Prezzo a listino

    discount

si  (se esiste almeno un record)

sconto

    price

si  (se esiste almeno un record)

prezzo di vendita

    extra_discount

si  (se esiste almeno un record)

sconto percentuale extra nel caso sia stata raggiunta la soglia extra_discount_threshold_value

    net_price

si  (se esiste almeno un record)

Prezzo di vendita dopo l'extra sconto. Questo valore è almeno uguale a price, anche se extra_discount = 0

    user_id_order

si  (se esiste almeno un record)

id ordine utente finale

    user_id_user

si  (se esiste almeno un record)

id_cliente di riferimento inserito nello store del partner

    user_company_name

si  (se esiste almeno un record)

ragione sociale o titolo dell'utente finale (Mr., Ms., Sig. , Sig.ra, dott., etc..  )

    user_first_name

si  (se esiste almeno un record)

nome utente finale

    user_last_name

si  (se esiste almeno un record)

cognome utente finale

    user_address

si  (se esiste almeno un record)

indirizzo utente finale

    user_city

si  (se esiste almeno un record)

città utente finale

    user_country

si  (se esiste almeno un record)

cap utente finale

    user_zipcode

si  (se esiste almeno un record)

nazione utente finale

    user_state

si  (se esiste almeno un record)

telefono utente finale

    user_mobile

si  (se esiste almeno un record)

cellulare utente finale

    user_mail

si  (se esiste almeno un record)

indirizzo mail  utente finale

    user_retail_price

si  (se esiste almeno un record)

prezzo retail utente finale

    user_discount

si  (se esiste almeno un record)

prezzo scontato utente finale

    user_price

si  (se esiste almeno un record)

prezzo finale utente finale

    user_cod

si  (se esiste almeno un record)

Pagamento in contrassegno (cod: Cache on Delivery ). Due soli valori ammessi:

  • 1 - Si
  • 0 - No

Default : 0

    user_note

si  (se esiste almeno un record)

note inserite dall'utente finale

    internal_note

si  (se esiste almeno un record)

note inserite dal partner per WWT




Strutture Chiamate JSON


1. Struttura Json di richiesta singolo items:


{

  "uid"         : "12345",

  "pid"         : "2",

  "lid"         : "1",

  "key”         : "VtKpudWnzRBioQeBKQXPBdSpamppUTw8",

  "api_version" : "1.0.0",

  "request"     : "get_basket_items",

  "id_basket"   : "10"

}



2. Struttura Json di richiesta item multipli:


{

  "uid"         : "12345",

  "pid"         : "2",

  "lid"         : "1",

  "key”         : "VtKpudWnzRBioQeBKQXPBdSpamppUTw8",

  "api_version" : "1.0.0",

  "request"     : "get_basket_items",

  "id_basket"   : "1;2;3"

}


3. Struttura Json  da utilizzare per ottenere l'elenco di tutti gli items presenti nel basket:


{

  "uid"         : "12345",

  "pid"         : "2",

  "lid"         : "1",

  "key”         : "VtKpudWnzRBioQeBKQXPBdSpamppUTw8",

  "api_version" : "1.0.0",

  "request"     : "get_basket_items",

  "id_basket"   : "*"

}



Struttura Chiamata PHP


Esempio di chiamata php:



$data = array(


               "uid"             => 12345,

               "pid"             => 2,

               "lid"             => 1,

               "key"             => "VtKpudWnzRBioQeBKQXPBdSpamppUTw8",

               "api_version"     => "1.0.0",

               "request"         => "get_basket_items",

               "id_basket"       => "1;2;3"


);



$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);







Strutture risposte JSON



Esempio di Risposta di tipo 1  positiva

{

   "success":true,

   "rc":0,

   "message":"",

   "items":[

      {

         "success":true,

         "rc":0,

         "message":"",

         "id_basket":3,

         "item":{

            "id_basket":"3",

            "id_catalog":"369",

            "id_supplier":"18",

            "speed_shipping":"1",

            "catalog_name":"BREIL",

            "id_product":"51788",

            "reference":"BW0052",

            "product_name":"BREIL Mod. LIBERTY lady 3H",

            "ean":"",

            "weight":"200",

            "qty_reserved":"11",

            "retail_price":"190.00",

            "discount":"70.00",

            "price":"57.00",

            "extra_discount":"30.00",

            "net_price":"39.90",

            "user_id_order":"22",

            "user_id_user":"33",

            "user_company_name":"Mr.",

            "user_first_name":"Arabella",

            "user_last_name":"Palermo",

            "user_address":"Bayreuther Strasse 14",

            "user_city":"Offenbach",

            "user_country":"am",

            "user_zipcode":"63073",

            "user_state":"Germany",

            "user_phone":"069 82 66 04",

            "user_mobile":"069 82 66 07",

            "user_mail":"ArabellaPalermo@dayrep.de",

            "user_retail_price":"1000.00",

            "user_discount":"50.30",

            "user_price":"497.00",

            "user_cod":1,

            "user_note":"dGVzdG8gY2xpZW50ZQ==",

            "internal_note":"dGVzdG8gZXNlcmNlbnRl"

         }

      }

   ]

}



Esempio di Risposta di tipo 1  con errori

{

   "success":false,

   "rc":-11,

   "message":"One or more errors occurred while processing your request",

   "items":[

      {

         "success":false,

         "rc":-12,

         "message":"id_basket 13 not found",

         "id_basket":13,

         "item":null

      }

   ]

}




Esempio di Risposta di tipo 2  positiva

{

   "success":true,

   "rc":0,

   "message":"",

   "items":[

      {

         "success":true,

         "rc":0,

         "message":"",

         "id_basket":3,

         "item":{

            "id_basket":"3",

            "id_catalog":"369",

            "catalog_name":"BREIL",

            "id_supplier":"18",

            "speed_shipping":"1",

            "id_product":"51788",

            "reference":"BW0052",

            "product_name":"BREIL Mod. LIBERTY lady 3H",

            "ean":"",

            "weight":"200",

            "qty_reserved":"11",

            "retail_price":"190.00",

            "discount":"70.00",

            "price":"57.00",

            "extra_discount":"30.00",

            "net_price":"39.90",

            "user_id_order":"22",

            "user_id_user":"33",

            "user_company_name":"Mr.",

            "user_first_name":"Arabella",

            "user_last_name":"Palermo",

            "user_address":"Bayreuther Strasse 14",

            "user_city":"Offenbach",

            "user_country":"am",

            "user_zipcode":"63073",

            "user_state":"Germany",

            "user_phone":"069 82 66 04",

            "user_mobile":"069 82 66 07",

            "user_mail":"ArabellaPalermo@dayrep.de",

            "user_retail_price":"1000.00",

            "user_discount":"50.30",

            "user_price":"497.00",

            "user_cod":1,

            "user_note":"dGVzdG8gY2xpZW50ZQ==",

            "internal_note":"dGVzdG8gZXNlcmNlbnRl"

         }

      },

      {

         "success":true,

         "rc":0,

         "message":"",

         "id_basket":4,

         "item":{

            "id_basket":"4",

            "id_catalog":"589",

            "catalog_name":"BINO",

            "id_supplier":"18",

            "speed_shipping":"1",

            "id_product":"104898",

            "reference":"25408AA",

            "product_name":"BINO MULTIF. LCD",

            "ean":"",

            "weight":"200",

            "qty_reserved":"1",

            "retail_price":"18.00",

            "discount":"75.00",

            "price":"4.50",

            "extra_discount":"30.00",

            "net_price":"3.15",

            "user_id_order":"22",

            "user_id_user":"33",

            "user_company_name":"Ms",

            "user_first_name":"Matilda",

            "user_last_name":"Dale",

            "user_address":"10 Horner Street",

            "user_city":"Akron",

            "user_country":"OH",

            "user_zipcode":"44307",

            "user_state":"United States",

            "user_phone":"330-977-0601",

            "user_mobile":"330-977-0602",

            "user_mail":"MatildaDale@rhyta.com",

            "user_retail_price":"1000.00",

            "user_discount":"50.30",

            "user_price":"497.00",

            "user_cod":1,

            "user_note":"dGVzdG8gY2xpZW50ZQ==",

            "internal_note":"dGVzdG8gZXNlcmNlbnRl"

         }

      }

   ]

}



Esempio di Risposta di tipo 2 con errori

{

   "success":false,

   "rc":-11,

   "message":"One or more errors occurred while processing your request",

   "items":[

      {

         "success":false,

         "rc":-12,

         "message":"id_basket 2 not found",

         "id_basket":2,

         "item":null

      },

      {

         "success":true,

         "rc":0,

         "message":"",

         "id_basket":3,

         "item":{

            "id_basket":"3",

            "id_catalog":"369",

            "catalog_name":"BREIL",

            "id_supplier":"18",

            "speed_shipping":"1",

            "id_product":"51788",

            "reference":"BW0052",

            "product_name":"BREIL Mod. LIBERTY lady 3H",

            "ean":"",

            "weight":"200",

            "qty_reserved":"11",

            "retail_price":"190.00",

            "discount":"70.00",

            "price":"57.00",

            "extra_discount":"30.00",

            "net_price":"39.90",

            "user_id_order":"22",

            "user_id_user":"33",

            "user_company_name":"Mr.",

            "user_first_name":"Arabella",

            "user_last_name":"Palermo",

            "user_address":"Bayreuther Strasse 14",

            "user_city":"Offenbach",

            "user_country":"am",

            "user_zipcode":"63073",

            "user_state":"Germany",

            "user_phone":"069 82 66 04",

            "user_mobile":"069 82 66 07",

            "user_mail":"ArabellaPalermo@dayrep.de",

            "user_retail_price":"1000.00",

            "user_discount":"50.30",

            "user_price":"497.00",

            "user_cod":1,

            "user_note":"dGVzdG8gY2xpZW50ZQ==",

            "internal_note":"dGVzdG8gZXNlcmNlbnRl"

         }

      }

   ]

}



A differenza delle richieste di tipo 1 e 2, la richiesta di tipo 3 non prevede errori di ritorno.

Nel caso in cui non ci fossero prodotti nel basket si avrà un esito positivo con il campo num_rows valorizzato a 0 ed il subarray items uguale a null.

Naturalmente anche la chiamata di tipo 3 rimane soggetta ad errori sistemici quali ad esempio il -2 o -4.


Esempio di Risposta di tipo 3 positiva

{

   "success":true,

   "rc":0,

   "message":"",

   "id_basket":"*",

   "num_rows":3,

   "items":[

      {

         "id_basket":"3",

         "id_catalog":"369",

         "catalog_name":"BREIL",

         "id_supplier":"18",

         "speed_shipping":"1",

         "id_product":"51788",

         "reference":"BW0052",

         "product_name":"BREIL Mod. LIBERTY lady 3H",

         "ean":"",

         "weight":"200",

         "qty_reserved":"11",

         "retail_price":"190.00",

         "discount":"70.00",

         "price":"57.00",

         "extra_discount":"30.00",

         "net_price":"39.90",

         "user_id_order":"22",

         "user_id_user":"33",

         "user_company_name":"Mr.",

         "user_first_name":"Arabella",

         "user_last_name":"Palermo",

         "user_address":"Bayreuther Strasse 14",

         "user_city":"Offenbach",

         "user_country":"am",

         "user_zipcode":"63073",

         "user_state":"Germany",

         "user_phone":"069 82 66 04",

         "user_mobile":"069 82 66 07",

         "user_mail":"ArabellaPalermo@dayrep.de",

         "user_retail_price":"1000.00",

         "user_discount":"50.30",

         "user_price":"497.00",

         "user_cod":1,

         "user_note":"dGVzdG8gY2xpZW50ZQ==",

         "internal_note":"dGVzdG8gZXNlcmNlbnRl"

      },

      {

         "id_basket":"4",

         "id_catalog":"589",

         "catalog_name":"BINO",

         "id_supplier":"18",

         "speed_shipping":"1",

         "id_product":"104898",

         "reference":"25408AA",

         "product_name":"BINO MULTIF. LCD",

         "ean":"",

         "weight":"200",

         "qty_reserved":"1",

         "retail_price":"18.00",

         "discount":"75.00",

         "price":"4.50",

         "extra_discount":"30.00",

         "net_price":"3.15",

         "user_id_order":"22",

         "user_id_user":"33",

         "user_company_name":"Ms",

         "user_first_name":"Matilda",

         "user_last_name":"Dale",

         "user_address":"10 Horner Street",

         "user_city":"Akron",

         "user_country":"OH",

         "user_zipcode":"44307",

         "user_state":"United States",

         "user_phone":"330-977-0601",

         "user_mobile":"330-977-0602",

         "user_mail":"MatildaDale@rhyta.com",

         "user_retail_price":"1000.00",

         "user_discount":"50.30",

         "user_price":"497.00",

         "user_cod":1,

         "user_note":"dGVzdG8gY2xpZW50ZQ==",

         "internal_note":"dGVzdG8gZXNlcmNlbnRl"

      },

      {

         "id_basket":"5",

         "id_catalog":"589",

         "catalog_name":"BINO",

         "id_supplier":"18",

         "speed_shipping":"1",

         "id_product":"104903",

         "reference":"26544AA",

         "product_name":"SV. BINO LCD",

         "ean":"1234567890",

         "weight":"200",

         "qty_reserved":"14",

         "retail_price":"15.00",

         "discount":"75.00",

         "price":"3.75",

         "extra_discount":"30.00",

         "net_price":"2.63",

         "user_id_order":"22",

         "user_id_user":"33",

         "user_company_name":"Mr.",

         "user_first_name":"Arabella",

         "user_last_name":"Palermo",

         "user_address":"Bayreuther Strasse 14",

         "user_city":"Offenbach",

         "user_country":"am",

         "user_zipcode":"63073",

         "user_state":"Germany",

         "user_phone":"069 82 66 04",

         "user_mobile":"069 82 66 07",

         "user_mail":"ArabellaPalermo@dayrep.de",

         "user_retail_price":"1000.00",

         "user_discount":"50.30",

         "user_price":"497.00",

         "user_cod":1,

         "user_note":"dGVzdG8gY2xpZW50ZQ==",

         "internal_note":"dGVzdG8gZXNlcmNlbnRl"

      }

   ]

}




Esempio di Risposta di tipo 3 senza elementi

{

   "success":true,

   "rc":0,

   "message":"",

   "id_basket":"*",

   "num_rows":0,

   "items":null

}



















       

Created with the Personal Edition of HelpNDoc: Full-featured multi-format Help generator