피드로 돌아가기
Dev.toBackend
원문 읽기
FBR API 기반 실시간 Digital Invoicing 및 IRN 발행 시스템 구축
Integrating Pakistani Businesses with the FBR Digital Invoicing API
AI 요약
Context
파키스탄 SRO 709(I)/2025 규정에 따라 모든 매출세 등록 사업자의 실시간 송장 전송 의무화. PRAL 운영 Digital Invoicing API를 통한 법적 유효성 확보 및 IRN-QR 코드 발행 체계 구축 필요.
Technical Solution
- Bearer Token 기반 인증 체계를 통한 NTN별 개별 보안 세션 유지 및 AES-256 암호화 저장
- validateinvoicedata를 통한 사전 검증 후 postinvoicedata로 IRN 및 QR 코드 획득하는 2-Step 제출 프로세스 설계
- HS Code 데이터베이스 정합성 검증 및 세액 계산식의 수학적 일치 여부를 확인하는 Strict JSON Payload 검증 로직 적용
- API 장애 및 Silent Rejection 대응을 위한 Idempotency 보장 Queue-and-Retry 메커니즘 구현
- 28가지 필수 테스트 시나리오를 CI 파이프라인에 통합하여 프로덕션 배포 전 정합성 강제 검증
- Base64 인코딩된 QR 이미지를 PDF 템플릿에 임베딩하여 법적 효력을 갖춘 최종 인보이스 렌더링
실천 포인트
- API 토큰의 Plain Text 로그 기록 금지 및 AES-256 암호화 저장 여부 확인 - 외부 API의 Silent Rejection 대응을 위한 일일 데이터 대조(Daily Reconciliation) 프로세스 구축 - 28가지 엣지 케이스 시나리오를 포함한 자동화 테스트 세트 확보 - QR 코드 출력물 최소 2cm x 2cm 규격 준수 및 고대비 렌더링 검토