feat(performance): 카페24 마켓 연동 주문을 해당 쇼핑몰 열로 집계
- 카페24 마켓 통합관리가 가져온 주문(market_id ≠ self)을 MARKET_MAP 으로 네이버·쿠팡·11번가 등 열에 (SaleEvent.marketplace_code). 연결표에 없는 마켓은 카페24 열 — 전체 합계는 카페24 일별 매출내역과 같음 - 환불도 원 주문의 마켓으로 같은 열에 - 카페24 사건 ID 에 c24: 접두어, 기간 교체는 카페24 열 + 다른 열의 c24: 행만 — 직접 연동분은 보존 - 매출 대조 마켓별 표에 "반영 열", 설정 화면에 "카페24 경유" 표시 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -105,6 +105,9 @@ class SaleEvent:
|
||||
discount_amount: int = 0
|
||||
order_status: str = ""
|
||||
raw: dict[str, Any] = field(default_factory=dict)
|
||||
# 어느 쇼핑몰 열로 집계할지 — None 이면 이 어댑터의 쇼핑몰. 다른 쇼핑몰 주문을 대신 받아 오는
|
||||
# 연동(예: 카페24 마켓 통합관리가 가져온 스마트스토어 주문)은 해당 쇼핑몰 코드를 넣는다.
|
||||
marketplace_code: str | None = None
|
||||
|
||||
def validate(self) -> None:
|
||||
if self.event_type not in EVENT_TYPES:
|
||||
@@ -148,6 +151,9 @@ class MarketplaceAdapter(ABC):
|
||||
# 쇼핑몰 API 가 "기간 안 결제·환불"을 빠짐없이 돌려줄 때만 켠다 — 규칙이 바뀌거나
|
||||
# 주문이 사라져도 예전 행이 남지 않는다. False 면 같은 사건 ID 만 덮어쓴다(upsert).
|
||||
replace_range: bool = False
|
||||
# replace_range 일 때 이 어댑터가 만든 사건을 가려내는 외부 사건 ID 접두어. 다른 쇼핑몰 열로 보낸
|
||||
# 사건(marketplace_code 지정)도 이 접두어로 찾아 함께 교체한다 — 그 쇼핑몰의 직접 연동분은 건드리지 않음.
|
||||
event_prefix: str = ""
|
||||
note: str = "" # 설정 화면 안내 문구
|
||||
|
||||
# ── 설정 ──────────────────────────────────────────────
|
||||
|
||||
@@ -13,9 +13,13 @@
|
||||
실제 환불액(actual_refund_amount). 환불코드가 R 로 시작하면 반품, 그 밖은 취소.
|
||||
- 수집 기간을 통째로 다시 받는다(replace_range) — 결제·환불 모두 기간 안 날짜로 조회되므로
|
||||
그 기간의 카페24 실데이터를 지우고 새로 넣는다. 규칙이 바뀌거나 주문이 사라져도 이중 집계 없음.
|
||||
- 자체몰 주문만(market_id 가 self/빈값). 카페24 로 연동돼 들어온 다른 마켓(스마트스토어·쿠팡 등)
|
||||
주문은 해당 쇼핑몰 어댑터와 이중 집계되지 않게 제외(환불도 원 주문의 market_id 로 판단).
|
||||
네이버페이 결제(order_place_id=NCHECKOUT)는 자체몰 주문이라 포함.
|
||||
- 자체몰 주문(market_id 가 self/빈값)은 카페24 열. 카페24 마켓 통합관리로 들어온 다른 마켓 주문
|
||||
(스마트스토어·쿠팡 등)은 MARKET_MAP 으로 해당 쇼핑몰 열에 넣는다(환불도 원 주문으로 판단).
|
||||
MARKET_MAP 에 없는 마켓은 카페24 열 — 전체 합계는 항상 카페24 일별 매출내역과 같다.
|
||||
네이버페이 결제(order_place_id=NCHECKOUT)는 자체몰 주문이라 카페24 열.
|
||||
카페24 가 만든 사건은 모두 외부 사건 ID 앞에 "c24:" — 다시 받을 때 이것만 골라 교체하므로
|
||||
해당 쇼핑몰을 나중에 직접 연동해도 그 데이터는 건드리지 않는다(단, 같은 주문을 양쪽에서 받지 않게
|
||||
직접 연동을 켜는 쇼핑몰은 MARKET_MAP 에서 빼야 한다).
|
||||
- 한 호출 검색기간 3개월 미만 → 60일씩 나눠 요청. orders limit ≤ 1000, refunds limit ≤ 500, offset ≤ 15000.
|
||||
- 개인정보(구매자 이름·주소·연락처·계좌)는 저장하지 않는다 — raw 에는 금액·상태 필드만.
|
||||
- 할인 항목 구성·마켓 주문 포함 여부는 `reconcile()`(설정 화면 "카페24 매출 대조")로 카페24 화면과
|
||||
@@ -45,6 +49,33 @@ LOOKUP_BATCH = 100
|
||||
MAX_OFFSET = 15000
|
||||
CHUNK_DAYS = 60
|
||||
SELF_MARKETS = {"", "self", None}
|
||||
EVENT_PREFIX = "c24:"
|
||||
|
||||
# 카페24 마켓 통합관리가 가져온 주문의 market_id(또는 order_place_id) → 우리 쇼핑몰 열.
|
||||
# 여기 없는 마켓(예: 옥션·인터파크)은 카페24 열에 남긴다 — 전체 합계는 항상 카페24 화면과 같다.
|
||||
# 실제 값은 설정 → "카페24 매출 대조"의 마켓별 표(market_id / 주문경로 / 반영 열)로 확인해 보탠다.
|
||||
MARKET_MAP: dict[str, str] = {
|
||||
"shopn": "naver", "smartstore": "naver", "storefarm": "naver", "naver": "naver",
|
||||
"coupang": "coupang",
|
||||
"sk11st": "elevenst", "11st": "elevenst", "elevenst": "elevenst",
|
||||
"gmarket": "gmarket",
|
||||
"lotteon": "lotteon", "lotte": "lotteon",
|
||||
"gsshop": "gsshop", "gs": "gsshop",
|
||||
"kakao": "kakao", "kakaotalkstore": "kakao", "talkstore": "kakao", "kakaostyle": "kakao",
|
||||
"ohouse": "ohouse", "todayhouse": "ohouse", "bucketplace": "ohouse",
|
||||
"toss": "toss", "tossshopping": "toss",
|
||||
}
|
||||
|
||||
|
||||
def target_code(market_id: Any, order_place_id: Any = None) -> str:
|
||||
"""이 주문을 집계할 쇼핑몰 열. 자체몰·모르는 마켓은 카페24."""
|
||||
if is_self_market(market_id):
|
||||
return "cafe24"
|
||||
for key in (market_id, order_place_id):
|
||||
code = MARKET_MAP.get(str(key or "").strip().lower())
|
||||
if code:
|
||||
return code
|
||||
return "cafe24"
|
||||
|
||||
# 결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰 (initial_order_amount 의 필드)
|
||||
DISCOUNT_FIELDS = ("membership_discount_amount", "set_product_discount_amount", "app_discount_amount",
|
||||
@@ -104,6 +135,7 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
auth_type = "shared"
|
||||
implemented = True
|
||||
replace_range = True
|
||||
event_prefix = EVENT_PREFIX
|
||||
docs_url = "https://apidocs.cafe24.com/docs/admin/get-orders"
|
||||
note = ("카페24 상품관리에서 연결한 OAuth 토큰을 함께 씁니다(여기서 따로 입력하지 않음). "
|
||||
"주문 읽기 권한이 필요해 권한 추가 후 한 번 다시 연결해야 합니다.")
|
||||
@@ -198,8 +230,8 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
{"start_date": s.isoformat(), "end_date": e.isoformat(),
|
||||
"date_type": "refund_date"}, REFUND_LIMIT)
|
||||
|
||||
def market_ids(self, ctx: AdapterContext, refunds: list[dict[str, Any]]) -> dict[str, Any]:
|
||||
"""환불의 원 주문 market_id — 주문일 60일 구간·100건씩 묶어 조회."""
|
||||
def market_ids(self, ctx: AdapterContext, refunds: list[dict[str, Any]]) -> dict[str, tuple[Any, Any]]:
|
||||
"""환불의 원 주문 (market_id, order_place_id) — 주문일 60일 구간·100건씩 묶어 조회. 못 찾으면 자체몰."""
|
||||
pairs = sorted({(_day(r.get("order_date")) or date.min, str(r.get("order_id") or ""))
|
||||
for r in refunds if r.get("order_id")})
|
||||
out: dict[str, Any] = {}
|
||||
@@ -212,7 +244,7 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
params = {"order_id": ",".join(ids), "start_date": first.isoformat(),
|
||||
"end_date": group[-1][0].isoformat(), "date_type": "order_date", "limit": LOOKUP_BATCH}
|
||||
for o in self._get(ctx, "/admin/orders", params).get("orders") or []:
|
||||
out[str(o.get("order_id"))] = o.get("market_id")
|
||||
out[str(o.get("order_id"))] = (o.get("market_id"), o.get("order_place_id"))
|
||||
i += len(group)
|
||||
return out
|
||||
|
||||
@@ -224,10 +256,12 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
rows = [r for r in self.refunds(ctx, start, end) if str(r.get("status") or "T") == "T"]
|
||||
markets = self.market_ids(ctx, rows)
|
||||
for r in rows:
|
||||
yield {**r, "_market_id": markets.get(str(r.get("order_id")), "self")}
|
||||
mid, place = markets.get(str(r.get("order_id")), ("self", None))
|
||||
yield {**r, "_market_id": mid, "_order_place_id": place}
|
||||
|
||||
def normalize_order(self, order: dict[str, Any]) -> list[SaleEvent]:
|
||||
if not is_self_market(order.get("market_id")) or order.get("paid") != "T":
|
||||
"""결제 주문 → SALE. 자체몰은 카페24 열, 마켓 연동 주문은 해당 쇼핑몰 열(MARKET_MAP)."""
|
||||
if order.get("paid") != "T":
|
||||
return []
|
||||
pay_day = _day(order.get("payment_date"))
|
||||
if pay_day is None:
|
||||
@@ -236,8 +270,10 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
names = [str(i.get("product_name") or "") for i in items if i.get("product_name")]
|
||||
name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else ""
|
||||
oid = str(order.get("order_id") or "")
|
||||
target = target_code(order.get("market_id"), order.get("order_place_id"))
|
||||
return [SaleEvent(
|
||||
event_type="SALE", external_event_id=f"{oid}-PAY", external_order_id=oid,
|
||||
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,
|
||||
quantity=sum(int(i.get("quantity") or 0) for i in items), order_status="결제완료",
|
||||
@@ -247,16 +283,16 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
)]
|
||||
|
||||
def normalize_refund(self, refund: dict[str, Any]) -> list[SaleEvent]:
|
||||
if not is_self_market(refund.get("_market_id")):
|
||||
return []
|
||||
"""환불 → CANCEL/RETURN(−). 원 주문의 market_id 로 결제와 같은 쇼핑몰 열에 넣는다."""
|
||||
day = _day(refund.get("refund_date"))
|
||||
code = str(refund.get("refund_code") or "")
|
||||
if day is None or not code:
|
||||
return []
|
||||
amount = _won(refund.get("actual_refund_amount"))
|
||||
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",
|
||||
external_event_id=code, external_order_id=str(refund.get("order_id") or ""),
|
||||
external_event_id=f"{EVENT_PREFIX}{code}", external_order_id=str(refund.get("order_id") or ""),
|
||||
external_line_id=",".join(refund.get("order_item_code") or []),
|
||||
order_date=_day(refund.get("order_date")), event_date=day, amount=-amount,
|
||||
quantity=-int(refund.get("quantity") or 0), order_status="환불완료",
|
||||
@@ -287,7 +323,8 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
if not is_self_market(o.get("market_id")):
|
||||
key = str(o.get("market_id"))
|
||||
bm = by_market.setdefault(key, {"market_id": key, "names": set(), "orders": 0, "total": 0,
|
||||
"refund_count": 0, "refund_amount": 0})
|
||||
"refund_count": 0, "refund_amount": 0,
|
||||
"target": target_code(o.get("market_id"), o.get("order_place_id"))})
|
||||
bm["orders"] += 1
|
||||
bm["total"] += order_total(o)
|
||||
for n in (o.get("order_place_name"), o.get("order_place_id")):
|
||||
@@ -305,14 +342,15 @@ class Cafe24Adapter(MarketplaceAdapter):
|
||||
refunds = {"self": {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0},
|
||||
"market": {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0}}
|
||||
for r in rows:
|
||||
mid = markets.get(str(r.get("order_id")), "self")
|
||||
mid, place = markets.get(str(r.get("order_id")), ("self", None))
|
||||
g = refunds["self" if is_self_market(mid) else "market"]
|
||||
g["count"] += 1
|
||||
for k in ("actual_refund_amount", "used_points", "used_credits"):
|
||||
g[k] += _won(r.get(k))
|
||||
if not is_self_market(mid):
|
||||
bm = by_market.setdefault(str(mid), {"market_id": str(mid), "names": set(), "orders": 0, "total": 0,
|
||||
"refund_count": 0, "refund_amount": 0})
|
||||
"refund_count": 0, "refund_amount": 0,
|
||||
"target": target_code(mid, place)})
|
||||
bm["refund_count"] += 1
|
||||
bm["refund_amount"] += _won(r.get("actual_refund_amount"))
|
||||
markets_out = sorted(({**v, "names": sorted(v["names"])} for v in by_market.values()),
|
||||
|
||||
@@ -157,9 +157,12 @@ def build_settings(store: Any, *, configured: Mapping[str, bool], key_info: Mapp
|
||||
key_versions_in_use: Mapping[int, int], sample_count: int) -> dict[str, Any]:
|
||||
from app.timezone import today_kst # noqa: WPS433
|
||||
|
||||
from .adapters.cafe24 import MARKET_MAP # noqa: WPS433
|
||||
|
||||
statuses = store.statuses()
|
||||
rates = store.rate_table()
|
||||
today = today_kst()
|
||||
via_cafe24 = set(MARKET_MAP.values()) # 카페24 마켓 통합관리 경유로 매출이 들어오는 쇼핑몰
|
||||
rows = []
|
||||
by_code = {m["code"]: m for m in store.list_marketplaces()}
|
||||
for adapter in all_adapters():
|
||||
@@ -178,6 +181,7 @@ def build_settings(store: Any, *, configured: Mapping[str, bool], key_info: Mapp
|
||||
"auth_type": adapter.auth_type, "shared": adapter.uses_shared_integration,
|
||||
"implemented": adapter.implemented, "note": adapter.note, "docs_url": adapter.docs_url,
|
||||
"configured": configured.get(adapter.code, False),
|
||||
"via_cafe24": adapter.code in via_cafe24,
|
||||
"status": st, "status_label": STATUS_LABELS.get(st, st),
|
||||
"last_test_at": st_row.get("last_test_at"), "last_test_ok": st_row.get("last_test_ok"),
|
||||
"last_sync_at": st_row.get("last_sync_at"), "last_success_sync_at": st_row.get("last_success_sync_at"),
|
||||
|
||||
@@ -224,17 +224,28 @@ class PerformanceDBStore:
|
||||
cur.executemany(self._UPSERT_SQL, rows)
|
||||
return len(rows)
|
||||
|
||||
def replace_events(self, code: str, start: date, end: date, events: Iterable[dict[str, Any]]) -> int:
|
||||
"""기간(sales_date) 안 이 쇼핑몰 실데이터(is_sample 아님)를 지우고 새로 넣는다 — 한 트랜잭션.
|
||||
테스트 데이터는 건드리지 않는다. 실패하면 롤백되어 예전 데이터가 그대로 남는다."""
|
||||
def replace_events(self, code: str, start: date, end: date, events: Iterable[dict[str, Any]],
|
||||
*, id_prefix: str = "") -> int:
|
||||
"""기간(sales_date) 안 이 어댑터가 만든 실데이터(is_sample 아님)를 지우고 새로 넣는다 — 한 트랜잭션.
|
||||
|
||||
지우는 대상: 이 쇼핑몰(code)의 행 + (id_prefix 가 있으면) 다른 쇼핑몰 열로 보냈던 이 어댑터의 행
|
||||
(external_event_id 가 id_prefix 로 시작). 다른 쇼핑몰의 직접 연동분·테스트 데이터는 건드리지 않는다.
|
||||
실패하면 롤백되어 예전 데이터가 그대로 남는다."""
|
||||
rows = self._event_rows(code, events, False)
|
||||
with self._pool.connection() as conn:
|
||||
with conn.transaction():
|
||||
conn.execute(
|
||||
"DELETE FROM perf_sales_events WHERE marketplace_code = %s AND is_sample = FALSE "
|
||||
"AND sales_date BETWEEN %s AND %s",
|
||||
(code, start, end),
|
||||
)
|
||||
if id_prefix:
|
||||
conn.execute(
|
||||
"DELETE FROM perf_sales_events WHERE is_sample = FALSE AND sales_date BETWEEN %s AND %s "
|
||||
"AND (marketplace_code = %s OR left(external_event_id, %s) = %s)",
|
||||
(start, end, code, len(id_prefix), id_prefix),
|
||||
)
|
||||
else:
|
||||
conn.execute(
|
||||
"DELETE FROM perf_sales_events WHERE marketplace_code = %s AND is_sample = FALSE "
|
||||
"AND sales_date BETWEEN %s AND %s",
|
||||
(code, start, end),
|
||||
)
|
||||
if rows:
|
||||
with conn.cursor() as cur:
|
||||
cur.executemany(self._UPSERT_SQL, rows)
|
||||
@@ -242,8 +253,10 @@ class PerformanceDBStore:
|
||||
|
||||
@staticmethod
|
||||
def _event_rows(code: str, events: Iterable[dict[str, Any]], is_sample: bool) -> list[tuple]:
|
||||
"""행마다 집계할 쇼핑몰 = 사건의 marketplace_code(다른 쇼핑몰 대신 받은 주문), 없으면 code."""
|
||||
return [
|
||||
(code, e["event_type"], e["external_event_id"], e["external_order_id"], e.get("external_line_id", ""),
|
||||
(e.get("marketplace_code") or code, e["event_type"], e["external_event_id"], e["external_order_id"],
|
||||
e.get("external_line_id", ""),
|
||||
e.get("order_date"), e.get("payment_date"), e["event_date"], e["sales_date"],
|
||||
e.get("product_name", ""), e.get("option_name", ""), int(e.get("quantity") or 0),
|
||||
int(e["amount"]), int(e.get("discount_amount") or 0), e.get("order_status", ""),
|
||||
|
||||
@@ -108,10 +108,15 @@ class SyncService:
|
||||
fetched, events = adapter.collect(ctx, start, end)
|
||||
known = ctx.credentials.known_secrets()
|
||||
rows = [event_row(ev, known) for ev in events]
|
||||
# 다른 쇼핑몰 열로 보낸 사건 — 등록된 쇼핑몰이 아니면 이 쇼핑몰 열에 둔다(합계가 빠지지 않게).
|
||||
registered = {m["code"] for m in self._store.list_marketplaces()}
|
||||
for r in rows:
|
||||
if r.get("marketplace_code") not in registered:
|
||||
r["marketplace_code"] = code
|
||||
if adapter.replace_range:
|
||||
# 그 기간을 통째로 다시 받은 쇼핑몰 — 기간 안 예전 행을 지우고 새로 넣는다(한 트랜잭션).
|
||||
rows = [r for r in rows if start <= r["sales_date"] <= end]
|
||||
upserted = self._store.replace_events(code, start, end, rows)
|
||||
upserted = self._store.replace_events(code, start, end, rows, id_prefix=adapter.event_prefix)
|
||||
else:
|
||||
upserted = self._store.upsert_events(code, rows)
|
||||
self._store.finish_run(run_id, ok=True, fetched=fetched, upserted=upserted)
|
||||
|
||||
@@ -235,4 +235,4 @@
|
||||
} | tojson }}</script>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/performance.js?v=20260930b" defer></script>{% endblock %}
|
||||
{% block scripts %}<script src="/static/performance.js?v=20260930c" defer></script>{% endblock %}
|
||||
|
||||
@@ -57,6 +57,7 @@
|
||||
{% if r.shared %}<span class="perf-pill">공통 연동</span>
|
||||
{% elif r.configured %}<span class="perf-pill is-ok">설정완료</span>
|
||||
{% else %}<span class="perf-pill">미설정</span>{% endif %}
|
||||
{% if r.via_cafe24 %}<span class="perf-pill is-ok" title="카페24 마켓 통합관리로 들어온 이 쇼핑몰 주문을 카페24 수집 때 함께 반영합니다">카페24 경유</span>{% endif %}
|
||||
</td>
|
||||
<td>
|
||||
<span class="perf-status st-{{ r.status }}"
|
||||
@@ -142,4 +143,4 @@
|
||||
</section>
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}<script src="/static/performance.js?v=20260930b" defer></script>{% endblock %}
|
||||
{% block scripts %}<script src="/static/performance.js?v=20260930c" defer></script>{% endblock %}
|
||||
|
||||
@@ -245,15 +245,18 @@ class FakeStore:
|
||||
def record_test(self, code, *, status, ok, error=""):
|
||||
self.status[code] = {"status": status, "ok": ok, "error": error, "test": True}
|
||||
|
||||
def replace_events(self, code, start, end, events):
|
||||
def replace_events(self, code, start, end, events, *, id_prefix=""):
|
||||
def mine(k, v):
|
||||
return k[0] == code or (id_prefix and k[2].startswith(id_prefix))
|
||||
self.events = {k: v for k, v in self.events.items()
|
||||
if not (k[0] == code and not v["is_sample"] and start <= v["sales_date"] <= end)}
|
||||
if not (mine(k, v) and not v["is_sample"] and start <= v["sales_date"] <= end)}
|
||||
return self.upsert_events(code, events)
|
||||
|
||||
def upsert_events(self, code, events, *, is_sample=False):
|
||||
n = 0
|
||||
for e in events:
|
||||
self.events[(code, e["event_type"], e["external_event_id"])] = {**e, "is_sample": is_sample}
|
||||
target = e.get("marketplace_code") or code
|
||||
self.events[(target, e["event_type"], e["external_event_id"])] = {**e, "is_sample": is_sample}
|
||||
n += 1
|
||||
return n
|
||||
|
||||
@@ -426,38 +429,47 @@ class _FakeCafe24(__import__("app.modules.performance.adapters.cafe24", fromlist
|
||||
|
||||
def test_cafe24_normalize_matches_daily_report():
|
||||
from app.modules.performance.adapters.base import AdapterContext
|
||||
from app.modules.performance.adapters.cafe24 import order_total
|
||||
from app.modules.performance.adapters.cafe24 import order_total, target_code
|
||||
|
||||
ctx = AdapterContext(code="cafe24", credentials=None)
|
||||
fake = _FakeCafe24(
|
||||
[[_c24_order("A"), _c24_order("B", market="shopn"), _c24_order("C", paid="F")]],
|
||||
[[_c24_order("A"), _c24_order("B", market="shopn"), _c24_order("C", paid="F"),
|
||||
_c24_order("D", market="auction")]],
|
||||
[[_c24_refund("C20260929-01", "A", 12_610), _c24_refund("R20260929-02", "X", 20_000),
|
||||
_c24_refund("C20260929-03", "M", 9_000), _c24_refund("C20260929-04", "A", 5_000, status="F")]],
|
||||
lookup={"M": "shopn"},
|
||||
)
|
||||
fetched, events = fake.collect(ctx, date(2026, 9, 29), date(2026, 9, 29))
|
||||
by = {(e.event_type, e.external_event_id): e for e in events}
|
||||
# 결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰 (결제 당시 금액)
|
||||
sale = by[("SALE", "A-PAY")]
|
||||
assert sale.amount == 50_000 + 3_000 - 1_000 - 5_000 == 47_000
|
||||
# 결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰 (결제 당시 금액), 사건 ID 는 c24: 접두어
|
||||
sale = by[("SALE", "c24:A-PAY")]
|
||||
assert sale.amount == 50_000 + 3_000 - 1_000 - 5_000 == 47_000 and sale.marketplace_code == "cafe24"
|
||||
assert sale.event_date == date(2026, 9, 29) and sale.quantity == 2 and sale.product_name == "상품1 외 1건"
|
||||
assert not any(e.external_order_id in ("B", "C") and e.event_type == "SALE" for e in events) # 마켓·미결제 제외
|
||||
# 환불: 환불완료일, 실제 환불액, R→반품 / 그 밖→취소, 마켓 주문·미완료 환불 제외
|
||||
assert by[("CANCEL", "C20260929-01")].amount == -12_610
|
||||
assert by[("RETURN", "R20260929-02")].amount == -20_000
|
||||
assert ("CANCEL", "C20260929-03") not in by and ("CANCEL", "C20260929-04") not in by
|
||||
assert by[("CANCEL", "C20260929-01")].event_date == date(2026, 9, 29)
|
||||
# 마켓 연동 주문은 해당 쇼핑몰 열로, 연결표에 없는 마켓(옥션)은 카페24 열, 미결제는 제외
|
||||
assert by[("SALE", "c24:B-PAY")].marketplace_code == "naver"
|
||||
assert by[("SALE", "c24:D-PAY")].marketplace_code == "cafe24"
|
||||
assert ("SALE", "c24:C-PAY") not in by
|
||||
# 환불: 환불완료일, 실제 환불액, R→반품 / 그 밖→취소, 원 주문의 마켓 열로, 미완료 환불 제외
|
||||
assert by[("CANCEL", "c24:C20260929-01")].amount == -12_610
|
||||
assert by[("CANCEL", "c24:C20260929-01")].marketplace_code == "cafe24"
|
||||
assert by[("RETURN", "c24:R20260929-02")].amount == -20_000
|
||||
assert by[("CANCEL", "c24:C20260929-03")].marketplace_code == "naver"
|
||||
assert ("CANCEL", "c24:C20260929-04") not in by
|
||||
assert by[("CANCEL", "c24:C20260929-01")].event_date == date(2026, 9, 29)
|
||||
for e in events:
|
||||
assert "buyer_name" not in str(e.raw) and "1234567890" not in str(e.raw) # 개인정보 미저장
|
||||
assert order_total({"initial_order_amount": {"order_price_amount": "1578300.00", "shipping_fee": "45500.00",
|
||||
"coupon_discount_price": "57000.00"}}) == 1_566_800 # 9/29 화면값
|
||||
# 대조: 자체몰/마켓 나눠 합산
|
||||
assert target_code("self") == "cafe24" and target_code("SK11ST") == "elevenst"
|
||||
assert target_code("unknown", "coupang") == "coupang" and target_code("unknown") == "cafe24"
|
||||
# 대조: 자체몰/마켓 나눠 합산 + 마켓별 반영 열
|
||||
rec = fake.reconcile(ctx, date(2026, 9, 29))
|
||||
assert rec["orders"]["self"]["orders"] == 1 and rec["orders"]["self"]["total"] == 47_000
|
||||
assert rec["orders"]["market"]["orders"] == 1 and rec["unpaid_orders"] == 1
|
||||
assert rec["orders"]["market"]["orders"] == 2 and rec["unpaid_orders"] == 1
|
||||
assert rec["refunds"]["self"]["actual_refund_amount"] == 32_610 and rec["refunds"]["market"]["count"] == 1
|
||||
assert rec["by_market"] == [{"market_id": "shopn", "names": [], "orders": 1, "total": 47_000,
|
||||
"refund_count": 1, "refund_amount": 9_000}]
|
||||
bym = {b["market_id"]: b for b in rec["by_market"]}
|
||||
assert bym["shopn"]["target"] == "naver" and bym["shopn"]["refund_amount"] == 9_000
|
||||
assert bym["auction"]["target"] == "cafe24" and bym["auction"]["orders"] == 1
|
||||
# 60일 단위 분할 + 페이지 넘김(1000건이면 다음 페이지)
|
||||
page1 = [_c24_order(f"x-{i}") for i in range(1000)]
|
||||
fake2 = _FakeCafe24([page1, [_c24_order("y")]])
|
||||
@@ -484,25 +496,29 @@ def test_cafe24_scope_and_replace_range():
|
||||
raise AssertionError("주문 권한 없으면 인증 실패여야 합니다")
|
||||
real.shared_status = lambda c: {"connected": True, "scopes": "mall.read_product,mall.read_order"}
|
||||
real.authenticate(ctx)
|
||||
# 기간 교체: 그 기간의 예전 실데이터(품목 단위 등)는 지우고, 테스트 데이터·기간 밖은 남긴다
|
||||
|
||||
def ev(eid, day, **kw):
|
||||
return {"event_type": "SALE", "external_event_id": eid, "external_order_id": "o",
|
||||
"event_date": day, "sales_date": day, "amount": 1, **kw}
|
||||
|
||||
# 기간 교체: 기간 안 카페24 행(예전 품목 단위)·카페24 경유 네이버 행은 지우고,
|
||||
# 네이버 직접 연동분·테스트 데이터·기간 밖은 남긴다
|
||||
st = FakeStore()
|
||||
st.upsert_events("cafe24", [{"event_type": "SALE", "external_event_id": "old-item-S", "external_order_id": "A",
|
||||
"event_date": date(2026, 9, 29), "sales_date": date(2026, 9, 29), "amount": 1}])
|
||||
st.upsert_events("cafe24", [{"event_type": "SALE", "external_event_id": "outside", "external_order_id": "Z",
|
||||
"event_date": date(2026, 9, 1), "sales_date": date(2026, 9, 1), "amount": 1}])
|
||||
st.upsert_events("cafe24", [{"event_type": "SALE", "external_event_id": "sample", "external_order_id": "S",
|
||||
"event_date": date(2026, 9, 29), "sales_date": date(2026, 9, 29), "amount": 1}],
|
||||
is_sample=True)
|
||||
fake = _FakeCafe24([[_c24_order("A")]])
|
||||
d, out = date(2026, 9, 29), date(2026, 9, 1)
|
||||
st.upsert_events("cafe24", [ev("old-item-S", d), ev("outside", out)])
|
||||
st.upsert_events("naver", [ev("c24:OLD-PAY", d), ev("direct-naver-1", d)])
|
||||
st.upsert_events("cafe24", [ev("sample", d)], is_sample=True)
|
||||
fake = _FakeCafe24([[_c24_order("A"), _c24_order("B", market="shopn")]])
|
||||
orig = syncmod.get_adapter
|
||||
syncmod.get_adapter = lambda c: fake
|
||||
try:
|
||||
r = SyncService(st, CredentialService(st, lambda: ring())).sync_marketplace(
|
||||
"cafe24", date(2026, 9, 29), date(2026, 9, 29))
|
||||
r = SyncService(st, CredentialService(st, lambda: ring())).sync_marketplace("cafe24", d, d)
|
||||
finally:
|
||||
syncmod.get_adapter = orig
|
||||
ids = {k[2] for k in st.events if k[0] == "cafe24"}
|
||||
assert r["ok"] and ids == {"A-PAY", "outside", "sample"}, ids
|
||||
got = {(k[0], k[2]) for k in st.events}
|
||||
assert r["ok"], r
|
||||
assert got == {("cafe24", "c24:A-PAY"), ("naver", "c24:B-PAY"), ("cafe24", "outside"),
|
||||
("naver", "direct-naver-1"), ("cafe24", "sample")}, got
|
||||
|
||||
|
||||
def test_registry_and_event_validation():
|
||||
|
||||
@@ -482,6 +482,8 @@
|
||||
const r = await api("GET", "/performance/api/marketplaces/cafe24/reconcile?date=" + encodeURIComponent(day));
|
||||
if (!r.ok) { out.innerHTML = '<p class="perf-notice is-warn">' + esc((r.label ? r.label + " — " : "") + r.message) + "</p>"; return; }
|
||||
const s = r.orders.self, m = r.orders.market, rs = r.refunds.self, rm = r.refunds.market;
|
||||
const MARKET_NAMES = {};
|
||||
root.querySelectorAll("tr[data-code]").forEach(function (tr) { MARKET_NAMES[tr.dataset.code] = tr.dataset.name; });
|
||||
const disc = ["membership_discount_amount", "set_product_discount_amount", "app_discount_amount",
|
||||
"market_other_discount_amount", "shipping_fee_discount_amount"];
|
||||
const coup = ["coupon_discount_price", "coupon_shipping_fee_amount"];
|
||||
@@ -510,7 +512,7 @@
|
||||
["순매출(결제합계 − 환불합계)", s.total - rs.actual_refund_amount, m.total - rm.actual_refund_amount, "key"],
|
||||
]);
|
||||
out.innerHTML = '<table class="perf-table" style="margin-top:8px"><thead><tr><th class="perf-th-label">' + esc(r.date) +
|
||||
"</th><th>자체몰(실적 반영)</th><th>다른 마켓 연동(제외)</th></tr></thead><tbody>" +
|
||||
"</th><th>자체몰(카페24 열)</th><th>다른 마켓 연동(해당 쇼핑몰 열)</th></tr></thead><tbody>" +
|
||||
rows.map(function (x) {
|
||||
const cls = x[3] === "key" ? ' class="perf-row-week"' : "";
|
||||
const f = function (v) { return x[3] === "cnt" ? fmt(v) : won(v); };
|
||||
@@ -520,9 +522,11 @@
|
||||
((r.by_market || []).length
|
||||
? '<h4 class="perf-h" style="margin:14px 0 6px">다른 마켓 연동 주문 — 마켓별</h4>' +
|
||||
'<table class="perf-table"><thead><tr><th class="perf-th-label">market_id</th><th class="perf-th-label">주문경로</th>' +
|
||||
"<th>주문수</th><th>결제합계</th><th>환불</th><th>순매출</th></tr></thead><tbody>" +
|
||||
'<th class="perf-th-label">반영 열</th><th>주문수</th><th>결제합계</th><th>환불</th><th>순매출</th></tr></thead><tbody>' +
|
||||
r.by_market.map(function (b) {
|
||||
const col = MARKET_NAMES[b.target] || b.target;
|
||||
return '<tr><td class="perf-td-label">' + esc(b.market_id) + "</td><td>" + esc((b.names || []).join(", ")) +
|
||||
"</td><td>" + esc(col) + (b.target === "cafe24" ? ' <span class="perf-muted">(연결표 없음)</span>' : "") +
|
||||
'</td><td class="perf-num">' + fmt(b.orders) + '</td><td class="perf-num">' + won(b.total) +
|
||||
'</td><td class="perf-num">' + won(-b.refund_amount) + '</td><td class="perf-num">' + won(b.total - b.refund_amount) + "</td></tr>";
|
||||
}).join("") + "</tbody></table>"
|
||||
|
||||
@@ -49,7 +49,15 @@
|
||||
- **기간 교체(`replace_range=True`)**: 결제·환불 모두 기간 안 날짜로 조회되므로 동기화 때 그 기간의 카페24 실데이터를 지우고
|
||||
새로 넣는다(한 트랜잭션, 테스트 데이터 제외). 규칙이 바뀌어도 예전 행이 남지 않는다 → 규칙을 고친 뒤에는 같은 기간을
|
||||
[과거 매출 가져오기]로 다시 받으면 된다.
|
||||
- **자체몰 주문만**(`market_id` = self/빈값). 환불은 원 주문을 100건씩 조회해 `market_id` 로 판단. 네이버페이는 자체몰 주문.
|
||||
- **마켓 연동 주문은 해당 쇼핑몰 열로**: 자체몰(`market_id` = self/빈값)은 카페24 열. 카페24 마켓 통합관리가 가져온
|
||||
다른 마켓 주문은 `MARKET_MAP`(market_id 또는 order_place_id → 우리 쇼핑몰 코드)으로 네이버·쿠팡·11번가 등 열에 넣는다
|
||||
(`SaleEvent.marketplace_code`). 연결표에 없는 마켓은 카페24 열 — **전체 합계는 항상 카페24 일별 매출내역과 같다**
|
||||
(9/28 대조로 자체몰+마켓 합계가 모든 줄에서 일치 확인). 환불은 원 주문을 100건씩 조회해 같은 열로. 네이버페이는 자체몰.
|
||||
- 카페24 가 만든 사건 ID 는 모두 `c24:` 접두어(`event_prefix`) — 다시 받을 때 카페24 열 + 다른 열의 `c24:` 행만 교체해
|
||||
그 쇼핑몰의 **직접 연동분은 건드리지 않는다**. 어떤 쇼핑몰을 직접 API 로 연동하면 같은 주문을 두 번 받지 않도록 그 마켓을
|
||||
`MARKET_MAP` 에서 빼야 한다. 설정 화면 API 설정 칸의 "카페24 경유" 표시 = 카페24 수집 때 함께 반영되는 쇼핑몰.
|
||||
- 실제 market_id 값은 "카페24 매출 대조"의 마켓별 표(market_id / 주문경로 / 반영 열)로 확인하고, "(연결표 없음)"으로 나오는
|
||||
마켓이 우리 쇼핑몰이면 `MARKET_MAP` 에 추가한다.
|
||||
- 60일 단위 분할(한 호출 3개월 미만), orders limit 1000 / refunds limit 500 페이지. 개인정보는 저장하지 않는다.
|
||||
- **카페24 매출 대조**(설정 화면, `GET /api/marketplaces/cafe24/reconcile?date=`): 그날 결제 주문·환불을 카페24 화면 열 순서대로
|
||||
(주문수·품목수·상품구매금액·배송비·할인·쿠폰·결제합계·환불합계·순매출) 자체몰/다른 마켓으로 나눠 합산. 저장하지 않음.
|
||||
|
||||
Reference in New Issue
Block a user