API & SDK
ASAP REST API
기업 사용자 인증 후 배송 접수, 조회, 취소 및 관세율 조회를 연동할 수 있는 외부 REST API 문서입니다.
Endpoints
7
Base URL
https://api.asapx.ai
Language Header
lang: ko | en
Auth Cookie
accessToken
Response 기준
REST API는 HTTP status를 우선 기준으로 처리합니다. 응답 body의 errorCode는 상세 원인 식별을 위한 ASAP 내부 코드입니다.
OK
- 성공
Created
- 배송 접수 성공
Bad Request
- 요청 값 검증 실패
- 필수값 누락
- 날짜/형식 오류
Unauthorized
- 인증 정보 없음
- accessToken 없음/만료/유효하지 않음
Forbidden
- 본인 배송이 아님
- REST API 사용 권한 없음
- 기업 계정이 아님
- 비활성/승인 전 계정
Not Found
- 배송 없음
- 계정 없음
Conflict
- 현재 상태에서 처리 불가
- 접수 신청 상태가 아니라 수정 불가
- 이미 취소된 배송
- 결제 완료/추가결제 상태라 취소 불가
Internal Server Error
- 서버 내부 오류
- 처리 결과 확인 불가
ASAP errorCode
0SUCCESS
요청이 정상 처리되었습니다.
1000NO_DATA_ERROR
조회 대상 데이터가 존재하지 않습니다.
1001REQUIRE_SIGNIN_ERROR
로그인 또는 인증이 필요한 요청입니다.
1002REQUIRE_SIGNUP_ERROR
회원가입 또는 계정 등록이 필요한 상태입니다.
1003USER_ACTIVATE_ERROR
계정이 비활성 상태이거나 아직 승인되지 않았습니다.
1004TOKEN_NOT_FOUND_ERROR
요청에 accessToken이 포함되어 있지 않습니다.
1005TOKEN_INVALID_ERROR
accessToken이 만료되었거나 유효하지 않습니다.
1006USER_PERMISSION_ERROR
요청을 수행할 권한이 없습니다.
1009ARGUMENT_NOT_VALID_ERROR
요청 파라미터 또는 body 값 검증에 실패했습니다.
1016ETC_ERROR
분류되지 않은 기타 오류입니다.
Authentication
REST API 사용을 위한 기업 사용자 인증과 세션 종료 API입니다.
REST 인증 API
기업 사용자 계정으로 인증합니다. 성공 시 응답 헤더 Set-Cookie에 accessToken이 포함되며, 이후 요청은 Cookie 헤더에 accessToken을 포함해야 합니다.
Request Body
id
string
기업 사용자 아이디
sample_api_userpw
string
기업 사용자 비밀번호
samplePassword1!Response
success
boolean
API 성공 여부
truemessage
string
전달 메시지
API가 정상 처리되었습니다errorCode
number
에러 코드
0data
object
인증 사용자 정보
userType
number
사용자 타입. 1: 기업, 2: 일반
1userId
number
사용자 ID
1id
string
사용자 아이디
sample_api_userstring
사용자 이메일
sample.user@example.comname
string
이름
홍길동cURL
curl -X POST "$BASE_URL/v1/rest/auth" \
-H "Content-Type: application/json" -H "lang: ko" \
-d '{"id":"sample_api_user","pw":"samplePassword1!"}'Request Example
{
"id": "sample_api_user",
"pw": "samplePassword1!"
}Response Example
{
"success": true,
"message": "API가 정상 처리되었습니다",
"errorCode": 0,
"data": {
"userType": 1,
"userId": 1,
"id": "sample_api_user",
"email": "sample.user@example.com",
"name": "홍길동"
}
}REST 로그아웃 API
REST API 세션을 로그아웃합니다. 응답 헤더 Set-Cookie를 통해 accessToken 쿠키가 즉시 만료됩니다.
Response
success
boolean
API 성공 여부
truemessage
string
전달 메시지
API가 정상 처리되었습니다errorCode
number
에러 코드
0data
null
전달 데이터
nullcURL
curl -X DELETE "$BASE_URL/v1/rest/auth" \
-H "lang: ko" \
-H "Cookie: accessToken=발급받은_토큰값"Response Example
{
"success": true,
"message": "API가 정상 처리되었습니다",
"errorCode": 0,
"data": null
}Delivery
배송 접수, 수정, 취소, 조회 API입니다.
배송 접수 API
새 배송을 접수합니다. 해외 배송은 국가 이동 옵션, 국내 배송은 내륙 운송 옵션을 함께 전달합니다.
Request Body
deliveryType
number
배송 타입. 1: 해외 배송, 2: 국내 배송
1etd
datetime
ISO 8601
픽업요청 일시. null이면 현재 시간으로 설정
2025-04-29T15:45:12eta
datetime
ISO 8601
도착희망 일시
2025-04-29T15:45:12memo
string
배송 관련 메모
배송 관련 메모deliveryItems
array
물품 정보 리스트. 최소 1개 이상
info
string
품목
품목detailInfo
string
품목 상세 정보
품목 상세 정보packageType
string
포장 정보
박스count
number
수량. 숫자만 가능
1weight
number
무게
1width
number
가로 길이(cm)
1depth
number
세로 길이(cm)
1height
number
높이(cm)
1cbm
number
부피. cm³ 단위일 경우 1,000,000으로 나눈 값
0.001coldChainFlag
number
콜드 체인 필요 여부
2minTemperature
number
최저온도. coldChainFlag가 1인 경우 최고 혹은 최저온도 필수
-15.50maxTemperature
number
최고온도. coldChainFlag가 1인 경우 최고 혹은 최저온도 필수
38.75hazardousFlag
number
위험물 포함 여부
1incoterms
string
인코텀즈. 해외 배송인 경우 사용
FOBcustomsSupport
number
통관 및 관세 지원 서비스
1insuranceSupport
number
보험 서비스
1hsCode
string
HS Code
0102212000name
string
접수자 이름
홍길동string
접수자 이메일
sample.user@example.comphoneNum
string
접수자 연락처. 숫자만 허용
01012345678division
string
접수자 계정 구분
본점sendReceiveFlag
number
접수자 발신/수신 여부. 1: 발신, 2: 수신, 3: 포함안됨
1departureDeliveryAddress
object
출발 배송 주소
name
string
이름
홍길동phoneNum
string
연락처. 숫자만 가능
01012345678string
이메일
sample.user@example.compostalCode
string
우편 번호
08812countryId
number
국가 고유 ID
1stateOrProvince
string
시/도 또는 주
서울city
string
시/군/구
강남구streetAddress
string
도로명 주소 또는 해외 street
서울특별시 관악구 호암로 22길 32detailAddress
string
상세 주소
SS건물 5층longitude
number
경도
126.5705968581795latitude
number
위도
33.45066447440359arrivalDeliveryAddress
object
도착 배송 주소
name
string
이름
홍길동phoneNum
string
연락처. 숫자만 가능
01012345678string
이메일
sample.user@example.compostalCode
string
우편 번호
08812countryId
number
국가 고유 ID
1stateOrProvince
string
시/도 또는 주
서울city
string
시/군/구
강남구streetAddress
string
도로명 주소 또는 해외 street
서울특별시 관악구 호암로 22길 32detailAddress
string
상세 주소
SS건물 5층longitude
number
경도
126.5705968581795latitude
number
위도
33.45066447440359returnDeliveryAddress
object
반송 주소. 해외 배송일 경우 존재
name
string
이름
홍길동phoneNum
string
연락처. 숫자만 가능
01012345678string
이메일
sample.user@example.compostalCode
string
우편 번호
08812countryId
number
국가 고유 ID
1stateOrProvince
string
시/도 또는 주
서울city
string
시/군/구
강남구streetAddress
string
도로명 주소 또는 해외 street
서울특별시 관악구 호암로 22길 32detailAddress
string
상세 주소
SS건물 5층longitude
number
경도
126.5705968581795latitude
number
위도
33.45066447440359deliveryPayment
object
배송 결제 정보
type
number
결제 유형
1payerFlag
number
결제 주체. null이면 계정 기본값 사용
1payMethod
number
결제 방법. null이면 계정 기본값 사용
1payerName
string
입금자 명
홍길동arrivalDeliveryLocal
object
내륙 운송 옵션. 국내 배송일 경우 필수
transportType
number
운송 수단. 국내 배송인 경우 필수
1amount
number
내륙 운송 비용
0deliveryGlobal
object
국가 이동 옵션. 해외 배송일 경우 필수
transportType
number
운송 수단. 해외 배송인 경우 필수
1amount
number
해외 이동 비용
0Response
success
boolean
API 성공 여부
truemessage
string
전달 메시지
API가 정상 처리되었습니다errorCode
number
에러 코드
0data
object
접수 결과
deliveryId
number
배송 ID
1deliveryNo
string
배송 접수 번호
KR0001KRcURL
curl -X POST "$BASE_URL/v1/rest/delivery" \
-H "Content-Type: application/json" -H "lang: ko" \
-H "Cookie: accessToken=발급받은_토큰값" \
-d '{"deliveryType":1,"name":"홍길동","email":"sample.user@example.com","phoneNum":"01012345678","sendReceiveFlag":1,"deliveryItems":[],"departureDeliveryAddress":{},"arrivalDeliveryAddress":{},"deliveryPayment":{},"deliveryGlobal":{}}'Request Example
{
"deliveryType": 1,
"etd": "2025-04-29T15:45:12",
"eta": "2025-04-29T15:45:12",
"memo": "배송 관련 메모",
"deliveryItems": [
{
"info": "사과",
"detailInfo": "사과",
"packageType": "박스",
"count": 1,
"weight": 1,
"width": 1,
"depth": 1,
"height": 1,
"cbm": 0.001,
"coldChainFlag": 2,
"hazardousFlag": 1,
"incoterms": "FOB",
"customsSupport": 1,
"insuranceSupport": 1,
"hsCode": "0102212000"
}
],
"name": "홍길동",
"email": "sample.user@example.com",
"phoneNum": "01012345678",
"division": "본점",
"sendReceiveFlag": 1,
"departureDeliveryAddress": {
"name": "홍길동",
"phoneNum": "01098765432",
"email": "sample.user@example.com",
"postalCode": "08812",
"countryId": 1,
"stateOrProvince": "서울",
"city": "강남구",
"streetAddress": "서울특별시 관악구 호암로 22길 32",
"detailAddress": "SS건물 5층"
},
"arrivalDeliveryAddress": {
"name": "홍길동",
"phoneNum": "01012345678",
"email": "receiver@example.com",
"postalCode": "90001",
"countryId": 2,
"stateOrProvince": "California",
"city": "Los Angeles",
"streetAddress": "123 Main St",
"detailAddress": "Unit 5"
},
"returnDeliveryAddress": {
"name": "홍길동",
"phoneNum": "01098765432",
"email": "sample.user@example.com",
"postalCode": "08812",
"countryId": 1,
"stateOrProvince": "서울",
"city": "강남구",
"streetAddress": "서울특별시 관악구 호암로 22길 32",
"detailAddress": "SS건물 5층"
},
"deliveryPayment": {
"type": 1,
"payerFlag": 1,
"payMethod": 1,
"payerName": "홍길동"
},
"deliveryGlobal": {
"transportType": 1,
"amount": 5000
}
}Response Example
{
"success": true,
"message": "API가 정상 처리되었습니다",
"errorCode": 0,
"data": {
"deliveryId": 1,
"deliveryNo": "KR0001KR"
}
}배송 수정 API
접수 신청 상태의 배송건만 수정할 수 있습니다. 전달한 필드만 수정 대상이 됩니다.
Request Body
deliveryId
number
배송 ID
1deliveryType
number
배송 타입. 1: 해외 배송, 2: 국내 배송
1name
string
접수자 이름
홍길동string
접수자 이메일
sample.user@example.comphoneNum
string
접수자 연락처
01012345678division
string
접수자 계정 구분
본점sendReceiveFlag
number
접수자 발신/수신 여부. 1: 발신, 2: 수신, 3: 포함안됨
1etd
datetime
ISO 8601
픽업요청 일시
2025-05-12T11:10:10eta
string
ISO 8601 or empty string
도착희망 일시. 빈 문자열 입력 시 null로 초기화
2025-05-12T11:10:10deliveryItems
array
물품 정보 리스트. deliveryItemId가 있으면 수정, 없으면 신규 추가
deliveryItemId
number
배송 물품 ID. 값이 있으면 해당 물품 수정, 없으면 신규 추가
1info
string
품목
품목detailInfo
string
품목 상세 정보
품목 상세 정보packageType
string
포장 정보
박스count
number
수량. 숫자만 가능
1weight
number
무게
1width
number
가로 길이(cm)
1depth
number
세로 길이(cm)
1height
number
높이(cm)
1cbm
number
부피. cm³ 단위일 경우 1,000,000으로 나눈 값
0.001coldChainFlag
number
콜드 체인 필요 여부
2minTemperature
number
최저온도. coldChainFlag가 1인 경우 최고 혹은 최저온도 필수
-15.50maxTemperature
number
최고온도. coldChainFlag가 1인 경우 최고 혹은 최저온도 필수
38.75hazardousFlag
number
위험물 포함 여부
1incoterms
string
인코텀즈. 해외 배송인 경우 사용
FOBcustomsSupport
number
통관 및 관세 지원 서비스
1insuranceSupport
number
보험 서비스
1hsCode
string
HS Code
0102212000departureDeliveryAddress
object
출발 배송 주소
name
string
이름
홍길동phoneNum
string
연락처. 숫자만 가능
01012345678string
이메일
sample.user@example.compostalCode
string
우편 번호
08812countryId
number
국가 고유 ID
1stateOrProvince
string
시/도 또는 주
서울city
string
시/군/구
강남구streetAddress
string
도로명 주소 또는 해외 street
서울특별시 관악구 호암로 22길 32detailAddress
string
상세 주소
SS건물 5층longitude
number
경도
126.5705968581795latitude
number
위도
33.45066447440359arrivalDeliveryAddress
object
도착 배송 주소
name
string
이름
홍길동phoneNum
string
연락처. 숫자만 가능
01012345678string
이메일
sample.user@example.compostalCode
string
우편 번호
08812countryId
number
국가 고유 ID
1stateOrProvince
string
시/도 또는 주
서울city
string
시/군/구
강남구streetAddress
string
도로명 주소 또는 해외 street
서울특별시 관악구 호암로 22길 32detailAddress
string
상세 주소
SS건물 5층longitude
number
경도
126.5705968581795latitude
number
위도
33.45066447440359returnDeliveryAddress
object
반송 주소
name
string
이름
홍길동phoneNum
string
연락처. 숫자만 가능
01012345678string
이메일
sample.user@example.compostalCode
string
우편 번호
08812countryId
number
국가 고유 ID
1stateOrProvince
string
시/도 또는 주
서울city
string
시/군/구
강남구streetAddress
string
도로명 주소 또는 해외 street
서울특별시 관악구 호암로 22길 32detailAddress
string
상세 주소
SS건물 5층longitude
number
경도
126.5705968581795latitude
number
위도
33.45066447440359deliveryPayment
object
배송 결제 정보
type
number
결제 유형
1payerFlag
number
결제 주체. null이면 계정 기본값 사용
1payMethod
number
결제 방법. null이면 계정 기본값 사용
1payerName
string
입금자 명
홍길동arrivalDeliveryLocal
object
내륙 운송 옵션
transportType
number
운송 수단. 국내 배송인 경우 필수
1amount
number
내륙 운송 비용
0deliveryGlobal
object
국가 이동 옵션
transportType
number
운송 수단. 해외 배송으로 변경하는 경우 필수
1Response
success
boolean
API 성공 여부
truemessage
string
전달 메시지
API가 정상 처리되었습니다errorCode
number
에러 코드
0data
object
수정 결과
cURL
curl -X PATCH "$BASE_URL/v1/rest/delivery" \
-H "Content-Type: application/json" -H "lang: ko" \
-H "Cookie: accessToken=발급받은_토큰값" \
-d '{"deliveryId":1,"memo":"변경 요청 메모"}'Request Example
{
"deliveryId": 1,
"memo": "변경 요청 메모"
}Response Example
{
"success": true,
"message": "API가 정상 처리되었습니다",
"errorCode": 0,
"data": {}
}배송 취소 API
지정한 배송건을 취소합니다.
Request Body
deliveryId
number
배송 ID
1Response
success
boolean
API 성공 여부
truemessage
string
전달 메시지
errorCode
number
에러 코드
0data
object
취소 결과
cURL
curl -X PATCH "$BASE_URL/v1/rest/delivery/cancel" \
-H "Content-Type: application/json" -H "lang: ko" \
-H "Cookie: accessToken=발급받은_토큰값" \
-d '{"deliveryId":1}'Request Example
{
"deliveryId": 1
}Response Example
{
"success": true,
"message": "API가 정상 처리되었습니다",
"errorCode": 0,
"data": {}
}배송 조회 API
배송 ID로 배송 상세 정보를 조회합니다.
Query Parameters
deliveryId
number
배송 ID. 1 이상
1Response
success
boolean
API 성공 여부
truemessage
string
전달 메시지
errorCode
number
에러 코드
0data
object
배송 상세 정보
deliveryId
number
배송 ID
1deliveryType
number
배송 타입
1userType
number
접수 사용자 타입
1userId
number
접수 사용자 ID
1name
string
접수자 이름
홍길동string
접수자 이메일
sample.user@example.comphoneNum
string
접수자 연락처
01000000000division
string
접수자 계정 구분
샘플 지점deliveryNo
string
배송 접수 번호
AA0000BBdeliveryStatus
number
배송 상태
1paymentStatus
number
결제 상태
1returnPaymentStatus
number
반송비 결제 상태
1totalAmount
number
총 배송비
0totalAmountOrigin
number
총 배송비 원가
0extraAmount
number
기타비용 합계
0extraAmountOrigin
number
기타비용 원가 합계
0additionalAmount
number
추가비 합계
0additionalAmountOrigin
number
추가비 원가 합계
0etd
datetime
ISO 8601
픽업 요청 일시
2099-01-01T09:00:00eta
datetime
ISO 8601
도착 희망 일시
2099-01-03T18:00:00unreadCount
number
읽지 않은 채팅 메시지 수
0successTime
datetime
ISO 8601
배송 완료 일시
2099-01-04T18:00:00sendReceiveFlag
number
접수자 발신/수신 여부
1adminUserName
string
관리자 이름
홍길동currentVehicleType
number
현재 배송 운송 수단
1memo
string
배송 관련 메모
샘플 배송 메모userMemo
string
사용자 노출 메모
사용자 노출 메모companyName
string
기업명
샘플 기업createdTime
datetime
ISO 8601
접수일시
2099-01-01T09:00:00deliveryItems
array
배송 품목 데이터 리스트
deliveryItemId
number
배송 물품 ID. 값이 있으면 해당 물품 수정, 없으면 신규 추가
1info
string
품목
품목detailInfo
string
품목 상세 정보
품목 상세 정보packageType
string
포장 정보
박스count
number
수량. 숫자만 가능
1weight
number
무게
1width
number
가로 길이(cm)
1depth
number
세로 길이(cm)
1height
number
높이(cm)
1cbm
number
부피. cm³ 단위일 경우 1,000,000으로 나눈 값
0.001coldChainFlag
number
콜드 체인 필요 여부
2minTemperature
number
최저온도. coldChainFlag가 1인 경우 최고 혹은 최저온도 필수
-15.50maxTemperature
number
최고온도. coldChainFlag가 1인 경우 최고 혹은 최저온도 필수
38.75hazardousFlag
number
위험물 포함 여부
1incoterms
string
인코텀즈. 해외 배송인 경우 사용
FOBcustomsSupport
number
통관 및 관세 지원 서비스
1insuranceSupport
number
보험 서비스
1hsCode
string
HS Code
0102212000departureDeliveryAddress
object
배송 출발지 데이터
name
string
이름
홍길동phoneNum
string
연락처. 숫자만 가능
01012345678string
이메일
sample.user@example.compostalCode
string
우편 번호
08812countryId
number
국가 고유 ID
1stateOrProvince
string
시/도 또는 주
서울city
string
시/군/구
강남구streetAddress
string
도로명 주소 또는 해외 street
서울특별시 관악구 호암로 22길 32detailAddress
string
상세 주소
SS건물 5층longitude
number
경도
126.5705968581795latitude
number
위도
33.45066447440359arrivalDeliveryAddress
object
배송 도착지 데이터
name
string
이름
홍길동phoneNum
string
연락처. 숫자만 가능
01012345678string
이메일
sample.user@example.compostalCode
string
우편 번호
08812countryId
number
국가 고유 ID
1stateOrProvince
string
시/도 또는 주
서울city
string
시/군/구
강남구streetAddress
string
도로명 주소 또는 해외 street
서울특별시 관악구 호암로 22길 32detailAddress
string
상세 주소
SS건물 5층longitude
number
경도
126.5705968581795latitude
number
위도
33.45066447440359returnDeliveryAddress
object
배송 반송지 데이터
name
string
이름
홍길동phoneNum
string
연락처. 숫자만 가능
01012345678string
이메일
sample.user@example.compostalCode
string
우편 번호
08812countryId
number
국가 고유 ID
1stateOrProvince
string
시/도 또는 주
서울city
string
시/군/구
강남구streetAddress
string
도로명 주소 또는 해외 street
서울특별시 관악구 호암로 22길 32detailAddress
string
상세 주소
SS건물 5층longitude
number
경도
126.5705968581795latitude
number
위도
33.45066447440359deliveryPayment
object
배송 결제 데이터
type
number
결제 유형
1payerFlag
number
결제 주체. null이면 계정 기본값 사용
1payMethod
number
결제 방법. null이면 계정 기본값 사용
1payerName
string
입금자 명
홍길동departureDeliveryLocal
object
배송 출발국가 내륙운송 데이터
transportType
number
운송 수단. 국내 배송인 경우 필수
1amount
number
내륙 운송 비용
0arrivalDeliveryLocal
object
배송 도착국가 내륙운송 데이터
transportType
number
운송 수단. 국내 배송인 경우 필수
1amount
number
내륙 운송 비용
0deliveryGlobal
object
배송 국가이동 데이터
transportType
number
운송 수단. 해외 배송으로 변경하는 경우 필수
1deliveryTransport
object
배송 국가이동 운송수단 데이터
deliveryFileList
array
배송 파일 데이터 리스트
deliveryExtraCostList
array
배송 추가비용 데이터 리스트
cURL
curl -X GET "$BASE_URL/v1/rest/delivery?deliveryId=1" \
-H "lang: ko" \
-H "Cookie: accessToken=발급받은_토큰값"Response Example
{
"success": true,
"message": "API가 정상 처리되었습니다",
"errorCode": 0,
"data": {
"deliveryId": 1,
"deliveryType": 1,
"userType": 1,
"userId": 1,
"name": "홍길동",
"email": "sample.user@example.com",
"phoneNum": "01000000000",
"deliveryNo": "AA0000BB",
"deliveryStatus": 1,
"paymentStatus": 1,
"returnPaymentStatus": 1,
"deliveryItems": [],
"departureDeliveryAddress": {},
"arrivalDeliveryAddress": {},
"deliveryPayment": {}
}
}Tariff
국가와 HS Code 기반 관세율 조회 API입니다.
관세율 조회 API
원산지, 수출국, 수입국, HS Code 기준으로 관세율을 조회합니다.
Query Parameters
originCountryCode
string
ISO 3166-1 alpha-2
원산지 국가 코드. ISO 3166-1 alpha-2
KRdepartureCountryCode
string
ISO 3166-1 alpha-2
수출 국가 코드. ISO 3166-1 alpha-2
KRarrivalCountryCode
string
ISO 3166-1 alpha-2
수입 국가 코드. ISO 3166-1 alpha-2
UShsCode
string
HS Code
0102212000Response
success
boolean
API 성공 여부
truemessage
string
전달 메시지
errorCode
number
에러 코드
0data
object
관세율 조회 결과
origin_country_code
string
원산지 국가 코드
AAorigin_country_name
string
원산지 국가명
샘플 원산지origin_country_name_en
string
원산지 국가명(영문)
Sample Origindeparture_country_code
string
출발 국가 코드
BBdeparture_country_name
string
출발 국가명
샘플 출발국departure_country_name_en
string
출발 국가명(영문)
Sample Departurearrival_country_code
string
도착 국가 코드
CCarrival_country_name
string
도착 국가명
샘플 도착국arrival_country_name_en
string
도착 국가명(영문)
Sample Arrivalhs_code
string
HS 코드
0000000000base_tariff
object
기본 관세
tariff_code
string
관세 코드
Xtariff_rate
number
관세율
8.0000tariff_rate_range
string
관세율 범위
0~00.0%unit_tax_amount
string
단위 세액
base_price
string
기준 가격
description
string
설명
샘플 기본 관세description_en
string
설명(영문)
Sample Base Tariffspecial_tariff
array
특별 관세 목록
priority
number
우선 순위
1tariff_code
string
관세 코드
Ytariff_rate
number
관세율
0.0000tariff_rate_range
string
관세율 범위
0~00.0%unit_tax_amount
string
단위 세액
base_price
string
기준 가격
description
string
설명
샘플 특별 관세description_en
string
설명(영문)
Sample Special Tariffspecial_tariff_type
string
특별 관세 유형
SAMPLEselected_tariff_code
string
선택된 관세 코드
Xselected_tariff_rate
number
선택된 관세율
0.0000selected_tariff_rate_range
string
선택된 관세율 범위
0~00.0%selected_tariff_description
string
선택된 관세 설명
샘플 관세selected_tariff_description_en
string
선택된 관세 설명(영문)
Sample Dutyselected_tariff_type
string
선택된 관세 유형
Xtariff_reasoning
string
관세 판단 근거
tariff_reasoning_en
string
관세 판단 근거(영문)
cURL
curl -X GET "$BASE_URL/v1/rest/tariff/lookup?originCountryCode=KR&departureCountryCode=KR&arrivalCountryCode=US&hsCode=0102212000" \
-H "lang: ko" \
-H "Cookie: accessToken=발급받은_토큰값"Response Example
{
"success": true,
"message": "API가 정상 처리되었습니다",
"errorCode": 0,
"data": {
"origin_country_code": "AA",
"departure_country_code": "BB",
"arrival_country_code": "CC",
"hs_code": "0000000000",
"base_tariff": {
"tariff_code": "X",
"tariff_rate": 8,
"tariff_rate_range": "0~00.0%",
"description": "샘플 기본 관세"
},
"special_tariff": [],
"selected_tariff_code": "X",
"selected_tariff_rate": 0
}
}