fix(performance): 카페24 환불 — 네이버페이만·전체취소 배송비 포함, 0원 결제 주문은 0원

9/4·9/16·9/25 대조 결과:
- 9/4 환불 122,100 = 환불 목록 98,700 + 네이버페이 취소 19,900 + 그 주문 배송비
  3,500 (주문 전체취소) — 우리는 배송비를 빠뜨려 −3,500 (9/14 −7,000 도 같은 유형)
- 9/16 환불 201,100 = 환불 목록 그대로 — 우리가 더 뺀 9,900 은 톡체크아웃
  (KAKAOPAY) 환불 기록 없는 취소. 카페24 는 네이버페이만 센다 (9/21 도 같은 유형)
- 9/25 결제: 실결제·적립금·네이버포인트는 카페24 와 같은데 합계만 +9,900 —
  네 값이 모두 0인 주문(가상계좌·휴대폰 9,900)을 상품식으로 넣었기 때문.
  카페24 는 0원 (9/11 +24,900 도 같은 유형)

- unrefunded_claims: 네이버페이(NCHECKOUT) 주문만, 주문 전체가 취소·반품되면
  배송비(− 배송비 할인·쿠폰)를 마지막 클레임 품목에 한 번 더함
- _paid_total: 상품식 대체 제거
- 대조 표에 품목별 배송비 포함액 표시, 테스트 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-29 23:03:50 +09:00
parent 2f86445077
commit 643ff25f27
6 changed files with 69 additions and 35 deletions
+34 -18
View File
@@ -11,7 +11,7 @@
(initial_order_amount 의 payment_amount·points_spent_amount·credits_spent_amount + 주문의 naver_point)
"상품구매금액 + 배송비 − 할인 − 쿠폰"은 할인 필드에 안 잡히는 차이(수십~수만 원)가 생겨 쓰지 않는다
(2026-09-23 실데이터: 카페24 1,874,738 = 1,713,128 + 10,110 + 151,500, 상품식은 1,874,800).
위 네 값이 모두 0인 주문(0원 결제 등)만 상품식으로 계산한다.
네 값이 모두 0인 주문도 0원(카페24와 같음).
환불은 따로 빼므로 취소 후 금액(actual_order_amount)이 아니라 결제 당시 금액을 쓴다.
- 환불합계(CANCEL/RETURN, −): GET /admin/refunds date_type=refund_date(환불완료일),
실제 환불액(actual_refund_amount). 환불코드가 R 로 시작하면 반품, 그 밖은 취소.
@@ -62,6 +62,7 @@ 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"})
NO_RECORD_CHANNEL = "ncheckout" # 네이버페이만 — 톡체크아웃·자체몰의 환불 기록 없는 취소는 카페24 환불합계에 없다
REFUND_LOOKAROUND_DAYS = 60
# 카페24 자체몰 주문 채널 — market_id 는 외부 마켓만이 아니라 주문 채널·간편결제도 담는다
@@ -150,9 +151,9 @@ def goods_total(w: dict[str, int]) -> int:
def _paid_total(w: dict[str, int]) -> int:
"""결제합계 = 실결제금액 + 적립금 + 예치금 + 네이버포인트. 모두 0이면 참고식."""
paid = sum(w[k] for k in PAID_FIELDS) + w["naver_point"]
return paid if paid > 0 else goods_total(w)
"""결제합계 = 실결제금액 + 적립금 + 예치금 + 네이버포인트. 넷 다 0인 주문은 카페24도 0원으로 센다
(9/25 가상계좌·휴대폰 9,900 주문 — 상품식으로 넣으면 그만큼 많아짐)."""
return sum(w[k] for k in PAID_FIELDS) + w["naver_point"]
def order_total(order: dict[str, Any]) -> int:
@@ -369,9 +370,12 @@ class Cafe24Adapter(MarketplaceAdapter):
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일 환불 목록(완료일·접수일)에 그 주문이 있으면 제외해
환불 목록 쪽과 두 번 빼지 않는다."""
"""환불 목록에 기록이 없는 네이버페이 취소·반품 완료 품목. 날짜 = 품목 취소일(반품은 반품완료일).
금액 = 판매가(+옵션)×수량 − 품목 할인·쿠폰. 주문 전체가 취소·반품되면 배송비(− 배송비 할인·쿠폰)도 환불로
보고 그 주문의 마지막 클레임 품목에 한 번 더한다. 앞뒤 60일 환불 목록(완료일·접수일)에 그 주문이 있으면
제외해 환불 목록 쪽과 두 번 빼지 않는다.
카페24 일별 매출 환불합계와 대조한 결과(2026-09): 네이버페이만 센다 — 톡체크아웃(KAKAOPAY)·자체몰의
환불 기록 없는 취소는 넣지 않는다(9/16 톡체크아웃 취소 9,900 제외, 9/4 네이버페이 전체취소 배송비 3,500 포함)."""
from app.timezone import today_kst # noqa: WPS433
found: dict[str, dict[str, Any]] = {}
@@ -380,32 +384,44 @@ class Cafe24Adapter(MarketplaceAdapter):
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):
if NO_RECORD_CHANNEL not in (_key(o.get("market_id")), _key(o.get("order_place_id"))):
continue
oid = str(o.get("order_id") or "")
for i in o.get("items") or []:
its = o.get("items") or []
claimed: list[tuple[date, str, dict[str, Any]]] = []
for i in its:
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):
if day is not None:
claimed.append((day, str(i.get("order_item_code") or f"{oid}-{i.get('item_no')}"), i))
if not claimed:
continue
all_claimed = len(claimed) == len(its)
w = order_amounts(o)
ship = max(0, w["shipping_fee"] - w["coupon_shipping_fee_amount"] - w["shipping_fee_discount_amount"])
last = max((d, k) for d, k, _ in claimed)
for day, key, i in claimed:
if not (start <= day <= end):
continue
key = str(i.get("order_item_code") or f"{oid}-{i.get('item_no')}")
status = str(i.get("order_status") or "")
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")))
amount = max(0, (_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")))
ship_refund = ship if all_claimed and (day, key) == last else 0
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),
"quantity": qty, "amount": amount + ship_refund, "shipping_refund": ship_refund,
"product_name": str(i.get("product_name") or "")[:40],
"naver_pay_claim_status": str(i.get("naver_pay_claim_status") or ""),
# 대조용 — 주문 전체가 취소·반품됐는지, 그 주문 배송비(배송비 환불 여부 확인)
"order_all_claimed": all(str(x.get("order_status") or "") in NO_RECORD_DONE
for x in o.get("items") or []),
"order_shipping_fee": order_amounts(o)["shipping_fee"],
# 대조용 — 주문 전체가 취소·반품됐는지, 그 주문 배송비
"order_all_claimed": all_claimed, "order_shipping_fee": w["shipping_fee"],
"item_payment_amount": _won(i.get("payment_amount")),
"coupon": _won(i.get("coupon_discount_price")),
}