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 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
ORIGINvàDESTINATIONcủapartyCreateWorkflow. - Các mục →
itemCreateWorkflow(các mục dòng bên trongshipmentCartons). - Đóng gói và trọng lượng →
cartonsCreateWorkflow. - Dịch vụ, xử lý và cờ tùy chỉnh →
shipmentCreateWorkflow.
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=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.
Dịch vụ và xử lý → shipmentCreateWorkflow
| Tham số My Page↕ | Trường Zonos↕ | Ghi chú↕ |
|---|---|---|
sendType + transType | serviceLevel (và shipmentRatingCreateWorkflow.serviceLevelCode) | Một mức dịch vụ Zonos mã hóa cả dịch vụ bưu điện và chế độ vận chuyển — ví dụ: japan_post.air.parcel. Phải là mức dịch vụ japan_post.*. |
pkgType | contentsType | SALE_OF_GOODS, GIFT, DOCUMENTS, SAMPLE, v.v. |
senderInstruction | nonDelivery.option | RETURN, ABANDON, hoặc FORWARD. |
fw_TransType | nonDelivery.transportMethod | AIR hoặc MOST_ECONOMICAL. |
noCm | isNonCommercial | true / false. |
damges | declaredValue | Giá trị bảo hiểm. Phải tính bằng JPY, yen nguyên. |
totalWeight | cartonsCreateWorkflow.weight + weightUnit | Gửi tới Japan Post tính bằng grams. |
Người gửi → partyCreateWorkflow (bên ORIGIN)
| Tham số My Page↕ | Trường Zonos↕ | Ghi chú↕ |
|---|---|---|
from_nam | person.firstName + person.lastName | |
from_companyName | person.companyName | |
from_postal | location.postalCode | |
from_add1 / from_add2 / from_add3 | location.line1 / location.line2 / location.locality | |
from_pref | location.administrativeAreaCode | Tỉnh. |
from_tel | person.phone |
Người nhận → partyCreateWorkflow (bên DESTINATION)
Các tham số to_* của người nhận ánh xạ tới bên DESTINATION theo cách tương tự như các trường người gửi.
| Tham số My Page↕ | Trường Zonos↕ | Ghi chú↕ |
|---|---|---|
to_nam | person.firstName + person.lastName | |
to_companyName | person.companyName | |
to_couCd | location.countryCode | US hoặc PR. |
to_add1 / to_add2 / to_add3 | location.line1 / location.line2 / location.locality | |
| Mã bưu chính / tiểu bang / điện thoại | location.postalCode / location.administrativeAreaCode / person.phone |
Các mục → itemCreateWorkflow
| Tham số My Page↕ | Trường Zonos↕ | Ghi chú↕ |
|---|---|---|
item_pkg | customsDescription | Mô tả tùy chỉnh mục. Ký tự nửa chiều, tối đa 85 ký tự. |
item_hsCode | hsCode | |
item_num | quantity | |
item_weight | measurements (trọng lượng trên mỗi đơn vị) | |
item_cost | amount | Giá đơn vị. |
item_curUnit | currencyCode |
Chuyển đổi để biết
Đây là những chuyển đổi thường cần chú ý:
- Mức dịch vụ thay thế
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. - 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+weightUnittrên thùng; Zonos chuyển đổi. - Mô tả tùy chỉnh 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 (La Rô).
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:
- Quy trình trả về một số theo dõi và nhãn. Kiểm tra
shipmentCreateWorkflow.trackingDetails.numbervàshipmentCartons[].label.urltrong 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.
Liên quan
- Tạo một lô hàng duy nhất — tài liệu tham khảo trường đầy đủ cho quy trình
CreateDeclarationShipment. - Gửi hàng loạt (hợp nhất) — gộp gói của ngày thành một phiếu gửi Japan Post.
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.