diff --git a/app/modules/performance/CLAUDE.md b/app/modules/performance/CLAUDE.md index 9b3bbe0..87d5355 100644 --- a/app/modules/performance/CLAUDE.md +++ b/app/modules/performance/CLAUDE.md @@ -20,6 +20,12 @@ - 1단계는 모의 데이터(`is_sample`)·구조까지, 실제 수집은 쇼핑몰별로 공식 문서 확인 후 순차 구현. - 쇼핑몰 화면 수치와 맞출 때는 필드 추측 말고 붙여넣기 비교 + 원본 필드 합계로 진단부터. +## 카페24 적립금 · 네이버 배송비·환불 (2026-10-19 규칙 변경) + +- **카페24** 매출 = 결제합계 − 적립금 사용, 환불 = 실제 + 예치금(적립금 환불 제외). raw `points`. 주문 내역 창 **적립금 사용** 칸·합계. +- **네이버** 매출 = 판매금액(총) + 배송비(raw `goods`·`ship`), 환불 = 클레임 완료일(`CLAIM_COMPLETED_DATETIME`) 조회의 취소·반품 완료 상품주문 −결제금액(`naver:{상품주문}-RF`, raw `refund`). 주문 내역 창 **배송비·환불금액** 칸·합계. +- 예전 규칙으로 받은 날은 [과거 매출 가져오기]로 다시 받아야 바뀜(최근 10일은 자동). 사용자 확인값 10/18: 카페24 적립금 16,820 · 네이버 배송비 87,500 · 환불 66,100 — 배포 뒤 대조. + ## 매출 업데이트 - 진행 창에서 쇼핑몰별 [중지](그 쇼핑몰만 멈추고 다음 쇼핑몰로). diff --git a/app/modules/performance/adapters/cafe24.py b/app/modules/performance/adapters/cafe24.py index 3c3d4b1..87e51ad 100644 --- a/app/modules/performance/adapters/cafe24.py +++ b/app/modules/performance/adapters/cafe24.py @@ -488,23 +488,27 @@ class Cafe24Adapter(MarketplaceAdapter): marketplace_code=target, event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}-PAY", external_order_id=oid, order_date=_day(order.get("order_date")), payment_date=pay_day, event_date=pay_day, - amount=max(0, order_total(order)), product_name=name, + # 적립금 사용분은 매출에서 뺀다(2026-10-19 사용자 요청) — 결제합계 − 적립금(points_spent_amount) + amount=max(0, order_total(order) - order_amounts(order)["points_spent_amount"]), 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), 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()}}, + "items": len(items), **{f"initial_{k}": v for k, v in order_amounts(order).items()}, + "points": order_amounts(order)["points_spent_amount"], "points_excluded": True}, )] def normalize_refund(self, refund: dict[str, Any]) -> list[SaleEvent]: """환불 → CANCEL/RETURN(−). 원 주문의 market_id 로 결제와 같은 쇼핑몰 열에 넣는다. - 금액 = 실제 환불액 + 적립금·예치금 환불(카페24 일별 매출 환불합계와 같음, 실데이터 확인).""" + 금액 = 실제 환불액 + 예치금 환불 — 적립금으로 돌려준 금액은 뺀다(2026-10-19, 결제에서 적립금을 빼므로 앞뒤를 맞춤. + 예전 = 카페24 일별 매출 환불합계와 같은 실제 + 적립금·예치금).""" if refund.get("_kind") == "claim": return self.normalize_claim(refund) day = _day(refund.get("refund_date")) code = str(refund.get("refund_code") or "") if day is None or not code: return [] - amount = refund_total(refund) + points = _won(refund.get("used_points")) + amount = refund_total(refund) - points return [SaleEvent( marketplace_code=target_code(refund.get("_market_id"), refund.get("_order_place_id")), event_type="RETURN" if code.upper().startswith("R") else "CANCEL", @@ -515,7 +519,8 @@ class Cafe24Adapter(MarketplaceAdapter): raw={"refund_code": code, "order_id": refund.get("order_id"), "status": refund.get("status"), "actual_refund_amount": refund.get("actual_refund_amount"), "used_points": refund.get("used_points"), "used_credits": refund.get("used_credits"), - "quantity": refund.get("quantity"), "order_item_code": refund.get("order_item_code")}, + "quantity": refund.get("quantity"), "order_item_code": refund.get("order_item_code"), + "points": -points, "points_excluded": True}, )] def normalize_claim(self, c: dict[str, Any]) -> list[SaleEvent]: diff --git a/app/modules/performance/adapters/naver.py b/app/modules/performance/adapters/naver.py index 88eb51a..13b50f7 100644 --- a/app/modules/performance/adapters/naver.py +++ b/app/modules/performance/adapters/naver.py @@ -13,9 +13,12 @@ ?from=…&to=…&rangeType=PAYED_DATETIME&pageSize=&page= — 결제일 기준, 한 번에 24시간까지(하루씩 부른다), from 부터 180일 안의 주문만. 응답에 주문·상품주문 상세가 바로 들어 있다(네이버 안내: 소량·조회용 권장 API). - SALE = 주문 하나(`naver:{orderId}`), 날짜 = 결제일(order.paymentDate). - 금액 = 상품주문들의 결제금액(productOrder.totalPaymentAmount) 합 — 배송비 제외. + 금액 = 상품주문들의 결제금액(productOrder.totalPaymentAmount) 합 **+ 배송비**(deliveryFeeAmount − deliveryDiscountAmount, + 2026-10-19 사용자 요청 — 예전엔 배송비 제외 = 판매금액(총)). raw = {goods: 상품 결제금액, ship: 배송비}. - 결제 뒤 취소·반품된 상품주문도 결제일 매출에 그대로 둔다(판매금액(총)). 입금대기·미입금 취소만 뺀다. - 그래서 지난 날짜 매출이 나중에 줄지 않는다. 환불(판매금액(순))은 아직 따로 만들지 않는다. + - **환불 = 환불된 날(클레임 완료일)에 뺀다**(2026-10-19): 같은 조회를 rangeType=CLAIM_COMPLETED_DATETIME 으로 하루씩 — + 그날 취소·반품 완료(CANCELED·RETURNED)된 상품주문마다 CANCEL/RETURN(`naver:{productOrderId}-RF`), 금액 = −totalPaymentAmount. + 판매분석의 환불금액처럼 결제일이 아니라 환불일 매출에서 빠진다. - 구매자 이름·연락처·주소는 저장하지 않는다. """ @@ -201,6 +204,22 @@ def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dic return orders +def refund_items(items: Iterable[dict[str, Any]], day: date) -> list[dict[str, Any]]: + """클레임 완료일 조회 결과 → 환불 줄(상품주문 하나 = 한 줄). 취소·반품 완료만, 금액 = 그 상품주문 결제금액.""" + out = [] + for c in items: + po, od = c.get("productOrder") or {}, c.get("order") or {} + status = str(po.get("productOrderStatus") or "") + if status not in CLAIMED_STATUS: + continue + out.append({"product_order_id": str(po.get("productOrderId") or c.get("productOrderId") or ""), + "order_id": str(od.get("orderId") or po.get("orderId") or ""), "day": day, "status": status, + "amount": _won(po.get("totalPaymentAmount")), "qty": _won(po.get("quantity")), + "name": str(po.get("productName") or ""), "opt": str(po.get("productOption") or ""), + "order_day": _day(od.get("orderDate")), "pay_day": _day(od.get("paymentDate") or po.get("paymentDate"))}) + return out + + # 토큰을 발급한 인증정보 — 이 값들이 바뀌면 저장된 토큰을 쓰지 않고 새로 받는다(credential_fingerprint) TOKEN_KEYS = ("client_id", "client_secret", "account_id") @@ -335,11 +354,12 @@ class NaverAdapter(MarketplaceAdapter): return body raise ApiError("네이버 API 호출 제한(429)이 계속됩니다. 잠시 뒤 다시 시도하세요.") - def _day_items(self, ctx: AdapterContext, d: date) -> list[dict[str, Any]]: - """결제일이 d(한국 시간 0시~23:59:59.999)인 상품주문 전체 — 모든 상태.""" + def _day_items(self, ctx: AdapterContext, d: date, range_type: str = "PAYED_DATETIME") -> list[dict[str, Any]]: + """기준일(range_type — 결제일 PAYED_DATETIME · 클레임 완료일 CLAIM_COMPLETED_DATETIME)이 d(한국 시간 0시~23:59:59.999)인 + 상품주문 전체 — 모든 상태.""" params: dict[str, Any] = { "from": f"{d.isoformat()}T00:00:00.000+09:00", "to": f"{d.isoformat()}T23:59:59.999+09:00", - "rangeType": "PAYED_DATETIME", "pageSize": PAGE_SIZE, + "rangeType": range_type, "pageSize": PAGE_SIZE, } out: list[dict[str, Any]] = [] for page in range(1, MAX_PAGES + 1): @@ -352,8 +372,9 @@ class NaverAdapter(MarketplaceAdapter): raise ApiError(f"네이버 {d.isoformat()} 주문이 {MAX_PAGES}쪽을 넘어 끝까지 받지 못했습니다 — 저장하지 않았습니다.") return out - def _items(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]: - ctx.progress.plan((end - start).days + 1, "일") # 진행 막대: 하루 = 한 단계 + def _items(self, ctx: AdapterContext, start: date, end: date, *, plan: tuple[int, str] | None = None) -> Iterable[dict[str, Any]]: + days = (end - start).days + 1 + ctx.progress.plan(*(plan or (days, "일"))) # 진행 막대: 하루 = 한 단계(매출 업데이트는 결제 + 환불 조회 = 하루 두 단계) d = start while d <= end: rows = self._day_items(ctx, d) @@ -363,7 +384,30 @@ class NaverAdapter(MarketplaceAdapter): # ── 수집 ────────────────────────────────────────────── def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]: - yield from group_orders(self._items(ctx, start, end), start, end).values() + days = (end - start).days + 1 + yield from group_orders(self._items(ctx, start, end, plan=(days * 2, "일 조회")), start, end).values() + + def fetch_refunds(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]: + """환불 — 클레임 완료일이 그날인 상품주문 중 취소·반품 완료(CANCELED·RETURNED)된 것(2026-10-19). 교환·미입금 취소는 아님.""" + d = start + while d <= end: + rows = self._day_items(ctx, d, "CLAIM_COMPLETED_DATETIME") + ctx.progress.step(items=len(rows)) + yield from refund_items(rows, d) + d += timedelta(days=1) + + def normalize_refund(self, r: dict[str, Any]) -> list[SaleEvent]: + if not r.get("amount") or not r.get("product_order_id"): + return [] + is_return = r.get("status") == "RETURNED" + return [SaleEvent( + event_type="RETURN" if is_return else "CANCEL", external_event_id=f"{EVENT_PREFIX}{r['product_order_id']}-RF", + external_order_id=str(r.get("order_id") or r["product_order_id"]), external_line_id=str(r["product_order_id"]), + order_date=r.get("order_day"), payment_date=r.get("pay_day"), event_date=r["day"], amount=-int(r["amount"]), + product_name=str(r.get("name") or "")[:200], option_name=str(r.get("opt") or "")[:200], + quantity=-int(r.get("qty") or 0), order_status="반품완료" if is_return else "취소완료", + raw={"product_order_id": r["product_order_id"], "status": r.get("status"), "refund": int(r["amount"])}, + )] def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]: oid, day = str(o.get("orderId") or ""), o.get("_day") @@ -372,9 +416,12 @@ class NaverAdapter(MarketplaceAdapter): names = o.get("names") or [] name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else "" statuses = [STATUS_KO.get(s, s) for s in o.get("statuses") or []] + goods, ship = max(0, int(o.get("amount") or 0)), max(0, int(o.get("ship") or 0)) return [SaleEvent( event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}", external_order_id=oid, - order_date=o.get("order_day"), payment_date=day, event_date=day, amount=max(0, int(o.get("amount") or 0)), + # 판매금액(총) + 배송비(2026-10-19) — 환불은 환불일에 따로(fetch_refunds) + order_date=o.get("order_day"), payment_date=day, event_date=day, amount=goods + ship, + raw={"goods": goods, "ship": ship}, product_name=name[:200], option_name=str(o.get("opt") or "")[:200], quantity=int(o.get("qty") or 0), discount_amount=max(0, int(o.get("discount") or 0)), order_status="/".join(statuses)[:50], )] diff --git a/app/modules/performance/db.py b/app/modules/performance/db.py index 1fd9df0..12efbec 100644 --- a/app/modules/performance/db.py +++ b/app/modules/performance/db.py @@ -494,12 +494,23 @@ class PerformanceDBStore: rows = conn.execute( "SELECT id, event_type, external_order_id, external_line_id, order_date, payment_date, " " event_date, sales_date, product_name, option_name, quantity, amount, " - " discount_amount, order_status, is_sample " + " discount_amount, order_status, is_sample, " + # 주문 내역 칸(2026-10-19) — 카페24 적립금(결제 +, 환불 −) · 네이버 배송비 · 네이버 환불금액(raw_data 의 숫자만) + " raw_data ->> 'points' AS points, raw_data ->> 'ship' AS ship, raw_data ->> 'refund' AS refund " "FROM perf_sales_events WHERE marketplace_code = %s AND sales_date BETWEEN %s AND %s " "ORDER BY sales_date, external_order_id, event_type LIMIT %s", (code, start, end, limit), ).fetchall() - return [{k: _iso(v) for k, v in r.items()} for r in rows] + out = [] + for r in rows: + row = {k: _iso(v) for k, v in r.items()} + for k in ("points", "ship", "refund"): + try: + row[k] = int(round(float(row[k]))) if row.get(k) not in (None, "") else None + except (TypeError, ValueError): + row[k] = None + out.append(row) + return out def sample_count(self) -> int: with self._pool.connection() as conn: diff --git a/app/modules/performance/templates/performance/ads.html b/app/modules/performance/templates/performance/ads.html index e2ac119..3757af8 100644 --- a/app/modules/performance/templates/performance/ads.html +++ b/app/modules/performance/templates/performance/ads.html @@ -1,6 +1,6 @@ {% extends "erp_base.html" %} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {#- ROAS 덧붙임 — "광고비(ROAS%)". 광고비가 없으면 아무것도 안 붙는다. -#} {%- macro roas(p) -%}{%- if p is not none -%}({{ "{:,}".format(p) }}%){%- endif -%}{%- endmacro -%} @@ -224,4 +224,4 @@ } | tojson }} {% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/performance/templates/performance/index.html b/app/modules/performance/templates/performance/index.html index c3959ac..704b854 100644 --- a/app/modules/performance/templates/performance/index.html +++ b/app/modules/performance/templates/performance/index.html @@ -1,6 +1,6 @@ {% extends "erp_base.html" %} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {%- macro won(v) -%} {%- if v is none -%} @@ -266,4 +266,4 @@ } | tojson }} {% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/performance/templates/performance/settings.html b/app/modules/performance/templates/performance/settings.html index c6f028c..7fe6bd1 100644 --- a/app/modules/performance/templates/performance/settings.html +++ b/app/modules/performance/templates/performance/settings.html @@ -1,6 +1,6 @@ {% extends "erp_base.html" %} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {%- macro when(v) -%}{{ (v or '')[:16] | replace('T', ' ') or '—' }}{%- endmacro -%} @@ -219,4 +219,4 @@ {% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/performance/tests/test_performance.py b/app/modules/performance/tests/test_performance.py index ea438e4..0c3e9f9 100644 --- a/app/modules/performance/tests/test_performance.py +++ b/app/modules/performance/tests/test_performance.py @@ -909,7 +909,7 @@ def test_cafe24_refund_total_includes_points_and_naverpay_cancels(): finally: _tz.today_kst = orig by = {e.external_event_id: e for e in events if e.event_type != "SALE"} - assert by["c24:C20260926-01"].amount == -(63_720 + 1_080) # 적립금 환불 포함 + assert by["c24:C20260926-01"].amount == -63_720 # 적립금 환불(1,080)은 뺀다(2026-10-19 — 매출도 적립금 제외) assert by["c24:NP1-01-CL"].amount == -55_800 and by["c24:NP1-01-CL"].event_type == "CANCEL" assert by["c24:NP1-01-CL"].event_date == date(2026, 9, 26) and by["c24:NP1-01-CL"].marketplace_code == "cafe24" assert by["c24:NP2-01-CL"].amount == -(40_000 - 1_000 + 3_000) # 판매가×수량 − 품목 쿠폰 + 전체취소 배송비 @@ -975,7 +975,8 @@ def test_cafe24_paid_total_matches_daily_report(): o["initial_order_amount"].update(payment_amount="42938.00", points_spent_amount="1000.00") assert order_total(o) == 42_938 + 1_000 + 3_000 == 46_938 ev = _FakeCafe24([]).normalize_order(o)[0] - assert ev.amount == 46_938 and ev.discount_amount == 1_000 + 5_000 + assert ev.amount == 46_938 - 1_000 and ev.discount_amount == 1_000 + 5_000 # 매출 = 결제합계 − 적립금(2026-10-19) + assert ev.raw["points"] == 1_000 and ev.raw["points_excluded"] o["actual_order_amount"] = {**o["initial_order_amount"], "payment_amount": "20000.00"} assert order_total_now(o) == 20_000 + 1_000 + 3_000 z = _c24_order("Z") @@ -1509,7 +1510,16 @@ def test_naver_collect_sales(): } calls = [] + refunds = { # 클레임 완료일 기준 조회 — 9/10 에 B1(9/9 결제) 취소 완료·C2 반품 완료, 교환은 환불 아님 + "2026-09-10": [_naver_item("B", "B1", "2026-09-09", 9900, status="CANCELED"), + _naver_item("C", "C2", "2026-09-10", 7000, status="RETURNED"), + _naver_item("E", "E1", "2026-08-30", 3000, status="EXCHANGED")]} + def get(url, params=None, headers=None, timeout=None): + if params["rangeType"] == "CLAIM_COMPLETED_DATETIME": + calls.append(("claim", params["from"][:10])) + return httpx.Response(200, json={"data": {"contents": refunds.get(params["from"][:10], []), + "pagination": {"page": params["page"], "hasNext": False}}}) key = (params["from"][:10], params["page"]) calls.append(key) rows, more = pages.get(key, ([], False)) @@ -1530,12 +1540,17 @@ def test_naver_collect_sales(): httpx.post, httpx.get, nv.CALL_INTERVAL_SEC = orig assert r["ok"], r ev_ = {k[2]: v for k, v in st.events.items() if k[0] == "naver"} - assert set(ev_) == {"naver:A", "naver:B", "naver:C"} # D 미입금취소만 제외 - assert ev_["naver:A"]["amount"] == 20000 + 5000 # 배송비 제외 + assert set(ev_) == {"naver:A", "naver:B", "naver:C", "naver:B1-RF", "naver:C2-RF"} # D 미입금취소만 제외, 교환은 환불 아님 + assert ev_["naver:A"]["amount"] == 20000 + 5000 + 3000 + 3000 # 판매금액 + 배송비(2026-10-19) + assert ev_["naver:A"]["raw"] == {"goods": 25000, "ship": 6000} assert ev_["naver:B"]["amount"] == 9900 # 결제 뒤 취소도 결제일 매출(판매금액(총)) + # 환불은 환불된 날(클레임 완료일)에 뺀다 — 결제일(9/9)이 아니라 9/10 + assert (ev_["naver:B1-RF"]["amount"], ev_["naver:B1-RF"]["sales_date"], ev_["naver:B1-RF"]["event_type"]) == (-9900, date(2026, 9, 10), "CANCEL") + assert (ev_["naver:C2-RF"]["amount"], ev_["naver:C2-RF"]["event_type"], ev_["naver:C2-RF"]["raw"]["refund"]) == (-7000, "RETURN", 7000) + assert ("claim", "2026-09-09") in calls and ("claim", "2026-09-10") in calls assert ev_["naver:A"]["quantity"] == 3 and ev_["naver:A"]["discount_amount"] == 1000 assert ev_["naver:A"]["sales_date"] == date(2026, 9, 9) and ev_["naver:A"]["product_name"] == "밀폐용기 외 1건" - assert ev_["naver:C"]["amount"] == 15000 + 7000 # 반품 줄도 포함 + assert ev_["naver:C"]["amount"] == 15000 + 7000 # 반품 줄도 포함(배송비 3,000 − 할인 3,000 = 0) assert ev_["naver:C"]["order_status"] == "구매확정/반품" assert ("2026-09-09", 2) in calls and ("2026-09-10", 2) not in calls # hasNext 일 때만 다음 쪽 assert "홍길동" not in repr(st.events) and "010-1234-5678" not in repr(st.events) @@ -1598,6 +1613,8 @@ def test_sync_job_progress(): def get(url, params=None, headers=None, timeout=None): day = params["from"][:10] + if params["rangeType"] != "PAYED_DATETIME": # 환불(클레임 완료일) 조회 — 이 테스트엔 없음 + return httpx.Response(200, json={"data": {"contents": [], "pagination": {"hasNext": False}}}) if day == "2026-09-10": # 둘째 날을 받는 중 — 진행 상황 중간 모습 mid.update(job.snapshot()) rows = [_naver_item("A" + day, "P" + day, day, 10000), _naver_item("B" + day, "Q" + day, day, 5000)] @@ -1618,14 +1635,15 @@ def test_sync_job_progress(): job.finish(last_update_at="2026-09-30T10:00:00") m = {s["code"]: s for s in mid["shops"]} - assert m["naver"]["state"] == "running" and (m["naver"]["done"], m["naver"]["total"], m["naver"]["unit"]) == (1, 2, "일") - assert m["naver"]["items"] == 2 and m["naver"]["fraction"] == 0.5 - assert mid["overall"]["shops"] == 1 and mid["overall"]["fraction"] == 0.5 and not mid["finished"] + # 네이버 = 하루에 결제·환불 두 번 조회(2026-10-19) — 2일 = 4단계 + assert m["naver"]["state"] == "running" and (m["naver"]["done"], m["naver"]["total"], m["naver"]["unit"]) == (1, 4, "일 조회") + assert m["naver"]["items"] == 2 and m["naver"]["fraction"] == 0.25 + assert mid["overall"]["shops"] == 1 and mid["overall"]["fraction"] == 0.25 and not mid["finished"] snap = job.snapshot() s = {x["code"]: x for x in snap["shops"]} assert s["naver"]["state"] == "done" and s["naver"]["upserted"] == 4 and s["naver"]["items"] == 4 - assert s["naver"]["done"] == s["naver"]["total"] == 2 and s["naver"]["fraction"] == 1.0 + assert s["naver"]["done"] == s["naver"]["total"] == 4 and s["naver"]["fraction"] == 1.0 assert s["ohouse"]["state"] == "error" and s["ohouse"]["status"] in ("not_implemented", "not_configured") assert not s["ohouse"]["active"] assert s["elevenst"]["state"] == "error" and s["elevenst"]["status"] == "not_configured" and not s["elevenst"]["active"] diff --git a/app/static/performance.css b/app/static/performance.css index 5440bfc..61e0f7b 100644 --- a/app/static/performance.css +++ b/app/static/performance.css @@ -366,3 +366,7 @@ td.is-link:hover { background: #eef2ff; text-decoration: underline; } .perf-opt-row { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; } .perf-opt-label { font-weight: 600; } .perf-head-notes { display: inline-flex; align-items: center; gap: 12px; margin-right: auto; margin-left: 12px; font-size: 12px; } +/* 주문 내역 추가 칸(카페24 적립금 · 네이버 배송비·환불금액, 2026-10-19) */ +.perf-ev-table .perf-ev-x { white-space: nowrap; color: #6b4e00; } +.perf-ev-xsub { font-size: 11px; font-weight: 500; color: var(--color-midtone-gray, #777); } +.perf-ev-table tfoot .perf-ev-x, .perf-ev-table tfoot .perf-ev-xsub { color: inherit; } diff --git a/app/static/performance.js b/app/static/performance.js index 5cf2014..5736349 100644 --- a/app/static/performance.js +++ b/app/static/performance.js @@ -653,29 +653,51 @@ const rows = res.rows || []; if (!rows.length) { m.body.innerHTML = '
내역이 없습니다.
'; return; } const KIND = { SALE: "결제", CANCEL: "취소", RETURN: "반품", ADJUST: "조정" }; + // 쇼핑몰별 추가 칸(2026-10-19) — 카페24 적립금 사용(매출에서 뺀 금액, 환불 줄은 돌려준 적립금 −), + // 네이버 배송비(매출에 더한 금액)·환불금액(환불된 날 매출에서 뺀 금액). 맨 아래 합계. + const EXTRA = { cafe24: [{ key: "points", label: "적립금 사용" }], + naver: [{ key: "ship", label: "배송비" }, { key: "refund", label: "환불금액" }] }[code] || []; + const xsum = EXTRA.map(function () { return { plus: 0, minus: 0 }; }); let sum = 0, sales = 0, minus = 0; const body = rows.map(function (r) { sum += r.amount; if (r.amount >= 0) sales += r.amount; else minus += r.amount; + const xcells = EXTRA.map(function (x, k) { + const v = r[x.key]; + if (v == null || v === 0) return '| 매출일 | 구분 | 주문번호 | ' + - '상품명 | 수량 | 금액 | 주문일 | ' + + '상품명 | 수량 | 금액 | ' + + EXTRA.map(function (x) { return '' + esc(x.label) + " | "; }).join("") + + '주문일 | ' + '결제일 | 상태 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 결제 ' + fmt(sales) + - " / 취소·반품 " + fmt(minus) + ' | ' + fmt(sum) + ' | ||||||||||||
처음 500건만 표시합니다.
' : "") + - '수수료는 일·쇼핑몰 단위로 계산되어 주문별로는 표시하지 않습니다.
'; + '수수료는 일·쇼핑몰 단위로 계산되어 주문별로는 표시하지 않습니다.' + + (code === "cafe24" ? " 금액은 적립금 사용분을 뺀 값입니다(환불도 적립금으로 돌려준 금액은 뺌)." : "") + + (code === "naver" ? " 결제 금액은 판매금액 + 배송비, 환불은 환불된 날에 빠집니다." : "") + + " 적립금·배송비 칸이 비어 있으면 규칙을 바꾸기 전에 받은 자료입니다 — 실적 설정 → 과거 매출 가져오기로 그 기간을 다시 받으세요.
"; } catch (err) { m.body.innerHTML = '' + esc(err.message) + "
"; } diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index a7e0346..39230c0 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -40,6 +40,13 @@ **카페24 관리자 "일별 매출내역"과 같은 기준**으로 센다(처음의 품목 결제금액 방식은 배송비가 빠지고 환불 날짜 기준이 달라 화면과 맞지 않아 교체). +> **2026-10-19 규칙 변경 — 적립금 제외**(사용자 요청): 매출(SALE) = 결제합계 **− 적립금 사용**(`initial_order_amount.points_spent_amount`), +> 환불 = 실제 환불액 + 예치금 환불(**적립금으로 돌려준 `used_points` 는 뺌** — 결제에서 뺐으니 앞뒤를 맞춤, 사용자 선택). +> 그래서 카페24 열은 이제 카페24 일별 매출내역의 결제합계·환불합계보다 적립금만큼 작다(아래 표·대조 설명은 그 전 기준). +> 사건 raw 에 `points`(결제 = 사용 적립금, 환불 = −돌려준 적립금)·`points_excluded: true`. 주문 내역 창에 **적립금 사용** 칸 + 합계 +> (맨 아래 = 결제 쪽 합, 환불이 있으면 "환불 −n" 따로). 사용자 확인값: 10/18 적립금 사용 16,820원. +> 규칙을 바꾸기 전에 받은 날은 [과거 매출 가져오기]로 다시 받아야 바뀐다(최근 10일은 자동 업데이트가 다시 받음). + | 사건 | 조회 | 금액·날짜 | |---|---|---| | SALE(결제합계) | `GET /admin/orders` `date_type=pay_date`, `embed=items`, `paid=T` | +(실결제금액 + 적립금 + 예치금 + 네이버포인트), `initial_order_amount` + 주문 `naver_point`(결제 당시 금액 — 환불을 따로 빼므로 취소 후 금액 X), 결제일. 주문 1건 = 사건 1건(`{order_id}-PAY`) | @@ -122,6 +129,15 @@ 할인 = `productDiscountAmount` 합. 결제 뒤 취소·반품(`CANCELED`·`RETURNED`)도 포함, 입금대기·미입금 취소만 뺀다 → 지난 날짜 매출이 나중에 줄지 않는다. `replace_range`. - 환불(판매금액(순))은 아직 사건으로 만들지 않는다 — 필요하면 클레임 완료일 기준 CANCEL/RETURN 을 추가. + - **2026-10-19 규칙 변경**(사용자 요청 — "판매금액에 배송비는 추가하고 환불 금액은 빼 주세요", 환불은 환불된 날): + SALE 금액 = 판매금액(총) **+ 배송비**(상품주문 `deliveryFeeAmount − deliveryDiscountAmount` 합, 주문마다 0 미만이면 0), + raw `{goods, ship}`. 환불 = 같은 조회를 `rangeType=CLAIM_COMPLETED_DATETIME` 으로 하루씩 다시 불러(매출 업데이트는 하루 2번 조회 — + 진행 막대 단위 "일 조회") 그날 클레임이 끝난 상품주문 중 **CANCELED·RETURNED**(교환·미입금 취소 제외)마다 + CANCEL/RETURN `naver:{productOrderId}-RF`, 금액 = −`totalPaymentAmount`(상품 결제금액, 배송비 환불은 넣지 않음), 날짜 = 환불(클레임 완료)일, + raw `{refund}`. 그래서 네이버 열 = 판매금액(총) + 배송비 − 환불금액(환불일). 주문 내역 창에 **배송비·환불금액** 칸 + 합계. + 사용자 확인값: 10/18 배송비 87,500원·환불 66,100원 — 배포 뒤 10/18 주문 내역 맨 아래 합계와 비교해 맞는지 확인할 것 + (환불이 다르면 배송비 환불·클레임 종류 포함 여부를 실데이터로 조정). `replace_range` 라 다시 받으면 그 기간 환불도 교체. + 네이버는 조회 시작일 180일 제한이 있어 그보다 오래된 날은 다시 받을 수 없다(예전 규칙 그대로 남음). - 설정 화면 **"쇼핑몰 원본 데이터 확인"**(네이버 선택): 결제일 기준 상품주문 전체의 항목별 합계, 상태별 합계, 날짜별 매출·그중 결제 뒤 취소/반품(참고)·배송비(참고). 개인정보(주문자·수령인·주소·연락처·메모)는 값 없이 이름만.