세금 시산 API 개발 문서 가져오기

무엇을 할 수 있나요?

• 세금 계산 — 제품(CCC 세금 코드 또는 제품 설명) + 외화 금액을 가져오고 전체 세금 세부정보(관세/사업세/판촉비/물품세/담배 및 주류세)와 세금을 포함한 총 구현 비용을 반환합니다.
• 세율 확인 — CCC 관세 번호에 따라 관세율과 물품세 플래그를 확인하세요.
• 자동 관세 — CCC가 없는 경우 제품 설명만 제공되며 시스템은 관세청의 AI 모델을 사용하여 자동으로 관세를 추천하고 세금을 계산합니다.

Base URL

인증 헤더(하나 선택)

Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx
// 또는
X-API-Key: lk_live_xxxxxxxxxxxxxxxxxxxxxxxx

서버측에서 호출하시고 키를 프런트엔드에 노출시키지 마세요. 속도 제한은 키 단위이며 응답 헤더 X-RateLimit-Remaining은 남은 제한을 보고하며 제한을 초과하면 HTTP 429가 반환됩니다.

GETPOST /api/v1/tax/estimate

POST + JSON을 사용하는 것이 좋습니다.

요청 매개변수

요청 예시(POST JSON)

curl -X POST https://0523.tw/api/v1/tax/estimate \
  -H "Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"product_description":"면 여성용 상의","currency_code":"CNY","price_foreign":300,"quantity":1}'

응답 200 (발췌)

{
  "success": true,
  "data": {
    "input": { "hs_code": "61061000", "currency_code": "CNY", "price_foreign": 300 },
    "exchange": { "rate_to_twd": 4.612, "price_twd": 1383.6 },
    "tariff_info": { "duty_rate": 10.5, "duty_rate_text": "10.5%", "ecfa_applied": false },
    "tax_base": 1383.6,
    "tax_breakdown": {
      "is_tax_exempt": true,            // 과세표준 ≤ NT$2,000 → 소액면세
      "duty": 0, "promo_fee": 0, "vat": 0, "total_tax": 0,
      "if_over_limit": {           // 반년 동안 6회 면제를 소진한 경우 납부할 금액은
        "duty": 145.28, "vat": 76.44, "total_tax": 221.72
      }
    },
    "antidumping": [],
    "total_landed_cost": 1453.6,
    "disclaimer": "..."
  }
}

GET /api/v1/tax/rate/{hsCode}

CCC 관세 번호(순수)에 따라 관세율과 물품세 플래그를 확인하세요.

curl https://0523.tw/api/v1/tax/rate/6109100000 \
  -H "Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "data": {
    "hs_code": "6109100000",
    "duty_rate": 10.5,
    "duty_rate_text": "10.5%",
    "is_commodity_tax": false,
    "name_zh": "면 티셔츠, 언더셔츠…",
    "source": "tariffs_db"
  }
}

기술 지원: howyunqisoftware@gmail.com

API 버전: v1(안정적).

변경 내역: 2026-06-01 — 수입세 평가판 API v1이 온라인 상태입니다.