작동 방식

자체 UI를 구축하거나 응답을 읽을 때 유용한, Clarify 설문지의 동작 방식입니다.

분기

질문은 이전 답변에 따라 달라질 수 있으므로, 배송자는 자신과 관련 있는 질문만 보게 됩니다. 이 로직을 직접 판단할 필요는 없습니다. 세션 라인에서 visibleQuestions는 현재 답변을 기준으로 이미 처리된, 곧바로 렌더링할 수 있는 목록입니다.

모든 항목을 클라이언트 측에서 렌더링하려는 경우에는 해당 라인의 questions 필드가 각 질문의 displayCondition과 함께 전체 목록을 반환하므로, 답변이 바뀔 때마다 로컬에서 질문을 표시하거나 숨길 수 있습니다.

답변 출처

모든 답변에는 출처가 기록됩니다:

INFERRED - 보내신 상품 데이터를 바탕으로 Clarify가 미리 채운 답변입니다. 0에서 1 사이의 confidence(신뢰도) 점수를 포함합니다.
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를 전송해야 합니다.

대상과 컨테이너

Target은 답변 집합이 설명하는 대상입니다:

CATALOG_ITEM - 재사용 가능한 상품 마스터 데이터입니다. 한 번 답변해 두면 여러 배송에서 재사용할 수 있습니다.
ITEM - 개별 배송의 항목입니다. ITEM에 답변할 때는 catalogItemId를 함께 전달하면, 재사용 가능한 카탈로그 수준의 답변 집합으로 해당 요건을 충족할 수 있습니다.

Container는 답변을 수집하는 단위입니다 — DECLARATION, LANDED_COST, CONSIGNMENT, CONSOLIDATION 중 하나입니다. 신고하기 전에 containerComplianceReadiness를 사용해 컨테이너 전체를 한 번의 호출로 확인하세요.

다음 단계

데모 예약하기