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 inn credentialToken fra 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 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.
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) { shipmentCreateWorkflow(input: $input) { id status trackingDetails { number } serviceLevel { id name carrier { id name } } shipmentCartons { id carton { id width length height weight items { item id amount description label url trackingNumber id documentFilingVariabelalternativer:
- Med oppfyllelsessenter: Legg til
"fulfillmentCenter": "fulfillment_center_12345"for å spesifisere opphavslokasjon - Med tilpasset sporing: Sett
"generateLabel": falseog 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": truefor å 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.
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.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
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.