feat(performance): 토스쇼핑 매출 = 순 거래액(매출 − 환불) — 정산 건별 REFUND 를 환불일에 차감

- 사용자 지정: 토스쇼핑 파트너스 "순 거래액" 기준(9/6 화면 매출 29,600 − 환불 11,900 = 17,700)
- 환불: GET /settlement-steps dateCondition=TRANSACTION_DATE 의 stepType=REFUND 상품 줄 → CANCEL 사건,
  날짜 = transactionTs 한국 날짜, 금액 = -|orderProductPrice|, 배송비 줄 제외, 31일 구간 + nextToken
  (클레임 목록은 날짜로 거를 수 없고 결제완료 단계 고객 취소가 안 잡혀 정산 쪽을 사용)
- 원본 데이터 확인: 날짜별 매출(주문일)·환불(환불일)·순 거래액 + 정산 stepType 별 항목 합계
- 원본 확인 표의 매출 열 이름도 day_cols 로 바꿀 수 있게(performance.js), 캐시 버전 20261001b
- 테스트·문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-01 10:12:07 +09:00
parent a45f78217c
commit d75dec2a50
6 changed files with 176 additions and 38 deletions
@@ -476,9 +476,17 @@ def test_toss_token_and_connection():
httpx.post, httpx.get, ts.CALL_INTERVAL_SEC = orig
def _toss_step(step, order_id, op_id, ts, price, *, qty=1):
"""정산 건별 목록 items[] 한 줄 — op_id None = 배송비 줄."""
return {"orderId": order_id, "orderProductId": op_id, "transactionTs": ts, "originTransactionTs": "2026-08-31T16:00:00Z",
"stepType": step, "orderProductPrice": price, "stockPrice": price // max(1, qty), "quantity": qty,
"displayProductName": "밀폐용기", "orderProductStatus": "CANCELED_PAYMENT" if step == "REFUND" else "CONFIRMED_ORDER"}
def test_toss_collect_sales():
"""토스쇼핑 매출(잠정) = 주문 단위, 주문일(한국 날짜) 기준, 주문상품 price(판매가 × 수량) 합 — 할인 전, 배송비 제외.
결제 뒤 취소·반품도 포함, 결제 전만 뺀다. 31일 구간으로 나눠 부르고 커서로 끝까지 받는다. 구매자 정보는 저장 안 함."""
"""토스쇼핑 매출 = 파트너스 "순 거래액" = 매출 − 환불(9/6 화면: 29,600 − 11,900 = 17,700).
매출 = 주문 단위, 주문일(한국 날짜), 주문상품 price 합(할인 전·배송비 제외, 나중에 취소·반품된 주문 포함, 결제 전 제외).
환불 = 정산 건별(거래일 기준) REFUND 상품 줄, 환불일. 31일 구간 + 커서. 구매자 정보는 저장 안 함."""
import httpx
from app.modules.performance.adapters import toss as ts
@@ -490,9 +498,21 @@ def test_toss_collect_sales():
_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),
}
calls = []
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 = [], []
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"))
calls.append((params["startDate"], params["endDate"], params.get("nextCursor")))
rows, cur = pages.get(key, ([], None))
@@ -513,8 +533,19 @@ def test_toss_collect_sales():
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)]
ev_ = {k[2]: v for k, v in st.events.items() if k[0] == "toss"}
assert set(ev_) == {"toss:1", "toss:2", "toss:4"} # 결제 전(3)만 제외
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
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 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)
@@ -535,10 +566,15 @@ def test_toss_reconcile_hides_personal():
access_token_expires_at=str(int(_t.time()) + 99999)))
rows = [_toss_item(1, 11, "2026-09-09T10:00:00", 20000, ship=3000, group=1),
_toss_item(2, 21, "2026-09-09T11:00:00", 9900, status="CANCELED_PAYMENT", ship=3000, group=2)]
steps = [_toss_step("REFUND", 2, 21, "2026-09-10T11:00:00", -9900), _toss_step("REFUND", 2, None, "2026-09-10T11:00:00", -3000)]
def get(url, params=None, headers=None, timeout=None):
if url.endswith("/settlement-steps"):
return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"items": steps, "nextToken": None}})
return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"results": rows, "nextCursor": None}})
orig = (httpx.get, ts.CALL_INTERVAL_SEC)
httpx.get = lambda url, params=None, headers=None, timeout=None: httpx.Response(
200, json={"resultType": "SUCCESS", "success": {"results": rows, "nextCursor": None}})
ts.CALL_INTERVAL_SEC = 0
httpx.get, ts.CALL_INTERVAL_SEC = get, 0
try:
rec = ts.TossAdapter().reconcile(ctx, date(2026, 9, 9), to=date(2026, 9, 10))
finally:
@@ -551,9 +587,13 @@ 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)
assert rec["days"] == [{"date": "2026-09-09", "orders": 2, "amount": 29900, "claimed": 9900, "ship": 6000},
{"date": "2026-09-10", "orders": 0, "amount": 0, "claimed": 0, "ship": 0}]
assert any("결제 뒤 취소·반품(매출 포함)" in p["label"] for p in rec["probes"])
# 날짜별: 매출(주문일) · 환불(환불일, 배송비 줄 제외) · 순 거래액
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}]
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)
def test_not_implemented_and_mock():