ГлавнаяДля логистических компаний Zonos Clarify Как это работает

Как это работает

Поведение опросников Clarify, которое полезно знать при создании собственного интерфейса или чтении ответов.

Ветвление

Вопросы могут зависеть от предыдущих ответов, поэтому отправитель видит только необходимое. Вам не нужно самостоятельно вычислять эту логику: в строке сеанса visibleQuestions — это готовый список для отрисовки, уже разрешённый на основе текущих ответов.

Если вы предпочитаете отрисовывать всё на клиентской стороне, поле questions строки возвращает полный набор с displayCondition каждого вопроса, чтобы вы могли показывать и скрывать вопросы локально при изменении ответов.

Источник ответа

Каждый ответ записывает, откуда он взялся:

INFERRED — предзаполнено Clarify на основе данных товара. Содержит оценку confidence от 0 до 1.
MANUAL — введено или исправлено человеком.
SUPPLIED — факт, который вы отправили в запросе (например, предполагаемое использование). Здесь нечего подтверждать, поэтому это не отображается как вопрос.

Исправление выведенного ответа заменяет его на MANUAL. Завершённый ответ сохраняет полный набор, поэтому всегда есть запись о том, что было предзаполнено, в отличие от того, что изменил человек.

Используйте confidence для определения того, сколько проверки нужно ответу — предложите ответы с низкой уверенностью для подтверждения человеком и быстро передайте дальше ответы с высокой уверенностью.

Динамические опции

Большинство вопросов перечисляют свои варианты внутри options. Некоторые зависят от товара и предыдущих ответов — они устанавливают optionsSource и оставляют options пустым.

Для этих вопросов строка сеанса включает таблицу dependentOptions со всеми доступными комбинациями для товара. Найдите запись, у которой parentValues соответствуют текущим ответам, затем отобразите её options — без дополнительных вызовов API.

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

Предполагаемое использование

Передавайте intendedUse для каждого товара для руководства выводом. Когда самого товара недостаточно для его определения, Clarify использует значение, которое вы объявили.

Значение↕	Для↕
`PERSONAL`	Личное потребление, подарки или домашнее использование (не для перепродажи).
`CONSUMER`	Обычные потребительские товары, продаваемые через розничные каналы.
`COMMERCIAL`	Деловое, производственное или промышленное использование.
`RESEARCH`	Лабораторное, тестовое, научное исследование или клинические испытания.

Витрины и потребительские потоки оформления заказов должны отправлять CONSUMER.

Цели и контейнеры

Цель — это то, что описывает набор ответов:

CATALOG_ITEM — повторно используемые главные данные товара. Ответьте один раз и переиспользуйте для всех отправлений.
ITEM — товар из одного отправления. При ответе для ITEM передавайте его catalogItemId, чтобы повторно используемый набор ответов на уровне каталога мог удовлетворить программу.

Контейнер — это группировка, под которой собираются ответы — DECLARATION, LANDED_COST, CONSIGNMENT или CONSOLIDATION. Используйте containerComplianceReadiness для проверки целого контейнера в одном вызове перед подачей.

Следующие шаги

Записаться на демонстрацию