Ge era kunder möjlighet att skapa Zonos-sändningar och etiketter från er plattform.
Den här guiden är utformad för utvecklare av fraktplattformar som vill integrera Zonos funktioner för att skapa sändningar i sin plattform åt sina kunder. Om ni redan använder Zonos API och bara behöver skapa sändningar för befintliga ordrar, se i stället vår guide för att skapa sändningar.
Om ni är en fraktplattform som stöder Zonos-kunder som skickar internationellt bör integration med Zonos för att skapa sändningar vara en av era främsta prioriteringar. Detta gör det möjligt för er att erbjuda den mest sömlösa upplevelsen för era handlare och deras kunder genom att utnyttja plattformens befintliga funktioner samtidigt som Zonos hanterar skapandet av sändningen, etiketten och tillhörande tulldokumentation.
Fördelarna med att använda Zonos för att skapa sändningar inkluderar:
Tredjepartsfakturering av tull och skatt - Vi säkerställer att ert eller er handlares fraktbolagskontonummer används för fraktavgifter, medan fakturorna för tull och skatt går till Zonos.
Flexibilitet - Istället för att lägga ner utvecklingsarbete på att säkerställa att er plattform kan generera regelefterlevande etiketter, integrerar ni med vårt API och låter oss hantera den ständigt föränderliga efterlevnaden vid gränsöverskridande handel.
Korrekt tulldokumentation - När ni använder Zonos för att generera etiketter säkerställer vi att rätt uppgifter skickas till fraktbolaget så att paketet snabbt klarerar tullen.
Den här guiden går igenom stegen för att implementera en komplett end-to-end-integration som gör att ni kan anropa Zonos för sändningar från er plattform.
Följ stegen nedan för att låta era kunder hämta Zonos-etiketter från er plattform.
1
Tillåt API-autentiseringsuppgifter
Zonos API nås med en credentialToken. Er plattform behöver ge kunderna möjlighet att ange sin credentialToken från Zonos Dashboard i er plattform. Därifrån kan ni göra förfrågningar till Zonos å deras vägnar.
2
Skapa en sändning
För att hämta en label måste ni skapa en shipment som label kommer att kopplas till. Zonos hanterar denna process med ett arbetsflöde som skapar shipments och labels i samma förfrågan. När ni utför denna mutation behöver ni inte skicka med en serviceLevel eftersom vi använder den serviceLevel som hämtas från den landedCost som är kopplad till order. För orderId kan ni använda Zonos order-ID eller accountOrderNumber, som troligen redan finns i ert system.
När en sändning och etiketter har skapats returnerar vi etiketterna antingen som en labelImage, vilket är en BASE64_ENCODED_IMAGE, eller som en url där etiketten kan hämtas.
Använd detta arbetsflöde när ni skapar en sändning för en befintlig order och inte behöver ändra uppgifter om artiklar eller parter. Det stöder valfria spårningsnummer, fulfillmentcenter, val av servicenivå och försäkring för deklarerat värde.
Shopify-handlare
Shopify skickar ett null-värde för person i ursprungsparten. Därför fungerar inte orderId ensamt för Shopify-handlare — använd i stället fliken Skapa avancerad sändning och ange fullständiga partsuppgifter, inklusive person.
Med fulfillmentcenter: Lägg till "fulfillmentCenter": "fulfillment_center_12345" för att ange ursprungsplatsen
Med anpassad spårning: Sätt "generateLabel": false och lägg till "trackingNumbers": ["tracking_1", "tracking_2"]
Med servicenivå: Lägg till "serviceLevel": "dhl.express_example" för att välja en specifik fraktbolagstjänst
Med försäkring för deklarerat värde: Lägg till "isDeclaredValue": true för att aktivera täckning för deklarerat värde
Med särskilda tjänster: Se guiden för särskilda tjänster för batterier, torris, farligt gods och alternativ för signatur.
Deklarerat värde
Sätt "isDeclaredValue": true för att aktivera täckning för deklarerat värde för alla artiklar i er sändning. Zonos anger automatiskt det fulla värdet för alla artiklar som skickats med i ordern; handlare kan inte ändra detta belopp. Detta anger det maximala ansvar som fraktbolaget accepterar vid förlust, skada eller stöld under transporten. Denna funktion stöds endast för sändningar med UPS, FedEx och DHL. Zonos hanterar automatiskt den fraktbolagsspecifika implementeringen när ni aktiverar deklarerat värde, inklusive de rätta parametrarna i våra API-anrop till dessa fraktbolag, så ni behöver inte hantera olika fraktbolags krav.
UPS-begränsningar: UPS täcker endast värden mellan 100 och 50 000 USD och behandlar deklarerat värde på kartongnivå. För sändningar med flera kartonger måste handlare dela upp sändningen för att ange täckning per kartong. UPS genererar också ett extra försäkringsformulär som måste skrivas ut tillsammans med etiketterna.
FedEx och DHL: Behandlar deklarerat värde på sändningsnivå utan ytterligare begränsningar.
Särskilda tjänster
Använd specialServices på en kartong för att ange särskilda hanteringskrav för batterier, torris, farligt gods eller signaturkrav. Se guiden för särskilda tjänster för fullständiga detaljer och exempel.
ShipStation UPS Unlock: Sändningar med flera kolli stöds inte. När en order skickas i flera kartonger dupliceras referensfältet, vilket gör att matchningen av ordernummer misslyckas i backend. Handlare som behöver sändningar med flera kolli bör i stället skapa etiketten i Zonos Dashboard. Sändningar med en enda kartong påverkas inte.
3
Makulera en sändning
Om en kund vill makulera en shipment kan ni använda följande mutation, som makulerar alla labels som är kopplade till shipment.
Plattformsintegration för sändningar
Skapa sändningar från er plattform
Ge era kunder möjlighet att skapa Zonos-sändningar och etiketter från er plattform.
Den här guiden är utformad för utvecklare av fraktplattformar som vill integrera Zonos funktioner för att skapa sändningar i sin plattform åt sina kunder. Om ni redan använder Zonos API och bara behöver skapa sändningar för befintliga ordrar, se i stället vår guide för att skapa sändningar.
Om ni är en fraktplattform som stöder Zonos-kunder som skickar internationellt bör integration med Zonos för att skapa sändningar vara en av era främsta prioriteringar. Detta gör det möjligt för er att erbjuda den mest sömlösa upplevelsen för era handlare och deras kunder genom att utnyttja plattformens befintliga funktioner samtidigt som Zonos hanterar skapandet av sändningen, etiketten och tillhörande tulldokumentation.
Fördelarna med att använda Zonos för att skapa sändningar inkluderar:
Den här guiden går igenom stegen för att implementera en komplett end-to-end-integration som gör att ni kan anropa Zonos för sändningar från er plattform.
Aktivera etikettutskrift
Följ stegen nedan för att låta era kunder hämta Zonos-etiketter från er plattform.
Tillåt API-autentiseringsuppgifter
Zonos API nås med en
credentialToken. Er plattform behöver ge kunderna möjlighet att ange sincredentialTokenfrån Zonos Dashboard i er plattform. Därifrån kan ni göra förfrågningar till Zonos å deras vägnar.Skapa en sändning
För att hämta en
labelmåste ni skapa enshipmentsomlabelkommer att kopplas till. Zonos hanterar denna process med ett arbetsflöde som skaparshipmentsochlabelsi samma förfrågan. När ni utför denna mutation behöver ni inte skicka med enserviceLeveleftersom vi använder denserviceLevelsom hämtas från denlandedCostsom är kopplad tillorder. FörorderIdkan ni använda Zonos order-ID elleraccountOrderNumber, som troligen redan finns i ert system.När en sändning och etiketter har skapats returnerar vi etiketterna antingen som en
labelImage, vilket är enBASE64_ENCODED_IMAGE, eller som enurldär etiketten kan hämtas.Använd detta arbetsflöde när ni skapar en sändning för en befintlig order och inte behöver ändra uppgifter om artiklar eller parter. Det stöder valfria spårningsnummer, fulfillmentcenter, val av servicenivå och försäkring för deklarerat värde.
Shopify skickar ett null-värde för
personi ursprungsparten. Därför fungerar inteorderIdensamt för Shopify-handlare — använd i stället fliken Skapa avancerad sändning och ange fullständiga partsuppgifter, inklusiveperson.mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustrackingDetails {number}serviceLevel {idnamecarrier {idname}}shipmentCartons {idcarton {idwidthlengthheightweightitems {item {idamountdescriptionlabelurltrackingNumberiddocumentFilingVariabelalternativ:
"fulfillmentCenter": "fulfillment_center_12345"för att ange ursprungsplatsen"generateLabel": falseoch lägg till"trackingNumbers": ["tracking_1", "tracking_2"]"serviceLevel": "dhl.express_example"för att välja en specifik fraktbolagstjänst"isDeclaredValue": trueför att aktivera täckning för deklarerat värdeDeklarerat värde
Sätt
"isDeclaredValue": trueför att aktivera täckning för deklarerat värde för alla artiklar i er sändning. Zonos anger automatiskt det fulla värdet för alla artiklar som skickats med i ordern; handlare kan inte ändra detta belopp. Detta anger det maximala ansvar som fraktbolaget accepterar vid förlust, skada eller stöld under transporten. Denna funktion stöds endast för sändningar med UPS, FedEx och DHL. Zonos hanterar automatiskt den fraktbolagsspecifika implementeringen när ni aktiverar deklarerat värde, inklusive de rätta parametrarna i våra API-anrop till dessa fraktbolag, så ni behöver inte hantera olika fraktbolags krav.UPS-begränsningar: UPS täcker endast värden mellan 100 och 50 000 USD och behandlar deklarerat värde på kartongnivå. För sändningar med flera kartonger måste handlare dela upp sändningen för att ange täckning per kartong. UPS genererar också ett extra försäkringsformulär som måste skrivas ut tillsammans med etiketterna.
FedEx och DHL: Behandlar deklarerat värde på sändningsnivå utan ytterligare begränsningar.
Särskilda tjänster
Använd
specialServicespå en kartong för att ange särskilda hanteringskrav för batterier, torris, farligt gods eller signaturkrav. Se guiden för särskilda tjänster för fullständiga detaljer och exempel.ShipStation UPS Unlock: Sändningar med flera kolli stöds inte. När en order skickas i flera kartonger dupliceras referensfältet, vilket gör att matchningen av ordernummer misslyckas i backend. Handlare som behöver sändningar med flera kolli bör i stället skapa etiketten i Zonos Dashboard. Sändningar med en enda kartong påverkas inte.
Makulera en sändning
Om en kund vill makulera en
shipmentkan ni använda följande mutation, som makulerar allalabelssom är kopplade tillshipment.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 den här sidan till hjälp?