DOCS
StartpaginaVoor logistieke dienstverleners Zonos Clarify Vragenlijst voltooien

Vragenlijst voltooien

Clarify vult vooraf in wat het kan uit uw itemdata; u bevestigt of corrigeert de rest en rondt vervolgens af.

GraphQL

Zodra u weet welke programma's van toepassing zijn (zie Compliance-vereisten controleren), bestaat de aanbevolen flow uit drie calls:

  1. Afleiden - complianceQuestionnaireInfer opent een sessie met antwoorden die zijn vooraf ingevuld op basis van uw itemdata.
  2. Beoordelen en corrigeren - questionnaireAnswersSubmit om alles te wijzigen waarmee de verzender niet akkoord gaat en om wat overblijft te beantwoorden.
  3. Attesteren - questionnaireSessionAttest om te accepteren en af te ronden.

Als u al over elk antwoord beschikt, kunt u in plaats daarvan een volledig antwoord in één call indienen — zie Volledig antwoord indienen hieronder.

Scopes

Lezen vereist de COMPLIANCE_READ-scope; antwoorden indienen vereist COMPLIANCE_WRITE. Zie OAuth.

Antwoordwaarden zijn JSON-gecodeerd

Elke antwoord-value is een JSON-gecodeerde string: een boolean is "true", een select- of tekstwaarde staat tussen aanhalingstekens zoals "\"cosmetic\"", een multi-select is "[\"a\",\"b\"]" en een getal is "42".

Afleiden en voorinvullen 

complianceQuestionnaireInfer bepaalt de toepasselijke programma's voor uw items, opent een sessie en vult vragen vooraf in op basis van uw itemdata. Elk vooraf ingevuld antwoord heeft provenance: INFERRED en een confidence-score.

Geef intendedUse door om de inferentie te sturen — storefront-flows moeten CONSUMER verzenden.

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}

De state van elke lijn vertelt u wat de volgende stap is:

  • READY_TO_ATTEST - elke verplichte vraag is beantwoord. Ga direct naar Attesteren (hieronder).
  • PARTIAL - sommige antwoorden zijn vooraf ingevuld, maar er zijn nog verplichte vragen. Beantwoord deze bij currentQuestion.
  • NOT_INFERRED - er kon niets vooraf worden ingevuld; beantwoord deze als een gewone vragenlijst.

Programma's die al zijn voldaan door een bestaand antwoord worden overgeslagen en geretourneerd in alreadySatisfied (hierboven weggelaten).

Beoordelen en corrigeren 

De sessie bevat vooraf ingevulde antwoorden — geen definitief antwoord. Voor elk antwoord doet de verzender een van de volgende twee dingen:

  • accepteert het — laat het ongewijzigd, en het blijft INFERRED, of
  • corrigeert het — dient een nieuwe waarde in met questionnaireAnswersSubmit, waardoor het MANUAL wordt.

Dien één antwoord of meerdere tegelijk in. Clarify verplaatst currentQuestion naar de volgende resterende vraag en rondt, wanneer er geen meer over zijn, het antwoord van de lijn af (de bijbehorende responseId wordt ingevuld).

Geaccepteerde antwoorden worden bewaard, niet verwijderd

Het corrigeren van één antwoord overschrijft alleen dat antwoord. Het definitieve antwoord bevat de volledige set — geaccepteerde antwoorden blijven INFERRED, correcties zijn MANUAL — zodat u altijd een overzicht heeft van wat de AI heeft aangeleverd versus wat een persoon heeft gewijzigd.

Zo accepteert de verzender bijvoorbeeld het geïnfereerde antwoord intended_use, maar corrigeert contains_color_additives, en dient daarom alleen dat ene antwoord in:

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}

Attesteren 

Wanneer een lijn READY_TO_ATTEST is — elk verplicht antwoord is al vooraf ingevuld en de verzender gaat akkoord — accepteert u deze in één call met questionnaireSessionAttest. Dit rondt elke in aanmerking komende lijn af, of alleen de lineIds die u doorgeeft.

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

Om een sessie die nog in behandeling is te annuleren, roept u questionnaireSessionAbandon(id: ID!) aan.

Volledig antwoord indienen 

Als u al over elk antwoord beschikt — bijvoorbeeld een herbruikbare antwoordenset voor een CATALOG_ITEM — slaat u de sessie over en dient u rechtstreeks in met questionnaireResponseSubmit. Dit vervangt elk eerder antwoord voor hetzelfde item en 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}

Wilt u liever antwoorden zonder inferentie? questionnaireSessionStart opent een sessie voor de programma's die u kiest, en vervolgens gebruikt u dezelfde calls Beoordelen en corrigeren en Attesteren als hierboven.

Antwoorden en gereedheid lezen 

Haal een definitief record op met questionnaireResponse(id) en controleer of een volledige container klaar is om in te dienen met containerComplianceReadiness — ready is alleen true wanneer elke lijn een volledig antwoord heeft.

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

Volgende stappen 

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

ComplianceQuestionnaireInferInput QuestionnaireAnswersSubmitInput QuestionnaireResponseSubmitInput QuestionnaireSessionAttestInput

MUTATIONS

complianceQuestionnaireInfer questionnaireAnswersSubmit questionnaireResponseSubmit questionnaireSessionAttest

Was deze pagina nuttig?

Krijg ondersteuning·Juridische documenten·© 2026 Zonos
Op deze pagina:
  • Vragenlijst voltooien
  • Afleiden en voorinvullen
  • Beoordelen en corrigeren
  • Attesteren
  • Volledig antwoord indienen
  • Antwoorden en gereedheid lezen
  • Volgende stappen