Prontidão para classificação

A mutação customsDescriptionValidate verifica se as informações de um artigo são suficientes para atribuir com confiança um código HS de 6 dígitos, antes de a classificação ser executada. Devolve um estado de prontidão ao qual aplica a sua própria política—avançar para a classificação, emitir um aviso, pedir mais detalhes ao comprador ou ao comerciante, ou rejeitar o artigo.

Trata-se de uma verificação prévia, não de uma classificação: customsDescriptionValidate não classifica o artigo e não devolve um código HS. Utilize-a para detetar antecipadamente descrições insuficientes ou inutilizáveis, para que as descrições que acabar por enviar para o Classify produzam resultados precisos e sem pressupostos.

No entanto, a verificação de prontidão é apenas uma das utilizações. Como os mesmos dados do artigo alimentam os serviços de descrição aduaneira e de classificação da Zonos, esta mutação é o ponto de entrada para um fluxo de trabalho mais amplo de Customs Description—controlar a qualidade dos dados e, em seguida, gerar a partir do artigo uma descrição aduaneira em conformidade. Consulte Mais do que um filtro de classificação abaixo.

Estados de prontidão 

Cada validação devolve um único status. O estado é meramente indicativo—a sua integração decide a consequência de cada valor.

Quando o estado é INCOMPLETE, o campo missingAttributes devolve o(s) atributo(s) em falta sob a forma de uma expressão curta (por exemplo, "fiber content" ou "material, construction") adequada para compor uma mensagem destinada ao utilizador. Para qualquer outro estado, é null.

Validar um artigo através da API 

Forneça diretamente os campos do artigo—é obrigatório pelo menos um campo descritivo. O exemplo abaixo valida um artigo cujo nome e descrição o identificam como uma t-shirt, mas omitem a composição em fibras necessária para o classificar, pelo que a mutação devolve INCOMPLETE.

Campos de entrada

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

Validar um artigo existente 

Se o artigo já existir na Zonos, indique o respetivo ID em existingItemId em vez de voltar a enviar todos os campos. Os campos do artigo armazenado servem de base à validação, e quaisquer campos que também forneça na mesma entrada substituem os valores armazenados—útil para testar se uma alteração tornaria um artigo com informações insuficientes pronto para classificação.

O content da resposta reproduz os dados do artigo que foram validados, com existingItemId resolvido, para que cada CustomsDescriptionValidation armazenado seja autodescritivo.

Mais do que um filtro de classificação 

Como o estado de prontidão é meramente indicativo, a mesma verificação alimenta mais do que um fluxo de trabalho—não serve apenas para decidir se deve classificar. customsDescriptionValidate avalia os mesmos dados do artigo que os serviços de classificação e de descrição aduaneira da Zonos utilizam, o que a torna um primeiro passo natural num fluxo de trabalho mais amplo de Customs Description:

• Filtro de qualidade dos dados — Identifique informações de artigos insuficientes ou inutilizáveis no ponto de entrada (num PIM, numa importação de catálogo ou no checkout) e peça exatamente o que falta com missingAttributes, antes de esses dados seguirem para as etapas seguintes.
• Gerar uma descrição aduaneira — Assim que um artigo estiver READY, envie os mesmos dados para a mutação customsDescriptionsCreate para que a Zonos gere, a partir do artigo, uma descrição aduaneira concisa e em conformidade com as alfândegas e com o ICS2—pedindo opcionalmente um código HS na mesma chamada. Validar primeiro a prontidão significa que a descrição gerada é construída com base em informações completas e não em pressupostos.
• Classificar com confiança — Avance para o Classify sabendo que a descrição é suficientemente rica para atribuir um código HS de 6 dígitos preciso, sem suposições.

Um fluxo típico de ponta a ponta é: validar a prontidão → recolher eventuais missingAttributes → gerar uma descrição aduaneira em conformidade (e o código HS) → classificar ou submeter.