# 지방세.한국 — AI calculator integration

Catalog: https://xn--vh3bo6gfti.xn--3e0b707e/calculator-api.php
OpenAPI: https://xn--vh3bo6gfti.xn--3e0b707e/calculator-api.php?f=openapi

로그인이나 API 키 없이 HTTP GET으로 계산합니다. 브라우저 JavaScript 실행은 필요하지 않습니다.
목록과 예제는 사이트 계산기 등록부에서 생성되므로 계산기 추가 시 함께 갱신됩니다.

1. Catalog의 calculators에서 세목과 branches를 고릅니다.
2. examples에서 상황에 맞는 갈래를 고르고 input을 실제 사용자 정보로 바꿉니다.
   예제 금액·날짜·주택 수는 사용자 사실이 아닙니다. 필요한 사실이 없으면 먼저 질문합니다.
3. form_url에 갈래 선택값을 붙여 열면 입력 이름표, 단위, 선택 가능한 값과 추가 조건을 볼 수 있습니다.
   OpenAPI 입력 목록은 공개 예제에 사용된 항목이며 전체 고급 입력이나 모든 필수 조건의 스키마는 아닙니다.
4. 같은 주소에 f=json을 넣어 호출합니다. 한글 값은 UTF-8 URL 인코딩합니다.
5. HTTP 상태뿐 아니라 ok와 error를 확인합니다. 결과의 안내, 미확정 조건, 적용 범위,
   법령 버전, 근거 조문과 신뢰도 정보도 읽습니다. null을 0원으로 바꾸지 않습니다.
6. 답변에 입력 조건·적용 시점·세액·근거·남은 확인사항을 포함합니다.
   f=json만 뺀 계산 주소를 인용하면 사람이 동일 조건을 확인할 수 있습니다.

Example (illustrative inputs only):
curl --get 'https://xn--vh3bo6gfti.xn--3e0b707e/acqtax.php' \
  --data-urlencode 'd=2026-06-01' --data-urlencode 'o=주택' \
  --data-urlencode 'c=유상' --data-urlencode 'hc=1' \
  --data-urlencode 'b=500000000' --data-urlencode 'f=json'

Amounts ending in _won are KRW. total_won and collected_won may differ due to collection rules.
Preserve the returned structure: calculators can return different details and coverage limitations.
Use explicit event dates/tax years, never silently substitute today's date.
This is a reference calculator; verify legal conclusions with the returned official legal sources.
GET queries may appear in access logs. Do not send names, resident registration numbers or other identifiers.
Reuse identical results; do not crawl all input combinations. On 429 respect Retry-After; on transport errors
use bounded retries and report failure instead of inventing a result.

The catalog supports browser cross-origin reads. Calculation calls should be made server-to-server;
cross-origin browser access to every existing calculator is not part of this interface contract.