Buat pengiriman via API
Setelah menghitung Landed Cost dan membuat pesanan, Anda dapat mengirim nomor pelacakan dan detail pengiriman lainnya ke Zonos melalui API.
Gunakan alur kerja ini ketika Anda membuat pengiriman untuk pesanan yang ada dan tidak perlu mengubah detail item atau pihak. Alur ini mendukung nomor pelacakan opsional, pusat pemenuhan, pemilihan tingkat layanan, dan asuransi nilai deklaratif.
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 } } }}Opsi Variabel:
- Dengan Pusat Pemenuhan: Tambahkan
"fulfillmentCenter": "fulfillment_center_12345"untuk menentukan lokasi asal - Dengan Pelacakan Kustom: Atur
"generateLabel": falsedan tambahkan"trackingNumbers": ["tracking_1", "tracking_2"] - Dengan Tingkat Layanan: Tambahkan
"serviceLevel": "dhl.express_example"untuk memilih layanan pembawa tertentu - Dengan Asuransi Nilai Deklaratif: Tambahkan
"isDeclaredValue": trueuntuk mengaktifkan perlindungan nilai deklaratif
Nilai deklaratif
Atur "isDeclaredValue": true untuk mengaktifkan perlindungan nilai deklaratif untuk semua item di pengiriman Anda. Zonos secara otomatis mengklaim nilai penuh dari semua item yang diajukan dalam pesanan; pedagang tidak dapat mengubah jumlah ini. Ini menetapkan kewajiban maksimum yang akan diterima pembawa dalam kasus kehilangan, kerusakan, atau pencurian selama pengiriman. Fitur ini hanya didukung untuk pengiriman UPS, FedEx, dan DHL. Zonos secara otomatis menangani implementasi khusus pembawa ketika Anda mengaktifkan nilai deklaratif, termasuk parameter yang sesuai dalam panggilan API kami ke pembawa ini, sehingga Anda tidak perlu mengelola persyaratan pembawa yang berbeda.
Batasan UPS: UPS hanya mencakup nilai antara 100,01-50.000 USD dan memproses nilai deklaratif di tingkat karton. Untuk pengiriman multi-karton, pedagang harus membagi pengiriman untuk menunjuk cakupan per karton. UPS juga menghasilkan formulir asuransi tambahan (UPS Control Log) yang harus dicetak bersama label untuk nilai deklaratif di atas 999 USD.
FedEx dan DHL: Memproses nilai deklaratif di tingkat pengiriman tanpa batasan tambahan.
Layanan khusus
Gunakan specialServices pada karton untuk menunjukkan persyaratan penanganan khusus untuk baterai, es kering, barang berbahaya, atau persyaratan tanda tangan. Lihat panduan layanan khusus untuk detail lengkap dan contoh.
Batalkan pengiriman
Untuk membatalkan label yang dibuat, gunakan mutasi berikut untuk membatalkan pengiriman. Label terkait apa pun juga akan dibatalkan secara otomatis. Perhatikan bahwa setelah pengiriman dibatalkan, pengiriman tidak dapat diperbarui atau dipulihkan.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Buat pengiriman untuk pesanan yang ada
Buat pengiriman dan label dengan API Zonos setelah menghitung biaya bea masuk dan membuat pesanan.
GraphQL
Panduan ini dirancang untuk pengguna yang sudah terintegrasi dengan API Zonos dan perlu membuat pengiriman untuk pesanan yang ada di sistem mereka. Jika Anda adalah platform pengiriman dan ingin menawarkan pembuatan pengiriman Zonos kepada pelanggan Anda, lihat panduan API Pengiriman kami.
Jika Anda terintegrasi dengan API Zonos dan disetujui untuk mengirim di luar Dashboard, gunakan mutasi
shipmentCreateWorkflowuntuk membuat pengiriman dan memberikan informasi pelacakan. Mutasi ini juga memungkinkan Anda menginformasikan Zonos tentang pengiriman domestik ke fasilitas cross-docking.Catatan: Jika Anda menggunakan aplikasi Duty and Tax dengan platform yang secara otomatis menyinkronkan nomor pelacakan ke Zonos, atau jika Anda mengirim langsung melalui Dashboard, mutasi ini tidak diperlukan.