Unggah pesanan secara massal

Unduh template CSV langsung dari halaman unggah di Dashboard. Template mencakup semua kolom wajib dan opsional — kolom wajib ditandai dengan asterisk (*) di baris header.

Satu baris per item 

Setiap baris mewakili satu item, bukan satu pesanan. Baris yang berbagi Order ID yang sama dikelompokkan menjadi satu pesanan multi-item, sehingga pesanan dengan tiga item berarti tiga baris. Nilai tingkat pesanan — penerima, alamat, tingkat layanan, jumlah pengiriman, mata uang, pihak yang membayar bea cukai, dan karton — dibaca dari baris pertama setiap kelompok.

Kolom wajib 

Informasi wajib untuk setiap baris terbagi dalam tiga kategori:

Penerima — Nama, nomor telepon, dan alamat pengiriman penerima, termasuk negara tujuan. Email bersifat opsional, tetapi divalidasi formatnya jika Anda memberikannya. Kode pos dan negara bagian/provinsi hanya diperlukan untuk negara yang format alamatnya menggunakannya — untuk negara tanpa kode pos (misalnya Hong Kong atau Tanzania), cukup kosongkan sel. Untuk negara dengan daftar negara bagian/provinsi, gunakan nama wilayah atau kode yang diakui (misalnya "Dubayy" atau "DU" untuk Dubai) sehingga pembawa dapat menilai tujuan.

Item — Paling tidak, nama item dan harga. Jumlah bersifat opsional dan default ke 1. Memberikan kode HS dan negara asal meningkatkan akurasi klasifikasi dan dapat mengurangi waktu pemrosesan di layar konfirmasi.

Pengiriman — Kode tingkat layanan yang cocok dengan pembawa yang dikonfigurasi di akun Anda (misalnya fedex.international_priority, ups_worldwide_expedited). Kolom Shipping Amount bersifat opsional: masukkan jumlah (0 diizinkan) untuk menggunakannya sebagai biaya pengiriman pesanan, atau kosongkan dan estimasi tarif pembawa akan dihitung untuk tingkat layanan Anda. Baris yang dihitung memerlukan beberapa detik tambahan masing-masing di layar konfirmasi, dan biaya pembawa akhir saat pembuatan label dapat berbeda dari estimasi. Beberapa tujuan tidak dapat dinilai secara otomatis (kesalahan "layanan tidak tersedia untuk negara tujuan") — masukkan jumlah pengiriman hanya untuk baris tersebut; baris kosong dan terisi dapat dicampur dengan bebas dalam satu file.

Kolom opsional 

ID Pajak Penerima — Gunakan kolom Tax ID Type dan Tax ID Number untuk menyertakan pengenal pajak penerima pada pesanan. Jenis harus menjadi salah satu kode di bawah (tidak peka huruf besar-kecil). Berikan kedua kolom bersama-sama; jenis tanpa nomor (atau sebaliknya) ditandai sebagai kesalahan di layar konfirmasi. ID pajak disimpan pada penerima pesanan dan diteruskan ke pembawa saat label dibuat. Untuk pesanan multi-item, ID pajak dari baris pertama pesanan digunakan.

Gunakan kode spesifik negara jika ada; untuk negara mana pun yang tidak tercantum, gunakan TIN.

Kode khusus tambahan (FED, FTZ, DUN, dan akun penangguhan bea cukai dan pajak DAN/TAN/DTF) diterima ketika perwakilan Zonos Anda mengarahkan Anda untuk menggunakannya.

Bea Cukai Dibayar Oleh — Opsional DDP atau DDU per pesanan. Kosongkan untuk perilaku default: DDP di mana pun tujuan mendukungnya, dengan fallback otomatis ke DDU jika tidak. DDP eksplisit ketat — baris error alih-alih fallback — dan DDU membuat penerima bertanggung jawab atas bea cukai dan pajak saat pengiriman. Layar konfirmasi dan unduhan hasil menunjukkan mana yang sebenarnya mendarat pada setiap pesanan, dengan lencana oranye pada baris DDU. Untuk pesanan multi-item, nilai pertama yang ditentukan menang, dan nilai yang bertentangan adalah kesalahan.

Jumlah Karton — Jika pesanan dikirimkan dalam beberapa kotak identik, atur Carton Quantity bersama kolom Carton Length/Width/Height/Weight. Kolom karton menjelaskan satu kotak (berat adalah berat satu kotak yang dikemas), dan jumlahnya mengalikannya — misalnya, 360 unit dikemas 30 dalam kotak akan menggunakan dimensi kotak, berat satu kotak penuh, dan jumlah karton 12. Kosong berarti 1. Pesanan dengan ukuran kotak campuran tidak dapat dijelaskan dalam CSV — biarkan kolom karton kosong pada pesanan tersebut dan Zonos akan membuat kotak secara otomatis berdasarkan berat item.

Tips 

• Gunakan kode tingkat layanan yang tepat ditampilkan di pengaturan pembawa Anda. Baris dengan kode tingkat layanan yang tidak diakui akan menampilkan peringatan di layar konfirmasi.
• Wilayah AS berbeda: Kepulauan Virgin AS menggunakan kode negara mereka sendiri (VI) dan mengirim sebagai internasional, sementara Puerto Rico menggunakan US dan mengirim sebagai domestik.
• Pembawa (khususnya UPS) menolak alamat pengiriman Kotak Pos — baris dengan "P.O. Box" di baris alamat dapat gagal rating dengan kesalahan ketersediaan layanan generik. Gunakan alamat jalan jika memungkinkan.
• Tanda baca tipografis dari Word atau Excel (kutipan keriting, garis en/em) dikoreksi secara otomatis. Tanda tanya yang muncul di mana seharusnya ada huruf aksen menunjukkan file kehilangan pengkodeannya — baris tersebut ditandai sehingga Anda dapat memasukkan kembali teksnya.
• Untuk negara tujuan yang memerlukan kode negara bagian atau provinsi (misalnya Brasil, AS, Kanada), pastikan bidang negara bagian diisi dengan kode ISO yang benar.
• Order ID diperlukan dan harus unik di seluruh akun Anda, termasuk unggahan sebelumnya — ID yang pernah digunakan sebelumnya (bahkan dalam file musim sebelumnya atau pesanan yang dibatalkan) ditolak saat pembuatan pesanan. Menggunakan kembali file? Tambahkan akhiran ke ID (misalnya ACALB-33 untuk volume 33). ID muncul di layar konfirmasi dan dibawa ke pesanan yang dibuat sebagai referensi pedagang.
• Nama penerima, alamat, kota, negara bagian/provinsi, nama perusahaan, dan nama item harus menggunakan karakter Latin. Skrip non-Latin seperti Jepang atau Arab ditolak.
• Baris yang sepenuhnya kosong diabaikan, sehingga baris kosong di akhir file Anda tidak berpengaruh.

Setiap kolom dalam template standar, sesuai urutan template. Kondisional berarti kolom hanya diperlukan dalam kasus tertentu — lihat Kolom wajib di atas untuk rinciannya.

Japan Post menggunakan template CSV sendiri, diunduh dari halaman unggah dengan cara yang sama. Tidak ada kolom tingkat layanan — unggahan menetapkan tingkat layanan pertama pembawa dan Anda memilih ulang di alur label — dan tidak ada kolom jumlah karton, karena unggahan ini selalu dikirim sebagai satu karton.

Kolom yang bersifat opsional di template standar tetapi wajib untuk Japan Post:

• HS code
• Country of origin
• Item weight — satuan berat tetap opsional di sini dan default ke gram
• Postal code
• State/province
• Shipping amount — tidak seperti template standar, kolom ini tidak boleh dikosongkan

Template juga menambahkan kolom pengiriman Japan Post yang disimpan pada pesanan dan diterapkan pada pengiriman saat label dibuat: Contents Type, Licence Number, Certificate Number, Invoice, Tax Code/VAT Number, Pay Condition, Remarks, Sender's Reference Number, dan Non-commercial. Semuanya opsional. Kolom teks menerima hingga 25 karakter, dan Non-commercial hanya menerima true atau false.

Setelah mengunggah, layar konfirmasi menampilkan rincian landed cost yang dihitung untuk setiap pesanan sebelum apa pun dibuat. Layar menunjukkan:

Baris dapat menampilkan $0 bea cukai, pajak, dan biaya ketika tujuan tidak membebankan biaya impor pada nilai yang dideklarasikan pengiriman (di bawah ambang batas de minimis negara tersebut) — landed cost benar-benar nol, bukan hilang, dan pengiriman adalah satu-satunya biaya untuk pesanan tersebut.

Tombol Buat pesanan menampilkan jumlah pesanan yang akan diajukan (misalnya Buat 17 pesanan). Hanya baris dengan status Siap atau Peringatan yang disertakan — baris dengan kesalahan dikecualikan.

Gunakan Unduh CSV hasil untuk mengekspor rincian penawaran lengkap (tarif terpilih, total item, pengiriman, bea cukai, pajak, biaya, dan total per pesanan) — berguna untuk menawari harga kepada pelanggan sebelum pesanan apa pun dibuat. Klik Mulai lagi untuk membuang unggahan dan memulai segar dengan file yang direvisi.

Ketika Anda membiarkan Shipping Amount kosong, kolom tingkat layanan menampilkan tarif yang sesuai dengan tingkat layanan CSV Anda. Jika tingkat layanan yang diminta tidak tersedia untuk tujuan, tarif terdekat yang tersedia dipilih dan ditandai dengan lencana Tingkat layanan berbeda — atau, ketika ada beberapa alternatif, dropdown Pilih tarif memungkinkan Anda memilih sebelum pesanan dapat dibuat.

Masalah ditandai inline di layar konfirmasi.

Kesalahan 

Baris dengan kesalahan dikecualikan ketika Anda mengklik Buat pesanan. Perbaiki masalah di CSV Anda dan unggah kembali untuk menyertakan baris tersebut. Kesalahan umum meliputi:

• Pesanan bernilai rendah tidak diizinkan — Nilai pesanan di bawah ambang batas minimum untuk toko Anda.
• Kode negara bagian tidak valid — Kode negara bagian atau provinsi tidak valid untuk negara tujuan. Diperlukan untuk negara seperti Brasil, AS, dan Kanada.
• Bidang wajib hilang — Kolom wajib kosong atau tidak dapat diurai.
• ID Pesanan sudah ada — Setiap ID pesanan harus unik di seluruh akun Anda, termasuk pesanan dari unggahan sebelumnya. Baris dengan ID yang sudah digunakan gagal saat pembuatan sementara sisa file berhasil — unggah kembali hanya baris yang gagal dengan ID segar (akhiran seperti -33 berfungsi baik).

Peringatan 

Baris dengan peringatan disertakan dalam pengajuan. Tinjau sebelum mengklik Buat pesanan. Peringatan umum meliputi:

• Tingkat layanan tidak dikonfigurasi — Kode tingkat layanan di CSV Anda tidak terhubung ke akun Anda. Pesanan akan dibuat tetapi mungkin tidak dinilai dengan benar. Verifikasi pengaturan pembawa Anda atau perbarui kode tingkat layanan di CSV Anda.

Batas unggahan saat ini adalah 200 pesanan per CSV. Pesanan diajukan dalam batch hingga 50 per panggilan API — jika unggahan Anda berisi lebih dari 50 pesanan siap, pesanan diproses dalam beberapa batch secara otomatis.

Segera hadir: Pembaruan mendatang akan menghapus batas 200 pesanan dan menambahkan pemrosesan pekerjaan latar belakang untuk unggahan yang lebih besar.