제품

대량 수입자를 위한 분류 및 도착지 인도 원가 API

운송 주선업자, 국경 간 이커머스 플랫폼, 우편 및 소포 운영사, 대량 수입자는 매일 수천 개의 제품을 세관으로 통관시킵니다. GingerControl API는 평범한 제품 설명과 원산지를 HTS 코드와 완전한 관세 스택으로 변환하므로, 사람이 모든 항목을 일일이 분류하지 않고도 시스템이 도착지 인도 원가를 견적하고 수입신고를 준비할 수 있습니다.

테스트 API 키 요청하기 API 레퍼런스 읽기

개발자 문서

API 사용 설명서

엔드포인트, 요청 및 응답 계약, 오류 코드, 속도 제한을 한 페이지에 모두 담았습니다.

gingercontrolREST API

설명서 열기

일회성이 아니라 전체 카탈로그를 위해 설계

일괄 호출당

200

호출당 제품 수

한 번의 일괄 요청이 최대 200개 제품을 병렬로 분류하고 가격을 산정하여 3~5분 안에 완료합니다.

프로덕션 등급

200K+

일일 분류 건수

표준 프로덕션 처리 용량. 맞춤형 엔터프라이즈 등급은 시간당 10만 건까지 확장됩니다.

개발자

전체 요청, 응답, 오류 계약은 API 레퍼런스에 담겨 있습니다.

API 레퍼런스

또는 테스트 키를 원하시면 chen@gingercontrol.com으로 이메일을 보내세요.

처리량 수치는 실시간 트래픽 전반에서 측정된 표준 프로덕션 등급 API 키를 나타냅니다. 실제 용량은 각 고객의 호출 패턴과 최대 QPS에 맞춰 조정됩니다. 분류 산출물은 신고 전에 관세사가 검토할 리서치 자료입니다.

제품 라인에서 도착지 인도 원가까지 한 번의 호출로

POST/v1/tariff

descriptionCotton T-shirt

countryVN

제품과 원산지 전송

제품 설명과 원산지를 POST하세요. 항목 하나든 최대 200개 배치든 가능합니다. 관세표 조회도, 관세사 대기열도 필요 없습니다.

6109.10.0012

MFN

301

232

Ginger가 분류하고 계산

엔진이 HTS 코드를 결정한 다음 전체 관세 스택을 조립합니다. MFN 기본 세율에 Section 301, 232, 122, 그리고 적용되는 모든 99류 항목까지요.

200 OK

hts_code

general_rate

Section 301

Section 232

도착지 인도 원가에 바로 쓸 데이터 수신

하나의 JSON 응답이 HTS 코드와 모든 관세 계층을 반환하여, 도착지 인도 원가 견적, 수입신고 준비, 가격 엔진에 곧바로 넣을 수 있습니다.

한 번의 요청으로, 전체 관세 그림을

설명과 원산지를 전송하세요. 단 한 번의 호출로 HTS 코드와 완전한 관세 내역을 받습니다. 이것은 마케팅용 스냅샷이며, API 레퍼런스가 모든 필드, 오류 코드, 배치 동작을 문서화합니다.

요청

curl -X POST 'https://api.gingercontrol.com/openapi/v1/tariff' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d {
    "description": "Cotton knit short sleeve T-shirt",
    "country_of_origin": "VN"
  }

응답

{
  "hts_code": "6109.10.0012",
  "tariffs": {
    "general_rate": "16.5%",
    "special_rate": "Free",
    "Section 301": [],
    "Section 232 - Metals": [],
    "Section 122": [
      { "code": "9903.03.01", "rate": "10%" }
    ]
  }
}

일괄 요청, 분할 코드 구성 요소, 오류 시맨틱, 속도 제한은 전체 API 레퍼런스를 참고하세요.

API가 귀사 시스템에 제공하는 것

계산

기본 세율만이 아니라, 실제로 수입신고에 얹히는 전체 스택.

MFN

301

232

122

Ch 99

Total

전체 도착지 인도 관세 스택

모든 응답은 General(MFN) 및 Special 세율에 더해 Section 301, Section 232, Section 122, 그리고 적용되는 모든 99류 항목을 담고 있어, 도착지 인도 원가 숫자가 세관이 실제로 부과할 금액을 반영합니다.

통합

예측 가능한 계약과 명확한 실패 모드, 운영팀이 계획을 세우는 요소.

POST/tariff1 item

POST/tariff/batch200

단일 및 일괄 엔드포인트

실시간 결제 견적을 위해 제품 하나를 분류하거나, 야간 카탈로그 실행을 위해 한 번의 일괄 호출로 최대 200개 항목을 밀어 넣으세요. 두 엔드포인트는 하나의 응답 형태와 하나의 할당량을 공유합니다.

누가 이 위에 구축하는가

이 API는 매일 대량의 소매 물품, 식료품, 소포를 세관으로 통관시키며 손으로 한 줄씩 분류하는 것이 도저히 감당되지 않는 운영을 위해 만들어졌습니다.

운송 주선업자

모든 항목마다 관세사를 기다리는 대신, 트럭이 떠나기 전에 고객의 전체 선적 명세를 분류하고 가격을 산정하세요.

국경 간 이커머스

결제 시점에 정확한 관세 포함 도착지 인도 원가를 보여주어, 배송 시 세관 요금에 쇼핑객이 놀라지 않게 하세요.

우편 및 소포 운영사

대량 인바운드 소포 흐름 전반에 HTS 코드와 관세를 적용하여 세관 신고와 선납에 반영하세요.

마켓플레이스 및 소매 플랫폼

분류 팀을 두지 않고도 수천 명의 제3자 판매자에게 올바른 HTS 코드와 관세 추정치를 제공하세요.

3PL 및 풀필먼트

온보딩에 분류와 도착지 인도 원가를 녹여 넣어, 모든 신규 고객 카탈로그가 첫날부터 수입신고 준비를 마치게 하세요.

ERP, TMS 및 가격 엔진

유지해야 할 관세표 없이, 고객이 이미 사용하는 플랫폼에 실시간 관세 데이터를 임베드하세요.

이 API가 해내는 일

"우리는 주당 수천 개의 SKU를 움직입니다. 모든 항목에 사람을 붙일 수는 없지만, 견적 시점의 잘못된 관세 추정치는 거래를 잃게 하거나 마진을 갉아먹습니다."

대량 운송 주선업자 또는 국경 간 판매사의 운영 책임자

그것이 의미하는 바

물품이 움직이기 전에 도착지 인도 원가 산정	한 번의 호출이 HTS 코드와 전체 관세 스택을 반환하며, 결제 견적이나 선적 명세에 쓸 만큼 빠릅니다.
단일 조회가 아니라 전체 카탈로그 처리	일괄 엔드포인트는 호출당 최대 200개 제품을 처리하며 하루 20만 건 이상의 분류로 확장됩니다.
견적에 들어가는 숫자를 신뢰	Section 301, 232, 122에 분할 코드 구성 요소별 관세까지 담은 전체 관세 스택으로, 신고 전 관세사 검토를 위해 설계되었습니다.

API FAQ

API를 사용하려면 관세사여야 하나요?

아니요. API는 리서치 산출물, 즉 견적과 준비에 시스템이 사용할 HTS 코드와 전체 관세 스택을 반환합니다. 그 결과는 수입신고에 사용되기 전에 관세사의 검토를 받도록 설계되었습니다. 작업 속도를 높일 뿐, 관세사의 승인을 대체하지는 않습니다.

분류는 얼마나 빠른가요?

단일 제품 분류는 보통 1분 이내에 반환됩니다. 최대 200개 제품 배치는 병렬로 실행되어 대략 3~5분 안에 완료되며, 이것이 표준 프로덕션 키가 하루 20만 건 이상의 분류를 처리할 수 있게 하는 요소입니다.

API가 관세 포함 도착지 인도 원가를 알려줄 수 있나요?

API는 수입신고에 얹히는 모든 관세 계층을 반환합니다. General(MFN) 및 Special 세율에 더해 Section 301, 232, 122, 그리고 적용되는 99류 항목까지요. 그 관세 스택을 귀사 자체의 운임 및 수수료와 결합하여 견적이나 결제용 도착지 인도 원가 수치를 산출하세요.

API 키는 어떻게 받나요?

테스트 키를 요청하시면 이메일과 같은 오프라인 채널을 통해 전달해 드립니다. 테스트 키는 소량의 할당량을 가지며 7~30일 후에 만료되고, 개발 전용입니다. 실서비스에 나갈 준비가 되면, 귀사의 호출 패턴, IP 허용 목록, 최대 QPS에 맞춰 프로덕션 키를 발급해 드립니다.

일괄 처리 한도는 어떻게 되나요?

일괄 엔드포인트는 호출당 최대 200개 제품을 받습니다. 각 항목이 고유한 상태를 보고하므로 분류할 수 없는 제품 하나가 전체 배치를 실패시키지 않으며, 단일과 일괄 엔드포인트 모두 귀사 키의 동일한 항목 할당량을 차감합니다.

전체 기술 문서는 어디에 있나요?

API 레퍼런스는 모든 엔드포인트, 요청 및 응답 필드, 오류 코드, 헤더, 속도 제한 규칙을 복사해 붙여넣을 수 있는 curl 예제와 함께 문서화합니다. 키를 받은 뒤 개발의 기준으로 삼을 페이지입니다.

귀사 운영 뒤에 Classifier를 두세요

테스트 키를 요청해 통합을 시작하거나, 전체 API 레퍼런스를 읽고 계약을 기준으로 구축하세요.