HjemTil logistikudbydere Zonos Clarify Sådan fungerer det

Sådan fungerer det

Adfærden bag Clarify-spørgeskemaer, der er nyttig, når du bygger dit eget UI eller læser svar.

Forgrening

Spørgsmål kan afhænge af tidligere svar, så en afsender kun ser det, der er relevant. Du behøver ikke evaluere den logik selv: på en sessionslinje er visibleQuestions den klar-til-visning-liste, allerede opløst mod de aktuelle svar.

Hvis du hellere vil gengive alt client-side, returnerer linjens questions-felt det fulde sæt med hvert spørgsmåls displayCondition, så du kan vise og skjule spørgsmål lokalt, når svar ændres.

Svaroprindelse

Hvert svar registrerer, hvor det kom fra:

INFERRED — forududfyldt af Clarify fra dine varedata. Medfører en confidence-score fra 0 til 1.
MANUAL — indtastet eller rettet af en person.
SUPPLIED — et faktum, du sendte i anmodningen (såsom intended use). Der er intet at bekræfte, så det vises ikke som et spørgsmål.

Rettelse af et infereret svar erstatter det med et MANUAL-svar. Et finaliseret svar bevarer hele blandingen, så der altid er en registrering af, hvad der blev forududfyldt mod hvad en person ændrede.

Brug confidence til at afgøre, hvor meget gennemgang et svar kræver — vis svar med lav confidence til en person for bekræftelse, og fast-track svar med høj confidence.

Dynamiske valgmuligheder

De fleste spørgsmål lister deres valg inline i options. Nogle afhænger af varen og tidligere svar — disse sætter optionsSource og lader options være tom.

For disse inkluderer en sessionslinje en dependentOptions-tabel, der dækker alle opnåelige kombinationer for varen. Find posten, hvis parentValues matcher de aktuelle svar, og vis derefter dens options — ingen ekstra API-kald.

{
  "questionCode": "fda_product_code",
  "dependsOn": ["intended_use"],
  "entries": [
    {
      "parentValues": [{ "questionCode": "intended_use", "value": "cosmetic" }],
      "options": [
        { "value": "53", "label": "Cosmetics" },
        { "value": "53A", "label": "Skin care preparations" }
      ]
    }
  ]
}

Intended use

Send intendedUse på hver vare for at guide inferens. Når produktet alene ikke er nok til at bestemme det, bruger Clarify den værdi, du erklærede.

Value↕	For↕
`PERSONAL`	Personligt forbrug, gaver eller husholdningsbrug (ikke videresalg).
`CONSUMER`	Generelle forbrugerprodukter solgt gennem detailkanaler.
`COMMERCIAL`	Erhvervs-, produktions- eller industrielle formål.
`RESEARCH`	Laboratorium, test, videnskabelige studier eller kliniske forsøg.

Storefront- og forbruger-checkout-flows bør sende CONSUMER.

Targets og containere

Target er hvad et sæt svar beskriver:

CATALOG_ITEM — genanvendelige produktmasterdata. Svar én gang og genbrug det på tværs af forsendelser.
ITEM — en enkelt forsendelses vare. Når du svarer for et ITEM, send dets catalogItemId, så et genanvendeligt katalogniveau-svar kan opfylde programmet.

Container er grupperingen, som svarene indsamles under — DECLARATION, LANDED_COST, CONSIGNMENT eller CONSOLIDATION. Brug containerComplianceReadiness til at tjekke en hel container i ét kald, før du indgiver.

Næste skridt

Book en demo