Landed Cost•

BerandaUntuk penyedia logistik Landed Cost Integrasi pengiriman platform

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:

Penagihan pihak ketiga bea dan pajak - Kami akan memastikan bahwa nomor rekening pembawa Anda atau pedagang digunakan untuk biaya pengiriman sementara tagihan untuk bea dan pajak datang ke Zonos.
Fleksibilitas - Alih-alih melakukan pekerjaan dev untuk memastikan bahwa Anda dapat menghasilkan label yang sesuai dengan platform Anda, integrasikan dengan API kami dan biarkan kepatuhan lintas batas yang terus berubah kepada kami.
Dokumentasi bea cukai yang akurat - Ketika Anda menggunakan Zonos untuk menghasilkan label, kami memastikan bahwa detail yang tepat diteruskan ke pembawa untuk memastikan bahwa paket melewati bea cukai dengan cepat.

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.

Aktifkan pencetakan label

Ikuti langkah-langkah di bawah ini untuk memungkinkan pelanggan Anda mengambil label Zonos dari platform Anda.

Izinkan kredensial API

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 menyertakan 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.

Pedagang Shopify

Shopify mengirimkan nilai null untuk person dalam pihak asal. Akibatnya, orderId saja tidak akan berfungsi untuk pedagang Shopify — gunakan tab Pembuatan pengiriman lanjutan sebagai gantinya dan berikan detail pihak lengkap termasuk person.

1mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {

2 shipmentCreateWorkflow(input: $input) {

3 id

4 status

5 trackingDetails {

6 number

7 }

8 serviceLevel {

9 id

10 name

11 carrier {

12 id

13 name

14 }

15 }

16 shipmentCartons {

17 id

18 carton {

19 id

20 width

21 length

22 height

23 weight

24 items {

25 item

26 id

27 amount

28 description

32 label

33 url

34 trackingNumber

35 id

36 documentFiling

Opsi Variabel:

Dengan Pusat Pemenuhan: Tambahkan "fulfillmentCenter": "fulfillment_center_12345" untuk menentukan lokasi asal
Dengan Pelacakan Kustom: Atur "generateLabel": false dan 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": true untuk 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: Memproses nilai yang dinyatakan 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

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

Pesan demo

Buat pengiriman dari platform Anda

Aktifkan pencetakan label

Izinkan kredensial API

Buat pengiriman

Batalkan pengiriman

Apakah halaman ini bermanfaat?