010-0000-1234? 자진발급 번호, 0 하나 차이의 실수

자진발급에서 가장 많이 하는 실수

현금영수증 자진발급은 고객의 정보를 모를 때 국세청 지정 번호로 우선 발행하는 중요한 절차예요. 그런데 이때 가장 자주 발생하는 실수가 있어요. 바로 자진발급 번호의 자릿수예요.

가운데 0이 하나 더

가장 많이 하는 실수는 바로 가운데 '0'의 개수예요.

국세청이 지정한 자진발급 전용 번호는 일반적인 휴대폰 번호(11자리)와 달리 총 10자리예요. 무의식적으로 11자리 형식을 적용하다가 010-0000-1234로 등록하는 실수가 자주 생겨요.

---

잘못 등록했을 때 발생하는 문제

만약 시스템에서 010-0000-1234(11자리)로 발급 요청을 보내면 다음과 같은 상황이 발생할 수 있어요.

• 오발행 리스크: 010-0000-1234로 현금영수증 발행은 자진발급이 아니라 소득공제로 발급 성공해요. 추후 자진발급에서 개인의 소득공제로 변경될 수 없게 되므로, 이는 가맹점의 현금영수증 의무 발행 위반 으로 이어질 수 있어 주의가 필요해요.

---

개발자를 위한 예방 및 해결 팁

Step 1: 입력값 검증(Validation) 강화

자진발급 로직을 짤 때, 입력값이 010000으로 시작한다면 자동으로 0100001234로 변환되거나, 11자리가 들어오지 못하도록 정규표현식(Regex)을 통해 체크하세요.

Step 2: 자동 보정 로직 구현

고객 정보가 없는 '자진발급' 모드일 경우, 시스템 내부적으로 상수를 정의하여 사용하는 것이 안전해요.

Step 3: 이미 잘못 발행했다면?

이미 010-0000-1234로 발행을 시도해 실패했다면, 즉시 원거래 번호를 확인하여 취소한 뒤, 정확한 번호인 010-000-1234로 재발행 절차를 밟아야 해요.

---

왜 이게 중요한가요?

자진발급은 세무 행정의 공백을 메우는 장치예요. 번호 하나가 틀리면 정산 데이터 전체의 신뢰도가 떨어지고, 가맹점은 과태료 대상이 될 수 있어요.

헥토파이낸셜 API 연동 시 identity 필드의 자릿수 체크 로직은 반드시 공통 모듈에 포함시키세요.

현금영수증 문서 바로가기 →