Hva er `tempCartUUID`?

Denne parameteren vil inneholde en GUID som er tildelt kundens internasjonale handlekurv og opprettet i Zonos-systemet. Dette feltet vil bli sendt via en URL-spørring `string` parameter mens du omdirigerer brukerens nettleser til Zonos Checkout.

Hva er URL-forespørselsparametrene?

`tempCartUUID` er en obligatorisk verdi som oppnås ved å kalle Zonos `createTempCart` API-tjenesteendepunkt. `country` er destinasjonslandets to-bokstavs ISO-kode. Vi anbefaler sterkt å sende denne parameteren for brukeropplevelse. Parameteren `country` vil forhåndsvelge destinasjonslandet inne i Zonos Checkout.

Checkout•

HjemAPI-referanse Checkout REST API Opprett en checkout

Opprett en checkout

Q: Hvordan omdirigerer man til Zonos Checkout?

Etter å ha mottatt et vellykket svar som inneholder `tempCartUUID`, vil serveren din sende en omdirigering fra kundens nettleser til Zonos Checkout med de aktuelle URL-spørringsstrengparametrene.

Utforsk nøkkel/verdi-parene som er involvert i opprettelsen av en checkout.

Dette API-endepunktet brukes til å sende handlekurvopplysninger og varer fra kundens handlekurv til Zonos API.

Du vil motta et JSON-svar som inneholder en tempCartUUID, en unik handlekurvidentifikator i Zonos-systemet. Dette vil bli brukt til å omdirigere kunden til Zonos Checkout for å fullføre bestillingen.

Attributter

JSON nøkkel/verdi-par i forespørselsteksten

POST https://api.iglobalstores.com/v1/createTempCart

felt↕	notater↕
`boxCount`	Eksempelverdi: 22x15x15(1),8x8x4(2),32x22x14(1) Format: Kommaseparert liste over boksdimensjoner og antall. I eksemplet ovenfor er det totalt 4 bokser. Den første boksen i listen vil være 22 tommer lang, 15 tommer bred og 15 tommer høy. Det vil være bare en boks brukt for den størrelsen. Det vil være to bokser på størrelse: 8x8x4 tommer. Det er akseptabelt å sende samme boksdimensjon flere ganger hvis det er enkelt for deg, slik: "22x15x15(1),22x15x15(1)", som betyr 2 bokser på størrelse: 22x15x15 tommer. Dette feltet beskriver boksene som vil bli brukt til å sende bestillingen. Det forventes ikke at en selger vet dette på bestillingstidspunktet; men hvis det er kjent, kan det sendes i `string` format.
`contShoppingURL`	Dette feltet brukes til å sende en URL for å overstyre HREF for "Fortsett shopping"-knappen inne i Zonos Checkout. `string`
`domesticShippingCharge`	Dette feltet brukes til å sende en innenlandsk fraktavgift til Zonos Checkout, og beløpet vil bli lagt til frakten. Dette kan konfigureres til å legges til i fraktens totalbeløp, eller vises som et eget linjeelement. `positivt flyttall, to desimalplasser`
`externalConfirmationPageURL`	Dette feltet brukes til å sende en URL for din bestillingsbekreftelse / takk-siden. Etter at en kunde har fullført betaling inne i Zonos Checkout, vil de bli omdirigert til denne URL-en for bestillingsbekreftelse. Denne URL-en brukes ofte til å utløse et kall til Zonos "orderDetail" API-tjenesteendepunkt for å hente bestillingsdetaljer og importere bestillingen til systemet. `string`
`footerHTML`	Dette feltet brukes til å sende en URL-kodet HTML-streng. Denne HTML-strengen vil bli dekodert og plassert før den avsluttende body-taggen på checkout-siden. Brukes ofte til å sende kode for re-marketing, analyse osv. `URL kodet streng`
`items` REQUIRED	Dette feltet er en liste over elementkart. `JSON string`
`items[index].countryOfOrigin`	Dette feltet brukes til å sende varens opprinnelsesland. Parameter må være landet to-bokstavs ISO-kode. `string`
`items[index].description` REQUIRED	Dette feltet brukes til å sende en fullstendig varebeskrivelse av handlekurvlinjeelementet, inkludert alle varealternativ, farger osv. `string`
`items[index].height`	Dette feltet brukes til å sende varehøyden og anbefales sterkt for nøyaktige leveringstilbud. Høydeenheter er REQUIRED i tommer. `string - positivt flyttall, to desimalplasser / heltall (tommer)`
`items[index].imageURL` REQUIRED	Dette feltet brukes til å sende URL-en til vareproduktbildet. URL-en må være HTTPS for å vises inne i Zonos Checkout. `string / HTTPS URL`
`items[index]itemBrand`	Dette feltet brukes til å sende varemerket`string`
`items[index]itemCategory`	Dette feltet brukes til å sende varekategorien og kan sendes med pipe-avgrensning hvis varen har mer enn en kategori. Eksempelverdier: "shoes" eller "shoes\|sport-shoes\|discount-shoes"`string`
`items[index]itemCustomization`	Dette feltet brukes til å sende ytterligere detaljer om varen som ikke vises i Zonos Checkout; dette kan imidlertid hentes gjennom "orderDetail" API-tjenesteendepunkt.
`items[index]itemHSCode`	Dette feltet brukes til å sende varens HS-kode og kan være med eller uten punktum. Eksempelverdier: "3926901000" eller "3926.90.1000"`string`
`items[index].itemURL`	Dette feltet brukes til å sende URL-en til vareproduktsiden. `string / URL`
`items[index].length`	Dette feltet brukes til å sende varelengden og anbefales sterkt for nøyaktige leveringstilbud. Lengdeenheter er REQUIRED i tommer. `string - positivt flyttall, to desimalplasser / heltall (tommer)`
`items[index].nonShippable`	Dette feltet brukes til å indikere om varen skal inkluderes i frakt-, tollsats- og skatteberegningene. Digitale nedlastinger, rabattkoder, håndteringskostnader osv. bør sendes med en verdi på "true". `boolean: true eller false`
`items[index].productId`	Dette feltet brukes til å sende linjeelementantallet. `string`
`items[index].quantity` REQUIRED	Dette feltet brukes til å sende linjeelementantallet. `string`
`items[index].sku`	Dette feltet brukes til å sende varesku / UPC / osv. `string`
`items[index].unitPrice` REQUIRED	Dette feltet brukes til å sende linjeelementenhetsprisen. `positivt flyttall, to desimalplasser / heltall`
`items[index].weight`	Dette feltet brukes til å sende varevekten og anbefales sterkt for nøyaktige leveringstilbud. Vekteenheter er som standard "LBS" hvis ikke en annen vektenhet sendes i items[index].itemWeightUnits``string - positivt flyttall, to desimalplasser / heltall
`items[index].weightUnits`	Dette feltet brukes til å overstyre standardvarevektenhetene. Varevektenhetene er som standard "LBS" hvis ikke en annen vektenhet sendes i dette feltet. `string - "LB", "OZ", "KG", eller "G"`
`items[index].width`	Dette feltet brukes til å sende varebredden og anbefales sterkt for nøyaktige leveringstilbud. Breddeenheter er REQUIRED i tommer. `string - positivt flyttall, to desimalplasser / heltall (tommer)`
`misc1 - misc6`	Dette feltet brukes til å sende diverse data knyttet til bestillingen gjennom Zonos API som skal hentes sammen med bestillingsdataene som returneres fra Zonos "orderDetail" API-tjenesteendepunkt. `string`
`referenceId`	Dette feltet brukes til å sende en unik referanseidentifikasjonsverdi for handlekurven/sesjonen/osv. i systemet ditt. Dette kan brukes til å slå opp Zonos-ordre-ID-en via Zonos "orderDetail" API-tjenesteendepunkt. `string`
`storeId` REQUIRED	Butikk-ID gitt av Zonos. `integer`

Ytterligere strengdatatyper

items[index].itemDescriptionLong
items[index].itemDescriptionDetailed
items[index].itemFabricContent
items[index].itemColor
items[index].itemLtlClass
items[index].status
items[index].itemMaterial

Rabatter, kuponger og promokoder

For å sende rabatter, kuponger og promokoder til Zonos gjennom serverposten, må de sendes som et eget element med en negativ verdi for parametrene: "unitPrice" og "nonShippable":true.

1{

2 "description": "Discount (10OFF) - 10% OFF",

3 "unitPrice": -15.5,

4 "quantity": 1,

5 "nonShippable": true

6}

HTTPS-svar

Vellykket HTTP-svar

Meldingsformat: JSON

1{

2 "tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"

3}

Definisjoner av svar-JSON

felt↕	notater↕
`tempCartUUID`	Denne parameteren vil inneholde en GUID som er tildelt kundens internasjonale handlekurv og opprettet i Zonos-systemet. Dette feltet vil bli sendt via en URL-spørring `string` parameter mens du omdirigerer brukerens nettleser til Zonos Checkout.

Feil HTTP-svar

Feilkode↕	betydning↕
400	Uventet tegn i forespørselsteksten.
406	Ikke akseptabelt. HTTP-header for "Accept" er ugyldig.
415	Medietypen støttes ikke. HTTP-header for "Content-Type" er ugyldig.
422	Ikke behandlingsdyktig enhet.
500	"storeId" var feil eller JSON-kroppen kunne ikke tolkes.

7Error 422 Unprocessable Entity

13HTTP ERROR 422

16 Problem accessing /v2/createTempCart. Reason:

17 Unprocessable Entity

21The request entity had the following errors:

25items may not be empty (was null)

27items may not be null (was null)

Omdirigering til Zonos Checkout

Etter å ha mottatt et vellykket svar som inneholder tempCartUUID, vil serveren din sende en omdirigering fra kundens nettleser til Zonos Checkout med de aktuelle URL-spørringsstrengparametrene som er dekket nedenfor.

Eksempel omdirigering URL: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA

Merk: [yourassignedsubdomain] - Kontakt ditt Zonos-implementeringsteammedlem for å motta ditt Zonos.com-underdomene.

URL-forespørselsparametere

felt↕	notater↕
`tempCartUUID` REQUIRED	Denne verdien oppnås ved å kalle Zonos `createTempCart` API-tjenesteendepunkt. `string / GUID`
`country`	Destinasjonslandets to-bokstavs ISO-kode. Vi anbefaler sterkt å sende denne parameteren for brukeropplevelse. Parameteren `country` vil forhåndsvelge destinasjonslandet inne i Zonos Checkout. Når du bruker Zonos Hello JS (JavaScript) på siden, kan du få denne verdien ved å kalle JavaScript-metoden: `zonos.country()`. `string` (Lengde: 2)

Ytterligere strengdatatyper

customerName
customerCompany
customerEmail
customerPhone
customerAltPhone
customerAddress1
customerAddress2
customerCity
customerState
customerZip

Bestill en demo

Opprett en checkout

Attributter

JSON nøkkel/verdi-par i forespørselsteksten

Ytterligere strengdatatyper

Rabatter, kuponger og promokoder

HTTPS-svar

Definisjoner av svar-JSON

Feil HTTP-svar

HTTP ERROR 422

The request entity had the following errors:

Omdirigering til Zonos Checkout

URL-forespørselsparametere

Ytterligere strengdatatyper

Var denne siden nyttig?