JAMONG MARKET · INTERNAL

상품등록 · 공급사관리 내부 운영 가이드

대상: 자몽마켓 운영 담당자 & AI (Claude Code / Codex)  ·  작성 2026-08-07  ·  몰 jamongmarket  ·  API 버전 2026-03-01
이 문서는 카페24 공식 매뉴얼과 Admin API 스펙을 실제로 대조해 작성했습니다. 필드명·코드값은 추정이 아니라 developers.cafe24.com 문서와 2026-08-06 몰 스냅샷 실측값입니다. 공급사에게 그대로 주는 문서가 아닙니다 — 외부용은 「공급사 입점 안내 가이드」가 따로 있습니다.
5
등록 상품
판매중 1건
0
등록된 공급사
전부 자체공급
5
상품 카테고리
영문 · 구조 미확정
P
권장 정산유형
수수료형
2026-08-06 카페24 Admin API 스냅샷 기준 (04_상품운영/카페24_스냅샷/).

0먼저 알아야 할 법적 제약

이걸 모르고 상품을 등록하면 되돌릴 수 없는 문제가 생깁니다. 다른 무엇보다 먼저 확인합니다.
⚠️ 온라인으로 팔 수 있는 술은 전통주뿐입니다.
현행법상 국내 주류 판매는 대면이 원칙이고, 통신판매가 허용된 주류는 전통주에 한합니다 (「주류의 통신판매에 관한 명령위임 고시」, 국세청고시 제2024-41호, 2025-01-01 시행). 일반 맥주·와인·위스키는 온라인 판매 자체가 불가합니다 — 상세페이지 노출이나 장바구니 담기도 마찬가지입니다.

성인인증은 선택이 아니라 의무입니다. 휴대전화·아이핀·공인인증서로 성인인증을 받은 자에 한해 판매할 수 있습니다.

자몽마켓의 상품 구성(무알콜·음료·주류 툴·안주·간식)은 대부분 이 규제 밖입니다. 문제가 되는 것은 실제 주류를 취급할 때뿐입니다. 판단 순서는 다음과 같습니다.

상품 유형온라인 판매필요 조치
무알콜 음료 · 안주 · 간식 · 와인잔 등 툴 가능 없음. adult_certification = F
전통주 (탁주·약주·청주·과실주 등 요건 충족분) 조건부 가능 주류 통신판매 면허 + adult_certification = T + 몰 성인인증 설정 활성화
일반 주류 (수입 맥주·와인·위스키·희석식 소주 등) 불가 등록하지 않는다. 요청이 와도 AI가 임의 등록하지 않고 원우에게 확인
성인인증은 상품 필드만으로 작동하지 않습니다. adult_certification=T를 걸어도, 몰 설정 쇼핑몰 설정 > 고객 설정 > 회원 정책 설정 > 회원가입 및 본인인증 설정에서 「성인인증 사용 시 구매차단」이 "사용함"이어야 실제로 차단됩니다. 둘 중 하나만 켜면 화면상 표시만 되고 구매는 그대로 뚫립니다 — 이중 소스 확인 대상입니다.

1카페24 공급사 구조 — 무엇을 위임하는가

카페24는 공급사를 "계정을 발급받아 자기 상품·주문만 관리하는 제한된 운영자"로 모델링합니다.
구분대표 운영자 (우리)공급사 운영자 (입점사)
관리 권한 전체 권한 · 전체 메뉴 대표 운영자가 허용한 메뉴만
상품관리 등록·관리 전체 + 판매옵션·기획전 해당 공급사 상품의 등록·관리만
주문관리 입금전 관리 포함 전 메뉴 자기 공급사 주문 처리 + 판매내역 조회만
게시판 게시판 관리 · 운영일지 · 캘린더 게시물 관리 + 자주쓰는 답변만

핵심: 상품은 반드시 하나의 공급사를 갖습니다. 지정하지 않으면 S0000000(자체공급)이 자동으로 붙습니다. 지금 자몽마켓 상품 5건이 전부 이 상태입니다.

대표 운영자 쪽 메뉴 (우리가 세팅하는 것)

업무처리 관리는 분쟁 대비용입니다. 공급사가 상품·주문을 언제 무엇을 바꿨는지가 여기에만 남습니다. 입점사가 늘어나면 이 로그를 주기적으로 내려받아 그리드에 보관하는 것을 권합니다.

2정산 유형 — 자몽마켓은 수수료형(P)

이 선택이 상품 등록 방식과 공급사와의 정산 계산식을 모두 바꿉니다. 먼저 결정하고 상품을 등록해야 합니다.
값유형정산 기준상품 등록 시
payment_type=P 수수료형 권장 상품 판매가격에 수수료율을 책정해 그 금액을 반영해 정산 price(판매가)가 기준. commission 필드에 수수료율
payment_type=D 매입형 상품 등록 시 입력한 공급가격 기준으로 정산 supply_price(공급가)를 정확히 입력해야 함
왜 수수료형인가 — 자몽마켓 사업 기획서에 "도매업체와의 정산방식을 판매분 정산이라는 효율적인 정산방식을 채용"이라고 명시돼 있습니다. 이것이 카페24 용어로 정확히 수수료형(P)입니다. 재고를 사들이지 않으므로 로우 리스크라는 사업 근거와도 일치합니다. 카페24 기본값도 P입니다.

수수료율 — 2026-05-14 실무미팅 확정

상품군수수료율commission 입력값
전통주15%15
식품 · 악세사리10%10
⚠️ commission은 공급사 단위 필드입니다 — 상품별로 다르게 줄 수 없습니다. 카페24의 commission은 suppliers 리소스에 붙어 있어 공급사 하나에 요율 하나입니다. 한 공급사가 전통주와 안주를 함께 공급하면 15%와 10%를 동시에 적용할 수 없습니다. 대응은 둘 중 하나입니다 — ① 같은 업체를 공급사 2건으로 분리 등록(전통주용·식품용) ② 대표 요율 하나로 합의. 이 판단은 첫 겸업 공급사가 등장할 때 원우가 결정합니다. AI가 임의로 분리 등록하지 않습니다.
공급사 수수료와 GRIM 30%는 전혀 다른 층입니다. 공급사 수수료(15/10%)는 몰 ↔ 공급사 정산이고, GRIM 30% / 자몽랩스 70% (순이익 기준, 월 1회, 세금계산서)는 그렇게 남은 이익을 우리와 자몽랩스가 나누는 상위 계약입니다. 두 숫자를 같은 표에 섞어 계산하지 마세요.
⚠️ 정산 구조는 PG 심사와 엮여 있습니다. 2026-06-02 토스페이먼츠 상담에서 플랫폼·입점셀러 정산 구조를 사전 고지해야 지급대행 안내를 받을 수 있다고 확인됐습니다. 공급사를 실제로 붙이기 전에 PG사에 이 구조를 고지하는 절차가 선행해야 하며, 전통주 전용 PG 선정이 아직 미완입니다 (진행중.md 런칭 블로커). 고지 없이 입점사 정산을 돌리면 PG 약관 위반이 될 수 있습니다.

정산 주기 · 시점 필드

필드값비고
payment_period
정산주기		 0 선택안함 · C 일일 · B 주간 · A 월간 기본값 0. 주간이면 payment_start_day/payment_end_day(0=일~6=토), 월간이면 payment_start_date/payment_end_date(1~31) 추가 지정
payment_method
정산시기		 10 결제완료 · 30 배송시작 · 40 배송완료 반품·취소 리스크를 공급사와 나누려면 40(배송완료)가 안전. 10은 취소 시 회수 부담이 우리에게 남음
commission
수수료율		 숫자 (기본값 10) payment_type=P일 때만 사용

3공급사 등록 — 필드 스펙

POST /api/v2/admin/suppliers · SCOPE mall.write_supply · 호출 40건/1회당 1건
필드제약설명 / 코드값
supplier_name 필수최대 50자공급사명
manager_information최대 3명하위: no필수, name필수, phone, email, use_sms
trading_type기본 D공급사유형 — D 사입(우리가 사서 배송) / C 직배송(공급사가 고객에게 직접)
supplier_type기본 WS공급사구조 — WS 도매 / SF 사입 / BS 입점 / ET 기타
status기본 AA 거래중 / P 거래중지 / N 거래해지
payment_type기본 PP 수수료형 / D 매입형  → §2
business_item최대 255자거래상품 유형
company_registration_no최대 12자사업자등록번호
company_name / president_name각 20~50자상호명 / 대표자명
company_condition / company_line각 20자업태 / 종목
bank_code / bank_account_no / bank_account_name—정산 계좌 (은행코드 / 계좌번호 / 예금주)
zipcode / address1 / address210 / 255 / 255자사업장 주소
exchange_zipcode / exchange_address1·2—반품 주소 — 직배송(C) 공급사는 반드시 채운다
show_supplier_info최대 100자쇼핑몰에 노출할 공급사 정보 — SP 전화 · SM 사업장주소 · MA 시장주소 · EA 반품주소 · MN 담당자명 · MI 담당자연락처
account_start_date / account_stop_date10자거래개시일 / 거래중지일
company_introduction—회사소개. 쇼핑몰 회사소개 화면에 노출됨 — 고객이 보는 문구다
수정(PUT) 시에는 supplier_code가 필수이며 형식이 [A-Z0-9] 정확히 8자입니다. 코드는 등록 시 시스템이 자동 부여하므로, 우리가 임의로 만들지 않고 등록 응답에서 받아 보관합니다.

4공급사 운영자 계정 — 권한 10종

POST /api/v2/admin/suppliers/users · 권한은 계정 단위로 켜고 끕니다. 기본은 최소 권한입니다.
권한 필드의미자몽마켓 초기 권장
permission_category_select상품 등록 시 분류(카테고리) 선택차단 우리가 배치
permission_product_modify등록 후 상품 정보 수정허용
permission_product_display쇼핑몰 화면에 진열차단 검수 후 우리가
permission_product_selling판매여부 설정차단 검수 후 우리가
permission_product_delete자기가 등록한 상품 삭제차단
permission_amount_inquiry주문 금액 조회허용 정산 확인용
permission_board_manage게시판 접근협의 CS 분담 여부에 따라
permission_order_menu주문 메뉴 접근허용 직배송이면 필수
permission_order_cs취소/교환/반품/환불 처리차단
permission_order_refund환불 완료 처리차단 돈이 나가는 동작
진열·판매 권한을 처음부터 열지 않습니다. 공급사가 직접 진열까지 할 수 있으면 검수되지 않은 상품이 라이브에 바로 노출됩니다. 주류 규제(§0)와 브랜드 톤을 우리가 책임지는 구조이므로, 등록은 공급사 · 노출 스위치는 우리가 유지합니다. 이는 상품 신규 등록을 판매안함/진열안함으로 만드는 기존 Hard Rule과 같은 원칙입니다.

5상품 등록 — 필드 스펙

POST /api/v2/admin/products · SCOPE mall.write_product · 호출 40건/1회당 1건

필수 3종

필드설명
product_name 필수상품명 (최대 250자)
price 필수판매가. 단 몰의 calculate_price_based_on이 B(상품가)이면 price_excluding_tax를 대신 써야 함 — 등록 전 GET /products/setting으로 확인
supply_price 필수공급가. 수수료형이어도 API는 필수로 요구함

자몽마켓에서 반드시 채우는 필드

필드값 / 코드이유
display / selling신규는 둘 다 F (기본값)검수 전 라이브 노출 방지 — Hard Rule
supplier_code[A-Z0-9] 8자, 기본 S0000000미지정 시 자체공급이 되어 정산 대상에서 누락됨
adult_certificationT/F주류는 T + 몰 설정 동반 (§0)
tax_type / tax_rateA 과세 · B 면세 · C 영세주류는 과세. 가공되지 않은 농·수·축산물은 면세
origin_place_no · origin_classification
또는 made_in_code		국가 단위면 made_in_code(2자리)로 갈음 가능원산지 표시는 법적 의무. origin_classification이 F(국내)면 국내 원산지만, T(해외)면 해외만 입력 가능
detail_image 외 3종image_upload_type을 "대표이미지 등록"으로 두면 상세이미지를 리사이징해 목록·작은목록·축소 이미지에 자동 반영개별 업로드는 4장을 따로 관리해야 해 누락이 생김
description / mobile_description상세설명 / 모바일 상세설명모바일을 채우면 모바일에서 PC 상세를 대체. 자몽마켓은 모바일 우선이므로 의도한 경우만 채운다
summary_description최대 255자목록·검색에 노출되는 요약
shipping_fee_typeT 무료 · R 고정 · M 금액별 · D 금액차등 · W 무게차등 · C 수량차등 · N 수량비례개별배송비 사용 시. 공급사별 배송비 설정과 충돌하지 않게 확인
expiration_datestart_date / end_date식품은 유통기한 관리 필요
product_weight0~999999.99무게차등 배송비·주류 배송 시 필요
custom_product_code최대 40자자체 재고관리 코드. 공급사 SKU 매핑에 사용
옵션·재고는 상품 등록과 같은 요청에서 처리할 수 있습니다. POST /products가 옵션 동시 등록을 지원하고, 이후 재고는 /products/{product_no}/variants/{variant_code}/inventories로 관리합니다. 옵션을 나중에 붙이면 variant_code가 재생성돼 재고가 초기화될 수 있으니 처음부터 같이 넣습니다.

6AI 작업 등급 — 어디까지 스스로 하는가

앱에 전체 권한(32 scope)이 부여돼 있으므로, 안전장치는 scope가 아니라 이 규칙에 있습니다. 자세한 내용은 07. 자동화/jamongmarket-cafe24-api/CLAUDE.md §4-1.
A 자동
모든 조회(GET) — 공급사 목록·상품·주문·통계. 승인 없이 실행한다.
B dry-run
공급사 등록·수정, 상품 등록·수정, 카테고리, 게시판, 프로모션, 디자인 쓰기.
무엇을 어떤 값으로 바꾸는지 목록으로 먼저 출력 → 승인 후 실행.
C 건별 승인
공급사 운영자 계정 발급·권한 변경, 주문 쓰기(취소·환불·상태변경), 회원 쓰기, 상점·배송 설정, 알림 발송.
묶어서 처리하지 않고 1건씩 확인받는다.
D 실행 안 함
대량 삭제, 일괄 환불, 공급사 거래해지(status=N), 회원 일괄 처리. 원우가 관리자 화면에서 직접.
자몽마켓은 자몽랩스와의 협업사업입니다. 수수료율·카테고리 구조·노출 정책·입점 승인은 파트너 합의 사항이므로 AI가 단독으로 바꾸지 않습니다. 공급사 계정 발급은 곧 외부인에게 우리 몰 관리자 접근을 주는 일이라 등급 C입니다.

7실행 체크리스트

신규 공급사 온보딩

  1. 사업자등록증·통장사본·(주류 취급 시) 주류 통신판매 면허 수령 — 면허 없는 주류는 등록하지 않는다
  2. 정산 조건 합의 — payment_type, commission, payment_period, payment_method
  3. POST /suppliers (등급 B: dry-run → 승인) → 응답의 supplier_code 8자를 그리드에 기록
  4. 배송 조건 설정 — trading_type이 C(직배송)면 반품 주소 필수
  5. 공급사 운영자 계정 발급 (등급 C: 건별 승인) — 권한은 §4 표대로 최소로
  6. 계정 정보 전달 + 공급사용 안내 가이드 함께 발송
  7. 11. 협업사업/자몽마켓/06_운영기록/히스토리.md에 등록일·조건 기록

상품 등록 (공급사 제출분 검수)

  1. §0 규제 판정 — 주류인가? 전통주인가? 면허가 있는가?
  2. GET /products/setting으로 calculate_price_based_on 확인 → price vs price_excluding_tax 결정
  3. display=F, selling=F로 등록 (등급 B)
  4. supplier_code가 S0000000이 아닌지 확인 — 가장 흔한 누락
  5. 원산지·과세구분·유통기한·중량 채움 확인
  6. 이미지 4종 확인 (대표이미지 등록 방식 권장)
  7. 카테고리 배치 — add_category_no
  8. 실제 화면 렌더 확인 후 display/selling을 T로 전환 (사람 판단)

8지금 몰의 상태와 해야 할 일

2026-08-06 API 스냅샷 실측. 가이드대로 운영하기 전에 정리해야 하는 것들입니다.
번호상품명진열/판매공급사판매가공급가메모
31자몽마켓 트러플 감자칩F / FS00000005,5005,5005/9 노출 확인분인데 꺼져 있음
30자몽마켓 버터 크래커F / FS00000004,9004,900동일
29자몽마켓 데일리 와인잔 1PT / TS000000012,00012,000현재 유일한 판매 상품
28Collection SampleF / FS000000000삭제 대상
27SampleF / FS000000010,0000삭제 대상
발견 사항 3가지
  1. 공급사가 하나도 등록돼 있지 않습니다. 5건 전부 S0000000(자체공급)입니다. 공급사 체계를 쓰기로 한 이상, 실제 공급 주체가 있는 상품은 공급사를 만들어 재배치해야 정산·통계가 맞습니다.
  2. 판매가 = 공급가로 동일합니다. 수수료형이면 문제되지 않지만, 매입형으로 갈 경우 마진이 0으로 계산됩니다. §2 결정 후 supply_price를 다시 채워야 할 수 있습니다.
  3. 카테고리 5종이 영문(Alcohol-Free / Snack / Tools / Store Exclusive / COLLECTION)이고, 기획했던 「주류 / 라이프스타일 / 그로서리」 구조와 다릅니다. 공급사에게 카테고리를 안내하려면 이 구조부터 확정해야 합니다 — 파트너 합의 사항.

9확인 필요 — 이 문서가 채우지 못한 것

근거가 없어 추정하지 않은 항목입니다. 확정되면 이 문서와 공급사용 가이드를 함께 갱신합니다.
항목상태담당
수수료율을 공급사용 문서에도 명시할지요율 자체는 확정(전통주 15 / 식품·악세사리 10). 다만 대외 문서에 숫자를 박으면 협상 여지가 사라지므로 현재 공급사용 가이드에는 "협의"로 두었음 — 명시 여부는 원우 판단원우
겸업 공급사 요율 처리commission이 공급사 단위라 15%·10% 동시 적용 불가 → 분리 등록 vs 단일 요율 결정 필요원우 (첫 사례 발생 시)
PG 지급대행 사전 고지플랫폼·입점셀러 정산 구조 고지가 선행돼야 함 (2026-06-02 토스 상담). 전통주 전용 PG 미선정 상태원우
상품 카테고리 구조현재 영문 5종 ↔ 기획 3종 불일치. 2026-05-14 미팅에서는 카테고리+매거진+커뮤니티 구조로 결정됨 — 셋 다 미반영. 공급사 안내 전 확정 필요파트너 합의
주류 통신판매 면허 보유자몽랩스 확인 요청 상태 (진행중.md 런칭 블로커)강 대표
몰 성인인증 구매차단 설정활성 여부 미확인 — 카페24 OAuth 재인증 후 실측 예정AI (재인증 후)
calculate_price_based_on 값미확인 — price vs price_excluding_tax 결정에 필요AI (재인증 후)
전통주 전용 PG토스페이먼츠 상담 완료, 카페24 답변 대기원우
공급사 정산 세금계산서 처리공급사→몰 발행 방식·시점 미정원우 · 강 대표
⚠️ 카페24 Admin API가 현재 인증 만료 상태입니다. 리프레시 토큰이 거부되어(2026-08-07 확인) authorize.py 브라우저 재인증이 필요합니다. 재인증 전까지 이 문서의 「몰 현황」은 2026-08-06 스냅샷 기준이며 그 이후 변경분은 반영돼 있지 않습니다.
출처 — 카페24 Admin API 문서 (버전 2026-03-01, Suppliers · Suppliers users · Products) · 카페24 쇼핑몰관리자 매뉴얼 — 공급사 관리 · 카페24 웹 매뉴얼 — 공급사목록 · 주류의 통신판매에 관한 명령위임 고시 (국세청고시 제2024-41호) · 자몽마켓 상품 스냅샷 2026-08-06 · 자몽마켓 사업 기획서