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 dengan credentialToken. Platform Anda perlu memberikan kemampuan kepada pelanggan untuk memasukkan credentialToken mereka dari Zonos Dashboard ke dalam platform Anda. Dari sini, Anda akan dapat melakukan permintaan ke Zonos atas nama mereka.
Buat pengiriman
Untuk mengambil label, Anda diharuskan 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 mengirimkan serviceLevel karena kami akan menggunakan serviceLevel yang digunakan dari landedCost yang terkait dengan order. Untuk orderId, Anda dapat menggunakan ID pesanan Zonos atau accountOrderNumber yang kemungkinan 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 di mana label dapat diambil.
Gunakan alur kerja ini ketika Anda membuat pengiriman untuk pesanan yang sudah ada dan tidak perlu memodifikasi detail item atau pihak. Ini mendukung nomor pelacakan opsional, pusat pemenuhan, pemilihan tingkat layanan, dan asuransi nilai yang dinyatakan.
Mutasi
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
}
}
}
}
Variabel Dasar
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
Dengan Pusat Pemenuhan
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
Dengan Pelacakan Kustom
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
Dengan Tingkat Layanan
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
Dengan asuransi nilai yang dinyatakan
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789mno",
"isDeclaredValue": true
}
}
Nilai yang Dinyatakan
Set "isDeclaredValue": true untuk mengaktifkan perlindungan nilai yang dinyatakan untuk semua item dalam pengiriman Anda. Zonos secara otomatis mengklaim nilai penuh dari semua item yang diajukan dalam pesanan; pedagang tidak dapat mengubah jumlah ini. Ini menetapkan tanggung jawab maksimum yang akan diterima oleh pengangkut dalam hal kehilangan, kerusakan, atau pencurian selama pengiriman. Fitur ini hanya didukung untuk pengiriman UPS, FedEx, dan DHL. Zonos secara otomatis menangani implementasi spesifik pengangkut ketika Anda mengaktifkan nilai yang dinyatakan, termasuk parameter yang sesuai dalam panggilan API kami ke pengangkut ini, sehingga Anda tidak perlu mengelola persyaratan pengangkut yang berbeda.
Batasan UPS: UPS hanya mencakup nilai antara 100-50.000 USD dan memproses nilai yang dinyatakan di tingkat karton. Untuk pengiriman multi-karton, pedagang harus membagi pengiriman untuk menetapkan perlindungan per karton. UPS juga menghasilkan formulir asuransi tambahan yang harus dicetak bersama dengan label.
FedEx dan DHL: Memproses nilai yang dinyatakan di tingkat pengiriman tanpa batasan tambahan.
Batalkan pengiriman
Jika seorang pelanggan ingin membatalkan pengiriman, Anda dapat menggunakan mutasi berikut yang akan membatalkan semua label yang terkait dengan pengiriman.
Permintaan
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
Buat pengiriman dari platform Anda
Beri 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 sudah ada, lihat panduan pembuatan pengiriman.
Jika Anda adalah platform pengiriman yang mendukung pelanggan Zonos yang mengirim secara internasional, mengintegrasikan dengan Zonos untuk pembuatan pengiriman harus menjadi pertimbangan utama. Ini akan memungkinkan Anda untuk menawarkan pengalaman yang paling mulus bagi pedagang Anda dan pelanggan mereka dengan memanfaatkan fitur-fitur yang sudah ada di platform Anda sambil membiarkan Zonos mengelola pembuatan pengiriman, label, dan dokumentasi bea cukai yang mendukung.
Keuntungan menggunakan Zonos untuk membuat pengiriman meliputi:
Panduan ini akan memandu Anda melalui langkah-langkah untuk menerapkan integrasi lengkap dari awal hingga akhir yang akan memungkinkan Anda untuk memanggil Zonos untuk pengiriman dari platform Anda.