{"openapi":"3.1.0","info":{"title":"ToolAvenpa 환불·해지 계산 API","version":"1.0.0","description":"한국 소비자분쟁해결기준에 따른 환불·위약금 계산. 참고용이며 법률 자문이 아닙니다. MCP: https://tool.avenpa.com/mcp"},"servers":[{"url":"https://tool.avenpa.com"}],"paths":{"/api/calc/calc_gym_refund":{"post":{"operationId":"calc_gym_refund","summary":"헬스장·체육시설 이용계약 중도 해지 시 환급액 계산(소비자분쟁해결기준)","description":"헬스장·체육시설 이용계약 중도 해지 시 환급액 계산(소비자분쟁해결기준). 소비자 사유: 총액 − 이용일수 금액 − 총액 10%. 업체 사유: 미이용분 환급 + 총액 10% 배상. Calculates a Korean gym membership refund. 날짜는 YYYY-MM-DD.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"total_price":{"type":"number","exclusiveMinimum":0,"description":"총 이용금액(원)"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"이용 시작일"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"이용 종료일"},"cancel_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"해지 통보일. 생략하면 오늘(KST)"},"fault":{"type":"string","enum":["consumer","business"],"description":"해지 사유. consumer=소비자 사정(변심·이사·부상 등), business=업체 사유(폐업·서비스 미제공 등). 기본 consumer"}},"required":["total_price","start_date","end_date"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_academy_refund":{"post":{"operationId":"calc_academy_refund","summary":"학원 수강료 환불액 계산(학원법 시행령 별표 4)","description":"학원 수강료 환불액 계산(학원법 시행령 별표 4). 교습 시작 전 전액, 총 교습시간 1/3 경과 전 2/3, 1/2 경과 전 1/2, 이후 0. 여러 달을 한꺼번에 냈다면 사유가 생긴 달 이후 달은 전액 환급. Korean academy tuition refund.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"monthly_fee":{"type":"number","exclusiveMinimum":0,"description":"월 수강료(원)"},"paid_months":{"type":"integer","minimum":1,"description":"한꺼번에 낸 개월 수(1개월분이면 1)"},"reason_month":{"type":"integer","minimum":1,"description":"환불 사유가 생긴 달(몇 번째 달인지). 기본 1"},"hours_in_month":{"type":"number","exclusiveMinimum":0,"description":"그 달 총 교습시간"},"hours_done":{"type":"number","minimum":0,"description":"그 달 이미 지난 교습시간(시작 전이면 0)"}},"required":["monthly_fee","paid_months","hours_in_month","hours_done"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_travel_cancel_fee":{"post":{"operationId":"calc_travel_cancel_fee","summary":"여행 계약을 소비자 사정으로 해제할 때 위약금과 환급액 계산(여행 표준약관)","description":"여행 계약을 소비자 사정으로 해제할 때 위약금과 환급액 계산(여행 표준약관). 출발 며칠 전에 통보했는지로 여행요금의 0~50%. Korean travel cancellation penalty.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"trip_kind":{"type":"string","enum":["abroad","stay","daytrip"],"description":"abroad=해외여행, stay=국내 숙박여행, daytrip=국내 당일여행"},"trip_fee":{"type":"number","exclusiveMinimum":0,"description":"여행요금 총액(원)"},"paid_amount":{"type":"number","minimum":0,"description":"이미 낸 금액(원). 생략하면 총액 전액"},"depart_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"출발일"},"notice_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"해제 통보일. 생략하면 오늘(KST)"}},"required":["trip_kind","trip_fee","depart_date"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_postpartum_refund":{"post":{"operationId":"calc_postpartum_refund","summary":"산후조리원 중도 해지 환급액 계산","description":"산후조리원 중도 해지 환급액 계산. 입소 전: 통보 시점별 계약금 환급(31일 전 100%, 21일 60%, 10일 30%, 이후 0, 계약 후 24시간 이내는 전액). 입소 후: 총액 − 이용일수 금액 − 10%. Korean postpartum care center refund.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"total_price":{"type":"number","exclusiveMinimum":0,"description":"총 이용금액(원)"},"deposit":{"type":"number","minimum":0,"description":"계약금(원). 입소 전 해지에만 쓰이며 생략하면 총액의 10%"},"enter_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"입소일(예정일)"},"leave_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"퇴실일(예정일)"},"cancel_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"해지 통보일. 생략하면 오늘(KST)"},"within_24h_of_contract":{"type":"boolean","description":"계약 후 24시간 이내 해지인지(입소 전만). 기본 false"},"fault":{"type":"string","enum":["consumer","business"],"description":"해지 사유. consumer=소비자 사정(변심·이사·부상 등), business=업체 사유(폐업·서비스 미제공 등). 기본 consumer"}},"required":["total_price","enter_date","leave_date"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_wedding_cancel_fee":{"post":{"operationId":"calc_wedding_cancel_fee","summary":"예식장 계약 해약 시 위약금(배상금)과 계약금 환급 계산(소비자분쟁해결기준, 2025-12 개정)","description":"예식장 계약 해약 시 위약금(배상금)과 계약금 환급 계산(소비자분쟁해결기준, 2025-12 개정). 예식 며칠 전에 통보했는지로 총비용의 0~70%. Korean wedding hall cancellation penalty.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"total_cost":{"type":"number","exclusiveMinimum":0,"description":"총비용(원)"},"deposit":{"type":"number","minimum":0,"description":"계약금(원). 생략하면 총비용의 10%"},"wedding_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"예식일"},"notice_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"해약 통보일. 생략하면 오늘(KST)"},"fault":{"type":"string","enum":["consumer","business"],"description":"해지 사유. consumer=소비자 사정(변심·이사·부상 등), business=업체 사유(폐업·서비스 미제공 등). 기본 consumer"}},"required":["total_cost","wedding_date"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_rental_cancel_fee":{"post":{"operationId":"calc_rental_cancel_fee","summary":"정수기 등 렌탈 제품을 약정 중 해지할 때 위약금 계산(소비자분쟁해결기준 정수기 등 임대업)","description":"정수기 등 렌탈 제품을 약정 중 해지할 때 위약금 계산(소비자분쟁해결기준 정수기 등 임대업). 의무사용기간 1년 초과: 잔여 렌탈료(월 렌탈료×잔여일수/30)의 10%. 1년 이하: 잔여 렌탈료 30%와 렌탈료 총합 10% 중 적은 금액. 업체 사유면 위약금 없음. 가입비·철거비·미납금은 제외. Korean rental (water purifier) early-termination fee.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"monthly_rent":{"type":"number","exclusiveMinimum":0,"description":"월 렌탈료(원)"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"렌탈 시작일(설치일)"},"term_months":{"type":"integer","minimum":1,"description":"의무사용기간(개월). 따로 없으면 렌탈 기간. 예: 36개월 약정이면 36"},"lease_months":{"type":"integer","minimum":1,"description":"렌탈 전체 기간(개월). 의무사용기간이 1년 이하일 때만 사용, 생략하면 term_months와 같음"},"cancel_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"해지 통보일. 생략하면 오늘(KST)"},"fault":{"type":"string","enum":["consumer","business"],"description":"해지 사유. consumer=소비자 사정(변심·이사·부상 등), business=업체 사유(폐업·서비스 미제공 등). 기본 consumer"}},"required":["monthly_rent","start_date","term_months"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_studyroom_refund":{"post":{"operationId":"calc_studyroom_refund","summary":"교육청에 독서실로 등록된 시설의 이용료 환불액 계산(학원법 시행령 별표 4)","description":"교육청에 독서실로 등록된 시설의 이용료 환불액 계산(학원법 시행령 별표 4). 본인 사정: 납부액 − 게시된 1일 이용료 × 일수(시작일~포기일 전날), 이용 전이면 전액, 1개월 초과는 사유 달만 이 식이고 나머지 달은 전액. 업체 사유(폐업 등): 납부액 − 납부액÷총일수×사용일수. 반환 기한은 사유 발생일부터 5일. 스터디카페(공간임대업·휴게음식점 등록), 시간권·당일권은 대상 아님. Korean registered study room refund.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"paid_amount":{"type":"number","exclusiveMinimum":0,"description":"납부한 이용료 총액(원)"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"이용 시작일"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"이용 종료일(계약상 만료일)"},"quit_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"포기(해지 통보)일 또는 업체 사유 발생일. 생략하면 오늘(KST)"},"daily_fee":{"type":"number","exclusiveMinimum":0,"description":"독서실이 게시한 1일 이용료(원). 본인 사정으로 이용 후 포기할 때 필수. 납부액÷일수가 아니라 현장 게시표 금액"},"used_started":{"type":"boolean","description":"이용을 이미 시작했는지. 기본 true, false면 전액 반환"},"fault":{"type":"string","enum":["consumer","business"],"description":"해지 사유. consumer=소비자 사정(변심·이사·부상 등), business=업체 사유(폐업·서비스 미제공 등). 기본 consumer"}},"required":["paid_amount","start_date","end_date"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_lodging_cancel_fee":{"post":{"operationId":"calc_lodging_cancel_fee","summary":"호텔·펜션·민박·캠핑장 숙박 예약 취소 시 환불·위약금 계산(소비자분쟁해결기준 숙박업, 업소 약관이 없을 때의 참고 기준)","description":"호텔·펜션·민박·캠핑장 숙박 예약 취소 시 환불·위약금 계산(소비자분쟁해결기준 숙박업, 업소 약관이 없을 때의 참고 기준). 체크인 며칠 전에 취소했는지, 성수기/비수기, 주중/주말(금·토·공휴일 전일)로 총요금의 0~90% 공제. 업체 사유면 계약금 환급 + 총요금 대비 배상. 환불불가 상품·플랫폼 약관·수수료는 제외. Korean hotel/pension booking cancellation refund.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"total_fee":{"type":"number","exclusiveMinimum":0,"description":"총 숙박요금(원)"},"paid_amount":{"type":"number","minimum":0,"description":"이미 낸 금액(계약금 또는 결제액, 원). 총 숙박요금 이하. 생략하면 전액 결제"},"checkin_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"체크인일(사용예정일)"},"cancel_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"취소 통보일. 생략하면 오늘(KST)"},"season":{"type":"string","enum":["auto","peak","off"],"description":"auto=체크인일로 자동 판정(7.15~8.24, 12.20~2.20이 성수기), peak=성수기, off=비수기. 업소 약관에 성수기 기간이 따로 있으면 직접 지정. 기본 auto"},"holiday_eve":{"type":"boolean","description":"체크인일이 공휴일 전일인지(주말 취급). 금·토요일 체크인은 자동 주말. 기본 false"},"within_24h":{"type":"boolean","description":"예약 계약 후 24시간 이내 취소인지(성수기 소비자 사유만, 체크인 당일엔 불가). 기본 false"},"fault":{"type":"string","enum":["consumer","business"],"description":"해지 사유. consumer=소비자 사정(변심·이사·부상 등), business=업체 사유(폐업·서비스 미제공 등). 기본 consumer"}},"required":["total_fee","checkin_date"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_show_ticket_cancel_fee":{"post":{"operationId":"calc_show_ticket_cancel_fee","summary":"콘서트·뮤지컬·연극 등 공연 티켓 취소 시 환급액 계산(소비자분쟁해결기준 공연업, 예매처·공연업자 약관이 없을 때의 참고 기준)","description":"콘서트·뮤지컬·연극 등 공연 티켓 취소 시 환급액 계산(소비자분쟁해결기준 공연업, 예매처·공연업자 약관이 없을 때의 참고 기준). 공연일 10일 전까지 전액, 7~9일 전 10%, 3~6일 전 20%, 1~2일 전 30%, 당일(시작 전) 90% 공제. 공연 3일 전까지 예매 후 24시간 이내 취소는 전액 환급. 공연업자 귀책이면 환급 + 입장료 10% 배상. 예매수수료·예매처 자체 취소수수료·공연 시작 후 취소는 제외. 영화·스포츠는 별도 기준. Korean concert/musical ticket cancellation refund.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticket_amount":{"type":"number","exclusiveMinimum":0,"description":"실제 결제한 티켓 금액(원). 할인 후 금액, 예매수수료 제외"},"show_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"공연일"},"cancel_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"취소 날짜. 생략하면 오늘(KST)"},"within_24h":{"type":"boolean","description":"예매 후 24시간 이내 취소인지(공연 3일 전까지만 전액 환급). 기본 false"},"fault":{"type":"string","enum":["consumer","business"],"description":"해지 사유. consumer=소비자 사정(변심·이사·부상 등), business=업체 사유(폐업·서비스 미제공 등). 기본 consumer"}},"required":["ticket_amount","show_date"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_moving_cancel_fee":{"post":{"operationId":"calc_moving_cancel_fee","summary":"이사(이사화물) 계약을 이사일 전에 해제·취소할 때 위약금·배상금 계산(소비자분쟁해결기준 이사화물취급사업, 표준약관)","description":"이사(이사화물) 계약을 이사일 전에 해제·취소할 때 위약금·배상금 계산(소비자분쟁해결기준 이사화물취급사업, 표준약관). 기준계약금=총 이사비용의 10%(실제 낸 계약금과 무관). 업체 사유: 낸 계약금 환급 + 기준계약금의 2배(이사 2일 전까지)·4배(1일 전)·6배(당일)·10배(당일까지 통보 없음). 내 사정: 이사 1일 전까지 취소 1배, 당일 2배(낸 계약금에서 공제). 지연·파손·추가요금은 제외. Korean moving contract cancellation penalty.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"total_fare":{"type":"number","exclusiveMinimum":0,"description":"총 이사비용(운임 등 합계액, 원). 10%가 기준계약금"},"paid_deposit":{"type":"number","minimum":0,"description":"실제 낸 계약금(원). 없으면 0. 생략하면 총액의 10%를 냈다고 봄"},"move_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"약정 이사일"},"notice_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"해제·취소를 통보한 날. 생략하면 오늘(KST)"},"no_notice":{"type":"boolean","description":"업체가 이사 당일까지 아무 통보도 하지 않음(fault=business일 때만, 10배). 기본 false"},"fault":{"type":"string","enum":["consumer","business"],"description":"해제 사유. consumer=내 사정으로 취소, business=업체 사정으로 해제. 기본 consumer"}},"required":["total_fare","move_date"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_car_rental_refund":{"post":{"operationId":"calc_car_rental_refund","summary":"렌터카(자동차대여) 예약취소·인도 전 하자·중도해지 환급액 계산(소비자분쟁해결기준 자동차대여업, 표준약관)","description":"렌터카(자동차대여) 예약취소·인도 전 하자·중도해지 환급액 계산(소비자분쟁해결기준 자동차대여업, 표준약관). case: cancel_consumer=소비자 사정 예약취소(사용개시 24시간 전까지 예약금 전액, 직전 24시간 이내는 예약금에서 대여예정요금 10% 공제), cancel_business=사업자 사정 취소(예약금+대여예정요금 10%), cancel_noshow=1시간 경과 노쇼(반환 없음), cancel_force=천재지변(예약금 전액), defect=인도 이전 하자(대체차량 불가면 낸 요금 전액+총 요금 10%), mid_consumer=고객 사정 중도해지(잔여기간 요금 10% 공제), mid_business=사업자 귀책(잔여기간 요금 10% 가산), mid_force=천재지변(잔여기간 요금 전액). 6개월 이상 장기계약은 별도 약정이 우선이라 제외. 보험 면책금·사고 수리비·유류·반납 지연은 제외. Korean rental-car cancellation refund.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"case":{"type":"string","enum":["cancel_consumer","cancel_business","cancel_noshow","cancel_force","defect","mid_consumer","mid_business","mid_force"],"description":"상황. 위 설명 참고"},"expected_fee":{"type":"number","exclusiveMinimum":0,"description":"대여예정요금 총액(원). 예약 전체 대여요금"},"deposit":{"type":"number","minimum":0,"description":"예약금 또는 실제 낸(선납) 대여요금(원). 예약취소는 예약금, 인도 이전 하자·중도해지는 낸 요금. 없으면 0"},"hours_before":{"type":"number","minimum":0,"description":"cancel_consumer일 때 사용개시까지 남은 시간. 24 이상이면 전액 환급"},"total_days":{"type":"integer","minimum":1,"description":"총 대여일수(mid_*일 때)"},"used_days":{"type":"integer","minimum":0,"description":"사용일수(mid_*일 때)"},"remain_fee":{"type":"number","minimum":0,"description":"mid_*일 때 잔여기간 대여요금을 직접 알면 입력(시간 단위 단가 계약 등). 생략하면 일할 계산"},"alt_car":{"type":"boolean","description":"defect일 때 동급 대체차량 제공 가능 여부. 기본 false"}},"required":["case","expected_fee"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_insurance_withdraw_deadline":{"post":{"operationId":"calc_insurance_withdraw_deadline","summary":"보험 청약철회 기한 계산(금융소비자보호법 제46조)","description":"보험 청약철회 기한 계산(금융소비자보호법 제46조). 철회 마감일 = 증권 받은 날+15일과 청약일+30일 중 먼저 도래하는 날(당일까지 가능, 발송일 기준). 일반금융소비자만 가능, 보장기간 90일 이내·보험금 지급사유 발생 후는 불가. 약관 설명 의무 위반 시 계약 성립일 3개월 이내 취소(상법 제638조의3). 날짜 계산이며 환불 금액은 계산하지 않는다. Korean insurance cooling-off deadline.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"apply_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"보험 청약일"},"policy_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"보험증권을 받은 날. 아직 못 받았으면 생략"},"send_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"철회 의사를 서면·문자·이메일로 발송할 날. 생략하면 오늘(KST)"},"coverage_days":{"type":"integer","minimum":1,"description":"보장기간(일). 90 이하이면 철회 불가. 모르면 생략"},"contract_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"계약 성립일(3개월 취소 계산용). 생략하면 3개월 취소는 계산 안 함"},"professional":{"type":"boolean","description":"전문금융소비자이면 true. 기본 false(일반 소비자)"},"claim_occurred":{"type":"boolean","description":"이미 보험금 지급사유가 발생했으면 true. 기본 false"}},"required":["apply_date"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_gift_certificate_refund":{"post":{"operationId":"calc_gift_certificate_refund","summary":"상품권·기프티콘 환불액 계산(소비자분쟁해결기준 상품권 관련업, 2025","description":"상품권·기프티콘 환불액 계산(소비자분쟁해결기준 상품권 관련업, 2025.12.18 고시). kind: paper=종이 등 일반 상품권, digital_amount=모바일·전자 금액형(충전형·정액형), digital_item=물품·용역 교환권(예: 아메리카노 기프티콘). situation: within7days=구매 다음날부터 7일 이내(신유형만, 구매액 전액), balance=유효기간 내 잔액 환급(권면금액 1만원 이하 80%·초과 60% 이상 사용해야 대상, 금액은 구매금액×(1−사용금액/권면금액), 물품형 제외), expired=유효기간 경과 후 5년 이내 상환 거부 시(종이 구매액의 90%, 신유형 권면 5만원 이하 90%·초과 95%·적립금 환불 100%). 업체 약관의 더 유리한 환불, 지역사랑상품권 등 법령·조례 상품권, 발행자 파산은 제외. 분쟁 해결 참고 기준이며 법적 강제력은 없음. Korean gift certificate / gifticon refund.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["paper","digital_amount","digital_item"],"description":"상품권 종류. 위 설명 참고"},"situation":{"type":"string","enum":["within7days","balance","expired"],"description":"상황. 위 설명 참고"},"purchase_price":{"type":"number","exclusiveMinimum":0,"description":"실제 구매금액(원). 할인 구매면 할인된 금액, 아니면 권면금액과 같음"},"face_value":{"type":"number","exclusiveMinimum":0,"description":"상품권 권면금액(원). balance·expired에 필수, within7days에는 불필요"},"used_amount":{"type":"number","minimum":0,"description":"사용한 금액(권면금액 기준, 원). 미사용이면 0. 생략하면 0"},"purchase_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"구매일(충전형은 최종 충전일). within7days에 필수, expired는 5년 판정에만 사용(생략 가능)"},"request_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"환불 요구일. 생략하면 오늘(KST)"},"point_refund":{"type":"boolean","description":"expired에서 신유형을 포인트·마일리지 등 적립금으로 환불받는 경우(사업자가 적립금 제도를 운영할 때). 기본 false"}},"required":["kind","situation","purchase_price"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_sangjo_cancel_refund":{"post":{"operationId":"calc_sangjo_cancel_refund","summary":"상조(선불식 할부계약) 중도 해약 시 법정 최소 해약환급금 계산(공정위 고시 제2023-14호)","description":"상조(선불식 할부계약) 중도 해약 시 법정 최소 해약환급금 계산(공정위 고시 제2023-14호). 환급금 = 납입금 누계 - 관리비(납입금의 5%, 최대 50만원) - 모집수당 공제액(총 계약대금의 10%, 최대 50만원 중 75% 선공제 + 25% 납입 비례). 정기형(월 균등납입 12회 이상)은 monthly_payment·total_count·paid_count, 부정기형은 total_contract(재화 제공 후 납부 약정액은 빼고 제공 전 납부 약정액만)·paid_total을 넣는다. 납입금이 공제액보다 적으면 0원. 청약철회·사업자 귀책(fault=business)은 위약금 없이 납입액 - 제공 재화 가액. 계약서에 더 유리한 약정이 있으면 그에 따르므로 최소값이다. 여행 선불식·2011.9.1. 이전 계약·부가상품 정산은 제외. Korean funeral (sangjo) prepaid contract cancellation refund.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contract_type":{"type":"string","enum":["regular","irregular"],"description":"regular=정기형(총 계약대금을 12개월 이상 월 균등 납입), irregular=부정기형(그 외)"},"monthly_payment":{"type":"number","exclusiveMinimum":0,"description":"정기형: 월 납입금(원)"},"total_count":{"type":"integer","minimum":12,"description":"정기형: 총(만기) 납입 회차. 예: 120"},"paid_count":{"type":"integer","minimum":1,"description":"정기형: 현재까지 납입한 회차(1 이상 총 회차 이하)"},"total_contract":{"type":"number","exclusiveMinimum":0,"description":"부정기형: 총 계약대금(원). 재화 제공 후 납부하기로 한 금액이 있으면 제외하고 제공 전 납부 약정액만"},"paid_total":{"type":"number","exclusiveMinimum":0,"description":"부정기형: 기납입 선수금 누계(원)"},"commission_rate":{"type":"number","minimum":0,"maximum":10,"description":"모집수당 비율(%). 생략하면 고시 최대치 10. 업체가 낮게 적용하는 경우만"},"provided_value":{"type":"number","minimum":0,"description":"이미 제공받은 재화·용역 가액(원). 있으면 환급금에서 추가 공제. 기본 0"},"fault":{"type":"string","enum":["consumer","business"],"description":"해약 사유. consumer=소비자 사유 중도 해약, business=청약철회 또는 사업자 귀책(위약금 없음). 기본 consumer"}},"required":["contract_type"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_realestate_brokerage_fee":{"post":{"operationId":"calc_realestate_brokerage_fee","summary":"부동산 중개보수(중개수수료) 상한과 초과분 반환액 계산(공인중개사법 시행규칙 제20조, 별표 1·2)","description":"부동산 중개보수(중개수수료) 상한과 초과분 반환액 계산(공인중개사법 시행규칙 제20조, 별표 1·2). 의뢰인 한쪽 기준 상한이며 부가세·실비는 별도. 주택 매매 0.4~0.7%(5천만~2억 구간 한도 80만원), 주택 임대차 0.3~0.6%, 오피스텔(전용 85㎡ 이하+입식부엌·수세식화장실·목욕시설) 매매 0.5%·임대차 0.4%, 상가·토지 등 0.9% 이내 협의. 월세는 보증금+월세×100(합 5천만원 미만이면 ×70)으로 환산. paid_amount를 주면 상한을 넘겨 낸 금액(반환 청구 가능 추정액)을 계산. 시·도 조례 확인 필요. Korean real estate brokerage fee cap and overcharge refund.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"property_type":{"type":"string","enum":["house","officetel","other"],"description":"대상물 유형. house=주택(부속토지 포함), officetel=오피스텔(전용 85㎡ 이하이고 전용 입식 부엌·수세식 화장실·목욕시설을 모두 갖춤), other=상가·토지·요건 미충족 오피스텔"},"deal_type":{"type":"string","enum":["sale","lease"],"description":"거래 종류. sale=매매·교환(교환은 가액이 큰 쪽), lease=임대차(전세·월세)"},"price":{"type":"number","exclusiveMinimum":0,"description":"매매가 또는 보증금(원)"},"monthly_rent":{"type":"number","minimum":0,"description":"월세(원). 임대차일 때만, 없으면 생략 또는 0"},"paid_amount":{"type":"number","minimum":0,"description":"실제 지급한(또는 요구받은) 중개보수(원, 부가세 제외). 주면 상한 초과분을 계산"}},"required":["property_type","deal_type","price"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_golf_cancel_fee":{"post":{"operationId":"calc_golf_cancel_fee","summary":"골프장 이용 전 예약 취소 위약금 계산(소비자분쟁해결기준 골프장, 표준약관 제6조)","description":"골프장 이용 전 예약 취소 위약금 계산(소비자분쟁해결기준 골프장, 표준약관 제6조). 이용예정일까지 남은 날수와 주말·공휴일 여부로 팀별 골프코스 이용요금의 0~30%. 주말·공휴일은 4일 전까지 0%, 3~2일 전 10%, 1일 전 20%, 당일 30%. 평일은 3일 전까지 0%, 2일 전 10%, 1일 전 20%, 당일 30%. 소비자 사유는 예약금과 상계, 사업자 사유는 예약금 환급 + 같은 비율 배상, 불가항력 휴장은 예약금 전액 환급. 카트·클럽하우스·세금·캐디피는 제외, 골프장 자체 약관이 다를 수 있음. 입장 후 환급은 페이지에서 계산. Korean golf course booking cancellation penalty.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"play_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"이용예정일(라운드 날짜)"},"cancel_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"취소 통보일. 생략하면 오늘(KST). 무통보 불참은 이용예정일 당일로"},"is_holiday":{"type":"boolean","description":"이용예정일이 평일 공휴일인지. 토·일은 자동 주말. 기본 false"},"team_fee":{"type":"number","exclusiveMinimum":0,"description":"팀별 골프코스 이용요금 합계(원) = 1인 코스요금 × 인원. 카트·클럽하우스 요금·세금 제외"},"deposit":{"type":"number","minimum":0,"description":"낸 예약금(원). 없으면 0 또는 생략"},"fault":{"type":"string","enum":["consumer","business","force"],"description":"취소 사유. consumer=소비자 사정(단순변심 등), business=골프장 책임, force=강설·폭우·태풍 등 불가항력으로 골프장이 임시휴장. 기본 consumer"}},"required":["play_date","team_fee"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_late_interest":{"post":{"operationId":"calc_late_interest","summary":"금전채무 지연이자(지연손해금) 계산","description":"금전채무 지연이자(지연손해금) 계산. 원금과 이자 시작일·종료일(양끝 포함)로 일수를 세고, 민사 연 5%·상사 연 6%·약정이율 중 하나를 적용합니다. 소장 부본 송달 다음 날(lawsuit_from)을 주면 그날부터 소송촉진법 이율(2019.6.1.~ 연 12%, 그 전 기간은 15%·20%)로 구간을 나눠 계산합니다. 1년은 365일, 원 미만 버림. 약정이율이 연 20%를 넘으면 이자제한법에 따라 20%로 줄입니다.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"type":"number","exclusiveMinimum":0,"description":"원금(원)"},"from_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"이자 시작일(지급 기한 다음 날 등). 이 날도 일수에 포함"},"to_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"계산 종료일. 생략하면 오늘(KST). 이 날도 일수에 포함"},"rate_type":{"type":"string","enum":["civil","commercial","agreed"],"description":"civil=민사 법정 연 5%, commercial=상행위 연 6%, agreed=약정이율(agreed_rate 필요). 기본 civil"},"agreed_rate":{"type":"number","exclusiveMinimum":0,"description":"약정 연이율(%). rate_type이 agreed일 때만. 예: 10"},"lawsuit_from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"소장 부본이 채무자에게 송달된 다음 날. 있으면 이 날부터 소송촉진법 이율 적용(선택)"}},"required":["principal","from_date"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_loan_schedule":{"post":{"operationId":"calc_loan_schedule","summary":"대출 상환 스케줄(회차별 납입액·원금·이자·잔액)","description":"대출 상환 스케줄(회차별 납입액·원금·이자·잔액). 원리금균등·원금균등·만기일시, 거치 기간 지원. 고정금리 기준이며 변동금리·실제 일수 이자는 다루지 않습니다. Korean loan repayment schedule.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"type":"number","exclusiveMinimum":0,"description":"대출 원금(원)"},"annual_rate":{"type":"number","minimum":0,"maximum":100,"description":"연 이자율(%). 예: 4.5"},"months":{"type":"integer","minimum":1,"maximum":600,"description":"총 대출 기간(개월, 거치 포함)"},"grace_months":{"type":"integer","minimum":0,"description":"거치 개월 수(이자만 냄). 기본 0"},"method":{"type":"string","enum":["annuity","principal","bullet"],"description":"annuity=원리금균등, principal=원금균등, bullet=만기일시. 기본 annuity"}},"required":["principal","annual_rate","months"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_prepay_fee":{"post":{"operationId":"calc_prepay_fee","summary":"대출 중도상환수수료 계산(중도상환금액 × 수수료율 × 잔존일수 ÷ 대출기간 일수)","description":"대출 중도상환수수료 계산(중도상환금액 × 수수료율 × 잔존일수 ÷ 대출기간 일수). 수수료율은 약정서 값을 넣습니다. Korean early-repayment fee.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0,"description":"중도상환금액(원)"},"fee_rate":{"type":"number","minimum":0,"maximum":10,"description":"중도상환수수료율(%). 약정서 값. 예: 1.4"},"left_days":{"type":"integer","minimum":0,"description":"상환일부터 만기(또는 면제 시작일)까지 남은 일수"},"total_days":{"type":"integer","minimum":1,"description":"대출 기간 전체 일수"}},"required":["amount","fee_rate","left_days","total_days"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_overtime_pay":{"post":{"operationId":"calc_overtime_pay","summary":"월 연장·야간·휴일근로 수당과 주휴수당 계산","description":"월 연장·야간·휴일근로 수당과 주휴수당 계산. 연장 1.5배, 야간 가산 0.5배, 휴일 8시간 이내 1.5배·초과 2배. 5인 미만이면 가산 없이 1.0배. 통상시급은 직접 넣습니다(월급제는 월급÷209 등). Korean overtime and weekly holiday pay.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"wage":{"type":"number","exclusiveMinimum":0,"description":"통상 시급(원)"},"overtime_hours":{"type":"number","minimum":0,"description":"연장근로 시간(월 합계)"},"night_hours":{"type":"number","minimum":0,"description":"22~06시에 일한 시간 전체(월 합계)"},"holiday_hours":{"type":"number","minimum":0,"description":"휴일근로 8시간 이내 시간"},"holiday_over_hours":{"type":"number","minimum":0,"description":"휴일근로 8시간 초과 시간"},"week_hours":{"type":"number","minimum":0,"description":"주 소정근로시간(주휴수당용, 15시간 이상일 때 계산). 생략하면 주휴수당 제외"},"five_or_more":{"type":"boolean","description":"상시 5인 이상 사업장이면 true(기본)"}},"required":["wage"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_severance":{"post":{"operationId":"calc_severance","summary":"퇴직금 계산","description":"퇴직금 계산. 입사일·퇴직일(양끝 포함), 퇴직 전 3개월 임금 총액(세전), 지난 1년 상여금·연차수당으로 1일 평균임금을 구해 퇴직금을 계산. 무급휴직 기간 제외·퇴직연금(DC/DB)은 다루지 않습니다. Korean severance pay.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"join_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"입사일"},"leave_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"퇴직일(마지막 근무일). 이 날도 재직일수에 포함"},"wages_3m":{"type":"number","exclusiveMinimum":0,"description":"퇴직 전 3개월 임금 총액(세전, 원)"},"bonus_year":{"type":"number","minimum":0,"description":"지난 1년 상여금 총액(원). 기본 0"},"leave_allowance_year":{"type":"number","minimum":0,"description":"지난 1년 연차수당 총액(원). 기본 0"},"ordinary_daily":{"type":"number","minimum":0,"description":"1일 통상임금(원, 선택). 평균임금보다 크면 이 값을 씁니다"}},"required":["join_date","leave_date","wages_3m"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_payroll_slip":{"post":{"operationId":"calc_payroll_slip","summary":"급여명세서용 4대보험 공제와 사업주 부담, 총 인건비 계산(2026년 7월 이후 요율)","description":"급여명세서용 4대보험 공제와 사업주 부담, 총 인건비 계산(2026년 7월 이후 요율). 소득세는 간이세액표에서 찾은 값(income_tax)을 입력하며 이 도구가 계산하지 않습니다. Korean payslip with social insurance (income tax is an input).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$","description":"급여 귀속 월(YYYY-MM, 2026-07 이후)"},"gross":{"type":"number","exclusiveMinimum":0,"description":"월 총지급액(원)"},"nontax":{"type":"number","minimum":0,"description":"비과세 합계(식대 월 20만원 등, 원). 기본 0"},"income_tax":{"type":"number","minimum":0,"description":"근로소득 간이세액표에서 찾은 소득세(원). 기본 0"},"size":{"type":"string","enum":["150","150p","1000","1000p"],"description":"사업주 고용안정 요율 구분: 150=150인 미만, 150p=150인 이상(우선지원대상 아님), 1000=150인 이상 우선지원 외 1000인 미만, 1000p=1000인 이상. 기본 150"},"accident_rate":{"type":"number","minimum":0,"maximum":20,"description":"산재보험료율(%, 사업주 부담, 업종별). 기본 0"}},"required":["month","gross"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_freelancer_tax":{"post":{"operationId":"calc_freelancer_tax","summary":"프리랜서 3","description":"프리랜서 3.3% 원천징수(소득세 3% + 지방소득세 0.3%, 10원 미만 절사)를 지급 건별로 계산. expense_rate를 주면 연간 종합소득세 정산 추정(과세표준·결정세액·환급 또는 추가납부)도 계산합니다. 실제 신고는 세무사·홈택스에서 확인하세요. Korean freelancer 3.3% withholding and rough annual tax.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"payments":{"type":"array","items":{"type":"number","exclusiveMinimum":0},"minItems":1,"description":"지급액 목록(원, 세전). 예: [1000000, 2500000]"},"expense_rate":{"type":"number","minimum":0,"exclusiveMaximum":100,"description":"경비율(%). 주면 연간 정산 추정을 함께 계산. 생략하면 건별 원천징수만"},"dependents":{"type":"integer","minimum":1,"maximum":20,"description":"본인 포함 기본공제 인원. 기본 1"},"other_deduction":{"type":"number","minimum":0,"description":"그 밖의 소득공제(원). 기본 0"}},"required":["payments"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}},"/api/calc/calc_lease_renewal":{"post":{"operationId":"calc_lease_renewal","summary":"임대차(주택·상가) 갱신 통지·갱신요구 가능 기간과 증액 5% 상한 계산","description":"임대차(주택·상가) 갱신 통지·갱신요구 가능 기간과 증액 5% 상한 계산. 종료일 6개월 전 ~ 2개월(주택)·1개월(상가) 전. 경계일은 하루 차이가 날 수 있어 도착일 기준 여유를 두세요. Korean lease renewal notice window and 5% rent cap.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["house","shop"],"description":"house=주택, shop=상가"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"계약 종료일"},"today":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"기준일. 생략하면 오늘(KST)"},"deposit":{"type":"number","minimum":0,"description":"현재 보증금(원)"},"rent":{"type":"number","minimum":0,"description":"현재 월 차임(원). 전세면 0"}},"required":["kind","end_date","deposit"],"additionalProperties":false}}}},"responses":{"200":{"description":"계산 결과(answer는 사용자에게 그대로 전달할 문장)","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"result":{"type":"object"},"basis":{"type":"string"},"caveat":{"type":"string"},"page":{"type":"string"}}}}}},"400":{"description":"입력 오류(error에 사유)"}}}}}}