Cara mengunggah pesanan
- Buka Dashboard -> Orders -> Manage -> Unggah pesanan.
- Unduh template CSV dari halaman unggah dan isinya dengan data pesanan Anda.
- Unggah CSV yang sudah selesai.
- Tinjau layar konfirmasi — biaya darat dihitung per baris dan kesalahan atau peringatan apa pun ditampilkan inline.
- Klik Buat pesanan untuk mengirimkan semua pesanan Siap.
Format CSV
Unduh template CSV langsung dari halaman unggah di Dashboard. Template mencakup semua kolom wajib dan opsional — kolom wajib ditandai dengan asterisk (*) di baris header.
Kolom wajib
Setiap baris mewakili satu pesanan. Informasi wajib untuk setiap baris terbagi dalam tiga kategori:
Penerima — Nama, email, nomor telepon, dan alamat pengiriman penerima, termasuk negara tujuan. 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, jumlah, dan harga. 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.
| Negara / Wilayah↕ | Kode↕ | ID Pajak↕ |
|---|---|---|
| Argentina | CUIL | CUIL atau CUIT |
| Argentina/Spanyol/Peru | DNI | Nomor identitas/pajak nasional |
| Australia | OSR | Pendaftaran GST AUSid |
| Australia/Selandia Baru | LVG | Pemasok terdaftar luar negeri (barang bernilai rendah) |
| Brasil | CNP | CNPJ (ID pajak federal bisnis) |
| Brasil | CPF | CPF (register pembayar pajak individu) |
| Kanada | GST | Nomor pendaftaran GST/HST |
| Chili | RUN | Rol Único Tributario (RUT/RUN) |
| Uni Eropa | EU_EORI | Nomor EU EORI |
| Uni Eropa | IOSS | Nomor Import One-Stop Shop |
| Prancis | FTPC | PPN bea cukai Prancis (bernilai rendah) |
| India | PAN | Nomor Akun Permanen |
| Indonesia | NPWP | Nomor identifikasi pajak |
| Meksiko | RFC | Registro Federal de Contribuyentes |
| Meksiko | CURP | CURP (individu) |
| Norwegia | VOEC | Nomor skema PPN pada E-Commerce |
| Norwegia | VOEC_NO | Nomor PPN Norwegia |
| Arab Saudi | SA_VAT | Nomor PPN Saudi |
| Afrika Selatan | TRN | Nomor referensi pajak |
| Korea Selatan | PCC | Kode kepabeanan pribadi |
| Uni Emirat Arab | UAE_TRN | Nomor pendaftaran pajak |
| Inggris | GB_EORI | Nomor UK EORI |
| Inggris | HMRC | Pendaftaran PPN UK (penjual asing) |
| Amerika Serikat | EIN | Nomor Identifikasi Pemberi Kerja |
| Amerika Serikat | SSN | Nomor Jaminan Sosial |
| Amerika Serikat | STA | ID pajak negara bagian |
| Negara mana pun | EORI | ID pendaftaran operator ekonomi |
| Negara lain mana pun | TIN | Nomor identifikasi pajak umum |
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 menggunakanUSdan 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 pencodeannya — 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 IDdiperlukan 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 (misalnyaACALB-33untuk volume 33). ID muncul di layar konfirmasi dan dibawa ke pesanan yang dibuat sebagai referensi pedagang.
Tinjau layar konfirmasi
Setelah mengunggah, layar konfirmasi menampilkan rincian biaya darat yang dihitung untuk setiap pesanan sebelum apa pun dibuat. Layar menunjukkan:
| Kolom↕ | Deskripsi↕ |
|---|---|
| ID Pesanan | ID referensi dari CSV Anda. |
| Item | Nama item dan jumlah. |
| Penerima | Nama penerima. |
| Negara | Negara tujuan. |
| Bea cukai dibayar oleh | Apakah penawaran yang dipilih adalah DDP (Anda membayar bea cukai dan pajak) atau DDU (penerima membayar saat pengiriman, ditampilkan dengan lencana oranye). |
| Tingkat layanan | Tingkat layanan pengiriman yang digunakan untuk penilaian. |
| Total item | Nilai item yang dideklarasikan. |
| Pengiriman | Biaya pengiriman yang dihitung. |
| Bea cukai | Bea cukai yang dihitung. |
| Pajak | Pajak yang dihitung. |
| Biaya | Biaya Zonos. |
| Total LC | Total biaya darat (bea cukai + pajak + biaya). |
| Total keseluruhan | Total termasuk nilai item dan biaya darat. |
| Status | Siap, Peringatan, atau Kesalahan. |
Baris dapat menampilkan $0 bea cukai, pajak, dan biaya ketika tujuan tidak membebankan biaya impor pada nilai yang dideklarasikan pengiriman (di bawah ambang batas minimum negara) — biaya darat benar-benar nol, bukan hilang, dan pengiriman adalah satu-satunya biaya untuk pesanan tersebut.
Tombol Buat pesanan menampilkan jumlah pesanan yang akan dikirimkan (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.
Kesalahan dan peringatan
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
-33berfungsi baik).
Peringatan
Baris dengan peringatan disertakan dalam pengiriman. 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 dan pemrosesan batch
Batas unggahan saat ini adalah 200 pesanan per CSV. Pesanan dikirimkan 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.
Unggah pesanan secara massal
Buat hingga 200 pesanan sekaligus dengan mengunggah file CSV.Daripada membuat pesanan satu per satu, Anda dapat mengunggah file CSV untuk membuat pesanan secara massal langsung dari Dashboard. Ini adalah opsi yang baik ketika Anda perlu memproses sejumlah besar pengiriman sekaligus. Biaya darat dihitung secara real-time untuk setiap baris dan ditampilkan di layar konfirmasi sebelum pesanan apa pun dikirimkan, sehingga Anda dapat meninjau rincian biaya lengkap di seluruh batch sebelum berkomitmen.