feat(performance): 카페24 매출 대조 — 금액이 줄어든 주문 건별 + 주문취소일 조회

결제일 기준 후보도 카페24 환불합계와 맞지 않음(9/26, 9/27). 9/26 결제 주문의
(결제 당시 − 현재) 205,200 중 환불 기록은 148,320 뿐이라, 환불 API 에 안 잡히는
취소(네이버페이 등)를 찾기 위해 줄어든 주문을 건별로(채널·결제수단·품목 상태·
네이버페이 클레임·취소일·환불 기록) 표시. 클레임 조회에 cancel_date 추가.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-29 17:52:57 +09:00
parent 1eca66838b
commit b3ee219858
5 changed files with 45 additions and 5 deletions
+25 -3
View File
@@ -51,8 +51,8 @@ CHUNK_DAYS = 60
EVENT_PREFIX = "c24:"
# 매출 대조 전용 — 클레임 완료 주문 조회 날짜 유형과 "완료" 상태(입금전취소 C47~49 는 결제 전이라 제외)
CLAIM_DATE_TYPES = (("cancel_complete_date", "취소완료"), ("return_complete_date", "반품완료"),
("exchange_complete_date", "교환완료"))
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"})
@@ -418,6 +418,7 @@ class Cafe24Adapter(MarketplaceAdapter):
by_payment: dict[str, dict[str, Any]] = {} # 결제수단 조합별(카페24 열 주문만)
unpaid = 0
paid_self: dict[str, int] = {} # 그날 결제된 카페24 열 주문 → (결제 당시 − 현재) 금액
reduced: dict[str, dict[str, Any]] = {} # 그중 금액이 줄어든 주문(취소·반품) — 환불 기록과 대조
for o in self.paid_orders(ctx, day, day):
if o.get("paid") != "T":
unpaid += 1
@@ -446,7 +447,22 @@ class Cafe24Adapter(MarketplaceAdapter):
g[k] += v
g["total"] += order_total(o)
if ch["target"] == "cafe24":
paid_self[str(o.get("order_id") or "")] = order_total(o) - order_total_now(o)
oid_ = str(o.get("order_id") or "")
paid_self[oid_] = order_total(o) - order_total_now(o)
if paid_self[oid_] > 0:
reduced[oid_] = {
"order_id": oid_, "channel": str(o.get("order_place_name") or o.get("market_id") or ""),
"payment": " + ".join(str(n) for n in (o.get("payment_method_name") or []) if n),
"initial": order_total(o), "now": order_total_now(o), "diff": paid_self[oid_],
"statuses": sorted({f"{i.get('order_status') or ''} {i.get('status_text') or ''}".strip()
for i in o.get("items") or []}),
"naver_pay": sorted({str(i.get("naver_pay_claim_status")) for i in o.get("items") or []
if i.get("naver_pay_claim_status")}),
"claim_dates": sorted({str(i.get(k))[:10] for i in o.get("items") or []
for k in ("cancel_date", "refund_date", "return_confirmed_date")
if i.get(k)}),
"refunded": 0, "refund_dates": [],
}
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},
@@ -528,6 +544,11 @@ class Cafe24Adapter(MarketplaceAdapter):
by_pay["amount_diff"] = sum(v for v in paid_self.values() if v > 0)
by_pay["refund_dates"] = sorted({str(x.get("refund_date") or "")[:10] for x in later})
refund_basis["by_pay_date"] = by_pay
for x in later:
r_ = reduced.get(str(x.get("order_id") or ""))
if r_ is not None:
r_["refunded"] += _won(x.get("actual_refund_amount")) + _won(x.get("used_points")) + _won(x.get("used_credits"))
r_["refund_dates"] = sorted({*r_["refund_dates"], str(x.get("refund_date") or "")[:10]})
comp = refund_basis["completed"]
no_refund = csum(lambda c: not c["has_refund"])
@@ -557,6 +578,7 @@ 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,
"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) +
") − 쿠폰(" + ", ".join(COUPON_FIELDS) + ")"}
@@ -239,4 +239,4 @@
} | tojson }}</script>
{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930i" defer></script>{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930j" defer></script>{% endblock %}
@@ -143,4 +143,4 @@
</section>
{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930i" defer></script>{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930j" defer></script>{% endblock %}
@@ -498,6 +498,9 @@ def test_cafe24_normalize_matches_daily_report():
bp = rec["refund_basis"]["by_pay_date"]
assert bp["count"] == 1 and bp["actual_refund_amount"] == 12_610
assert bp["amount_diff"] == 5 * 50_000 # 결제 당시 − 현재(가짜 현재 상품금액 0)
red = {x["order_id"]: x for x in rec["reduced_orders"]}
assert set(red) == {"A", "D", "E", "F", "G"} and red["A"]["refunded"] == 12_610 and red["D"]["refunded"] == 0
assert rec["reduced_orders"][-1]["order_id"] == "A" # 환불 기록으로 설명 안 되는 금액이 큰 순
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 에 없는 취소(네이버페이 등)를 찾는다. 입금전취소·미완료는 합계 제외
+15
View File
@@ -566,6 +566,21 @@
'</td><td class="perf-num">' + won(x.used_points + x.used_credits) + "</td><td>" + esc((x.methods || []).join(", ") || "–") + "</td></tr>";
}).join("") + "</tbody></table>"
: "") +
((r.reduced_orders || []).length
? '<h4 class="perf-h" style="margin:14px 0 6px">그날 결제한 주문 중 금액이 줄어든 주문 (취소·반품) — "환불 기록 없음"이 환불 API 에 안 잡힌 건</h4>' +
'<table class="perf-table"><thead><tr><th class="perf-th-label">주문번호</th><th class="perf-th-label">채널</th>' +
'<th class="perf-th-label">결제수단</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.reduced_orders.map(function (x) {
const miss = x.diff - x.refunded;
return "<tr" + (miss > 0 ? ' class="perf-row-match"' : "") + '><td class="perf-td-label">' + esc(x.order_id) + "</td><td>" +
esc(x.channel || "–") + "</td><td>" + esc(x.payment || "–") + "</td><td>" +
esc(x.statuses.join(", ") + (x.naver_pay.length ? " / 네이버페이 " + x.naver_pay.join(",") : "")) + "</td><td>" +
esc(x.claim_dates.join(", ") || "–") + '</td><td class="perf-num">' + won(x.initial) + '</td><td class="perf-num">' +
won(x.now) + '</td><td class="perf-num">' + won(x.diff) + '</td><td class="perf-num">' +
(x.refunded ? won(x.refunded) + ' <span class="perf-muted">' + esc(x.refund_dates.join(", ")) + "</span>" : "<b>없음</b>") + "</td></tr>";
}).join("") + "</tbody></table>"
: "") +
(r.claims
? '<h4 class="perf-h" style="margin:14px 0 6px">그날 취소·반품·교환 완료 품목 (주문 API)</h4>' +
((r.claims.errors || []).length ? '<p class="perf-notice is-warn">' + esc(r.claims.errors.join(" / ")) + "</p>" : "") +