DOCS

Request a bulk classification

/

Solicitar uma classificação em massa

Explore os pares chave/valor em uma solicitação de classificação em massa.

Crie uma nova solicitação para a classificação em massa de um item para os códigos HS universais (6 dígitos) ou específicos do país (8+ dígitos). O limite de solicitação de classificação em massa é baseado no tempo limite de 90 segundos da AWS, o que resulta em cerca de 2.000 classificações.

Nota: Para obter uma classificação, você deve fornecer uma descrição. É você quem decide quais campo(s) fornecer, mas recomendamos que forneça o máximo de informações possível para receber uma classificação mais precisa.

Atributos 

Pares chave/valor JSON no corpo da solicitação

POST | https://api.zonos.com/v1/classify/bulk

O cabeçalho acima é uma entrada obrigatória para que esta solicitação de classificação em massa seja concluída com sucesso.

CampoNotas
items OBRIGATÓRIOLista de itens a serem exportados para serem classificados.
item[index].item.age OPCIONALA idade do item. Por exemplo, "1784-1820" ou "3º século d.C."
items[index].item.amount OPCIONALO preço do item.
items[index].item.brand OPCIONALA marca do item.
items[index].item.category OPCIONALA categoria do item.
items[index].item.description OBRIGATÓRIOA descrição dos produtos para a fatura comercial. Esta descrição geralmente difere da descrição de varejo e normalmente inclui uma descrição geral do que é, do que é feito e para que é usado.
items[index].item.detail OPCIONALRecursos adicionais, atributos ou descrições do item.
items[index].item.gender OPCIONALA referência de gênero associada ao item.
items[index].item.hs_code OPCIONALQuantos dígitos conhecidos do código HS, que serão usados para sub-classificações. Por exemplo, se você estiver classificando uma lista de roupas de malha, insira "61" para forçar a lógica a encontrar códigos dentro do capítulo 61.
items[index].item.image_url OPCIONALA URL da imagem.
items[index].item.language_code OPCIONALO código de idioma ISO 639-1. Se null, o inglês é o idioma padrão.
item[index].material OPCIONALA composição material do item.
item[index].product_id OPCIONALO identificador único do item do comerciante ou exportador para o produto.
item[index].sub_category OPCIONALA categoria mais associada ao item.
ship_to_countries OPCIONALOs países de destino, representados por um código ISO de duas letras. Este campo é obrigatório para uma classificação de oito dígitos+ específica do país HTS.

Exemplo de solicitação

CLASSIFY CLASSIFICAÇÃO

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
{
  "items": [
    {
      "item": {
        "id": "29342",
        "amount": 12.99,
        "brand": null,
        "category": "women's clothing",
        "description": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
        "detail": null,
        "gender": "women",
        "hs_code": "6116",
        "image_url": "https://zonos.com/images/cozygloves.png",
        "item_age": null,
        "language_code": "en",
        "material": "cotton",
        "product_id": "895669256385",
        "sub_category": "women's accessories"
      }
    },
    {
      "item": {
        "id": "29343",
        "amount": 19.99,
        "brand": null,
        "category": null,
        "description": "Cadet Army Cap Basic Everyday Military Style Hat",
        "detail": null,
        "gender": "men's",
        "hs_code": null,
        "image_url": "https://zonos.com/images/cadethat.png",
        "item_age": null,
        "language_code": "en",
        "material": null,
        "product_id": "895669256378",
        "sub_category": null
      }
    },
    {
      "item": {
        "id": "29344",
        "amount": 45.29,
        "brand": "Ray Ban",
        "category": "Accessories",
        "description": "Vintage Aviator Square Sunglasses",
        "detail": null,
        "gender": null,
        "hs_code": null,
        "image_url": "https://zonos.com/images/vintagesunglasses.png",
        "item_age": null,
        "language_code": "en",
        "material": null,
        "product_id": "895669256399",
        "sub_category": "Sunglasses"
      }
    }
  ],
  "ship_to_countries": ["CA", "FR"]
}

Exemplo de resposta

CLASSIFY OBJETO

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
{
  "items": [
    {
      "id": "29342",
      "ship_to_country": "CA",
      "hs_code": "6116.99.0000",
      "tariff_description": "Of other textile materials",
      "chapter": "61",
      "chapter_description": "Apparel and clothing, knitted or crocheted",
      "heading": "6116",
      "heading_description": "Gloves, mittens, and mitts, knitted or crocheted",
      "subheading": "6116.99",
      "subheading_description": "Gloves, mittens, and mitts of other textile materials",
      "combinedDescription": "Of other textile materials: of other textile materials",
      "truncatedCombinedDescription": "Of other textile materials: of other textile"
    },
    {
      "id": "29342",
      "ship_to_country": "FR",
      "hs_code": "6116.99.0000",
      "tariff_description": "Of other textile materials",
      "chapter": "61",
      "chapter_description": "Apparel and clothing, knitted or crocheted",
      "heading": "6116",
      "heading_description": "Gloves, mittens, and mitts, knitted or crocheted",
      "subheading": "6116.99",
      "subheading_description": "Gloves, mittens, and mitts of other textile materials",
      "combinedDescription": "Of other textile materials: of other textile materials",
      "truncatedCombinedDescription": "Of other textile materials: of other textile"
    },
    {
      "id": "29343",
      "ship_to_country": "CA",
      "hs_code": "6505.00.4000",
      "tariff_description": "Other hats, hoods, caps, bonnets or berets",
      "chapter": "65",
      "chapter_description": "Hats and headgear",
      "heading": "6505",
      "heading_description": "Hats and other headgear of textile materials; visors, hairnets, etc.",
      "subheading": "6505.00",
      "subheading_description": "knitted hats and visors",
      "combinedDescription": "Other hats, hoods, caps, bonnets or berets",
      "truncatedCombinedDescription": "Other hats, hoods, caps, bonnets or berets"
    },
    {
      "id": "29343",
      "ship_to_country": "FR",
      "hs_code": "6505.00.3000",
      "tariff_description": "Peaked caps",
      "chapter": "65",
      "chapter_description": "Hats and headgear",
      "heading": "6505",
      "heading_description": "Hats and other headgear of textile materials; visors, hairnets, etc.",
      "subheading": "6505.00",
      "subheading_description": "knitted hats and visors",
      "combinedDescription": "Hats and other headgear, knitted or crocheted, or made up from lace, felt or other textile fabric, in the piece (but not in strips), whether or not lined or trimmed; hair-nets of any material, whether or not lined or trimmed: Peaked caps",
      "truncatedCombinedDescription": "Hats and other headgear, knitted or crocheted"
    },
    {
      "id": "29344",
      "ship_to_country": "CA",
      "hs_code": "9004.10.0000",
      "tariff_description": "Sunglasses",
      "chapter": "90",
      "chapter_description": "Optic fiber cables, optical lenses, glasses, binoculars, cameras and projectors, medical appliances, and other measuring instruments",
      "heading": "9004",
      "heading_description": "Eyewear",
      "subheading": "9004.10",
      "subheading_description": "Sunglasses",
      "combinedDescription": "Spectacles, goggles and the like, corrective, protective or other: sunglasses: Sunglasses",
      "truncatedCombinedDescription": "Spectacles, goggles and the like, corrective,"
    },
    {
      "id": "29344",
      "ship_to_country": "FR",
      "hs_code": "9004.10.9900",
      "tariff_description": "Other: other",
      "chapter": "90",
      "chapter_description": "Optic fiber cables, optical lenses, glasses, binoculars, cameras and projectors, medical appliances, and other measuring instruments",
      "heading": "9004",
      "heading_description": "Eyewear",
      "subheading": "9004.10",
      "subheading_description": "Sunglasses",
      "combinedDescription": "Spectacles, goggles and the like, corrective, protective or other: sunglasses",
      "truncatedCombinedDescription": "Spectacles, goggles and the like, corrective,"
    }
  ]
}

Esta página foi útil?