diff --git a/app/modules/performance/adapters/toss.py b/app/modules/performance/adapters/toss.py index cf644b7..7f92a49 100644 --- a/app/modules/performance/adapters/toss.py +++ b/app/modules/performance/adapters/toss.py @@ -17,11 +17,15 @@ 주문 하나 = 사건 하나(`toss:{orderId}`), 날짜 = 주문 시각(orderedAt, 한국 날짜 — 토스쇼핑은 주문 = 결제), 금액 = 주문상품 price(판매가 × 수량) 합 — 할인 전, 배송비 제외. 할인(totalDiscountPrice = 토스쇼핑 할인 + 토스페이 할인)은 discount_amount 로만 보관. 결제 전(BEFORE_PAYMENT)만 빼고 결제 뒤 취소·반품도 주문일 매출에 둔다(화면 "매출"도 환불 전 금액). - - 환불 CANCEL — 정산 건별 목록 GET /api/v3/shopping-fep/settlement-steps?dateCondition=TRANSACTION_DATE&fromDate=&toDate= - &size=100&nextToken= 의 stepType=REFUND 줄(상품 줄만 — 배송비 줄은 orderProductId 가 없음). 날짜 = 환불 거래 일시 - (transactionTs, 한국 날짜), 금액 = −|orderProductPrice|(정산 기준 금액, 없으면 판매가 × 수량). 결제완료 단계의 고객 취소는 - 클레임 목록에 안 잡히고 클레임 목록은 날짜로 거를 수 없어 정산 쪽을 쓴다. 사건 ID `toss:R{orderProductId}-{거래일시}`. - - 설정 화면 "쇼핑몰 원본 데이터 확인"에 날짜별 매출·환불·순 거래액 — 파트너스 화면과 같은지 본다. + - 환불 CANCEL/RETURN — 환불일에 뺀다. 주문상품 하나에 한 번(사건 ID `toss:R{orderProductId}`). `merge_refunds`: + ① 클레임 목록 GET /api/v3/shopping-fep/claims(날짜 조건이 없어 전체를 넘긴다)의 환불 완료(isRefunded) CANCEL·RETURN — + 날짜 = refundedDt(한국 날짜). 반품은 이것뿐(주문 내역엔 반품 완료 날짜가 없다). + ② 클레임이 없는 결제취소 — 주문 내역의 canceledAt(한국 날짜). 결제완료 단계의 고객 취소는 클레임이 생기지 않는다(문서). + 기간보다 CANCEL_LOOKBACK_DAYS(90)일 앞 주문까지 불러 다른 날 주문을 기간 안에 취소한 것도 잡는다. + 금액 = 그 주문상품의 price(판매가 × 수량, 매출과 같은 기준), 주문 내역에 없으면(90일보다 오래된 주문) 클레임 order.price. + 9/6 실데이터: 9/5 주문(276435356)을 9/6 취소 11,900 — 클레임(CANCEL/COMPLETED)·canceledAt 둘 다 9/6 = 화면 환불 11,900. + 정산 건별(settlement-steps)의 REFUND 는 이 취소를 담지 않아(구매확정 전 취소는 정산에 안 올라옴) 쓰지 않는다. + - 설정 화면 "쇼핑몰 원본 데이터 확인"에 날짜별 매출·환불·순 거래액과 환불 출처별(정산·취소 시각·클레임) 비교. - 구매자·수령인 이름·연락처·주소·요청사항은 저장하지 않는다. """ @@ -174,7 +178,7 @@ def cancel_rows(items: Iterable[dict[str, Any]], start: date, end: date) -> list continue status = str(it.get("orderProductStatus") or "") out.append({"orderId": str(it["orderId"]), "orderProductId": str(it.get("orderProductId") or ""), "_day": day, - "amount": _won(it.get("price")), "note": f"{STATUS_KO.get(status, status)} · 주문일 " + "amount": _won(it.get("price")), "status": status, "note":f"{STATUS_KO.get(status, status)} · 주문일 " f"{kst_day(it.get('orderedAt')) or '?'}"}) return out @@ -195,6 +199,43 @@ def claim_rows(items: Iterable[dict[str, Any]], start: date, end: date) -> list[ return out +def merge_refunds(order_items: Iterable[dict[str, Any]], claims: Iterable[dict[str, Any]], + start: date, end: date) -> list[dict[str, Any]]: + """환불 규칙 — 클레임 환불 완료(CANCEL·RETURN, refundedDt) + 클레임이 없는 결제취소(canceledAt), 주문상품마다 한 번. + 금액은 주문 내역의 price(판매가 × 수량)를 우선(없으면 클레임 order.price). 날짜가 [start, end] 인 것만. + 클레임이 있는 주문상품은 그 클레임 날짜만 쓴다(기간 밖이어도 취소 시각으로 다시 넣지 않음 — 날짜가 바뀌지 않게).""" + order_items = list(order_items) + by_op = {str(it.get("orderProductId")): it for it in order_items if it.get("orderProductId")} + out: dict[str, dict[str, Any]] = {} + claimed_ops: set[str] = set() + for c in claims: + order = c.get("order") if isinstance(c.get("order"), dict) else {} + product = c.get("product") if isinstance(c.get("product"), dict) else {} + kind = str(c.get("type") or "") + op = str(order.get("orderProductId") or "") + if not c.get("isRefunded") or kind not in ("CANCEL", "RETURN") or not order.get("id") or not op: + continue + claimed_ops.add(op) + day = kst_day(c.get("refundedDt")) + if day is None or not (start <= day <= end) or op in out: + continue + it = by_op.get(op) or {} + out[op] = {"orderId": str(order["id"]), "orderProductId": op, "_day": day, "type": kind, + "amount": _won(it["price"]) if "price" in it else _won(order.get("price")), + "qty": _won(it.get("quantity")) or _won(product.get("quantity")), + "name": str(it.get("productName") or product.get("name") or ""), + "order_day": kst_day(it.get("orderedAt") or order.get("createdDt"))} + for r in cancel_rows(order_items, start, end): + op = r["orderProductId"] + if not op or op in claimed_ops or op in out or r["status"] != "CANCELED_PAYMENT": + continue + it = by_op.get(op) or {} + out[op] = {"orderId": r["orderId"], "orderProductId": op, "_day": r["_day"], "type": "CANCEL", + "amount": r["amount"], "qty": _won(it.get("quantity")), "name": str(it.get("productName") or ""), + "order_day": kst_day(it.get("orderedAt"))} + return sorted(out.values(), key=lambda x: (x["_day"], x["orderId"], x["orderProductId"])) + + def summary(rows: list[dict[str, Any]]) -> list[dict[str, Any]]: """원본 확인 표 — 항목별 채워진 줄·숫자 합계·예시 값(개인정보·자유 입력 항목은 값·합계 숨김).""" fields = field_summary([flatten(r) for r in rows]) @@ -403,23 +444,52 @@ class TossAdapter(MarketplaceAdapter): ctx.progress.step(items=len(rows)) yield from rows - # ── 수집 ────────────────────────────────────────────── - def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]: - ctx.progress.plan(2 * len(self._windows(start, end)), "31일 구간") # 주문 내역 + 정산(환불) - yield from group_orders(self._items(ctx, start, end), start, end).values() + def _lookback_items(self, ctx: AdapterContext, start: date) -> list[dict[str, Any]]: + """기간 앞 CANCEL_LOOKBACK_DAYS 일의 주문상품 — 다른 날 주문을 기간 안에 취소한 것을 찾는 용도.""" + out: list[dict[str, Any]] = [] + for a, b in self._windows(start - timedelta(days=CANCEL_LOOKBACK_DAYS), start - timedelta(days=1)): + rows = self._window_items(ctx, a, b) + ctx.progress.step(items=len(rows)) + out.extend(rows) + return out - def fetch_refunds(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]: - yield from refund_rows(self._refund_items(ctx, start, end), start, end) + def _plan(self, ctx: AdapterContext, start: date, end: date, extra: int = 0) -> None: + """진행 막대: 기간 주문 구간 + 앞 90일 주문 구간 + 클레임 목록 1단계 (+ 원본 확인의 정산 구간).""" + back = len(self._windows(start - timedelta(days=CANCEL_LOOKBACK_DAYS), start - timedelta(days=1))) + ctx.progress.plan(len(self._windows(start, end)) + back + 1 + extra, "단계") + + def _claims_step(self, ctx: AdapterContext) -> list[dict[str, Any]]: + claims = self._claims(ctx) + ctx.progress.step(items=len(claims)) + return claims + + # ── 수집 ────────────────────────────────────────────── + def collect(self, ctx: AdapterContext, start: date, end: date) -> tuple[int, list[SaleEvent]]: + """매출(주문일) + 환불(환불일, merge_refunds). 주문 내역은 환불 금액·취소 시각에도 쓰여 한 번만 부른다.""" + self.authenticate(ctx) + self._plan(ctx, start, end) + items = list(self._items(ctx, start, end)) + back = self._lookback_items(ctx, start) + claims = self._claims_step(ctx) + events: list[SaleEvent] = [] + for o in group_orders(items, start, end).values(): + events.extend(self.normalize_order(o)) + for r in merge_refunds(back + items, claims, start, end): + events.extend(self.normalize_refund(r)) + for ev in events: + ev.validate() + return len(items) + len(claims), events def normalize_refund(self, r: dict[str, Any]) -> list[SaleEvent]: oid, day = str(r.get("orderId") or ""), r.get("_day") - if not oid or day is None: + if not oid or day is None or not r.get("orderProductId"): return [] + kind = "RETURN" if r.get("type") == "RETURN" else "CANCEL" return [SaleEvent( - event_type="CANCEL", external_event_id=f"{EVENT_PREFIX}R{r['orderProductId']}-{r.get('_ts') or day}"[:200], - external_order_id=oid, external_line_id=str(r.get("orderProductId") or ""), event_date=day, - order_date=r.get("order_day"), amount=-abs(int(r.get("amount") or 0)), - product_name=str(r.get("name") or "")[:200], quantity=int(r.get("qty") or 0), order_status="환불", + event_type=kind, external_event_id=f"{EVENT_PREFIX}R{r['orderProductId']}", external_order_id=oid, + external_line_id=str(r["orderProductId"]), event_date=day, order_date=r.get("order_day"), + amount=-abs(int(r.get("amount") or 0)), product_name=str(r.get("name") or "")[:200], + quantity=int(r.get("qty") or 0), order_status="반품 환불" if kind == "RETURN" else "취소 환불", )] def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]: @@ -450,22 +520,18 @@ class TossAdapter(MarketplaceAdapter): # ── 원본 데이터 확인(설정 화면 "쇼핑몰 원본 데이터 확인") ───────── def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]: - """기간(최대 31일)의 주문상품을 실제로 불러 항목별 합계·상태별 합계·날짜별 현재 규칙 매출을 돌려준다. - 토스쇼핑 파트너스 화면 매출과 어느 항목이 맞는지 실데이터로 확정하는 용도. 개인정보 항목은 값 없이 이름만.""" + """기간(최대 31일)을 실제로 불러 항목별 합계·상태별 합계와 날짜별 매출·환불·순 거래액(= 저장되는 값)을 돌려준다. + 환불은 출처별(클레임 환불 완료·주문 취소 시각·정산 REFUND)로도 나란히 보여 파트너스 화면과 맞춰 볼 수 있게. + 개인정보 항목은 값 없이 이름만. 저장하지 않는다.""" self.authenticate(ctx) to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1)) - ctx.progress.plan(2 * len(self._windows(day, to)), "31일 구간") + self._plan(ctx, day, to, extra=len(self._windows(day, to))) try: items = list(self._items(ctx, day, to)) + back = self._lookback_items(ctx, day) except AdapterError as exc: return {"date": day.isoformat(), "to": to.isoformat(), "probes": [ {"key": "orders", "label": "주문 내역", "path": ORDERS_PATH, "ok": False, "error": exc.message[:300]}]} - settle_err = "" - try: - settle = list(self._refund_items(ctx, day, to)) - except AdapterError as exc: - settle, settle_err = [], exc.message[:300] - refunds = refund_rows(settle, day, to) by_status: dict[str, list[dict[str, Any]]] = {} for it in items: by_status.setdefault(str(it.get("orderProductStatus") or "?"), []).append(it) @@ -477,55 +543,46 @@ class TossAdapter(MarketplaceAdapter): " — 결제 뒤 취소·반품(매출 포함)" if st in CLAIMED_STATUS else ""), "path": "orderProductStatus", "ok": True, "count": len(rows), "fields": [f for f in summary(rows) if f["sum"] is not None]}) - if settle_err: - probes.append({"key": "settlement", "label": "정산 건별(거래일 기준 — 환불)", "path": SETTLEMENT_PATH, - "ok": False, "error": settle_err}) - else: - probes.append({"key": "settlement", "label": "정산 건별(거래일 기준, 결제·환불·배송비 줄 전체)", - "path": SETTLEMENT_PATH + " (TRANSACTION_DATE)", "ok": True, "count": len(settle), - "fields": summary(settle)}) - steps: dict[str, list[dict[str, Any]]] = {} - for it in settle: - kind = str(it.get("stepType") or "?") + ("" if it.get("orderProductId") else " · 배송비 줄") - steps.setdefault(kind, []).append(it) - for kind, rows in sorted(steps.items()): - probes.append({"key": f"step-{kind}", "label": f"정산 {kind}" - + (" — 환불(순 거래액에서 뺌)" if kind == "REFUND" else ""), - "path": "stepType", "ok": True, "count": len(rows), - "fields": [f for f in summary(rows) if f["sum"] is not None]}) - - # ── 환불 후보 세 가지 — 파트너스 화면 "환불"과 어느 쪽이 같은지 날짜별로 나란히(실데이터로 규칙 확정용) ── - candidates: list[dict[str, Any]] = [ - {"key": "settlement", "label": "① 정산 REFUND 상품 줄(거래일) — 현재 규칙", "rows": refunds, "error": settle_err}] - # ② 주문 취소 시각 — 기간보다 CANCEL_LOOKBACK_DAYS 전 주문까지 본다(다른 날 주문을 이 기간에 취소한 것) - look_from = day - timedelta(days=CANCEL_LOOKBACK_DAYS) + claims_err = "" try: - back = [r for a, b in self._windows(look_from, day - timedelta(days=1)) for r in self._window_items(ctx, a, b)] - canceled = cancel_rows(back + items, day, to) - cand_err = "" - except AdapterError as exc: - canceled, cand_err = [], exc.message[:300] - candidates.append({"key": "canceled", "label": f"② 주문 취소 시각(canceledAt, {CANCEL_LOOKBACK_DAYS}일 전 주문까지)", - "rows": canceled, "error": cand_err}) - # ③ 클레임 환불 완료 시각 — 클레임 목록은 날짜로 못 거른다(전체를 받아 refundedDt 로 거름) - try: - claims = self._claims(ctx) - claimed = claim_rows(claims, day, to) + claims = self._claims_step(ctx) probes.append({"key": "claims", "label": "클레임 목록(전체 — 날짜 조건 없음)", "path": CLAIMS_PATH, "ok": True, "count": len(claims), "fields": summary(claims)}) - cand_err = "" except AdapterError as exc: - claimed, cand_err = [], exc.message[:300] - probes.append({"key": "claims", "label": "클레임 목록", "path": CLAIMS_PATH, "ok": False, "error": cand_err}) - candidates.append({"key": "claims", "label": "③ 클레임 환불 완료(refundedDt, 금액 order.price)", - "rows": claimed, "error": cand_err}) + claims, claims_err = [], exc.message[:300] + probes.append({"key": "claims", "label": "클레임 목록", "path": CLAIMS_PATH, "ok": False, "error": claims_err}) + settle_err = "" + try: + settle = list(self._refund_items(ctx, day, to)) + probes.append({"key": "settlement", "label": "정산 건별(거래일 기준, 결제·환불·배송비 줄 전체 — 참고)", + "path": SETTLEMENT_PATH + " (TRANSACTION_DATE)", "ok": True, "count": len(settle), + "fields": summary(settle)}) + except AdapterError as exc: + settle, settle_err = [], exc.message[:300] + probes.append({"key": "settlement", "label": "정산 건별(참고)", "path": SETTLEMENT_PATH, "ok": False, + "error": settle_err}) + + refunds = merge_refunds(back + items, claims, day, to) # 저장되는 환불(현재 규칙) + # ── 환불 출처별 — 파트너스 화면 "환불"과 맞춰 보는 용도 ── + candidates: list[dict[str, Any]] = [ + {"key": "rule", "label": "적용 규칙(클레임 환불 + 클레임 없는 결제취소)", "rows": [ + {**r, "note": f"{'반품' if r['type'] == 'RETURN' else '취소'} · 주문일 {r.get('order_day') or '?'}"} + for r in refunds], "error": claims_err}, + {"key": "claims", "label": "클레임 환불 완료(refundedDt, 금액 order.price)", "rows": claim_rows(claims, day, to), + "error": claims_err}, + {"key": "canceled", "label": f"주문 취소 시각(canceledAt, {CANCEL_LOOKBACK_DAYS}일 전 주문까지)", + "rows": cancel_rows(back + items, day, to), "error": ""}, + {"key": "settlement", "label": "정산 REFUND 상품 줄(거래일) — 참고", "rows": [ + {**r, "note": f"정산 REFUND · 주문일 {r.get('order_day') or '?'}"} for r in refund_rows(settle, day, to)], + "error": settle_err}, + ] for c in candidates: c["days"] = {} for r in c["rows"]: k = r["_day"].isoformat() c["days"][k] = c["days"].get(k, 0) + r["amount"] c["rows"] = [{"date": r["_day"].isoformat(), "orderId": r["orderId"], "orderProductId": r["orderProductId"], - "amount": r["amount"], "note": r.get("note") or f"정산 REFUND · 주문일 {r.get('order_day') or '?'}"} + "amount": r["amount"], "note": r.get("note") or ""} for r in sorted(c["rows"], key=lambda x: (x["_day"], x["orderId"]))][:200] days = [] @@ -542,5 +599,5 @@ class TossAdapter(MarketplaceAdapter): "refund_candidates": candidates, "day_cols": {"amount": "매출(주문일)", "claimed": "환불(환불일)", "ship": "순 거래액(저장되는 매출)"}, "rule": "순 거래액 = 매출 − 환불. 매출 = 주문일(orderedAt) 기준 주문상품 price(판매가 × 수량) 합(할인 전, " - "배송비 제외, 나중에 취소·반품된 주문 포함, 결제 전 제외). 환불 = 정산 건별 REFUND 상품 줄의 " - "orderProductPrice, 환불 거래일(transactionTs) 기준. 토스쇼핑 파트너스의 매출·환불·순 거래액과 비교"} + "배송비 제외, 나중에 취소·반품된 주문 포함, 결제 전 제외). 환불 = 클레임 환불 완료(취소·반품, refundedDt) + " + "클레임 없는 결제취소(canceledAt), 주문상품마다 한 번, 금액 = 그 주문상품 price. 환불일 기준"} diff --git a/app/modules/performance/templates/performance/index.html b/app/modules/performance/templates/performance/index.html index 8ee5001..78121b2 100644 --- a/app/modules/performance/templates/performance/index.html +++ b/app/modules/performance/templates/performance/index.html @@ -239,4 +239,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 520a0b2..a0585bf 100644 --- a/app/modules/performance/templates/performance/settings.html +++ b/app/modules/performance/templates/performance/settings.html @@ -179,4 +179,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 49b7c55..7801224 100644 --- a/app/modules/performance/tests/test_performance.py +++ b/app/modules/performance/tests/test_performance.py @@ -483,39 +483,63 @@ def _toss_step(step, order_id, op_id, ts, price, *, qty=1): "displayProductName": "밀폐용기", "orderProductStatus": "CANCELED_PAYMENT" if step == "REFUND" else "CONFIRMED_ORDER"} +def _toss_claim(cid, kind, status, order_id, op_id, price, *, refunded=None, created="2026-08-01T10:00:00", qty=1): + """클레임 목록 items[] 한 줄 — refunded = 환불 완료 일시(없으면 미환불). 개인정보·자유 입력 항목 포함.""" + return {"id": cid, "type": kind, "status": status, "isRefunded": bool(refunded), "refundedDt": refunded, + "requestReason": "단순 변심 010-5555-6666", "returnAddress": "서울시 반품동", + "order": {"id": order_id, "orderProductId": op_id, "price": price, "createdDt": created, + "ordererName": "홍길동", "ordererPhoneNumber": "010-1234-5678"}, + "product": {"id": 3, "name": "밀폐용기", "quantity": qty}} + + def test_toss_collect_sales(): - """토스쇼핑 매출 = 파트너스 "순 거래액" = 매출 − 환불(9/6 화면: 29,600 − 11,900 = 17,700). + """토스쇼핑 매출 = 파트너스 "순 거래액" = 매출 − 환불(9/6 화면: 29,600 − 11,900 = 17,700, 9/5 주문을 9/6 취소). 매출 = 주문 단위, 주문일(한국 날짜), 주문상품 price 합(할인 전·배송비 제외, 나중에 취소·반품된 주문 포함, 결제 전 제외). - 환불 = 정산 건별(거래일 기준) REFUND 상품 줄, 환불일. 31일 구간 + 커서. 구매자 정보는 저장 안 함.""" + 환불 = 클레임 환불 완료(취소·반품, refundedDt) + 클레임 없는 결제취소(canceledAt), 주문상품마다 한 번, 금액 = 주문상품 price. + 기간 앞 90일 주문까지 불러 다른 날 주문의 환불도 잡는다. 31일 구간 + 커서. 구매자 정보는 저장 안 함.""" import httpx from app.modules.performance.adapters import toss as ts + def item(*a, canceled=None, **kw): + it = _toss_item(*a, **kw) + if canceled: + it["canceledAt"] = canceled + return it + pages = { - ("2026-08-01", None): ([_toss_item(1, 11, "2026-08-31T23:30:00+09:00", 20000, qty=2, dc=1000, ship=3000, group=7), - _toss_item(1, 12, "2026-08-31T23:30:00+09:00", 5000, ship=3000, group=7, name="뚜껑")], "p2"), - ("2026-08-01", "p2"): ([_toss_item(2, 21, "2026-08-31T16:00:00Z", 9900, status="CANCELED_PAYMENT"), # 9/1 01:00 KST - _toss_item(3, 31, "2026-08-31T09:00:00", 4000, status="BEFORE_PAYMENT")], None), - ("2026-09-01", None): ([_toss_item(4, 41, "2026-09-01T10:00:00", 15000, status="COMPLETED_RETURN")], None), + ("2026-08-01", None): ([item(1, 11, "2026-08-31T23:30:00+09:00", 20000, qty=2, dc=1000, ship=3000, group=7), + item(1, 12, "2026-08-31T23:30:00+09:00", 5000, ship=3000, group=7, name="뚜껑")], "p2"), + ("2026-08-01", "p2"): ([item(2, 21, "2026-08-31T16:00:00Z", 9900, status="CANCELED_PAYMENT", # 9/1 01:00 KST + canceled="2026-08-31T17:30:00Z"), # 9/1 02:30 — 클레임 없음 + item(3, 31, "2026-08-31T09:00:00", 4000, status="BEFORE_PAYMENT")], None), + ("2026-09-01", None): ([item(4, 41, "2026-09-01T10:00:00", 15000, status="COMPLETED_RETURN"), + item(6, 61, "2026-09-02T10:00:00", 5000, status="CANCELED_PAYMENT", + canceled="2026-09-02T11:00:00")], None), # 클레임 환불은 9/5(기간 밖) → 여기선 안 뺌 + # 기간 앞 90일(5/3~7/31) 조회의 마지막 구간 — 7/15 주문을 8/10 에 취소(클레임 있음) + ("2026-07-04", None): ([item(5, 51, "2026-07-15T10:00:00", 7000, qty=2, status="CANCELED_PAYMENT", + canceled="2026-08-10T09:00:00")], None), } - settle = { - ("2026-08-01", None): ([_toss_step("PAY", 2, 21, "2026-08-31T16:00:00Z", 9900), - _toss_step("REFUND", 2, 21, "2026-08-31T17:30:00Z", -9900)], "s2"), # 9/1 02:30 KST - ("2026-08-01", "s2"): ([_toss_step("REFUND", 2, None, "2026-08-31T17:30:00Z", -3000), # 배송비 줄 → 제외 - _toss_step("REFUND", 9, 91, "2026-07-31T10:00:00", -5000)], None), # 기간 밖 - ("2026-09-01", None): ([_toss_step("REFUND", 4, 41, "2026-09-02T09:00:00+09:00", 15000)], None), - } - calls, scalls = [], [] + claims = [ + _toss_claim(1, "RETURN", "COMPLETED", 4, 41, 15000, refunded="2026-09-02T09:00:00"), + _toss_claim(2, "CANCEL", "COMPLETED", 5, 51, 3500, refunded="2026-08-10T09:05:00", qty=2), # 금액은 주문 price 7,000 + _toss_claim(3, "CANCEL", "COMPLETED", 6, 61, 5000, refunded="2026-09-05T10:00:00"), # 기간 밖 + _toss_claim(4, "CANCEL", "COMPLETED", 8, 81, 4400, refunded="2026-08-15T10:00:00"), # 90일보다 오래된 주문 + _toss_claim(5, "EXCHANGE", "COMPLETED", 1, 11, 20000, refunded="2026-09-01T10:00:00"), # 교환 → 제외 + _toss_claim(6, "CANCEL", "REQUESTED", 1, 12, 5000), # 미환불 → 제외 + ] + calls, ccalls = [], [] def get(url, params=None, headers=None, timeout=None): - if url.endswith("/settlement-steps"): - assert params["dateCondition"] == "TRANSACTION_DATE" and params["size"] == 100 - scalls.append((params["fromDate"], params["toDate"], params.get("nextToken"))) - rows, tok = settle.get((params["fromDate"], params.get("nextToken")), ([], None)) - return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"items": rows, "nextToken": tok}}) - key = (params["startDate"], params.get("nextCursor")) + if url.endswith("/claims"): + ccalls.append(params.get("nextToken")) + page = claims[:3] if not params.get("nextToken") else claims[3:] + tok = None if params.get("nextToken") else "c2" + return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"items": page, "nextToken": tok, + "hasNext": tok is not None}}) + assert not url.endswith("/settlement-steps"), "수집은 정산 건별을 부르지 않는다" calls.append((params["startDate"], params["endDate"], params.get("nextCursor"))) - rows, cur = pages.get(key, ([], None)) + rows, cur = pages.get((params["startDate"], params.get("nextCursor")), ([], None)) return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"results": rows, "nextCursor": cur}}) def post(url, data=None, timeout=None, headers=None): @@ -531,21 +555,25 @@ def test_toss_collect_sales(): finally: httpx.post, httpx.get, ts.CALL_INTERVAL_SEC = orig assert r["ok"], r - assert calls == [("2026-08-01", "2026-08-31", None), ("2026-08-01", "2026-08-31", "p2"), - ("2026-09-01", "2026-09-02", None)] # 31일 구간 + 커서 - assert scalls == [("2026-08-01", "2026-08-31", None), ("2026-08-01", "2026-08-31", "s2"), - ("2026-09-01", "2026-09-02", None)] + assert [c for c in calls if c[0] >= "2026-08-01"] == [ + ("2026-08-01", "2026-08-31", None), ("2026-08-01", "2026-08-31", "p2"), ("2026-09-01", "2026-09-02", None)] + assert [(a, b) for a, b, _ in calls if a < "2026-08-01"] == [ + ("2026-05-03", "2026-06-02"), ("2026-06-03", "2026-07-03"), ("2026-07-04", "2026-07-31")] # 앞 90일 + assert ccalls == [None, "c2"] # 클레임 목록 끝까지 ev_ = {k[2]: v for k, v in st.events.items() if k[0] == "toss"} refunds = {k: v for k, v in ev_.items() if k.startswith("toss:R")} - assert set(ev_) - set(refunds) == {"toss:1", "toss:2", "toss:4"} # 결제 전(3)만 제외 - assert sorted((v["amount"], v["sales_date"]) for v in refunds.values()) == [ - (-15000, date(2026, 9, 2)), (-9900, date(2026, 9, 1))] # 환불일 기준, 배송비 줄·기간 밖 제외 - assert all(v["event_type"] == "CANCEL" for v in refunds.values()) - # 순 거래액: 9/1 = 매출 9,900(주문 2) − 환불 9,900 = 0, 9/2 = 0 − 15,000 + assert set(ev_) - set(refunds) == {"toss:1", "toss:2", "toss:4", "toss:6"} # 결제 전(3)만 제외 + assert {k: (v["amount"], v["sales_date"], v["event_type"]) for k, v in refunds.items()} == { + "toss:R21": (-9900, date(2026, 9, 1), "CANCEL"), # 클레임 없는 결제취소 → canceledAt + "toss:R41": (-15000, date(2026, 9, 2), "RETURN"), # 반품 → 클레임 refundedDt + "toss:R51": (-7000, date(2026, 8, 10), "CANCEL"), # 앞 90일 주문 — 금액은 주문 price(판매가 × 수량) + "toss:R81": (-4400, date(2026, 8, 15), "CANCEL"), # 주문 내역에 없는 오래된 주문 → 클레임 order.price + } # R61: 클레임 환불(9/5)이 기간 밖 → canceledAt(9/2)으로 넣지 않음, 교환·미환불 클레임 제외 net = {} for v in ev_.values(): net[v["sales_date"]] = net.get(v["sales_date"], 0) + v["amount"] - assert net == {date(2026, 8, 31): 25000, date(2026, 9, 1): 15000 + 9900 - 9900, date(2026, 9, 2): -15000} + assert net == {date(2026, 8, 10): -7000, date(2026, 8, 15): -4400, date(2026, 8, 31): 25000, + date(2026, 9, 1): 9900 + 15000 - 9900, date(2026, 9, 2): 5000 - 15000} assert ev_["toss:1"]["amount"] == 25000 and ev_["toss:1"]["discount_amount"] == 1000 # 할인 전·배송비 제외 assert ev_["toss:1"]["quantity"] == 3 and ev_["toss:1"]["product_name"] == "밀폐용기 외 1건" assert ev_["toss:1"]["sales_date"] == date(2026, 8, 31) @@ -600,15 +628,16 @@ def test_toss_reconcile_hides_personal(): assert f[k]["personal"] and f[k]["sample"] == "", k assert not f["productName"]["personal"] and f["productName"]["sample"] == "밀폐용기" assert "홍길동" not in repr(rec) and "010-1234-5678" not in repr(rec) and "010-9999-8888" not in repr(rec) - # 날짜별: 매출(주문일) · 환불(환불일, 배송비 줄 제외) · 순 거래액 + # 날짜별: 매출(주문일) · 환불(환불일, 적용 규칙) · 순 거래액 — 9/10 환불 = 반품 클레임 5,000 + 클레임 없는 결제취소 11,900 assert rec["days"] == [{"date": "2026-09-09", "orders": 2, "amount": 29900, "claimed": 0, "ship": 29900}, - {"date": "2026-09-10", "orders": 0, "amount": 0, "claimed": 9900, "ship": -9900}] + {"date": "2026-09-10", "orders": 0, "amount": 0, "claimed": 16900, "ship": -16900}] assert rec["day_cols"]["ship"].startswith("순 거래액") labels = [p["label"] for p in rec["probes"]] - assert any("결제 뒤 취소·반품(매출 포함)" in x for x in labels) - assert any(x.startswith("정산 REFUND — 환불") for x in labels) and any("배송비 줄" in x for x in labels) - # 환불 후보 세 가지 — 날짜별 합계 + 건별 + assert any("결제 뒤 취소·반품(매출 포함)" in x for x in labels) and any("정산 건별" in x for x in labels) + # 환불 출처별 — 적용 규칙 · 클레임 · 취소 시각 · 정산(참고), 날짜별 합계 + 건별 cand = {c["key"]: c for c in rec["refund_candidates"]} + assert rec["refund_candidates"][0]["key"] == "rule" and cand["rule"]["days"] == {"2026-09-10": 16900} + assert sorted(x["orderId"] for x in cand["rule"]["rows"]) == ["7", "8"] assert cand["settlement"]["days"] == {"2026-09-10": 9900} assert cand["canceled"]["days"] == {"2026-09-10": 11900} and cand["canceled"]["rows"][0]["orderId"] == "7" assert "주문일 2026-08-20" in cand["canceled"]["rows"][0]["note"] diff --git a/app/static/performance.js b/app/static/performance.js index 97ff1ee..a168fbd 100644 --- a/app/static/performance.js +++ b/app/static/performance.js @@ -1008,10 +1008,10 @@ ["orders", "amount", "claimed", "ship"].map(function (k) { return '' + fmt(r.days.reduce(function (a, d) { return a + (d[k] || 0); }, 0)) + ""; }).join("") + "" : ""; - // 환불 후보(토스쇼핑) — 후보별 날짜 합계를 나란히, 아래에 건별 목록(주문번호·금액·메모) + // 환불 출처별(토스쇼핑) — 출처별 날짜 합계를 나란히, 아래에 건별 목록(주문번호·금액·메모) const rc = r.refund_candidates || []; const candDays = (r.days || []).map(function (d) { return d.date; }); - const cands = rc.length ? '

환불 후보 — 쇼핑몰 화면 "환불"과 같은 열을 알려 주세요

' + + const cands = rc.length ? '

환불 출처별 비교 — 첫 열(적용 규칙)이 저장되는 환불

' + '' + rc.map(function (c) { return ""; }).join("") + "" + candDays.map(function (dt) { diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index bba03cb..c2deaa4 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -165,22 +165,23 @@ - **매출 규칙 = 파트너스 "순 거래액" = 매출 − 환불**(2026-10-01 사용자 지정, 9/6 화면: 매출 29,600 − 환불 11,900 = 순 거래액 17,700). - 매출 SALE = 주문 하나(`toss:{orderId}`), 날짜 = `orderedAt` 의 한국 날짜, 금액 = `price` 합(할인 전, 배송비 제외), 할인은 `discount_amount` 로만. 결제 전(`BEFORE_PAYMENT`)만 빼고 나중에 취소·반품된 주문도 주문일 매출에 둔다(화면 "매출"도 환불 전). - - 환불 CANCEL = 정산 건별 `GET /api/v3/shopping-fep/settlement-steps?dateCondition=TRANSACTION_DATE&fromDate&toDate&size=100&nextToken` - (31일, 결제·환불·배송비 줄)의 **`stepType=REFUND` 상품 줄**(배송비 줄 = `orderProductId` 없음 → 제외), 날짜 = 환불 거래 일시 - `transactionTs` 의 한국 날짜, 금액 = −|`orderProductPrice`|(없으면 판매가 × 수량). 사건 ID `toss:R{orderProductId}-{거래일시}`. - 클레임 목록 API 는 날짜로 거를 수 없고(REQUESTED·REVOKED 만 7일 조회) 결제완료 단계의 고객 취소는 클레임으로 안 잡혀서 쓰지 않는다. - - `replace_range`(접두어 `toss:` — 매출·환불 함께 교체). 진행 막대 = 주문 + 정산 31일 구간 수. 개인정보(주문자·수령인·주소·요청사항· - 송장)는 저장 안 함. -- **실데이터 대조(2026-10-01, 9/6)**: 매출 29,600 = 주문 2건 `price` 합 **일치**(`orderedAt` 은 시간대 없이 한국 시간 — - 17:57 주문도 9/6). 환불 11,900 은 **정산 REFUND 에 없다**(9/6 거래일 정산 = PAY 2줄 + 배송비 2줄뿐, 9/6 주문은 둘 다 구매확정) → - 다른 날 주문을 9/6 에 환불한 건이 정산 건별에 안 나온다(구매확정 전 취소는 정산에 안 올라오는 듯). 그래서 원본 데이터 확인에 - **환불 후보 세 가지**(`refund_candidates`)를 날짜별로 나란히: ① 정산 REFUND(현재 규칙) ② 주문 `canceledAt`(기간 90일 전 주문까지 - 조회) ③ 클레임 목록 `refundedDt`(`isRefunded`, 금액 `order.price` — 클레임 목록은 날짜 조건이 없어 전체를 넘겨 거름, 최대 1만 건) - + 건별(주문번호·금액·메모). 화면 11,900 과 같은 후보로 수집 규칙을 바꾼다(**미확정**). + - 환불 = **환불일**에 뺀다, 주문상품마다 한 번(사건 ID `toss:R{orderProductId}`), `merge_refunds`: + ① 클레임 목록 `GET /api/v3/shopping-fep/claims?size=100&nextToken`(유형·상태 조건 없음 = 전체 — 이 API 는 그 밖엔 날짜로 못 거른다, + 최대 1만 건)의 **환불 완료**(`isRefunded`) `CANCEL`·`RETURN` — 날짜 = `refundedDt`. 반품은 이것뿐(주문 내역엔 반품 완료 날짜 없음). + 사건 종류 CANCEL / RETURN. + ② 클레임이 **없는** 결제취소(`CANCELED_PAYMENT`) — 날짜 = 주문 내역 `canceledAt`(결제완료 단계 고객 취소는 클레임이 안 생김). + 클레임이 있는 주문상품은 클레임 날짜만 쓴다(그 날짜가 기간 밖이어도 취소 시각으로 다시 넣지 않음 — 날짜가 흔들리지 않게). + 금액 = 그 주문상품의 `price`(판매가 × 수량 — 매출과 같은 기준), 주문 내역에 없으면 클레임 `order.price`. 다른 날 주문의 환불을 잡으려고 + 수집 때 **기간 앞 90일**(`CANCEL_LOOKBACK_DAYS`) 주문 내역도 부른다. 교환·미환불 클레임은 제외. + - 수집은 `collect` 를 직접 구현(주문 내역을 매출·환불 금액·취소 시각에 함께 쓰려고). 진행 막대 = 기간 주문 구간 + 앞 90일 구간 + 클레임 1. + `replace_range`(접두어 `toss:` — 매출·환불 함께 교체). 개인정보(주문자·수령인·주소·요청사항·수거 주소·요청 사유·송장)는 저장 안 함. +- **실데이터 대조(2026-10-01, 9/6)**: 매출 29,600 = 주문 2건 `price` 합 **일치**(`orderedAt` 은 시간대 없이 한국 시간 — 17:57 주문도 9/6). + 환불 11,900 = 9/5 주문(276435356)을 9/6 취소 — 클레임 `CANCEL/COMPLETED` `refundedDt` 9/6 과 `canceledAt` 9/6 **둘 다 일치**, + 정산 건별 REFUND 에는 **없다**(9/6 거래일 정산 = PAY 2줄 + 배송비 2줄뿐 — 구매확정 전 취소는 정산에 안 올라옴) → 정산은 환불에 쓰지 않는다. +- 원본 데이터 확인(토스쇼핑): 날짜별 **매출(주문일)·환불(환불일)·순 거래액**(`day_cols`, = 저장되는 값) + **환불 출처별 비교** + (`refund_candidates`: 적용 규칙 · 클레임 환불 완료 · 주문 취소 시각 · 정산 REFUND(참고), 날짜별 합계 + 건별 주문번호·금액·메모) + + 주문 상태별·클레임·정산 항목 합계. 화면 숫자와 다르면 출처별 열로 어느 쪽이 빠졌는지 본다. - 정산 줄의 다른 항목: 셀러 부담 쿠폰 `shoppingDiscountMerchant`, 정산 지급액 `settlementAmount`, 수수료 `payFee`·`productFee`. -- 대조: 설정 화면 "쇼핑몰 원본 데이터 확인" → 토스쇼핑 — 날짜별 **매출(주문일)·환불(환불일)·순 거래액**(`day_cols`)과 주문 상태별· - 정산 stepType 별 항목 합계. 파트너스 화면 숫자와 다르면 금액 항목(`price` / `price − totalDiscountPrice`, 환불 `orderProductPrice` / - `orderProductPaidAmount`)이나 날짜 기준을 여기서 보고 고친다(실데이터 대조는 아직 — 운영 서버 IP 에서만 호출됨). ### 연동 단계 체크리스트(쇼핑몰마다)
날짜" + esc(c.label) + "