단순 정규식의 함정, 세금 식별 번호 검증의 유지보수 전략

Context

단순한 알고리즘으로 보이는 세금 식별 번호 검증 로직을 내부 구현. 엣지 케이스 및 국가별 복잡한 규정 미반영으로 인한 데이터 무결성 훼손 발생. 잘못된 값이 정상으로 처리되는 Silent Bug로 인한 사후 처리 비용 증가.

Technical Solution

• NIF, NIE, CIF, IBAN 등 다양한 식별자 타입별 공식 알고리즘을 적용한 외부 API 전환
• 특정 접두사에 따른 가변 길이 및 체크섬 계산 로직을 추상화한 자동 타입 감지 구조
• JavaScript BigInt 미지원 환경에서 발생하는 IBAN MOD-97 계산 오류를 해결한 서버 사이드 검증 방식
• 엔티티 타입에 따라 숫자와 문자가 혼용되는 CIF 제어 문자 검증 로직 정교화
• 법규 변경 및 포맷 업데이트를 API 제공자가 전담하는 관리형 아키텍처 채택
• JSON 기반의 구조화된 응답 체계를 통해 검증 실패 사유를 명확히 전달하는 인터페이스 설계

Impact

• Trial 엔드포인트 기준 IP당 일일 50회 무료 검증 제공

Key Takeaway

비즈니스 도메인의 규정이나 법적 표준이 빈번히 변하는 로직은 내부 구현보다 전문 API를 통한 외주화가 유지보수 비용과 데이터 리스크를 줄이는 효율적인 설계임.