Ontdek de sleutel/waarde-paren die betrokken zijn bij het aanmaken van een checkout.
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.
JSON-sleutel/waarde-paren in de hoofdtekst van het verzoek
POST https://api.iglobalstores.com/v1/createTempCart
field↕
notes↕
boxCount
Voorbeeldwaarde: 22x15x15(1),8x8x4(2),32x22x14(1) Formaat: Kommagescheiden lijst van doosafmetingen en aantal. In het voorbeeld hierboven zijn er in totaal 4 dozen. De eerste doos in de lijst is 22 inch lang, 15 inch breed en 15 inch hoog. Er wordt maar één doos van dat formaat gebruikt. Er zijn twee dozen van het formaat: 8x8x4 inch. Het is toegestaan om dezelfde doosafmeting meerdere keren door te geven als dat voor u makkelijker is, bijvoorbeeld zo: “22x15x15(1),22x15x15(1)”, wat 2 dozen van het formaat 22x15x15 inch betekent. Dit veld beschrijft de dozen die worden gebruikt om de bestelling te verzenden. Er wordt niet verwacht dat een handelaar dit weet op het moment van bestelling; als het echter bekend is, kan het worden doorgegeven in het string-formaat.
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
in inches. 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
Dit veld wordt gebruikt om de itemcategorie door te geven en kan met een verticale streep (pipe) worden gescheiden als het item meer dan één categorie heeft. Voorbeeldwaarden: “shoes” of “shoes|sport-shoes|discount-shoes”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
Dit veld wordt gebruikt om de HS-code van het item door te geven en kan met of zonder punten worden opgegeven. Voorbeeldwaarden: “3926901000” of “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
in inches. 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
in inches. 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
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.
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
7Fout 422 Onverwerkbare entiteit
8
9
10
11
12
13
HTTP-FOUT 422
14
15
16 Probleem met toegang tot /v2/createTempCart. Reden:
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.
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)
Een checkout aanmaken
Een checkout aanmaken
Ontdek de sleutel/waarde-paren die betrokken zijn bij het aanmaken van een checkout.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.Kenmerken
JSON-sleutel/waarde-paren in de hoofdtekst van het verzoek
POST
https://api.iglobalstores.com/v1/createTempCartboxCountFormaat: Kommagescheiden lijst van doosafmetingen en aantal. In het voorbeeld hierboven zijn er in totaal 4 dozen. De eerste doos in de lijst is 22 inch lang, 15 inch breed en 15 inch hoog. Er wordt maar één doos van dat formaat gebruikt. Er zijn twee dozen van het formaat: 8x8x4 inch. Het is toegestaan om dezelfde doosafmeting meerdere keren door te geven als dat voor u makkelijker is, bijvoorbeeld zo: “22x15x15(1),22x15x15(1)”, wat 2 dozen van het formaat 22x15x15 inch betekent. Dit veld beschrijft de dozen die worden gebruikt om de bestelling te verzenden. Er wordt niet verwacht dat een handelaar dit weet op het moment van bestelling; als het echter bekend is, kan het worden doorgegeven in het
string-formaat.contShoppingURLstringdomesticShippingChargepositive floating point, two decimal placesexternalConfirmationPageURLstringfooterHTMLURL encoded stringitemsREQUIRED
JSON stringitems[index].countryOfOriginstringitems[index].descriptionREQUIRED
stringitems[index].heightREQUIRED
string - positive floating point, two decimal places / integer (inches)items[index].imageURLREQUIRED
string / HTTPS URLitems[index]itemBrandstringdoor te gevenitems[index]itemCategoryVoorbeeldwaarden: “shoes” of “shoes|sport-shoes|discount-shoes”
stringitems[index]itemCustomizationitems[index]itemHSCodeVoorbeeldwaarden: “3926901000” of “3926.90.1000”
stringitems[index].itemURLstring / URLitems[index].lengthREQUIRED
string - positive floating point, two decimal places / integer (inches)items[index].nonShippableboolean: true or falseitems[index].productIdstringitems[index].quantityREQUIRED
stringitems[index].skustringitems[index].unitPriceREQUIRED
positive floating point, two decimal places / integeritems[index].weightitems[index].itemWeightUnits``string - positive floating point, two decimal places / integeritems[index].weightUnitsstring - "LB", "OZ", "KG", or "G”items[index].widthREQUIRED
string - positive floating point, two decimal places / integer (inches)misc1 - misc6stringreferenceIdstringstoreIdREQUIRED
integerExtra typen stringgegevens
items[index].itemDescriptionLongitems[index].itemDescriptionDetaileditems[index].itemFabricContentitems[index].itemColoritems[index].itemLtlClassitems[index].statusitems[index].itemMaterialKortingen, 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.{"description": "Discount (10OFF) - 10% OFF","unitPrice": -15.5,"quantity": 1,"nonShippable": true}HTTPS-antwoord
Succesvolle HTTP-reactie
Berichtformaat: JSON
{"tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"}Antwoord-JSON-definities
tempCartUUIDstringparameter terwijl de browser van de gebruiker wordt omgeleid naar Zonos Checkout.Fout HTTP-reacties
HTTP-FOUT 422
Probleem met toegang tot /v2/createTempCart. Reden:De aanvragentiteit had de volgende fouten:
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.URL-verzoekparameters
tempCartUUIDREQUIRED
createTempCartaan te roepen.string / GUIDcountrycountryselecteert 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
customerNamecustomerCompanycustomerEmailcustomerPhonecustomerAltPhonecustomerAddress1customerAddress2customerCitycustomerStatecustomerZipWas deze pagina nuttig?