fix(performance): 카페24 환불합계를 일별 매출내역과 같게 — 적립금 환불 + 네이버페이 취소
실데이터 대조 결과 카페24 일별 매출 환불합계 =
환불 목록(실제 환불액 + 적립금·예치금 환불)
+ 환불 목록에 없는 취소·반품(네이버페이 취소 등, 품목 취소일 기준)
9/26: 178,220 + 1,080 + 96,500 = 275,800, 9/27: 145,000 + 55,800 = 200,800 일치.
- normalize_refund 금액에 적립금·예치금 환불 포함(refund_total)
- unrefunded_claims: orders date_type=cancel_date|return_complete_date 의 C40~43/R40~43
품목 중 앞뒤 60일 환불 목록에 없는 주문 → CANCEL/RETURN 사건(c24:{품목코드}-CL)
- 대조 화면 환불합계를 적용 규칙으로 표시 + "적용 규칙" 후보
- 테스트 추가
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -55,6 +55,10 @@ CLAIM_DATE_TYPES = (("cancel_complete_date", "취소완료"), ("cancel_date", "
|
||||
("return_complete_date", "반품완료"), ("exchange_complete_date", "교환완료"))
|
||||
CLAIM_DONE = frozenset({"C40", "C41", "C42", "C43", "R40", "R41", "R42", "R43", "E40"})
|
||||
UNPAID_CANCEL = frozenset({"C47", "C48", "C49"})
|
||||
# 환불 목록(/admin/refunds)에 없는 취소·반품(네이버페이 등) — 카페24 일별 매출 환불합계에는 들어간다(실데이터 확인)
|
||||
NO_RECORD_DATE_TYPES = ("cancel_date", "return_complete_date")
|
||||
NO_RECORD_DONE = frozenset({"C40", "C41", "C42", "C43", "R40", "R41", "R42", "R43"})
|
||||
REFUND_LOOKAROUND_DAYS = 60
|
||||
|
||||
# 카페24 자체몰 주문 채널 — market_id 는 외부 마켓만이 아니라 주문 채널·간편결제도 담는다
|
||||
# (실데이터 확인 2026-09-30: mobile=모바일웹, NCHECKOUT=네이버페이, KAKAOPAY=톡체크아웃).
|
||||
@@ -141,6 +145,11 @@ def order_total(order: dict[str, Any]) -> int:
|
||||
- sum(a[k] for k in DISCOUNT_FIELDS) - sum(a[k] for k in COUPON_FIELDS))
|
||||
|
||||
|
||||
def refund_total(refund: dict[str, Any]) -> int:
|
||||
"""환불합계 = 실제 환불액 + 적립금·예치금 환불."""
|
||||
return _won(refund.get("actual_refund_amount")) + _won(refund.get("used_points")) + _won(refund.get("used_credits"))
|
||||
|
||||
|
||||
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 {}
|
||||
@@ -314,6 +323,49 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
seen.add(oid)
|
||||
return {"items": items, "errors": errors, "full_cancel_shipping": full_cancel_shipping}
|
||||
|
||||
def unrefunded_claims(self, ctx: AdapterContext, start: date, end: date) -> list[dict[str, Any]]:
|
||||
"""환불 목록에 기록이 없는 취소·반품 완료 품목(네이버페이 취소 등). 날짜 = 품목 취소일(반품은 반품완료일).
|
||||
금액 = 판매가(+옵션)×수량 − 품목 할인·쿠폰. 앞뒤 60일 환불 목록(완료일·접수일)에 그 주문이 있으면 제외해
|
||||
환불 목록 쪽과 두 번 빼지 않는다."""
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
found: dict[str, dict[str, Any]] = {}
|
||||
for date_type in NO_RECORD_DATE_TYPES:
|
||||
for s, e in _chunks(start, end):
|
||||
for o in self._paged(ctx, "/admin/orders", "orders",
|
||||
{"start_date": s.isoformat(), "end_date": e.isoformat(),
|
||||
"date_type": date_type, "embed": "items"}, ORDER_LIMIT):
|
||||
oid = str(o.get("order_id") or "")
|
||||
for i in o.get("items") or []:
|
||||
status = str(i.get("order_status") or "")
|
||||
if status not in NO_RECORD_DONE:
|
||||
continue
|
||||
keys = (("cancel_date", "refund_date", "return_confirmed_date") if status[:1] == "C"
|
||||
else ("return_confirmed_date", "refund_date", "cancel_date"))
|
||||
day = next((d for d in (_day(i.get(k)) for k in keys) if d), None)
|
||||
if day is None or not (start <= day <= end):
|
||||
continue
|
||||
key = str(i.get("order_item_code") or f"{oid}-{i.get('item_no')}")
|
||||
qty = int(i.get("quantity") or 0)
|
||||
amount = ((_won(i.get("product_price")) + _won(i.get("option_price"))) * qty
|
||||
- _won(i.get("additional_discount_price")) - _won(i.get("coupon_discount_price"))
|
||||
- _won(i.get("app_item_discount_amount")))
|
||||
found[key] = {
|
||||
"order_id": oid, "item_code": key, "status": status, "day": day,
|
||||
"market_id": o.get("market_id"), "place_id": o.get("order_place_id"),
|
||||
"place_name": o.get("order_place_name"), "order_date": _day(o.get("order_date")),
|
||||
"quantity": qty, "amount": max(0, amount),
|
||||
"product_name": str(i.get("product_name") or "")[:40],
|
||||
"naver_pay_claim_status": str(i.get("naver_pay_claim_status") or ""),
|
||||
}
|
||||
if not found:
|
||||
return []
|
||||
lo = start - timedelta(days=REFUND_LOOKAROUND_DAYS)
|
||||
hi = max(end, min(end + timedelta(days=REFUND_LOOKAROUND_DAYS), today_kst()))
|
||||
refunded = {str(r.get("order_id") or "") for dt in ("refund_date", "accepted_refund_date")
|
||||
for r in self.refunds(ctx, lo, hi, dt)}
|
||||
return [c for c in found.values() if c["order_id"] not in refunded]
|
||||
|
||||
def market_ids(self, ctx: AdapterContext, refunds: list[dict[str, Any]]) -> dict[str, tuple[Any, Any, Any]]:
|
||||
"""환불의 원 주문 (market_id, order_place_id, order_place_name) — 주문일 60일 구간·100건씩 묶어 조회.
|
||||
못 찾으면 자체몰."""
|
||||
@@ -343,6 +395,8 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
for r in rows:
|
||||
mid, place, _name = markets.get(str(r.get("order_id")), ("self", None, None))
|
||||
yield {**r, "_market_id": mid, "_order_place_id": place}
|
||||
for c in self.unrefunded_claims(ctx, start, end):
|
||||
yield {**c, "_kind": "claim"}
|
||||
|
||||
def normalize_order(self, order: dict[str, Any]) -> list[SaleEvent]:
|
||||
"""결제 주문 → SALE. 자체몰은 카페24 열, 마켓 연동 주문은 해당 쇼핑몰 열(MARKET_MAP)."""
|
||||
@@ -368,12 +422,15 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
)]
|
||||
|
||||
def normalize_refund(self, refund: dict[str, Any]) -> list[SaleEvent]:
|
||||
"""환불 → CANCEL/RETURN(−). 원 주문의 market_id 로 결제와 같은 쇼핑몰 열에 넣는다."""
|
||||
"""환불 → CANCEL/RETURN(−). 원 주문의 market_id 로 결제와 같은 쇼핑몰 열에 넣는다.
|
||||
금액 = 실제 환불액 + 적립금·예치금 환불(카페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 = _won(refund.get("actual_refund_amount"))
|
||||
amount = refund_total(refund)
|
||||
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",
|
||||
@@ -387,6 +444,23 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
"quantity": refund.get("quantity"), "order_item_code": refund.get("order_item_code")},
|
||||
)]
|
||||
|
||||
def normalize_claim(self, c: dict[str, Any]) -> list[SaleEvent]:
|
||||
"""환불 목록에 없는 취소·반품 품목(네이버페이 등) → CANCEL/RETURN(−), 취소일(반품완료일)."""
|
||||
if not c.get("amount") or c.get("day") is None:
|
||||
return []
|
||||
is_return = str(c.get("status"))[:1] == "R"
|
||||
return [SaleEvent(
|
||||
marketplace_code=target_code(c.get("market_id"), c.get("place_id")),
|
||||
event_type="RETURN" if is_return else "CANCEL",
|
||||
external_event_id=f"{EVENT_PREFIX}{c['item_code']}-CL", external_order_id=str(c.get("order_id") or ""),
|
||||
external_line_id=str(c["item_code"]), order_date=c.get("order_date"), event_date=c["day"],
|
||||
amount=-int(c["amount"]), quantity=-int(c.get("quantity") or 0), product_name=c.get("product_name") or "",
|
||||
order_status="반품완료" if is_return else "취소완료",
|
||||
raw={"order_id": c.get("order_id"), "item_code": c["item_code"], "status": c.get("status"),
|
||||
"market_id": c.get("market_id"), "naver_pay_claim_status": c.get("naver_pay_claim_status"),
|
||||
"no_refund_record": True},
|
||||
)]
|
||||
|
||||
# ── 대조(설정 화면 "카페24 매출 대조") ─────────────────
|
||||
def reconcile(self, ctx: AdapterContext, day: date) -> dict[str, Any]:
|
||||
"""그날 결제 주문·환불을 항목별로 합산 — 카페24 일별 매출내역과 비교해 규칙을 확정하는 용도.
|
||||
@@ -465,8 +539,8 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
}
|
||||
rows = [r for r in self.refunds(ctx, day, day) if str(r.get("status") or "T") == "T"]
|
||||
markets = self.market_ids(ctx, rows)
|
||||
refunds = {"self": {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0},
|
||||
"market": {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0}}
|
||||
refunds = {k: {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0,
|
||||
"no_record_count": 0, "no_record": 0, "total": 0} for k in ("self", "market")}
|
||||
for r in rows:
|
||||
mid, place, place_name = markets.get(str(r.get("order_id")), ("self", None, None))
|
||||
ch = channel(mid, place, place_name)
|
||||
@@ -474,8 +548,18 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
g["count"] += 1
|
||||
for k in ("actual_refund_amount", "used_points", "used_credits"):
|
||||
g[k] += _won(r.get(k))
|
||||
g["total"] += refund_total(r)
|
||||
ch["refund_count"] += 1
|
||||
ch["refund_amount"] += _won(r.get("actual_refund_amount"))
|
||||
ch["refund_amount"] += refund_total(r)
|
||||
no_record = self.unrefunded_claims(ctx, day, day)
|
||||
for c in no_record:
|
||||
ch = channel(c["market_id"], c["place_id"], c["place_name"])
|
||||
g = refunds["self" if ch["target"] == "cafe24" else "market"]
|
||||
g["no_record_count"] += 1
|
||||
g["no_record"] += c["amount"]
|
||||
g["total"] += c["amount"]
|
||||
ch["refund_count"] += 1
|
||||
ch["refund_amount"] += c["amount"]
|
||||
channels_out = sorted(({**v, "names": sorted(v["names"])} for v in by_channel.values()),
|
||||
key=lambda v: v["total"], reverse=True)
|
||||
|
||||
@@ -555,7 +639,9 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
claimed = csum(lambda c: True)
|
||||
# 카페24 "환불합계" 후보 — 화면 값과 같은 줄을 찾는다(화면에서 값을 입력하면 강조)
|
||||
candidates = [
|
||||
{"key": "completed", "label": "환불완료일 · 실제 환불액 (현재 적용)", "amount": comp["actual_refund_amount"]},
|
||||
{"key": "applied", "label": "적용 규칙 · 환불 목록(실제 + 적립금·예치금) + 환불 목록 없는 취소·반품(네이버페이 등)",
|
||||
"amount": refunds["self"]["total"] + refunds["market"]["total"]},
|
||||
{"key": "completed", "label": "환불완료일 · 실제 환불액 (이전 규칙)", "amount": comp["actual_refund_amount"]},
|
||||
{"key": "completed_pts", "label": "환불완료일 · 실제 환불액 + 적립금·예치금", "amount": comp["with_points"]},
|
||||
{"key": "pay_date", "label": "결제일 기준 · 그날 결제 주문의 환불(오늘까지) · 실제 환불액",
|
||||
"amount": by_pay["actual_refund_amount"]},
|
||||
@@ -578,6 +664,9 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
"by_channel": channels_out, "refund_basis": refund_basis,
|
||||
"refund_list": sorted(refund_list.values(), key=lambda r: r["refund_code"]),
|
||||
"claims": claims, "refund_candidates": candidates,
|
||||
"no_record_claims": [{**c, "day": c["day"].isoformat(),
|
||||
"order_date": c["order_date"].isoformat() if c["order_date"] else None}
|
||||
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) +
|
||||
|
||||
@@ -239,4 +239,4 @@
|
||||
} | tojson }}</script>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/performance.js?v=20260930j" defer></script>{% endblock %}
|
||||
{% block scripts %}<script src="/static/performance.js?v=20260930k" defer></script>{% endblock %}
|
||||
|
||||
@@ -143,4 +143,4 @@
|
||||
</section>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/performance.js?v=20260930j" defer></script>{% endblock %}
|
||||
{% block scripts %}<script src="/static/performance.js?v=20260930k" defer></script>{% endblock %}
|
||||
|
||||
@@ -425,7 +425,7 @@ class _FakeCafe24(__import__("app.modules.performance.adapters.cafe24", fromlist
|
||||
if params.get("date_type") == "order_date": # 원 주문 market_id 조회
|
||||
ids = params["order_id"].split(",")
|
||||
return {"orders": [{"order_id": i, "market_id": self.lookup.get(i, "self")} for i in ids]}
|
||||
if params.get("date_type", "").endswith("_complete_date"):
|
||||
if params.get("date_type", "").endswith("_complete_date") or params.get("date_type") == "cancel_date":
|
||||
return {"orders": self.claims.get(params["date_type"], []) if idx == 0 else []}
|
||||
return {"orders": self.orders_pages[idx] if idx < len(self.orders_pages) else []}
|
||||
|
||||
@@ -549,6 +549,50 @@ def test_cafe24_normalize_matches_daily_report():
|
||||
assert calls[1]["offset"] == 1000 and all(c["limit"] == 1000 and c["date_type"] == "pay_date" for c in calls)
|
||||
|
||||
|
||||
def test_cafe24_refund_total_includes_points_and_naverpay_cancels():
|
||||
"""카페24 일별 매출 환불합계 = 환불 목록(실제 + 적립금·예치금) + 환불 목록에 없는 취소·반품(네이버페이 등).
|
||||
실데이터: 9/26 = 178,220 + 1,080 + 네이버페이 취소 96,500 = 275,800, 9/27 = 145,000 + 네이버페이 55,800."""
|
||||
import app.timezone as _tz
|
||||
from app.modules.performance.adapters.base import AdapterContext
|
||||
|
||||
ctx = AdapterContext(code="cafe24", credentials=None)
|
||||
item = lambda code, st, price, qty=1, day="2026-09-26 15:00:00", **kw: {
|
||||
"order_item_code": code, "order_status": st, "quantity": qty, "product_price": f"{price}.00",
|
||||
"option_price": "0.00", "product_name": "상품", "cancel_date": day, **kw}
|
||||
refund = {**_c24_refund("C20260926-01", "O1", 63_720), "used_points": "1080.00",
|
||||
"refund_date": "2026-09-26T20:25:08+09:00"}
|
||||
fake = _FakeCafe24([[]], [[refund]], claims={
|
||||
"cancel_date": [
|
||||
{**_c24_order("O1"), "items": [item("O1-01", "C40", 64_800)]}, # 환불 목록 있음 → 제외
|
||||
{**_c24_order("NP1", market="NCHECKOUT"), "items": [item("NP1-01", "C40", 55_800),
|
||||
item("NP1-02", "N40", 9_000)]}, # 정상 품목 제외
|
||||
{**_c24_order("NP2", market="NCHECKOUT"), "items": [item("NP2-01", "C40", 20_000, 2,
|
||||
coupon_discount_price="1000.00")]},
|
||||
{**_c24_order("NP3", market="NCHECKOUT"), "items": [item("NP3-01", "C40", 5_000, day="2026-09-27 01:00:00")]},
|
||||
{**_c24_order("NP4", market="NCHECKOUT"), "items": [item("NP4-01", "C00", 5_000)]}, # 취소신청만 → 제외
|
||||
],
|
||||
"return_complete_date": [{**_c24_order("NP1", market="NCHECKOUT"), "items": [item("NP1-01", "C40", 55_800)]}],
|
||||
})
|
||||
orig, _tz.today_kst = _tz.today_kst, (lambda: date(2026, 9, 29))
|
||||
try:
|
||||
_, events = fake.collect(ctx, date(2026, 9, 26), date(2026, 9, 26))
|
||||
rec = fake.reconcile(ctx, date(2026, 9, 26))
|
||||
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: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) # 판매가×수량 − 품목 쿠폰
|
||||
assert set(by) == {"c24:C20260926-01", "c24:NP1-01-CL", "c24:NP2-01-CL"} # 다른 날·신청·환불 기록 있는 주문 제외
|
||||
rs = rec["refunds"]["self"]
|
||||
assert rs["no_record_count"] == 2 and rs["no_record"] == 55_800 + 39_000
|
||||
assert rs["total"] == 63_720 + 1_080 + 55_800 + 39_000
|
||||
cand = {c["key"]: c["amount"] for c in rec["refund_candidates"]}
|
||||
assert cand["applied"] == rs["total"]
|
||||
assert {c["item_code"] for c in rec["no_record_claims"]} == {"NP1-01", "NP2-01"}
|
||||
|
||||
|
||||
def test_cafe24_scope_and_replace_range():
|
||||
import app.modules.performance.sync as syncmod
|
||||
from app.modules.performance.adapters.base import AdapterContext
|
||||
|
||||
Reference in New Issue
Block a user