DOCS

Completa un questionario

Completa un questionario

Clarify precompila ciò che può dai dati del tuo articolo; confermi o correggi il riposare, quindi finalizzare.

GraphQL

Una volta che sai quali programmi si applicano (vedi Verificare i requisiti di conformità), il flusso consigliato è di tre chiamate:

  1. Dedurre - complianceQuestionnaireInfer apre una sessione con le risposte precompilato dai dati dell'articolo.
  2. Rivedi e correggi - questionnaireAnswersSubmit per cambiare qualsiasi cosa il mittente non è d'accordo e risponde su ciò che resta.
  3. Attesta - questionnaireSessionAttest accettare e finalizzare.

Se hai già tutte le risposte, puoi inviare una risposta completa in una sola chiamata invece, vedi Invia una risposta completa di seguito.

Ambiti

La lettura richiede il COMPLIANCE_READ ambito; l'invio delle risposte richiede COMPLIANCE_WRITE. Vedere OAuth.

I valori della risposta sono codificati in JSON

Ogni risposta value è una stringa codificata JSON: un booleano è "true", un select o il valore del testo è citato come "\"cosmetic\"", è una selezione multipla "[\"a\",\"b\"]", e un numero è "42".

Deduci e precompila 

complianceQuestionnaireInfer risolve i programmi applicabili ai tuoi articoli, apre una sessione e pre-risponde alle domande dai dati dell'articolo. Ciascuno la risposta precompilata ha provenance: INFERRED e un confidence punto.

Passaggio intendedUse per guidare l'inferenza: i flussi del negozio dovrebbero essere inviati 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}

Ogni riga state ti dice cosa c'è dopo:

  • READY_TO_ATTEST - viene data risposta a ogni domanda richiesta. Vai direttamente a Attestato (sotto).
  • PARTIAL - alcune risposte erano precompilate, ma rimangono le domande obbligatorie. Rispondi a currentQuestion.
  • NOT_INFERRED - non è possibile precompilare nulla; rispondi in modo semplice questionario.

I programmi già soddisfatti da una risposta esistente vengono saltati e restituiti alreadySatisfied (omesso sopra).

Rivedi e correggi 

La sessione contiene risposte precompilate, non una risposta definitiva. Per ciascuno risposta, lo spedizioniere:

  • accetta lo lascia intatto e rimane INFERRED, o
  • lo corregge — invia un nuovo valore con questionnaireAnswersSubmit, quale diventa MANUAL.

Invia una o più risposte contemporaneamente. Clarify avanza currentQuestion al successiva domanda rimanente e, quando non ne rimane nessuna, finalizza quella della riga risposta (it responseId è popolato).

Le risposte accettate vengono conservate, non scartate

La correzione di una risposta sovrascrive solo quella risposta. La risposta definitiva è valida il set completo: le risposte accettate restano INFERRED, le correzioni sono MANUAL — quindi tieni sempre un registro di ciò che l'IA ha fornito rispetto a ciò che una persona ha cambiato.

Ad esempio, il mittente accetta quanto dedotto intended_use ma corregge contains_color_additives, quindi inviano solo quella risposta:

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}

Attesta 

Quando una linea è READY_TO_ATTEST — ogni risposta richiesta già precompilata e il mittente è d'accordo: accettalo in una sola chiamata con questionnaireSessionAttest. Esso finalizza ogni riga idonea o solo la lineIds tu passi.

1mutation AttestSession($input: QuestionnaireSessionAttestInput!) {
2 questionnaireSessionAttest(input: $input) {
3 id
4 status
5 lines {
6 id
7 status
8 responseId
9 }
10 }
11}

Per eliminare una sessione in corso, chiamare questionnaireSessionAbandon(id: ID!).

Invia una risposta completa 

Se hai già tutte le risposte, ad esempio una risposta riutilizzabile impostata per a CATALOG_ITEM - salta la sessione e invia direttamente con questionnaireResponseSubmit. Sostituisce qualsiasi risposta precedente per lo stesso elemento e programma.

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}

Preferisci rispondere senza fare deduzioni? questionnaireSessionStart apre una sessione per i programmi che scegli, quindi usi gli stessi Rivedi e correggi e Attesta le chiamate sopra.

Leggi le risposte e la preparazione 

Recupera un record finalizzato con questionnaireResponse(id)e verificare se a l'intero contenitore è pronto per essere archiviato containerComplianceReadinessready È true solo quando ogni riga ha una risposta completa.

1query ContainerReadiness($containerType: ContainerType!, $containerId: ID!) {
2 containerComplianceReadiness(
3 containerType: $containerType
4 containerId: $containerId
5 ) {
6 ready
7 totalLineCount
8 outstandingLineCount
9 }
10}

Passaggi successivi 

Questa pagina è stata utile?