Giv kunder mulighed for at oprette Zonos-forsendelser og labels fra din platform.
Denne guide er beregnet til udviklere af forsendelsesplatforme, der vil integrere Zonos-forsendelsesoprettelse i deres platform til deres kunder. Hvis du allerede bruger Zonos API og blot skal oprette forsendelser til eksisterende ordrer, se vores guide til forsendelsesoprettelse.
Hvis du er en forsendelsesplatform, der understøtter Zonos-kunder, der sender internationalt, bør integration med Zonos til forsendelsesoprettelse være en topprioritet. Det giver dig mulighed for at tilbyde den mest problemfri oplevelse for dine forhandlere og deres kunder ved at udnytte din platforms eksisterende funktioner, mens Zonos håndterer oprettelse af forsendelse, label og understøttende tolddokumentation.
Fordele ved at bruge Zonos til at oprette forsendelser omfatter:
Third-party-fakturering af told og skatter — Vi sikrer, at dit eller din forhandlers carrier-kontonummer bruges til forsendelsesomkostninger, mens regninger for told og skat går til Zonos.
Fleksibilitet — I stedet for at udføre udviklingsarbejde for at sikre, at du kan generere compliant labels med din platform, integrer med vores API og overlade den konstant skiftende grænseoverskridende compliance til os.
Præcis tolddokumentation — Når du bruger Zonos til at generere labels, sikrer vi, at de rigtige detaljer sendes til carrieren, så pakken hurtigt kommer igennem tolden.
Denne guide gennemgår trinene til at implementere en komplet end-to-end-integration, der giver dig mulighed for at kalde Zonos til forsendelser fra din platform.
Følg trinene nedenfor for at give dine kunder mulighed for at hente Zonos-labels fra din platform.
1
Tillad API-legitimationsoplysninger
Zonos API er tilgængelig via en credentialToken. Din platform skal give kunder mulighed for at indtaste deres credentialToken fra Zonos Dashboard i din platform. Derefter kan du foretage anmodninger til Zonos på deres vegne.
2
Opret en forsendelse
For at hente en label skal du oprette en shipment, som labelen knyttes til. Zonos administrerer denne proces med et workflow, der opretter shipments og labels i samme anmodning. Når du udfører denne mutation, behøver du ikke at sende et serviceLevel, da vi bruger det serviceLevel, der blev brugt fra landedCost, som er knyttet til order. For orderId kan du bruge Zonos ordre-ID'et eller accountOrderNumber, som sandsynligvis allerede findes i dit system.
Når en forsendelse og labels oprettes, returnerer vi labels som et labelImage, som er et BASE64_ENCODED_IMAGE, eller som en url, hvorfra labelen kan hentes.
Brug dette workflow, når du opretter en forsendelse til en eksisterende ordre og ikke behøver at ændre vare- eller partidetaljer. Det understøtter valgfrie sporingsnumre, fulfillment centers, valg af service level og declared value-forsikring.
Shopify-forhandlere
Shopify sender en null-værdi for person i origin-partiet. Som resultat vil orderId alene ikke fungere for Shopify-forhandlere — brug fanen Avanceret forsendelsesoprettelse i stedet, og angiv fulde partidetaljer inklusive person.
Med fulfillment center: Tilføj "fulfillmentCenter": "fulfillment_center_12345" for at angive oprindelseslokationen
Med brugerdefineret sporing: Sæt "generateLabel": false og tilføj "trackingNumbers": ["tracking_1", "tracking_2"]
Med service level: Tilføj "serviceLevel": "dhl.express_example" for at vælge en specifik carrier-service
Med declared value-forsikring: Tilføj "isDeclaredValue": true for at aktivere declared value-dækning
Med special services: Se guiden til special services for batterier, tøris, farligt gods og signaturmuligheder.
Declared value
Sæt "isDeclaredValue": true for at aktivere declared value-dækning for alle varer i din forsendelse. Zonos gør automatisk krav på den fulde værdi af alle varer indsendt i ordren; forhandlere kan ikke ændre dette beløb. Dette angiver det maksimale ansvar, som carrieren accepterer i tilfælde af tab, skade eller tyveri under transport. Denne funktion understøttes kun for UPS-, FedEx- og DHL-forsendelser. Zonos håndterer automatisk carrier-specifik implementering, når du aktiverer declared value, herunder de relevante parametre i vores API-kald til disse carriers, så du ikke behøver at administrere forskellige carrier-krav.
UPS-begrænsninger: UPS dækker kun værdier mellem 100-50.000 USD og behandler declared value på carton-niveau. For forsendelser med flere cartons skal forhandlere opdele forsendelsen for at angive dækning pr. carton. UPS genererer også en ekstra forsikringsformular, der skal printes sammen med labels.
FedEx og DHL: Behandler declared value på forsendelsesniveau uden yderligere begrænsninger.
Special services
Brug specialServices på en carton for at angive særlige håndteringskrav for batterier, tøris, farligt gods eller signaturkrav. Se guiden til special services for fulde detaljer og eksempler.
ShipStation UPS Unlock: Forsendelser med flere pakker understøttes ikke. Når en ordre sendes i flere kasser, duplikeres referencefeltet, hvilket får ordrenummermatchning til at fejle på backend. Forhandlere, der har brug for forsendelser med flere pakker, bør oprette labelen i Zonos Dashboard i stedet. Enkeltkasse-forsendelser påvirkes ikke.
3
Annuller en forsendelse
Hvis en kunde vil annullere en shipment, kan du bruge følgende mutation, som annullerer alle labels, der er knyttet til shipmenten.
Platformintegration af forsendelser
Opret forsendelser fra din platform
Giv kunder mulighed for at oprette Zonos-forsendelser og labels fra din platform.
Denne guide er beregnet til udviklere af forsendelsesplatforme, der vil integrere Zonos-forsendelsesoprettelse i deres platform til deres kunder. Hvis du allerede bruger Zonos API og blot skal oprette forsendelser til eksisterende ordrer, se vores guide til forsendelsesoprettelse.
Hvis du er en forsendelsesplatform, der understøtter Zonos-kunder, der sender internationalt, bør integration med Zonos til forsendelsesoprettelse være en topprioritet. Det giver dig mulighed for at tilbyde den mest problemfri oplevelse for dine forhandlere og deres kunder ved at udnytte din platforms eksisterende funktioner, mens Zonos håndterer oprettelse af forsendelse, label og understøttende tolddokumentation.
Fordele ved at bruge Zonos til at oprette forsendelser omfatter:
Denne guide gennemgår trinene til at implementere en komplet end-to-end-integration, der giver dig mulighed for at kalde Zonos til forsendelser fra din platform.
Aktiver labeludskrivning
Følg trinene nedenfor for at give dine kunder mulighed for at hente Zonos-labels fra din platform.
Tillad API-legitimationsoplysninger
Zonos API er tilgængelig via en
credentialToken. Din platform skal give kunder mulighed for at indtaste derescredentialTokenfra Zonos Dashboard i din platform. Derefter kan du foretage anmodninger til Zonos på deres vegne.Opret en forsendelse
For at hente en
labelskal du oprette enshipment, somlabelen knyttes til. Zonos administrerer denne proces med et workflow, der oprettershipmentsoglabelsi samme anmodning. Når du udfører denne mutation, behøver du ikke at sende etserviceLevel, da vi bruger detserviceLevel, der blev brugt fralandedCost, som er knyttet tilorder. FororderIdkan du bruge Zonos ordre-ID'et elleraccountOrderNumber, som sandsynligvis allerede findes i dit system.Når en forsendelse og labels oprettes, returnerer vi labels som et
labelImage, som er etBASE64_ENCODED_IMAGE, eller som enurl, hvorfra labelen kan hentes.Brug dette workflow, når du opretter en forsendelse til en eksisterende ordre og ikke behøver at ændre vare- eller partidetaljer. Det understøtter valgfrie sporingsnumre, fulfillment centers, valg af service level og declared value-forsikring.
Shopify sender en null-værdi for
personi origin-partiet. Som resultat vilorderIdalene ikke fungere for Shopify-forhandlere — brug fanen Avanceret forsendelsesoprettelse i stedet, og angiv fulde partidetaljer inklusiveperson.mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustrackingDetails {number}serviceLevel {idnamecarrier {idname}}shipmentCartons {idcarton {idwidthlengthheightweightitems {item {idamountdescriptionlabelurltrackingNumberiddocumentFilingVariabelmuligheder:
"fulfillmentCenter": "fulfillment_center_12345"for at angive oprindelseslokationen"generateLabel": falseog tilføj"trackingNumbers": ["tracking_1", "tracking_2"]"serviceLevel": "dhl.express_example"for at vælge en specifik carrier-service"isDeclaredValue": truefor at aktivere declared value-dækningDeclared value
Sæt
"isDeclaredValue": truefor at aktivere declared value-dækning for alle varer i din forsendelse. Zonos gør automatisk krav på den fulde værdi af alle varer indsendt i ordren; forhandlere kan ikke ændre dette beløb. Dette angiver det maksimale ansvar, som carrieren accepterer i tilfælde af tab, skade eller tyveri under transport. Denne funktion understøttes kun for UPS-, FedEx- og DHL-forsendelser. Zonos håndterer automatisk carrier-specifik implementering, når du aktiverer declared value, herunder de relevante parametre i vores API-kald til disse carriers, så du ikke behøver at administrere forskellige carrier-krav.UPS-begrænsninger: UPS dækker kun værdier mellem 100-50.000 USD og behandler declared value på carton-niveau. For forsendelser med flere cartons skal forhandlere opdele forsendelsen for at angive dækning pr. carton. UPS genererer også en ekstra forsikringsformular, der skal printes sammen med labels.
FedEx og DHL: Behandler declared value på forsendelsesniveau uden yderligere begrænsninger.
Special services
Brug
specialServicespå en carton for at angive særlige håndteringskrav for batterier, tøris, farligt gods eller signaturkrav. Se guiden til special services for fulde detaljer og eksempler.ShipStation UPS Unlock: Forsendelser med flere pakker understøttes ikke. Når en ordre sendes i flere kasser, duplikeres referencefeltet, hvilket får ordrenummermatchning til at fejle på backend. Forhandlere, der har brug for forsendelser med flere pakker, bør oprette labelen i Zonos Dashboard i stedet. Enkeltkasse-forsendelser påvirkes ikke.
Annuller en forsendelse
Hvis en kunde vil annullere en
shipment, kan du bruge følgende mutation, som annullerer allelabels, der er knyttet tilshipmenten.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 side nyttig?