마감다리 급여전표 자동 연동

이번 달 급여 마감 건과 부서별 생성된 전표 묶음, 건별 전송 상태가 한 화면에 보입니다. 마감이 감지된 건은 전표 생성 진행 상태로 이어집니다.

• 아마란스10 조회 API 응답을 Zod 스키마로 검증해 내부 표준 전표 구조로 정규화
• BullMQ 작업 큐에 마감 건 단위 전표 생성 작업을 등록하고 진행 상태를 조회
• React Query 폴링으로 마감 건과 전표 묶음 상태를 화면에 반영

마감 감지부터 전표 묶음 생성까지를 작업 큐 하나의 흐름으로 묶어 같은 마감 건이 두 번 생성되지 않도록 구조를 설계합니다.

생성된 전표를 차변·대변 합계와 함께 목록으로 검토하고, 이어카운트와 SAP 양식별로 바뀐 필수 컬럼을 대조해 봅니다. 합계가 맞지 않는 전표는 경고로 표시됩니다.

• 대상 시스템별 양식 정의를 데이터로 분리해 컬럼 추가에 코드 수정이 필요 없도록 구성
• 차변·대변 합계 검증과 필수 컬럼 누락 검사를 전송 전 단계에서 일괄 실행
• TanStack Table로 전표 목록 필터·정렬과 상세 행 펼침 구성

양식 정의와 변환 엔진을 분리해 SAP와 이어카운트 양식이 달라도 같은 전표 원본에서 각각의 업로드 양식을 만들도록 설계합니다.

전표별로 대기·전송 중·완료·실패 상태가 보이고, 실패한 건은 사유와 함께 다시 전송할 수 있습니다. 이미 전송이 끝난 전표는 다시 보내지 않도록 막힙니다.

• 전표 해시 기반 멱등 키로 같은 전표의 중복 전송을 서버에서 차단
• 재시도 횟수와 지수 백오프를 작업 큐 옵션으로 설정하고 실패 사유를 분류해 저장
• SAP 전송 어댑터 인터페이스에 파일 전달 구현을 먼저 연결하고 자동 전송 구현을 교체 가능하게 설계

전송 방식이 환경에 따라 달라지는 SAP 연동을 어댑터 구조로 분리해 파일 전달에서 자동 전송으로 코드 변경 범위를 좁히도록 설계합니다.

자동 전송이 어려운 경우를 위해 선택한 전표 묶음을 엑셀 또는 CSV 파일로 내려받습니다. 대상 시스템 양식에 맞춘 파일 이름과 컬럼 구성으로 만들어집니다.

• ExcelJS로 양식별 컬럼 순서와 숫자·날짜 서식을 지정한 xlsx 생성
• CSV는 UTF-8 BOM과 구분자 설정을 지원해 한글 깨짐을 방지
• 다운로드 요청자와 시각을 이력 테이블에 기록

하나의 양식 정의에서 전송 페이로드와 엑셀·CSV 파일을 함께 만들어 자동 전송과 수동 업로드가 같은 내용이 되도록 구조를 설계합니다.