Điều kiện tiên quyết
Trước khi bạn bắt đầu, hãy đảm bảo bạn có những điều sau:
- Một đăng ký giá bao gồm đang hoạt động với Zonos.
- Khóa API GraphQL Secret từ Zonos Dashboard của bạn. Điều hướng đến Settings -> Integrations để tìm khóa API của bạn. Khóa phải có tiền tố
credential_livevà không được hết hạn.
Thiết lập lần đầu
Làm theo các bước sau để thiết lập mẫu báo cáo giá bao gồm lần đầu tiên.
Sao chép mẫu Google Sheet
Mở mẫu báo cáo giá bao gồm và tạo bản sao của bạn bằng cách đi đến File -> Make a copy. Không yêu cầu quyền truy cập biên tập vào trang tính gốc.
Kết nối khóa API của bạn
Trong bảng tính được sao chép, nhấp vào Zonos -> Update GraphQL API Key từ thanh menu (bên cạnh Help). Tùy chọn menu này có thể mất một phút để xuất hiện sau khi mở bảng tính.
Xác nhận tập lệnh
Đối với người dùng lần đầu, hộp thoại xác nhận sẽ xuất hiện. Nhấp OK, sau đó làm theo các lời nhắc để xác nhận tập lệnh bằng tài khoản Google của bạn:
- Nhấp vào Select all để cấp các quyền cần thiết.
- Nhấp vào Continue để hoàn tất quá trình xác nhận.
Nhập khóa API Secret của bạn
Sau khi xác nhận, hộp thoại sẽ nhắc bạn nhập khóa API GraphQL Secret của Zonos. Bạn có thể tìm thấy điều này trong Zonos Dashboard của bạn dưới Settings -> Integrations.
Hãy chắc chắn sao chép khóa Secret hợp lệ có tiền tố credential_live. Các khóa hết hạn hoặc khóa Công khai sẽ gây ra lỗi.
Tìm nạp đơn hàng
Nhấp vào Zonos -> Fetch Orders từ thanh menu.
Chọn một phạm vi ngày
Nhập ngày bắt đầu và ngày kết thúc trong hộp thoại hoặc sử dụng một trong các tùy chọn được đặt trước (Last 30 days, This month, Last month, This year), sau đó nhấp Fetch Orders.
Khi hoàn tất, các đơn hàng của bạn sẽ điền vào tab Orders của bảng tính.
Lưu ý: Để lưu một báo cáo để tham khảo trong tương lai, nhấp chuột phải vào tab Orders và chọn Duplicate, sau đó đổi tên khi cần. Bạn cũng có thể xuất hoặc tạo một bản sao của toàn bộ bảng tính.
Sử dụng hàng ngày
Sau khi hoàn tất thiết lập lần đầu, việc tạo báo cáo mới rất đơn giản:
- Bỏ qua các bước 1-3 - Đây là quá trình một lần.
- Bỏ qua bước 4 trừ khi khóa API của bạn đã hết hạn hoặc bạn cần kéo dữ liệu từ một cửa hàng Zonos khác.
- Lặp lại các bước 5 và 6 để tìm nạp đơn hàng cho một phạm vi ngày mới.
Lỗi 401 Unauthorized
Bạn có thể thấy một lỗi chứa HTTP fetch failed from 'order': 401: Unauthorized.
Khắc phục: Hãy chắc chắn bạn đang sử dụng khóa API GraphQL Secret hợp lệ từ Zonos Dashboard của bạn. Lỗi này xảy ra khi khóa bị thiếu, không hợp lệ hoặc không phải là loại khóa Secret.
Lỗi yêu cầu bảo mật không thành công
Bạn có thể thấy một lỗi chứa Security requirement failed.
Khắc phục: Hãy chắc chắn bạn đang sử dụng khóa API GraphQL Secret (không phải khóa Công khai) và nó không có trạng thái Expired. Điều hướng đến Settings -> Integrations trong Zonos Dashboard của bạn để xác minh trạng thái khóa.
Không có đơn hàng nào xuất hiện
Không có đơn hàng nào điền mặc dù cung cấp khóa API GraphQL Secret hợp lệ.
Khắc phục: Báo cáo này chỉ tạo dữ liệu cho các đơn hàng có thuộc tính giá bao gồm. Nếu các mục của bạn không chứa các trường reverseAmountDetail, chúng sẽ không được bao gồm. Xác minh rằng bạn đã xử lý các đơn hàng giá bao gồm trong phạm vi ngày bạn đã chọn.
Xuất báo cáo giá bao gồm
Tạo chi tiết giá bao gồm mức mục bằng cách sử dụng Google Sheet.
Mẫu báo cáo giá bao gồm là một Google Sheet có tập lệnh được xây dựng sẽ truy vấn API GraphQL của Zonos để lấy các đơn hàng của bạn và tạo báo cáo hiển thị chi tiết mức mục về lượng cơ sở và lượng bao gồm. Điều này rất hữu ích cho bất kỳ thương nhân nào muốn có cái nhìn rõ ràng về cách các khoản thuế nhập khẩu, thuế và phí được phân bổ trên các mục trong các đơn hàng giá bao gồm của họ.