Zonos + Japan Post API modeli nasıl çalışır?
Japan Post Verified Account tüccarları doğrudan Zonos'u çağırır. Zonos, Japan Post ile kendi kimlik bilgilerini kullanır ve her etikette Later Pay Number'ınızı içererek postaj ücretleri hesabınıza faturalandırılır.
Tek bir GraphQL isteğinde, Zonos:
- Verified Account'ınızı ve Later Pay Numbers'ınızı doğrular.
- Etiketi ve tracking number'ını oluşturmak için sizin adınıza Japan Post Label API'sini (code 52) çağırır.
- ABD duty prepayment için bir Declaration ID oluşturur.
- Declaration ID'yi
declarationShipmentCreatearacılığıyla tracking number ile bağlar. - Etiketi, tracking number'ını ve shipment kaydını size geri döndürür.
Kendi Japan Post API kimlik bilgilerine (CTID / CT password) ihtiyacınız yoktur. Zonos Verified Account'ınıza bağlı Japan Post Later Pay Numbers'a (後納お客様番号) ihtiyacınız var.
Hangi setup'tasınız?
Herkes etiket ve manifest'i oluşturmak için Zonos'u çağırır, bu nedenle kendi Japan Post kimlik bilgilerinizi (CTID / CT password) hiçbir zaman sağlamazsınız. Setup'a göre değişen şey, geçtiğiniz Zonos API başlıklarıdır — aşağıdaki satırınızı bulun, ardından her flow'un Endpoint and authentication bölümündeki eşleşen sekmesini kullanın.
| ↕ | E-ticaret satıcısı↕ | Shipping platform (BYOA)↕ | 3PL / Lojistik Ortak / Reseller↕ |
|---|---|---|---|
| Siz kimsiniz | Kendi siparişlerinizi gönderen bir marka | Birçok tüccarın etiketi oluşturduğu bir platform | Birçok tüccar müşterisi adına gönderen bir ortak |
| Kurduğunuz Verified Account | Bir Verified Account (kendi hesabınız) | Her tüccar kendi hesabını kurar; siz onun adına gönderiş yaparsınız | Tüm göndericileriniz için kullanılan bir Verified Account |
| Geçilecek Zonos API başlıkları | Sadece credentialToken (sizin) | credentialToken (sizin) + accountKey (her tüccarın) | Sadece credentialToken (sizin) |
| Hangi Later Pay Number postaj ücreti faturalandırılır | Sizin | Her tüccarın | Sizin |
| Zonos kimin görev ücretini faturalandırır | Siz | Her tüccar | Siz |
BYOA (Bring Your Own Account): her tüccar kendi Japan Post Verified Account'ına sahiptir ve platform, platform'un kendi hesabı altında gönderiş yapmak yerine tüccarın account key'ini geçerek bu tüccar adına etiketler oluşturur.
İki API flow'u
Parcelleri nasıl dağıttığınıza bağlı olarak iki entegrasyon deseni vardır.
Tek bir shipment oluşturun
Temel zincir. Tek bir GraphQL isteği bir shipment'ı ham girdilerden (partiler, öğeler, ambalaj) yazdırılabilir bir Japan Post etikete kadar alır. Siparişler gelir gelmez parcelleri bireysel olarak gönderiyorsanız bunu kullanın.
Batch dispatch (konsolidasyon)
Ertelenen ödeme batch flow'u. Sabah bir konsolidasyonu açın, gün boyunca tek-shipment zincirini kullanarak shipment'ları ona ekleyin, ardından gün sonunda tüm batch'i kapsayan bir Japan Post dispatch slip'i almak için konsolidasyonu kapatın. Parça-parça yerine gün sonunda tek bir işlemde Japan Post postajını kapatıyorsanız bunu kullanın.
Zaten Japan Post My Page API'sini kullanıyorsanız?
Şu anda Japan Post My Page API'si (ctCode=52) ile etiketler oluşturuyorsanız, bu entegrasyonu tutabilir ve duty-prepaid ABD etiketleri için Zonos ekleyebilirsiniz. Alan-alana eşleme ve bir doğrulama kontrol listesi için My Page API ile Zonos'u kullanma bölümüne bakınız.
API aracılığıyla etiket oluşturun
Duty-prepaid Japan Post etiketleri oluşturmak için fulfillment sisteminizi Zonos GraphQL API ile entegre edin.
Bu bölüm, Verified Accounts kullanacak programlı bir Japan Post etiket workflow'u oluşturan mühendislik ekipleri içindir. Geliştirme kaynakları olmayan küçük veya orta ölçekli bir gönderenci iseniz, bunun yerine Dashboard'da etiket oluşturun bölümüne bakınız.