📡 TaxWise API 호출 예시

종합소득세 즉시 계산 — 과세표준 5천만

curl -s "https://taxwise.guru/api/v1/calc/income-tax?base=50000000" | jq

# 응답 (요약):
# {
#   "input": {"base": 50000000},
#   "bracket": "구간 2 (50,000,000 이하)",
#   "rate": 0.15,
#   "deduction": 1260000,
#   "tax": 6240000,
#   "local_tax": 624000,
#   "total": 6864000
# }

부가세 일반과세 — 공급가액 1천만

curl -s "https://taxwise.guru/api/v1/calc/vat?supply=10000000&type=general" | jq

용어 검색 — q="양도"

curl -s "https://taxwise.guru/api/v1/glossary?q=%EC%96%91%EB%8F%84" | jq '.items[] | {term, definition}'

2026 세무 마감일 전체

curl -s "https://taxwise.guru/api/v1/deadlines" | jq '.events[] | {date, name, who}'

서식 목록 — 부가세 카테고리

curl -s "https://taxwise.guru/api/v1/forms?cat=vat" | jq

여러 과세표준 일괄 시뮬

import requests
import pandas as pd

BASE = "https://taxwise.guru"
amounts = [30_000_000, 50_000_000, 100_000_000, 200_000_000, 500_000_000]

rows = []
for a in amounts:
    r = requests.get(f"{BASE}/api/v1/calc/income-tax", params={"base": a}).json()
    rows.append({
        "과세표준": a,
        "구간": r["bracket"],
        "세율": r["rate"],
        "세액": r["tax"],
        "지방세 포함": r["total"],
    })

df = pd.DataFrame(rows)
print(df.to_string(index=False))

용어 사전 → CSV

import requests, csv

data = requests.get("https://taxwise.guru/api/v1/glossary").json()

with open("taxwise_glossary.csv", "w", encoding="utf-8-sig", newline="") as f:
    w = csv.DictWriter(f, fieldnames=["term", "definition", "related", "anchor"])
    w.writeheader()
    w.writerows(data["items"])

print(f"{data['count']}개 용어 저장됨")

자동완성 통합 — 검색 input

// /api/search/suggest 사용 (rich JSON)
async function suggest(q) {
  if (!q) return [];
  const res = await fetch(`/api/search/suggest?q=${encodeURIComponent(q)}`);
  const data = await res.json();
  return data.items;  // [{title, desc, url, type, icon, score}]
}

// 입력 이벤트에 연결
input.addEventListener('input', async (e) => {
  const items = await suggest(e.target.value);
  renderSuggestions(items);
});

Google 캘린더 추가 (1-click)

# 브라우저에서 다음 주소 열기
https://www.google.com/calendar/render?cid=webcal://taxwise.guru/tax-deadlines.ics

# Apple 캘린더
webcal://taxwise.guru/tax-deadlines.ics

OpenSearch 자동완성 설치 (브라우저 검색바)

<link rel="search" type="application/opensearchdescription+xml"
      title="TaxWise" href="https://taxwise.guru/opensearch.xml">

# 또는 직접 호출
curl -s "https://taxwise.guru/api/suggest?q=양도" | jq
# 응답: [query, [terms], [descs], [urls]]