개인 국세 통합조회 인증 요청
req_hometax_bundle개인 국세 통합조회를 위한 본인 간편인증을 요청합니다. products 로 조회할 상품을 고르면 고른 상품만 승인 한 번으로 실행하고, 단가는 고른 상품 단가의 합입니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_hometax_bundle에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | 본인 이름 | |
| year | No | 증명 귀속연도 4자리 (증명을 고를 때 사용) | |
| phone | Yes | 본인 명의 휴대전화 번호 (숫자만) | |
| years | No | 신고·납부내역 조회 연수 (1~10, 생략 시 1) | |
| format | No | 증명 응답 형식 (생략 시 both) | |
| engl_yn | No | 영문 증명 여부 (Y/N, 생략 시 N) | |
| itrf_cd | No | 증명 발급 사유 코드 (서버 공통코드) | |
| delivery | No | 교부방법 (06 프린터·10 화면·04 팩스·12 전자문서지갑) | |
| issuance | No | 증명 발급 구분 (서버 공통코드) | |
| products | Yes | 조회할 상품 키 (1개 이상). personal_income·cash_receipt_deduction·income_by_payer·income_data_check·tax_return_history·tax_payment_history·income_amount_cert·pension_credit_cert·fact_cert | |
| quantity | No | 발급 희망 수량 (1~5, 생략 시 1) | |
| birthDate | Yes | 생년월일 8자리 (YYYYMMDD) | |
| end_month | No | 증명 조회 종료 월 (01~12) | |
| submit_to | No | 제출처 코드 2자리 (증명을 고를 때 사용) | |
| incomeYears | No | 소득·현금영수증 조회 연수 (1~5, 생략 시 1) | |
| start_month | No | 증명 조회 시작 월 (01~12) | |
| use_purpose | No | 사용용도 코드 2자리 (증명을 고를 때 사용) | |
| authProvider | Yes | 휴대폰에서 승인할 간편인증 방식 | |
| resno_open_yn | No | 주민등록번호 공개 여부 (Y/N) | |
| amount_open_yn | No | 소득금액증명 금액 공개 여부 (Y/N) | |
| address_open_yn | No | 주소 공개 여부 (Y/N) | |
| income_source_open_yn | No | 소득금액증명 소득발생처 공개 여부 (Y/N) | |
| withholding_all_print_yn | No | 소득금액증명 원천징수의무자 전체 표시 (Y/N) |