Kenmerken
JSON-sleutel/waarde-paren in de hoofdtekst van het verzoek
POST https://api.iglobalstores.com/v1/createTempCart
| field↕ | notes↕ |
|---|---|
boxCount | Example value: 22x15x15(1),8x8x4(2),32x22x14(1) Format: Comma-separated list of box dimensions and count. In the example above, there are a total of 4 boxes. The first box in the list will be 22 inches long, by 15 inches wide, by 15 inches high. There will only be one box used for that size. There will be two boxes of size: 8x8x4 inches. It is acceptable to pass the same box dimension multiple times if that is easy for you, like this: “22x15x15(1),22x15x15(1)”, which means 2 boxes of size: 22x15x15 inches.This field describes the boxes that will be used to ship the order. It is not expected that a merchant knows this at time of order; however, if it is known, it may be passed in the string format. |
contShoppingURL | Dit veld wordt gebruikt om een URL door te geven om de HREF van de knop “Verder winkelen” in de Zonos Checkout te overschrijven. string |
domesticShippingCharge | Dit veld wordt gebruikt om binnenlandse verzendkosten door te geven aan Zonos Checkout, en het bedrag wordt toegevoegd aan de verzendkosten. Dit kan worden geconfigureerd om het verzendtotaal toe te voegen of te worden opgesplitst als een afzonderlijk regelitem. positive floating point, two decimal places |
externalConfirmationPageURL | Dit veld wordt gebruikt om een URL van uw orderbevestiging/bedankpagina door te geven. Nadat een klant de betaling binnen Zonos Checkout heeft voltooid, wordt hij of zij doorgestuurd naar deze URL voor orderbevestiging. Deze URL wordt vaak gebruikt om een aanroep naar het Zonos “orderDetail” API-service-eindpunt te activeren om de orderdetails op te halen en de bestelling in het systeem te importeren. string |
footerHTML | Dit veld wordt gebruikt om een URL-gecodeerde HTML-tekenreeks door te geven. Deze HTML-string wordt gedecodeerd en vóór de afsluitende body-tag op de afrekenpagina geplaatst. Vaak gebruikt om code door te geven voor remarketing, analyses, enz. URL encoded string |
items REQUIRED | Dit veld bevat een lijst met itemkaarten. JSON string |
items[index].countryOfOrigin | Dit veld wordt gebruikt om het land van herkomst van het artikel door te geven. Parameter moet het land two-letter ISO code zijn. string |
items[index].description REQUIRED | Dit veld wordt gebruikt om een volledige artikelbeschrijving van het winkelwagenregelitem door te geven, inclusief eventuele itemopties, kleuren, enz. string |
items[index].height | Dit veld wordt gebruikt om de artikelhoogte door te geven en wordt ten zeerste aanbevolen voor nauwkeurige verzendoffertes. Hoogte-eenheden zijn REQUIRED string - positive floating point, two decimal places / integer (inches) |
items[index].imageURL REQUIRED | Dit veld wordt gebruikt om de URL naar de productafbeelding van het artikel door te geven. De URL moet HTTPS zijn om binnen Zonos Checkout te kunnen worden weergegeven. string / HTTPS URL |
items[index]itemBrand | Dit veld wordt gebruikt om het artikelmerkstring door te geven |
items[index]itemCategory | This field is used to pass the item category and may be passed pipe delimited if the item has more than one category. Example values: “shoes” or “shoes|sportschoenen|kortingsschoenen” string |
items[index]itemCustomization | Dit veld wordt gebruikt om aanvullende details over het item door te geven die niet worden weergegeven in de Zonos Checkout; Dit kan echter worden opgehaald via het “orderDetail” API-service-eindpunt. |
items[index]itemHSCode | This field is used to pass the item HS code and may be with or without periods. Example values: “3926901000” or “3926.90.1000” string |
items[index].itemURL | Dit veld wordt gebruikt om de URL naar de artikelproductpagina door te geven. string / URL |
items[index].length | Dit veld wordt gebruikt om de artikellengte door te geven en wordt ten zeerste aanbevolen voor nauwkeurige verzendoffertes. Lengte-eenheden zijn REQUIRED string - positive floating point, two decimal places / integer (inches) |
items[index].nonShippable | Dit veld wordt gebruikt om aan te geven of het artikel moet worden meegenomen in de berekeningen voor verzending, invoerrechten en belasting. Digitale downloads, kortingscodes, administratiekosten, etc. moeten worden doorgegeven met de waarde “true”. boolean: true or false |
items[index].productId | Dit veld wordt gebruikt om de hoeveelheid van het regelitem door te geven. string |
items[index].quantity REQUIRED | Dit veld wordt gebruikt om de hoeveelheid van het regelitem door te geven. string |
items[index].sku | Dit veld wordt gebruikt om het artikel SKU / UPC / etc. door te geven. string |
items[index].unitPrice REQUIRED | Dit veld wordt gebruikt om de eenheidsprijs van het regelitem door te geven. positive floating point, two decimal places / integer |
items[index].weight | Dit veld wordt gebruikt om het gewicht van het artikel door te geven en wordt ten zeerste aanbevolen voor nauwkeurige verzendoffertes. Gewichtseenheden zijn standaard ingesteld op “LBS”, tenzij een andere gewichtseenheid wordt doorgegeven in items[index].itemWeightUnits``string - positive floating point, two decimal places / integer |
items[index].weightUnits | Dit veld wordt gebruikt om de standaardgewichtseenheden van artikelen te overschrijven. De gewichtseenheden van artikelen zijn standaard ingesteld op “LBS”, tenzij in dit veld een andere gewichtseenheid wordt opgegeven. string - "LB", "OZ", "KG", or "G” |
items[index].width | Dit veld wordt gebruikt om de artikelbreedte door te geven en wordt ten zeerste aanbevolen voor nauwkeurige verzendoffertes. Breedte-eenheden zijn REQUIRED string - positive floating point, two decimal places / integer (inches) |
misc1 - misc6 | Dit veld wordt gebruikt om diverse gegevens die aan de bestelling zijn gekoppeld door te geven via de Zonos API, zodat deze kunnen worden opgehaald samen met de bestelgegevens die worden geretourneerd door het Zonos “orderDetail” API-service-eindpunt. string |
referenceId | Dit veld wordt gebruikt om een unieke referentie-identificatiewaarde door te geven voor de winkelwagen/sessie/etc. in uw systeem. Dit kan worden gebruikt om de Zonos bestel-ID op te zoeken via het Zonos “orderDetail” API-service-eindpunt. string |
storeId REQUIRED | Winkel-ID verstrekt door Zonos. integer |
Extra typen stringgegevens
items[index].itemDescriptionLongitems[index].itemDescriptionDetaileditems[index].itemFabricContentitems[index].itemColoritems[index].itemLtlClassitems[index].statusitems[index].itemMaterial
Kortingen, kortingsbonnen en promotiecodes
Om kortingen, kortingsbonnen en promotiecodes via de serverpost naar Zonos te sturen, moeten ze als afzonderlijk item worden doorgegeven met een negatieve waarde voor parameters: “unitPrice” en “nonShippable”:true.
1
{2
"description": "Discount (10OFF) - 10% OFF",3
"unitPrice": -15.5,4
"quantity": 1,5
"nonShippable": true6
}HTTPS-antwoord
Succesvolle HTTP-reactie
Berichtformaat: JSON
1
{2
"tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"3
}Antwoord-JSON-definities
| field↕ | notes↕ |
|---|---|
tempCartUUID | Deze parameter bevat een GUID die is toegewezen aan de internationale winkelwagen van uw klant en is aangemaakt in het Zonos-systeem. Dit bestand wordt doorgegeven via een URL-query string parameter terwijl de browser van de gebruiker wordt omgeleid naar Zonos Checkout. |
Fout HTTP-reacties
| Error code↕ | meaning↕ |
|---|---|
| 400 | Onverwacht teken in de hoofdtekst van het verzoek. |
| 406 | Niet acceptabel. HTTP-header voor 'Accepteren' is ongeldig. |
| 415 | Niet-ondersteund mediatype. HTTP-header voor 'Content-Type' is ongeldig. |
| 422 | Onverwerkbare entiteit. |
| 500 | 'storeId' was onjuist of de JSON-hoofdtekst kon niet worden geparseerd. |
1
2
3
4
5
6
7
Fout 422 Onverwerkbare entiteit 8
9
10
11
12
13
HTTP-FOUT 422
14
15
16
Probleem met toegang tot /v2/createTempCart. Reden:17
Onverwerkbare entiteit
18
19
20
21
De aanvragentiteit had de volgende fouten:
22
23
24
25
items mogen niet leeg zijn (was nul) 26
27
items mogen niet nul zijn (was nul) 28
29
30
31
32
33
Omleiden naar de Zonos Checkout
Na ontvangst van een succesvol antwoord met de tempCartUUID, stuurt uw server een omleiding van de browser van de klant naar de Zonos Checkout met de juiste URL-querystringparameters die hieronder worden beschreven.
Voorbeeld omleidings-URL: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA
Opmerking: [uw toegewezen subdomein] - Neem contact op met uw Zonos implementatieteamlid om uw Zonos.com-subdomein te ontvangen.
URL-verzoekparameters
| field↕ | notes↕ |
|---|---|
tempCartUUID REQUIRED | Deze waarde wordt verkregen door het API-service-eindpunt Zonos createTempCart aan te roepen. string / GUID |
country | two-letter ISO code van het land van bestemming. We raden u ten zeerste aan deze parameter door te geven voor gebruikerservaring. De parameter country selecteert vooraf het land van bestemming binnen Zonos Checkout. Wanneer u de Zonos Hello JS (JavaScript) op de site gebruikt, kunt u deze waarde verkrijgen door de JavaScript-methode aan te roepen: zonos.country(). string (Lengte: 2) |
Extra typen stringgegevens
customerNamecustomerCompanycustomerEmailcustomerPhonecustomerAltPhonecustomerAddress1customerAddress2customerCitycustomerStatecustomerZip
Maak een kassa
Ontdek de sleutel/waarde-paren die betrokken zijn bij het maken van een kassa.Dit API-eindpunt wordt gebruikt om winkelwageninformatie en artikelen uit de winkelwagen van de klant naar de Zonos API te sturen.
U ontvangt een JSON-antwoord met daarin een
tempCartUUID, een unieke winkelwagen-ID in het Zonos-systeem. Dit wordt gebruikt om de klant door te sturen naar Zonos Checkout om de bestelling af te ronden.