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.
Campo | Notas |
---|---|
items OBRIGATÓRIO | Lista de itens a serem exportados para serem classificados. |
item[index].item.age OPCIONAL | A idade do item. Por exemplo, "1784-1820" ou "3º século d.C." |
items[index].item.amount OPCIONAL | O preço do item. |
items[index].item.brand OPCIONAL | A marca do item. |
items[index].item.category OPCIONAL | A categoria do item. |
items[index].item.description OBRIGATÓRIO | A 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 OPCIONAL | Recursos adicionais, atributos ou descrições do item. |
items[index].item.gender OPCIONAL | A referência de gênero associada ao item. |
items[index].item.hs_code OPCIONAL | Quantos 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 OPCIONAL | A URL da imagem. |
items[index].item.language_code OPCIONAL | O código de idioma ISO 639-1. Se null , o inglês é o idioma padrão. |
item[index].material OPCIONAL | A composição material do item. |
item[index].product_id OPCIONAL | O identificador único do item do comerciante ou exportador para o produto. |
item[index].sub_category OPCIONAL | A categoria mais associada ao item. |
ship_to_countries OPCIONAL | Os 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,"
}
]
}
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.