DOCS

Como funciona

O comportamento por detrás dos questionários do Clarify, útil quando cria a sua própria interface ou lê as respostas.

Ramificação 

As perguntas podem depender de respostas anteriores, pelo que o expedidor só vê o que é relevante. Não precisa de avaliar essa lógica por si: numa linha de sessão, visibleQuestions é a lista pronta a apresentar, já resolvida com base nas respostas atuais.

Se preferir apresentar tudo do lado do cliente, o campo questions da linha devolve o conjunto completo com o displayCondition de cada pergunta, para que possa mostrar e ocultar perguntas localmente à medida que as respostas mudam.

Proveniência das respostas 

Cada resposta regista a sua origem:

  • INFERRED - pré-preenchida pelo Clarify a partir dos dados do seu artigo. Inclui uma pontuação confidence de 0 a 1.
  • MANUAL - introduzida ou corrigida por uma pessoa.
  • SUPPLIED - um dado que enviou no pedido (como a utilização prevista). Não há nada a confirmar, por isso não é apresentada como pergunta.

Corrigir uma resposta inferida substitui-a por uma resposta MANUAL. Uma resposta finalizada mantém a combinação completa, pelo que existe sempre um registo do que foi pré-preenchido e do que uma pessoa alterou.

Utilize confidence para decidir quanta revisão uma resposta necessita — destaque as respostas de baixa confiança para que uma pessoa as confirme e acelere as de alta confiança.

Opções dinâmicas 

A maioria das perguntas indica as suas opções diretamente em options. Algumas dependem do artigo e de respostas anteriores — estas definem optionsSource e deixam options vazio.

Para essas, uma linha de sessão inclui uma tabela dependentOptions que abrange todas as combinações possíveis para o artigo. Encontre a entrada cujos parentValues correspondem às respostas atuais e, em seguida, mostre as respetivas options — sem chamadas adicionais à 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" }
      ]
    }
  ]
}

Utilização prevista 

Envie intendedUse em cada artigo para orientar a inferência. Quando o produto, por si só, não é suficiente para a determinar, o Clarify utiliza o valor que declarou.

Valor↕Para↕
PERSONALConsumo pessoal, presentes ou uso doméstico (não para revenda).
CONSUMERProdutos de consumo geral vendidos através de canais de retalho.
COMMERCIALFins empresariais, de fabrico ou industriais.
RESEARCHLaboratório, testes, estudos científicos ou ensaios clínicos.

Os fluxos de loja online e de checkout para consumidores devem enviar CONSUMER.

Alvos e contentores 

O alvo é aquilo que um conjunto de respostas descreve:

  • CATALOG_ITEM - dados mestre de produto reutilizáveis. Responda uma vez e reutilize-os em todas as remessas.
  • ITEM - o artigo de uma única remessa. Ao responder para um ITEM, envie o respetivo catalogItemId para que um conjunto de respostas reutilizável ao nível do catálogo possa satisfazer o programa.

O contentor é o agrupamento sob o qual as respostas são recolhidas — DECLARATION, LANDED_COST, CONSIGNMENT ou CONSOLIDATION. Utilize containerComplianceReadiness para verificar um contentor inteiro numa única chamada antes de submeter a declaração.

Esta página foi útil?