feat(performance): 카페24 매출 대조 — 환불합계 후보·환불 건별·취소/반품 완료 품목

9/26 은 결제합계가 카페24와 같고 환불만 97,580 모자라며 완료일·접수일·적립금
어느 기준으로도 맞지 않아, 환불 API 에 빠진 건을 찾는 진단을 추가.
- 환불합계 후보 표: 카페24 화면 값을 입력하면 같은 줄 강조
- 환불 건별 목록(완료일·접수일 기준 합침, 계좌 등 개인정보 제외)
- 그날 취소/반품/교환 완료 품목(orders date_type=*_complete_date, embed=items)
  품목 판매가·결제금액·쿠폰·환불 기록 유무

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-29 17:44:21 +09:00
parent a19c1f4cab
commit 370834b58b
7 changed files with 199 additions and 6 deletions
+107
View File
@@ -50,6 +50,12 @@ MAX_OFFSET = 15000
CHUNK_DAYS = 60
EVENT_PREFIX = "c24:"
# 매출 대조 전용 — 클레임 완료 주문 조회 날짜 유형과 "완료" 상태(입금전취소 C47~49 는 결제 전이라 제외)
CLAIM_DATE_TYPES = (("cancel_complete_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"})
# 카페24 자체몰 주문 채널 — market_id 는 외부 마켓만이 아니라 주문 채널·간편결제도 담는다
# (실데이터 확인 2026-09-30: mobile=모바일웹, NCHECKOUT=네이버페이, KAKAOPAY=톡체크아웃).
# 이 주문들은 카페24 자체몰 매출이다. 비교는 소문자로.
@@ -251,6 +257,55 @@ class Cafe24Adapter(MarketplaceAdapter):
{"start_date": s.isoformat(), "end_date": e.isoformat(),
"date_type": date_type}, REFUND_LIMIT)
def claim_items(self, ctx: AdapterContext, day: date) -> dict[str, Any]:
"""그날 취소완료·반품완료·교환완료된 주문의 클레임 품목(대조 전용). 환불 API 에 안 잡히는 건
(네이버페이 취소 등)을 찾기 위한 것. 조회 실패는 errors 에 담고 계속한다. 개인정보 제외."""
items: list[dict[str, Any]] = []
errors: list[str] = []
seen: set[str] = set()
full_cancel_shipping = 0
for date_type, label in CLAIM_DATE_TYPES:
try:
orders = list(self._paged(ctx, "/admin/orders", "orders",
{"start_date": day.isoformat(), "end_date": day.isoformat(),
"date_type": date_type, "embed": "items"}, ORDER_LIMIT))
except ApiError as exc:
errors.append(f"{label}: {exc}")
continue
for o in orders:
oid = str(o.get("order_id") or "")
its = o.get("items") or []
claimed = [i for i in its if str(i.get("order_status") or "")[:1] in ("C", "R", "E")
and str(i.get("order_status") or "") not in UNPAID_CANCEL]
if claimed and len(claimed) == len(its) and oid not in seen and \
all(str(i.get("order_status") or "") in CLAIM_DONE and str(i.get("order_status"))[:1] == "C" for i in its):
full_cancel_shipping += order_amounts(o)["shipping_fee"]
for i in claimed:
key = str(i.get("order_item_code") or f"{oid}-{i.get('item_no')}")
if key in seen:
continue
seen.add(key)
status = str(i.get("order_status") or "")
qty = int(i.get("quantity") or 0)
items.append({
"via": label, "order_id": oid, "item_code": key,
"channel": str(o.get("order_place_name") or o.get("market_id") or ""),
"paid": o.get("paid") == "T", "pay_date": str(o.get("payment_date") or "")[:10],
"status": status, "status_text": str(i.get("status_text") or ""),
"done": status in CLAIM_DONE,
"claim_code": str(i.get("claim_code") or ""),
"product_name": str(i.get("product_name") or "")[:40], "quantity": qty,
"product_amount": (_won(i.get("product_price")) + _won(i.get("option_price"))) * qty,
"payment_amount": _won(i.get("payment_amount")),
"coupon": _won(i.get("coupon_discount_price")),
"naver_pay_claim_status": str(i.get("naver_pay_claim_status") or ""),
"cancel_date": str(i.get("cancel_date") or "")[:16],
"refund_date": str(i.get("refund_date") or "")[:16],
"return_confirmed_date": str(i.get("return_confirmed_date") or "")[:16],
})
seen.add(oid)
return {"items": items, "errors": errors, "full_cancel_shipping": full_cancel_shipping}
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건씩 묶어 조회.
못 찾으면 자체몰."""
@@ -420,8 +475,60 @@ class Cafe24Adapter(MarketplaceAdapter):
for s in sorted({str(x.get("status") or "") for x in accepted})
],
}
# 환불 건별 목록(완료일 기준 + 접수일 기준, 환불코드로 합침) — 개인정보(이메일·계좌) 제외
extra = markets | self.market_ids(ctx, [a for a in accepted if str(a.get("order_id")) not in markets])
refund_list: dict[str, dict[str, Any]] = {}
for basis, items in (("completed", rows), ("accepted", accepted)):
for x in items:
code = str(x.get("refund_code") or "")
mid, place, place_name = extra.get(str(x.get("order_id")), ("self", None, None))
e = refund_list.setdefault(code, {
"refund_code": code, "order_id": str(x.get("order_id") or ""),
"channel": str(place_name or mid or ""), "status": str(x.get("status") or ""),
"accepted_date": str(x.get("accepted_refund_date") or "")[:16].replace("T", " "),
"refund_date": str(x.get("refund_date") or "")[:16].replace("T", " "),
"quantity": int(x.get("quantity") or 0),
"actual_refund_amount": _won(x.get("actual_refund_amount")),
"used_points": _won(x.get("used_points")), "used_credits": _won(x.get("used_credits")),
"cancel_fee_amount": _won(x.get("cancel_fee_amount")),
"methods": [str(m) for m in (x.get("refund_methods") or []) if m],
"in_completed": False, "in_accepted": False,
})
e["in_" + basis] = True
claims = self.claim_items(ctx, day)
refunded_orders = {r["order_id"] for r in refund_list.values()}
for c in claims["items"]:
c["has_refund"] = c["order_id"] in refunded_orders
def csum(pred) -> dict[str, int]:
sel = [c for c in claims["items"] if c["done"] and pred(c)]
return {"count": len(sel), "payment_amount": sum(c["payment_amount"] for c in sel),
"product_amount": sum(c["product_amount"] for c in sel)}
comp = refund_basis["completed"]
no_refund = csum(lambda c: not c["has_refund"])
claimed = csum(lambda c: True)
# 카페24 "환불합계" 후보 — 화면 값과 같은 줄을 찾는다(화면에서 값을 입력하면 강조)
candidates = [
{"key": "completed", "label": "환불완료일 · 실제 환불액 (현재 적용)", "amount": comp["actual_refund_amount"]},
{"key": "completed_pts", "label": "환불완료일 · 실제 환불액 + 적립금·예치금", "amount": comp["with_points"]},
{"key": "accepted", "label": "환불접수일(전체 상태) · 실제 환불액", "amount": refund_basis["accepted_all"]["actual_refund_amount"]},
{"key": "accepted_pts", "label": "환불접수일(전체 상태) · 실제 + 적립금·예치금", "amount": refund_basis["accepted_all"]["with_points"]},
{"key": "claim_pay", "label": "취소·반품·교환 완료 품목 · 품목 결제금액", "amount": claimed["payment_amount"]},
{"key": "claim_prod", "label": "취소·반품·교환 완료 품목 · 판매가(+옵션)×수량", "amount": claimed["product_amount"]},
{"key": "claim_pay_ship", "label": "완료 품목 결제금액 + 전체취소 주문 배송비",
"amount": claimed["payment_amount"] + claims["full_cancel_shipping"]},
{"key": "completed_plus_noref", "label": "환불완료 실제 환불액 + 환불 기록 없는 완료 품목 결제금액",
"amount": comp["actual_refund_amount"] + no_refund["payment_amount"]},
{"key": "completed_pts_plus_noref", "label": "환불완료 (실제+적립금) + 환불 기록 없는 완료 품목 결제금액",
"amount": comp["with_points"] + no_refund["payment_amount"]},
]
return {"date": day.isoformat(), "orders": groups, "refunds": refunds, "unpaid_orders": unpaid,
"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,
"by_payment": sorted(by_payment.values(), key=lambda v: v["total"], reverse=True),
"formula": "결제합계 = 상품구매금액 + 배송비 − 할인(" + ", ".join(DISCOUNT_FIELDS) +
") − 쿠폰(" + ", ".join(COUPON_FIELDS) + ")"}
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20260930a" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20260930b" />{% endblock %}
{%- macro won(v) -%}
{%- if v is none -%}<span class="perf-na"></span>
@@ -239,4 +239,4 @@
} | tojson }}</script>
{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930g" defer></script>{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930h" defer></script>{% endblock %}
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20260930a" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20260930b" />{% endblock %}
{%- macro when(v) -%}{{ (v or '')[:16] | replace('T', ' ') or '—' }}{%- endmacro -%}
@@ -143,4 +143,4 @@
</section>
{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930g" defer></script>{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930h" defer></script>{% endblock %}
@@ -407,8 +407,9 @@ def _c24_refund(code, oid, amount, status="T", order_date="2026-09-20T09:00:00+0
class _FakeCafe24(__import__("app.modules.performance.adapters.cafe24", fromlist=["Cafe24Adapter"]).Cafe24Adapter):
def __init__(self, orders_pages, refunds_pages=(), lookup=None):
def __init__(self, orders_pages, refunds_pages=(), lookup=None, claims=None):
self.orders_pages = orders_pages # 결제일 조회 페이지들
self.claims = claims or {} # date_type(취소/반품/교환 완료일) → 주문 목록
self.refunds_pages = list(refunds_pages)
self.lookup = lookup or {} # order_id → market_id (환불 원 주문 조회)
self.calls = []
@@ -424,6 +425,8 @@ 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"):
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 []}
@@ -485,7 +488,32 @@ def test_cafe24_normalize_matches_daily_report():
assert rb["completed"]["count"] == 3 and rb["completed"]["actual_refund_amount"] == 12_610 + 20_000 + 9_000
assert rb["accepted_all"]["count"] == 4 and rb["accepted_all"]["with_points"] == 12_610 + 20_000 + 9_000 + 5_000
assert {s["status"]: s["count"] for s in rb["accepted_by_status"]} == {"T": 3, "F": 1}
# 기기: PC 채널(self)이어도 휴대폰 주문(order_from_mobile=T)은 모바일
assert {c["key"] for c in rec["refund_candidates"]} >= {"completed", "completed_pts", "claim_pay"}
assert {r["refund_code"] for r in rec["refund_list"]} == {"C20260929-01", "R20260929-02", "C20260929-03", "C20260929-04"}
assert "1234567890" not in str(rec["refund_list"]) # 환불 계좌 미노출
# 클레임 완료 품목: 환불 API 에 없는 취소(네이버페이 등)를 찾는다. 입금전취소·미완료는 합계 제외
item = lambda code, st, pay, price=10_000, qty=1: {"order_item_code": code, "order_status": st, "quantity": qty,
"product_price": f"{price}.00", "option_price": "0.00",
"payment_amount": f"{pay}.00", "product_name": "상품"}
fake4 = _FakeCafe24([[]], [[_c24_refund("C1", "A", 9_000)]], claims={
"cancel_complete_date": [
{**_c24_order("A"), "items": [item("A-01", "C40", 9_000)]},
{**_c24_order("N"), "market_id": "NCHECKOUT", "items": [item("N-01", "C40", 19_800, 20_000), item("N-02", "C40", 5_000, 5_000)]},
{**_c24_order("U"), "items": [item("U-01", "C48", 7_000)]},
{**_c24_order("P"), "items": [item("P-01", "C34", 3_000), item("P-02", "N40", 4_000)]}],
"return_complete_date": [{**_c24_order("N"), "items": [item("N-01", "C40", 19_800, 20_000)]},
{**_c24_order("R"), "items": [item("R-01", "R40", 12_000, 6_000, 2)]}],
})
rec4 = fake4.reconcile(ctx, date(2026, 9, 29))
cl = {c["item_code"]: c for c in rec4["claims"]["items"]}
assert set(cl) == {"A-01", "N-01", "N-02", "P-01", "R-01"} # 입금전취소(U)·정상 품목 제외, 중복 제거
assert cl["A-01"]["has_refund"] and not cl["N-01"]["has_refund"] and not cl["P-01"]["done"]
assert cl["R-01"]["product_amount"] == 12_000
assert rec4["claims"]["full_cancel_shipping"] == 3_000 * 2 # A, N 전체취소(배송비 3,000씩)
cand = {c["key"]: c["amount"] for c in rec4["refund_candidates"]}
assert cand["claim_pay"] == 9_000 + 19_800 + 5_000 + 12_000
assert cand["completed_plus_noref"] == 9_000 + 19_800 + 5_000 + 12_000
# 기기: PC 채널(self)이어도 휴대폰 주문(order_from_mobile=T)은 모바일
assert ch["self"]["mobile_orders"] == 1 and ch["self"]["pc_orders"] == 0 and ch["self"]["mobile_total"] == 47_000
assert ch["NCHECKOUT"]["pc_orders"] == 1 and ch["mobile"]["mobile_orders"] == 1
# self 는 PC 전용이 아니다 — 주문경로(PC쇼핑몰/모바일웹)별로 한 줄씩(실데이터 확인)