Khám phá các chương trình áp dụng
Chuyển hsCode và shipToCountry của một mặt hàng để tìm những chương trình nào áp dụng. Kết quả là một kết nối được phân trang gồm các nút ComplianceRequirement, mỗi nút trỏ đến ComplianceProgram mà nó kích hoạt.
query ComplianceRequirements($filter: ComplianceRequirementFilter!) { complianceRequirements(filter: $filter, first: 10) { totalCount pageInfo { hasNextPage endCursor } edges { cursor node { id hsCode shipToCountry shipFromCountry program { id code name programType authority jurisdiction status strictness currentVersion { id version status } } } } }}Một shipFromCountry là null trên yêu cầu có nghĩa là chương trình áp dụng
bất kể xuất xứ. Khi bạn cung cấp shipFromCountry trong bộ lọc, cả các hàng dành riêng cho xuất xứ và các hàng "bất kỳ xuất xứ" đều được khớp.
Lọc và phân trang
complianceRequirements chấp nhận ComplianceRequirementFilter cùng với các đối số phân trang con trỏ tiêu chuẩn (first / after để phân trang về phía trước, last /
before để phân trang về phía sau).
| Filter field↕ | Type↕ | Notes↕ |
|---|---|---|
hsCode | String | Khớp mã HS chính xác. Loại trừ lẫn nhau với hsCodePrefix. |
hsCodePrefix | String | Khớp tiền tố (chỉ các chữ số và dấu chấm, tối đa 12 ký tự). Loại trừ lẫn nhau với hsCode. |
shipToCountry | CountryCode | Quốc gia đích. |
shipFromCountry | CountryCode | Quốc gia xuất xứ. Các hàng có xuất xứ null ("bất kỳ xuất xứ") cũng khớp. |
programTypes | [ComplianceProgramType!] | Chỉ khớp với các loại chương trình này. Danh sách trống = không có bộ lọc. |
Ví dụ, liệt kê mọi yêu cầu PGA cho chương cosmetics 3304:
query PgaRequirements($filter: ComplianceRequirementFilter!) { complianceRequirements(filter: $filter, first: 25) { totalCount edges { node { hsCode shipToCountry program { code name } } } }}Đọc bộ câu hỏi của một chương trình
Mỗi ComplianceProgram hiển thị phiên bản hiện tại của nó — bộ câu hỏi ACTIVE — và các questions của phiên bản đó theo thứ tự hiển thị. Mỗi câu hỏi khai báo answerType của nó, liệu nó có required, options của nó (đối với các loại chọn), và một displayCondition tùy chọn phân nhánh bộ câu hỏi. Đọc cấu trúc này để hiển thị giao diện của riêng bạn hoặc để hiểu chính xác những gì mà một nhập khẩu phải cung cấp.
query QuestionnaireStructure($filter: ComplianceRequirementFilter!) { complianceRequirements(filter: $filter, first: 1) { edges { node { program { code name currentVersion { version status questions { code prompt helpText answerType required section displayOrder optionsSource options { value label displayOrder } displayCondition { questionCode operator values } } } } } } }}Trong ví dụ trên, contains_color_additives chỉ được hiển thị khi
intended_use bằng cosmetic — đó là displayCondition hoạt động. Để biết
mô hình phân nhánh đầy đủ và các tùy chọn động (optionsSource), hãy xem
How it works.
Các bước tiếp theo
- Complete a questionnaire - suy diễn, trả lời và hoàn thành các bộ câu hỏi mà bạn đã phát hiện ở đây.
- How it works - phân nhánh, nguồn gốc và các tùy chọn động.
Kiểm tra yêu cầu tuân thủ
Phát hiện những chương trình tuân thủ nào áp dụng cho một mặt hàng và đọc bộ câu hỏi mà bạn sẽ cần trả lời.
GraphQL
Truy vấn
complianceRequirementslà điểm vào của Zonos Clarify. Với mã HS của một mặt hàng và tuyến đường, nó trả về những chương trình tuân thủ được kích hoạt và cho phép bạn duyệt qua cấu trúc bộ câu hỏi đầy đủ của mỗi chương trình — các câu hỏi, tùy chọn và logic phân nhánh. Sử dụng nó để quyết định xem một lô hàng có cần câu trả lời tuân thủ hay không và để hiển thị giao diện bộ câu hỏi của riêng bạn.Truy vấn này yêu cầu phạm vi
COMPLIANCE_READ. Xem OAuth để xác thực các yêu cầu API.