Đã tạo nhãn với Japan Post My Page API? Giữ tích hợp của bạn — thêm Zonos cho nhãn U.S. có trả trước thuế quan.
Hướng dẫn này dành cho các đội đã tích hợp với Japan Post My Page Web API để tạo nhãn (hoạt động ctCode=52). Đối với các gói được gửi đến U.S., hiện đòi hỏi phải trả trước thuế quan, bạn tạo nhãn thông qua Zonos. Zonos là một phần mở rộng của quy trình My Page: nó gọi My Page Label API (ctCode=52) thay mặt bạn, thêm U.S. duty Declaration ID và đánh dấu DDP, và trả lại nhãn My Page cùng số theo dõi cho bạn. Japan Post vẫn tạo nhãn và tính phí gửi bạn thông qua Later Pay Number của bạn.
Tóm lại: bạn tiếp tục xây dựng trên My Page, và Zonos xử lý lớp thuế quan U.S. cho các lô hàng được gửi đến Hoa Kỳ.
Đối với một gói được gửi đến U.S., bạn gửi lô hàng đến quy trình Zonos CreateDeclarationShipment GraphQL thay vì gọi My Page trực tiếp. Trong một yêu cầu duy nhất, Zonos:
Gọi Japan Post Label API (ctCode=52) thay mặt bạn, sử dụng Later Pay Numbers của Verified Account để phí vận chuyển vẫn được tính vào tài khoản Japan Post của bạn.
Tạo U.S. duty Declaration ID và liên kết nó với số theo dõi.
Thêm đánh dấu DDP vào nhãn.
Trả lại nhãn Japan Post cùng số theo dõi cho bạn.
CreateDeclarationShipment kết nối bảy bước. Dữ liệu tương tự mà bạn đã lắp ráp cho yêu cầu ctCode=52 được phân phối trên các bước:
Người gửi / người nhận → các bên ORIGIN và DESTINATION của partyCreateWorkflow.
Các mục → itemCreateWorkflow (các mục dòng bên trong shipmentCartons).
Đóng gói và trọng lượng → cartonsCreateWorkflow.
Dịch vụ, xử lý và cờ tùy chỉnh → shipmentCreateWorkflow.
Zonos xử lý những cái này cho bạn
Bạn không gửi thông tin đăng nhập Japan Post hoặc mã hoạt động (ctCode, ctId, ctPw), ngày gửi (sendDate), hoặc ghi chú khai báo DDP. Zonos đặt những cái này tự động khi gọi My Page.
Mỗi bảng hiển thị nơi tham số ctCode=52 của Japan Post My Page đi vào quy trình Zonos. Để biết đầy đủ chi tiết trường, loại và những trường nào là bắt buộc, hãy xem Tạo một lô hàng duy nhất.
Mức dịch vụ thay thế sendType + transType. Chọn mức dịch vụ Zonos japan_post.* duy nhất khớp với dịch vụ bưu điện và vận chuyển bạn gửi hôm nay dưới dạng hai tham số riêng biệt.
Giá trị bảo hiểm (declaredValue) phải tính bằng JPY, yen nguyên. Các tiền tệ khác hoặc yen phân số sẽ bị từ chối.
Trọng lượng được gửi tới Japan Post tính bằng grams. Cung cấp weight + weightUnit trên thùng; Zonos chuyển đổi.
Mô tả hải quan của mục bị giới hạn ở 85 ký tự nửa chiều.
Tất cả các trường địa chỉ phải bằng ký tự tiếng Anh (chữ La Mã).
Khi bạn tạo nhãn U.S. thông qua Zonos, hãy xác nhận nó hoạt động từ đầu đến cuối:
Quy trình trả về một số theo dõi và nhãn. Kiểm tra shipmentCreateWorkflow.trackingDetails.number và shipmentCartons[].label.url trong phản hồi.
Declaration ID được tạo và liên kết. Lô hàng chỉ được trả trước thuế quan khi Declaration ID được liên kết với số theo dõi — Zonos thực hiện việc này bên trong cùng một yêu cầu.
DDP được in trên nhãn. Mở nhãn được trả về và xác nhận đánh dấu DDP có mặt.
Lô hàng xuất hiện trong Dashboard Zonos của bạn dưới Verified Account của bạn.
Để gửi hàng loạt, xác nhận việc hợp nhất đóng lại và trả lại phiếu gửi Japan Post (Mã 61). Xem Gửi hàng loạt (hợp nhất).
So sánh với nhãn My Page. Tạo cùng một lô hàng theo cả hai cách và xác nhận mức dịch vụ, trọng lượng, giá trị khai báo và chi tiết mục khớp trên nhãn in.
Kiểm tra trước khi bạn hoạt động
Xác nhận toàn bộ luồng trên một lô hàng thử nghiệm trước khi gửi khối lượng U.S. sản xuất thông qua Zonos. Tích hợp My Page của bạn vẫn hoạt động cho tất cả những thứ khác.
Sử dụng Zonos với My Page API
Sử dụng Zonos với Japan Post My Page API
Đã tạo nhãn với Japan Post My Page API? Giữ tích hợp của bạn — thêm Zonos cho nhãn U.S. có trả trước thuế quan.
Hướng dẫn này dành cho các đội đã tích hợp với Japan Post My Page Web API để tạo nhãn (hoạt động
ctCode=52). Đối với các gói được gửi đến U.S., hiện đòi hỏi phải trả trước thuế quan, bạn tạo nhãn thông qua Zonos. Zonos là một phần mở rộng của quy trình My Page: nó gọi My Page Label API (ctCode=52) thay mặt bạn, thêm U.S. duty Declaration ID và đánh dấu DDP, và trả lại nhãn My Page cùng số theo dõi cho bạn. Japan Post vẫn tạo nhãn và tính phí gửi bạn thông qua Later Pay Number của bạn.Tóm lại: bạn tiếp tục xây dựng trên My Page, và Zonos xử lý lớp thuế quan U.S. cho các lô hàng được gửi đến Hoa Kỳ.
Nếu bạn đang tích hợp lần đầu, hãy bắt đầu với Tạo một lô hàng duy nhất.
Zonos phù hợp như thế nào
Đối với một gói được gửi đến U.S., bạn gửi lô hàng đến quy trình Zonos
CreateDeclarationShipmentGraphQL thay vì gọi My Page trực tiếp. Trong một yêu cầu duy nhất, Zonos:ctCode=52) thay mặt bạn, sử dụng Later Pay Numbers của Verified Account để phí vận chuyển vẫn được tính vào tài khoản Japan Post của bạn.CreateDeclarationShipmentkết nối bảy bước. Dữ liệu tương tự mà bạn đã lắp ráp cho yêu cầuctCode=52được phân phối trên các bước:ORIGINvàDESTINATIONcủapartyCreateWorkflow.itemCreateWorkflow(các mục dòng bên trongshipmentCartons).cartonsCreateWorkflow.shipmentCreateWorkflow.Bạn không gửi thông tin đăng nhập Japan Post hoặc mã hoạt động (
ctCode,ctId,ctPw), ngày gửi (sendDate), hoặc ghi chú khai báo DDP. Zonos đặt những cái này tự động khi gọi My Page.Các trường My Page của bạn ánh xạ tới Zonos như thế nào
Mỗi bảng hiển thị nơi tham số
ctCode=52của Japan Post My Page đi vào quy trình Zonos. Để biết đầy đủ chi tiết trường, loại và những trường nào là bắt buộc, hãy xem Tạo một lô hàng duy nhất.Dịch vụ và xử lý →
shipmentCreateWorkflowsendType+transTypeserviceLevel(vàshipmentRatingCreateWorkflow.serviceLevelCode)japan_post.air.parcel. Phải là mức dịch vụjapan_post.*.pkgTypecontentsTypeSALE_OF_GOODS,ECOMMERCE_GOODS,COMMERCIAL_GOODS,COMMERCIAL_SAMPLE,RETURNED_GOODS,GIFT,DOCUMENTS, hoặcOTHER.senderInstructionnonDelivery.optionRETURN_AFTER_RETENTION,RETURN_IMMEDIATELY,FORWARD, hoặcABANDON. Zonos tách chỉ dẫn "trả lại" duy nhất của My Page thành hai giá trị.fw_TransTypenonDelivery.transportMethodAIRhoặcMOST_ECONOMICAL. Áp dụng cho hai tùy chọnRETURN_*.noCmisNonCommercialtrue/false.damgesdeclaredValuetotalWeightcartonsCreateWorkflow.weight+weightUnitNgười gửi →
partyCreateWorkflow(bênORIGIN)from_namperson.firstName+person.lastNamefrom_companyNameperson.companyNamefrom_postallocation.postalCodefrom_add1/from_add2/from_add3location.line1/location.line2/location.localityfrom_preflocation.administrativeAreaCodefrom_telperson.phoneNgười nhận →
partyCreateWorkflow(bênDESTINATION)Các tham số
to_*của người nhận ánh xạ tới bênDESTINATIONtheo cách tương tự như các trường người gửi.to_namperson.firstName+person.lastNameto_companyNameperson.companyNameto_couCdlocation.countryCodeUShoặcPR.to_add1/to_add2/to_add3location.line1/location.line2/location.localitylocation.postalCode/location.administrativeAreaCode/person.phoneCác mục →
itemCreateWorkflowitem_pkgcustomsDescriptionitem_hsCodehsCodeitem_numquantityitem_weightmeasurements(trọng lượng trên mỗi đơn vị)item_costamountitem_curUnitcurrencyCodeChuyển đổi để biết
Đây là những chuyển đổi thường cần chú ý:
sendType+transType. Chọn mức dịch vụ Zonosjapan_post.*duy nhất khớp với dịch vụ bưu điện và vận chuyển bạn gửi hôm nay dưới dạng hai tham số riêng biệt.declaredValue) phải tính bằng JPY, yen nguyên. Các tiền tệ khác hoặc yen phân số sẽ bị từ chối.weight+weightUnittrên thùng; Zonos chuyển đổi.Xác minh nhãn U.S. của bạn
Khi bạn tạo nhãn U.S. thông qua Zonos, hãy xác nhận nó hoạt động từ đầu đến cuối:
shipmentCreateWorkflow.trackingDetails.numbervàshipmentCartons[].label.urltrong phản hồi.Xác nhận toàn bộ luồng trên một lô hàng thử nghiệm trước khi gửi khối lượng U.S. sản xuất thông qua Zonos. Tích hợp My Page của bạn vẫn hoạt động cho tất cả những thứ khác.
Liên quan
CreateDeclarationShipment.Trang này có hữu ích không?