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:
@@ -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")]])
|
||||
|
||||
@@ -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; }
|
||||
|
||||
@@ -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건씩 조회해 같은 열로. 네이버페이는 자체몰.
|
||||
|
||||
Reference in New Issue
Block a user