국세완납증명서 발급(신청)

활용 시나리오

• 금융 입찰 제출용 완납 증명 — 은행 대출, 지자체 공공 입찰, 거래처 계약에서 요구하는 국세완납증명서를 API로 신청하고 접수번호를 시스템에 남깁니다.
• ERP 그룹웨어 일괄 신청 — 법인 지점별 담당자가 홈택스에 직접 로그인하지 않고, 연동 세션 기준으로 증명서 신청 Job을 배치 스케줄로 실행합니다.
• 신청 접수 추적 — 응답의 민원 ID 접수번호를 내부 티켓 CRM과 매핑해 발급 수령 단계와 대사합니다.
• 표시 옵션 통제 — 주소 주민번호 표시, 발급 매수, 제출처 수령방법 등 신청 옵션을 Job params로 명시해 정책에 맞게 제출합니다.

연동 절차

1. 1. 홈택스 세션 연동 — account_link_id로 인증된 홈택스 세션을 준비합니다. tin txpr_nm을 생략하면 세션의 사업자 상호가 사용됩니다.
2. 2. 신청 옵션 지정 — 주소 주민번호 공개 여부, 발급 매수, 제출처 수령방법 등 필요 시 params로 전달합니다.
3. 3. 국세완납증명 신청 실행 — POST /hometax/products/v1/a/c1/national-tax-payment Job을 호출해 홈택스에 국세완납증명서 신청을 제출합니다.
4. 4. 접수 결과 저장 — 응답의 cvaId rcatNo를 저장하고, 증명서 목록 다운로드 등 후속 Job(별도 상품)과 연계합니다.