From 6b751e48d0c994ef9b5b19ff76f58528e0eb29a6 Mon Sep 17 00:00:00 2001 From: chpark Date: Thu, 7 May 2026 20:45:07 +0900 Subject: [PATCH] =?UTF-8?q?chore(manual=20+=20fix):=20=EB=A7=A4=EB=89=B4?= =?UTF-8?q?=EC=96=BC=20=ED=95=9C=EA=B8=80=ED=99=94=20+=20=ED=83=9D?= =?UTF-8?q?=EB=B0=B0/=EC=9A=A9=EC=B0=A8=20=EB=9D=BC=EC=9D=B8=20=EB=8F=99?= =?UTF-8?q?=EA=B8=B0=ED=99=94=20=EB=B2=84=EA=B7=B8=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit [매뉴얼] - 영어/기술용어/환경변수 코드 노출 제거 - 초등학생 수준 친절한 설명체로 전면 재작성 - 역할별 시나리오 박스 + 화면 도식 + FAQ 한글 위주 - URL/코드 참조 최소화 [ExtraRow 버그] - 거래명세표에서 [+ 택배/용차 추가] 클릭해도 인풋 칸의 수량이 화면에 안 바뀌던 문제 - 같은 OBJID 라서 컴포넌트가 unmount 안 되어 useState 초기값 무시되던 케이스 - useEffect 로 line prop 변경 시 인풋 state 동기화 Co-Authored-By: Claude Opus 4.7 (1M context) --- public/manual.html | 899 +++++++++++++++++-------- src/app/(main)/m/admin/orders/page.tsx | 8 + 2 files changed, 616 insertions(+), 291 deletions(-) diff --git a/public/manual.html b/public/manual.html index 2946787..13c82f2 100644 --- a/public/manual.html +++ b/public/manual.html @@ -3,69 +3,76 @@ -모모유통 ERP 사용자 매뉴얼 +모모유통 사용 설명서 @@ -104,334 +133,622 @@
-

모모유통 ERP 사용자 매뉴얼

-
유통관리 시스템 v0.6 · 발주 → 출고 → 정산 → 전자세금계산서까지
+

모모유통 사용 설명서

+
물건을 사고 파는 과정을 컴퓨터로 처리하는 시스템 — 누구나 쉽게 따라할 수 있어요
- 도메인 · momotogether.com - 대상 · 거래처 · 모모유통 임직원 · 시스템 관리자 - 업데이트 · 2026-05-07 + 홈페이지 주소 · momotogether.com + 이용 대상 · 거래처(가게) / 모모유통 직원 + 수정일 · 2026년 5월 7일
-
-

1. 시스템 개요

+
+

1. 이 시스템은 어떤 시스템인가요?

- 모모유통 ERP는 본사가 도매처에서 물품을 사들여 자체 창고에 적재하고, - 가입된 소매 대리점(거래처)이 시스템에서 출고를 요청하면 담당자가 검수·승인하여 출고하는 유통관리 솔루션입니다. + 모모유통은 도매처에서 물건을 사들여 자체 창고에 쌓아두고, + 가게(거래처)들이 인터넷으로 물건을 주문하면 담당자가 확인해서 보내주는 회사예요. + 이 시스템은 그 과정을 종이/엑셀이 아니라 컴퓨터·핸드폰으로 한 번에 처리할 수 있게 해주는 도구입니다.

-

주요 기능

+ +

한 줄로 정리하면

-
거래처 발주품목 검색 → 카트 → 택배/용차 추가 → 발주 요청
-
출고 처리담당자 일괄 승인 + 거래명세표 메일 자동 발송
-
입금 관리입금 등록 → 미수금 추적
-
전자세금계산서출고/입금 후 별도 발행 (국세청 직접 연동 대비 골격)
-
통계 / 그래프일별·월별·업체별·원가/마진 분석 + 엑셀 다운로드
-
회원 권한제한수량 해지 / 숨김품목 보기 등 거래처별 특수권한
+
가게는 사이트에서 물건을 주문해요
+
모모 직원은 주문을 보고 물건을 보내요
+
창고에서 물건이 자동으로 빠져요(−)
+
또 다른 직원은 도매처에서 물건을 사와요
+
창고에 물건이 자동으로 쌓여요(+)
+
월말에는 매출·이익을 한눈에 봐요
-

역할 구분

+

누가 어떤 메뉴를 쓰나요?

- - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
역할설명
거래처 USER가입한 소매 대리점. 발주만 가능.
관리자 ADMIN모모유통 임직원. 품목/창고/회원 마스터 관리 + 출고/입금 처리 + 통계.
사용자하는 일주로 쓰는 메뉴
거래처
(물건 사는 가게)		물건 검색하고 주문 넣기거래처 주문 메뉴 (출고 요청)
출고 담당
(모모 직원)		가게가 넣은 주문을 확인하고 보내기 → 창고 재고 줄어듦(−)
입금 확인, 세금계산서 끊기		출고/정산 메뉴
입고 담당
(모모 직원)		도매처에 물건 주문, 받아서 등록 → 창고 재고 늘어남(+)매입/입고 메뉴
물품 등록 담당
(모모 직원)		팔 물건, 가게 회원, 도매처 등 기본 정보 등록·관리마스터 관리 메뉴
관리자
(사장님 등)		매출·이익이 얼마나 났는지 보기통계 메뉴
+ +

왼쪽에 있는 메뉴 5개

+

로그인하면 왼쪽에 메뉴 5개가 줄지어 있어요. 클릭하면 그 메뉴의 화면이 오른쪽에 펼쳐져요.

+
+
momotogether.com
+
📦 모모유통👤 내 이름 · 로그아웃
+
+
+
━ 왼쪽 메뉴 ━
+ ▸ 거래처 주문
+ ▸ 출고/정산 (직원만)
+ ▸ 매입/입고 (직원만)
+ ▸ 마스터 관리 (직원만)
+ ▸ 통계 +
+
+ 선택한 메뉴의 내용이 여기에 보여요 +
+
+
+ +

💡 가게(거래처)는 '거래처 주문' 메뉴만 쓰면 돼요. 다른 메뉴는 모모유통 직원이 사용해요.

-

2. 로그인 · 회원가입

-

로그인 (URL: /login)

-
    -
  1. 아이디 이메일 또는 사번 형태(관리자) 입력
    2. -
  2. 비밀번호 입력 후 [로그인]
    3. -
  3. 성공 시 자동 이동 → 출고 요청 화면(/m/orders/new)
    4. -
-
모든 사용자는 로그인 후 출고 요청 화면으로 이동합니다. 관리자는 좌측 메뉴에서 [출고/정산] 등으로 이동.
+

2. 로그인하기 · 회원가입하기

-

회원가입 (URL: /signup)

-

거래처 회원가입 전용. 모모유통 직원은 가입 X, 관리자가 직접 등록.

+

2.1 로그인하기

+

주소창에 momotogether.com 을 치고 들어가면 로그인 화면이 나와요.

+
    +
  1. 아이디 입력가게는 이메일 주소, 모모 직원은 회사에서 받은 아이디를 입력해요.
    2. +
  2. 비밀번호 입력하고 [로그인] 버튼 클릭틀리면 빨간 글씨로 알려줘요. 비밀번호를 까먹었다면 모모 직원에게 연락해서 다시 받으세요.
    3. +
  3. 로그인 성공 → '주문 화면'이 자동으로 열려요모든 사용자는 로그인하면 똑같이 주문 화면으로 가요. 직원은 거기서 왼쪽 메뉴로 자기 화면으로 이동하면 돼요.
    4. +
+ +

2.2 회원가입하기 거래처(가게)만

+

처음 거래하는 가게라면 직접 가입할 수 있어요. (모모 직원은 가입 X — 사장이 직접 등록해 줘요)

- - - - - - - - + + + + + + + + + +
필드필수설명
이메일Y로그인 ID로 사용
비밀번호Y8자 이상
업체명Y거래명세표에 표시
대표자N
연락처Y휴대폰
주소Y배송지
사업자등록번호N전자세금계산서 발행 시 필수
적는 칸필수?설명
이메일네이게 로그인 아이디가 돼요
비밀번호네8자 이상
가게 이름네거래명세표나 세금계산서에 나올 이름
대표자아니오세금계산서 끊을 때 필요
전화번호네휴대폰 번호
주소네물건 받을 곳
사업자등록번호아니오세금계산서 받으려면 꼭 필요
-
비밀번호 분실 시 관리자가 [마스터 관리 → 거래처 회원 관리]에서 초기화하거나 신규 비번 발급. 본인은 [회원정보 수정] 화면에서 변경 가능.
- -
-

3. 거래처(USER) 가이드

+ + + +
+

거래처 가. 거래처(가게) 사용법

+

가게 사장님이 모모유통에서 물건을 주문할 때 쓰는 화면이에요. 컴퓨터로도 핸드폰으로도 잘 보입니다.

-

3.1 출고 요청 (URL: /m/orders/new)

-

로그인 직후 자동으로 이 화면이 열립니다. 품목 카드를 카트에 담고 [발주 요청] 버튼으로 전송합니다.

+ +

가-1. 물건 주문하기 — 가장 많이 쓰는 화면

+

로그인하면 자동으로 이 화면이 열려요.

-

화면 구성

-
-
/m/orders/new
+

화면이 어떻게 생겼나요?

+
+
momotogether.com (주문 화면)
-
🛒 발주 장바구니 [N개]면세 ₩ — | 과세 ₩ — | 합계 ₩ —  [발주 요청]
-
＋ 택배 추가 / ＋ 용차 추가전체 삭제
-
품목 검색: [품목명/코드] 전체/면세/과세[조회]
-
품목 카드 그리드 (이미지 · 단가 · 재고)＋ 담기
+ +
+
+ 🛒 장바구니 담은 개수 3 + 면세 9,000원 · 과세 16,545원 · 총 27,200원   주문하기 ▼ +
+
+

▲ 장바구니를 누르면 펼쳐지면서 [택배비 추가] [용차비 추가] 버튼이 보여요

+ +
🔍 물건 이름이나 코드로 검색전체 / 면세 / 과세 ▾   검색
+ +
+
+ 📦
+ 꽃계탕 면세
+ 4,500원
+ 창고에 212개 있음
+ ＋ 담기 +
+
+ 📦
+ 빨강 탈취제
+ 9,200원
+ 창고에 100개 있음
+ ＋ 담기 +
+
+ 📦
+ 김치찌개 택배만
+ 12,000원
+ 창고에 50개 있음
+ ＋ 담기 +
+
-

사용 단계

+

물건 카드에 붙은 표시들

+ + + + + + + + +
표시뜻가게가 알아둘 점
면세세금이 붙지 않는 물건그냥 참고만 — 시스템이 알아서 세금 계산
택배만택배로만 보내는 물건이걸 담으면 택배비 줄이 자동으로 추가돼요. 빼면 주문이 안 돼요.
"한 번에 30개까지만"한 번에 담을 수 있는 최대 개수이 개수까지만 담겨요. 더 담고 싶으면 모모 직원에게 권한 신청.
"창고에 0개"가 빨간색품절[＋ 담기] 버튼이 눌리지 않아요
+ +

주문하는 순서

    -
  1. 품목 검색품목명/코드 입력 후 [조회]. 면세/과세 필터 가능.
    2. -
  2. ＋ 담기 버튼품목 카드의 [＋ 담기] 클릭 → 카트에 1개 추가. 같은 품목 다시 누르면 수량 +1.
    3. -
  3. 수량 조정카트의 [−] / [＋] 또는 숫자 직접 입력. 재고/한도(max_order_qty) 자동 클램프.
    4. -
  4. 택배/용차 추가택배 전용 품목을 담으면 자동으로 택배 라인 1줄 추가. 수동 추가는 카트의 [＋ 택배 추가] / [＋ 용차 추가].
    5. -
  5. 택배/용차 단가 · 수량기본 단가는 택배 4,000원 / 용차 5,000원. 직접 수정 가능. 같은 종류 버튼 다시 누르면 수량 +1.
    6. -
  6. [발주 요청] 클릭합계 + 품목수 확인 모달 → [발주]. 성공 시 발주번호(ORD-YYYYMMDD-NNNN) 부여.
    7. +
  7. 물건 검색물건 이름이나 코드를 적고 [검색] 또는 엔터 키. 위쪽의 '면세/과세' 칸에서 종류를 골라 더 좁힐 수도 있어요.
    8. +
  8. ＋ 담기 버튼 누르기장바구니에 1개 들어가요. 같은 물건을 다시 누르면 개수가 1 늘어나요. 창고에 있는 양보다 많이 담으려고 하면 못 담는다고 알려줘요.
    9. +
  9. 장바구니 펼쳐서 개수 조절위쪽 초록색 장바구니 바를 누르면 펼쳐져요. − + 버튼이나 숫자 직접 입력으로 개수를 바꿀 수 있어요.
    10. +
  10. 택배비 / 용차비 추가하기 (필요할 때만)'택배만'으로 표시된 물건을 담으면 택배비 줄이 자동으로 1줄 추가돼요. 직접 추가하려면 [＋ 택배 추가] 또는 [＋ 용차 추가] 버튼. 같은 버튼을 다시 누르면 새 줄이 생기지 않고 그 줄의 개수가 1 늘어나요.
    11. +
  11. 택배비/용차비 가격·개수 수정기본 가격 — 택배 4,000원 / 용차 5,000원. 담당자 이름·가격·개수 다 수기로 고칠 수 있어요. 개수 × 가격 = 합계가 자동 계산돼요.
    12. +
  12. [주문하기] 버튼 누르기총 얼마, 몇 개라고 다시 한 번 물어봐요. [주문] 누르면 끝. 주문 번호가 나와요(예: ORD-20260507-0001). 끝나면 '내 주문 내역' 화면으로 자동으로 이동해요.
-

품목 카드 배지

- - - - - -
배지의미
면세부가세 면제 품목
택배택배 전용 — 카트에 담으면 택배 라인 자동 추가
"1회 한도 ≤ N"1회 발주 최대 수량 제한 (관리자 권한 부여 시 무시)
+
+ ⚠️ "택배 전용 품목이 들어있어 택배줄이 필요해요" 라고 뜨면 +

장바구니에 택배만 표시 물건이 있어요. 이런 물건은 반드시 택배비 줄이 1개 이상 있어야 주문이 돼요. 자동으로 들어가야 정상이지만 안 보이면 [＋ 택배 추가] 버튼을 눌러서 줄을 만들어 주세요.

+
-

3.2 내 발주 이력 (URL: /m/orders)

-
    -
  • 전체 발주 이력을 상태별로 조회
    • -
  • 출고완료(APPROVED)/입금완료(PAID)/계산서발행(INVOICED) 건은 거래명세표 엑셀 다운로드 가능
    • -
  • [엑셀] 버튼으로 전체 이력을 .xlsx 로 내려받기
    • -
- - - - - - - -
상태의미
출고요청거래처가 발주 요청, 담당자 처리 대기
출고완료담당자 승인 후 재고 차감 + 거래명세표 메일 발송됨
입금완료대금 입금 등록 완료
계산서발행전자세금계산서 발행 완료
취소담당자 반려 또는 본인 취소
+
+

📘 따라하기 예시 — "꽃계탕 2개 + 탈취제 2개 주문하기"

+
    +
  1. 로그인 → 주문 화면이 자동으로 열려요
    2. +
  2. "꽃계탕"을 검색창에 치고 [검색] → [＋ 담기] 버튼을 두 번 클릭 (개수 2)
    3. +
  3. "탈취제"를 검색 → [＋ 담기] 두 번 클릭 (개수 2)
    4. +
  4. 위쪽 장바구니 바 클릭 → 펼쳐서 개수 확인
    5. +
  5. 총 27,200원 확인 → [주문하기] → [주문]
    6. +
  6. "주문 완료 — 주문번호 ORD-20260507-0001" 알림 → 확인
    7. +
+
-

3.3 회원정보 수정 (URL: /profile)

-

헤더 우측의 자기 이름을 클릭하면 진입.

+ +

가-2. 내가 주문한 내역 보기

+

왼쪽 메뉴의 거래처 주문 → 내 주문 내역 을 누르면 보여요.

+

주문 상태별 뜻

+ + + + + + + + + +
상태무슨 뜻인가요?가게가 할 일
출고요청주문이 들어갔고, 모모 직원이 처리하기를 기다리는 중혹시 취소하고 싶으면 모모유통에 전화·문자로 연락
출고완료모모 직원이 확인해서 보냈어요. 창고 재고는 줄었어요. 거래명세표가 메일로 와 있어요.거래명세표 받아서 확인 + 입금 진행
입금완료입금이 들어왔다고 모모 직원이 등록했어요세금계산서를 기다리세요
계산서발행전자세금계산서가 발행됐어요홈택스에서 사업자번호로 조회 가능
취소주문이 취소됐어요—
+

오른쪽 위 [엑셀] 버튼을 누르면 전체 주문 내역을 엑셀 파일로 받을 수 있어요.

+ + +

가-3. 내 정보·비밀번호 바꾸기

+

화면 오른쪽 위에 있는 내 이름을 누르면 들어가져요.

    -
  • 기본 정보 업체명·대표자·연락처·이메일·주소·사업자번호 수정
    • -
  • 비밀번호 변경 현재 비번 확인 후 새 비번 (4자 이상) 입력
    • +
  • 기본 정보 수정 — 가게 이름, 대표자, 전화번호, 이메일, 주소, 사업자번호를 고치고 [저장] 누르세요.
    • +
  • 비밀번호 변경 — 지금 쓰는 비밀번호를 한 번 입력 → 새 비밀번호(4자 이상)를 두 번 입력 → [비밀번호 변경].
- -
-

4. 관리자(ADMIN) 가이드

+ + + +
+

출고담당 나. 출고 담당자 사용법

+

출고 담당자는 가게가 넣은 주문을 보고 창고에서 물건을 꺼내 보내는 사람이에요. 출고 처리를 하면 창고 재고가 자동으로 줄어요(−). 입금 확인과 세금계산서 끊는 일도 같이 해요.

-

4.1 발주서 관리 · 출고처리 · 거래명세표 (URL: /m/admin/orders)

-

좌측 발주 리스트에서 선택하면 우측에 거래명세표 미리보기가 표시됩니다. 체크박스 다중 선택 후 [출고]를 누르면 일괄 처리됩니다.

+ +

나-1. 주문서 보고 물건 내보내기

+

왼쪽 메뉴 출고/정산 → 출고 관리로 들어가요.

-

화면 구성 (2분할)

-
-
/m/admin/orders — 좌:발주 리스트 | 우:거래명세표 미리보기
-
-
좌측상태 필터 · 체크박스 · ORDER-YYYYMMDD-NNNN · 일자 · 업체 · 합계 · 상태
-
우측거래명세표 [엑셀 다운로드] · ＋ 택배/용차 추가 · 라인 인라인 편집 · 합계
+

화면 모습 (왼쪽: 주문 목록 / 오른쪽: 거래명세표)

+
+
momotogether.com (출고 관리)
+
주문서 관리 · 출고처리전체상태 ▾   조회   🚚 출고하기
+
+
+
주문 목록 (총 18건 / 출고 가능 6건)
+ + + + + + + +
☐주문번호날짜상태
☑ORD-20260507-00025/7요청
☐ORD-20260507-00015/7요청
—ORD-20260506-00035/6완료
+
+
+
거래명세표 미리보기   ⬇ 엑셀 다운로드
+
거 래 명 세 표
+
주문번호 · ORD-20260507-0002  ｜  주문일자 · 2026-05-07  ｜  현재상태 · 출고요청
+
홍길동상회 귀하
대표:홍길동 · ☎ 010-1234-5678
+
+ ＋ 택배 추가 +   + ＋ 용차 추가 +
+ + + + + + + + +
#물건명구분창고개수가격합계
1택배 택배비과세-[1][4000]4,000✓ ✕
2용차 용차과세-[2][5000]10,000✓ ✕
3꽃계탕면세21224,5009,000
4빨강 탈취제과세10029,20018,400
+
총 합계 (세금 포함) 41,400원
+
-

출고 처리 단계

+

출고하는 순서

    -
  1. 발주 선택좌측 리스트에서 출고요청 상태 발주를 체크박스로 선택 (전체선택 헤더 체크박스 가능)
    2. -
  2. [출고] 버튼상단 녹색 [출고] 클릭 → 확인 모달 → 일괄 승인
    3. -
  3. 자동 처리① 재고 차감 ② 거래명세표 .xlsx 자동 생성 ③ 거래처 이메일로 거래명세표 본문 + 첨부파일 발송 ④ 상태 → APPROVED
    4. -
  4. 결과 알림성공/실패 건수 + 메일 발송 실패 건수가 모달로 표시
    5. +
  5. 주문 고르기왼쪽 목록에서 출고요청 상태인 주문을 체크박스로 선택해요. 여러 개 한꺼번에 선택 가능. 다른 상태(이미 출고된 것)는 체크가 안 돼요.
    6. +
  6. 오른쪽에서 거래명세표 확인왼쪽에서 한 줄을 누르면 오른쪽에 자세한 내용이 떠요. 창고 재고가 부족한 줄은 빨간색으로 보이고 위쪽에 경고 박스가 떠요. 재고 부족 상태로는 출고가 안 돼요.
    7. +
  7. (필요할 때만) 택배비/용차비 추가가게가 빠뜨렸거나 가격을 조정해야 할 때 [+ 택배 추가] [+ 용차 추가] 버튼으로 줄을 만들고, 담당자 이름/가격/개수를 직접 적어요. ✓ 누르면 저장, ✕ 누르면 삭제.
    8. +
  8. 위쪽 [🚚 출고하기] 버튼 누르기"N건 출고하시겠습니까?" 알림 → [출고]. 누르는 즉시:
    ① 창고 재고 자동으로 줄어듦(−)
    ② 거래명세표 엑셀 파일이 자동으로 만들어짐
    ③ 가게 메일로 거래명세표가 자동 발송됨
    ④ 상태가 출고완료로 바뀜
    9. +
  9. 결과 확인"출고 처리 완료 (성공 N건 / 실패 M건)" 알림이 떠요. 메일 발송에 실패한 건수도 같이 알려줘요.
-

거래명세표 인라인 편집 (REQUESTED 상태에서만)

+

택배비/용차비 줄 직접 고치기 ('출고요청' 상태일 때만)

    -
  • [＋ 택배 추가] / [＋ 용차 추가] — 같은 종류가 이미 있으면 수량 +1, 없으면 신규 1줄 (단가 4,000/5,000 기본)
    • -
  • 택배/용차 행은 인라인 입력칸 — 담당자명·단가·수량 즉시 수정, ✓ 클릭 → 저장 / × 클릭 → 삭제
    • -
  • 품목(ITEM) 라인은 보호되어 이 화면에서 수정 불가
    • -
  • 택배/용차 라인이 품목보다 위쪽에 표시 (관행)
    • -
  • 변경 시 발주 합계(total_supply/vat/amount/delivery/charter)는 백엔드에서 자동 재집계
    • +
  • + 택배 추가 또는 + 용차 추가 누르기 — 이미 그 종류의 줄이 있으면 그 줄의 개수가 +1 늘어나고, 없으면 새 줄이 생겨요.
    • +
  • 줄에서 담당자 이름·가격·개수를 그 자리에서 바로 고칠 수 있어요. ✓로 저장, ✕로 삭제.
    • +
  • 일반 물건 줄은 여기서 고칠 수 없어요. (물건 자체를 바꾸려면 가게가 다시 주문해야 함)
    • +
  • 택배비/용차비 줄은 항상 물건 줄 위쪽에 보여요.
-

출고/입금 완료 후

-

거래명세표 하단에 [세금계산서 발행 (과세)] / [계산서(면세)] 버튼이 노출. 클릭 시 /api/m/einvoices/issue 호출 → 발행 결과 모달 (승인번호/처리방식).

+
+ 💡 택배 전용 물건의 자동 처리 +

물품 등록할 때 "택배전용"으로 설정한 물건이 가게의 주문에 들어 있으면, 시스템이 알아서 택배비 줄을 1줄 추가해요. 출고 담당자는 가격/개수만 검토하면 돼요.

+
-
현재 stub 모드 — 발행은 DB 기록만 수행, 국세청에 실제 전송 X. 사업자 공동인증서 + 홈택스 ERP 연계 승인 후 NTS_ESERO_MODE=test|prod 환경변수 전환 시 활성화.
+

주문 거절하기

+

거래명세표 아래의 [✕ 반려] 버튼을 누르면 주문이 취소돼요. (재고는 영향 없음) 가게에 따로 전화/메시지로 이유를 알려 주세요.

-

4.2 입금 관리 (URL: /m/admin/payments)

-
    -
  • 출고 완료된 발주의 입금 등록
    • -
  • 입금일 / 입금액 입력 → 상태 PAID 로 전환, paid_amount/paid_date 갱신
    • -
+

출고 끝난 뒤 — 세금계산서 끊기

+

출고완료/입금완료 상태인 주문의 거래명세표 아래쪽에 세금계산서 발행 계산서(면세) 두 버튼이 떠요. 누르면 [나-3 세금계산서 끊기] 화면과 같은 흐름으로 처리돼요.

-

4.3 계산서 발행 (URL: /m/admin/invoices)

-
    -
  • 월말 일괄 거래명세서/계산서 발행 (자체 PDF/엑셀)
    • -
  • 국세청 전송 X — 사업자가 홈택스에서 직접 신고하는 형태
    • -
- -

4.4 전자세금계산서 (URL: /m/admin/einvoices)

-

출고/입금 완료된 발주에 대해 별도로 전자(세금)계산서를 발행하고 이력을 관리하는 전용 메뉴.

-

화면 구성

+ +

나-2. 입금 들어왔는지 확인하기

+

왼쪽 메뉴 출고/정산 → 입금 관리.

    -
  1. 발행 가능 발주 리스트출고완료/입금완료 상태 발주가 표시됨. 한 줄당 [세금계산서] 버튼.
    2. -
  2. 발행 클릭확인 모달 → /api/m/einvoices/issue 호출 → 결과 모달 (승인번호/처리방식)
    3. -
  3. 발행 이력날짜 범위·상태·거래처별 필터, [엑셀] 다운로드
    4. +
  4. 출고완료 주문 고르기입금 대기 상태(출고완료)인 주문 목록이 떠요
    5. +
  5. 입금일·입금액 입력하고 [등록]전액 입금이면 상태가 입금완료로, 일부만 들어왔으면 미수금이 표시돼요
-

발행 어댑터 (env: EINVOICE_PROVIDER)

- - - - - -
값동작비용
manual (기본)자체 거래명세서, DB 기록만0원
nts국세청 e-세로 직접 연동 (XMLDSig + SOAP)인증서 연 4~5만원
popbill(향후) Popbill REST API건당 100~150원
-

상태 머신

-

DRAFT → QUEUED → SENT → ACK | FAIL | CANCELED

-

4.5 마스터 관리

+ +

나-3. 세금계산서 끊기

+

왼쪽 메뉴 출고/정산 → 전자세금계산서. 출고/입금이 끝난 주문에 대해 세금계산서를 한꺼번에 발행할 수 있어요. 부가세 신고 시점에 일괄 처리해도 되고, 그때그때 처리해도 돼요.

-

① 품목 관리 (/m/admin/items)

-
    -
  • 등록 / 수정 / 이미지 업로드 / 삭제(soft)
    • -
  • 주요 필드: -
      -
    • 면세/과세 — 라디오. 면세 품목은 부가세 0.
      • -
    • 발주 제한수량 (max_order_qty) — 1회 발주 최대 수량. 공란/0 = 제한 없음.
      • -
    • 숨김 처리 (is_hidden) — '숨김' 선택 시 일반 회원에게는 카드가 안 보임. 권한자만 노출.
      • -
    • 택배 전용 (requires_delivery) — '택배전용' 선택 시 카트에 담기면 택배 라인 자동 추가, 발주 시 택배 없으면 차단.
      • -
    • 제조관리 — 소비기한·원산지·입고가·보관온도·바코드·메모 (JSONB attributes).
      • -
    -
    • -
+

화면 모습

+
+
momotogether.com (전자세금계산서)
+
+
발행 가능한 주문새로고침 ⬇ 엑셀
+ + + + + +
주문번호일자거래처합계상태발행
ORD-20260506-00035/6홍길동상회37,200출고완료▶ 세금계산서
+
지금까지 발행한 내역   기간 [날짜][날짜] · 상태 ▾ 조회
+ + + + + +
발행일거래처구분합계승인번호상태
5월 6일홍길동상회세금37,20020260506-...완료
+
+
-

② 거래처 회원 관리 (/m/admin/customers)

-
    -
  • 거래처(user_type='C') 회원 목록 + 정보/권한 수정
    • -
  • 특수 권한 토글 두 가지: -
      -
    • 제한수량 해지 (unlimited_qty='Y') — 모든 품목의 1회 발주 한도를 무시하고 재고만큼 발주 가능
      • -
    • 숨김처리 보기 (view_hidden='Y') — 숨김 품목도 발주 화면에 노출
      • -
    -
    • -
  • 관리자 패널(/admin-panel)의 사용자 폼에서도 같은 권한 수정 가능
    • -
+

발행하는 순서

+
    +
  1. 발행 가능한 주문 확인출고완료/입금완료 상태인 주문이 자동으로 떠요. [새로고침] 누르면 갱신.
    2. +
  2. [▶ 세금계산서] 버튼 누르기"발행하시겠습니까?" 알림 → [발행]. 시스템이 자동으로 처리해서 결과를 알려줘요. (승인번호, 처리방식)
    3. +
  3. 결과 확인아래 [지금까지 발행한 내역] 표에서 상태 완료 인지 보면 돼요. 승인번호는 24자리 숫자.
    4. +
  4. 엑셀로 받기월말에 [⬇ 엑셀] 누르면 발행 내역을 엑셀로 다운로드 받을 수 있어요. 회계장부나 부가세 신고할 때 사용.
    5. +
-

③ 매입처 / ④ 창고 / ⑤ 제조사

- - - - - -
메뉴경로역할
매입처 관리/m/admin/vendors매입 발주처 등록 (도매처)
창고 관리/m/admin/warehouses적재 창고 + 픽업/입출고 분류
제조사 관리/m/admin/makers품목 제조사 마스터
+
+ ⚠️ 지금은 시범 모드예요 (실제로 국세청에 보내지 않아요) +

현재는 발행 버튼을 눌러도 모모 시스템 안에만 기록되고 진짜 국세청에 전송되지는 않아요. 실제로 보내려면 다음 준비가 필요해요:

+
    +
  1. 사업자용 공동인증서 발급 (한국정보인증, 사인코리아 등에서. 1년에 4~5만원)
    2. +
  2. 홈택스 홈페이지에서 "전자세금계산서 ERP 연계 신청"
    3. +
  3. 승인되면 시스템에 인증서 연결 후 시범 환경에서 100건 정도 검증
    4. +
  4. 검증 끝나면 운영 모드로 전환 → 진짜 국세청 발송 시작
    5. +
+

이 작업은 시스템 개발자에게 부탁하시면 됩니다.

+
-

4.6 매입/입고

- - - - - -
메뉴경로역할
매입 발주/m/admin/procurements매입처에 보낼 발주서 작성
입고 처리/m/admin/inbounds발주한 품목 입고 등록 → 재고 증가
재고 관리/m/admin/inventory현재 재고 + 입출고 이력
- -

4.7 통계 · 대시보드

- - - - - - -
메뉴경로설명
대시보드/m/dashboard전체 요약
월간 매출/m/admin/statistics업체별 면세/과세/총 매출 (TOP15 막대그래프) + 엑셀
일자별 매출/m/admin/statistics/daily일별 매출 추이 (스택 막대 + 건수 라인) + 엑셀
원가/마진/m/admin/statistics/margin품목별 매출/원가/마진 TOP10 + 마진율 + 엑셀
-

모든 통계 화면 우상단의 [엑셀 다운로드] 버튼으로 .xlsx 파일을 받을 수 있습니다.

+

거래명세표 화면에서도 발행 가능

+

[나-1 출고 관리] 화면에서 출고/입금이 끝난 주문의 거래명세표 아래에 세금계산서 발행 버튼이 떠 있어요. 거기서 눌러도 똑같이 발행돼요.

- + + + +
+

입고담당 물품등록 다. 입고 담당자·물품 등록 담당자 사용법

+

입고 담당자는 도매처에서 물건을 사 와서 창고에 쌓는 사람이에요. 입고 등록을 하면 창고 재고가 자동으로 늘어요(+). 물품 등록 담당자는 팔 물건, 가게 회원, 도매처 등 기본 정보를 등록·관리해요.

+ + +

다-1. 물건 매입하기 (도매처에 주문)

+

왼쪽 메뉴 매입/입고 → 매입 발주.

+
    +
  1. [+ 매입 발주] 버튼도매처를 고르고, 살 물건과 개수, 가격, 입고 예정일을 적어요
    2. +
  2. 저장도매처에 주문서가 만들어지고 상태는 발주
    3. +
  3. 도매처에서 물건이 도착하면다음 단계인 '입고 처리'로 이동
    4. +
+ + +

다-2. 물건 들어오면 등록하기 (창고에 쌓임)

+

물건이 창고에 도착하면 이 화면에서 등록해요. 등록하면 창고 재고가 늘어나요(+).

+
    +
  1. 입고할 매입 발주 고르기아직 입고 안 된 발주서 목록이 떠요
    2. +
  2. 입고 개수 / 창고 / 입고일 적기주문할 때 적은 개수랑 실제 들어온 개수가 다를 수 있어요. 부분 입고도 가능해요.
    3. +
  3. [입고 등록] 누르기해당 창고의 재고가 N개만큼 늘어나요. 누가 언제 무엇을 입고했는지 기록도 남아요.
    4. +
+
+ 💡 입고 vs 출고 — 헷갈리지 마세요 +
    +
  • 입고: 도매처 → 모모 창고로 들어옴 → 재고 +
    • +
  • 출고: 모모 창고 → 가게(거래처)로 나감 → 재고 −
    • +
+
+ + +

다-3. 창고에 뭐가 얼마나 있는지 보기

+

왼쪽 메뉴 매입/입고 → 재고 관리.

+
    +
  • 창고별·물건별로 지금 몇 개 있는지 한눈에 봐요
    • +
  • 언제 들어오고 나갔는지 기록도 다 확인 가능
    • +
  • 창고 사이 이동이나 재고 조정도 등록할 수 있어요
    • +
+ + +

다-4. 팔 물건 등록·수정하기

+

왼쪽 메뉴 마스터 관리 → 품목 관리. 가게가 주문 화면에서 보는 물건 카드를 여기서 만들고 관리해요.

+ +

등록·수정할 때 적는 칸들

+
+
물건 이름 *가게 주문 화면에 표시될 이름
+
제조사[제조사 관리]에 미리 등록한 회사 중에서 고르기
+
단위개(EA), 박스(BOX), 킬로그램(KG), 리터(L), 팩(PACK) 중 선택
+
구분 (면세/과세)면세 = 세금 없음 / 과세 = 세금 있음. 라디오로 골라요
+
판매가 (세금 포함)가게에게 보여주는 가격. 세금이 포함된 금액
+
원가우리가 도매처에서 산 가격. 마진(이익) 계산에 사용
+
한 번에 주문 가능 수량한 번 주문에 몇 개까지 살 수 있는지. 비워두면 제한 없음. 가게에 권한을 풀어주면 무시됨
+
숨김 처리"숨김" 고르면 일반 가게에게는 안 보여요. 권한 받은 가게에게만 보임
+
택배 전용⭐ "택배전용" 고르면 가게가 이 물건을 장바구니에 담을 때 택배비 줄이 자동으로 추가돼요
+
제조관리 정보유통기한·원산지·들어올 때 가격·보관온도·바코드·메모. 입고할 때 참고용
+
+ +

물건 목록에서 한눈에 알아보는 표시

+ + + + + + + +
사용 / 중지판매 중 / 판매 안 함
숨김일반 가게 화면에는 안 보임 (권한자만 보임)
≤30한 번에 30개까지만 주문 가능
택배택배 전용 — 장바구니에 담으면 택배비 줄이 자동 생김
+ +
+

📘 따라하기 예시 — "신상품 김치찌개 등록 (택배 전용, 면세)"

+
    +
  1. 마스터 관리 → 품목 관리 → [+ 새로 등록]
    2. +
  2. 물건 이름: 김치찌개, 제조사 선택, 단위 개
    3. +
  3. 구분: 면세, 판매가 12,000원, 원가 8,000원
    4. +
  4. 한 번에 주문 가능 수량: 30 (한 번에 30개까지만)
    5. +
  5. 숨김 처리: 공개
    6. +
  6. 택배 전용: 택배전용 선택 → 가게가 담으면 자동으로 택배비 줄 추가됨
    7. +
  7. 이미지 올리기 → [저장]
    8. +
  8. 물건 목록 그리드에 사용면세≤30택배 배지가 뜸
    9. +
+
+ + +

다-5. 거래처(가게) 정보·권한 관리

+

왼쪽 메뉴 마스터 관리 → 거래처 회원 관리. 가입한 가게들의 정보와 특수 권한을 관리해요.

+ +

특수 권한 두 가지

+ + + + + + +
권한 이름켜면 어떻게 되나요?언제 켜주나요?
제한수량 해지모든 물건의 "한 번에 N개까지" 제한이 사라져요. 창고에 있는 만큼 다 살 수 있어요.오래 거래한 단골 가게, 한 번에 많이 사가는 가게
숨김처리 보기"숨김"으로 등록된 물건도 주문 화면에 보여요특정 카테고리 전문 가게, 신상품을 먼저 보여줄 가게
+
    +
  1. 가게 검색아이디, 가게 이름, 이메일로 찾기
    2. +
  2. [✏ 수정] 누르기해당 가게의 수정 화면이 열려요
    3. +
  3. 특수 권한 체크박스 켜고 저장다음 로그인부터 바로 적용돼요
    4. +
+ + +

다-6. 도매처·창고·제조사 등록

+

왼쪽 메뉴 마스터 관리 안에 있어요.

+ + + + + + + +
메뉴 이름여기에 등록하는 것
매입처 관리도매처(우리가 물건을 사 오는 곳) — 회사 이름, 연락처, 사업자번호
창고 관리창고 — 본사 창고, 김포 지사 창고, 픽업 장소 등 분류
제조사 관리물건을 만든 회사. 물건 등록할 때 여기서 골라요.
+
+ + + + +
+

통계 라. 매출·이익 분석하기

+ + + + + + + + + +
메뉴여기서 볼 수 있는 것
대시보드오늘·이번 달 매출, 진행 중인 주문 등 한눈에 요약
월간 매출 (가게별)년/월을 고르면 가게별 면세·과세·총 매출이 표 + 막대그래프(상위 15개)로 보여요
일자별 매출기간을 고르면 날짜별 매출 추이가 막대그래프 + 주문 건수 라인으로 보여요
원가/마진월별로 어떤 물건이 얼마나 팔렸고, 원가 빼면 이익이 얼마인지 (상위 10개 그래프)
+

모든 통계 화면 오른쪽 위에 ⬇ 엑셀 버튼이 있어서 엑셀 파일로 받을 수 있어요.

+
+ + + +
-

5. 전체 업무 흐름도

- 
-[거래처 USER]                       [관리자 ADMIN]
-  │                                    │
-  ① 출고 요청 작성  ─────────────►  발주서 관리 (/m/admin/orders)
-  (품목+택배/용차)                       │ 체크 + [출고] 버튼
-                                         ▼
-                                   ② 재고 차감
-                                   ③ 거래명세표 메일 발송  (status = APPROVED)
-                                         │
-  ④ 입금 ──────────────────────►  입금 관리 (/m/admin/payments)
-                                         │ 입금 등록
-                                         ▼  (status = PAID)
-                                         │
-  ⑤ 거래명세표 / 세금계산서  ◄──── 전자세금계산서 (/m/admin/einvoices)
-                                         │ [세금계산서 발행] 클릭
-                                         ▼  (status = INVOICED)
-                                   ⑥ 통계 / 매출 / 원가 마진 분석
-                                       (/m/admin/statistics/*)
+  
5. 전체 일이 어떻게 흘러가나요?

+  
+   [입고 담당자]                  [거래처(가게)]                [출고 담당자]
+       │                              │                              │
+   ① 도매처에 물건 주문                   │                              │
+       │                              │                              │
+   ② 물건 들어오면 입고 등록                │                              │
+       │ → 창고 재고 +                  │                              │
+       │                              │                              │
+       └────► 창고에 재고 쌓임 ────────► │                              │
+                                      │                              │
+                                ③ 가게가 주문                            │
+                                  (물건 + 자동 택배)                       │
+                                      │                              │
+                                      └─────► ④ 출고 담당이 주문 확인 ──┘
+                                                  │
+                                                  ▼
+                                            ⑤ 창고 재고 −
+                                            ⑥ 거래명세표 메일 발송 (가게에게)
+                                            ⑦ 상태 = 출고완료
+                                                  │
+                          ⑧ 가게가 입금 ─────────► ⑨ 입금 등록
+                                                  │ 상태 = 입금완료
+                                                  ▼
+                                            ⑩ 세금계산서 발행
+                                                  │ 상태 = 계산서발행
+                                                  ▼
+                                            ⑪ 매출·이익 분석 (월말)
- + + +
-

6. 자주 묻는 질문 / 문제 해결

+

6. 자주 묻는 질문

-

Q. 발주 요청 시 "택배 전용 품목이 포함되어 택배 라인이 필요합니다" 메시지

-

A. 카트에 택배 배지 품목이 들어 있으면 반드시 택배 라인이 1줄 이상 있어야 합니다. 자동 추가되어야 정상이지만 안 되면 [＋ 택배 추가] 수동 클릭.

+

Q1. 거래처 주문하려는데 "택배 전용 품목이 들어있어 택배줄이 필요해요"라고 떠요

+

장바구니에 택배만 표시 물건이 있어요. 이런 물건은 반드시 택배비 줄이 1줄 이상 있어야 주문이 돼요. 자동으로 들어가야 정상이지만, 안 보이면 [＋ 택배 추가] 버튼을 눌러서 줄을 만들어 주세요.

-

Q. 1회 발주 한도가 너무 작아서 더 못 담아요

-

A. 품목별 max_order_qty 제한입니다. 관리자가 [거래처 회원 관리]에서 해당 회원에게 제한수량 해지 권한을 부여하면 무시됩니다.

+

Q2. 거래처 한 번에 더 많이 담고 싶어요

+

물건마다 "한 번에 N개까지"라는 제한이 있어요. 모모 직원에게 연락해서 "제한수량 해지" 권한을 부탁하면 풀려요. 권한이 풀리면 창고에 있는 만큼 다 살 수 있어요.

-

Q. 숨김 품목을 보고 싶어요

-

A. 일반 회원에게는 노출되지 않습니다. 관리자가 [거래처 회원 관리]에서 숨김처리 보기 권한을 부여하면 카드가 보입니다.

+

Q3. 거래처 안 보이는 물건이 있는 것 같아요

+

일부 물건은 모모유통이 일반 가게에게는 보이지 않게 숨겨 둘 수 있어요. "숨김처리 보기" 권한을 받으면 그런 물건도 볼 수 있어요. 모모 직원에게 권한 신청하세요.

-

Q. 출고 처리 후 거래명세표 메일이 안 갔어요

-

A. 출고 모달의 결과창에 "메일 N건 실패" 표시가 있습니다. 거래처 이메일 주소를 [거래처 회원 관리]에서 확인하고 SMTP 환경변수를 점검합니다 (SMTP_HOST/PORT/USER/PASS/FROM).

+

Q4. 출고담당 출고 처리했는데 가게에 메일이 안 갔다고 해요

+

출고 결과 알림창에 "메일 N건 실패"라고 표시돼요. [거래처 회원 관리]에서 그 가게의 이메일 주소가 정확한지 확인해 주세요. 그래도 안 가면 시스템 개발자에게 연락 (메일 서버 점검 필요).

-

Q. 전자세금계산서 발행 시 "STUB-OK" 가 떠요

-

A. 현재 NTS_ESERO_MODE=stub 입니다. 국세청에 실제 전송하지 않고 DB 기록만 합니다. 운영 활성화 절차:

+

Q5. 출고담당 거래명세표에서 [+ 택배 추가] 눌렀는데 개수가 화면에 안 바뀌어요

+

화면을 새로고침(F5)하면 정상으로 보여요. (이 부분은 5월 7일 패치에서 자동 동기화로 수정됐어요)

+ +

Q6. 출고담당 세금계산서 발행했는데 결과에 "시범 모드"라고 떠요

+

지금은 진짜 국세청에 보내지 않고 시스템 내부에만 기록되는 상태예요. 진짜로 발송하려면 다음이 필요해요:

    -
  1. 사업자용 공동인증서 발급 (한국정보인증/SignKorea, 연 4~5만원)
    2. -
  2. 홈택스 → 전자세금계산서 ERP 연계 신청 → 테스트 ID/PW 승인
    3. -
  3. .env.production 에 NTS_ESERO_MODE=test, NTS_ESERO_USER_ID/PW, NTS_ESERO_CERT_PATH/PW 설정
    4. -
  4. 테스트 환경에서 100건 모범 발행 검증 → NTS_ESERO_MODE=prod 전환
    5. +
  5. 사업자용 공동인증서 (한국정보인증, 사인코리아 등에서 발급, 1년에 4~5만원)
    6. +
  6. 홈택스 → 전자세금계산서 ERP 연계 신청 (1~3일 승인)
    7. +
  7. 인증서 등록 + 시스템 운영 모드로 전환
+

이 작업은 시스템 개발자에게 부탁하시면 돼요.

-

Q. 비밀번호를 까먹었어요

-

A. 관리자가 [관리자 패널 → 사용자 관리]에서 신규 비밀번호로 초기화. 시스템 관리자(admin)도 같은 방법.

+

Q7. 입고담당 입고 처리했는데 재고가 안 늘어요

+

입고 등록할 때 창고 선택을 빠뜨리지 않았는지 확인해 보세요. [재고 관리] 화면에서 그 물건의 입출고 이력을 보면 등록된 건이 보일 거예요.

-

Q. 모바일에서 화면이 잘 안 맞아요

-

A. 발주 작성·통계·관리자 화면 모두 반응형으로 설계되어 있습니다 (375px ~). 헤더는 사용자명 + 로그아웃만 노출. 좌측 메뉴는 햄버거 토글로 접기/펴기.

+

Q8. 물품등록 거래처 가게가 비밀번호를 까먹었대요

+

왼쪽 메뉴의 [관리자 패널 → 사용자 관리]에서 그 가게를 찾아 임시 비밀번호로 초기화해 주세요. 그 가게에게 임시 비밀번호를 알려주고, 로그인 후 [내 정보] 화면에서 본인이 직접 바꾸도록 안내하세요.

-
-

- 문서 버전: v0.6 — 2026-05-07 · 모모유통 ERP +

Q9. 휴대폰에서 화면이 잘 안 맞아요

+

주문 화면, 통계 화면 등 거의 모든 화면이 휴대폰에서도 잘 보이도록 만들어졌어요. 만약 깨진다면 새로고침을 한 번 해보세요. 왼쪽 메뉴는 햄버거 버튼(≡)을 눌러서 펼치고 접을 수 있어요.

+ +

Q10. 거래명세표나 세금계산서를 인쇄하고 싶어요

+

거래명세표는 [엑셀] 버튼으로 다운받은 뒤 엑셀에서 인쇄하면 돼요. 세금계산서는 운영 모드 활성화 후에 홈택스에서 PDF로 출력할 수 있어요.

+ +
+

+ 이 설명서는 2026년 5월 7일에 만들어졌어요 · 모모유통 · momotogether.com

diff --git a/src/app/(main)/m/admin/orders/page.tsx b/src/app/(main)/m/admin/orders/page.tsx index 7477d79..8ecb04d 100644 --- a/src/app/(main)/m/admin/orders/page.tsx +++ b/src/app/(main)/m/admin/orders/page.tsx @@ -547,6 +547,14 @@ function ExtraRow({ line, displaySeq, onSave, onDelete }: { const [label, setLabel] = useState(line.EXTRA_LABEL || line.ITEM_NAME); const [unitPrice, setUnitPrice] = useState(Number(line.UNIT_PRICE) || 0); const [qty, setQty] = useState(Number(line.QTY) || 1); + + // 외부에서 line 이 갱신되면(예: + 택배 추가 → 서버 재조회) 인풋도 동기화. + // 같은 OBJID 라서 컴포넌트가 unmount 되지 않아 useState 초기값이 무시되는 문제 방지. + useEffect(() => { + setLabel(line.EXTRA_LABEL || line.ITEM_NAME); + setUnitPrice(Number(line.UNIT_PRICE) || 0); + setQty(Number(line.QTY) || 1); + }, [line.OBJID, line.EXTRA_LABEL, line.ITEM_NAME, line.UNIT_PRICE, line.QTY]); const total = Math.round(unitPrice * qty); const supply = Math.round(total / 1.1); const vat = total - supply;