- 모모유통 ERP는 본사가 도매처에서 물품을 사들여 자체 창고에 적재하고, - 가입된 소매 대리점(거래처)이 시스템에서 출고를 요청하면 담당자가 검수·승인하여 출고하는 유통관리 솔루션입니다. + 모모유통은 도매처에서 물건을 사들여 자체 창고에 쌓아두고, + 가게(거래처)들이 인터넷으로 물건을 주문하면 담당자가 확인해서 보내주는 회사예요. + 이 시스템은 그 과정을 종이/엑셀이 아니라 컴퓨터·핸드폰으로 한 번에 처리할 수 있게 해주는 도구입니다.
-| 역할 | 설명 | |
|---|---|---|
| 거래처 USER | 가입한 소매 대리점. 발주만 가능. | |
| 관리자 ADMIN | 모모유통 임직원. 품목/창고/회원 마스터 관리 + 출고/입금 처리 + 통계. | |
| 사용자 | 하는 일 | 주로 쓰는 메뉴 |
| 거래처 (물건 사는 가게) |
+ 물건 검색하고 주문 넣기 | +거래처 주문 메뉴 (출고 요청) | +
| 출고 담당 (모모 직원) |
+ 가게가 넣은 주문을 확인하고 보내기 → 창고 재고 줄어듦(−) 입금 확인, 세금계산서 끊기 |
+ 출고/정산 메뉴 | +
| 입고 담당 (모모 직원) |
+ 도매처에 물건 주문, 받아서 등록 → 창고 재고 늘어남(+) | +매입/입고 메뉴 | +
| 물품 등록 담당 (모모 직원) |
+ 팔 물건, 가게 회원, 도매처 등 기본 정보 등록·관리 | +마스터 관리 메뉴 | +
| 관리자 (사장님 등) |
+ 매출·이익이 얼마나 났는지 보기 | +통계 메뉴 | +
로그인하면 왼쪽에 메뉴 5개가 줄지어 있어요. 클릭하면 그 메뉴의 화면이 오른쪽에 펼쳐져요.
+💡 가게(거래처)는 '거래처 주문' 메뉴만 쓰면 돼요. 다른 메뉴는 모모유통 직원이 사용해요.
/login)/m/orders/new)/signup)거래처 회원가입 전용. 모모유통 직원은 가입 X, 관리자가 직접 등록.
+주소창에 momotogether.com 을 치고 들어가면 로그인 화면이 나와요.
+처음 거래하는 가게라면 직접 가입할 수 있어요. (모모 직원은 가입 X — 사장이 직접 등록해 줘요)
| 필드 | 필수 | 설명 |
|---|---|---|
| 이메일 | Y | 로그인 ID로 사용 |
| 비밀번호 | Y | 8자 이상 |
| 업체명 | Y | 거래명세표에 표시 |
| 대표자 | N | |
| 연락처 | Y | 휴대폰 |
| 주소 | Y | 배송지 |
| 사업자등록번호 | N | 전자세금계산서 발행 시 필수 |
| 적는 칸 | 필수? | 설명 |
| 이메일 | 네 | 이게 로그인 아이디가 돼요 |
| 비밀번호 | 네 | 8자 이상 |
| 가게 이름 | 네 | 거래명세표나 세금계산서에 나올 이름 |
| 대표자 | 아니오 | 세금계산서 끊을 때 필요 |
| 전화번호 | 네 | 휴대폰 번호 |
| 주소 | 네 | 물건 받을 곳 |
| 사업자등록번호 | 아니오 | 세금계산서 받으려면 꼭 필요 |
가게 사장님이 모모유통에서 물건을 주문할 때 쓰는 화면이에요. 컴퓨터로도 핸드폰으로도 잘 보입니다.
-/m/orders/new)로그인 직후 자동으로 이 화면이 열립니다. 품목 카드를 카트에 담고 [발주 요청] 버튼으로 전송합니다.
+ +로그인하면 자동으로 이 화면이 열려요.
-[품목명/코드] 전체/면세/과세[조회]▲ 장바구니를 누르면 펼쳐지면서 [택배비 추가] [용차비 추가] 버튼이 보여요
+ +| 표시 | 뜻 | 가게가 알아둘 점 |
|---|---|---|
| 면세 | 세금이 붙지 않는 물건 | 그냥 참고만 — 시스템이 알아서 세금 계산 |
| 택배만 | 택배로만 보내는 물건 | 이걸 담으면 택배비 줄이 자동으로 추가돼요. 빼면 주문이 안 돼요. |
| "한 번에 30개까지만" | 한 번에 담을 수 있는 최대 개수 | 이 개수까지만 담겨요. 더 담고 싶으면 모모 직원에게 권한 신청. |
| "창고에 0개"가 빨간색 | 품절 | [＋ 담기] 버튼이 눌리지 않아요 |
max_order_qty) 자동 클램프.ORD-YYYYMMDD-NNNN) 부여.| 배지 | 의미 |
|---|---|
| 면세 | 부가세 면제 품목 |
| 택배 | 택배 전용 — 카트에 담으면 택배 라인 자동 추가 |
| "1회 한도 ≤ N" | 1회 발주 최대 수량 제한 (관리자 권한 부여 시 무시) |
장바구니에 택배만 표시 물건이 있어요. 이런 물건은 반드시 택배비 줄이 1개 이상 있어야 주문이 돼요. 자동으로 들어가야 정상이지만 안 보이면 [＋ 택배 추가] 버튼을 눌러서 줄을 만들어 주세요.
+/m/orders)| 상태 | 의미 |
|---|---|
| 출고요청 | 거래처가 발주 요청, 담당자 처리 대기 |
| 출고완료 | 담당자 승인 후 재고 차감 + 거래명세표 메일 발송됨 |
| 입금완료 | 대금 입금 등록 완료 |
| 계산서발행 | 전자세금계산서 발행 완료 |
| 취소 | 담당자 반려 또는 본인 취소 |
/profile)헤더 우측의 자기 이름을 클릭하면 진입.
+ +왼쪽 메뉴의 거래처 주문 → 내 주문 내역 을 누르면 보여요.
+| 상태 | 무슨 뜻인가요? | 가게가 할 일 |
|---|---|---|
| 출고요청 | 주문이 들어갔고, 모모 직원이 처리하기를 기다리는 중 | 혹시 취소하고 싶으면 모모유통에 전화·문자로 연락 |
| 출고완료 | 모모 직원이 확인해서 보냈어요. 창고 재고는 줄었어요. 거래명세표가 메일로 와 있어요. | 거래명세표 받아서 확인 + 입금 진행 |
| 입금완료 | 입금이 들어왔다고 모모 직원이 등록했어요 | 세금계산서를 기다리세요 |
| 계산서발행 | 전자세금계산서가 발행됐어요 | 홈택스에서 사업자번호로 조회 가능 |
| 취소 | 주문이 취소됐어요 | — |
오른쪽 위 [엑셀] 버튼을 누르면 전체 주문 내역을 엑셀 파일로 받을 수 있어요.
+ + +화면 오른쪽 위에 있는 내 이름을 누르면 들어가져요.
출고 담당자는 가게가 넣은 주문을 보고 창고에서 물건을 꺼내 보내는 사람이에요. 출고 처리를 하면 창고 재고가 자동으로 줄어요(−). 입금 확인과 세금계산서 끊는 일도 같이 해요.
-/m/admin/orders)좌측 발주 리스트에서 선택하면 우측에 거래명세표 미리보기가 표시됩니다. 체크박스 다중 선택 후 [출고]를 누르면 일괄 처리됩니다.
+ +왼쪽 메뉴 출고/정산 → 출고 관리로 들어가요.
-| ☐ | 주문번호 | 날짜 | 상태 |
|---|---|---|---|
| ☑ | ORD-20260507-0002 | 5/7 | 요청 |
| ☐ | ORD-20260507-0001 | 5/7 | 요청 |
| — | ORD-20260506-0003 | 5/6 | 완료 |
| # | 물건명 | 구분 | 창고 | 개수 | 가격 | 합계 | |
|---|---|---|---|---|---|---|---|
| 1 | 택배 택배비 | 과세 | - | [1] | [4000] | 4,000 | ✓ ✕ |
| 2 | 용차 용차 | 과세 | - | [2] | [5000] | 10,000 | ✓ ✕ |
| 3 | 꽃계탕 | 면세 | 212 | 2 | 4,500 | 9,000 | |
| 4 | 빨강 탈취제 | 과세 | 100 | 2 | 9,200 | 18,400 |
total_supply/vat/amount/delivery/charter)는 백엔드에서 자동 재집계거래명세표 하단에 [세금계산서 발행 (과세)] / [계산서(면세)] 버튼이 노출. 클릭 시 /api/m/einvoices/issue 호출 → 발행 결과 모달 (승인번호/처리방식).
물품 등록할 때 "택배전용"으로 설정한 물건이 가게의 주문에 들어 있으면, 시스템이 알아서 택배비 줄을 1줄 추가해요. 출고 담당자는 가격/개수만 검토하면 돼요.
+NTS_ESERO_MODE=test|prod 환경변수 전환 시 활성화.거래명세표 아래의 [✕ 반려] 버튼을 누르면 주문이 취소돼요. (재고는 영향 없음) 가게에 따로 전화/메시지로 이유를 알려 주세요.
-/m/admin/payments)paid_amount/paid_date 갱신출고완료/입금완료 상태인 주문의 거래명세표 아래쪽에 세금계산서 발행 계산서(면세) 두 버튼이 떠요. 누르면 [나-3 세금계산서 끊기] 화면과 같은 흐름으로 처리돼요.
-/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) — '택배전용' 선택 시 카트에 담기면 택배 라인 자동 추가, 발주 시 택배 없으면 차단.| 주문번호 | 일자 | 거래처 | 합계 | 상태 | 발행 |
|---|---|---|---|---|---|
| ORD-20260506-0003 | 5/6 | 홍길동상회 | 37,200 | 출고완료 | ▶ 세금계산서 |
| 발행일 | 거래처 | 구분 | 합계 | 승인번호 | 상태 |
|---|---|---|---|---|---|
| 5월 6일 | 홍길동상회 | 세금 | 37,200 | 20260506-... | 완료 |
/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 파일을 받을 수 있습니다.
+[나-1 출고 관리] 화면에서 출고/입금이 끝난 주문의 거래명세표 아래에 세금계산서 발행 버튼이 떠 있어요. 거기서 눌러도 똑같이 발행돼요.
- + + + +입고 담당자는 도매처에서 물건을 사 와서 창고에 쌓는 사람이에요. 입고 등록을 하면 창고 재고가 자동으로 늘어요(+). 물품 등록 담당자는 팔 물건, 가게 회원, 도매처 등 기본 정보를 등록·관리해요.
+ + +왼쪽 메뉴 매입/입고 → 매입 발주.
+물건이 창고에 도착하면 이 화면에서 등록해요. 등록하면 창고 재고가 늘어나요(+).
+왼쪽 메뉴 매입/입고 → 재고 관리.
+왼쪽 메뉴 마스터 관리 → 품목 관리. 가게가 주문 화면에서 보는 물건 카드를 여기서 만들고 관리해요.
+ +| 사용 / 중지 | 판매 중 / 판매 안 함 |
| 숨김 | 일반 가게 화면에는 안 보임 (권한자만 보임) |
| ≤30 | 한 번에 30개까지만 주문 가능 |
| 택배 | 택배 전용 — 장바구니에 담으면 택배비 줄이 자동 생김 |
왼쪽 메뉴 마스터 관리 → 거래처 회원 관리. 가입한 가게들의 정보와 특수 권한을 관리해요.
+ +| 권한 이름 | 켜면 어떻게 되나요? | 언제 켜주나요? |
|---|---|---|
| 제한수량 해지 | 모든 물건의 "한 번에 N개까지" 제한이 사라져요. 창고에 있는 만큼 다 살 수 있어요. | 오래 거래한 단골 가게, 한 번에 많이 사가는 가게 |
| 숨김처리 보기 | "숨김"으로 등록된 물건도 주문 화면에 보여요 | 특정 카테고리 전문 가게, 신상품을 먼저 보여줄 가게 |
왼쪽 메뉴 마스터 관리 안에 있어요.
+| 메뉴 이름 | 여기에 등록하는 것 |
|---|---|
| 매입처 관리 | 도매처(우리가 물건을 사 오는 곳) — 회사 이름, 연락처, 사업자번호 |
| 창고 관리 | 창고 — 본사 창고, 김포 지사 창고, 픽업 장소 등 분류 |
| 제조사 관리 | 물건을 만든 회사. 물건 등록할 때 여기서 골라요. |
| 메뉴 | 여기서 볼 수 있는 것 |
|---|---|
| 대시보드 | 오늘·이번 달 매출, 진행 중인 주문 등 한눈에 요약 |
| 월간 매출 (가게별) | 년/월을 고르면 가게별 면세·과세·총 매출이 표 + 막대그래프(상위 15개)로 보여요 |
| 일자별 매출 | 기간을 고르면 날짜별 매출 추이가 막대그래프 + 주문 건수 라인으로 보여요 |
| 원가/마진 | 월별로 어떤 물건이 얼마나 팔렸고, 원가 빼면 이익이 얼마인지 (상위 10개 그래프) |
모든 통계 화면 오른쪽 위에 ⬇ 엑셀 버튼이 있어서 엑셀 파일로 받을 수 있어요.
+-[거래처 USER] [관리자 ADMIN] - │ │ - ① 출고 요청 작성 ─────────────► 발주서 관리 (/m/admin/orders) - (품목+택배/용차) │ 체크 + [출고] 버튼 - ▼ - ② 재고 차감 - ③ 거래명세표 메일 발송 (status = APPROVED) - │ - ④ 입금 ──────────────────────► 입금 관리 (/m/admin/payments) - │ 입금 등록 - ▼ (status = PAID) - │ - ⑤ 거래명세표 / 세금계산서 ◄──── 전자세금계산서 (/m/admin/einvoices) - │ [세금계산서 발행] 클릭 - ▼ (status = INVOICED) - ⑥ 통계 / 매출 / 원가 마진 분석 - (/m/admin/statistics/*) +5. 전체 일이 어떻게 흘러가나요?
++ [입고 담당자] [거래처(가게)] [출고 담당자] + │ │ │ + ① 도매처에 물건 주문 │ │ + │ │ │ + ② 물건 들어오면 입고 등록 │ │ + │ → 창고 재고 + │ │ + │ │ │ + └────► 창고에 재고 쌓임 ────────► │ │ + │ │ + ③ 가게가 주문 │ + (물건 + 자동 택배) │ + │ │ + └─────► ④ 출고 담당이 주문 확인 ──┘ + │ + ▼ + ⑤ 창고 재고 − + ⑥ 거래명세표 메일 발송 (가게에게) + ⑦ 상태 = 출고완료 + │ + ⑧ 가게가 입금 ─────────► ⑨ 입금 등록 + │ 상태 = 입금완료 + ▼ + ⑩ 세금계산서 발행 + │ 상태 = 계산서발행 + ▼ + ⑪ 매출·이익 분석 (월말)
A. 카트에 택배 배지 품목이 들어 있으면 반드시 택배 라인이 1줄 이상 있어야 합니다. 자동 추가되어야 정상이지만 안 되면 [＋ 택배 추가] 수동 클릭.
+장바구니에 택배만 표시 물건이 있어요. 이런 물건은 반드시 택배비 줄이 1줄 이상 있어야 주문이 돼요. 자동으로 들어가야 정상이지만, 안 보이면 [＋ 택배 추가] 버튼을 눌러서 줄을 만들어 주세요.
-A. 품목별 max_order_qty 제한입니다. 관리자가 [거래처 회원 관리]에서 해당 회원에게 제한수량 해지 권한을 부여하면 무시됩니다.
물건마다 "한 번에 N개까지"라는 제한이 있어요. 모모 직원에게 연락해서 "제한수량 해지" 권한을 부탁하면 풀려요. 권한이 풀리면 창고에 있는 만큼 다 살 수 있어요.
-A. 일반 회원에게는 노출되지 않습니다. 관리자가 [거래처 회원 관리]에서 숨김처리 보기 권한을 부여하면 카드가 보입니다.
+일부 물건은 모모유통이 일반 가게에게는 보이지 않게 숨겨 둘 수 있어요. "숨김처리 보기" 권한을 받으면 그런 물건도 볼 수 있어요. 모모 직원에게 권한 신청하세요.
-A. 출고 모달의 결과창에 "메일 N건 실패" 표시가 있습니다. 거래처 이메일 주소를 [거래처 회원 관리]에서 확인하고 SMTP 환경변수를 점검합니다 (SMTP_HOST/PORT/USER/PASS/FROM).
출고 결과 알림창에 "메일 N건 실패"라고 표시돼요. [거래처 회원 관리]에서 그 가게의 이메일 주소가 정확한지 확인해 주세요. 그래도 안 가면 시스템 개발자에게 연락 (메일 서버 점검 필요).
-A. 현재 NTS_ESERO_MODE=stub 입니다. 국세청에 실제 전송하지 않고 DB 기록만 합니다. 운영 활성화 절차:
화면을 새로고침(F5)하면 정상으로 보여요. (이 부분은 5월 7일 패치에서 자동 동기화로 수정됐어요)
+ +지금은 진짜 국세청에 보내지 않고 시스템 내부에만 기록되는 상태예요. 진짜로 발송하려면 다음이 필요해요:
.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 +
주문 화면, 통계 화면 등 거의 모든 화면이 휴대폰에서도 잘 보이도록 만들어졌어요. 만약 깨진다면 새로고침을 한 번 해보세요. 왼쪽 메뉴는 햄버거 버튼(≡)을 눌러서 펼치고 접을 수 있어요.
+ +거래명세표는 [엑셀] 버튼으로 다운받은 뒤 엑셀에서 인쇄하면 돼요. 세금계산서는 운영 모드 활성화 후에 홈택스에서 PDF로 출력할 수 있어요.
+ ++ 이 설명서는 2026년 5월 7일에 만들어졌어요 · 모모유통 · momotogether.com