fix(performance): 카페24 market_id 의 자체몰 채널(모바일웹·네이버페이·톡체크아웃)을 자체몰로 분류

실데이터 대조 결과 "다른 마켓 연동"으로 보이던 주문은 mobile(모바일웹)·NCHECKOUT(네이버페이)·
KAKAOPAY(톡체크아웃) — 모두 카페24 자체몰 주문. 금액은 이미 카페24 열이었지만 대조 표시가 오해를 불렀다.

- SELF_CHANNELS 로 자체몰 채널 명시, channel_kind(self/market/unknown)
- MARKET_MAP 에서 결제수단과 헷갈리는 일반 이름(naver, kakao 등) 제거
- 매출 대조: "카페24 열 / 다른 쇼핑몰 열" + "주문 채널별" 표(자체몰 채널/외부 마켓/알 수 없는 채널)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-29 16:59:16 +09:00
parent 19396f1745
commit f63f82d642
6 changed files with 92 additions and 57 deletions
+61 -40
View File
@@ -48,34 +48,51 @@ REFUND_LIMIT = 500
LOOKUP_BATCH = 100
MAX_OFFSET = 15000
CHUNK_DAYS = 60
SELF_MARKETS = {"", "self", None}
EVENT_PREFIX = "c24:"
# 카페24 마켓 통합관리가 가져온 주문의 market_id(또는 order_place_id) → 우리 쇼핑몰 열.
# 여기 없는 마켓(예: 옥션·인터파크)은 카페24 열에 남긴다 — 전체 합계는 항상 카페24 화면과 같다.
# 실제 값은 설정 → "카페24 매출 대조"의 마켓별 표(market_id / 주문경로 / 반영 열)로 확인해 보탠다.
# 카페24 자체몰 주문 채널 — market_id 는 외부 마켓만이 아니라 주문 채널·간편결제도 담는다
# (실데이터 확인 2026-09-30: mobile=모바일웹, NCHECKOUT=네이버페이, KAKAOPAY=톡체크아웃).
# 이 주문들은 카페24 자체몰 매출이다. 비교는 소문자로.
SELF_CHANNELS: dict[str, str] = {
"": "자체몰", "self": "자체몰(PC)", "cafe24": "자체몰", "mobile": "모바일웹", "mobile_d": "모바일앱",
"ncheckout": "네이버페이", "kakaopay": "톡체크아웃",
}
# 카페24 마켓 통합관리가 가져온 외부 마켓 주문의 market_id(또는 order_place_id) → 우리 쇼핑몰 열.
# 여기에도 SELF_CHANNELS 에도 없는 채널은 "알 수 없는 채널"로 카페24 열에 남긴다 — 전체 합계는 항상
# 카페24 화면과 같다. 결제수단(네이버페이·카카오페이)과 헷갈릴 수 있는 일반 이름(naver, kakao)은 넣지 않는다.
# 실제 값은 설정 → "카페24 매출 대조"의 주문 채널별 표로 확인해 보탠다.
MARKET_MAP: dict[str, str] = {
"shopn": "naver", "smartstore": "naver", "storefarm": "naver", "naver": "naver",
"shopn": "naver", "smartstore": "naver", "storefarm": "naver",
"coupang": "coupang",
"sk11st": "elevenst", "11st": "elevenst", "elevenst": "elevenst",
"gmarket": "gmarket",
"lotteon": "lotteon", "lotte": "lotteon",
"gsshop": "gsshop", "gs": "gsshop",
"kakao": "kakao", "kakaotalkstore": "kakao", "talkstore": "kakao", "kakaostyle": "kakao",
"lotteon": "lotteon",
"gsshop": "gsshop",
"kakaotalkstore": "kakao", "talkstore": "kakao", "kakaostyle": "kakao",
"ohouse": "ohouse", "todayhouse": "ohouse", "bucketplace": "ohouse",
"toss": "toss", "tossshopping": "toss",
"tossshopping": "toss",
}
def _key(value: Any) -> str:
return str(value or "").strip().lower()
def channel_kind(market_id: Any, order_place_id: Any = None) -> str:
"""self(자체몰 채널) / market(외부 마켓, 해당 쇼핑몰 열) / unknown(모르는 채널 → 카페24 열)."""
if market_id is None or _key(market_id) in SELF_CHANNELS:
return "self"
if _key(market_id) in MARKET_MAP or _key(order_place_id) in MARKET_MAP:
return "market"
return "unknown"
def target_code(market_id: Any, order_place_id: Any = None) -> str:
"""이 주문을 집계할 쇼핑몰 열. 자체몰·모르는 마켓은 카페24."""
if is_self_market(market_id):
"""이 주문을 집계할 쇼핑몰 열. 자체몰 채널·모르는 채널은 카페24."""
if channel_kind(market_id, order_place_id) != "market":
return "cafe24"
for key in (market_id, order_place_id):
code = MARKET_MAP.get(str(key or "").strip().lower())
if code:
return code
return "cafe24"
return MARKET_MAP.get(_key(market_id)) or MARKET_MAP[_key(order_place_id)]
# 결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰 (initial_order_amount 의 필드)
DISCOUNT_FIELDS = ("membership_discount_amount", "set_product_discount_amount", "app_discount_amount",
@@ -118,7 +135,8 @@ def order_total(order: dict[str, Any]) -> int:
def is_self_market(market_id: Any) -> bool:
return market_id in SELF_MARKETS
"""카페24 자체몰 채널(PC·모바일·네이버페이·톡체크아웃 등)인가."""
return channel_kind(market_id) == "self"
def _chunks(start: date, end: date) -> Iterable[tuple[date, date]]:
@@ -306,31 +324,37 @@ class Cafe24Adapter(MarketplaceAdapter):
def reconcile(self, ctx: AdapterContext, day: date) -> dict[str, Any]:
"""그날 결제 주문·환불을 항목별로 합산 — 카페24 일별 매출내역과 비교해 규칙을 확정하는 용도.
자체몰/다른 마켓을 나눠 합산한다. 개인정보는 담지 않는다.
groups["self"] = 카페24 열(자체몰 채널 + 알 수 없는 채널), groups["market"] = 다른 쇼핑몰 열로 가는
외부 마켓 주문. by_channel = 주문 채널(market_id)별 내역. 개인정보는 담지 않는다.
"""
self.authenticate(ctx)
def empty() -> dict[str, int]:
return {"orders": 0, "items": 0, "lines": 0, **{k: 0 for k in AMOUNT_FIELDS}, "total": 0}
def channel(mid: Any, place: Any) -> dict[str, Any]:
key = "" if mid is None else str(mid)
kind = channel_kind(mid, place)
return by_channel.setdefault(key, {
"market_id": key or "(없음)", "label": SELF_CHANNELS.get(_key(mid), ""), "names": set(),
"kind": kind, "target": target_code(mid, place),
"orders": 0, "total": 0, "refund_count": 0, "refund_amount": 0,
})
groups = {"self": empty(), "market": empty()}
by_market: dict[str, dict[str, Any]] = {} # 다른 마켓 연동 주문 — market_id 별
by_channel: dict[str, dict[str, Any]] = {}
unpaid = 0
for o in self.paid_orders(ctx, day, day):
if o.get("paid") != "T":
unpaid += 1
continue
if not is_self_market(o.get("market_id")):
key = str(o.get("market_id"))
bm = by_market.setdefault(key, {"market_id": key, "names": set(), "orders": 0, "total": 0,
"refund_count": 0, "refund_amount": 0,
"target": target_code(o.get("market_id"), o.get("order_place_id"))})
bm["orders"] += 1
bm["total"] += order_total(o)
for n in (o.get("order_place_name"), o.get("order_place_id")):
if n:
bm["names"].add(str(n))
g = groups["self" if is_self_market(o.get("market_id")) else "market"]
ch = channel(o.get("market_id"), o.get("order_place_id"))
ch["orders"] += 1
ch["total"] += order_total(o)
for n in (o.get("order_place_name"), o.get("order_place_id")):
if n:
ch["names"].add(str(n))
g = groups["self" if ch["target"] == "cafe24" else "market"]
g["orders"] += 1
g["items"] += sum(int(i.get("quantity") or 0) for i in o.get("items") or [])
g["lines"] += len(o.get("items") or [])
@@ -343,19 +367,16 @@ class Cafe24Adapter(MarketplaceAdapter):
"market": {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0}}
for r in rows:
mid, place = markets.get(str(r.get("order_id")), ("self", None))
g = refunds["self" if is_self_market(mid) else "market"]
ch = channel(mid, place)
g = refunds["self" if ch["target"] == "cafe24" else "market"]
g["count"] += 1
for k in ("actual_refund_amount", "used_points", "used_credits"):
g[k] += _won(r.get(k))
if not is_self_market(mid):
bm = by_market.setdefault(str(mid), {"market_id": str(mid), "names": set(), "orders": 0, "total": 0,
"refund_count": 0, "refund_amount": 0,
"target": target_code(mid, place)})
bm["refund_count"] += 1
bm["refund_amount"] += _won(r.get("actual_refund_amount"))
markets_out = sorted(({**v, "names": sorted(v["names"])} for v in by_market.values()),
key=lambda v: v["total"], reverse=True)
ch["refund_count"] += 1
ch["refund_amount"] += _won(r.get("actual_refund_amount"))
channels_out = sorted(({**v, "names": sorted(v["names"])} for v in by_channel.values()),
key=lambda v: v["total"], reverse=True)
return {"date": day.isoformat(), "orders": groups, "refunds": refunds, "unpaid_orders": unpaid,
"by_market": markets_out,
"by_channel": channels_out,
"formula": "결제합계 = 상품구매금액 + 배송비 − 할인(" + ", ".join(DISCOUNT_FIELDS) +
") − 쿠폰(" + ", ".join(COUPON_FIELDS) + ")"}
@@ -235,4 +235,4 @@
} | tojson }}</script>
{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930c" defer></script>{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930d" defer></script>{% endblock %}
@@ -143,4 +143,4 @@
</section>
{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930c" defer></script>{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930d" defer></script>{% endblock %}
@@ -434,7 +434,8 @@ def test_cafe24_normalize_matches_daily_report():
ctx = AdapterContext(code="cafe24", credentials=None)
fake = _FakeCafe24(
[[_c24_order("A"), _c24_order("B", market="shopn"), _c24_order("C", paid="F"),
_c24_order("D", market="auction")]],
_c24_order("D", market="auction"), _c24_order("E", market="NCHECKOUT"),
_c24_order("F", market="KAKAOPAY"), _c24_order("G", market="mobile")]],
[[_c24_refund("C20260929-01", "A", 12_610), _c24_refund("R20260929-02", "X", 20_000),
_c24_refund("C20260929-03", "M", 9_000), _c24_refund("C20260929-04", "A", 5_000, status="F")]],
lookup={"M": "shopn"},
@@ -448,6 +449,9 @@ def test_cafe24_normalize_matches_daily_report():
# 마켓 연동 주문은 해당 쇼핑몰 열로, 연결표에 없는 마켓(옥션)은 카페24 열, 미결제는 제외
assert by[("SALE", "c24:B-PAY")].marketplace_code == "naver"
assert by[("SALE", "c24:D-PAY")].marketplace_code == "cafe24"
# 네이버페이·톡체크아웃·모바일웹은 카페24 자체몰 주문(실데이터 확인) — 네이버/카카오 열로 가면 안 된다
for oid in ("E", "F", "G"):
assert by[("SALE", f"c24:{oid}-PAY")].marketplace_code == "cafe24", oid
assert ("SALE", "c24:C-PAY") not in by
# 환불: 환불완료일, 실제 환불액, R→반품 / 그 밖→취소, 원 주문의 마켓 열로, 미완료 환불 제외
assert by[("CANCEL", "c24:C20260929-01")].amount == -12_610
@@ -462,14 +466,18 @@ def test_cafe24_normalize_matches_daily_report():
"coupon_discount_price": "57000.00"}}) == 1_566_800 # 9/29 화면값
assert target_code("self") == "cafe24" and target_code("SK11ST") == "elevenst"
assert target_code("unknown", "coupang") == "coupang" and target_code("unknown") == "cafe24"
# 대조: 자체몰/마켓 나눠 합산 + 마켓별 반영 열
assert target_code("NCHECKOUT", "NCHECKOUT") == "cafe24" and target_code("KAKAOPAY") == "cafe24"
assert target_code("naver") == "cafe24" and target_code("kakao") == "cafe24" # 결제수단과 헷갈리는 일반 이름 X
# 대조: 카페24 열(자체몰 채널+모르는 채널)/다른 쇼핑몰 열 + 주문 채널별
rec = fake.reconcile(ctx, date(2026, 9, 29))
assert rec["orders"]["self"]["orders"] == 1 and rec["orders"]["self"]["total"] == 47_000
assert rec["orders"]["market"]["orders"] == 2 and rec["unpaid_orders"] == 1
assert rec["orders"]["self"]["orders"] == 5 and rec["orders"]["self"]["total"] == 5 * 47_000 # A,D,E,F,G
assert rec["orders"]["market"]["orders"] == 1 and rec["unpaid_orders"] == 1 # B(스마트스토어)
assert rec["refunds"]["self"]["actual_refund_amount"] == 32_610 and rec["refunds"]["market"]["count"] == 1
bym = {b["market_id"]: b for b in rec["by_market"]}
assert bym["shopn"]["target"] == "naver" and bym["shopn"]["refund_amount"] == 9_000
assert bym["auction"]["target"] == "cafe24" and bym["auction"]["orders"] == 1
ch = {b["market_id"]: b for b in rec["by_channel"]}
assert ch["shopn"]["kind"] == "market" and ch["shopn"]["target"] == "naver" and ch["shopn"]["refund_amount"] == 9_000
assert ch["auction"]["kind"] == "unknown" and ch["auction"]["target"] == "cafe24"
assert ch["NCHECKOUT"]["kind"] == "self" and ch["NCHECKOUT"]["label"] == "네이버페이"
assert ch["KAKAOPAY"]["label"] == "톡체크아웃" and ch["mobile"]["label"] == "모바일웹"
# 60일 단위 분할 + 페이지 넘김(1000건이면 다음 페이지)
page1 = [_c24_order(f"x-{i}") for i in range(1000)]
fake2 = _FakeCafe24([page1, [_c24_order("y")]])
+9 -7
View File
@@ -512,27 +512,29 @@
["순매출(결제합계 − 환불합계)", s.total - rs.actual_refund_amount, m.total - rm.actual_refund_amount, "key"],
]);
out.innerHTML = '<table class="perf-table" style="margin-top:8px"><thead><tr><th class="perf-th-label">' + esc(r.date) +
"</th><th>자체몰(카페24 열)</th><th>다른 마켓 연동(해당 쇼핑몰 열)</th></tr></thead><tbody>" +
"</th><th>카페24 열(자체몰 채널)</th><th>다른 쇼핑몰 열(외부 마켓)</th></tr></thead><tbody>" +
rows.map(function (x) {
const cls = x[3] === "key" ? ' class="perf-row-week"' : "";
const f = function (v) { return x[3] === "cnt" ? fmt(v) : won(v); };
return "<tr" + cls + '><th class="perf-td-label' + (x[3] === "sub" ? " perf-muted" : "") + '">' + esc(x[0]) +
'</th><td class="perf-num">' + f(x[1]) + '</td><td class="perf-num">' + f(x[2]) + "</td></tr>";
}).join("") + "</tbody></table>" +
((r.by_market || []).length
? '<h4 class="perf-h" style="margin:14px 0 6px">다른 마켓 연동 주문 — 마켓별</h4>' +
((r.by_channel || []).length
? '<h4 class="perf-h" style="margin:14px 0 6px">주문 채널별</h4>' +
'<table class="perf-table"><thead><tr><th class="perf-th-label">market_id</th><th class="perf-th-label">주문경로</th>' +
'<th class="perf-th-label">반영 열</th><th>주문수</th><th>결제합계</th><th>환불</th><th>순매출</th></tr></thead><tbody>' +
r.by_market.map(function (b) {
'<th class="perf-th-label">구분</th><th class="perf-th-label">반영 열</th><th>주문수</th><th>결제합계</th><th>환불</th><th>순매출</th></tr></thead><tbody>' +
r.by_channel.map(function (b) {
const col = MARKET_NAMES[b.target] || b.target;
const kind = b.kind === "self" ? "자체몰 채널" + (b.label ? "(" + b.label + ")" : "")
: b.kind === "market" ? "외부 마켓" : '<span class="perf-err" style="display:inline">알 수 없는 채널</span>';
return '<tr><td class="perf-td-label">' + esc(b.market_id) + "</td><td>" + esc((b.names || []).join(", ")) +
"</td><td>" + esc(col) + (b.target === "cafe24" ? ' <span class="perf-muted">(연결표 없음)</span>' : "") +
"</td><td>" + (b.kind === "unknown" ? kind : esc(kind)) + "</td><td>" + esc(col) +
'</td><td class="perf-num">' + fmt(b.orders) + '</td><td class="perf-num">' + won(b.total) +
'</td><td class="perf-num">' + won(-b.refund_amount) + '</td><td class="perf-num">' + won(b.total - b.refund_amount) + "</td></tr>";
}).join("") + "</tbody></table>"
: "") +
'<p class="perf-foot perf-muted">' + esc(r.formula) + ". 미결제 주문 " + fmt(r.unpaid_orders) +
"건 제외. 카페24 화면과 다른 줄이 있으면 알려 주세요 — 규칙을 맞추겠습니다.</p>";
"건 제외. \"알 수 없는 채널\"은 카페24 열에 넣습니다 — 외부 마켓이면 어느 쇼핑몰인지 알려 주세요.</p>";
} catch (err) {
out.innerHTML = '<p class="perf-notice is-warn">' + esc(err.message) + "</p>";
} finally { recon.disabled = false; }
+5 -1
View File
@@ -49,7 +49,11 @@
- **기간 교체(`replace_range=True`)**: 결제·환불 모두 기간 안 날짜로 조회되므로 동기화 때 그 기간의 카페24 실데이터를 지우고
새로 넣는다(한 트랜잭션, 테스트 데이터 제외). 규칙이 바뀌어도 예전 행이 남지 않는다 → 규칙을 고친 뒤에는 같은 기간을
[과거 매출 가져오기]로 다시 받으면 된다.
- **마켓 연동 주문은 해당 쇼핑몰 열로**: 자체몰(`market_id` = self/빈값)은 카페24 열. 카페24 마켓 통합관리가 가져온
- **주의 — `market_id` 는 외부 마켓만이 아니라 자체몰 주문 채널·간편결제도 담는다**(실데이터 확인 2026-09-30:
`mobile`=모바일웹, `NCHECKOUT`=네이버페이, `KAKAOPAY`=톡체크아웃). 이들은 `SELF_CHANNELS` 로 카페24 열.
대조 도구의 "주문 채널별" 표가 채널마다 자체몰 채널 / 외부 마켓 / 알 수 없는 채널(→ 카페24 열)을 보여 준다.
`MARKET_MAP` 에는 결제수단과 헷갈릴 수 있는 일반 이름(naver, kakao)을 넣지 않는다.
- **마켓 연동 주문은 해당 쇼핑몰 열로**: 자체몰 채널은 카페24 열. 카페24 마켓 통합관리가 가져온
다른 마켓 주문은 `MARKET_MAP`(market_id 또는 order_place_id → 우리 쇼핑몰 코드)으로 네이버·쿠팡·11번가 등 열에 넣는다
(`SaleEvent.marketplace_code`). 연결표에 없는 마켓은 카페24 열 — **전체 합계는 항상 카페24 일별 매출내역과 같다**
(9/28 대조로 자체몰+마켓 합계가 모든 줄에서 일치 확인). 환불은 원 주문을 100건씩 조회해 같은 열로. 네이버페이는 자체몰.