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