Cách mô hình API Zonos + Japan Post hoạt động
Các thương nhân Tài khoản xác minh Japan Post gọi Zonos trực tiếp. Zonos sử dụng thông tin đăng nhập của riêng nó với Japan Post và bao gồm Số khách hàng Thanh toán sau của bạn trên mọi nhãn để phí bưu điện được tính vào tài khoản của bạn.
Trong một yêu cầu GraphQL duy nhất, Zonos:
- Xác thực Tài khoản xác minh và Số khách hàng Thanh toán sau của bạn.
- Gọi API Nhãn Japan Post (mã 52) thay bạn để tạo nhãn và số theo dõi.
- Tạo ID Khai báo hàng để chuẩn bị nộp lệ phí Mỹ.
- Liên kết ID Khai báo hàng với số theo dõi qua
declarationShipmentCreate. - Trả lại nhãn, số theo dõi và bản ghi vận chuyển cho bạn.
Bạn không cần thông tin đăng nhập API Japan Post của riêng bạn (CTID / mật khẩu CT). Bạn cần các Số khách hàng Thanh toán sau của Japan Post (後納お客様番号) được kết nối với Tài khoản xác minh của Zonos.
Thiết lập nào của bạn?
Tất cả mọi người gọi Zonos để tạo cả nhãn và biên bản, vì vậy bạn không bao giờ cung cấp thông tin đăng nhập Japan Post của riêng mình (CTID / mật khẩu CT). Điều thay đổi theo thiết lập là các tiêu đề API Zonos nào bạn chuyển - tìm hàng của bạn bên dưới, sau đó sử dụng tab phù hợp trong phần Điểm cuối và xác thực của mỗi luồng.
| ↕ | Thương nhân Thương mại điện tử↕ | Nền tảng vận chuyển (BYOA)↕ | Đối tác 3PL / Logistic / Bán lại↕ |
|---|---|---|---|
| Bạn là ai | Một thương hiệu vận chuyển các đơn hàng của bạn | Một nền tảng mà nhiều thương nhân tạo nhãn qua | Một đối tác vận chuyển thay mặt nhiều khách hàng thương nhân |
| Tài khoản xác minh bạn thiết lập | Một Tài khoản xác minh (của riêng bạn) | Mỗi thương nhân thiết lập của riêng họ; bạn vận chuyển thay mặt họ | Một Tài khoản xác minh được sử dụng cho tất cả những người vận chuyển của bạn |
| Tiêu đề API Zonos để chuyển | credentialToken (của bạn) chỉ | credentialToken (của bạn) + accountKey (của mỗi thương nhân) | credentialToken (của bạn) chỉ |
| Số khách hàng Thanh toán sau của ai được tính phí vận chuyển | Của bạn | Của mỗi thương nhân | Của bạn |
| Zonos thanh toán ai cho các khoản phí | Bạn | Mỗi thương nhân | Bạn |
BYOA (Mang tài khoản của riêng bạn): mỗi thương nhân giữ Tài khoản xác minh Japan Post của riêng họ, và nền tảng tạo nhãn thay mặt thương nhân đó bằng cách chuyển khóa tài khoản của thương nhân, thay vì vận chuyển dưới tài khoản của nền tảng.
Hai luồng API
Có hai mô hình tích hợp tùy thuộc vào cách bạn gửi các gói hàng.
Tạo một lô vận chuyển duy nhất
Chuỗi nền tảng. Một yêu cầu GraphQL duy nhất đưa một lô vận chuyển từ đầu vào thô (các bên tham gia, mục hàng, đóng gói) qua hoàn chỉnh để có nhãn Japan Post có thể in. Sử dụng điều này nếu bạn vận chuyển các gói hàng riêng lẻ khi đơn hàng đến.
Tạo một lô vận chuyển duy nhất →
Gửi hàng theo lô (Hợp nhất)
Luồng thanh toán hoãn lại hàng loạt. Mở một hợp nhất vào buổi sáng, đính kèm các lô vận chuyển vào nó suốt cả ngày bằng cách sử dụng chuỗi lô vận chuyển duy nhất, sau đó đóng hợp nhất vào cuối ngày để nhận một phiếu gửi hàng Japan Post bao trùm toàn bộ lô. Sử dụng điều này nếu bạn thanh toán phí bưu điện Japan Post trong một giao dịch vào cuối ngày thay vì từng gói hàng.
Đã sử dụng API My Page của Japan Post?
Nếu bạn hiện tại tạo nhãn bằng API My Page của Japan Post (ctCode=52), bạn có thể giữ lại tích hợp đó và thêm Zonos cho các nhãn được chuẩn bị nộp lệ phí Mỹ. Xem Sử dụng Zonos với API My Page để xem ánh xạ trường từng trường và danh sách kiểm tra xác minh.
Tạo nhãn qua API
Tích hợp hệ thống hoàn thiện của bạn với API GraphQL của Zonos để tạo nhãn Japan Post có thuế đã thanh toán trước.
Phần này dành cho các đội kỹ thuật đang xây dựng quy trình tạo nhãn Japan Post theo chương trình sử dụng Tài khoản xác minh. Nếu bạn là nhà bán hàng nhỏ hoặc vừa không có tài nguyên phát triển, hãy xem Tạo nhãn trong Dashboard thay thế.