원천징수 신고 명세 제출

활용 시나리오

• 급여 원천 세무 마감 — 귀속 제출 연월을 지정해 원천세 신고 제출 Job을 실행하고, 수기 홈택스 제출을 줄입니다.
• 다른 세무 API와 구분 — 지급명세서 **조회** **제출내역 조회** 상품과 action을 혼동하지 않도록 카탈로그를 분리합니다.
• non-idempotent 운영 — 동일 연월 중복 제출을 막기 위해 재시도 스케줄 정책과 Idempotency-Key를 관리합니다.
• 홈택스 세무대리 대행 — 고객 account_link 세션으로 원천세 신고 제출을 대행하고 결과를 내부 티켓에 남깁니다.

연동 절차

1. 1. 홈택스 세션 — account_link_id로 로그인 세션을 준비합니다(필요 시 session.login 선행).
2. 2. 귀속 제출 연월 — txtn_ym, sbms_ym(YYYYMM)과 tin(선택)을 params에 설정합니다.
3. 3. 제출 실행 — POST .../withholding-submit — hometax.tax.withholding.submit Job을 호출합니다.
4. 4. 결과 확인 — 응답을 저장하고 홈택스 화면 후속 조회로 제출 여부를 검증합니다.