Prontidão de classificação

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

É uma verificação pré-voo, não uma classificação:customsDescriptionValidate faz não classifica o item e faz não retorne um HS code. Use-o para capturar antecipadamente descrições limitadas ou inutilizáveis, para que as descrições que você eventualmente envia para Classify produzir resultados precisos e livres de suposições.

A verificação de prontidão é apenas um uso. Como os mesmos dados de item orientam os serviços de descrição e classificação alfandegária de Zonos, essa mutação é o ponto de entrada para uma abordagem mais ampla Descrição Aduaneira fluxo de trabalho – controlando a qualidade dos dados e, em seguida, gerando uma descrição alfandegária compatível do item. Ver Mais do que uma porta de classificação abaixo.

Status de prontidão 

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

Quando o estado é INCOMPLETE , o missingAttributescampo retorna o(s) atributo(s) ausente(s) como uma frase curta (por exemplo"fiber content" ou "material, construction") que é adequado para redigir uma mensagem voltada ao usuário. Isso é 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 conteúdo de fibra necessário para classificá-lo, então 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 em Zonos, passe seu ID como existingItemId em vez de reenviar todos os campos. Os campos do item armazenado são usados ​​como base para validação, e quaisquer campos que você também fornecer na mesma entrada substituem os valores armazenados – útil para testar se uma edição deixaria um item fino pronto para classificação.

A resposta content ecoa os dados do item que foi validado, com existingItemIdresolvido, então cada um armazenado CustomsDescriptionValidation é autodescritivo.

Mais que uma porta de classificação 

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

• Portão de qualidade de dados — Exiba informações de itens escassos 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 os dados fluam downstream.
• Gerar uma descrição alfandegária — Uma vez que um item é READY , entregue os mesmos dados ao customsDescriptionsCreate mutação para que Zonos gere um texto conciso, alfandegário e ICS2- descrição alfandegária compatível do item - opcionalmente solicitando um HS code na mesma chamada. Validar a prontidão primeiro significa que a descrição gerada é construída a partir de informações completas, e não de suposições.
• Classify com confiança - Prossiga para Classify saber 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 qualquer missingAttributes → gerar uma descrição alfandegária compatível (e HS code) → classificar ou arquivar.