홈택스
현금영수증 당일발행 수정
국세청 홈택스에서 당일 발급한 현금영수증 건을 수정합니다. 홈택스 연동 데이터를 내부 업무 흐름에 연결해 활용할 수 있습니다.
활용 시나리오
- 당일 금액 정정 — POS 입력 오류로 금액만 바로잡을 때 승인번호 금액으로 수정 Job을 호출합니다.
- 홈택스 조회 후 수정 — daily_issue.search로 승인번호를 확인한 뒤 modify를 실행해 잘못된 건 수정을 줄입니다.
- 자동화 파이프라인 — 조회→수정을 한 워크플로로 묶되 non-idempotent 특성을 고려해 재시도 정책을 분리합니다.
- 홈택스 취소와 분리 — 취소(cancel) action과 상품 문구를 분리해 운영 실수를 방지합니다.
연동 절차
- 1. 당일 발급 조회 — search Job으로 aprv_no 금액을 확인합니다.
- 2. 수정 값 확정 — tota_trs_amt 및 필요 시 거래유형 용도 필드를 지정합니다.
- 3. 수정 실행 — POST .../modify-daily-issue Job을 호출합니다.
- 4. 결과 검증 — 응답을 저장하고 재조회로 반영 여부를 확인합니다.