Gi kundene dine evnen til å opprette Zonos forsendelser og etiketter fra plattformen din.
Denne guiden er designet for utviklere av leveringsplattformer som ønsker å integrere Zonos forsendelsesopprettelsesfunksjoner inn i plattformen sin for kundene sine. Hvis du allerede bruker Zonos API og bare trenger å opprette forsendelser for eksisterende ordrer, se vår guide for forsendelsesoppretting.
Hvis du er en leveringsplattform som støtter Zonos-kunder som sender internasjonalt, bør integrering med Zonos for forsendelsesoppretting være en toppprioritet. Dette vil tillate deg å tilby den mest sømløse opplevelsen for dine kjøpmenn og deres kunder ved å utnytte plattformens eksisterende funksjoner samtidig som du lar Zonos håndtere opprettelsen av forsendelsen, etiketten og støttende tollsdokumentasjon.
Fordeler ved å bruke Zonos til å opprette forsendelser inkluderer:
Fakturering av toll og skatt fra tredjeparter - Vi sikrer at ditt eller kjøpmannens transportørkonto blir brukt for fraktavgifter mens regningene for toll og skatt kommer til Zonos.
Fleksibilitet - I stedet for å utføre utviklingsarbeid for å sikre at du kan generere samsvarsmerkede etiketter med plattformen din, integrer med vår API og la det stadig skiftende grenseoverskridende regelverket være Zonos' ansvar.
Nøyaktig tollsdokumentasjon - Når du bruker Zonos til å generere etiketter, sikrer vi at riktige detaljer blir sendt til transportøren for å sikre at pakken raskt kommer gjennom tollbehandlingen.
Denne guiden vil lede deg gjennom trinnene for å implementere en komplett end-to-end-integrasjon som vil tillate deg å kalle Zonos for forsendelser fra plattformen din.
Følg trinnene nedenfor for å tillate kundene dine å hente Zonos-etiketter fra plattformen din.
1
Tillat API-legitimasjon
Zonos API er tilgjengelig via en credentialToken. Plattformen din må gi kundene evnen til å skrive inn credentialToken fra Zonos Dashboard inn i plattformen din. Herfra vil du kunne foreta forespørsler til Zonos på deres vegne.
2
Opprett en forsendelse
For å hente en label, er du pålagt å opprette en shipment som label vil være tilknyttet. Zonos administrerer denne prosessen med en arbeidsflyt som oppretter shipments og labels i samme forespørsel. Når du utfører denne mutasjonen, trenger du ikke å overføre en serviceLevel da vi vil bruke serviceLevel brukt fra landedCost som er knyttet til order. For orderId kan du bruke Zonos ordre-ID eller accountOrderNumber som sannsynligvis allerede er i systemet ditt.
Når en forsendelse og etiketter opprettes, returnerer vi etiketter som en labelImage som er en BASE64_ENCODED_IMAGE, eller som en url hvor etiketten kan hentes fra.
Bruk denne arbeidsflyten når du oppretter en forsendelse for en eksisterende ordre og ikke trenger å endre detaljer om varer eller parter. Det støtter valgfrie sporingsnumre, oppfyllelsessentre, servicenivåvalg og deklarert verdiforsikring.
Shopify-selgere
Shopify passerer en nullverdi for person i opphavspartiet. Som et resultat vil orderId alene ikke fungere for Shopify-kjøpmenn — bruk Avansert forsendelsesoppretting-fanen i stedet og gi komplette partidetaljer, inkludert person.
Med oppfyllelsessenter: Legg til "fulfillmentCenter": "fulfillment_center_12345" for å spesifisere opphavslokasjon
Med tilpasset sporing: Sett "generateLabel": false og legg til "trackingNumbers": ["tracking_1", "tracking_2"]
Med servicenivå: Legg til "serviceLevel": "dhl.express_example" for å velge en spesifikk transportørtjeneste
Med deklarert verdiforsikring: Legg til "isDeclaredValue": true for å aktivere deklarert verdidekning
Med spesielle tjenester: Se guiden for spesielle tjenester for batterier, tørris, farlige varer og signaturalternativer.
Deklarert verdi
Sett "isDeclaredValue": true for å aktivere deklarert verdidekning for alle varer i forsendelsen din. Zonos krever automatisk hele verdien av alle varer som sendes inn i ordren; kjøpmenn kan ikke endre dette beløpet. Dette setter den maksimale ansvaret transportøren vil akseptere i tilfelle tap, skade eller tyveri under transit. Denne funksjonen støttes bare for UPS-, FedEx- og DHL-forsendelser. Zonos håndterer automatisk transportørspesifikk implementering når du aktiverer deklarert verdi, inkludert de riktige parametrene i våre API-kall til disse transportørene, slik at du ikke trenger å administrere ulike transportørkrav.
UPS-begrensninger: UPS dekker bare verdier mellom 100-50 000 USD og behandler deklarert verdi på kartongnivå. For forsendelser med flere kartonger må kjøpmenn dele forsendelsen for å utpeke dekning per kartong. UPS genererer også et tilleggsforsikringsskjema som må skrives ut med etikettene.
FedEx og DHL: Behandler deklarert verdi på forsendelsesnivå uten ytterligere begrensninger.
Spesielle tjenester
Bruk specialServices på en kartong for å indikere spesielle håndteringskrav for batterier, tørris, farlige varer eller signaturkrav. Se guiden for spesielle tjenester for fullstendige detaljer og eksempler.
ShipStation UPS Unlock: Multipiece-forsendelser støttes ikke. Når en ordre sendes i flere bokser, dupliseres referansefeltet, noe som forårsaker at ordrenummerkjøring mislykkes på serveren. Kjøpmenn som trenger multipiece-forsendelser bør opprette etiketten i Zonos Dashboard i stedet. Forsendelser med én boks påvirkes ikke.
3
Annuller en forsendelse
I tilfelle en kunde ønsker å annullere en shipment, kan du bruke følgende mutasjon som vil annullere alle labels knyttet til shipment.
Plattformintegrasjon for forsendelser
Opprett forsendelser fra plattformen din
Gi kundene dine evnen til å opprette Zonos forsendelser og etiketter fra plattformen din.
Denne guiden er designet for utviklere av leveringsplattformer som ønsker å integrere Zonos forsendelsesopprettelsesfunksjoner inn i plattformen sin for kundene sine. Hvis du allerede bruker Zonos API og bare trenger å opprette forsendelser for eksisterende ordrer, se vår guide for forsendelsesoppretting.
Hvis du er en leveringsplattform som støtter Zonos-kunder som sender internasjonalt, bør integrering med Zonos for forsendelsesoppretting være en toppprioritet. Dette vil tillate deg å tilby den mest sømløse opplevelsen for dine kjøpmenn og deres kunder ved å utnytte plattformens eksisterende funksjoner samtidig som du lar Zonos håndtere opprettelsen av forsendelsen, etiketten og støttende tollsdokumentasjon.
Fordeler ved å bruke Zonos til å opprette forsendelser inkluderer:
Denne guiden vil lede deg gjennom trinnene for å implementere en komplett end-to-end-integrasjon som vil tillate deg å kalle Zonos for forsendelser fra plattformen din.
Aktiver etikettkopi
Følg trinnene nedenfor for å tillate kundene dine å hente Zonos-etiketter fra plattformen din.
Tillat API-legitimasjon
Zonos API er tilgjengelig via en
credentialToken. Plattformen din må gi kundene evnen til å skrive inncredentialTokenfra Zonos Dashboard inn i plattformen din. Herfra vil du kunne foreta forespørsler til Zonos på deres vegne.Opprett en forsendelse
For å hente en
label, er du pålagt å opprette enshipmentsomlabelvil være tilknyttet. Zonos administrerer denne prosessen med en arbeidsflyt som opprettershipmentsoglabelsi samme forespørsel. Når du utfører denne mutasjonen, trenger du ikke å overføre enserviceLevelda vi vil brukeserviceLevelbrukt fralandedCostsom er knyttet tilorder. FororderIdkan du bruke Zonos ordre-ID elleraccountOrderNumbersom sannsynligvis allerede er i systemet ditt.Når en forsendelse og etiketter opprettes, returnerer vi etiketter som en
labelImagesom er enBASE64_ENCODED_IMAGE, eller som enurlhvor etiketten kan hentes fra.Bruk denne arbeidsflyten når du oppretter en forsendelse for en eksisterende ordre og ikke trenger å endre detaljer om varer eller parter. Det støtter valgfrie sporingsnumre, oppfyllelsessentre, servicenivåvalg og deklarert verdiforsikring.
Shopify passerer en nullverdi for
personi opphavspartiet. Som et resultat vilorderIdalene ikke fungere for Shopify-kjøpmenn — bruk Avansert forsendelsesoppretting-fanen i stedet og gi komplette partidetaljer, inkludertperson.mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustrackingDetails {number}serviceLevel {idnamecarrier {idname}}shipmentCartons {idcarton {idwidthlengthheightweightitems {itemidamountdescriptionlabelurltrackingNumberiddocumentFilingVariabelalternativer:
"fulfillmentCenter": "fulfillment_center_12345"for å spesifisere opphavslokasjon"generateLabel": falseog legg til"trackingNumbers": ["tracking_1", "tracking_2"]"serviceLevel": "dhl.express_example"for å velge en spesifikk transportørtjeneste"isDeclaredValue": truefor å aktivere deklarert verdidekningDeklarert verdi
Sett
"isDeclaredValue": truefor å aktivere deklarert verdidekning for alle varer i forsendelsen din. Zonos krever automatisk hele verdien av alle varer som sendes inn i ordren; kjøpmenn kan ikke endre dette beløpet. Dette setter den maksimale ansvaret transportøren vil akseptere i tilfelle tap, skade eller tyveri under transit. Denne funksjonen støttes bare for UPS-, FedEx- og DHL-forsendelser. Zonos håndterer automatisk transportørspesifikk implementering når du aktiverer deklarert verdi, inkludert de riktige parametrene i våre API-kall til disse transportørene, slik at du ikke trenger å administrere ulike transportørkrav.UPS-begrensninger: UPS dekker bare verdier mellom 100-50 000 USD og behandler deklarert verdi på kartongnivå. For forsendelser med flere kartonger må kjøpmenn dele forsendelsen for å utpeke dekning per kartong. UPS genererer også et tilleggsforsikringsskjema som må skrives ut med etikettene.
FedEx og DHL: Behandler deklarert verdi på forsendelsesnivå uten ytterligere begrensninger.
Spesielle tjenester
Bruk
specialServicespå en kartong for å indikere spesielle håndteringskrav for batterier, tørris, farlige varer eller signaturkrav. Se guiden for spesielle tjenester for fullstendige detaljer og eksempler.ShipStation UPS Unlock: Multipiece-forsendelser støttes ikke. Når en ordre sendes i flere bokser, dupliseres referansefeltet, noe som forårsaker at ordrenummerkjøring mislykkes på serveren. Kjøpmenn som trenger multipiece-forsendelser bør opprette etiketten i Zonos Dashboard i stedet. Forsendelser med én boks påvirkes ikke.
Annuller en forsendelse
I tilfelle en kunde ønsker å annullere en
shipment, kan du bruke følgende mutasjon som vil annullere allelabelsknyttet tilshipment.mutation {shipmentStatusUpdate(input: {shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"status: VOIDEDnote: "Voiding shipment"}) {idstatus}}CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput
cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate
Var denne siden nyttig?