Cài đặt tài khoản

Tạo Tài khoản Xác minh của bạn, thêm phương thức thanh toán và kết nối tích hợp của bạn.

Bước 1 — Tạo Tài khoản Xác minh của bạn

Đăng ký Tài khoản Xác minh Zonos bằng liên kết đăng ký Česká pošta. Hoàn tất địa chỉ doanh nghiệp và thiết lập thanh toán của bạn.

Bước 2 — Thêm phương thức thanh toán

Thêm phương thức thanh toán vào tài khoản Zonos của bạn để tài trợ cho việc chuyển tiền thuế nhập khẩu cho lô hàng đi tới Mỹ.

Bước 3 — Lấy khóa API của bạn

Đăng nhập vào Bảng điều khiển Zonos của bạn và điều hướng đến Account → Integrations. Bảng hiển thị hai khóa:

Tên trong Bảng điều khiển↕	Mục đích↕	Sử dụng cho API?↕
Account key	Định danh để liên kết với nhà điều hành bưu chính	❌ KHÔNG
API key	Khóa xác thực để gọi API Zonos	✅ CÓ — sử dụng cái này

Sao chép mã thông báo trong hàng API key. Nó bắt đầu bằng credential_live_. Bạn sẽ cần khóa này cho cả hai phương pháp tích hợp.

Giữ API key của bạn an toàn. Không được lưu nó vào quản lý phiên bản hoặc chia sẻ nó công khai. Nếu bạn tin rằng nó đã bị xâm phạm, hãy tái tạo nó từ cùng trang Account → Integrations.

Bước 4 (tùy chọn) — Ước tính chi phí thuế nhập khẩu với Item Quoter

Công cụ Item Quoter trong Bảng điều khiển Zonos của bạn cho phép bạn tra cứu các chi phí thuế nhập khẩu ước tính cho các sản phẩm của bạn trước khi vận chuyển — hữu ích để kiểm tra giá và lập kế hoạch trước mà không cần tạo Mã Khai báo.

Phương pháp tích hợp

Chọn phương pháp phù hợp với cài đặt kỹ thuật của bạn. Cả hai phương pháp đều tạo Mã Khai báo mà bạn sau đó tải lên hệ thống vận chuyển của Česká pošta.

Dành cho khách hàng kỹ thuật và nhà phát triển gọi Zonos trực tiếp từ hệ thống của riêng họ.

Điểm cuối

URL: https://api.zonos.com/graphql
Phương pháp: POST
Content-Type: application/json

Xác thực

Truyền API key của bạn trong tiêu đề credentialToken: credentialToken: credential_live_xxxxxxxxxxxxxxxxxx

Ví dụ API

Đăng nhập vào tài khoản Česká pošta của bạn để xem ví dụ API đầy đủ, bao gồm yêu cầu và phản hồi đầy đủ.

Sau khi tạo Mã Khai báo

Gửi Mã Khai báo tới Česká pošta cùng với chi tiết lô hàng của bạn. Česká pošta liên kết Mã Khai báo với lô hàng và trả lại số theo dõi. Zonos không cấp số theo dõi.

Xử lý lỗi

Lỗi / Triệu chứng↕	Nguyên nhân và cách khắc phục có thể↕
Security requirement failed	API key của bạn không hợp lệ hoặc được chuyển trong tiêu đề sai. Đảm bảo bạn đang sử dụng API Key (không phải Account Key) và tên tiêu đề chính xác là `credentialToken`.
HTTP 401 Unauthorized	API key bị thiếu trong tiêu đề yêu cầu. Xác nhận `credentialToken` được bao gồm.
`errors` mảng trong phản hồi	Đột biến trả về lỗi GraphQL. Kiểm tra trường `message` trong mảng lỗi để biết chi tiết.
Hình dạng phản hồi không mong đợi	Phản hồi không bao gồm `data.declarationCreate.id`. Ghi nhật ký phần thân phản hồi đầy đủ và xác minh văn bản đột biến khớp với ví dụ chính xác.

Đặt lịch demo