HomePer i fornitori di logistica Zonos Clarify Come funziona

Come funziona

Il comportamento dei questionari Clarify, utile quando crei una tua UI oppure leggi le risposte.

Ramificazione

Le domande possono dipendere dalle risposte precedenti, quindi il mittente vede solo ciò che è rilevante. Non devi valutare tu stesso questa logica: su una riga di sessione, visibleQuestions è l'elenco pronto per il rendering, già risolto rispetto alle risposte attuali.

Se preferisci eseguire il rendering di tutto lato client, il campo questions della riga restituisce l'intero set con il displayCondition di ciascuna domanda, così puoi mostrare e nascondere le domande localmente man mano che le risposte cambiano.

Provenienza della risposta

Ogni risposta registra da dove proviene:

INFERRED - precompilata da Clarify a partire dai dati dell'articolo. Ha un punteggio di confidence da 0 a 1.
MANUAL - inserita o corretta da una persona.
SUPPLIED - un dato che hai inviato nella richiesta (come la destinazione d'uso). Non c'è nulla da confermare, quindi non viene mostrata come domanda.

Correggere una risposta dedotta la sostituisce con una di tipo MANUAL. Una risposta finalizzata mantiene l'intero mix, quindi c'è sempre una registrazione di ciò che è stato precompilato rispetto a ciò che una persona ha modificato.

Usa confidence per decidere quanta revisione richiede una risposta: mostra le risposte a bassa confidenza affinché una persona le confermi, e velocizza il percorso per quelle ad alta confidenza.

Opzioni dinamiche

La maggior parte delle domande elenca le proprie opzioni direttamente in options. Alcune dipendono dall'articolo e dalle risposte precedenti: queste impostano optionsSource e lasciano options vuoto.

Per queste, una riga di sessione include una tabella dependentOptions che copre ogni combinazione raggiungibile per l'articolo. Trova la voce il cui parentValues corrisponde alle risposte attuali, quindi mostra le sue options — nessuna chiamata API aggiuntiva.

{
  "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" }
      ]
    }
  ]
}

Destinazione d'uso

Passa intendedUse su ogni articolo per guidare l'inferenza. Quando il prodotto da solo non è sufficiente per determinarla, Clarify utilizza il valore che hai dichiarato.

Valore↕	Per↕
`PERSONAL`	Consumo personale, regali o uso domestico (non rivendita).
`CONSUMER`	Prodotti di consumo generici venduti attraverso canali di vendita al dettaglio.
`COMMERCIAL`	Scopi commerciali, produttivi o industriali.
`RESEARCH`	Laboratorio, test, studio scientifico o sperimentazioni cliniche.

I flussi di storefront e di checkout dei consumatori dovrebbero inviare CONSUMER.

Target e contenitori

Target è ciò che descrive un insieme di risposte:

CATALOG_ITEM - dati anagrafici di prodotto riutilizzabili. Rispondi una volta e riutilizzali per più spedizioni.
ITEM - un singolo articolo di una spedizione. Quando rispondi per un ITEM, passa il suo catalogItemId in modo che un insieme di risposte riutilizzabile a livello di catalogo possa soddisfare il programma.

Container è il raggruppamento in cui vengono raccolte le risposte — DECLARATION, LANDED_COST, CONSIGNMENT o CONSOLIDATION. Usa containerComplianceReadiness per verificare un intero contenitore in un'unica chiamata prima di procedere con la dichiarazione.

Passaggi successivi

Prenota una demo