Core Solution(MindGarden) ERP 연동·거래 생성·트러블슈팅. confirm-payment vs confirm-deposit 흐름, amount-info API, relatedTransactions 조회.
ERP(재무 거래) 연동, 매칭 입금/결제 확인, 거래 생성 관련 작업 시 이 스킬을 적용하세요.
| 구분 | confirm-payment | confirm-deposit |
|---|---|---|
| API | POST /api/v1/admin/mappings/{id}/confirm-payment | POST /api/v1/admin/mappings/{id}/confirm-deposit |
| 요청 파라미터 | paymentMethod, paymentReference, paymentAmount | depositReference |
| ERP 거래 타입 | INCOME (입금 시) / RECEIVABLES (미수금) |
| INCOME |
| 용도 | 결제·입금 확인 (금액 포함) | 입금 확인 (현금 수입) |
| 핵심 로직 | AdminServiceImpl.confirmPayment(4arg) → createConsultationIncomeTransaction | AdminServiceImpl.confirmDeposit → createConsultationIncomeTransaction |
createConsultationIncomeTransaction, createAdditionalSessionIncomeTransaction 재사용GET /api/v1/admin/amount-management/mappings/{mappingId}/amount-info
담당: AmountManagementController, AmountManagementServiceImpl.getIntegratedAmountInfo()
반환 구조:
packagePrice, paymentAmount, packageName, totalSessionsaccurateAmount: 거래용 금액 (packagePrice 우선, 없으면 paymentAmount)relatedTransactions: 관련 ERP 거래 목록 (id, amount, type, description, createdAt)relatedTransactionCount: relatedTransactions 개수isConsistent, consistencyMessage, recommendation: 금액 일관성 검사 결과관련 엔티티: CONSULTANT_CLIENT_MAPPING, CONSULTANT_CLIENT_MAPPING_ADDITIONAL, CONSULTANT_CLIENT_MAPPING_REFUND
| 키워드 | 의미 |
|---|---|
상담료 수입 거래 자동 생성 완료 | INCOME 거래 생성 성공 |
상담료 수입 거래 자동 생성 실패 | INCOME 거래 생성 예외 |
중복 거래 방지 | 이미 존재 → 스킵 (정상) |
유효한 거래 금액을 결정할 수 없습니다 | packagePrice/paymentAmount 둘 다 없음 |
[중앙화] 상담료 수입 거래 생성 완료 | createConsultationIncomeTransaction 성공 |
[미수금] 매출채권 거래 생성 완료 | RECEIVABLES 거래 생성 성공 |
입금 확인 ERP 거래 스킵 | effectiveAmount 없음으로 거래 미생성 |
상세 트러블슈팅 절차는 docs/standards/ERP_TROUBLESHOOTING.md 참조.