DOCS
Trang chủCho các nhà cung cấp logistics Zonos Clarify Kiểm tra yêu cầu tuân thủ

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 complianceRequirements là đ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.

Phạm vi bắt buộc

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.

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.

1query ComplianceRequirements($filter: ComplianceRequirementFilter!) {
2 complianceRequirements(filter: $filter, first: 10) {
3 totalCount
4 pageInfo {
5 hasNextPage
6 endCursor
7 }
8 edges {
9 cursor
10 node {
11 id
12 hsCode
13 shipToCountry
14 shipFromCountry
15 program {
16 id
17 code
18 name
19 programType
20 authority
21 jurisdiction
22 status
23 strictness
24 currentVersion {
25 id
26 version
27 status
28 }
29 }
30 }
31 }
32 }
33}

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).

Trường bộ lọc↕Loại↕Ghi chú↕
hsCodeStringKhớp mã HS chính xác. Loại trừ lẫn nhau với hsCodePrefix.
hsCodePrefixStringKhớ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.
shipToCountryCountryCodeQuốc gia đích.
shipFromCountryCountryCodeQuố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 mỹ phẩm 3304:

1query PgaRequirements($filter: ComplianceRequirementFilter!) {
2 complianceRequirements(filter: $filter, first: 25) {
3 totalCount
4 edges {
5 node {
6 hsCode
7 shipToCountry
8 program {
9 code
10 name
11 }
12 }
13 }
14 }
15}

Đọc bộ câu hỏi của một chương trình 

Mỗi ComplianceProgram hiển thị currentVersion 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à nhập khẩu phải cung cấp.

1query QuestionnaireStructure($filter: ComplianceRequirementFilter!) {
2 complianceRequirements(filter: $filter, first: 1) {
3 edges {
4 node {
5 program {
6 code
7 name
8 currentVersion {
9 version
10 status
11 questions {
12 code
13 prompt
14 helpText
15 answerType
16 required
17 section
18 displayOrder
19 optionsSource
20 options {
21 value
22 label
23 displayOrder
24 }
25 displayCondition {
26 questionCode
27 operator
28 values
29 }
30 }
31 }
32 }
33 }
34 }
35 }
36}

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.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ComplianceRequirementFilter

Trang này có hữu ích không?

Nhận hỗ trợ·Tài liệu pháp lý·© 2026 Zonos
Trên trang này:
  • Kiểm tra yêu cầu tuân thủ
  • Khám phá các chương trình áp dụng
  • Lọc và phân trang
  • Đọc bộ câu hỏi của một chương trình
  • Các bước tiếp theo