diff --git a/app/modules/performance/adapters/cafe24.py b/app/modules/performance/adapters/cafe24.py index e8acc3a..85ef0ad 100644 --- a/app/modules/performance/adapters/cafe24.py +++ b/app/modules/performance/adapters/cafe24.py @@ -8,6 +8,8 @@ 카페24 관리자 "일별 매출내역"과 같은 기준으로 센다(Admin API 문서 2026-09-01 확인). - 결제합계(SALE, +): GET /admin/orders date_type=pay_date(결제일), 결제된(paid=T) 주문마다 상품구매금액 + 배송비 − 할인 − 쿠폰 (주문의 initial_order_amount — 결제 당시 금액) + 카페24 화면의 상품구매금액은 품목의 상품추가할인(items[].additional_discount_price)을 뺀 값이다 — + initial_order_amount 에는 이 할인이 없어 품목에서 더해 뺀다(실데이터: 상품구매금액이 100원 단위가 아닌 날만 차이). 환불은 따로 빼므로 취소 후 금액(actual_order_amount)이 아니라 결제 당시 금액을 쓴다. - 환불합계(CANCEL/RETURN, −): GET /admin/refunds date_type=refund_date(환불완료일), 실제 환불액(actual_refund_amount). 환불코드가 R 로 시작하면 반품, 그 밖은 취소. @@ -132,16 +134,23 @@ def _day(value: Any) -> date | None: return None +def item_additional_discount(order: dict[str, Any], *, active_only: bool = False) -> int: + """품목 상품추가할인 합계(items[].additional_discount_price, 품목 줄 금액). 주문 금액(initial/actual)에는 없다. + active_only 면 취소·반품된 품목은 빼고(현재 금액 계산용).""" + return sum(_won(i.get("additional_discount_price")) for i in order.get("items") or [] + if not (active_only and str(i.get("order_status") or "")[:1] in ("C", "R"))) + + def order_amounts(order: dict[str, Any]) -> dict[str, int]: - """결제 당시 금액(initial_order_amount, 없으면 actual_order_amount) 항목별 원 단위.""" + """결제 당시 금액(initial_order_amount, 없으면 actual_order_amount) 항목별 원 단위 + 품목 상품추가할인.""" a = order.get("initial_order_amount") or order.get("actual_order_amount") or {} - return {k: _won(a.get(k)) for k in AMOUNT_FIELDS} + return {**{k: _won(a.get(k)) for k in AMOUNT_FIELDS}, "additional_discount_price": item_additional_discount(order)} def order_total(order: dict[str, Any]) -> int: - """결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰.""" + """결제합계 = 상품구매금액(− 품목 상품추가할인) + 배송비 − 할인 − 쿠폰.""" a = order_amounts(order) - return (a["order_price_amount"] + a["shipping_fee"] + return (a["order_price_amount"] - a["additional_discount_price"] + a["shipping_fee"] - sum(a[k] for k in DISCOUNT_FIELDS) - sum(a[k] for k in COUPON_FIELDS)) @@ -154,7 +163,7 @@ def order_total_now(order: dict[str, Any]) -> int: """취소·반품 반영 후 현재 결제합계(actual_order_amount). 없으면 결제 당시 금액.""" a = order.get("actual_order_amount") or order.get("initial_order_amount") or {} w = {k: _won(a.get(k)) for k in AMOUNT_FIELDS} - return (w["order_price_amount"] + w["shipping_fee"] + return (w["order_price_amount"] - item_additional_discount(order, active_only=True) + w["shipping_fee"] - sum(w[k] for k in DISCOUNT_FIELDS) - sum(w[k] for k in COUPON_FIELDS)) @@ -416,7 +425,8 @@ class Cafe24Adapter(MarketplaceAdapter): order_date=_day(order.get("order_date")), payment_date=pay_day, event_date=pay_day, amount=max(0, order_total(order)), product_name=name, quantity=sum(int(i.get("quantity") or 0) for i in items), order_status="결제완료", - discount_amount=sum(order_amounts(order)[k] for k in DISCOUNT_FIELDS + COUPON_FIELDS), + discount_amount=sum(order_amounts(order)[k] + for k in ("additional_discount_price", *DISCOUNT_FIELDS, *COUPON_FIELDS)), raw={"order_id": oid, "market_id": order.get("market_id"), "order_place_id": order.get("order_place_id"), "items": len(items), **{f"initial_{k}": v for k, v in order_amounts(order).items()}}, )] @@ -471,7 +481,8 @@ class Cafe24Adapter(MarketplaceAdapter): self.authenticate(ctx) def empty() -> dict[str, int]: - return {"orders": 0, "items": 0, "lines": 0, **{k: 0 for k in AMOUNT_FIELDS}, "total": 0} + return {"orders": 0, "items": 0, "lines": 0, **{k: 0 for k in AMOUNT_FIELDS}, + "additional_discount_price": 0, "total": 0} def channel(mid: Any, place: Any, place_name: Any = None) -> dict[str, Any]: """(market_id, 주문경로) 한 쌍 = 한 줄. self 안에도 PC쇼핑몰·모바일웹 경로가 섞여 있어 나눠 본다.""" @@ -669,5 +680,5 @@ class Cafe24Adapter(MarketplaceAdapter): for c in no_record], "reduced_orders": sorted(reduced.values(), key=lambda r: r["diff"] - r["refunded"], reverse=True), "by_payment": sorted(by_payment.values(), key=lambda v: v["total"], reverse=True), - "formula": "결제합계 = 상품구매금액 + 배송비 − 할인(" + ", ".join(DISCOUNT_FIELDS) + + "formula": "결제합계 = 상품구매금액(− 품목 상품추가할인) + 배송비 − 할인(" + ", ".join(DISCOUNT_FIELDS) + ") − 쿠폰(" + ", ".join(COUPON_FIELDS) + ")"} diff --git a/app/modules/performance/tests/test_performance.py b/app/modules/performance/tests/test_performance.py index d8f7a8a..f989bd1 100644 --- a/app/modules/performance/tests/test_performance.py +++ b/app/modules/performance/tests/test_performance.py @@ -650,6 +650,23 @@ def test_cafe24_scope_and_replace_range(): ("naver", "direct-naver-1"), ("cafe24", "sample")}, got +def test_cafe24_item_additional_discount(): + """카페24 상품구매금액 = 판매가 합계 − 품목 상품추가할인(additional_discount_price). 주문 금액에는 없다. + 실데이터: 9/23 카페24 상품구매금액 1,860,738 — 판매가 합계 1,860,800 과 62원 차이.""" + from app.modules.performance.adapters.cafe24 import order_total, order_total_now + + o = _c24_order("A") # 50,000 + 3,000 − 1,000 − 5,000 + o["items"][0]["additional_discount_price"] = "38.00" + o["items"][1]["additional_discount_price"] = "24.00" + assert order_total(o) == 47_000 - 62 + ev = _FakeCafe24([]).normalize_order(o)[0] + assert ev.amount == 46_938 and ev.discount_amount == 62 + 1_000 + 5_000 + # 현재 금액: 취소된 품목의 추가할인은 빼지 않는다 + o["actual_order_amount"] = dict(o["initial_order_amount"]) + o["items"][1]["order_status"] = "C40" + assert order_total_now(o) == 47_000 - 38 + + def test_daily_check_db_vs_live(): """일별 비교: 저장값(카페24 경유 다른 마켓 열 포함) + 지금 API 값(저장 안 함).""" import app.modules.performance.sync as syncmod diff --git a/app/static/performance.js b/app/static/performance.js index 13e1d8a..811c1bc 100644 --- a/app/static/performance.js +++ b/app/static/performance.js @@ -474,6 +474,7 @@ } // ── 카페24 매출 대조 — 카페24 "일별 매출내역" 열 순서대로 ── + let lastShop = {}; // 일별 비교에 붙여넣은 카페24 값(날짜 → 열) — 대조 표에 차이 열로 표시 const recon = document.getElementById("perf-recon"); if (recon) recon.addEventListener("click", async function () { const day = document.getElementById("perf-recon-date").value; @@ -497,34 +498,46 @@ coupon_discount_price: "상품쿠폰", coupon_shipping_fee_amount: "배송비쿠폰", }; const sum = function (g, keys) { return keys.reduce(function (a, k) { return a + (g[k] || 0); }, 0); }; + // x[4] = 붙여넣은 카페24 일별 매출내역 열 번호(일별 비교에서 이 날짜를 눌렀을 때 차이 표시) const rows = [ - ["주문수", s.orders, m.orders, "cnt"], ["품목수(수량 합계)", s.items, m.items, "cnt"], ["품목수(품목 줄 수)", s.lines, m.lines, "cnt"], - ["상품구매금액", s.order_price_amount, m.order_price_amount], ["배송비", s.shipping_fee, m.shipping_fee], - ["할인 합계", sum(s, disc), sum(m, disc)], + ["주문수", s.orders, m.orders, "cnt", 0], ["품목수(수량 합계)", s.items, m.items, "cnt", 1], ["품목수(품목 줄 수)", s.lines, m.lines, "cnt", 1], + ["상품구매금액(− 상품추가할인)", s.order_price_amount - s.additional_discount_price, m.order_price_amount - m.additional_discount_price, "", 2], + [" · 판매가 합계", s.order_price_amount, m.order_price_amount, "sub"], + [" · 상품추가할인(품목)", s.additional_discount_price, m.additional_discount_price, "sub"], + ["배송비", s.shipping_fee, m.shipping_fee, "", 3], + ["할인 합계", sum(s, disc), sum(m, disc), "", 4], ].concat(disc.map(function (k) { return [" · " + LABEL[k], s[k], m[k], "sub"]; })) - .concat([["쿠폰 합계", sum(s, coup), sum(m, coup)]]) + .concat([["쿠폰 합계", sum(s, coup), sum(m, coup), "", 5]]) .concat(coup.map(function (k) { return [" · " + LABEL[k], s[k], m[k], "sub"]; })) .concat([ - ["결제합계(계산)", s.total, m.total, "key"], - [" 참고: 실결제금액", s.payment_amount, m.payment_amount, "sub"], - [" 참고: 적립금 사용", s.points_spent_amount, m.points_spent_amount, "sub"], - [" 참고: 예치금 사용", s.credits_spent_amount, m.credits_spent_amount, "sub"], + ["결제합계(계산)", s.total, m.total, "key", 10], + [" 참고: 실결제금액", s.payment_amount, m.payment_amount, "sub", 6], + [" 참고: 적립금 사용", s.points_spent_amount, m.points_spent_amount, "sub", 7], + [" 참고: 예치금 사용", s.credits_spent_amount, m.credits_spent_amount, "sub", 8], ["환불 건수(환불 목록)", rs.count, rm.count, "cnt"], [" · 실제 환불액", rs.actual_refund_amount, rm.actual_refund_amount, "sub"], [" · 적립금 환불", rs.used_points, rm.used_points, "sub"], [" · 예치금 환불", rs.used_credits, rm.used_credits, "sub"], ["환불 목록 없는 취소·반품 품목 수(네이버페이 등)", rs.no_record_count, rm.no_record_count, "cnt"], [" · 취소·반품 금액", rs.no_record, rm.no_record, "sub"], - ["환불합계", rs.total, rm.total, "key"], - ["순매출(결제합계 − 환불합계)", s.total - rs.total, m.total - rm.total, "key"], + ["환불합계", rs.total, rm.total, "key", 11], + ["순매출(결제합계 − 환불합계)", s.total - rs.total, m.total - rm.total, "key", 12], ]); + const shopCols = (lastShop[r.date] || {}).cols || null; out.innerHTML = '
| ' + esc(r.date) + - " | 카페24 열(자체몰 채널) | 다른 쇼핑몰 열(외부 마켓) | 카페24 열(자체몰 채널) | 다른 쇼핑몰 열(외부 마켓) | " + + (shopCols ? "합계 | 카페24 화면 | 차이 | " : "") + "" + 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); }; + let cmp = ""; + if (shopCols) { + const both = (x[1] || 0) + (x[2] || 0), c = x[4] == null ? null : shopCols[x[4]]; + cmp = '' + f(both) + ' | ' + (c == null ? "" : f(c)) + ' | ' + + (c == null ? "" : both === c ? '✓' : '' + (both > c ? "+" : "") + fmt(both - c) + "") + " | "; + } return "
|---|---|---|
| ' + esc(x[0]) + - ' | ' + f(x[1]) + ' | ' + f(x[2]) + " | ' + f(x[1]) + ' | ' + f(x[2]) + " | " + cmp + ""; }).join("") + "
날짜가 있는 줄을 찾지 못했습니다. 카페24 일별 매출내역 표를 복사해 붙여 넣으세요.
'; return; } const live = document.getElementById("perf-daily-live").checked; diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index 0da9a2b..2ed7765 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -71,6 +71,10 @@ 매출내역 표를 붙여 넣으면(날짜 + 뒤 세 숫자 = 결제합계·환불합계·순매출, 첫 숫자 = 주문수) 날짜마다 저장값(`c24:` 사건 전체, 다른 마켓 열 포함)과 지금 API·현재 규칙으로 다시 계산한 값(`adapter.collect`, 저장 안 함)을 비교한다. 저장값만 틀림 → 예전 규칙으로 받은 것([다시 가져오기] 버튼), API 값도 틀림 → 규칙 차이(결제/환불) → 날짜 클릭으로 그날 대조. + 날짜를 눌러 연 대조 표에는 붙여넣은 카페24 열(주문수·품목수·상품구매금액·배송비·할인·쿠폰·실결제·적립금·예치금·결제·환불·순매출)과 + 열별 차이가 같이 나온다. +- 결제합계의 상품구매금액 = 판매가 합계 − **품목 상품추가할인**(`items[].additional_discount_price`). 주문 금액(initial_order_amount)에는 + 이 할인이 없다(2026-09 실데이터: 카페24 상품구매금액이 100원 단위가 아닌 날만 결제합계가 그만큼 많았음, 예 9/23 +62). ### 연동 단계 체크리스트(쇼핑몰마다)