Opret forsendelser via API
Efter beregning af en Landed Cost og oprettelse af en ordre kan du sende sporingsnumre og andre forsendelsesdetaljer til Zonos via API'en.
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 documentFiling } } }}Variabelmuligheder:
- 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
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,01-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 (UPS Control Log), der skal printes sammen med labels for declared value over 999 USD.
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.
Annuller en forsendelse
For at annullere en oprettet label skal du bruge følgende mutation til at annullere forsendelsen. Alle tilknyttede labels annulleres også automatisk. Bemærk, at når en forsendelse er annulleret, kan den ikke opdateres eller gendannes.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Opret en forsendelse til eksisterende ordrer
Opret forsendelser og labels med Zonos API efter beregning af landed cost og oprettelse af ordrer.
GraphQL
Denne guide er beregnet til brugere, der allerede er integreret med Zonos API og skal oprette forsendelser til eksisterende ordrer i deres system. Hvis du er en forsendelsesplatform og i stedet vil tilbyde Zonos-forsendelsesoprettelse til dine kunder, se vores Shipment API-guide.
Hvis du er integreret med Zonos API og godkendt til at sende uden for Dashboard, skal du bruge
shipmentCreateWorkflow-mutationen til at oprette forsendelser og angive sporingsoplysninger. Disse mutationer giver dig også mulighed for at informere Zonos om indenlandske forsendelser til cross-docking-faciliteter.Bemærk: Hvis du bruger en Duty and Tax-app med en platform, der automatisk synkroniserer sporingsnumre til Zonos, eller hvis du sender direkte via Dashboard, er disse mutationer ikke påkrævede.