DOCS

Validação de descrição aduaneira

Validação de descrição aduaneira

Verifique se a descrição de um item é completa o suficiente para classificá-lo com confiança — antes de classificar.

Por que uma descrição aduaneira completa é importante 

Todo envio transfronteiriço precisa de um código HS, e esse código só é tão bom quanto a descrição da qual ele deriva. A classificação HS impulsiona o desembaraço aduaneiro e o cálculo das tarifas e dos impostos, por isso a descrição na sua fatura comercial precisa dizer claramente o que é o item e do que ele é feito.

Quando uma descrição é vaga ou ambígua, a classificação precisa preencher as lacunas com uma suposição — e um detalhe suposto pode levar ao código HS errado. Um código errado significa tarifas e impostos errados, e aumenta o risco de atrasos no desembaraço aduaneiro, multas e outros problemas de conformidade.

A Validação de descrição aduaneira permite detectar uma descrição fraca logo no início, no momento da inserção dos dados, em vez de descobrir o problema depois que um item já foi classificado com base em uma suposição. Quando algo está faltando, ela informa exatamente qual detalhe pedir ao cliente — para que você possa corrigir a descrição antes que ela chegue à classificação. Quando estiver pronto para gerar a própria descrição, consulte Customs Description; para atribuir o código HS, consulte Classify.

Como funciona 

Você envia os campos descritivos que tem para um item — name, description, material e categories. A validação avalia se essa informação é específica o suficiente para chegar a um único código HS sem supor um fato não informado, como o teor de fibra, se um tecido é de malha ou tecido plano, ou o uso pretendido do item.

Ela retorna um status que indica quão pronta está a descrição e — quando algo está faltando — uma lista clarifications que informa exatamente o que perguntar.

A validação não classifica o item e não retorna um código HS. O status é apenas indicativo: você decide o que fazer com base em sua própria política — prosseguir para a classificação, emitir um aviso, pedir mais detalhes ao cliente ou rejeitar o item.

Duas entradas opcionais estendem a verificação:

  • existingItemId — valida um item que você já armazenou, em vez de passar seus campos diretamente. Quaisquer campos que você também informar substituem os valores armazenados.
  • shipToCountry — quando informado, a validação também verifica se a descrição é específica o suficiente para determinar a linha tarifária específica do país de destino, não apenas a subposição HS de seis dígitos.

Estados de prontidão 

O campo status retorna um de quatro valores.

StatusO que significaAção recomendada
READYA informação é suficiente para determinar o código HS com confiança, sem suposições. clarifications está vazio.Prossiga para a classificação.
INCOMPLETEO item é identificável, mas escolher entre as subposições HS plausíveis exigiria supor um detalhe não informado.Peça ao cliente o detalhe indicado em clarifications e valide ou classifique novamente.
READY_TO_SUBHEADINGA subposição de seis dígitos é determinada com confiança, mas ainda falta um detalhe para escolher a linha tarifária específica do país correta. Só é possível quando shipToCountry for informado.Opcionalmente, colete o detalhe extra para tarifas precisas, ou prossiga no nível da subposição.
UNRECOGNIZABLEO texto não estabelece o que o item fundamentalmente é — por exemplo, um valor vazio, um SKU ou código interno isolado, ou texto sem sentido.Peça ao cliente para inserir o item novamente.

Esclarecimentos 

Sempre que o status não for READY, a lista clarifications contém frases curtas e específicas que descrevem o que adicionar à descrição — por exemplo, "state the primary fiber content". Essas frases são escritas para serem exibidas diretamente ao cliente, portanto um bom padrão é apresentá-las no momento da inserção dos dados e solicitar o detalhe faltante antes de continuar.

Quando o status é READY, clarifications está vazio.

Validar uma descrição aduaneira 

Use a mutação customsDescriptionValidate. Forneça os campos do item diretamente ou faça referência a um item armazenado com existingItemId. No mínimo, inclua um campo descritivo.

1mutation CustomsDescriptionValidate(
2$input: CustomsDescriptionValidationInput!
3) {
4 customsDescriptionValidate(input: $input) {
5 status
6 clarifications
7 content {
8 name
9 description
10 material
11 categories
12 }
13 }
14}

No exemplo acima, o item é claramente identificável como uma blusa, mas roupas são classificadas parcialmente pelo material e pela construção — então escolher o código HS correto exigiria uma suposição. O status é INCOMPLETE, e clarifications informa exatamente o que pedir ao cliente. Depois que esses detalhes forem adicionados, o mesmo item é validado como READY.

Uma descrição que já contém os atributos decisivos é validada como READY sem esclarecimentos.

1{
2 "input": {
3 "name": "Men's crew-neck t-shirt",
4 "material": "100% combed cotton, knit",
5 "categories": [
6 "Apparel",
7 "Tops"
8 ]
9 }
10}

Adicionar shipToCountry verifica a prontidão até a linha tarifária do país de destino. Aqui, a subposição de seis dígitos já está determinada, então o status é READY_TO_SUBHEADING e as clarifications descrevem o que ainda é necessário para escolher a linha tarifária exata.

1{
2 "input": {
3 "name": "Pullover sweater",
4 "material": "100% cotton, knit",
5 "categories": [
6 "Apparel",
7 "Tops"
8 ],
9 "shipToCountry": "US"
10 }
11}
GraphQL API ReferenceTypes, inputs, and operations used in this guide

Esta página foi útil?