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 deres credentialToken fra Zonos Dashboard i din platform. Derefter kan du foretage anmodninger til Zonos på deres vegne.
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.
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 documentFilingVariabelmuligheder:
- Med fulfillment center: Tilføj
"fulfillmentCenter": "fulfillment_center_12345"for at angive oprindelseslokationen - Med brugerdefineret sporing: Sæt
"generateLabel": falseog 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": truefor 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.
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.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
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.