fix(performance): 11번가 매출 — 정산된 주문은 정산 판매금액합계(배송비 줄 포함)

셀러오피스 "판매 상세내역"(정산) 대조: 9/10 주문은 상품 83,800 + 배송비 줄 3,000
= 86,800 인데 주문 목록의 dlvCst 는 0 이라 주문 목록만으로는 3,000 이 빠진다.
정산 API 의 selPrcAmt 합(121,700 = 34,900 + 3,000 + 83,800)은 판매 상세내역과 같다.

- 정산 내역을 [기간, 기간+45일(오늘까지)] 불러 결제일(ordStlEndDt)로 거르고
  주문별 selPrcAmt 합을 매출로(정산확정 상태, cupnAmt = 11번가 부담 할인)
- 정산 전 주문만 주문 상태 목록의 ordAmt + 배송비
- 사건을 주문 단위(11st:{ordNo})로 — 정산 전/후가 같은 ID 라 바뀌어도 한 건
- 테스트·문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-30 01:24:58 +09:00
parent 40d94e2892
commit f037ea7de0
3 changed files with 112 additions and 65 deletions
+79 -45
View File
@@ -5,12 +5,15 @@
(공식 이용방법 openapi.11st.co.kr → OpenApiOperationGuide SERVICE_METHOD, 2026-09-30 확인)
응답은 XML(euc-kr). 없는 주소는 500 + resultCode -997 "등록된 API 정보가 존재하지 않습니다", 건이 없으면 -1 "해당 건이 없습니다".
매출(2026-09-30 실데이터로 확정 — 설정 화면 "11번가 원본 데이터 확인"):
- 주문 상태 목록 4개(결제완료·발송대기·배송중·배송완료)는 지금 그 상태인 주문만 준다. 배송완료 목록에 구매확정 주문도 남는다.
- SALE = 주문 한 줄, 날짜 = 결제일(ordStlEndDt, 없으면 주문일 ordDt), 금액 = ordAmt(판매금액, 11번가 부담 쿠폰 전)
+ 배송비(dlvCst, 주문번호당 한 번). ordAmt − ordPayAmt = 11번가 부담 할인(tmallApplyDscAmt). 수수료는 판매금액 기준.
매출(2026-09-30 실데이터·셀러오피스 "판매 상세내역"으로 확정):
- SALE = 주문 하나(`11st:{ordNo}`), 날짜 = 결제일.
- 정산된 주문: 정산 내역(/rest/settlement/settlementList/{yyyyMMdd}/{yyyyMMdd}, 정산확정일 stlDy 기준)의
판매금액합계(selPrcAmt) 합 — 판매 상세내역과 같고 배송비(도서산간 등)가 별도 줄로 들어 있다.
예: 9/10 주문 = 83,800 + 배송비 줄 3,000 = 86,800 (주문 목록의 dlvCst 는 0 이라 주문 목록만으로는 모자람).
- 정산 전 주문: 주문 상태 목록 4개(결제완료·발송대기·배송중·배송완료 — 지금 그 상태인 주문만, 배송완료에 구매확정 주문도
남음)의 ordAmt(판매금액, 11번가 부담 쿠폰 전) + 배송비(dlvCst 최댓값 한 번). 정산되면 다음 업데이트 때 정산 값으로 바뀐다.
- ordAmt − ordPayAmt = 11번가 부담 할인(= 정산 cupnAmt/tmallApplyDscAmt). 수수료는 판매금액 기준(34,900 × 13% = 4,537).
- 취소·반품된 주문은 목록에서 빠진다 → 기간을 통째로 다시 받아(replace_range) 매출에서 빠진다(취소 사건을 따로 만들지 않음).
- 정산 내역(/rest/settlement/settlementList/{yyyyMMdd}/{yyyyMMdd})은 정산확정일(stlDy) 기준 — 확인 도구에서만 쓴다.
"""
from __future__ import annotations
@@ -134,10 +137,9 @@ ORDER_STATUS = {"complete": "결제완료", "packaging": "발송대기", "shippi
# 목록의 날짜 조건이 주문일인지 상태 변경일(배송완료일 등)인지 문서로 확인 못 해, 기간 뒤로 넉넉히 더 불러
# 주문일로 거른다(나중에 배송완료된 주문도 빠지지 않게).
LOOKAHEAD_DAYS = 30
SETTLE_LOOKAHEAD_DAYS = 45 # 결제 → 정산확정(구매확정)까지 보통 1~3주
SETTLEMENT_PATH = "/rest/settlement/settlementList/{ds}/{de}"
EVENT_PREFIX = "11st:"
# raw 에 남길 항목 — 금액·날짜·상태·상품만(구매자 정보 제외)
RAW_KEEP = ("ordNo", "ordPrdSeq", "ordDt", "ordStlEndDt", "ordAmt", "ordPayAmt", "dlvCst", "ordQty", "prdNo",
"atmtBuyCnfrmYN", "pocnfrmDt", "selPrc", "ordPrdStat")
def _won(value: Any) -> int:
@@ -175,54 +177,86 @@ class ElevenstAdapter(MarketplaceAdapter):
]
# ── 수집 ──────────────────────────────────────────────
def _pages(self, ctx: AdapterContext, tmpl: str, lo: date, hi: date) -> Iterable[dict[str, str]]:
"""[lo, hi] 를 7일씩 나눠 한 주소를 부른다."""
s = lo
while s <= hi:
e = min(hi, s + timedelta(days=PROBE_CHUNK_DAYS - 1))
ds, de = s.strftime("%Y%m%d"), e.strftime("%Y%m%d")
yield from xml_records(self._get(ctx, tmpl.format(s=f"{ds}0000", e=f"{de}2359", ds=ds, de=de)))
s = e + timedelta(days=1)
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
"""주문 상태 목록 4개를 [start, end+30일(오늘까지)] 7일씩 불러 주문일이 [start, end] 인 줄만.
같은 줄(주문번호+순번)이 두 목록에 나오면(조회 사이 상태 변경) 한 번만.
배송비는 주문번호마다 줄들의 dlvCst 최댓값을 가장 앞 순번 줄에 한 번(_ship)."""
"""결제일이 [start, end] 인 주문을 주문 단위로 합쳐 돌려준다.
1) 정산 내역 — 정산확정일 기준이라 [start, end+45일(오늘까지)] 를 불러 결제일(ordStlEndDt)로 거른다.
판매금액합계(selPrcAmt)는 셀러오피스 "판매 상세내역"과 같고 배송비 줄(도서산간 등)도 따로 들어 있다.
2) 아직 정산 전인 주문 — 주문 상태 목록 4개([start, end+30일]) 의 ordAmt + 배송비(dlvCst 최댓값 한 번).
같은 주문이 정산에 있으면 정산 값을 쓴다(정산되면 다음 업데이트 때 정산 값으로 바뀜)."""
from app.timezone import today_kst # noqa: WPS433
hi = max(end, min(end + timedelta(days=LOOKAHEAD_DAYS), today_kst()))
today = today_kst()
orders: dict[str, dict[str, Any]] = {}
def acc(oid: str, src: str, day: date) -> dict[str, Any]:
return orders.setdefault(oid, {"ordNo": oid, "_src": src, "_day": day, "amount": 0, "qty": 0,
"discount": 0, "ship": 0, "names": [], "opt": "", "raw": {}})
settle_hi = max(end, min(end + timedelta(days=SETTLE_LOOKAHEAD_DAYS), today))
for r in self._pages(ctx, SETTLEMENT_PATH, start, settle_hi):
oid, day = str(r.get("ordNo") or ""), _day(r.get("ordStlEndDt"))
if not oid or day is None or not (start <= day <= end):
continue
o = acc(oid, "settlement", day)
o["amount"] += _won(r.get("selPrcAmt"))
o["qty"] += _won(r.get("ordQty"))
o["discount"] += _won(r.get("cupnAmt"))
if r.get("prdNm") and r["prdNm"] not in o["names"]:
o["names"].append(r["prdNm"])
o["opt"] = o["opt"] or str(r.get("slctPrdOptNm") or "")
for k in ("stlAmt", "selFee", "deductAmt", "bmStlDlvCst"):
o["raw"][k] = o["raw"].get(k, 0) + _won(r.get(k))
o["raw"]["stlDy"] = r.get("stlDy")
settled = set(orders)
hi = max(end, min(end + timedelta(days=LOOKAHEAD_DAYS), today))
seen: set[str] = set()
rows: list[dict[str, Any]] = []
for tmpl in ORDER_PATHS:
status = ORDER_STATUS[tmpl.split("/")[3]]
s = start
while s <= hi:
e = min(hi, s + timedelta(days=PROBE_CHUNK_DAYS - 1))
body = self._get(ctx, tmpl.format(s=s.strftime("%Y%m%d") + "0000", e=e.strftime("%Y%m%d") + "2359"))
for r in xml_records(body):
key = f"{r.get('ordNo')}-{r.get('ordPrdSeq')}"
day = _day(r.get("ordStlEndDt") or r.get("ordDt"))
if not r.get("ordNo") or key in seen or day is None or not (start <= day <= end):
continue
seen.add(key)
rows.append({**r, "_status": status})
s = e + timedelta(days=1)
ship: dict[str, tuple[int, int]] = {} # 주문번호 → (배송비, 가장 앞 순번)
for r in rows:
oid, seq = str(r["ordNo"]), _won(r.get("ordPrdSeq"))
cur = ship.get(oid, (0, seq))
ship[oid] = (max(cur[0], _won(r.get("dlvCst"))), min(cur[1], seq))
for r in rows:
fee, first = ship[str(r["ordNo"])]
yield {**r, "_ship": fee if _won(r.get("ordPrdSeq")) == first else 0}
for r in self._pages(ctx, tmpl, start, hi):
oid = str(r.get("ordNo") or "")
key = f"{oid}-{r.get('ordPrdSeq')}"
day = _day(r.get("ordStlEndDt") or r.get("ordDt"))
if not oid or oid in settled or key in seen or day is None or not (start <= day <= end):
continue
seen.add(key)
o = acc(oid, status, day)
o["amount"] += _won(r.get("ordAmt"))
o["ship"] = max(o["ship"], _won(r.get("dlvCst")))
o["qty"] += _won(r.get("ordQty"))
o["discount"] += max(0, _won(r.get("ordAmt")) - _won(r.get("ordPayAmt")))
if r.get("prdNm") and r["prdNm"] not in o["names"]:
o["names"].append(r["prdNm"])
o["opt"] = o["opt"] or str(r.get("slctPrdOptNm") or "")
o["raw"]["ordDt"] = r.get("ordDt")
for o in orders.values():
o["amount"] += o.pop("ship")
yield o
def normalize_order(self, r: dict[str, Any]) -> list[SaleEvent]:
"""주문 한 줄 → SALE. 금액 = 판매금액(ordAmt, 11번가 부담 쿠폰 전) + 배송비(_ship, 주문번호당 한 줄).
def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]:
"""주문 하나 → SALE(결제일). 금액 = 정산 판매금액합계(정산 전이면 ordAmt + 배송비) — 11번가 부담 쿠폰 전 금액.
수수료가 판매금액 기준이라(34,900 × 13% = 4,537, 정산 실데이터) 판매자 매출은 할인 전 금액으로 본다."""
oid, seq = str(r.get("ordNo") or ""), str(r.get("ordPrdSeq") or "")
day = _day(r.get("ordStlEndDt") or r.get("ordDt"))
oid, day = str(o.get("ordNo") or ""), o.get("_day")
if not oid or day is None:
return []
amount = _won(r.get("ordAmt")) + _won(r.get("_ship"))
opt = str(r.get("slctPrdOptNm") or "")
names = o.get("names") or []
name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else ""
return [SaleEvent(
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}-{seq}", external_order_id=oid,
external_line_id=seq, order_date=_day(r.get("ordDt")), payment_date=day, event_date=day,
amount=max(0, amount), product_name=str(r.get("prdNm") or "")[:200], option_name=opt[:200],
quantity=int(_won(r.get("ordQty"))), discount_amount=max(0, _won(r.get("ordAmt")) - _won(r.get("ordPayAmt"))),
order_status=str(r.get("_status") or ""),
raw={k: r.get(k) for k in RAW_KEEP if r.get(k) not in (None, "")},
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}", external_order_id=oid,
payment_date=day, event_date=day, amount=max(0, int(o.get("amount") or 0)),
product_name=name[:200], option_name=str(o.get("opt") or "")[:200], quantity=int(o.get("qty") or 0),
discount_amount=max(0, int(o.get("discount") or 0)),
order_status="정산확정" if o.get("_src") == "settlement" else str(o.get("_src") or ""),
raw={"source": o.get("_src"), **(o.get("raw") or {})},
)]
def _get(self, ctx: AdapterContext, path: str) -> bytes: