DOCS

Classificando itens

Classificando itens

Aprenda como solicitar uma classificação no Dashboard e via API.

Abaixo, você encontrará exemplos ilustrando como solicitar classificações universais e específicas de cada país através do Dashboard ou via API. Para aqueles que buscam detalhes técnicos mais abrangentes e documentação extensa, visite nosso site de referência da API GraphQL do Zonos. Este recurso abrangente oferece insights detalhados sobre endpoints da API, mutações GraphQL e informações técnicas extensas.

Campos de entrada 

Embora apenas uma descrição seja necessária para gerar uma classificação, quanto mais detalhes do produto você fornecer, mais precisa será sua classificação. Abaixo está uma explicação abrangente de cada campo de entrada aceito pelo Classify. Ao entender esses campos de entrada, você pode maximizar seu uso e gerar classificações altamente precisas.

Descrições dos campos de entrada

CampoDescrição
Nome (obrigatório)O nome do produto
Descrição (opcional)Uma descrição detalhada e longa do produto
URL da imagem (opcional)Link para uma imagem do produto. Nota: Certifique-se de usar um link para a URL da imagem real e não para a URL da página do produto
Categorias (opcional)Subcategorias gerais de produtos, por exemplo, Roupas e Acessórios, Suprimentos para Animais de Estimação, Produtos de Escritório ou Roupas de Bebê, Camas para Animais de Estimação, Adesivos e Fitas
Material (opcional)O que o produto é feito, por exemplo, plástico, madeira, aço
País de Origem (opcional)A abreviação de duas letras (código ISO) para o país de fabricação ou produção do produto
Código HS fornecido (opcional)Inclua um código HS existente em sua solicitação de classificação para orientar seu pedido. Dependendo de sua preferência e da origem do código HS fornecido, Classify pode validar o código HS e verificar sua coerência em relação aos detalhes da descrição do item. Saiba mais.
País de destino (opcional)Identifica qual país o produto será classificado. O país de destino deve ser exibido com a abreviação de duas letras (código ISO) de cada país e não o nome real do país, por exemplo, AU, não Austrália. Incluir este campo permitirá que Classify retorne um código HS específico de país com 8+ dígitos em vez do código universal de 6 dígitos. Saiba mais sobre as diferenças entre códigos HS universais e específicos de país.
ID do produto (opcional)Seu ID do produto ou qualquer número que possa ser usado para identificar exclusivamente cada produto. Se um ID do produto não for fornecido, Classify atribuirá IDs de produtos começando com 1

Nota: Se você estiver enviando seu CSV de solicitação em massa no Dashboard, o país de destino não fará parte do modelo, mas você selecionará seus países de destino após fazer o upload do seu CSV de solicitação em massa.

Solicitar uma classificação 

Para solicitar uma classificação no Dashboard ou via API, siga os passos e a mutação abaixo.

O exemplo abaixo mostra uma solicitação universal (6 dígitos). Para solicitar classificações para países específicos, adicione os 'códigos ISO' dos países na solicitação do Classify como visto no exemplo abaixo. Para solicitar um código HS universal, deixe o país de destino null na solicitação do Classify.

A entrada aceita uma lista, então você pode solicitar muitas ou uma única classificação de uma vez.

MUTATION

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
mutation {
  classificationsCalculate(
    input: [
      {
        categories: "women's clothing"
        imageUrl: "https://zonos.com/images/cozygloves.webp"
        name: "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
        configuration: { shipToCountries: KR }
      }
    ]
  ) {
    id
    name
    categories
    imageUrl
    hsCode {
      code
      description {
        full
      }
    }
  }
}

RESPOSTA

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "data": {
    "classificationsCalculate": [
      {
        "id": "classification_313d8d9d-e330-4d79-9922-cb7a1ff317e2",
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
        "categories": ["women's clothing"],
        "imageUrl": null,
        "hsCode": {
          "code": "6116.99.0000",
          "description": {
            "full": "Articles of apparel and clothing accessories, knitted or crocheted: Gloves, mittens and mitts, knitted or crocheted: Other : Of other textile materials"
          }
        }
      }
    ]
  }
}

Possíveis respostas da API

Quando Classify recebe uma solicitação de classificação, ele tenta corresponder os dados do item de entrada incluídos na solicitação com uma correspondência na base de dados de Classify's com base na maior pontuação de confiança. Com base no que é encontrado, Classify retornará uma das seguintes respostas:

  1. Quando hsCode é retornado com um código HS de 6 a 8+ dígitos, dependendo se um país de envio foi incluído na solicitação ou não, sua solicitação de classificação foi bem-sucedida.
  2. Quando {"errors": [ { "message": "No adequate response"}]} é retornado, isso significa que Classify não conseguiu encontrar uma classificação devido a informações de entrada insuficientes.

Esta página foi útil?