Inferer og forudfyld
complianceQuestionnaireInfer opløser de relevante programmer for dine varer,
åbner en session og forudbesvarer spørgsmål ud fra dine varedata. Hvert
forududfyldt svar har provenance: INFERRED og en confidence-score.
Send intendedUse for at styre inferens — storefront-flows bør sende CONSUMER.
mutation InferQuestionnaire($input: ComplianceQuestionnaireInferInput!) { complianceQuestionnaireInfer(input: $input) { session { id status lines { id programId status currentQuestion { code prompt answerType } } } lines { lineId state remainingRequiredCount } }}Hver linjes state fortæller dig, hvad der er næste skridt:
READY_TO_ATTEST— alle påkrævede spørgsmål er besvaret. Gå direkte til Attester (nedenfor).PARTIAL— nogle svar blev forududfyldt, men påkrævede spørgsmål resterer. Besvar dem vedcurrentQuestion.NOT_INFERRED— intet kunne forududfyldes; besvar det som et almindeligt spørgeskema.
Programmer, der allerede er dækket af et eksisterende svar, springes over og
returneres i alreadySatisfied (udeladt ovenfor).
Gennemgå og ret
Sessionen indeholder forududfyldte svar — ikke et finaliseret svar. For hvert svar gør afsenderen enten:
- accepterer det — lader det være urørt, og det forbliver
INFERRED, eller - retter det — indsender en ny værdi med
questionnaireAnswersSubmit, som bliverMANUAL.
Indsend ét svar eller flere ad gangen. Clarify fremrykker currentQuestion til
det næste resterende spørgsmål og, når ingen er tilbage, finaliserer linjens
svar (dens responseId udfyldes).
For eksempel accepterer afsenderen det infererede intended_use, men retter
contains_color_additives, så de indsender kun det ene svar:
mutation SubmitAnswers($input: QuestionnaireAnswersSubmitInput!) { questionnaireAnswersSubmit(input: $input) { status lines { id status responseId answers { questionCode value provenance confidence } } }}Attester
Når en linje er READY_TO_ATTEST — alle påkrævede svar allerede forududfyldt og
afsenderen er enig — accepter den i ét kald med questionnaireSessionAttest. Det
finaliserer alle berettigede linjer eller kun de lineIds, du sender.
mutation AttestSession($input: QuestionnaireSessionAttestInput!) { questionnaireSessionAttest(input: $input) { id status lines { id status responseId } }}For at kassere en igangværende session, kald questionnaireSessionAbandon(id: ID!).
Indsend et komplet svar
Hvis du allerede har alle svar — for eksempel et genanvendeligt sæt svar for et
CATALOG_ITEM — spring sessionen over og indsend direkte med
questionnaireResponseSubmit. Det erstatter ethvert tidligere svar for samme
vare og program.
mutation SubmitResponse($input: QuestionnaireResponseSubmitInput!) { questionnaireResponseSubmit(input: $input) { id status completedAt answers { questionCode value provenance } }}Foretrækker du at besvare uden inferens? questionnaireSessionStart åbner en session
for de programmer, du vælger, og derefter bruger du de samme kald til Gennemgå og ret og
Attester som ovenfor.
Læs svar og parathed
Hent en finaliseret registrering med questionnaireResponse(id), og tjek om en
hel container er klar til indgivelse med containerComplianceReadiness —
ready er true kun når hver linje har et komplet svar.
query ContainerReadiness($containerType: ContainerType!, $containerId: ID!) { containerComplianceReadiness( containerType: $containerType containerId: $containerId ) { ready totalLineCount outstandingLineCount }}Næste trin
- Sådan fungerer det — forgrening, oprindelse, dynamiske valgmuligheder og tiltænkt brug.
- Tjek compliance-krav — opdag programmer og læs spørgeskemastrukturer.
Udfyld et spørgeskema
Clarify forudfylder det, den kan, ud fra dine varedata; du bekræfter eller retter resten og finaliserer derefter.
GraphQL
Når du ved, hvilke programmer der gælder (se Tjek compliance-krav), er det anbefalede flow tre kald:
complianceQuestionnaireInferåbner en session med svar forududfyldt ud fra dine varedata.questionnaireAnswersSubmittil at ændre det, afsenderen er uenig i, og besvare det, der mangler.questionnaireSessionAttesttil at acceptere og finalisere.Hvis du allerede har alle svar, kan du indsende et komplet svar i ét kald i stedet — se Indsend et komplet svar nedenfor.
Læsning kræver scope
COMPLIANCE_READ; indsendelse af svar kræverCOMPLIANCE_WRITE. Se OAuth.Hver svar-
valueer en JSON-kodet streng: en boolean er"true", en valg- eller tekstværdi er citeret som"\"cosmetic\"", et multi-select er"[\"a\",\"b\"]", og et tal er"42".