Aktifkan pencetakan label
Ikuti langkah-langkah di bawah ini untuk memungkinkan pelanggan Anda mengambil label Zonos dari platform Anda.
Izinkan kredensial API
Zonos API dapat diakses oleh credentialToken. Platform Anda harus memberi pelanggan kemampuan untuk memasukkan credentialToken mereka dari Zonos Dashboard ke dalam platform Anda. Dari sini, Anda akan dapat membuat permintaan ke Zonos atas nama mereka.
Buat pengiriman
Untuk mengambil label, Anda diperlukan untuk membuat shipment yang akan dikaitkan dengan label. Zonos mengelola proses ini dengan alur kerja yang membuat shipments dan labels dalam permintaan yang sama. Saat melakukan mutasi ini, Anda tidak perlu melewatkan serviceLevel karena kami akan menggunakan serviceLevel yang digunakan dari landedCost yang terikat pada order. Untuk orderId, Anda dapat menggunakan Zonos order ID atau accountOrderNumber yang mungkin sudah ada di sistem Anda.
Ketika pengiriman dan label berhasil dibuat, kami akan mengembalikan label sebagai labelImage yang merupakan BASE64_ENCODED_IMAGE, atau sebagai url tempat label dapat diambil.
Gunakan alur kerja ini saat Anda membuat pengiriman untuk pesanan yang ada dan tidak perlu memodifikasi detail item atau pihak. Ini mendukung nomor pelacakan opsional, pusat pemenuhan pesanan, pilihan tingkat layanan, dan asuransi nilai yang dinyatakan.
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 documentFilingOpsi 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 yang Dinyatakan: Tambahkan
"isDeclaredValue": trueuntuk mengaktifkan cakupan nilai yang dinyatakan - Dengan Layanan Khusus: Lihat panduan layanan khusus untuk baterai, es kering, barang berbahaya, dan opsi tanda tangan.
Nilai yang dinyatakan
Atur "isDeclaredValue": true untuk mengaktifkan cakupan nilai yang dinyatakan untuk semua item dalam pengiriman Anda. Zonos secara otomatis mengklaim nilai penuh semua item yang dikirimkan dalam pesanan; pedagang tidak dapat memodifikasi jumlah ini. Ini menetapkan tanggung jawab maksimum yang akan diterima pembawa dalam kasus kehilangan, kerusakan, atau pencurian selama transit. Fitur ini hanya didukung untuk pengiriman UPS, FedEx, dan DHL. Zonos secara otomatis menangani implementasi khusus pembawa ketika Anda mengaktifkan nilai yang dinyatakan, termasuk parameter yang sesuai dalam panggilan API kami ke pembawa ini, jadi Anda tidak perlu mengelola persyaratan pembawa yang berbeda.
Batasan UPS: UPS hanya mencakup nilai antara 100-50.000 USD dan memproses nilai yang dinyatakan pada tingkat karton. Untuk pengiriman multi-karton, pedagang harus membagi pengiriman untuk menentukan cakupan per karton. UPS juga menghasilkan formulir asuransi tambahan yang harus dicetak dengan label.
FedEx dan DHL: Nilai yang dinyatakan proses pada 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.
Pembuka Kunci UPS ShipStation: Pengiriman multi-potongan tidak didukung. Ketika pesanan dikirim dalam beberapa kotak, bidang referensi diduplikasi, menyebabkan pencocokan nomor pesanan gagal di backend. Pedagang yang memerlukan pengiriman multi-potongan harus membuat label di Zonos Dashboard sebagai gantinya. Pengiriman kotak tunggal tidak terpengaruh.
Batalkan pengiriman
Dalam hal pelanggan ingin membatalkan shipment, Anda dapat menggunakan mutasi berikut yang akan membatalkan semua labels yang terikat pada shipment.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
Buat pengiriman dari platform Anda
Berikan pelanggan kemampuan untuk membuat pengiriman dan label Zonos dari platform Anda.
Panduan ini dirancang untuk pengembang platform pengiriman yang ingin mengintegrasikan kemampuan pembuatan pengiriman Zonos ke dalam platform mereka untuk pelanggan mereka. Jika Anda sudah menggunakan Zonos API dan hanya perlu membuat pengiriman untuk pesanan yang ada, lihat panduan pembuatan pengiriman kami.
Jika Anda adalah platform pengiriman yang mendukung pelanggan Zonos mengirim secara internasional, integrasi dengan Zonos untuk pembuatan pengiriman harus menjadi pertimbangan utama. Ini akan memungkinkan Anda menawarkan pengalaman paling mulus bagi pedagang dan pelanggan mereka dengan memanfaatkan fitur platform yang ada sambil membiarkan Zonos mengelola pembuatan pengiriman, label, dan dokumentasi bea cukai pendukung.
Keuntungan menggunakan Zonos untuk membuat pengiriman meliputi:
Panduan ini akan memandu Anda melalui langkah-langkah untuk mengimplementasikan integrasi lengkap end-to-end yang akan memungkinkan Anda memanggil Zonos untuk pengiriman dari platform Anda.