diff --git a/app/modules/performance/CLAUDE.md b/app/modules/performance/CLAUDE.md index 87d5355..3e37892 100644 --- a/app/modules/performance/CLAUDE.md +++ b/app/modules/performance/CLAUDE.md @@ -23,7 +23,7 @@ ## 카페24 적립금 · 네이버 배송비·환불 (2026-10-19 규칙 변경) - **카페24** 매출 = 결제합계 − 적립금 사용, 환불 = 실제 + 예치금(적립금 환불 제외). raw `points`. 주문 내역 창 **적립금 사용** 칸·합계. -- **네이버** 매출 = 판매금액(총) + 배송비(raw `goods`·`ship`), 환불 = 클레임 완료일(`CLAIM_COMPLETED_DATETIME`) 조회의 취소·반품 완료 상품주문 −결제금액(`naver:{상품주문}-RF`, raw `refund`). 주문 내역 창 **배송비·환불금액** 칸·합계. +- **네이버** 매출 = 판매금액(총) + 배송비(raw `goods`·`ship` — 배송 묶음마다 `deliveryFeeAmount` 한 번, 할인 안 뺌 = 판매분석 배송비, 10/18 87,500 확인), 환불 = 클레임 완료일(`CLAIM_COMPLETED_DATETIME`) 조회의 취소·반품 완료 상품주문 −결제금액(`naver:{상품주문}-RF`, raw `refund`). 주문 내역 창 **배송비·환불금액** 칸·합계. - 예전 규칙으로 받은 날은 [과거 매출 가져오기]로 다시 받아야 바뀜(최근 10일은 자동). 사용자 확인값 10/18: 카페24 적립금 16,820 · 네이버 배송비 87,500 · 환불 66,100 — 배포 뒤 대조. ## 매출 업데이트 diff --git a/app/modules/performance/adapters/naver.py b/app/modules/performance/adapters/naver.py index 65e27c4..709490d 100644 --- a/app/modules/performance/adapters/naver.py +++ b/app/modules/performance/adapters/naver.py @@ -13,8 +13,8 @@ ?from=…&to=…&rangeType=PAYED_DATETIME&pageSize=&page= — 결제일 기준, 한 번에 24시간까지(하루씩 부른다), from 부터 180일 안의 주문만. 응답에 주문·상품주문 상세가 바로 들어 있다(네이버 안내: 소량·조회용 권장 API). - SALE = 주문 하나(`naver:{orderId}`), 날짜 = 결제일(order.paymentDate). - 금액 = 상품주문들의 결제금액(productOrder.totalPaymentAmount) 합 **+ 배송비**(deliveryFeeAmount − deliveryDiscountAmount, - 2026-10-19 사용자 요청 — 예전엔 배송비 제외 = 판매금액(총)). raw = {goods: 상품 결제금액, ship: 배송비}. + 금액 = 상품주문들의 결제금액(productOrder.totalPaymentAmount) 합 **+ 배송비**(배송 묶음마다 deliveryFeeAmount 한 번, 할인 안 뺌 = + 판매분석 '배송비', 2026-10-19 사용자 요청·10/18 실데이터 87,500 확인 — 예전엔 배송비 제외). raw = {goods: 상품 결제금액, ship: 배송비}. - 결제 뒤 취소·반품된 상품주문도 결제일 매출에 그대로 둔다(판매금액(총)). 입금대기·미입금 취소만 뺀다. - **환불 = 환불된 날(클레임 완료일)에 뺀다**(2026-10-19): 같은 조회를 rangeType=CLAIM_COMPLETED_DATETIME 으로 하루씩 — 그날 취소·반품 완료(CANCELED·RETURNED)된 상품주문마다 CANCEL/RETURN(`naver:{productOrderId}-RF`), 금액 = −totalPaymentAmount. @@ -176,7 +176,9 @@ def field_summary(records: list[dict[str, str]]) -> list[dict[str, Any]]: def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dict[str, dict[str, Any]]: """상품주문 → 주문 하나로 합침(결제일이 [start, end] 이고 결제된 것 — 나중에 취소·반품된 것도 포함). 금액 = totalPaymentAmount 합(할인 뒤 상품 결제금액, 배송비 제외) = 판매분석 "판매금액(총)". - 배송비·취소/반품분은 참고용(ship·claimed)으로만 모은다.""" + 배송비(ship) = **배송 묶음(packageNumber, 없으면 주문)마다 deliveryFeeAmount 한 번**(묶음 안 최댓값), 배송비 할인은 빼지 않음 — + 네이버는 배송비·할인을 상품주문마다 반복해 적는다. 10/18 실데이터: 묶음당 한 번 = 87,500 = 판매분석 배송비 + (상품주문마다 배송비 − 할인 = 38,500 은 틀림, 2026-10-19 ship_check 로 확인). 취소/반품분은 참고용(claimed).""" orders: dict[str, dict[str, Any]] = {} for c in items: po, od = c.get("productOrder") or {}, c.get("order") or {} @@ -186,13 +188,15 @@ def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dic if not oid or day is None or not (start <= day <= end) or status in EXCLUDED_STATUS: continue o = orders.setdefault(oid, {"orderId": oid, "_day": day, "amount": 0, "ship": 0, "claimed": 0, "qty": 0, - "discount": 0, "names": [], "opt": "", "statuses": [], + "discount": 0, "names": [], "opt": "", "statuses": [], "_ship_pkg": {}, "order_day": _day(od.get("orderDate"))}) paid = _won(po.get("totalPaymentAmount")) o["amount"] += paid if status in CLAIMED_STATUS: o["claimed"] += paid - o["ship"] += _won(po.get("deliveryFeeAmount")) - _won(po.get("deliveryDiscountAmount")) + pkg = str(po.get("packageNumber") or oid) + o["_ship_pkg"][pkg] = max(o["_ship_pkg"].get(pkg, 0), _won(po.get("deliveryFeeAmount"))) + o["ship"] = sum(o["_ship_pkg"].values()) o["qty"] += _won(po.get("quantity")) o["discount"] += _won(po.get("productDiscountAmount")) name = str(po.get("productName") or "") @@ -239,7 +243,7 @@ def ship_check(items: Iterable[dict[str, Any]], start: date, end: date) -> dict[ "section": sum(r["section"] for r in rows)}, "per_order": per("order"), "per_package": per("package"), "orders": [{"order": k, "lines": v} for k, v in sorted(orders.items())], - "note": "판매분석 '배송비'와 같은 값의 후보를 찾는다 — 지금 매출 규칙은 per_product_order.fee_minus_discount", + "note": "판매분석 '배송비'와 같은 값의 후보 — 지금 매출 규칙은 per_package.max_fee(묶음마다 배송비 한 번, 할인 안 뺌)", } diff --git a/app/modules/performance/tests/test_performance.py b/app/modules/performance/tests/test_performance.py index 3334cfd..f7ec6a2 100644 --- a/app/modules/performance/tests/test_performance.py +++ b/app/modules/performance/tests/test_performance.py @@ -1541,8 +1541,9 @@ def test_naver_collect_sales(): assert r["ok"], r ev_ = {k[2]: v for k, v in st.events.items() if k[0] == "naver"} assert set(ev_) == {"naver:A", "naver:B", "naver:C", "naver:B1-RF", "naver:C2-RF"} # D 미입금취소만 제외, 교환은 환불 아님 - assert ev_["naver:A"]["amount"] == 20000 + 5000 + 3000 + 3000 # 판매금액 + 배송비(2026-10-19) - assert ev_["naver:A"]["raw"] == {"goods": 25000, "ship": 6000} + # 판매금액 + 배송비(2026-10-19) — 배송비는 배송 묶음(여기선 주문)마다 한 번(상품주문마다 반복돼 와도), 할인은 빼지 않음 + assert ev_["naver:A"]["amount"] == 20000 + 5000 + 3000 + assert ev_["naver:A"]["raw"] == {"goods": 25000, "ship": 3000} assert ev_["naver:B"]["amount"] == 9900 # 결제 뒤 취소도 결제일 매출(판매금액(총)) # 환불은 환불된 날(클레임 완료일)에 뺀다 — 결제일(9/9)이 아니라 9/10 assert (ev_["naver:B1-RF"]["amount"], ev_["naver:B1-RF"]["sales_date"], ev_["naver:B1-RF"]["event_type"]) == (-9900, date(2026, 9, 10), "CANCEL") @@ -1550,7 +1551,7 @@ def test_naver_collect_sales(): assert ("claim", "2026-09-09") in calls and ("claim", "2026-09-10") in calls assert ev_["naver:A"]["quantity"] == 3 and ev_["naver:A"]["discount_amount"] == 1000 assert ev_["naver:A"]["sales_date"] == date(2026, 9, 9) and ev_["naver:A"]["product_name"] == "밀폐용기 외 1건" - assert ev_["naver:C"]["amount"] == 15000 + 7000 # 반품 줄도 포함(배송비 3,000 − 할인 3,000 = 0) + assert ev_["naver:C"]["amount"] == 15000 + 7000 + 3000 # 반품 줄도 포함, 배송비 할인(조건부 무료)도 판매분석처럼 배송비에 넣음 assert ev_["naver:C"]["order_status"] == "구매확정/반품" assert ("2026-09-09", 2) in calls and ("2026-09-10", 2) not in calls # hasNext 일 때만 다음 쪽 assert "홍길동" not in repr(st.events) and "010-1234-5678" not in repr(st.events) @@ -2211,3 +2212,21 @@ def test_naver_ship_check_candidates(): assert got["per_package"]["groups"] == 4 and got["per_package"]["max_fee"] == 10500 assert [o["order"] for o in got["orders"]] == ["A", "B", "C", "D"] and len(got["orders"][0]["lines"]) == 2 assert "홍길동" not in repr(got) and "010-1234-5678" not in repr(got) + + +def test_naver_ship_once_per_package_like_sales_analysis(): + """10/18 실데이터 모양(2026-10-19): 상품주문마다 배송비 3,500·할인이 반복 — 묶음마다 배송비 한 번(할인 안 뺌) = 판매분석 배송비.""" + from app.modules.performance.adapters import naver as nv + + def it(order, po, fee, dc, pkg): + x = _naver_item(order, po, "2026-10-18", 10000, status="DELIVERING", ship=fee, ship_dc=dc) + x["content"]["productOrder"]["packageNumber"] = pkg + return x["content"] + + items = [it("A", "A1", 3500, 3500, "P1"), it("A", "A2", 3500, 3500, "P1"), # 조건부 무료 묶음 — 그래도 3,500 + it("B", "B1", 3500, 0, "P2"), it("B", "B2", 3500, 0, "P2"), it("B", "B3", 3500, 0, "P2"), + it("C", "C1", 0, 0, "P3"), # 무료배송 상품 + it("D", "D1", 3500, 0, "P4"), it("D", "D2", 3500, 0, "P5")] # 한 주문 두 묶음 = 두 번 + o = nv.group_orders(items, date(2026, 10, 18), date(2026, 10, 18)) + assert {k: v["ship"] for k, v in o.items()} == {"A": 3500, "B": 3500, "C": 0, "D": 7000} + assert sum(v["ship"] for v in o.values()) == nv.ship_check(items, date(2026, 10, 18), date(2026, 10, 18))["per_package"]["max_fee"] diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index 5f402a1..8525dc3 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -141,7 +141,11 @@ - **배송비 대조(2026-10-19)**: 10/18 실데이터 — 상품주문 53건(주문 30건), `deliveryFeeAmount` 합 157,500(3,500×45)·`deliveryDiscountAmount` 합 119,000(3,500×34)·`sectionDeliveryFee` 0 → 지금 규칙(상품주문마다 배송비 − 할인) 38,500, 판매분석 배송비는 87,500(3,500×25). 배송비·할인이 상품주문마다 반복돼 주문/배송 묶음 단위로 세야 하는 것으로 보여, 진단 `GET /api/marketplaces/naver/reconcile?date=` 응답에 - `ship_check`(상품주문·주문·배송 묶음(packageNumber) 단위 후보 합계 + 주문별 상품주문 배송비·할인·상태)를 추가 — 87,500 과 맞는 후보로 규칙 확정 예정. + `ship_check`(상품주문·주문·배송 묶음(packageNumber) 단위 후보 합계 + 주문별 상품주문 배송비·할인·상태)를 추가. + **확정(같은 날)**: `per_package.max_fee` = `per_order.max_fee` = **87,500** = 판매분석 배송비(배송비 있는 묶음 25개 × 3,500). + → 네이버는 배송비·할인을 상품주문마다 반복해 적고, 판매분석 '배송비'는 **배송 묶음마다 deliveryFeeAmount 한 번, 배송비 할인(조건부 무료 등)은 빼지 않은 값**. + 규칙을 그렇게 바꿈(`group_orders` — 묶음 `packageNumber`, 없으면 주문). 붙여 준 10/18 상품주문 53건을 새 규칙에 넣어 87,500 확인. + 주의: 할인된 배송비도 들어가므로 손님이 실제로 낸 배송비(38,500)보다 크다 — 판매분석 기준을 따른 것. - 설정 화면 **"쇼핑몰 원본 데이터 확인"**(네이버 선택): 결제일 기준 상품주문 전체의 항목별 합계, 상태별 합계, 날짜별 매출·그중 결제 뒤 취소/반품(참고)·배송비(참고). 개인정보(주문자·수령인·주소·연락처·메모)는 값 없이 이름만.