Opprett forsendelser via API
Etter å ha beregnet en landingsomkostning og opprettet en bestilling, kan du sende sporingsnumre og andre forsendelses detaljer til Zonos gjennom API.
Bruk denne arbeidsflyten når du oppretter en forsendelse for en eksisterende bestilling og ikke trenger å endre detaljer om varer eller parter. Den støtter valgfrie sporingsnumre, oppfyllelsessentre, valg av servicenivå og deklarert verdiforsikring.
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 } } }}Variabelalternativer:
- Med oppfyllelsessenter: Legg til
"fulfillmentCenter": "fulfillment_center_12345"for å spesifisere opprinnelsessted - Med eget sporing: Sett
"generateLabel": falseog legg til"trackingNumbers": ["tracking_1", "tracking_2"] - Med servicenivå: Legg til
"serviceLevel": "dhl.express_example"for å velge en bestemt operatørservice - Med deklarert verdiforsikring: Legg til
"isDeclaredValue": truefor å aktivere deklarert verdidekning
Deklarert verdi
Sett "isDeclaredValue": true for å aktivere deklarert verdidekning for alle varer i forsendelsen din. Zonos krever automatisk den fulle verdien av alle varer som sendes inn i bestillingen; selgere kan ikke endre dette beløpet. Dette angir den maksimale ansvaret som operatøren vil akseptere ved tap, skade eller tyveri under transport. Denne funksjonen støttes bare for UPS-, FedEx- og DHL-forsendelser. Zonos håndterer automatisk operatørspesifikk implementering når du aktiverer deklarert verdi, inkludert passende parametere i våre API-anrop til disse operatørene, slik at du ikke trenger å administrere ulike operatørkrav.
UPS-begrensninger: UPS dekker bare verdier mellom 100,01–50 000 USD og behandler deklarert verdi på kartonnivå. For flerkarton-forsendelser må selgere dele forsendelsen for å bestemme dekning per kartong. UPS genererer også et tilleggssforsikringsskjema (UPS Control Log) som må skrives ut sammen med etikettene for deklarerte verdier over 999 USD.
FedEx og DHL: Behandler deklarert verdi på forsendelsnivå uten ytterligere begrensninger.
Spesielle tjenester
Bruk specialServices på en kartong for å indikere spesielle håndteringskrav for batterier, tørris, farlige varer eller signeringsalternativer. Se veiledningen for spesielle tjenester for alle detaljer og eksempler.
Annuller en forsendelse
For å annullere en opprettet etikett, bruk følgende mutasjon til å annullere forsendelsen. Alle tilknyttede etiketter blir også automatisk annullert. Merk at når en forsendelse er annullert, kan den ikke oppdateres eller gjenopprettes.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Opprett en forsendelse for eksisterende bestillinger
Opprett forsendelser og etiketter med Zonos API etter å ha beregnet landingskostnader og opprettet bestillinger.
GraphQL
Denne veiledningen er utformet for brukere som allerede er integrert med Zonos API og som trenger å opprette forsendelser for eksisterende bestillinger i systemet sitt. Hvis du er en forsendelsesoversikt og ønsker å tilby Zonos-forsendelsesetablering til dine kunder i stedet, se veiledningen vår for Shipment API.
Hvis du er integrert med Zonos API og godkjent for å sende utenfor Dashboard, bruk
shipmentCreateWorkflow-mutasjonen til å opprette forsendelser og oppgi sporingssinformasjon. Disse mutasjonene lar deg også informere Zonos om innenlandske forsendelser til krysstockingsfasiliteter.Merk: Hvis du bruker en Duty and Tax-app med en plattform som automatisk synkroniserer sporingsnumre til Zonos, eller hvis du sender direkte gjennom Dashboard, er disse mutasjonene ikke nødvendige.