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:
@@ -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:
|
||||
|
||||
Reference in New Issue
Block a user