AccueilPour les prestataires logistiques Zonos Clarify Fonctionnement

Fonctionnement

Le comportement derrière les questionnaires Clarify, utile lorsque vous construisez votre propre interface ou lisez les réponses.

Branchement

Les questions peuvent dépendre de réponses antérieures, de sorte qu'un expéditeur ne voit que ce qui est pertinent. Vous n'avez pas à évaluer cette logique vous-même : sur une ligne de session, visibleQuestions est la liste prête à afficher, déjà résolue par rapport aux réponses actuelles.

Si vous préférez tout afficher côté client, le champ questions de la ligne renvoie l'ensemble complet avec le displayCondition de chaque question, afin que vous puissiez afficher et masquer les questions localement lorsque les réponses changent.

Provenance des réponses

Chaque réponse enregistre son origine :

INFERRED — préremplie par Clarify à partir des données de votre article. Comporte un score de confidence de 0 à 1.
MANUAL — saisie ou corrigée par une personne.
SUPPLIED — un fait que vous avez envoyé dans la requête (comme l'usage prévu). Il n'y a rien à confirmer, donc il n'est pas affiché comme question.

Corriger une réponse inférée la remplace par une réponse MANUAL. Une réponse finalisée conserve le mélange complet, de sorte qu'il existe toujours une trace de ce qui a été prérempli par rapport à ce qu'une personne a modifié.

Utilisez confidence pour décider du niveau de revue nécessaire — faites confirmer les réponses à faible confiance par une personne, et accélérez celles à haute confiance.

Options dynamiques

La plupart des questions listent leurs choix inline dans options. Certaines dépendent de l'article et de réponses antérieures — elles définissent optionsSource et laissent options vide.

Pour celles-ci, une ligne de session inclut une table dependentOptions couvrant chaque combinaison atteignable pour l'article. Trouvez l'entrée dont les parentValues correspondent aux réponses actuelles, puis affichez ses options — sans appels API supplémentaires.

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

Usage prévu

Passez intendedUse sur chaque article pour guider l'inférence. Lorsque le produit seul ne suffit pas à le déterminer, Clarify utilise la valeur que vous avez déclarée.

Valeur↕	Pour↕
`PERSONAL`	Consommation personnelle, cadeaux ou usage domestique (pas de revente).
`CONSUMER`	Produits grand public vendus via la distribution de détail.
`COMMERCIAL`	Usage professionnel, industriel ou de fabrication.
`RESEARCH`	Laboratoire, tests, étude scientifique ou essais cliniques.

Les flux boutique et checkout consommateur doivent envoyer CONSUMER.

Cibles et conteneurs

Cible est ce qu'un ensemble de réponses décrit :

CATALOG_ITEM — données produit réutilisables. Répondez une fois et réutilisez sur les envois.
ITEM — article d'un envoi unique. Lorsque vous répondez pour un ITEM, passez son catalogItemId afin qu'un ensemble de réponses au niveau catalogue réutilisable puisse satisfaire le programme.

Conteneur est le regroupement sous lequel les réponses sont collectées — DECLARATION, LANDED_COST, CONSIGNMENT ou CONSOLIDATION. Utilisez containerComplianceReadiness pour vérifier un conteneur entier en un appel avant le dépôt.

Prochaines étapes

Réserver une démo