Create shipments via API
Landed Cost calculate 및 order 생성 후 API를 통해 tracking number 및 other shipment detail을 Zonos에 send할 수 있습니다.
Existing order shipment 생성 시 item 또는 party detail modify가 필요 없을 때 이 workflow를 사용하세요. Optional tracking number, fulfillment center, service level selection, declared value insurance를 지원합니다.
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 } } }}Variable options:
- With Fulfillment Center: Origin location 지정을 위해
"fulfillmentCenter": "fulfillment_center_12345"추가 - With Custom Tracking:
"generateLabel": false설정 및"trackingNumbers": ["tracking_1", "tracking_2"]추가 - With Service Level: Specific carrier service 선택을 위해
"serviceLevel": "dhl.express_example"추가 - With Declared Value Insurance: Declared value coverage enable을 위해
"isDeclaredValue": true추가
Declared value
"isDeclaredValue": true` 설정으로 shipment 모든 item declared value coverage를 enable합니다. Zonos는 order submitted 모든 item full value를 automatically claim하며 merchant는 amount를 modify할 수 없습니다. Transit 중 loss, damage, theft 시 carrier maximum liability를 설정합니다. UPS, FedEx, DHL shipment만 지원합니다. Declared value enable 시 carrier-specific implementation을 automatically 처리하므로 different carrier requirement를 manage할 필요 없습니다.
UPS limitations: UPS는 100.01-50,000 USD value만 cover하며 carton level declared value를 처리합니다. Multi-carton shipment는 carton별 coverage 지정을 위해 split해야 합니다. 999 USD 초과 declared value는 label과 함께 print해야 하는 additional insurance form(UPS Control Log)을 generate합니다.
FedEx and DHL: Additional restriction 없이 shipment level declared value를 처리합니다.
Special services
Carton specialServices로 battery, dry ice, dangerous goods, signature requirement special handling을 indicate합니다. Full detail 및 example은 special services guide를 참조하세요.
Void a shipment
Created label cancel은 아래 mutation으로 shipment void를 사용하세요. Associated label도 automatically void됩니다. Shipment void 후 update 또는 restore 불가합니다.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Create a shipment for existing orders
Landed cost calculate 및 order 생성 후 Zonos API로 shipment 및 label을 생성합니다.
GraphQL
이 guide는 Zonos API에 integrated되어 system existing order shipment를 생성해야 하는 user용입니다. Shipping platform이 customer에게 Zonos shipment creation을 offer하려면 Shipment API guide를 참조하세요.
Zonos API integrated 및 ship outside of Dashboard approved이면
shipmentCreateWorkflowmutation으로 shipment를 생성하고 tracking information을 제공하세요. Cross-docking facility domestic shipment도 Zonos에 inform할 수 있습니다.Note: Platform이 tracking number를 Zonos에 automatically sync하는 Duty and Tax app을 사용하거나 Dashboard에서 directly shipping하면 이 mutation은 required하지 않습니다.