diff --git a/app/modules/performance/adapters/elevenst.py b/app/modules/performance/adapters/elevenst.py
index c0fe7e2..43e50db 100644
--- a/app/modules/performance/adapters/elevenst.py
+++ b/app/modules/performance/adapters/elevenst.py
@@ -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:
diff --git a/app/modules/performance/tests/test_performance.py b/app/modules/performance/tests/test_performance.py
index 5782473..8810861 100644
--- a/app/modules/performance/tests/test_performance.py
+++ b/app/modules/performance/tests/test_performance.py
@@ -887,30 +887,40 @@ def test_elevenst_connection():
def test_elevenst_collect_sales():
- """11번가 매출 = 주문 상태 목록(결제완료·발송대기·배송중·배송완료)의 줄, 결제일(없으면 주문일) 기준,
- 금액 = ordAmt + 배송비(주문번호마다 최댓값을 가장 앞 줄에 한 번). 같은 줄이 두 목록에 나와도 한 번, 기간 밖 주문일은 제외.
- 실데이터 9/9: ordAmt 34,900 / ordPayAmt 34,900, 9/10: ordAmt 83,800 / ordPayAmt 72,740(11번가 쿠폰 11,060)."""
+ """11번가 매출 = 주문 단위, 결제일 기준.
+ 정산된 주문은 정산 내역의 판매금액합계(selPrcAmt) 합 — 셀러오피스 "판매 상세내역"과 같다(배송비 줄 포함).
+ 정산 전 주문은 주문 상태 목록의 ordAmt + 배송비. 실데이터: 9/9 = 34,900, 9/10 = 83,800 + 배송비 3,000 = 86,800
+ (주문 목록의 dlvCst 는 0 이라 정산 값을 써야 맞음)."""
import httpx
- import app.modules.performance.sync as syncmod
+ import app.modules.performance.sync as syncmod # noqa: F401
import app.timezone as _tz
- from app.modules.performance.adapters import elevenst as ev
def line(no, seq, day, amt, pay, ship=0, qty=1):
return (f"{no}{seq}{day} 15:13:16"
f"{amt}{pay}{ship}{qty}"
f"밀폐용기홍길동18550503")
+
+ def stl(no, pay_day, amt, qty, cupn=0):
+ return (f"{no}1홍길동"
+ f"{pay_day}2026/09/19밀폐용기{qty}"
+ f"{amt}{amt - 100}{cupn}")
+ settlement = ("" + stl("20260909099415322", "2026/09/09", 34900, 1) +
+ stl("20260910099718265", "2026/09/10", 3000, 0) + stl("20260910099718265", "2026/09/10", 83800, 2, 11060) +
+ stl("20260801000000009", "2026/08/01", 9999, 1) + "").encode()
completed = ("" + line("20260909099415322", 1, "2026-09-09", 34900, 34900) +
line("20260910099718265", 1, "2026-09-10", 83800, 72740, qty=2) +
- line("20260910099718265", 2, "2026-09-10", 10000, 10000, ship=3000) +
line("20260801000000001", 1, "2026-08-01", 5000, 5000) + "").encode()
- packaging = ("" + line("20260909099415322", 1, "2026-09-09", 34900, 34900) +
- line("20260911000000002", 1, "2026-09-11", 20000, 20000, ship=3000) + "").encode()
+ packaging = ("" + line("20260911000000002", 1, "2026-09-11", 20000, 20000, ship=3000) +
+ line("20260911000000002", 2, "2026-09-11", 5000, 5000, ship=3000) +
+ line("20260911000000002", 2, "2026-09-11", 5000, 5000, ship=3000) + "").encode()
empty = "-1해당 건이 없습니다.".encode()
calls = []
def route(url, headers=None, timeout=None):
calls.append(url)
+ if "/settlement/" in url:
+ return httpx.Response(200, content=settlement if "/20260916/" in url else empty)
if "/ordservices/completed/" in url:
return httpx.Response(200, content=completed)
if "/ordservices/packaging/" in url:
@@ -928,13 +938,13 @@ def test_elevenst_collect_sales():
httpx.get, _tz.today_kst = orig, orig_today
assert r["ok"], r
ev_ = {k[2]: v for k, v in st.events.items() if k[0] == "elevenst"}
- assert set(ev_) == {"11st:20260909099415322-1", "11st:20260910099718265-1", "11st:20260910099718265-2",
- "11st:20260911000000002-1"} # 중복 1번, 8/1 주문 제외
- assert ev_["11st:20260909099415322-1"]["amount"] == 34_900 and ev_["11st:20260909099415322-1"]["sales_date"] == date(2026, 9, 9)
- assert ev_["11st:20260910099718265-1"]["amount"] == 83_800 + 3_000 # 2번 줄의 배송비를 앞 줄에 한 번
- assert ev_["11st:20260910099718265-1"]["discount_amount"] == 11_060
- assert ev_["11st:20260910099718265-2"]["amount"] == 10_000
- assert ev_["11st:20260911000000002-1"]["amount"] == 23_000
+ assert set(ev_) == {"11st:20260909099415322", "11st:20260910099718265", "11st:20260911000000002"} # 8/1 제외
+ assert ev_["11st:20260909099415322"]["amount"] == 34_900 and ev_["11st:20260909099415322"]["sales_date"] == date(2026, 9, 9)
+ assert ev_["11st:20260910099718265"]["amount"] == 86_800 # 정산 값(배송비 줄 포함)
+ assert ev_["11st:20260910099718265"]["discount_amount"] == 11_060 and ev_["11st:20260910099718265"]["quantity"] == 2
+ assert ev_["11st:20260910099718265"]["order_status"] == "정산확정"
+ assert ev_["11st:20260911000000002"]["amount"] == 25_000 + 3_000 # 정산 전: ordAmt + 배송비 한 번, 중복 줄 1번
+ assert ev_["11st:20260911000000002"]["order_status"] == "발송대기"
assert "홍길동" not in repr(st.events) and "18550503" not in repr(st.events) # 구매자 정보 미저장
assert any("/20260930" in u for u in calls) and not any("/20261001" in u for u in calls) # 오늘까지만 더 불러옴
diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md
index 4ff165b..1069312 100644
--- a/docs/PERFORMANCE_MODULE.md
+++ b/docs/PERFORMANCE_MODULE.md
@@ -92,12 +92,15 @@
개인정보 값 숨김)으로 실데이터를 보고 확정했다(2026-09-30).
- 주문 상태 목록 4개(`/rest/ordservices/complete|packaging|shipping|completed/{yyyyMMddHHmm}/{…}`)는 **지금 그 상태인 주문만**
준다. 배송완료 목록에 구매확정 주문도 남는다. 취소·반품된 주문은 목록에서 빠지고 `/rest/claimservice/canceledorders|…` 에 있다.
-- SALE = 주문 한 줄(`11st:{ordNo}-{ordPrdSeq}`), 날짜 = 결제일(`ordStlEndDt`, 없으면 주문일 `ordDt`), 금액 = `ordAmt`
- (판매금액, 11번가 부담 쿠폰 전) + 배송비(`dlvCst`, 주문번호마다 최댓값을 가장 앞 줄에 한 번). `ordAmt − ordPayAmt` = 11번가
- 부담 할인(`discount_amount` 에 기록). 수수료는 판매금액 기준(정산 `selFee` = 34,900 × 13%).
+- SALE = **주문 하나**(`11st:{ordNo}`), 날짜 = 결제일.
+ - **정산된 주문**: 정산 내역(`/rest/settlement/settlementList/{yyyyMMdd}/{yyyyMMdd}`, 정산확정일 `stlDy` 기준 → 기간 뒤 45일
+ (오늘까지)을 더 불러 결제일 `ordStlEndDt` 로 거름)의 **판매금액합계 `selPrcAmt` 합**. 셀러오피스 "판매 상세내역"과 같고
+ 배송비(도서산간 등)가 별도 줄로 들어 있다 — 9/10 주문 83,800 + 배송비 줄 3,000 = 86,800(주문 목록 `dlvCst` 는 0).
+ - **정산 전 주문**: 주문 상태 목록의 `ordAmt`(판매금액, 11번가 부담 쿠폰 전) + 배송비(`dlvCst` 최댓값 한 번). 기간 뒤 30일을 더
+ 불러 주문일로 거른다. 정산되면 다음 업데이트 때 정산 값으로 바뀐다.
+ - `ordAmt − ordPayAmt` = 정산 `cupnAmt` = 11번가 부담 할인(`discount_amount`). 수수료는 판매금액 기준(34,900 × 13% = 4,537).
- `replace_range` — 기간을 통째로 다시 받아 취소·반품된 주문이 매출에서 빠진다(취소 사건을 따로 만들지 않음 → 지난 날짜
- 금액이 나중에 줄 수 있음). 목록의 날짜 조건이 주문일인지 상태 변경일인지 몰라 **기간 뒤 30일(오늘까지)을 더 불러 주문일로 거른다.**
-- 정산 내역 `/rest/settlement/settlementList/{yyyyMMdd}/{yyyyMMdd}` 은 정산확정일(`stlDy`) 기준 — 확인 도구에서만 쓴다.
+ 금액이 나중에 줄 수 있음). 구매자 이름·아이디·연락처는 저장하지 않는다.
### 연동 단계 체크리스트(쇼핑몰마다)