DOCS
Classify•
홈물류 제공업체용 Classify 품목 분류

품목 분류

Dashboard와 API로 분류를 요청하는 방법을 알아보세요.

아래에서 Dashboard 또는 API를 통해 범용 분류와 국가별 분류를 요청하는 예시를 확인할 수 있습니다. 더 자세한 기술 정보와 전체 문서가 필요하다면 Zonos GraphQL API 레퍼런스 개발자 사이트를 방문하세요. 이 사이트에서는 API 엔드포인트, GraphQL mutation 및 다양한 기술 정보를 자세히 안내합니다.

입력 필드 

분류를 생성하는 데 필요한 것은 설명뿐이지만, 제품 정보를 더 많이 제공할수록 분류의 정확도가 높아집니다. 또는 제품 URL만 제공해도 Classify가 관련 품목 정보를 모두 자동으로 추출합니다. 아래에서 Classify가 지원하는 각 입력 필드를 자세히 설명합니다. 각 입력 필드를 이해하면 이를 최대한 활용하여 매우 정확한 분류를 생성할 수 있습니다.

분류 요청하기 

Dashboard 또는 API로 분류를 요청하려면 아래 단계와 mutation을 따르세요.

아래 예시는 범용(6자리) 요청입니다. 특정 국가 기준으로 분류를 요청하려면 아래 예시처럼 Classify 요청에 해당 국가의 ISO 코드를 추가합니다. 범용 HS 코드를 요청하려면 Classify 요청에서 도착 국가(ship-to country)를 null로 둡니다.

입력값은 목록 형식이므로 한 번에 여러 건 또는 한 건의 분류를 요청할 수 있습니다.

참고: API로 감사 추적을 생성하려면 쿼리에 auditTrail 필드를 포함하세요. 이용 권한과 구현 방법은 Zonos 담당자에게 문의하세요.

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}

가능한 API 응답

Classify는 분류 요청을 받으면 요청에 포함된 입력 품목 데이터를 Classify 데이터베이스에서 신뢰도 점수가 가장 높은 항목과 매칭하려고 시도합니다. 검색 결과에 따라 Classify는 다음 응답 중 하나를 반환합니다.

  1. 요청에 도착 국가를 포함했는지에 따라 6자리 또는 8자리 이상의 HS 코드와 함께 hsCode가 반환되면 분류 요청이 성공한 것입니다.
  2. {"errors": [ { "message": "No adequate response"}]}가 반환되면 입력 정보가 부족하여 Classify가 분류를 찾지 못했다는 의미입니다.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ClassificationCalculateInput

MUTATIONS

classificationsCalculate

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

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • 품목 분류
  • 입력 필드
  • 분류 요청하기