Merge branch 'feat/perf-points-shipping'
This commit is contained in:
@@ -20,6 +20,12 @@
|
||||
- 1단계는 모의 데이터(`is_sample`)·구조까지, 실제 수집은 쇼핑몰별로 공식 문서 확인 후 순차 구현.
|
||||
- 쇼핑몰 화면 수치와 맞출 때는 필드 추측 말고 붙여넣기 비교 + 원본 필드 합계로 진단부터.
|
||||
|
||||
## 카페24 적립금 · 네이버 배송비·환불 (2026-10-19 규칙 변경)
|
||||
|
||||
- **카페24** 매출 = 결제합계 − 적립금 사용, 환불 = 실제 + 예치금(적립금 환불 제외). raw `points`. 주문 내역 창 **적립금 사용** 칸·합계.
|
||||
- **네이버** 매출 = 판매금액(총) + 배송비(raw `goods`·`ship`), 환불 = 클레임 완료일(`CLAIM_COMPLETED_DATETIME`) 조회의 취소·반품 완료 상품주문 −결제금액(`naver:{상품주문}-RF`, raw `refund`). 주문 내역 창 **배송비·환불금액** 칸·합계.
|
||||
- 예전 규칙으로 받은 날은 [과거 매출 가져오기]로 다시 받아야 바뀜(최근 10일은 자동). 사용자 확인값 10/18: 카페24 적립금 16,820 · 네이버 배송비 87,500 · 환불 66,100 — 배포 뒤 대조.
|
||||
|
||||
## 매출 업데이트
|
||||
|
||||
- 진행 창에서 쇼핑몰별 [중지](그 쇼핑몰만 멈추고 다음 쇼핑몰로).
|
||||
|
||||
@@ -488,23 +488,27 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
marketplace_code=target,
|
||||
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}-PAY", external_order_id=oid,
|
||||
order_date=_day(order.get("order_date")), payment_date=pay_day, event_date=pay_day,
|
||||
amount=max(0, order_total(order)), product_name=name,
|
||||
# 적립금 사용분은 매출에서 뺀다(2026-10-19 사용자 요청) — 결제합계 − 적립금(points_spent_amount)
|
||||
amount=max(0, order_total(order) - order_amounts(order)["points_spent_amount"]), product_name=name,
|
||||
quantity=sum(int(i.get("quantity") or 0) for i in items), order_status="결제완료",
|
||||
discount_amount=sum(order_amounts(order)[k] for k in DISCOUNT_FIELDS + COUPON_FIELDS),
|
||||
raw={"order_id": oid, "market_id": order.get("market_id"), "order_place_id": order.get("order_place_id"),
|
||||
"items": len(items), **{f"initial_{k}": v for k, v in order_amounts(order).items()}},
|
||||
"items": len(items), **{f"initial_{k}": v for k, v in order_amounts(order).items()},
|
||||
"points": order_amounts(order)["points_spent_amount"], "points_excluded": True},
|
||||
)]
|
||||
|
||||
def normalize_refund(self, refund: dict[str, Any]) -> list[SaleEvent]:
|
||||
"""환불 → CANCEL/RETURN(−). 원 주문의 market_id 로 결제와 같은 쇼핑몰 열에 넣는다.
|
||||
금액 = 실제 환불액 + 적립금·예치금 환불(카페24 일별 매출 환불합계와 같음, 실데이터 확인)."""
|
||||
금액 = 실제 환불액 + 예치금 환불 — 적립금으로 돌려준 금액은 뺀다(2026-10-19, 결제에서 적립금을 빼므로 앞뒤를 맞춤.
|
||||
예전 = 카페24 일별 매출 환불합계와 같은 실제 + 적립금·예치금)."""
|
||||
if refund.get("_kind") == "claim":
|
||||
return self.normalize_claim(refund)
|
||||
day = _day(refund.get("refund_date"))
|
||||
code = str(refund.get("refund_code") or "")
|
||||
if day is None or not code:
|
||||
return []
|
||||
amount = refund_total(refund)
|
||||
points = _won(refund.get("used_points"))
|
||||
amount = refund_total(refund) - points
|
||||
return [SaleEvent(
|
||||
marketplace_code=target_code(refund.get("_market_id"), refund.get("_order_place_id")),
|
||||
event_type="RETURN" if code.upper().startswith("R") else "CANCEL",
|
||||
@@ -515,7 +519,8 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
raw={"refund_code": code, "order_id": refund.get("order_id"), "status": refund.get("status"),
|
||||
"actual_refund_amount": refund.get("actual_refund_amount"),
|
||||
"used_points": refund.get("used_points"), "used_credits": refund.get("used_credits"),
|
||||
"quantity": refund.get("quantity"), "order_item_code": refund.get("order_item_code")},
|
||||
"quantity": refund.get("quantity"), "order_item_code": refund.get("order_item_code"),
|
||||
"points": -points, "points_excluded": True},
|
||||
)]
|
||||
|
||||
def normalize_claim(self, c: dict[str, Any]) -> list[SaleEvent]:
|
||||
|
||||
@@ -13,9 +13,12 @@
|
||||
?from=…&to=…&rangeType=PAYED_DATETIME&pageSize=&page= — 결제일 기준, 한 번에 24시간까지(하루씩 부른다),
|
||||
from 부터 180일 안의 주문만. 응답에 주문·상품주문 상세가 바로 들어 있다(네이버 안내: 소량·조회용 권장 API).
|
||||
- SALE = 주문 하나(`naver:{orderId}`), 날짜 = 결제일(order.paymentDate).
|
||||
금액 = 상품주문들의 결제금액(productOrder.totalPaymentAmount) 합 — 배송비 제외.
|
||||
금액 = 상품주문들의 결제금액(productOrder.totalPaymentAmount) 합 **+ 배송비**(deliveryFeeAmount − deliveryDiscountAmount,
|
||||
2026-10-19 사용자 요청 — 예전엔 배송비 제외 = 판매금액(총)). raw = {goods: 상품 결제금액, ship: 배송비}.
|
||||
- 결제 뒤 취소·반품된 상품주문도 결제일 매출에 그대로 둔다(판매금액(총)). 입금대기·미입금 취소만 뺀다.
|
||||
그래서 지난 날짜 매출이 나중에 줄지 않는다. 환불(판매금액(순))은 아직 따로 만들지 않는다.
|
||||
- **환불 = 환불된 날(클레임 완료일)에 뺀다**(2026-10-19): 같은 조회를 rangeType=CLAIM_COMPLETED_DATETIME 으로 하루씩 —
|
||||
그날 취소·반품 완료(CANCELED·RETURNED)된 상품주문마다 CANCEL/RETURN(`naver:{productOrderId}-RF`), 금액 = −totalPaymentAmount.
|
||||
판매분석의 환불금액처럼 결제일이 아니라 환불일 매출에서 빠진다.
|
||||
- 구매자 이름·연락처·주소는 저장하지 않는다.
|
||||
"""
|
||||
|
||||
@@ -201,6 +204,22 @@ def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dic
|
||||
return orders
|
||||
|
||||
|
||||
def refund_items(items: Iterable[dict[str, Any]], day: date) -> list[dict[str, Any]]:
|
||||
"""클레임 완료일 조회 결과 → 환불 줄(상품주문 하나 = 한 줄). 취소·반품 완료만, 금액 = 그 상품주문 결제금액."""
|
||||
out = []
|
||||
for c in items:
|
||||
po, od = c.get("productOrder") or {}, c.get("order") or {}
|
||||
status = str(po.get("productOrderStatus") or "")
|
||||
if status not in CLAIMED_STATUS:
|
||||
continue
|
||||
out.append({"product_order_id": str(po.get("productOrderId") or c.get("productOrderId") or ""),
|
||||
"order_id": str(od.get("orderId") or po.get("orderId") or ""), "day": day, "status": status,
|
||||
"amount": _won(po.get("totalPaymentAmount")), "qty": _won(po.get("quantity")),
|
||||
"name": str(po.get("productName") or ""), "opt": str(po.get("productOption") or ""),
|
||||
"order_day": _day(od.get("orderDate")), "pay_day": _day(od.get("paymentDate") or po.get("paymentDate"))})
|
||||
return out
|
||||
|
||||
|
||||
# 토큰을 발급한 인증정보 — 이 값들이 바뀌면 저장된 토큰을 쓰지 않고 새로 받는다(credential_fingerprint)
|
||||
TOKEN_KEYS = ("client_id", "client_secret", "account_id")
|
||||
|
||||
@@ -335,11 +354,12 @@ class NaverAdapter(MarketplaceAdapter):
|
||||
return body
|
||||
raise ApiError("네이버 API 호출 제한(429)이 계속됩니다. 잠시 뒤 다시 시도하세요.")
|
||||
|
||||
def _day_items(self, ctx: AdapterContext, d: date) -> list[dict[str, Any]]:
|
||||
"""결제일이 d(한국 시간 0시~23:59:59.999)인 상품주문 전체 — 모든 상태."""
|
||||
def _day_items(self, ctx: AdapterContext, d: date, range_type: str = "PAYED_DATETIME") -> list[dict[str, Any]]:
|
||||
"""기준일(range_type — 결제일 PAYED_DATETIME · 클레임 완료일 CLAIM_COMPLETED_DATETIME)이 d(한국 시간 0시~23:59:59.999)인
|
||||
상품주문 전체 — 모든 상태."""
|
||||
params: dict[str, Any] = {
|
||||
"from": f"{d.isoformat()}T00:00:00.000+09:00", "to": f"{d.isoformat()}T23:59:59.999+09:00",
|
||||
"rangeType": "PAYED_DATETIME", "pageSize": PAGE_SIZE,
|
||||
"rangeType": range_type, "pageSize": PAGE_SIZE,
|
||||
}
|
||||
out: list[dict[str, Any]] = []
|
||||
for page in range(1, MAX_PAGES + 1):
|
||||
@@ -352,8 +372,9 @@ class NaverAdapter(MarketplaceAdapter):
|
||||
raise ApiError(f"네이버 {d.isoformat()} 주문이 {MAX_PAGES}쪽을 넘어 끝까지 받지 못했습니다 — 저장하지 않았습니다.")
|
||||
return out
|
||||
|
||||
def _items(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
ctx.progress.plan((end - start).days + 1, "일") # 진행 막대: 하루 = 한 단계
|
||||
def _items(self, ctx: AdapterContext, start: date, end: date, *, plan: tuple[int, str] | None = None) -> Iterable[dict[str, Any]]:
|
||||
days = (end - start).days + 1
|
||||
ctx.progress.plan(*(plan or (days, "일"))) # 진행 막대: 하루 = 한 단계(매출 업데이트는 결제 + 환불 조회 = 하루 두 단계)
|
||||
d = start
|
||||
while d <= end:
|
||||
rows = self._day_items(ctx, d)
|
||||
@@ -363,7 +384,30 @@ class NaverAdapter(MarketplaceAdapter):
|
||||
|
||||
# ── 수집 ──────────────────────────────────────────────
|
||||
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
yield from group_orders(self._items(ctx, start, end), start, end).values()
|
||||
days = (end - start).days + 1
|
||||
yield from group_orders(self._items(ctx, start, end, plan=(days * 2, "일 조회")), start, end).values()
|
||||
|
||||
def fetch_refunds(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
|
||||
"""환불 — 클레임 완료일이 그날인 상품주문 중 취소·반품 완료(CANCELED·RETURNED)된 것(2026-10-19). 교환·미입금 취소는 아님."""
|
||||
d = start
|
||||
while d <= end:
|
||||
rows = self._day_items(ctx, d, "CLAIM_COMPLETED_DATETIME")
|
||||
ctx.progress.step(items=len(rows))
|
||||
yield from refund_items(rows, d)
|
||||
d += timedelta(days=1)
|
||||
|
||||
def normalize_refund(self, r: dict[str, Any]) -> list[SaleEvent]:
|
||||
if not r.get("amount") or not r.get("product_order_id"):
|
||||
return []
|
||||
is_return = r.get("status") == "RETURNED"
|
||||
return [SaleEvent(
|
||||
event_type="RETURN" if is_return else "CANCEL", external_event_id=f"{EVENT_PREFIX}{r['product_order_id']}-RF",
|
||||
external_order_id=str(r.get("order_id") or r["product_order_id"]), external_line_id=str(r["product_order_id"]),
|
||||
order_date=r.get("order_day"), payment_date=r.get("pay_day"), event_date=r["day"], amount=-int(r["amount"]),
|
||||
product_name=str(r.get("name") or "")[:200], option_name=str(r.get("opt") or "")[:200],
|
||||
quantity=-int(r.get("qty") or 0), order_status="반품완료" if is_return else "취소완료",
|
||||
raw={"product_order_id": r["product_order_id"], "status": r.get("status"), "refund": int(r["amount"])},
|
||||
)]
|
||||
|
||||
def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]:
|
||||
oid, day = str(o.get("orderId") or ""), o.get("_day")
|
||||
@@ -372,9 +416,12 @@ class NaverAdapter(MarketplaceAdapter):
|
||||
names = o.get("names") or []
|
||||
name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else ""
|
||||
statuses = [STATUS_KO.get(s, s) for s in o.get("statuses") or []]
|
||||
goods, ship = max(0, int(o.get("amount") or 0)), max(0, int(o.get("ship") or 0))
|
||||
return [SaleEvent(
|
||||
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}", external_order_id=oid,
|
||||
order_date=o.get("order_day"), payment_date=day, event_date=day, amount=max(0, int(o.get("amount") or 0)),
|
||||
# 판매금액(총) + 배송비(2026-10-19) — 환불은 환불일에 따로(fetch_refunds)
|
||||
order_date=o.get("order_day"), payment_date=day, event_date=day, amount=goods + ship,
|
||||
raw={"goods": goods, "ship": ship},
|
||||
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="/".join(statuses)[:50],
|
||||
)]
|
||||
|
||||
@@ -494,12 +494,23 @@ class PerformanceDBStore:
|
||||
rows = conn.execute(
|
||||
"SELECT id, event_type, external_order_id, external_line_id, order_date, payment_date, "
|
||||
" event_date, sales_date, product_name, option_name, quantity, amount, "
|
||||
" discount_amount, order_status, is_sample "
|
||||
" discount_amount, order_status, is_sample, "
|
||||
# 주문 내역 칸(2026-10-19) — 카페24 적립금(결제 +, 환불 −) · 네이버 배송비 · 네이버 환불금액(raw_data 의 숫자만)
|
||||
" raw_data ->> 'points' AS points, raw_data ->> 'ship' AS ship, raw_data ->> 'refund' AS refund "
|
||||
"FROM perf_sales_events WHERE marketplace_code = %s AND sales_date BETWEEN %s AND %s "
|
||||
"ORDER BY sales_date, external_order_id, event_type LIMIT %s",
|
||||
(code, start, end, limit),
|
||||
).fetchall()
|
||||
return [{k: _iso(v) for k, v in r.items()} for r in rows]
|
||||
out = []
|
||||
for r in rows:
|
||||
row = {k: _iso(v) for k, v in r.items()}
|
||||
for k in ("points", "ship", "refund"):
|
||||
try:
|
||||
row[k] = int(round(float(row[k]))) if row.get(k) not in (None, "") else None
|
||||
except (TypeError, ValueError):
|
||||
row[k] = None
|
||||
out.append(row)
|
||||
return out
|
||||
|
||||
def sample_count(self) -> int:
|
||||
with self._pool.connection() as conn:
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261019a" />{% endblock %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261019c" />{% endblock %}
|
||||
|
||||
{#- ROAS 덧붙임 — "광고비(ROAS%)". 광고비가 없으면 아무것도 안 붙는다. -#}
|
||||
{%- macro roas(p) -%}{%- if p is not none -%}<span class="perf-roas">({{ "{:,}".format(p) }}%)</span>{%- endif -%}{%- endmacro -%}
|
||||
@@ -224,4 +224,4 @@
|
||||
} | tojson }}</script>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/performance.js?v=20261019a" defer></script>{% endblock %}
|
||||
{% block scripts %}<script src="/static/performance.js?v=20261019b" defer></script>{% endblock %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261019a" />{% endblock %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261019c" />{% endblock %}
|
||||
|
||||
{%- macro won(v) -%}
|
||||
{%- if v is none -%}<span class="perf-na"></span>
|
||||
@@ -266,4 +266,4 @@
|
||||
} | tojson }}</script>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/performance.js?v=20261019a" defer></script>{% endblock %}
|
||||
{% block scripts %}<script src="/static/performance.js?v=20261019b" defer></script>{% endblock %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{% extends "erp_base.html" %}
|
||||
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261019a" />{% endblock %}
|
||||
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261019c" />{% endblock %}
|
||||
|
||||
{%- macro when(v) -%}{{ (v or '')[:16] | replace('T', ' ') or '—' }}{%- endmacro -%}
|
||||
|
||||
@@ -219,4 +219,4 @@
|
||||
</section>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/performance.js?v=20261019a" defer></script>{% endblock %}
|
||||
{% block scripts %}<script src="/static/performance.js?v=20261019b" defer></script>{% endblock %}
|
||||
|
||||
@@ -909,7 +909,7 @@ def test_cafe24_refund_total_includes_points_and_naverpay_cancels():
|
||||
finally:
|
||||
_tz.today_kst = orig
|
||||
by = {e.external_event_id: e for e in events if e.event_type != "SALE"}
|
||||
assert by["c24:C20260926-01"].amount == -(63_720 + 1_080) # 적립금 환불 포함
|
||||
assert by["c24:C20260926-01"].amount == -63_720 # 적립금 환불(1,080)은 뺀다(2026-10-19 — 매출도 적립금 제외)
|
||||
assert by["c24:NP1-01-CL"].amount == -55_800 and by["c24:NP1-01-CL"].event_type == "CANCEL"
|
||||
assert by["c24:NP1-01-CL"].event_date == date(2026, 9, 26) and by["c24:NP1-01-CL"].marketplace_code == "cafe24"
|
||||
assert by["c24:NP2-01-CL"].amount == -(40_000 - 1_000 + 3_000) # 판매가×수량 − 품목 쿠폰 + 전체취소 배송비
|
||||
@@ -975,7 +975,8 @@ def test_cafe24_paid_total_matches_daily_report():
|
||||
o["initial_order_amount"].update(payment_amount="42938.00", points_spent_amount="1000.00")
|
||||
assert order_total(o) == 42_938 + 1_000 + 3_000 == 46_938
|
||||
ev = _FakeCafe24([]).normalize_order(o)[0]
|
||||
assert ev.amount == 46_938 and ev.discount_amount == 1_000 + 5_000
|
||||
assert ev.amount == 46_938 - 1_000 and ev.discount_amount == 1_000 + 5_000 # 매출 = 결제합계 − 적립금(2026-10-19)
|
||||
assert ev.raw["points"] == 1_000 and ev.raw["points_excluded"]
|
||||
o["actual_order_amount"] = {**o["initial_order_amount"], "payment_amount": "20000.00"}
|
||||
assert order_total_now(o) == 20_000 + 1_000 + 3_000
|
||||
z = _c24_order("Z")
|
||||
@@ -1509,7 +1510,16 @@ def test_naver_collect_sales():
|
||||
}
|
||||
calls = []
|
||||
|
||||
refunds = { # 클레임 완료일 기준 조회 — 9/10 에 B1(9/9 결제) 취소 완료·C2 반품 완료, 교환은 환불 아님
|
||||
"2026-09-10": [_naver_item("B", "B1", "2026-09-09", 9900, status="CANCELED"),
|
||||
_naver_item("C", "C2", "2026-09-10", 7000, status="RETURNED"),
|
||||
_naver_item("E", "E1", "2026-08-30", 3000, status="EXCHANGED")]}
|
||||
|
||||
def get(url, params=None, headers=None, timeout=None):
|
||||
if params["rangeType"] == "CLAIM_COMPLETED_DATETIME":
|
||||
calls.append(("claim", params["from"][:10]))
|
||||
return httpx.Response(200, json={"data": {"contents": refunds.get(params["from"][:10], []),
|
||||
"pagination": {"page": params["page"], "hasNext": False}}})
|
||||
key = (params["from"][:10], params["page"])
|
||||
calls.append(key)
|
||||
rows, more = pages.get(key, ([], False))
|
||||
@@ -1530,12 +1540,17 @@ def test_naver_collect_sales():
|
||||
httpx.post, httpx.get, nv.CALL_INTERVAL_SEC = orig
|
||||
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"} # D 미입금취소만 제외
|
||||
assert ev_["naver:A"]["amount"] == 20000 + 5000 # 배송비 제외
|
||||
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}
|
||||
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")
|
||||
assert (ev_["naver:C2-RF"]["amount"], ev_["naver:C2-RF"]["event_type"], ev_["naver:C2-RF"]["raw"]["refund"]) == (-7000, "RETURN", 7000)
|
||||
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 # 반품 줄도 포함
|
||||
assert ev_["naver:C"]["amount"] == 15000 + 7000 # 반품 줄도 포함(배송비 3,000 − 할인 3,000 = 0)
|
||||
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)
|
||||
@@ -1598,6 +1613,8 @@ def test_sync_job_progress():
|
||||
|
||||
def get(url, params=None, headers=None, timeout=None):
|
||||
day = params["from"][:10]
|
||||
if params["rangeType"] != "PAYED_DATETIME": # 환불(클레임 완료일) 조회 — 이 테스트엔 없음
|
||||
return httpx.Response(200, json={"data": {"contents": [], "pagination": {"hasNext": False}}})
|
||||
if day == "2026-09-10": # 둘째 날을 받는 중 — 진행 상황 중간 모습
|
||||
mid.update(job.snapshot())
|
||||
rows = [_naver_item("A" + day, "P" + day, day, 10000), _naver_item("B" + day, "Q" + day, day, 5000)]
|
||||
@@ -1618,14 +1635,15 @@ def test_sync_job_progress():
|
||||
job.finish(last_update_at="2026-09-30T10:00:00")
|
||||
|
||||
m = {s["code"]: s for s in mid["shops"]}
|
||||
assert m["naver"]["state"] == "running" and (m["naver"]["done"], m["naver"]["total"], m["naver"]["unit"]) == (1, 2, "일")
|
||||
assert m["naver"]["items"] == 2 and m["naver"]["fraction"] == 0.5
|
||||
assert mid["overall"]["shops"] == 1 and mid["overall"]["fraction"] == 0.5 and not mid["finished"]
|
||||
# 네이버 = 하루에 결제·환불 두 번 조회(2026-10-19) — 2일 = 4단계
|
||||
assert m["naver"]["state"] == "running" and (m["naver"]["done"], m["naver"]["total"], m["naver"]["unit"]) == (1, 4, "일 조회")
|
||||
assert m["naver"]["items"] == 2 and m["naver"]["fraction"] == 0.25
|
||||
assert mid["overall"]["shops"] == 1 and mid["overall"]["fraction"] == 0.25 and not mid["finished"]
|
||||
|
||||
snap = job.snapshot()
|
||||
s = {x["code"]: x for x in snap["shops"]}
|
||||
assert s["naver"]["state"] == "done" and s["naver"]["upserted"] == 4 and s["naver"]["items"] == 4
|
||||
assert s["naver"]["done"] == s["naver"]["total"] == 2 and s["naver"]["fraction"] == 1.0
|
||||
assert s["naver"]["done"] == s["naver"]["total"] == 4 and s["naver"]["fraction"] == 1.0
|
||||
assert s["ohouse"]["state"] == "error" and s["ohouse"]["status"] in ("not_implemented", "not_configured")
|
||||
assert not s["ohouse"]["active"]
|
||||
assert s["elevenst"]["state"] == "error" and s["elevenst"]["status"] == "not_configured" and not s["elevenst"]["active"]
|
||||
|
||||
@@ -366,3 +366,7 @@ td.is-link:hover { background: #eef2ff; text-decoration: underline; }
|
||||
.perf-opt-row { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; }
|
||||
.perf-opt-label { font-weight: 600; }
|
||||
.perf-head-notes { display: inline-flex; align-items: center; gap: 12px; margin-right: auto; margin-left: 12px; font-size: 12px; }
|
||||
/* 주문 내역 추가 칸(카페24 적립금 · 네이버 배송비·환불금액, 2026-10-19) */
|
||||
.perf-ev-table .perf-ev-x { white-space: nowrap; color: #6b4e00; }
|
||||
.perf-ev-xsub { font-size: 11px; font-weight: 500; color: var(--color-midtone-gray, #777); }
|
||||
.perf-ev-table tfoot .perf-ev-x, .perf-ev-table tfoot .perf-ev-xsub { color: inherit; }
|
||||
|
||||
@@ -653,29 +653,51 @@
|
||||
const rows = res.rows || [];
|
||||
if (!rows.length) { m.body.innerHTML = '<p class="perf-muted">내역이 없습니다.</p>'; return; }
|
||||
const KIND = { SALE: "결제", CANCEL: "취소", RETURN: "반품", ADJUST: "조정" };
|
||||
// 쇼핑몰별 추가 칸(2026-10-19) — 카페24 적립금 사용(매출에서 뺀 금액, 환불 줄은 돌려준 적립금 −),
|
||||
// 네이버 배송비(매출에 더한 금액)·환불금액(환불된 날 매출에서 뺀 금액). 맨 아래 합계.
|
||||
const EXTRA = { cafe24: [{ key: "points", label: "적립금 사용" }],
|
||||
naver: [{ key: "ship", label: "배송비" }, { key: "refund", label: "환불금액" }] }[code] || [];
|
||||
const xsum = EXTRA.map(function () { return { plus: 0, minus: 0 }; });
|
||||
let sum = 0, sales = 0, minus = 0;
|
||||
const body = rows.map(function (r) {
|
||||
sum += r.amount;
|
||||
if (r.amount >= 0) sales += r.amount; else minus += r.amount;
|
||||
const xcells = EXTRA.map(function (x, k) {
|
||||
const v = r[x.key];
|
||||
if (v == null || v === 0) return '<td class="perf-num perf-ev-x"></td>';
|
||||
if (v > 0) xsum[k].plus += v; else xsum[k].minus += v;
|
||||
return '<td class="perf-num perf-ev-x">' + fmt(v) + "</td>";
|
||||
}).join("");
|
||||
return '<tr class="' + (r.event_type === "CANCEL" ? "is-cancel" : r.amount < 0 ? "perf-ev-cancel" : "") + '">' +
|
||||
"<td>" + esc(r.sales_date) + "</td><td>" + esc(KIND[r.event_type] || r.event_type) +
|
||||
(r.is_sample ? ' <span class="perf-pill">테스트</span>' : "") + "</td>" +
|
||||
"<td>" + esc(r.external_order_id) + "</td>" +
|
||||
'<td class="perf-ev-name">' + esc(r.product_name) + (r.option_name ? " <span class='perf-muted'>" + esc(r.option_name) + "</span>" : "") + "</td>" +
|
||||
'<td class="perf-num">' + esc(r.quantity) + "</td>" +
|
||||
'<td class="perf-num">' + fmt(r.amount) + "</td>" +
|
||||
'<td class="perf-num">' + fmt(r.amount) + "</td>" + xcells +
|
||||
"<td>" + esc(r.order_date || "") + "</td><td>" + esc(r.payment_date || "") + "</td>" +
|
||||
"<td>" + esc(r.order_status) + "</td></tr>";
|
||||
}).join("");
|
||||
m.body.innerHTML =
|
||||
'<div class="perf-ev-wrap"><table class="perf-table perf-ev-table"><thead><tr>' +
|
||||
'<th class="perf-th-label">매출일</th><th class="perf-th-label">구분</th><th class="perf-th-label">주문번호</th>' +
|
||||
'<th class="perf-th-label perf-ev-name">상품명</th><th>수량</th><th>금액</th><th class="perf-th-label">주문일</th>' +
|
||||
'<th class="perf-th-label perf-ev-name">상품명</th><th>수량</th><th>금액</th>' +
|
||||
EXTRA.map(function (x) { return '<th class="perf-ev-x">' + esc(x.label) + "</th>"; }).join("") +
|
||||
'<th class="perf-th-label">주문일</th>' +
|
||||
'<th class="perf-th-label">결제일</th><th class="perf-th-label">상태</th></tr></thead><tbody>' + body +
|
||||
'</tbody><tfoot><tr class="perf-row-total"><th class="perf-td-label" colspan="5">결제 ' + fmt(sales) +
|
||||
" / 취소·반품 " + fmt(minus) + '</th><td class="perf-num">' + fmt(sum) + '</td><td colspan="3"></td></tr></tfoot></table></div>' +
|
||||
" / 취소·반품 " + fmt(minus) + '</th><td class="perf-num">' + fmt(sum) + "</td>" +
|
||||
EXTRA.map(function (x, k) {
|
||||
const s = xsum[k];
|
||||
return '<td class="perf-num perf-ev-x"><b>' + fmt(s.plus || s.minus ? (s.plus || s.minus) : 0) + "</b>" +
|
||||
(s.plus && s.minus ? '<div class="perf-ev-xsub">환불 ' + fmt(s.minus) + "</div>" : "") + "</td>";
|
||||
}).join("") +
|
||||
'<td colspan="3"></td></tr></tfoot></table></div>' +
|
||||
(res.truncated ? '<p class="perf-muted">처음 500건만 표시합니다.</p>' : "") +
|
||||
'<p class="perf-muted">수수료는 일·쇼핑몰 단위로 계산되어 주문별로는 표시하지 않습니다.</p>';
|
||||
'<p class="perf-muted">수수료는 일·쇼핑몰 단위로 계산되어 주문별로는 표시하지 않습니다.' +
|
||||
(code === "cafe24" ? " 금액은 적립금 사용분을 뺀 값입니다(환불도 적립금으로 돌려준 금액은 뺌)." : "") +
|
||||
(code === "naver" ? " 결제 금액은 판매금액 + 배송비, 환불은 환불된 날에 빠집니다." : "") +
|
||||
" 적립금·배송비 칸이 비어 있으면 규칙을 바꾸기 전에 받은 자료입니다 — 실적 설정 → 과거 매출 가져오기로 그 기간을 다시 받으세요.</p>";
|
||||
} catch (err) {
|
||||
m.body.innerHTML = '<p class="perf-notice is-warn">' + esc(err.message) + "</p>";
|
||||
}
|
||||
|
||||
@@ -40,6 +40,13 @@
|
||||
**카페24 관리자 "일별 매출내역"과 같은 기준**으로 센다(처음의 품목 결제금액 방식은 배송비가 빠지고 환불 날짜 기준이 달라
|
||||
화면과 맞지 않아 교체).
|
||||
|
||||
> **2026-10-19 규칙 변경 — 적립금 제외**(사용자 요청): 매출(SALE) = 결제합계 **− 적립금 사용**(`initial_order_amount.points_spent_amount`),
|
||||
> 환불 = 실제 환불액 + 예치금 환불(**적립금으로 돌려준 `used_points` 는 뺌** — 결제에서 뺐으니 앞뒤를 맞춤, 사용자 선택).
|
||||
> 그래서 카페24 열은 이제 카페24 일별 매출내역의 결제합계·환불합계보다 적립금만큼 작다(아래 표·대조 설명은 그 전 기준).
|
||||
> 사건 raw 에 `points`(결제 = 사용 적립금, 환불 = −돌려준 적립금)·`points_excluded: true`. 주문 내역 창에 **적립금 사용** 칸 + 합계
|
||||
> (맨 아래 = 결제 쪽 합, 환불이 있으면 "환불 −n" 따로). 사용자 확인값: 10/18 적립금 사용 16,820원.
|
||||
> 규칙을 바꾸기 전에 받은 날은 [과거 매출 가져오기]로 다시 받아야 바뀐다(최근 10일은 자동 업데이트가 다시 받음).
|
||||
|
||||
| 사건 | 조회 | 금액·날짜 |
|
||||
|---|---|---|
|
||||
| SALE(결제합계) | `GET /admin/orders` `date_type=pay_date`, `embed=items`, `paid=T` | +(실결제금액 + 적립금 + 예치금 + 네이버포인트), `initial_order_amount` + 주문 `naver_point`(결제 당시 금액 — 환불을 따로 빼므로 취소 후 금액 X), 결제일. 주문 1건 = 사건 1건(`{order_id}-PAY`) |
|
||||
@@ -122,6 +129,15 @@
|
||||
할인 = `productDiscountAmount` 합. 결제 뒤 취소·반품(`CANCELED`·`RETURNED`)도 포함, 입금대기·미입금 취소만 뺀다
|
||||
→ 지난 날짜 매출이 나중에 줄지 않는다. `replace_range`.
|
||||
- 환불(판매금액(순))은 아직 사건으로 만들지 않는다 — 필요하면 클레임 완료일 기준 CANCEL/RETURN 을 추가.
|
||||
- **2026-10-19 규칙 변경**(사용자 요청 — "판매금액에 배송비는 추가하고 환불 금액은 빼 주세요", 환불은 환불된 날):
|
||||
SALE 금액 = 판매금액(총) **+ 배송비**(상품주문 `deliveryFeeAmount − deliveryDiscountAmount` 합, 주문마다 0 미만이면 0),
|
||||
raw `{goods, ship}`. 환불 = 같은 조회를 `rangeType=CLAIM_COMPLETED_DATETIME` 으로 하루씩 다시 불러(매출 업데이트는 하루 2번 조회 —
|
||||
진행 막대 단위 "일 조회") 그날 클레임이 끝난 상품주문 중 **CANCELED·RETURNED**(교환·미입금 취소 제외)마다
|
||||
CANCEL/RETURN `naver:{productOrderId}-RF`, 금액 = −`totalPaymentAmount`(상품 결제금액, 배송비 환불은 넣지 않음), 날짜 = 환불(클레임 완료)일,
|
||||
raw `{refund}`. 그래서 네이버 열 = 판매금액(총) + 배송비 − 환불금액(환불일). 주문 내역 창에 **배송비·환불금액** 칸 + 합계.
|
||||
사용자 확인값: 10/18 배송비 87,500원·환불 66,100원 — 배포 뒤 10/18 주문 내역 맨 아래 합계와 비교해 맞는지 확인할 것
|
||||
(환불이 다르면 배송비 환불·클레임 종류 포함 여부를 실데이터로 조정). `replace_range` 라 다시 받으면 그 기간 환불도 교체.
|
||||
네이버는 조회 시작일 180일 제한이 있어 그보다 오래된 날은 다시 받을 수 없다(예전 규칙 그대로 남음).
|
||||
- 설정 화면 **"쇼핑몰 원본 데이터 확인"**(네이버 선택): 결제일 기준 상품주문 전체의 항목별 합계, 상태별 합계, 날짜별
|
||||
매출·그중 결제 뒤 취소/반품(참고)·배송비(참고). 개인정보(주문자·수령인·주소·연락처·메모)는 값 없이 이름만.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user