Trang chủCho các nhà cung cấp logistics Zonos Clarify Hoàn thành bảng câu hỏi

Hoàn thành bảng câu hỏi

Clarify điền sẵn những gì nó có thể từ dữ liệu mục của bạn; bạn xác nhận hoặc sửa chữa phần còn lại, sau đó hoàn tất.

GraphQL

Khi bạn biết các chương trình nào được áp dụng (xem Kiểm tra yêu cầu tuân thủ), quy trình được khuyến nghị là ba lệnh gọi:

Suy luận - complianceQuestionnaireInfer mở một phiên với câu trả lời được điền sẵn từ dữ liệu mục của bạn.
Xem xét và sửa chữa - questionnaireAnswersSubmit để thay đổi bất cứ điều gì người gửi hàng không đồng ý và trả lời những gì còn lại.
Chứng thực - questionnaireSessionAttest để chấp nhận và hoàn tất.

Nếu bạn đã có mọi câu trả lời, bạn có thể gửi phản hồi hoàn chỉnh trong một lệnh gọi thay vào đó — xem Gửi phản hồi hoàn chỉnh bên dưới.

Phạm vi

Đọc yêu cầu phạm vi COMPLIANCE_READ; gửi câu trả lời yêu cầu COMPLIANCE_WRITE. Xem OAuth.

Giá trị câu trả lời được mã hóa JSON

Mọi giá trị value của câu trả lời là một chuỗi được mã hóa JSON: một boolean là "true", một giá trị chọn hoặc văn bản được trích dẫn như "\"cosmetic\"", một multi-select là "[\"a\",\"b\"]", và một số là "42".

Suy luận và điền sẵn

complianceQuestionnaireInfer giải quyết các chương trình áp dụng cho các mục của bạn, mở một phiên, và trả lời sẵn các câu hỏi từ dữ liệu mục của bạn. Mỗi câu trả lời được điền sẵn có provenance: INFERRED và điểm confidence.

Truyền intendedUse để hướng dẫn suy luận — các quy trình cửa hàng trực tuyến nên gửi CONSUMER.

1mutation InferQuestionnaire($input: ComplianceQuestionnaireInferInput!) {

2 complianceQuestionnaireInfer(input: $input) {

3 session {

4 id

5 status

6 lines {

7 id

8 programId

9 status

10 currentQuestion {

11 code

12 prompt

13 answerType

14 }

15 }

16 }

17 lines {

18 lineId

19 state

20 remainingRequiredCount

21 }

22 }

23}

Trạng thái state của mỗi dòng cho bạn biết tiếp theo là gì:

READY_TO_ATTEST - mọi câu hỏi bắt buộc đều được trả lời. Đi thẳng đến Chứng thực (bên dưới).
PARTIAL - một số câu trả lời đã được điền sẵn, nhưng các câu hỏi bắt buộc vẫn còn. Trả lời chúng tại currentQuestion.
NOT_INFERRED - không thể điền sẵn gì; trả lời nó như một bảng câu hỏi thông thường.

Các chương trình đã được thỏa mãn bởi phản hồi hiện có sẽ bị bỏ qua và được trả về trong alreadySatisfied (không được hiển thị ở trên).

Xem xét và sửa chữa

Phiên chứa câu trả lời được điền sẵn — không phải phản hồi cuối cùng. Đối với mỗi câu trả lời, người gửi hàng:

chấp nhận nó — để nguyên vẹn, và nó vẫn là INFERRED, hoặc
sửa chữa nó — gửi giá trị mới với questionnaireAnswersSubmit, trở thành MANUAL.

Gửi một hoặc nhiều câu trả lời cùng một lúc. Clarify đẩy currentQuestion đến câu hỏi tiếp theo còn lại và, khi không có câu nào còn lại, hoàn tất phản hồi của dòng (responseId của nó được điền).

Các câu trả lời được chấp nhận được giữ lại, không bị loại bỏ

Sửa chữa một câu trả lời chỉ ghi đè lên câu trả lời đó. Phản hồi cuối cùng giữ bộ đầy đủ — các câu trả lời được chấp nhận vẫn là INFERRED, các sửa chữa là MANUAL — vì vậy bạn luôn giữ một hồ sơ về những gì AI cung cấp so với những gì một người thay đổi.

Ví dụ, người gửi hàng chấp nhận intended_use được suy luận nhưng sửa chữa contains_color_additives, vì vậy họ chỉ gửi một câu trả lời đó:

1mutation SubmitAnswers($input: QuestionnaireAnswersSubmitInput!) {

2 questionnaireAnswersSubmit(input: $input) {

3 status

4 lines {

5 id

6 status

7 responseId

8 answers {

9 questionCode

10 value

11 provenance

12 confidence

13 }

14 }

15 }

16}

Chứng thực

Khi một dòng là READY_TO_ATTEST — mọi câu trả lời bắt buộc đã được điền sẵn và người gửi hàng đồng ý — chấp nhận nó trong một lệnh gọi với questionnaireSessionAttest. Nó hoàn tất mọi dòng đủ điều kiện, hoặc chỉ những lineIds bạn truyền.

1mutation AttestSession($input: QuestionnaireSessionAttestInput!) {

2 questionnaireSessionAttest(input: $input) {

3 id

4 status

5 lines {

6 id

7 status

8 responseId

9 }

10 }

11}

Để hủy bỏ một phiên đang diễn ra, hãy gọi questionnaireSessionAbandon(id: ID!).

Gửi phản hồi hoàn chỉnh

Nếu bạn đã có mọi câu trả lời — ví dụ như một bộ câu trả lời có thể tái sử dụng cho CATALOG_ITEM — bỏ qua phiên và gửi trực tiếp với questionnaireResponseSubmit. Nó thay thế bất kỳ phản hồi trước đó nào cho cùng mục và chương trình.

1mutation SubmitResponse($input: QuestionnaireResponseSubmitInput!) {

2 questionnaireResponseSubmit(input: $input) {

3 id

4 status

5 completedAt

6 answers {

7 questionCode

8 value

9 provenance

10 }

11 }

12}

Thích trả lời mà không cần suy luận? questionnaireSessionStart mở một phiên cho các chương trình bạn chọn, và sau đó bạn sử dụng Xem xét và sửa chữa và các lệnh gọi Chứng thực tương tự ở trên.

Đọc phản hồi và sẵn sàng

Tìm nạp một hồ sơ cuối cùng với questionnaireResponse(id), và kiểm tra xem toàn bộ container có sẵn sàng để nộp với containerComplianceReadiness — ready chỉ là true khi mọi dòng đều có phản hồi hoàn chỉnh.

1query ContainerReadiness($containerType: ContainerType!, $containerId: ID!) {

2 containerComplianceReadiness(

3 containerType: $containerType

4 containerId: $containerId

5 ) {

6 ready

7 totalLineCount

8 outstandingLineCount

9 }

10}

Các bước tiếp theo

Cách nó hoạt động - nhánh, nguồn gốc, các tùy chọn động và mục đích sử dụng.
Kiểm tra yêu cầu tuân thủ - khám phá các chương trình và đọc cấu trúc bảng câu hỏi.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

ComplianceQuestionnaireInferInput QuestionnaireAnswersSubmitInput QuestionnaireResponseSubmitInput QuestionnaireSessionAttestInput

MUTATIONS

complianceQuestionnaireInfer questionnaireAnswersSubmit questionnaireResponseSubmit questionnaireSessionAttest

Đặt lịch demo