Prontidão de classificação

A mutação customsDescriptionValidate verifica se as informações de um item são suficientes para atribuir com confiança um HS code de 6 dígitos, antes que a classificação seja executada. Ela retorna um status de prontidão ao qual você aplica sua própria política – prosseguir para classificar, avisar, pedir mais detalhes ao comprador ou comerciante, ou rejeitar o item.

É uma verificação pré-voo, não uma classificação: o customsDescriptionValidate não classifica o item e não retorna um HS code. Use-o para identificar antecipadamente descrições vagas ou inutilizáveis, para que as descrições que você eventualmente enviar para Classify produzam resultados precisos e livres de suposições.

No entanto, a verificação de prontidão é apenas um dos usos. Como os mesmos dados do item alimentam os serviços de descrição aduaneira e classificação da Zonos, esta mutação é o ponto de entrada para um fluxo de trabalho mais amplo de Descrição Aduaneira – controlando a qualidade dos dados e, em seguida, gerando uma descrição aduaneira compatível a partir do item. Veja Mais do que um portão de classificação abaixo.

Status de prontidão 

Cada validação retorna um status. O status é apenas consultivo – sua integração decide a consequência de cada valor.

Quando o status é INCOMPLETE, o campo missingAttributes retorna o(s) atributo(s) ausente(s) como uma frase curta (por exemplo, "fiber content" ou "material, construction") adequada para compor uma mensagem voltada ao usuário. É null para qualquer outro status.

Valide um item via API 

Forneça os campos do item diretamente – pelo menos um campo descritivo é obrigatório. O exemplo abaixo valida um item cujo nome e descrição o identificam como uma camiseta, mas omitem o teor de fibra necessário para classificá-lo, portanto a mutação retorna INCOMPLETE.

Campos de entrada

Forneça existingItemId ou os campos do item diretamente – pelo menos um campo descritivo é obrigatório.

Validar um item existente 

Se o item já existir na Zonos, informe o ID dele como existingItemId em vez de reenviar todos os campos. Os campos do item armazenado são usados como base para a validação, e quaisquer campos que você também informar na mesma entrada substituem os valores armazenados – útil para testar se uma edição tornaria um item com informações insuficientes pronto para classificação.

A resposta content reflete os dados do item que foi validado, com o existingItemId resolvido, de modo que cada CustomsDescriptionValidation armazenado seja autodescritivo.

Mais do que um portão de classificação 

Como o status de prontidão é apenas consultivo, a mesma verificação alimenta mais de um fluxo de trabalho – não se trata apenas de decidir se deve classificar ou não. O customsDescriptionValidate avalia os mesmos dados do item que os serviços de classificação e descrição aduaneira da Zonos consomem, o que o torna um primeiro passo natural em um fluxo de trabalho mais amplo de Descrição Aduaneira:

• Portão de qualidade de dados — Identifique informações de item vagas ou inutilizáveis no ponto de entrada (em um PIM, importação de catálogo ou checkout) e solicite exatamente o que está faltando usando missingAttributes, antes que esses dados sigam adiante no fluxo.
• Gerar uma descrição aduaneira — Assim que um item estiver READY, envie os mesmos dados para a mutação customsDescriptionsCreate para que a Zonos gere, a partir do item, uma descrição aduaneira concisa e compatível com o ICS2 – opcionalmente solicitando um HS code na mesma chamada. Validar a prontidão primeiro garante que a descrição gerada seja construída a partir de informações completas, e não de suposições.
• Classifique com confiança — Prossiga para Classify sabendo que a descrição é rica o suficiente para atribuir um HS code preciso de 6 dígitos sem suposições.

Um fluxo típico de ponta a ponta é: validar a prontidão → coletar quaisquer missingAttributes → gerar uma descrição aduaneira compatível (e o HS code) → classificar ou arquivar.