Zaten Japan Post My Page API ile etiket mi oluşturuyorsunuz? Entegrasyonunuzu koruyun — gümrük ödemeli ABD etiketleri için Zonos'u ekleyin.
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.
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:
Sizin adınıza 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.
ABD gümrük Beyanname Kimliğini oluşturur ve bunu takip numarasına bağlar.
DDP işaretlemesini etikete ekler.
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ı → partyCreateWorkflowORIGIN 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.
Zonos bunları sizin için işliyor
Japan Post kimlik bilgilerini, işlem kodunu (ctCode, ctId, ctPw), sevkiyat tarihini (sendDate) veya DDP beyanname açıklamalarını göndermeyin. Zonos, My Page'i çağırdığında bunları otomatik olarak ayarlar.
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
My Page parametresi↕
Zonos alanı↕
Notlar↕
sendType + transType
serviceLevel (ve shipmentRatingCreateWorkflow.serviceLevelCode)
Bir Zonos hizmet seviyesi, posta hizmetini ve taşıma modunu kodlar — örn. japan_post.air.parcel. Bir japan_post.* hizmet seviyesi olmalıdır.
pkgType
contentsType
SALE_OF_GOODS, ECOMMERCE_GOODS, COMMERCIAL_GOODS, COMMERCIAL_SAMPLE, RETURNED_GOODS, GIFT, DOCUMENTS veya OTHER.
senderInstruction
nonDelivery.option
RETURN_AFTER_RETENTION, RETURN_IMMEDIATELY, FORWARD veya ABANDON. Zonos, My Page'in tek "return" talimatını iki değere böler.
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.
Zonos aracılığıyla bir ABD etiketi oluşturduğunuzda, sondan sona çalıştığını doğrulayın:
İş akışı bir takip numarası ve etiket döndürür. Yanıtta shipmentCreateWorkflow.trackingDetails.number ve shipmentCartons[].label.url kontrol edin.
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.
DDP etikete yazdırılır. Döndürülen etiketi açın ve DDP işaretlemesinin mevcut olduğunu doğrulayın.
Gönderim Zonos Dashboard'ında görünür Doğrulanan Hesabınızın altında.
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.
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.
Canlı geçmeden önce test edin
Üretim ABD hacmini Zonos aracılığıyla göndermeden önce tam akışı bir test gönderiminde doğrulayın. My Page entegrasyonunuz diğer her şey için yerinde kalır.
My Page API ile Zonos'u Kullanma
Zonos ile Japan Post My Page API'yi Kullanma
Zaten Japan Post My Page API ile etiket mi oluşturuyorsunuz? Entegrasyonunuzu koruyun — gümrük ödemeli ABD etiketleri için Zonos'u ekleyin.
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
CreateDeclarationShipmentGraphQL iş akışına gönderirsiniz. Bu tek istekte, Zonos: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.CreateDeclarationShipmentyedi adımı zincirler. Zaten birctCode=52isteği için topladığınız veriler, bunlar arasında dağıtılır:partyCreateWorkflowORIGINveDESTINATIONtarafları.itemCreateWorkflow(shipmentCartonsiçindeki satır öğeleri).cartonsCreateWorkflow.shipmentCreateWorkflow.Japan Post kimlik bilgilerini, işlem kodunu (
ctCode,ctId,ctPw), sevkiyat tarihini (sendDate) veya DDP beyanname açıklamalarını göndermeyin. Zonos, My Page'i çağırdığında bunları otomatik olarak ayarlar.My Page alanlarınız Zonos'a nasıl eşlenir?
Her tablo, bir Japan Post My Page
ctCode=52parametresinin 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 →
shipmentCreateWorkflowsendType+transTypeserviceLevel(veshipmentRatingCreateWorkflow.serviceLevelCode)japan_post.air.parcel. Birjapan_post.*hizmet seviyesi olmalıdır.pkgTypecontentsTypeSALE_OF_GOODS,ECOMMERCE_GOODS,COMMERCIAL_GOODS,COMMERCIAL_SAMPLE,RETURNED_GOODS,GIFT,DOCUMENTSveyaOTHER.senderInstructionnonDelivery.optionRETURN_AFTER_RETENTION,RETURN_IMMEDIATELY,FORWARDveyaABANDON. Zonos, My Page'in tek "return" talimatını iki değere böler.fw_TransTypenonDelivery.transportMethodAIRveyaMOST_ECONOMICAL.noCmisNonCommercialtrue/false.damgesdeclaredValuetotalWeightcartonsCreateWorkflow.weight+weightUnitGönderici →
partyCreateWorkflow(ORIGINtarafı)from_namperson.firstName+person.lastNamefrom_companyNameperson.companyNamefrom_postallocation.postalCodefrom_add1/from_add2/from_add3location.line1/location.line2/location.localityfrom_preflocation.administrativeAreaCodefrom_telperson.phoneAlıcı →
partyCreateWorkflow(DESTINATIONtarafı)Alıcı
to_*parametreleri, gönderici alanları ile aynı şekildeDESTINATIONtarafıyla eşlenir.to_namperson.firstName+person.lastNameto_companyNameperson.companyNameto_couCdlocation.countryCodeUSveyaPR.to_add1/to_add2/to_add3location.line1/location.line2/location.localitylocation.postalCode/location.administrativeAreaCode/person.phoneÖğeler →
itemCreateWorkflowitem_pkgcustomsDescriptionitem_hsCodehsCodeitem_numquantityitem_weightmeasurements(birim ağırlığı)item_costamountitem_curUnitcurrencyCodeBilmeniz gereken dönüştürmeler
Genellikle dikkat gereken dönüştürmeler şunlardır:
sendType+transTypeyerine geçer. Bugün iki ayrı parametre olarak göndediğiniz posta hizmetini ve taşımayı eşleştiren tek Zonosjapan_post.*hizmet seviyesini seçin.declaredValue) JPY, tam yen olmalıdır. Diğer para birimleri veya kesirli yen reddedilecektir.weight+weightUnitsağlayın; Zonos dönüştürür.ABD etiketlerinizi doğrulayın
Zonos aracılığıyla bir ABD etiketi oluşturduğunuzda, sondan sona çalıştığını doğrulayın:
shipmentCreateWorkflow.trackingDetails.numberveshipmentCartons[].label.urlkontrol edin.Üretim ABD hacmini Zonos aracılığıyla göndermeden önce tam akışı bir test gönderiminde doğrulayın. My Page entegrasyonunuz diğer her şey için yerinde kalır.
İlgili
CreateDeclarationShipmentiş akışı için tam alan referansı.Bu sayfa faydalı mıydı?