커머스 모듈
커머스 모듈의 상세 매뉴얼입니다. 상품 · 주문 · 배송 · 클레임 · 쿠폰 · 적립금 · 구매 등급 · 기획전 · 리뷰 · 통계까지 쇼핑몰 운영 전체를 다룹니다. 결제는 짓미페이 모듈이 처리합니다(공식자료의 "짓미페이 모듈" 문서 참고).
시작하기
1. 스토어에서 커머스 모듈을 설치합니다. 짓미페이 모듈도 함께 설치·설정합니다.
2. 사이트 메뉴 편집에서 커머스 모듈을 메뉴로 추가합니다(예: shop).
3. 커머스 콘솔에 들어갑니다. 쇼핑몰 화면 우상단의 관리 버튼(관리 권한자에게만 보임)으로 진입하며, 운영은 전부 이 전용 콘솔에서 합니다.
콘솔 대시보드에는 개설 체크리스트가 있어 결제 설정 > 배송비 > 카테고리 > 상품 등록 순서로 안내합니다.
콘솔 메뉴 한눈에
| 메뉴 | 하는 일 |
|---|---|
| 대시보드 | 매출 요약 · 처리 대기 건 · 개설 체크리스트 |
| 주문 | 주문 목록 검색, 건별 상세(결제·배송·이력) 처리 |
| 상품 | 상품 목록 · 등록 · 편집 (옵션, 기획전 노출 포함) |
| 재고 | 목록에서 검색 후 행에서 바로 수량 조정 |
| 카테고리 | 다단계 카테고리 관리 |
| 뱃지 | 상품 카드에 붙일 표시 만들기 |
| 기획전 | 상품 묶음 전용 페이지 · 배너 · 메인 노출 |
| 문의 | 상품 문의(Q&A) 답변 |
| 클레임 | 취소 신청 · 반품 · 교환 처리 |
| 쿠폰 | 쿠폰 발행 · 발급 내역 |
| 적립금 | 지급 · 차감 이력, 수동 지급 |
| 등급 | 구매 등급 기준 · 혜택 관리 |
| 통계 | 기간별 · 상품별 · 지역별 매출 |
| 설정 | 아래 "설정 전체 항목" 참고 |
설정 전체 항목
기본
| 항목 | 설명 |
|---|---|
| 사용 | 쇼핑몰 전체 on/off |
| 운영 모드 | 독립몰 (오픈마켓은 2차 개발 예정) |
| 주문번호 접두어 | 주문번호 앞에 붙는 문자 |
| 비회원 주문 | 허용 / 회원만. 허용 시 비회원은 주문 비밀번호(4자 이상)로 주문을 조회합니다 |
| 결제 대기 유지 (분) | 미결제 주문을 유지할 시간 (10~1440분). 지나면 자동 정리됩니다 |
| 취소·반품 신청 기한 | 배송완료 후 며칠까지 클레임 신청을 받을지 (0~90일) |
| 상품 상세 구매 박스 | 기본(상단 고정형) / 우측 플로팅(스크롤 따라다님) |
배송
| 항목 | 설명 |
|---|---|
| 기본 배송비 | 주문당 기본 배송비 |
| 무료배송 기준 금액 | 이 금액 이상 주문 시 배송비 무료 (0=사용 안 함) |
| 지역 추가 배송비 | 도서·산간·해외 추가금. 국가(ISO 2자리, 비우면 KR) · 시·도 이름 · 우편번호 패턴으로 구간을 등록합니다. 아래 "지역 추가 배송비" 참고 |
| 스윗트래커 API 키 | 배송 조회 연동용. 아래 "배송 조회" 참고 |
쇼핑몰 화면
| 항목 | 설명 |
|---|---|
| 메인 구성 | 상품 목록 / 쇼핑 홈(배너 + 섹션). 쇼핑 홈이면 아래 항목들이 적용됩니다 |
| 홈 배너 | 슬라이더 배너 여러 장 등록 (이미지 또는 배경색, 제목·문구는 <br> 줄바꿈 지원, 글자색·그림자 옵션) |
| 홈 섹션 표시 | 추천 상품 / 신상품 / 인기 상품 / 할인 상품 각각 on/off |
| 섹션 상품 수 | 홈 섹션당 표시 개수 (4~24) |
| 카테고리 배치 | 상단 셀렉트 / 좌측 사이드바 |
적립금·리뷰
| 항목 | 설명 |
|---|---|
| 적립률 (%) | 결제 완료 시 실결제 상품 금액 기준 자동 적립 (0=미사용, 0.01% 단위). 구매 등급에 등급별 적립률이 있으면 그 값이 우선합니다 |
| 적립금 최소 사용 금액 | 이 금액 이상부터 사용 가능. 주문서에 조건이 표시되고 1원 단위로 사용합니다 |
| 텍스트 리뷰 적립금 | 글만 쓴 리뷰 보상 |
| 사진·영상 리뷰 적립금 | 미디어 첨부 리뷰 보상 |
판매자 정보
주문서(거래명세서) 인쇄물 상단에 찍히는 정보입니다. 상호 · 대표자 · 사업자등록번호 · 대표 전화 · 사업장 주소 · 하단 안내 문구를 입력합니다. 비워 둔 항목은 인쇄물에 나오지 않습니다.
세금
| 항목 | 설명 |
|---|---|
| 사업자 구분 | 과세사업자(기본) / 면세사업자 / 간이과세자. 뒤 둘은 세액을 계산하지 않고 표기도 감춥니다 |
| 부가세율 (%) | 기본 10 |
| 상품 가격 기준 | 부가세 포함가(기본, 역산) / 부가세 별도(표시가에 가산) |
| 해외 배송 | 국내만(기본) / 해외 배송 받음. 켜면 주문서에서 배송 국가를 고를 수 있습니다 |
- 상품마다 과세 / 면세를 상품 편집에서 정합니다. 면세 상품은 주문서 품목표에 면세로 표시됩니다.
- 배송 국가가 대한민국이 아니면 수출로 보아 영세율(세액 0)로 표기합니다.
- 주문 시점의 과세 구분이 함께 저장되므로, 나중에 상품 설정을 바꿔도 과거 주문서는 그대로 유지됩니다.
개인정보·알림
| 항목 | 설명 |
|---|---|
| 개인정보 수집 동의 문구 / 버전 | 주문서 동의 항목에 표시됩니다. 문구를 바꾸면 버전을 올리세요 |
| 주문 정보 보관 (일) | 기간 경과 주문의 개인정보 파기 기준 (0=무기한) |
| 관리자 알림 | 새 주문·클레임 발생 시 메일 발송 여부와 수신 주소 |
지역 추가 배송비
도서·산간이나 해외처럼 배송비를 더 받아야 하는 구간을 줄 단위로 등록합니다. 설정 > 배송의 지역 추가 배송비에서 관리합니다.
| 칸 | 뜻 |
|---|---|
| 이름 | 표시용 (예: 제주) |
| 국가 | ISO 2자리. 비우면 대한민국(KR) |
| 시·도 | 이름으로 나열. 제주도 · 제주특별자치도처럼 적어도 같은 지역으로 봅니다 |
| 우편번호 | 접두(63) 또는 범위(40200-40240)를 쉼표로 나열 |
| 추가금 | 원 |
판정 순서는 국가 → 시·도 → 우편번호입니다. 국가가 다르면 그 줄은 적용되지 않고, 시·도나 우편번호 중 하나라도 맞으면 추가금이 붙습니다. 국가만 적고 나머지를 비우면 그 나라 전체에 적용되므로 해외 배송비를 한 줄로 잡을 수 있습니다.
다국어
여러 언어로 운영하는 사이트라면 이름·문구를 언어별로 지정할 수 있습니다. 입력칸 옆의 지구본 버튼을 누르면 됩니다.
지원하는 곳: 카테고리 이름, 상품명, 한 줄 요약, 기획전 이름·소개문, 뱃지 문구, 쿠폰 이름, 등급명, 쇼핑 홈 배너 제목·문구.
| 탭 | 하는 일 |
|---|---|
| 등록된 문구 | 이미 만들어 둔 문구를 검색해 연결 |
| 새로 만들기 | 사이트에 켜둔 언어별로 입력해 저장하면 바로 연결 |
- 문구는 한 번 만들면 다른 곳에서도 골라 쓸 수 있습니다. 예를 들어 카테고리에서 만든 문구를 상품명에도 연결할 수 있습니다.
- 저장되는 곳은 코어의 다국어 코드라, 관리자 > 다국어 화면에서도 함께 보이고 수정할 수 있습니다.
- 연결하지 않으면 입력한 글자가 그대로 쓰입니다. 연결 해제를 누르면 다시 일반 글자로 돌아갑니다.
- 사이트에 켜둔 언어가 하나뿐이면 입력칸도 하나만 나옵니다. 관리자 > 기본 설정에서 언어를 더 켜면 함께 늘어납니다.
다통화 판매
KRW 외의 통화로 가격을 표시하고 주문·결제까지 그 통화로 처리할 수 있습니다. 짓미페이 0.2.0 이상이 필요합니다.
켜는 방법
1. 관리자 > 짓미페이 > 게이트웨이의 공용 환율에 사용할 통화(USD 등)의 환율을 등록합니다 (자동 갱신을 켜도 됩니다).
2. 커머스 설정의 판매 통화에 통화 코드를 쉼표로 구분해 입력합니다. 예: USD, JPY
3. 외화 가격 미등록 상품 정책을 고릅니다: 환율로 자동 환산해 판매 / 해당 통화로 판매 안 함.
동작 방식
| 항목 | 설명 |
|---|---|
| 상품 가격 | 상품 등록 화면에 통화별 정가·판매가 칸이 생깁니다. 비워두면 위 정책에 따라 환산 판매되거나 판매되지 않습니다 |
| 표시 통화 | 상품 목록·상세 상단에 통화 선택이 나타나고, 고른 통화로 가격이 표기됩니다 (1년간 기억) |
| 주문 | 주문 1건은 통화 1개로 확정됩니다. 주문서·주문 완료·내 주문·관리자 화면·거래명세서가 모두 그 통화로 표기됩니다 |
| 환율 박제 | 주문에는 결제 시점 환율이 저장되어, 이후 환율이 바뀌어도 주문·환불 금액이 달라지지 않습니다 |
| 결제수단 | 주문 통화를 지원하는 결제수단만 결제 화면에 나타납니다. 외화 주문은 PayPal 등으로 결제됩니다 |
| 쿠폰·적립금 | KRW 주문 전용입니다. 외화 주문에서는 사용할 수 없고 구매 적립도 되지 않습니다 |
| 배송비 | 기본 배송비와 지역 추가 배송비는 환율로 환산해 청구됩니다 |
| 매출 통계 | 원장은 KRW 기준을 유지합니다. 외화 주문은 결제 시점 환율로 환산해 집계됩니다 |
다통화를 쓰지 않는 사이트는 아무 것도 바뀌지 않습니다. 판매 통화를 비워두면 기존과 동일하게 동작합니다.
카테고리
- 다단계(하위의 하위)를 지원합니다. 콘솔 > 카테고리에서 상위를 고르고 추가하면 트리가 만들어집니다.
- 상위 카테고리를 열면 하위 카테고리의 상품까지 함께 표시됩니다.
- 좌측 사이드바 배치일 때: 1차 카테고리를 누르면 하위가 펼쳐지고, 현재 위치의 조상·하위가 자동으로 펼쳐진 채 표시됩니다. 목록 상단에는 "홈 > 카테고리A > 카테고리B" 브레드크럼이 나옵니다.
상품
등록·편집
상품명, 판매가, 할인가(설정 시 할인 상품 섹션 대상), 대표 이미지, 상세 설명(에디터), 카테고리(복수), 진열 상태, 추천 여부, 재고를 입력합니다. 편집 화면 하단의 저장 바는 화면에 고정되어 어디서든 저장할 수 있습니다.
옵션
옵션은 두 종류이며 편집 화면에서 섹션이 분리되어 있습니다.
| 구분 | 가격 입력 | 담기는 방식 | 예시 |
|---|---|---|---|
| 기본 옵션 | 추가금액 (음수 가능) | 본품 가격 + 추가금 | 색상: 블랙 +0원, 골드 +500원 |
| 추가 옵션 | 옵션 상품 가격 (0원 이상) | 그 가격 그대로 별도 수량으로 담김 | 전용 파우치 3,000원 |
본품보다 싼 변형(예: 알뜰형)을 팔려면 추가 옵션에 음수를 넣는 것이 아니라 기본 옵션의 음수 추가금으로 등록합니다. 추가 옵션에 음수를 넣으면 저장이 거부되며, 옵션 등록 옆 ⓘ 아이콘에 같은 안내가 있습니다. 등록된 옵션은 이름·가격·재고를 수정할 수 있습니다.
기본 옵션의 두 가지 방식
기본 옵션은 직접 입력과 조합형 중 하나를 골라 씁니다. 편집 화면 옵션 영역 맨 위에서 전환합니다.
| 방식 | 만드는 법 | 구매 화면 |
|---|---|---|
| 직접 입력 | 옵션명을 한 줄씩 등록 | 셀렉트 하나. 고르면 본품이 그 옵션으로 교체되고 한 번에 하나만 담김 |
| 조합형 | 축(색상·사이즈 등)을 정해 조합을 한꺼번에 생성 | 축마다 선택칸이 나오고, 모두 고르면 담김. 여러 조합을 함께 담을 수 있음 |
조합형 사용법입니다.
1. 축 이름과 값을 적습니다. 값은 쉼표로 나눕니다(예: 색상 = 블랙, 화이트 / 사이즈 = M, L).
2. 축마다 표시 방식을 고릅니다. 셀렉트 · 버튼 · 색상칩 중 하나입니다.
3. 조합 만들기를 누르면 아래 기본 옵션 표가 조합으로 채워집니다(위 예시는 4개).
4. 조합마다 추가금 · 재고 · SKU를 넣고 저장합니다.
- 색상칩으로 두면 값을
블루미스트|#7ec8e3처럼 적어 색을 지정할 수 있습니다. 색을 안 적으면 글자 버튼으로 나옵니다. - 축은 최대 3개, 조합은 최대 100개입니다.
- 어떤 값이 들어간 조합이 전부 품절이면 구매 화면에서 그 값이 흐려지고 선택되지 않습니다.
- 축을 고쳐 다시 만들면 이미 있는 조합의 추가금·재고는 그대로 두고, 축에서 빠진 조합은 지우지 않고 숨김으로 물러납니다(주문 이력 보존).
- 방식을 바꿔도 쓰지 않는 쪽 옵션은 삭제되지 않고 숨김으로 남으며, 되돌리면 다시 꺼내 쓸 수 있습니다.
재고
- 상품·옵션별 재고를 관리하며 0이 되면 품절 표시됩니다.
- 콘솔 > 재고에서 상품명으로 검색해 목록의 행에서 바로 조정합니다(검색어는 조정 후에도 유지).
상품 문의 (Q&A)
상품 상세의 문의 탭에서 구매자가 질문을 남기면 콘솔 > 문의에 모입니다. 답변하면 상품 상세에 함께 표시됩니다.
진열
쇼핑 홈
메인 구성을 "쇼핑 홈"으로 하면: 배너 슬라이더 → 기획전 아이콘 숏컷(메인 노출 기획전) → 추천/신상품/인기/할인 섹션 → 기획전 카드 순으로 구성됩니다. 홈 좌상단의 섹션 메뉴(추천 상품 · 신상품 · 인기 상품 · 할인 상품)는 각각 전용 목록 페이지로 연결됩니다.
| 섹션 | 기준 |
|---|---|
| 추천 상품 | 상품 편집의 추천 체크 |
| 신상품 | 최근 등록순 |
| 인기 상품 | 판매량순 |
| 할인 상품 | 할인가가 설정된 상품 |
기획전
상품을 묶어 전용 페이지를 만드는 기능입니다.
1. 콘솔 > 기획전 > 등록에서 제목을 입력합니다. 주소 슬러그는 자동 생성되며 직접 정할 수도 있습니다(중복 검사).
2. 배너를 구성합니다: 배경(단색 · 그라디언트 · 이미지 첨부), 포인트 이미지, 제목·문구(<br> 줄바꿈 지원), 글자색, 그림자.
3. 상품을 담습니다. 검색해서 체크하며, 수백 개여도 스크롤 목록에서 관리할 수 있습니다. 순서도 조정합니다.
4. 로고(1:1) 를 등록하고 메인 노출을 켜면 쇼핑 홈의 아이콘 숏컷 줄에 표시됩니다. 메인 노출에는 로고가 필수입니다.
상품 편집 화면에도 기획전 노출 섹션이 있어 상품 쪽에서 소속 기획전을 지정할 수 있습니다. 기획전 페이지 주소는 ?v=promo&p=슬러그 형식입니다.
주문과 배송
주문 상태 흐름
결제대기 → 결제완료 → 배송준비 → 배송중 → 배송완료 → 구매확정
- 구매자 주문내역과 주문상세에는 5단계 배송 트래커가 표시됩니다.
- 무통장 주문은 관리자의 입금 확인 시 결제완료가 됩니다(짓미페이).
- 구매확정은 구매자가 직접 누르며, 확정 시 리뷰 작성으로 이어집니다.
취소·반품·교환 규칙
| 시점 | 구매자가 할 수 있는 것 | 처리 |
|---|---|---|
| 결제대기 · 결제완료 | 취소 | 즉시 취소 (결제 취소 포함) |
| 배송준비 | 취소 신청 | 판매자 승인제 |
| 배송중 · 배송완료 | 반품 · 교환 신청 | 판매자 승인 후 진행 |
배송이 시작된 뒤 들어온 취소 요청은 서버가 자동으로 반품 신청으로 전환합니다. 신청 기한은 설정의 "취소·반품 신청 기한"을 따릅니다. 콘솔 > 클레임에서 승인·거절하며 처리 이력이 한글로 기록됩니다.
주문 처리
콘솔 > 주문에서 건을 열어 처리합니다: 입금 확인(무통장) → 배송준비 전환 → 택배사·송장번호 입력(배송중 전환) → 배송완료. 각 단계 전환과 메모가 처리 이력에 남습니다.
주문서(거래명세서) 출력
주문 상세 하단의 주문서 출력, 또는 주문 목록에서 체크한 뒤 선택 주문서 출력을 누르면 인쇄 전용 창이 열립니다. A4 한 장 기준이며 여러 건을 고르면 한 창에 이어서 나오고 건마다 페이지가 나뉩니다(한 번에 50건까지).
담기는 내용은 판매자 정보(상호·대표자·사업자등록번호·전화·주소), 주문번호·주문일·상태·주문자, 받는분·주소·배송메모·운송장, 품목표(옵션·수량·단가·금액), 합계, 주문 메모, 하단 안내 문구입니다. 값이 없는 항목은 줄 자체가 나오지 않습니다.
판매자 정보와 세금 표기는 설정 > 판매자 정보 / 세금에서 채웁니다.
주문 내보내기 (CSV)
주문 목록 위의 주문 내보내기 (CSV) 는 택배사 송장 업로드 등에 쓰는 표를 내려받습니다. 체크한 주문만, 아무것도 안 고르면 현재 검색 조건 전체가 대상입니다. 엑셀에서 한글이 깨지지 않도록 UTF-8 BOM으로 저장됩니다.
열 구성: 주문번호, 주문일시, 주문자·연락처·이메일, 받는분·연락처, 우편번호·주소·상세주소, 배송메모, 상품(옵션 포함), 수량합계, 결제금액, 결제상태, 배송상태, 택배사, 송장번호.
배송 조회 (스윗트래커)
송장번호만 입력하면 상태가 자동 표기되고 구매자에게 배송 이력 타임라인이 보입니다.
1. 스윗트래커에서 API 키를 발급받아 설정에 입력합니다.
2. 주문 처리에서 택배사와 송장번호를 입력합니다.
동작 방식: 조회 API를 주기적으로 호출해 상태·이력을 저장하고 화면은 저장된 데이터만 읽습니다(추적 API는 연 단위 별도 계약이라 쓰지 않습니다). 요금제 호출 한도를 아끼도록 10분 간격 폴링 · 같은 송장 2시간 1회 · 배송완료 송장 중단 등의 보호가 걸려 있어 상태 반영에 최대 10분 정도 지연될 수 있습니다. 지원 택배사: CJ대한통운, 한진, 롯데, 우체국, 로젠, 경동 등.
리뷰
- 구매확정 직후 리뷰 작성으로 바로 이어지고(단일 상품이면 해당 상품 리뷰 폼으로), 주문내역의 미작성 건에도 작성 버튼이 보입니다.
- 사진·영상 첨부: jpg / png / gif / webp / mp4 / mov / webm, 20MB, 최대 5개.
- 적립 보상: 상품당 첫 리뷰 1회. 미디어가 있으면 사진·영상 리뷰 적립금, 없으면 텍스트 리뷰 적립금이 지급되고 지급 메시지가 표시됩니다.
- 상품 카드에는 평점과 리뷰 수가 표시됩니다.
쿠폰
콘솔 > 쿠폰에서 발행합니다.
| 항목 | 설명 |
|---|---|
| 할인 방식 | 정액 (원) / 정률 (%) |
| 최대 할인 금액 | 정률 쿠폰의 상한 |
| 최소 주문 금액 | 이 금액 이상 주문에만 적용 |
| 사용 기간 | 시작·종료 일시 |
| 상태 | 발급 중지 가능 |
쿠폰 코드는 주문서에서 입력해 적용합니다. 사용은 주문 단위 1회이며, 같은 쿠폰의 중복 사용은 서버에서 막습니다. 구매 등급 승급 시 자동 발급되는 등급 쿠폰도 여기서 관리합니다.
적립금
- 커머스 자체 원장으로 관리합니다(코어 포인트와 별개).
- 자동 적립: 결제 완료 시 적립률에 따라 지급, 주문 취소 시 회수.
- 리뷰 적립: 위 리뷰 보상.
- 수동 지급·차감: 콘솔 > 적립금에서 회원을 지정해 처리하며 사유가 이력에 남습니다.
- 사용: 주문서에서 입력. 최소 사용 금액 이상부터 1원 단위로 쓸 수 있고, 조건이 주문서에 표시됩니다. 최소 미만 입력은 반영되지 않습니다.
구매 등급
누적 결제완료 금액 기준으로 자동 산정되는 커머스 자체 등급입니다(코어 회원그룹과 무관).
- 콘솔 > 등급에서 등급명, 기준 금액, 등급별 적립률, 등급 할인(정액/정률)을 등록합니다.
- 결제완료·취소 때마다 자동으로 재계산되어 등급이 오르내립니다.
- 등급이 오르면 등급 쿠폰이 1회 자동 발급됩니다.
- 등급별 적립률이 있으면 기본 적립률 대신 적용됩니다.
통계
집계 기준은 결제완료 시각입니다. 취소·환불 건은 매출에서 빼고 따로 표기합니다.
대시보드
콘솔 첫 화면에 오늘 매출(어제 대비), 이번 달 매출(지난달 대비), 결제 대기 · 발주 대기 · 배송중 · 클레임 신청 건수가 카드로 나옵니다. 뒤 네 개는 눌러 해당 목록으로 바로 갑니다. 아래에는 최근 30일 일별 매출 그래프와 인기 상품 5개가 있습니다.
통계 화면
| 탭 | 내용 |
|---|---|
| 기간별 매출 | 일 · 주 · 월 · 년 단위 전환, 기간 지정. 막대 그래프 + 표 |
| 상품별 | 판매수량 · 주문건수 · 매출 (매출순) |
| 지역별 | 배송지 주소의 첫 낱말로 시·도를 판정해 집계 |
상단에 매출 · 주문 · 평균 주문금액 · 취소환불 요약이 있고, 각 탭 결과는 CSV 내보내기로 받을 수 있습니다.
결제와 번호 표기
주문서의 결제는 짓미페이가 처리합니다(카드=토스페이먼츠, 무통장). 구매자 화면에는 커머스의 주문번호가 대표로 표시되고 짓미페이의 결제번호는 보조로 표기되어 혼동이 없습니다. 상세는 짓미페이 매뉴얼을 참고하세요.
자주 묻는 질문
- 주문서에서 "주문하기"가 막혀요: 이름 · 연락처 · 주소 · (비회원) 주문 비밀번호 · 개인정보 동의가 비면 제출 전에 해당 칸으로 스크롤·표시됩니다. 표시된 칸을 채우면 진행됩니다.
- 적립금 100원을 입력했는데 반영이 안 돼요: 최소 사용 금액 미만이면 미리보기와 결제에 반영되지 않습니다.
- 배송 상태가 바로 안 바뀌어요: 조회 API 주기 폴링 구조라 최대 10분 지연될 수 있습니다.
- 추가 옵션에 음수 가격이 안 들어가요: 의도된 동작입니다. 본품보다 싼 변형은 기본 옵션의 음수 추가금으로 등록하세요.