+ 모모유통 ERP는 본사가 도매처에서 물품을 사들여 자체 창고에 적재하고, + 가입된 소매 대리점(거래처)이 시스템에서 출고를 요청하면 담당자가 검수·승인하여 출고하는 유통관리 솔루션입니다. +
+| 역할 | 설명 |
|---|---|
| 거래처 USER | 가입한 소매 대리점. 발주만 가능. |
| 관리자 ADMIN | 모모유통 임직원. 품목/창고/회원 마스터 관리 + 출고/입금 처리 + 통계. |
/login)/m/orders/new)/signup)거래처 회원가입 전용. 모모유통 직원은 가입 X, 관리자가 직접 등록.
+| 필드 | 필수 | 설명 |
|---|---|---|
| 이메일 | Y | 로그인 ID로 사용 |
| 비밀번호 | Y | 8자 이상 |
| 업체명 | Y | 거래명세표에 표시 |
| 대표자 | N | |
| 연락처 | Y | 휴대폰 |
| 주소 | Y | 배송지 |
| 사업자등록번호 | N | 전자세금계산서 발행 시 필수 |
/m/orders/new)로그인 직후 자동으로 이 화면이 열립니다. 품목 카드를 카트에 담고 [발주 요청] 버튼으로 전송합니다.
+ +[품목명/코드] 전체/면세/과세[조회]max_order_qty) 자동 클램프.ORD-YYYYMMDD-NNNN) 부여.| 배지 | 의미 |
|---|---|
| 면세 | 부가세 면제 품목 |
| 택배 | 택배 전용 — 카트에 담으면 택배 라인 자동 추가 |
| "1회 한도 ≤ N" | 1회 발주 최대 수량 제한 (관리자 권한 부여 시 무시) |
/m/orders)| 상태 | 의미 |
|---|---|
| 출고요청 | 거래처가 발주 요청, 담당자 처리 대기 |
| 출고완료 | 담당자 승인 후 재고 차감 + 거래명세표 메일 발송됨 |
| 입금완료 | 대금 입금 등록 완료 |
| 계산서발행 | 전자세금계산서 발행 완료 |
| 취소 | 담당자 반려 또는 본인 취소 |
/profile)헤더 우측의 자기 이름을 클릭하면 진입.
+/m/admin/orders)좌측 발주 리스트에서 선택하면 우측에 거래명세표 미리보기가 표시됩니다. 체크박스 다중 선택 후 [출고]를 누르면 일괄 처리됩니다.
+ +total_supply/vat/amount/delivery/charter)는 백엔드에서 자동 재집계거래명세표 하단에 [세금계산서 발행 (과세)] / [계산서(면세)] 버튼이 노출. 클릭 시 /api/m/einvoices/issue 호출 → 발행 결과 모달 (승인번호/처리방식).
NTS_ESERO_MODE=test|prod 환경변수 전환 시 활성화./m/admin/payments)paid_amount/paid_date 갱신/m/admin/invoices)/m/admin/einvoices)출고/입금 완료된 발주에 대해 별도로 전자(세금)계산서를 발행하고 이력을 관리하는 전용 메뉴.
+/api/m/einvoices/issue 호출 → 결과 모달 (승인번호/처리방식)EINVOICE_PROVIDER)| 값 | 동작 | 비용 |
|---|---|---|
manual (기본) | 자체 거래명세서, DB 기록만 | 0원 |
nts | 국세청 e-세로 직접 연동 (XMLDSig + SOAP) | 인증서 연 4~5만원 |
popbill | (향후) Popbill REST API | 건당 100~150원 |
DRAFT → QUEUED → SENT → ACK | FAIL | CANCELED
/m/admin/items)max_order_qty) — 1회 발주 최대 수량. 공란/0 = 제한 없음.is_hidden) — '숨김' 선택 시 일반 회원에게는 카드가 안 보임. 권한자만 노출.requires_delivery) — '택배전용' 선택 시 카트에 담기면 택배 라인 자동 추가, 발주 시 택배 없으면 차단./m/admin/customers)user_type='C') 회원 목록 + 정보/권한 수정unlimited_qty='Y') — 모든 품목의 1회 발주 한도를 무시하고 재고만큼 발주 가능view_hidden='Y') — 숨김 품목도 발주 화면에 노출/admin-panel)의 사용자 폼에서도 같은 권한 수정 가능| 메뉴 | 경로 | 역할 |
|---|---|---|
| 매입처 관리 | /m/admin/vendors | 매입 발주처 등록 (도매처) |
| 창고 관리 | /m/admin/warehouses | 적재 창고 + 픽업/입출고 분류 |
| 제조사 관리 | /m/admin/makers | 품목 제조사 마스터 |
| 메뉴 | 경로 | 역할 |
|---|---|---|
| 매입 발주 | /m/admin/procurements | 매입처에 보낼 발주서 작성 |
| 입고 처리 | /m/admin/inbounds | 발주한 품목 입고 등록 → 재고 증가 |
| 재고 관리 | /m/admin/inventory | 현재 재고 + 입출고 이력 |
| 메뉴 | 경로 | 설명 |
|---|---|---|
| 대시보드 | /m/dashboard | 전체 요약 |
| 월간 매출 | /m/admin/statistics | 업체별 면세/과세/총 매출 (TOP15 막대그래프) + 엑셀 |
| 일자별 매출 | /m/admin/statistics/daily | 일별 매출 추이 (스택 막대 + 건수 라인) + 엑셀 |
| 원가/마진 | /m/admin/statistics/margin | 품목별 매출/원가/마진 TOP10 + 마진율 + 엑셀 |
모든 통계 화면 우상단의 [엑셀 다운로드] 버튼으로 .xlsx 파일을 받을 수 있습니다.
++[거래처 USER] [관리자 ADMIN] + │ │ + ① 출고 요청 작성 ─────────────► 발주서 관리 (/m/admin/orders) + (품목+택배/용차) │ 체크 + [출고] 버튼 + ▼ + ② 재고 차감 + ③ 거래명세표 메일 발송 (status = APPROVED) + │ + ④ 입금 ──────────────────────► 입금 관리 (/m/admin/payments) + │ 입금 등록 + ▼ (status = PAID) + │ + ⑤ 거래명세표 / 세금계산서 ◄──── 전자세금계산서 (/m/admin/einvoices) + │ [세금계산서 발행] 클릭 + ▼ (status = INVOICED) + ⑥ 통계 / 매출 / 원가 마진 분석 + (/m/admin/statistics/*) ++
A. 카트에 택배 배지 품목이 들어 있으면 반드시 택배 라인이 1줄 이상 있어야 합니다. 자동 추가되어야 정상이지만 안 되면 [＋ 택배 추가] 수동 클릭.
+ +A. 품목별 max_order_qty 제한입니다. 관리자가 [거래처 회원 관리]에서 해당 회원에게 제한수량 해지 권한을 부여하면 무시됩니다.
A. 일반 회원에게는 노출되지 않습니다. 관리자가 [거래처 회원 관리]에서 숨김처리 보기 권한을 부여하면 카드가 보입니다.
+ +A. 출고 모달의 결과창에 "메일 N건 실패" 표시가 있습니다. 거래처 이메일 주소를 [거래처 회원 관리]에서 확인하고 SMTP 환경변수를 점검합니다 (SMTP_HOST/PORT/USER/PASS/FROM).
A. 현재 NTS_ESERO_MODE=stub 입니다. 국세청에 실제 전송하지 않고 DB 기록만 합니다. 운영 활성화 절차:
.env.production 에 NTS_ESERO_MODE=test, NTS_ESERO_USER_ID/PW, NTS_ESERO_CERT_PATH/PW 설정NTS_ESERO_MODE=prod 전환A. 관리자가 [관리자 패널 → 사용자 관리]에서 신규 비밀번호로 초기화. 시스템 관리자(admin)도 같은 방법.
A. 발주 작성·통계·관리자 화면 모두 반응형으로 설계되어 있습니다 (375px ~). 헤더는 사용자명 + 로그아웃만 노출. 좌측 메뉴는 햄버거 토글로 접기/펴기.
+ ++ 문서 버전: v0.6 — 2026-05-07 · 모모유통 ERP +
+