Cara model API Zonos + Japan Post bekerja
Pedagang Japan Post Verified Account menghubungi Zonos secara langsung. Zonos menggunakan kredensial sendiri dengan Japan Post dan menyertakan Nomor Pembayaran Kemudian Anda pada setiap label sehingga porto ditagihkan ke akun Anda.
Dalam satu permintaan GraphQL, Zonos:
- Memvalidasi Akun Terverifikasi Anda dan Nomor Pembayaran Kemudian.
- Memanggil Japan Post Label API (kode 52) atas nama Anda untuk menghasilkan label dan nomor pelacakan.
- Membuat ID Deklarasi untuk prabayar bea cukai A.S.
- Menautkan ID Deklarasi ke nomor pelacakan melalui
declarationShipmentCreate. - Mengembalikan label, nomor pelacakan, dan catatan pengiriman kepada Anda.
Anda tidak memerlukan kredensial Japan Post API sendiri (CTID / sandi CT). Anda memerlukan Nomor Pembayaran Kemudian Japan Post Anda (後納お客様番号) yang terhubung ke Akun Terverifikasi Zonos Anda.
Setup mana yang Anda?
Semua orang memanggil Zonos untuk membuat label dan manifest, jadi Anda tidak perlu memberikan kredensial Japan Post sendiri (CTID / sandi CT). Apa yang berubah menurut setup adalah header API Zonos mana yang Anda lewatkan — temukan baris Anda di bawah, kemudian gunakan tab yang cocok di bagian Endpoint dan autentikasi setiap alur.
| ↕ | Pedagang ecommerce↕ | Platform pengiriman (BYOA)↕ | 3PL / Logistic Partner / Reseller↕ |
|---|---|---|---|
| Siapa Anda | Merek yang mengirim pesanan Anda sendiri | Platform banyak pedagang yang membuat label melaluinya | Mitra yang mengirim atas nama banyak klien pedagang |
| Akun Terverifikasi yang Anda siapkan | Satu Akun Terverifikasi (milik Anda sendiri) | Setiap pedagang menyiapkan milik mereka sendiri; Anda mengirim atas nama mereka | Satu Akun Terverifikasi digunakan untuk semua pengirim Anda |
| Header API Zonos untuk dilewatkan | credentialToken (milik Anda) hanya | credentialToken (milik Anda) + accountKey (setiap pedagang) | credentialToken (milik Anda) hanya |
| Nomor Pembayaran Kemudian siapa yang ditagihkan postage | Milik Anda | Setiap pedagang | Milik Anda |
| Siapa yang Zonos tagihkan untuk bea cukai | Anda | Setiap pedagang | Anda |
BYOA (Bawa Akun Anda Sendiri): setiap pedagang memegang Akun Terverifikasi Japan Post mereka sendiri, dan platform membuat label atas nama pedagang itu dengan melewatkan kunci akun pedagang, daripada mengirim di bawah akun platform Anda sendiri.
Dua alur API
Ada dua pola integrasi tergantung pada cara Anda mengirim paket.
Buat satu pengiriman
Rantai fundamental. Satu permintaan GraphQL membawa pengiriman dari input mentah (pihak, item, kemasan) semuanya melalui ke label Japan Post yang dapat dicetak. Gunakan ini jika Anda mengirim paket secara individual saat pesanan masuk.
Pengiriman batch (konsolidasi)
Alur batch pembayaran tertunda. Buka konsolidasi di pagi hari, lampirkan pengiriman ke dalamnya di seluruh hari menggunakan rantai pengiriman tunggal, kemudian tutup konsolidasi di akhir hari untuk mendapatkan satu slip pengiriman Japan Post yang mencakup seluruh batch. Gunakan ini jika Anda menyelesaikan postage Japan Post dalam satu transaksi di akhir hari daripada paket demi paket.
Sudah menggunakan Japan Post My Page API?
Jika Anda saat ini membuat label dengan Japan Post My Page API (ctCode=52), Anda dapat mempertahankan integrasi itu dan menambahkan Zonos untuk label A.S. dengan bea cukai prabayar. Lihat Menggunakan Zonos dengan My Page API untuk pemetaan bidang demi bidang dan daftar periksa verifikasi.
Buat label melalui API
Integrasikan sistem pemenuhan Anda dengan GraphQL API Zonos untuk membuat label Japan Post dengan bea cukai prabayar.
Bagian ini untuk tim teknik yang membangun alur kerja label Japan Post terprogram yang akan menggunakan Akun Terverifikasi. Jika Anda adalah pengirim kecil atau menengah tanpa sumber daya pengembangan, lihat Buat label di Dashboard sebagai gantinya.