Bagaimana Zonos cocok
Untuk paket tujuan A.S., Anda mengirimkan pengiriman ke alur kerja CreateDeclarationShipment GraphQL Zonos daripada memanggil My Page secara langsung. Dalam permintaan tunggal itu, Zonos:
- Memanggil Japan Post Label API (
ctCode=52) atas nama Anda, menggunakan Nomor Pembayaran Kemudian Akun Terverifikasi Anda sehingga postage masih ditagihkan ke akun Japan Post Anda. - Membuat ID Deklarasi bea cukai A.S. dan menautkannya ke nomor pelacakan.
- Menambahkan penandaan DDP ke label.
- Mengembalikan label Japan Post dan nomor pelacakan kepada Anda.
CreateDeclarationShipment merantai tujuh langkah. Data yang sama yang sudah Anda kumpulkan untuk permintaan ctCode=52 didistribusikan di seluruh mereka:
- Pengirim / penerima → pihak
partyCreateWorkflowORIGINdanDESTINATION. - Item →
itemCreateWorkflow(item baris di dalamshipmentCartons). - Kemasan dan berat →
cartonsCreateWorkflow. - Layanan, penanganan, dan bendera bea cukai →
shipmentCreateWorkflow.
Cara bidang My Page Anda memetakan ke Zonos
Setiap tabel menunjukkan ke mana parameter Japan Post My Page ctCode=52 pergi dalam alur kerja Zonos. Untuk detail bidang lengkap, tipe, dan bidang mana yang diperlukan, lihat Buat satu pengiriman.
Layanan dan penanganan → shipmentCreateWorkflow
| Parameter My Page↕ | Bidang Zonos↕ | Catatan↕ |
|---|---|---|
sendType + transType | serviceLevel (dan shipmentRatingCreateWorkflow.serviceLevelCode) | Satu tingkat layanan Zonos mengkodekan baik layanan surat maupun mode transportasi — misalnya japan_post.air.parcel. Harus berupa tingkat layanan japan_post.*. |
pkgType | contentsType | SALE_OF_GOODS, GIFT, DOCUMENTS, SAMPLE, dll. |
senderInstruction | nonDelivery.option | RETURN, ABANDON, atau FORWARD. |
fw_TransType | nonDelivery.transportMethod | AIR atau MOST_ECONOMICAL. |
noCm | isNonCommercial | true / false. |
damges | declaredValue | Nilai asuransi. Harus dalam JPY, seluruh yen. |
totalWeight | cartonsCreateWorkflow.weight + weightUnit | Dikirim ke Japan Post dalam gram. |
Pengirim → partyCreateWorkflow (pihak ORIGIN)
| Parameter My Page↕ | Bidang Zonos↕ | Catatan↕ |
|---|---|---|
from_nam | person.firstName + person.lastName | |
from_companyName | person.companyName | |
from_postal | location.postalCode | |
from_add1 / from_add2 / from_add3 | location.line1 / location.line2 / location.locality | |
from_pref | location.administrativeAreaCode | Prefektur. |
from_tel | person.phone |
Penerima → partyCreateWorkflow (pihak DESTINATION)
Parameter penerima to_* memetakan ke pihak DESTINATION dengan cara yang sama seperti bidang pengirim.
| Parameter My Page↕ | Bidang Zonos↕ | Catatan↕ |
|---|---|---|
to_nam | person.firstName + person.lastName | |
to_companyName | person.companyName | |
to_couCd | location.countryCode | US atau PR. |
to_add1 / to_add2 / to_add3 | location.line1 / location.line2 / location.locality | |
| Kode pos / negara bagian / telepon | location.postalCode / location.administrativeAreaCode / person.phone |
Item → itemCreateWorkflow
| Parameter My Page↕ | Bidang Zonos↕ | Catatan↕ |
|---|---|---|
item_pkg | customsDescription | Deskripsi bea cukai item. Karakter lebar setengah, maks 85 karakter. |
item_hsCode | hsCode | |
item_num | quantity | |
item_weight | measurements (berat per unit) | |
item_cost | amount | Harga unit. |
item_curUnit | currencyCode |
Konversi yang perlu diketahui
Ini adalah transformasi yang paling sering memerlukan perhatian:
- Tingkat layanan menggantikan
sendType+transType. Pilih tingkat layanan Zonosjapan_post.*tunggal yang cocok dengan layanan surat dan transportasi yang Anda kirim hari ini sebagai dua parameter terpisah. - Nilai asuransi (
declaredValue) harus JPY, seluruh yen. Mata uang lain atau yen fraksional akan ditolak. - Berat dikirim ke Japan Post dalam gram. Berikan
weight+weightUnitpada karton; Zonos mengonversi. - Deskripsi bea cukai item dibatasi hingga 85 karakter lebar setengah.
- Semua bidang alamat harus dalam karakter bahasa Inggris (Romawi).
Verifikasi label A.S. Anda
Ketika Anda membuat label A.S. melalui Zonos, konfirmasikan bekerja dari ujung ke ujung:
- Alur kerja mengembalikan nomor pelacakan dan label. Periksa
shipmentCreateWorkflow.trackingDetails.numberdanshipmentCartons[].label.urldalam respons. - ID Deklarasi dibuat dan ditautkan. Pengiriman dibayar di muka hanya ketika ID Deklarasi ditautkan ke nomor pelacakan — Zonos melakukan ini dalam permintaan yang sama.
- DDP dicetak pada label. Buka label yang dikembalikan dan konfirmasikan penandaan DDP ada.
- Pengiriman muncul di Zonos Dashboard Anda di bawah Akun Terverifikasi Anda.
- Untuk pengiriman batch, konfirmasikan konsolidasi ditutup dan mengembalikan slip pengiriman Japan Post (Kode 61). Lihat Pengiriman batch (konsolidasi).
- Bandingkan dengan label My Page. Buat pengiriman yang sama dengan kedua cara dan konfirmasikan tingkat layanan, berat, nilai deklarasi, dan detail item cocok pada label yang dicetak.
Terkait
- Buat satu pengiriman — referensi bidang lengkap untuk alur kerja
CreateDeclarationShipment. - Pengiriman batch (konsolidasi) — bundel paket hari itu ke dalam satu slip pengiriman Japan Post.
Menggunakan Zonos dengan Japan Post My Page API
Sudah membuat label dengan Japan Post My Page API? Pertahankan integrasi Anda — tambahkan Zonos untuk label A.S. dengan bea cukai prabayar.
Panduan ini untuk tim yang sudah mengintegrasikan dengan Japan Post My Page Web API untuk membuat label (operasi
ctCode=52). Untuk paket tujuan A.S., yang sekarang memerlukan bea cukai dibayar di muka, Anda membuat label melalui Zonos. Zonos adalah perpanjangan dari alur kerja My Page: ia memanggil Japan Post Label API (ctCode=52) atas nama Anda, menambahkan ID Deklarasi bea cukai A.S. dan penandaan DDP, dan mengembalikan label My Page dan nomor pelacakan kepada Anda. Japan Post masih menghasilkan label dan menagihkan postage Anda melalui Nomor Pembayaran Kemudian Anda.Singkatnya: Anda terus membangun di My Page, dan Zonos menangani lapisan bea cukai A.S. untuk pengiriman tujuan Amerika Serikat.
Jika Anda mengintegrasikan untuk pertama kali, mulai dengan Buat satu pengiriman.