From f037ea7de0100445703a3a0bdc35b56173df49d0 Mon Sep 17 00:00:00 2001 From: king Date: Wed, 30 Sep 2026 01:24:58 +0900 Subject: [PATCH] =?UTF-8?q?fix(performance):=2011=EB=B2=88=EA=B0=80=20?= =?UTF-8?q?=EB=A7=A4=EC=B6=9C=20=E2=80=94=20=EC=A0=95=EC=82=B0=EB=90=9C=20?= =?UTF-8?q?=EC=A3=BC=EB=AC=B8=EC=9D=80=20=EC=A0=95=EC=82=B0=20=ED=8C=90?= =?UTF-8?q?=EB=A7=A4=EA=B8=88=EC=95=A1=ED=95=A9=EA=B3=84(=EB=B0=B0?= =?UTF-8?q?=EC=86=A1=EB=B9=84=20=EC=A4=84=20=ED=8F=AC=ED=95=A8)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 셀러오피스 "판매 상세내역"(정산) 대조: 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 --- app/modules/performance/adapters/elevenst.py | 124 +++++++++++------- .../performance/tests/test_performance.py | 40 +++--- docs/PERFORMANCE_MODULE.md | 13 +- 3 files changed, 112 insertions(+), 65 deletions(-) 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`) 기준 — 확인 도구에서만 쓴다. + 금액이 나중에 줄 수 있음). 구매자 이름·아이디·연락처는 저장하지 않는다. ### 연동 단계 체크리스트(쇼핑몰마다)