재무 모듈 (기관관리자)
기관 구성원이 매출 청구 / 입금 매칭 / 세금계산서 / 경비 / 계약 / 정산 보고서를 다룰 수 있도록 재무관리 모듈을 활성화합니다.
외부 연동은 자가 등록: 팝빌 (세금계산서 + 입금조회) / 아임웹 (주문 수집) 자격증명은 본 모듈 활성 후 기관관리자가 직접 화면에서 등록 — 시스템관리자 개입 불필요.
1. 사전 조건
| 항목 | 필수 / 권장 | 비고 |
|---|---|---|
| (없음 — 단독 활성 가능) | — | 재무 모듈 단독으로도 동작 |
| 팝빌 파트너 회원 | 권장 | 세금계산서 자동 발행 / 입금 자동 수집 |
| 아임웹 OAuth 자격증명 | 선택 | 아임웹 주문 → billing_item 자동 매핑 |
| CRM 모듈 활성 | 선택 | 견적 → 계약 승격 흐름 |
2. 모듈 활성화
좌측 사이드바 → 관리자 → 모듈 관리 (/app/admin/modules) → "재무관리" 카드 토글 ON.
활성화 직후 좌측 사이드바에 재무관리 메뉴가 추가됩니다.
3. 메뉴 노출 정책 (M9-A / M9-B)
재무관리는 하위 화면이 많아 사용 범위에 맞춰 메뉴를 정리할 수 있습니다.
3.1 메뉴 그룹 (M9-A)
좌측 메뉴는 다음 그룹으로 구분:
재무관리
├── 매출
│ ├── 매출 대장
│ ├── 청구
│ ├── 입금 매칭
│ └── 세금계산서
├── 매입
│ ├── 경비
│ └── 영수증
├── 계약
└── 보고서
└── 월별 정산3.2 그룹 / 개별 메뉴 토글 (M9-B)
재무 모듈 카드의 [설정] 패널 → 메뉴 표시 탭:
| 토글 | 효과 |
|---|---|
| 그룹 단위 ON/OFF | 예: "매입" 그룹 OFF → 경비 / 영수증 메뉴 한 번에 숨김 |
| 개별 메뉴 ON/OFF | 예: 영수증 메뉴만 숨기고 경비는 유지 |
→ 기관의 사용 범위 (예: 매출만 / 매입만 / 둘 다) 에 맞게 정리.
4. 외부 연동 (팝빌 · 아임웹)
본 모듈 활성 후 재무관리 → 외부 연동 (/app/finance/integrations) 에서 자가 등록 가능.
| 연동 | 용도 | 가이드 |
|---|---|---|
| 팝빌 — 전자세금계산서 | 매출 확정 시 자동 발행 + 발행 결과 자동 갱신 | 팝빌 연동 |
| 팝빌 — 계좌조회 (EasyFin) | 사업자 계좌 입금내역 자동 수집 → 매출 자동 매칭 | 팝빌 연동 |
| 아임웹 OAuth2 | 아임웹 주문 → billing_item 자동 매핑 | (작성 예정) |
자격증명은 모두 AES-GCM 으로 암호화 저장 — 시스템관리자도 평문 조회 불가.
5. 세금계산서 / 청구 / 경비 — 기능 개요
| 영역 | 기능 |
|---|---|
| 매출 대장 | 청구 건 생성 → 입금 매칭 → 세금계산서 발행까지 일원 추적 |
| 입금 매칭 | 팝빌 EasyFin 수집 → 입금자명/금액 자동 매칭 → 보류함에서 수동 선택 가능 |
| 세금계산서 | 입금 확정 시 자동 발행 (팝빌) / 수동 발행 / 수정 발행 |
| 경비 | 메일에서 영수증 첨부 → 경비 행 자동 생성 (create_expense_from_email 흐름) |
| 계약 | CRM 견적 승격 → 계약 행 / 매출 자동화 시작점 |
| 정산 보고서 | 월별 매출 vs 입금 vs 세금계산서 매칭 현황 |
6. 알림 (M5)
다음 이벤트 발생 시 SSE / 모바일 푸시로 알림:
- 입금 자동 매칭 성공 (담당자에게)
- 입금 매칭 보류함에 신규 항목
- 세금계산서 발행 완료 / 실패
- 아임웹 주문 신규 수집
알림 수신자 / 채널 설정은 별도 정책 — 현재는 매출 담당 사용자 자동 구독.
7. 모듈 비활성화 시 영향
| 항목 | 영향 |
|---|---|
| 좌측 사이드바 재무관리 메뉴 | 즉시 사라짐 |
| 매출 / 청구 / 경비 / 계약 데이터 | DB 에 보관 (재활성 시 복구) |
| 팝빌 / 아임웹 외부 연동 자격증명 | 보관됨 (재활성 시 복구) — 폴링 cron 만 중단 |
| 세금계산서 자동 발행 cron | 중단 |
| 입금 자동 수집 cron | 중단 |
| CRM 견적 → 계약 승격 | 비활성 |
자격증명까지 삭제하려면 외부 연동 화면에서 개별 [연결 해제] 후 모듈 비활성.
8. 트러블슈팅
메뉴가 안 보임
- 모듈 ON 확인
- 메뉴 노출 토글에서 그룹/개별 OFF 되어 있는지 확인 (3-2 참고)
세금계산서 자동 발행이 안 됨
- 팝빌 연동 자격증명 등록 + 연결 테스트 성공 여부 확인
- 팝빌 측 공동인증서 등록 여부
- 팝빌 콘솔의 콜백 URL + 시스템 환경변수
POPBILL_WEBHOOK_SECRET(시스템관리자 영역)
입금이 자동 매칭 안 됨
- 입금 매칭 보류함에 쌓이는지 확인 (매칭 후보가 여러 건이면 자동 매칭 보류)
- alias 학습 (M4-A) 이 누적될수록 자동 매칭률 향상
관련 가이드
- 팝빌 연동 — 세금계산서 + 입금조회 자격증명 자가 등록
- CRM 모듈 (관리자) — 견적 → 계약 승격 흐름
- Gmail 모듈 (관리자) — 메일 → 경비 (영수증 첨부) 흐름