fix(performance): 네이버 배송비 = 배송 묶음마다 한 번(할인 안 뺌) — 판매분석 배송비와 같게
10/18 실데이터: 상품주문마다 배송비 − 할인 = 38,500 → 묶음마다 deliveryFeeAmount 한 번 = 87,500(판매분석과 일치) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -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 — 배포 뒤 대조.
|
||||
|
||||
## 매출 업데이트
|
||||
|
||||
@@ -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(묶음마다 배송비 한 번, 할인 안 뺌)",
|
||||
}
|
||||
|
||||
|
||||
|
||||
@@ -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"]
|
||||
|
||||
@@ -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)보다 크다 — 판매분석 기준을 따른 것.
|
||||
- 설정 화면 **"쇼핑몰 원본 데이터 확인"**(네이버 선택): 결제일 기준 상품주문 전체의 항목별 합계, 상태별 합계, 날짜별
|
||||
매출·그중 결제 뒤 취소/반품(참고)·배송비(참고). 개인정보(주문자·수령인·주소·연락처·메모)는 값 없이 이름만.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user