DOCS

Item classification

Dashboard 및 API로 classification을 요청하는 방법을 알아봅니다.

Dashboard 또는 API를 통해 universal 및 country-specific classification을 요청하는 example을 아래에서 확인할 수 있습니다. 더 comprehensive한 technical detail과 extensive documentation은 Zonos GraphQL API reference developer site를 방문하세요. API endpoint, GraphQL mutation, extensive technical information에 대한 detailed insight를 제공합니다.

Input field 

classification 생성에는 description만 필요하지만 더 많은 product detail을 제공할수록 classification이 더 accurate해집니다. 또는 product URL만 제공하면 Classify가 relevant item detail을 자동으로 extract합니다. Classify가 accept하는 각 input field에 대한 comprehensive explanation은 아래와 같습니다. input field를 이해하면 usage를 극대화하고 highly accurate classification을 생성할 수 있습니다.

Classification 요청 

Dashboard 또는 API로 classification을 요청하려면 아래 step과 mutation을 따릅니다.

아래 example은 universal(6-digit) request를 보여줍니다. specific country로 classification을 요청하려면 아래 example처럼 Classify request에 country ISO code를 추가합니다. universal HS code를 요청하려면 Classify request에서 ship-to country를 null로 둡니다.

input은 list이므로 single 또는 many classification을 한 번에 요청할 수 있습니다.

Note: API로 audit trail을 생성하려면 query에 auditTrail field를 포함하세요. access 및 implementation detail은 Zonos representative에게 문의하세요.

1mutation ClassifyItems($input: [ClassificationCalculateInput!]!) {
2 classificationsCalculate(input: $input) {
3 id
4 name
5 categories
6 imageUrl
7 hsCode {
8 code
9 description {
10 full
11 }
12 }
13 }
14}

Possible API response

Classify가 classification request를 받으면 highest confidence score 기준으로 Classify database에서 request의 input item data와 match를 시도합니다. 발견된 내용에 따라 Classify는 다음 response 중 하나를 반환합니다:

  1. request에 ship-to country 포함 여부에 따라 6~8+ digit HS code와 함께 hsCode가 반환되면 classification request가 successful합니다.
  2. {"errors": [ { "message": "No adequate response"}]}가 반환되면 insufficient input information으로 classification을 찾을 수 없음을 의미합니다.
GraphQL API ReferenceTypes, inputs, and operations used in this guide

이 페이지가 도움이 되었나요?