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.
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 ke seluruh langkah tersebut:
Pengirim / penerima → pihak partyCreateWorkflowORIGIN dan DESTINATION.
Item → itemCreateWorkflow (item baris di dalam shipmentCartons).
Kemasan dan berat → cartonsCreateWorkflow.
Layanan, penanganan, dan bendera bea cukai → shipmentCreateWorkflow.
Zonos menangani ini untuk Anda
Anda tidak mengirim kredensial Japan Post atau kode operasi (ctCode, ctId, ctPw), tanggal pengiriman (sendDate), atau keterangan deklarasi DDP. Zonos menetapkan ini secara otomatis ketika ia memanggil My Page.
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.
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, ECOMMERCE_GOODS, COMMERCIAL_GOODS, COMMERCIAL_SAMPLE, RETURNED_GOODS, GIFT, DOCUMENTS, atau OTHER.
senderInstruction
nonDelivery.option
RETURN_AFTER_RETENTION, RETURN_IMMEDIATELY, FORWARD, atau ABANDON. Zonos membagi instruksi "return" tunggal My Page menjadi dua nilai.
Ini adalah transformasi yang paling sering memerlukan perhatian:
Tingkat layanan menggantikan sendType + transType. Pilih tingkat layanan Zonos japan_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 + weightUnit pada karton; Zonos mengonversi.
Deskripsi bea cukai item dibatasi hingga 85 karakter lebar setengah.
Semua bidang alamat harus dalam karakter bahasa Inggris (Romawi).
Ketika Anda membuat label A.S. melalui Zonos, konfirmasikan bahwa prosesnya berjalan dari ujung ke ujung:
Alur kerja mengembalikan nomor pelacakan dan label. Periksa shipmentCreateWorkflow.trackingDetails.number dan shipmentCartons[].label.url dalam 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.
Uji sebelum Anda go-live
Validasi alur kerja lengkap pada pengiriman uji sebelum mengirim volume A.S. produksi melalui Zonos. Integrasi My Page Anda tetap berlaku untuk semua hal lainnya.
Menggunakan Zonos dengan My Page API
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.
Bagaimana Zonos berperan
Untuk paket tujuan A.S., Anda mengirimkan pengiriman ke alur kerja
CreateDeclarationShipmentGraphQL Zonos daripada memanggil My Page secara langsung. Dalam permintaan tunggal itu, Zonos:ctCode=52) atas nama Anda, menggunakan Nomor Pembayaran Kemudian Akun Terverifikasi Anda sehingga postage masih ditagihkan ke akun Japan Post Anda.CreateDeclarationShipmentmerantai tujuh langkah. Data yang sama yang sudah Anda kumpulkan untuk permintaanctCode=52didistribusikan ke seluruh langkah tersebut:partyCreateWorkflowORIGINdanDESTINATION.itemCreateWorkflow(item baris di dalamshipmentCartons).cartonsCreateWorkflow.shipmentCreateWorkflow.Anda tidak mengirim kredensial Japan Post atau kode operasi (
ctCode,ctId,ctPw), tanggal pengiriman (sendDate), atau keterangan deklarasi DDP. Zonos menetapkan ini secara otomatis ketika ia memanggil My Page.Cara bidang My Page Anda memetakan ke Zonos
Setiap tabel menunjukkan ke mana parameter Japan Post My Page
ctCode=52pergi dalam alur kerja Zonos. Untuk detail bidang lengkap, tipe, dan bidang mana yang diperlukan, lihat Buat satu pengiriman.Layanan dan penanganan →
shipmentCreateWorkflowsendType+transTypeserviceLevel(danshipmentRatingCreateWorkflow.serviceLevelCode)japan_post.air.parcel. Harus berupa tingkat layananjapan_post.*.pkgTypecontentsTypeSALE_OF_GOODS,ECOMMERCE_GOODS,COMMERCIAL_GOODS,COMMERCIAL_SAMPLE,RETURNED_GOODS,GIFT,DOCUMENTS, atauOTHER.senderInstructionnonDelivery.optionRETURN_AFTER_RETENTION,RETURN_IMMEDIATELY,FORWARD, atauABANDON. Zonos membagi instruksi "return" tunggal My Page menjadi dua nilai.fw_TransTypenonDelivery.transportMethodAIRatauMOST_ECONOMICAL.noCmisNonCommercialtrue/false.damgesdeclaredValuetotalWeightcartonsCreateWorkflow.weight+weightUnitPengirim →
partyCreateWorkflow(pihakORIGIN)from_namperson.firstName+person.lastNamefrom_companyNameperson.companyNamefrom_postallocation.postalCodefrom_add1/from_add2/from_add3location.line1/location.line2/location.localityfrom_preflocation.administrativeAreaCodefrom_telperson.phonePenerima →
partyCreateWorkflow(pihakDESTINATION)Parameter penerima
to_*memetakan ke pihakDESTINATIONdengan cara yang sama seperti bidang pengirim.to_namperson.firstName+person.lastNameto_companyNameperson.companyNameto_couCdlocation.countryCodeUSatauPR.to_add1/to_add2/to_add3location.line1/location.line2/location.localitylocation.postalCode/location.administrativeAreaCode/person.phoneItem →
itemCreateWorkflowitem_pkgcustomsDescriptionitem_hsCodehsCodeitem_numquantityitem_weightmeasurements(berat per unit)item_costamountitem_curUnitcurrencyCodeKonversi yang perlu diketahui
Ini adalah transformasi yang paling sering memerlukan perhatian:
sendType+transType. Pilih tingkat layanan Zonosjapan_post.*tunggal yang cocok dengan layanan surat dan transportasi yang Anda kirim hari ini sebagai dua parameter terpisah.declaredValue) harus JPY, seluruh yen. Mata uang lain atau yen fraksional akan ditolak.weight+weightUnitpada karton; Zonos mengonversi.Verifikasi label A.S. Anda
Ketika Anda membuat label A.S. melalui Zonos, konfirmasikan bahwa prosesnya berjalan dari ujung ke ujung:
shipmentCreateWorkflow.trackingDetails.numberdanshipmentCartons[].label.urldalam respons.Validasi alur kerja lengkap pada pengiriman uji sebelum mengirim volume A.S. produksi melalui Zonos. Integrasi My Page Anda tetap berlaku untuk semua hal lainnya.
Terkait
CreateDeclarationShipment.Apakah halaman ini bermanfaat?