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 sin credentialToken frå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 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.
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 documentFilingVariabelalternativ:
- Med fulfillmentcenter: Lägg till
"fulfillmentCenter": "fulfillment_center_12345"för att ange ursprungsplatsen - Med anpassad spårning: Sätt
"generateLabel": falseoch 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": truefö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.
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.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
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.