Ableiten und vorausfüllen
complianceQuestionnaireInfer löst die zutreffenden Programme für Ihre Artikel
auf, öffnet eine Sitzung und beantwortet Fragen anhand Ihrer Artikeldaten
vorab. Jede vorausgefüllte Antwort hat provenance: INFERRED und einen
confidence-Score.
Übergeben Sie intendedUse, um die Ableitung zu steuern — Storefront-Flows
sollten CONSUMER senden.
mutation InferQuestionnaire($input: ComplianceQuestionnaireInferInput!) { complianceQuestionnaireInfer(input: $input) { session { id status lines { id programId status currentQuestion { code prompt answerType } } } lines { lineId state remainingRequiredCount } }}Der state jeder Zeile zeigt Ihnen, was als Nächstes ansteht:
READY_TO_ATTEST- jede erforderliche Frage ist beantwortet. Gehen Sie direkt zu Bestätigen (unten).PARTIAL- einige Antworten wurden vorausgefüllt, aber erforderliche Fragen bleiben offen. Beantworten Sie sie beicurrentQuestion.NOT_INFERRED- nichts konnte vorausgefüllt werden; beantworten Sie es als einfachen Fragebogen.
Bereits durch eine bestehende Antwort erfüllte Programme werden übersprungen und
in alreadySatisfied zurückgegeben (oben ausgelassen).
Prüfen und korrigieren
Die Sitzung enthält vorausgefüllte Antworten — keine finalisierte Antwort. Für jede Antwort kann der Versender entweder:
- sie akzeptieren — unverändert lassen, und sie bleibt
INFERRED, oder - sie korrigieren — einen neuen Wert mit
questionnaireAnswersSubmitsenden, der zuMANUALwird.
Senden Sie eine oder mehrere Antworten gleichzeitig. Clarify setzt
currentQuestion auf die nächste verbleibende Frage und finalisiert, wenn keine
mehr übrig sind, die Antwort der Zeile (ihre responseId wird befüllt).
Der Versender akzeptiert beispielsweise den abgeleiteten intended_use, korrigiert
aber contains_color_additives, und sendet daher nur diese eine Antwort:
mutation SubmitAnswers($input: QuestionnaireAnswersSubmitInput!) { questionnaireAnswersSubmit(input: $input) { status lines { id status responseId answers { questionCode value provenance confidence } } }}Bestätigen
Wenn eine Zeile READY_TO_ATTEST ist — jede erforderliche Antwort bereits
vorausgefüllt und der Versender einverstanden — akzeptieren Sie sie in einem
Aufruf mit questionnaireSessionAttest. Es finalisiert jede berechtigte Zeile
oder nur die lineIds, die Sie übergeben.
mutation AttestSession($input: QuestionnaireSessionAttestInput!) { questionnaireSessionAttest(input: $input) { id status lines { id status responseId } }}Um eine laufende Sitzung zu verwerfen, rufen Sie questionnaireSessionAbandon(id: ID!)
auf.
Vollständige Antwort senden
Wenn Sie bereits jede Antwort haben — beispielsweise einen wiederverwendbaren
Antwortsatz für ein CATALOG_ITEM — überspringen Sie die Sitzung und senden
direkt mit questionnaireResponseSubmit. Es ersetzt jede vorherige Antwort für
denselben Artikel und dasselbe Programm.
mutation SubmitResponse($input: QuestionnaireResponseSubmitInput!) { questionnaireResponseSubmit(input: $input) { id status completedAt answers { questionCode value provenance } }}Sie möchten ohne Ableitung antworten? questionnaireSessionStart öffnet eine
Sitzung für die von Ihnen gewählten Programme, und anschließend verwenden Sie
dieselben Aufrufe Prüfen und korrigieren und Bestätigen wie oben.
Antworten und Bereitschaft lesen
Rufen Sie einen finalisierten Datensatz mit questionnaireResponse(id) ab und
prüfen Sie mit containerComplianceReadiness, ob ein gesamter Container zur
Einreichung bereit ist — ready ist nur true, wenn jede Zeile eine vollständige
Antwort hat.
query ContainerReadiness($containerType: ContainerType!, $containerId: ID!) { containerComplianceReadiness( containerType: $containerType containerId: $containerId ) { ready totalLineCount outstandingLineCount }}Nächste Schritte
- So funktioniert es - Verzweigung, Herkunft, dynamische Optionen und Intended Use.
- Compliance-Anforderungen prüfen - Programme ermitteln und Fragebogenstrukturen lesen.
Fragebogen ausfüllen
Clarify füllt vor, was es aus Ihren Artikeldaten kann; Sie bestätigen oder korrigieren den Rest und finalisieren dann.
GraphQL
Sobald Sie wissen, welche Programme gelten (siehe Compliance-Anforderungen prüfen), ist der empfohlene Ablauf drei Aufrufe:
complianceQuestionnaireInferöffnet eine Sitzung mit aus Ihren Artikeldaten vorausgefüllten Antworten.questionnaireAnswersSubmit, um alles zu ändern, womit der Versender nicht einverstanden ist, und den Rest zu beantworten.questionnaireSessionAttest, um zu akzeptieren und zu finalisieren.Wenn Sie bereits jede Antwort haben, können Sie stattdessen in einem Aufruf eine vollständige Antwort senden — siehe Vollständige Antwort senden unten.
Zum Lesen ist der Scope
COMPLIANCE_READerforderlich; zum Senden von AntwortenCOMPLIANCE_WRITE. Siehe OAuth.Jeder Antwort-
valueist ein JSON-codierter String: ein Boolean ist"true", ein Auswahl- oder Textwert ist in Anführungszeichen wie"\"cosmetic\"", eine Mehrfachauswahl ist"[\"a\",\"b\"]"und eine Zahl ist"42".