DOCS
HjemFor logistikkselskaper Zonos Clarify Fullfør en spørreundersøkelse

Fullfør en spørreundersøkelse

Clarify forhåndsutfyller det den kan fra elementdataene dine; du bekrefter eller korrigerer resten, og fullfører deretter.

GraphQL

Når du vet hvilke programmer som gjelder (se Kontroller samsvarskrav), er den anbefalte flyten tre anrop:

  1. Utled - complianceQuestionnaireInfer åpner en økt med svar forhåndsutfylt fra elementdataene dine.
  2. Gjennomgå og korrigér - questionnaireAnswersSubmit for å endre noe avsender er uenig i og svar på det som er igjen.
  3. Attestér - questionnaireSessionAttest for å godta og fullføre.

Hvis du allerede har hvert svar, kan du sende inn et fullstendig svar i ett anrop i stedet — se Send inn et fullstendig svar nedenfor.

Omfang

Lesing krever COMPLIANCE_READ-omfanget; sending av svar krever COMPLIANCE_WRITE. Se OAuth.

Svarverdier er JSON-kodet

Hvert svar value er en JSON-kodet streng: en boolsk verdi er "true", en velg- eller tekstverdi er sitert som "\"cosmetic\"", et flertallsvalg er "[\"a\",\"b\"]", og et tall er "42".

Utled og forhåndsutfyll 

complianceQuestionnaireInfer løser gjeldende programmer for elementene dine, åpner en økt, og forhåndsbesvarer spørsmål fra elementdataene dine. Hvert forhåndsutfylt svar har provenance: INFERRED og en confidence-poengsum.

Send intendedUse for å veilede utledning — butikkfrontflyter bør sende 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}

Hver linjes state forteller deg hva som er neste:

  • READY_TO_ATTEST - hvert påkrevd spørsmål er besvart. Gå direkte til Attestér (nedenfor).
  • PARTIAL - noen svar ble forhåndsutfylt, men påkrevde spørsmål gjenstår. Besvar dem på currentQuestion.
  • NOT_INFERRED - ingenting kunne forhåndsutfylles; besvar det som en vanlig spørreundersøkelse.

Programmer som allerede er tilfredsstilt av et eksisterende svar hoppes over og returneres i alreadySatisfied (utelatt ovenfor).

Gjennomgå og korrigér 

Økten inneholder forhåndsutfylte svar — ikke et fullført svar. For hvert svar, gjør avsender enten:

  • godtar det — lar det være urørt, og det forblir INFERRED, eller
  • korrigerer det — sender inn en ny verdi med questionnaireAnswersSubmit, som blir MANUAL.

Send inn ett svar eller flere på en gang. Clarify avanserer currentQuestion til neste gjenstående spørsmål og, når det ikke gjenstår noen, fullfører linjens svar (dens responseId blir fylt ut).

Godtatte svar beholdes, ikke forkastet

Korrigering av ett svar overstyrer bare det svaret. Det fullstendige svaret inneholder hele settet — godtatte svar forblir INFERRED, rettelser er MANUAL — slik at du alltid har en registrering over hva AI'en leverte kontra hva en person endret.

For eksempel godtar avsender det utledede intended_use men korrigerer contains_color_additives, så avsender sender bare inn det ene svaret:

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}

Attestér 

Når en linje er READY_TO_ATTEST — hvert påkrevd svar allerede forhåndsutfylt og avsender er enig — godta det i ett anrop med questionnaireSessionAttest. Det fullfører hver kvalifisert linje, eller bare lineIds du sender.

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

For å forkaste en pågående økt, kall questionnaireSessionAbandon(id: ID!).

Send inn et fullstendig svar 

Hvis du allerede har hvert svar — for eksempel et gjenbrukbart svarresett for en CATALOG_ITEM — hopp over økten og send direkte med questionnaireResponseSubmit. Det erstatter evt tidligere svar for samme element og program.

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}

Foretrekker å svare uten utledning? questionnaireSessionStart åpner en økt for programmene du velger, og deretter bruker du de samme Gjennomgå og korrigér og Attestér anropene ovenfor.

Les svar og beredskap 

Hent en fullført oppføring med questionnaireResponse(id), og kontroller om en hel beholder er klar til innlevering med containerComplianceReadiness — ready er true bare når hver linje har et fullstendig svar.

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

Neste steg 

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

ComplianceQuestionnaireInferInput QuestionnaireAnswersSubmitInput QuestionnaireResponseSubmitInput QuestionnaireSessionAttestInput

MUTATIONS

complianceQuestionnaireInfer questionnaireAnswersSubmit questionnaireResponseSubmit questionnaireSessionAttest

Var denne siden nyttig?

Få støtte·Juridiske dokumenter·© 2026 Zonos
På denne siden:
  • Fullfør en spørreundersøkelse
  • Utled og forhåndsutfyll
  • Gjennomgå og korrigér
  • Attestér
  • Send inn et fullstendig svar
  • Les svar og beredskap
  • Neste steg