Zonos ile Japan Post My Page API'yi Kullanma

Bu kılavuz, Japan Post My Page Web API ile etiket oluşturmak (işlem ctCode=52) için zaten entegre olan takımlar içindir. ABD'ye gönderilen parseller, artık gümrüğü önceden ödenmiş olması gerektiğinden, etiketi Zonos aracılığıyla oluşturursunuz. Zonos, My Page iş akışının bir uzantısıdır: sizin adınıza My Page Label API'sini (ctCode=52) çağırır, ABD gümrük Beyanname Kimliğini ve DDP işaretlemesini ekler ve My Page etiketini ve takip numarasını size döndürür. Japan Post hala etiketi üretir ve gönderimi Later Pay Number'ınız aracılığıyla faturalandırır.

Kısacası: My Page'de oluşturmaya devam edersiniz ve Zonos, Amerika Birleşik Devletleri'ne gönderilen gönderiler için ABD gümrük katmanını işler.

İlk kez entegre oluyorsanız, Tek bir gönderim oluştur ile başlayın.

Zonos nereye uyuyor? 

ABD'ye gönderilen bir paket için, gönderimi My Page'e doğrudan çağrı yapmak yerine Zonos CreateDeclarationShipment GraphQL iş akışına gönderirsiniz. Bu tek istekte, Zonos:

1. Senin adına Japan Post Label API'sini (ctCode=52) çağırır, Doğrulanan Hesabınızın Later Pay Numbers'ını kullanarak gönderim hala Japan Post hesabınıza faturalandırılır.
2. ABD gümrük Beyanname Kimliğini oluşturur ve bunu takip numarasına bağlar.
3. DDP işaretlemesini etikete ekler.
4. Japan Post etiketini ve takip numarasını size döndürür.

CreateDeclarationShipment yedi adımı zincirler. Zaten bir ctCode=52 isteği için topladığınız veriler, bunlar arasında dağıtılır:

• Gönderici / alıcı → partyCreateWorkflow ORIGIN ve DESTINATION tarafları.
• Öğeler → itemCreateWorkflow (shipmentCartons içindeki satır öğeleri).
• Ambalaj ve ağırlık → cartonsCreateWorkflow.
• Hizmet, işleme ve gümrük bayrakları → shipmentCreateWorkflow.

My Page alanlarınız Zonos'a nasıl eşlenir? 

Her tablo, bir Japan Post My Page ctCode=52 parametresinin Zonos iş akışında nereye gittiğini gösterir. Tam alan ayrıntıları, türleri ve hangi alanların gerekli olduğu için Tek bir gönderim oluştur konusuna bakın.

Hizmet ve işleme → shipmentCreateWorkflow

Gönderici → partyCreateWorkflow (ORIGIN tarafı)

Alıcı → partyCreateWorkflow (DESTINATION tarafı)

Alıcı to_* parametreleri, gönderici alanları ile aynı şekilde DESTINATION tarafıyla eşlenir.

Öğeler → itemCreateWorkflow

Bilmeniz gereken dönüştürmeler 

Genellikle dikkat gereken dönüştürmeler şunlardır:

• Hizmet seviyesi sendType + transType yerine geçer. Bugün iki ayrı parametre olarak göndediğiniz posta hizmetini ve taşımayı eşleştiren tek Zonos japan_post.* hizmet seviyesini seçin.
• Sigortalı değer (declaredValue) JPY, tam yen olmalıdır. Diğer para birimleri veya kesirli yen reddedilecektir.
• Ağırlık Japan Post'a gram cinsinden gönderilir. Karton üzerinde weight + weightUnit sağlayın; Zonos dönüştürür.
• Öğe gümrük açıklamaları 85 yarım genişlik karakteri ile sınırlıdır.
• Tüm adres alanları İngilizce (Roman) karakterlerde olmalıdır.

ABD etiketlerinizi doğrulayın 

Zonos aracılığıyla bir ABD etiketi oluşturduğunuzda, sondan sona çalıştığını doğrulayın:

1. İş akışı bir takip numarası ve etiket döndürür. Yanıtta shipmentCreateWorkflow.trackingDetails.number ve shipmentCartons[].label.url kontrol edin.
2. Bir Beyanname Kimliği oluşturuldu ve bağlandı. Gönderim, Beyanname Kimliği takip numarasına bağlandığında gümrük ödemeli olur — Zonos bunu aynı istekte yapar.
3. DDP etikete yazdırılır. Döndürülen etiketi açın ve DDP işaretlemesinin mevcut olduğunu doğrulayın.
4. Gönderim Zonos Panosu'nda görünür Doğrulanan Hesabınızın altında.
5. Toplu gönderim için, konsolidasyonun kapandığını ve Japan Post gönderim fişini (Kod 61) döndürdüğünü doğrulayın. Toplu gönderim (konsolidasyon) konusuna bakın.
6. Bir My Page etiketiyle karşılaştırın. Aynı gönderimi her iki şekilde oluşturun ve yazdırılan etikette hizmet seviyesi, ağırlık, beyan edilen değer ve öğe ayrıntılarının eşleştiğini doğrulayın.

İlgili 

• Tek bir gönderim oluştur — CreateDeclarationShipment iş akışı için tam alan referansı.
• Toplu gönderim (konsolidasyon) — günün parsellerini bir Japan Post gönderim fişinde birleştir.