Poznaj pary klucz/wartość związane z tworzeniem koszyka.
Ten punkt końcowy API jest używany do wysyłania informacji o koszyku i przedmiotów z koszyka klienta do interfejsu API Zonos.
Otrzymasz odpowiedź JSON zawierającą tempCartUUID, unikatowy identyfikator koszyka w systemie Zonos. Będzie on używany do przekierowania klienta do Zonos Checkout w celu ukończenia zamówienia.
POST https://api.iglobalstores.com/v1/createTempCart
pole↕
uwagi↕
boxCount
Przykładowa wartość: 22x15x15(1),8x8x4(2),32x22x14(1) Format: Lista wymiarów pudełek i liczby oddzielone przecinkami. W powyższym przykładzie jest łącznie 4 pudełka. Pierwsze pudełko na liście będzie mieć długość 22 cali, szerokość 15 cali i wysokość 15 cali. Będzie tylko jedno pudełko tego rozmiaru. Będą dwa pudełka rozmiaru: 8x8x4 cale. Dopuszczalne jest przesłanie tego samego wymiaru pudełka wiele razy, jeśli jest to dla Ciebie łatwe, na przykład: "22x15x15(1),22x15x15(1)", co oznacza 2 pudełka rozmiaru: 22x15x15 cali. To pole opisuje pudełka, które będą używane do wysłania zamówienia. Nie oczekuje się, że sprzedawca zna to w momencie zamówienia; jednak jeśli jest to znane, można je przesłać w formacie string.
contShoppingURL
To pole jest używane do przesłania adresu URL w celu zastąpienia HREF przycisku "Kontynuuj zakupy" wewnątrz Zonos Checkout. string
domesticShippingCharge
To pole jest używane do przesłania opłaty za wysyłkę krajową do Zonos Checkout, a kwota zostanie dodana do wysyłki. Można to skonfigurować do dodania całkowitej wysyłki lub rozdzielić jako oddzielną pozycję wiersza. dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne
externalConfirmationPageURL
To pole jest używane do przesłania adresu URL strony potwierdzenia zamówienia/podziękowania. Po ukończeniu płatności wewnątrz Zonos Checkout klient zostanie przekierowany na ten adres URL w celu potwierdzenia zamówienia. Ten adres URL jest często używany do wyzwolenia wywołania punktu końcowego usługi API "orderDetail" Zonos w celu pobrania szczegółów zamówienia i zaimportowania zamówienia do systemu. string
footerHTML
To pole jest używane do przesłania zakodowanego adresu URL ciągu HTML. Ten ciąg HTML będzie zdekodowany i umieszczony przed tagiem zamykającym body na stronie koszyka. Zwykle używane do przesyłania kodu do remarketingu, analityki itp. ciąg kodowany adresem URL
items
REQUIRED
To pole jest listą map pozycji. ciąg JSON
items[index].countryOfOrigin
To pole jest używane do przesłania kraju pochodzenia towaru. Parametr musi być krajem dwuliterowy kod ISO. string
items[index].description
REQUIRED
To pole jest używane do przesłania pełnego opisu przedmiotu pozycji w koszyku, w tym wszelkich opcji przedmiotu, kolorów itp. string
items[index].height
To pole jest używane do przesłania wysokości przedmiotu i jest wysoce zalecane dla dokładnych ofert wysyłki. Jednostki wysokości są
REQUIRED
w calach. string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne / liczba całkowita (cale)
items[index].imageURL
REQUIRED
To pole jest używane do przesłania adresu URL obrazu produktu przedmiotu. Adres URL musi być HTTPS, aby być wyświetlanym wewnątrz Zonos Checkout. string / HTTPS URL
items[index]itemBrand
To pole jest używane do przesłania marki przedmiotustring
items[index]itemCategory
To pole jest używane do przesłania kategorii przedmiotu i może być przesłane oddzielone znakiem pipe, jeśli przedmiot ma więcej niż jedną kategorię. Przykładowe wartości: "shoes" lub "shoes|sport-shoes|discount-shoes"string
items[index]itemCustomization
To pole jest używane do przesłania dodatkowych szczegółów dotyczących przedmiotu, które nie są wyświetlane w Zonos Checkout; jednak można je pobrać poprzez punkt końcowy usługi API "orderDetail".
items[index]itemHSCode
To pole jest używane do przesłania kodu HS towaru i może być z kropkami lub bez. Przykładowe wartości: "3926901000" lub "3926.90.1000"string
items[index].itemURL
To pole jest używane do przesłania adresu URL strony produktu przedmiotu. string / URL
items[index].length
To pole jest używane do przesłania długości przedmiotu i jest wysoce zalecane dla dokładnych ofert wysyłki. Jednostki długości są
REQUIRED
w calach. string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne / liczba całkowita (cale)
items[index].nonShippable
To pole jest używane do wskazania, czy przedmiot powinien być uwzględniony w obliczeniach wysyłki, podatków i opłat. Pobieranie cyfrowe, kody rabatowe, opłaty manipulacyjne itp. powinny być przesłane z wartością "true". boolean: true lub false
items[index].productId
To pole jest używane do przesłania ilości pozycji wiersza. string
items[index].quantity
REQUIRED
To pole jest używane do przesłania ilości pozycji wiersza. string
items[index].sku
To pole jest używane do przesłania numeru SKU / UPC / itp. przedmiotu. string
items[index].unitPrice
REQUIRED
To pole jest używane do przesłania ceny jednostkowej pozycji wiersza. dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne / liczba całkowita
items[index].weight
To pole jest używane do przesłania wagi przedmiotu i jest wysoce zalecane dla dokładnych ofert wysyłki. Jednostki wagi są domyślnie "LBS", chyba że przesłano inną jednostkę wagi w items[index].itemWeightUnits``string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne / liczba całkowita
items[index].weightUnits
To pole jest używane do zastąpienia domyślnych jednostek wagi przedmiotu. Jednostki wagi przedmiotu są domyślnie "LBS", chyba że w tym polu przesłano inną jednostkę wagi. string - "LB", "OZ", "KG", lub "G"
items[index].width
To pole jest używane do przesłania szerokości przedmiotu i jest wysoce zalecane dla dokładnych ofert wysyłki. Jednostki szerokości są
REQUIRED
w calach. string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne / liczba całkowita (cale)
misc1 - misc6
To pole jest używane do przesłania danych dodatkowych związanych z zamówieniem poprzez interfejs API Zonos, które będą pobierane razem z danymi zamówienia zwracanymi z punktu końcowego usługi API "orderDetail" Zonos. string
referenceId
To pole jest używane do przesłania unikatowej wartości identyfikacji odniesienia dla koszyka/sesji/itp. w Twoim systemie. Można to używać do wyszukania identyfikatora zamówienia Zonos poprzez punkt końcowy usługi API "orderDetail" Zonos. string
storeId
REQUIRED
Identyfikator sklepu dostarczony przez Zonos. integer
Aby przesłać rabaty, kupony i kody promocyjne do Zonos poprzez wysyłkę serwera, muszą być przesłane jako oddzielna pozycja z ujemną wartością dla parametrów: "unitPrice" i "nonShippable":true.
Ten parametr będzie zawierać GUID przypisany do międzynarodowego koszyka klienta i utworzony w systemie Zonos. To pole będzie przesłane poprzez parametr zapytania adresu URL string podczas przekierowania przeglądarki użytkownika do Zonos Checkout.
Odpowiedzi błędów HTTP
Kod błędu↕
znaczenie↕
400
Nieoczekiwany znak w treści żądania.
406
Niedopuszczalne. Nagłówek HTTP dla "Accept" jest nieprawidłowy.
415
Nieobsługiwany typ nośnika. Nagłówek HTTP dla "Content-Type" jest nieprawidłowy.
422
Jednostka nie do przetworzenia.
500
"storeId" był nieprawidłowy lub nie można było przeanalizować treści JSON.
Po otrzymaniu pomyślnej odpowiedzi zawierającej tempCartUUID, serwer wyśle przekierowanie z przeglądarki klienta do Zonos Checkout z odpowiednimi parametrami ciągu zapytania adresu URL omówionymi poniżej.
Uwaga: [yourassignedsubdomain] - Skontaktuj się z członkiem zespołu implementacji Zonos, aby otrzymać swoją domenę Zonos.com.
Parametry żądania adresu URL
pole↕
uwagi↕
tempCartUUID
REQUIRED
Ta wartość jest uzyskiwana przez wywołanie punktu końcowego usługi API Zonos createTempCart. string / GUID
country
Dwuliterowy kod ISO kraju docelowego. Zdecydowanie zalecamy przesłanie tego parametru dla doświadczenia użytkownika. Parametr country wstępnie wybierze kraj docelowy wewnątrz Zonos Checkout. Korzystając z Zonos Hello JS (JavaScript) na stronie, można uzyskać tę wartość, wywołując metodę JavaScript: zonos.country(). string (Długość: 2)
Utwórz koszyk
Utwórz koszyk
Poznaj pary klucz/wartość związane z tworzeniem koszyka.
Ten punkt końcowy API jest używany do wysyłania informacji o koszyku i przedmiotów z koszyka klienta do interfejsu API Zonos.
Otrzymasz odpowiedź JSON zawierającą
tempCartUUID, unikatowy identyfikator koszyka w systemie Zonos. Będzie on używany do przekierowania klienta do Zonos Checkout w celu ukończenia zamówienia.Atrybuty
Pary klucz/wartość JSON w treści żądania
POST
https://api.iglobalstores.com/v1/createTempCartboxCountFormat: Lista wymiarów pudełek i liczby oddzielone przecinkami. W powyższym przykładzie jest łącznie 4 pudełka. Pierwsze pudełko na liście będzie mieć długość 22 cali, szerokość 15 cali i wysokość 15 cali. Będzie tylko jedno pudełko tego rozmiaru. Będą dwa pudełka rozmiaru: 8x8x4 cale. Dopuszczalne jest przesłanie tego samego wymiaru pudełka wiele razy, jeśli jest to dla Ciebie łatwe, na przykład: "22x15x15(1),22x15x15(1)", co oznacza 2 pudełka rozmiaru: 22x15x15 cali. To pole opisuje pudełka, które będą używane do wysłania zamówienia. Nie oczekuje się, że sprzedawca zna to w momencie zamówienia; jednak jeśli jest to znane, można je przesłać w formacie
string.contShoppingURLstringdomesticShippingChargedodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętneexternalConfirmationPageURLstringfooterHTMLciąg kodowany adresem URLitemsREQUIRED
ciąg JSONitems[index].countryOfOriginstringitems[index].descriptionREQUIRED
stringitems[index].heightREQUIRED
string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne / liczba całkowita (cale)items[index].imageURLREQUIRED
string / HTTPS URLitems[index]itemBrandstringitems[index]itemCategoryPrzykładowe wartości: "shoes" lub "shoes|sport-shoes|discount-shoes"
stringitems[index]itemCustomizationitems[index]itemHSCodePrzykładowe wartości: "3926901000" lub "3926.90.1000"
stringitems[index].itemURLstring / URLitems[index].lengthREQUIRED
string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne / liczba całkowita (cale)items[index].nonShippableboolean: true lub falseitems[index].productIdstringitems[index].quantityREQUIRED
stringitems[index].skustringitems[index].unitPriceREQUIRED
dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne / liczba całkowitaitems[index].weightitems[index].itemWeightUnits``string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne / liczba całkowitaitems[index].weightUnitsstring - "LB", "OZ", "KG", lub "G"items[index].widthREQUIRED
string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca dziesiętne / liczba całkowita (cale)misc1 - misc6stringreferenceIdstringstoreIdREQUIRED
integerDodatkowe typy danych ciągów
items[index].itemDescriptionLongitems[index].itemDescriptionDetaileditems[index].itemFabricContentitems[index].itemColoritems[index].itemLtlClassitems[index].statusitems[index].itemMaterialRabaty, kupony i kody promocyjne
Aby przesłać rabaty, kupony i kody promocyjne do Zonos poprzez wysyłkę serwera, muszą być przesłane jako oddzielna pozycja z ujemną wartością dla parametrów:
"unitPrice"i"nonShippable":true.{"description": "Discount (10OFF) - 10% OFF","unitPrice": -15.5,"quantity": 1,"nonShippable": true}Odpowiedź HTTPS
Pomyślna odpowiedź HTTP
Format wiadomości: JSON
{"tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"}Definicje JSON odpowiedzi
tempCartUUIDstringpodczas przekierowania przeglądarki użytkownika do Zonos Checkout.Odpowiedzi błędów HTTP
HTTP ERROR 422
Problem accessing /v2/createTempCart. Reason:The request entity had the following errors:
Przekierowanie do Zonos Checkout
Po otrzymaniu pomyślnej odpowiedzi zawierającej
tempCartUUID, serwer wyśle przekierowanie z przeglądarki klienta do Zonos Checkout z odpowiednimi parametrami ciągu zapytania adresu URL omówionymi poniżej.Parametry żądania adresu URL
tempCartUUIDREQUIRED
createTempCart.string / GUIDcountrycountrywstępnie wybierze kraj docelowy wewnątrz Zonos Checkout. Korzystając z Zonos Hello JS (JavaScript) na stronie, można uzyskać tę wartość, wywołując metodę JavaScript:zonos.country().string(Długość: 2)Dodatkowe typy danych ciągów
customerNamecustomerCompanycustomerEmailcustomerPhonecustomerAltPhonecustomerAddress1customerAddress2customerCitycustomerStatecustomerZipWas this page helpful?