fix(performance): 카페24 결제합계에서 품목 상품추가할인 빼기 + 대조 표에 카페24 열별 차이

일별 비교 결과 결제합계가 틀린 날은 모두 카페24 상품구매금액이 100원 단위가
아닌 날이고, 차이만큼 더하면 정확히 100원 단위가 된다(9/23 1,860,738+62,
9/22 2,620,740+260, 9/12 7,889,287+13 …). 카페24 화면의 상품구매금액은
품목 상품추가할인(items[].additional_discount_price, 문서: 상품추가할인액)을
뺀 값인데, initial_order_amount 에는 이 할인이 없어 우리가 그만큼 많았다.

- order_total: 판매가 합계 − 품목 상품추가할인 + 배송비 − 할인 − 쿠폰
- order_total_now: 취소·반품 품목의 추가할인은 제외
- 대조 표: 상품구매금액을 추가할인 뺀 값으로 + 판매가 합계·추가할인 세부 줄
- 일별 비교에서 날짜를 눌러 연 대조 표에 붙여넣은 카페24 열과 열별 차이 표시
- 테스트 추가

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-29 21:43:50 +09:00
parent 614332a1e6
commit 6f43f8066a
4 changed files with 68 additions and 22 deletions
+19 -8
View File
@@ -8,6 +8,8 @@
카페24 관리자 "일별 매출내역"과 같은 기준으로 센다(Admin API 문서 2026-09-01 확인).
- 결제합계(SALE, +): GET /admin/orders date_type=pay_date(결제일), 결제된(paid=T) 주문마다
상품구매금액 + 배송비 − 할인 − 쿠폰 (주문의 initial_order_amount — 결제 당시 금액)
카페24 화면의 상품구매금액은 품목의 상품추가할인(items[].additional_discount_price)을 뺀 값이다 —
initial_order_amount 에는 이 할인이 없어 품목에서 더해 뺀다(실데이터: 상품구매금액이 100원 단위가 아닌 날만 차이).
환불은 따로 빼므로 취소 후 금액(actual_order_amount)이 아니라 결제 당시 금액을 쓴다.
- 환불합계(CANCEL/RETURN, −): GET /admin/refunds date_type=refund_date(환불완료일),
실제 환불액(actual_refund_amount). 환불코드가 R 로 시작하면 반품, 그 밖은 취소.
@@ -132,16 +134,23 @@ def _day(value: Any) -> date | None:
return None
def item_additional_discount(order: dict[str, Any], *, active_only: bool = False) -> int:
"""품목 상품추가할인 합계(items[].additional_discount_price, 품목 줄 금액). 주문 금액(initial/actual)에는 없다.
active_only 면 취소·반품된 품목은 빼고(현재 금액 계산용)."""
return sum(_won(i.get("additional_discount_price")) for i in order.get("items") or []
if not (active_only and str(i.get("order_status") or "")[:1] in ("C", "R")))
def order_amounts(order: dict[str, Any]) -> dict[str, int]:
"""결제 당시 금액(initial_order_amount, 없으면 actual_order_amount) 항목별 원 단위."""
"""결제 당시 금액(initial_order_amount, 없으면 actual_order_amount) 항목별 원 단위 + 품목 상품추가할인."""
a = order.get("initial_order_amount") or order.get("actual_order_amount") or {}
return {k: _won(a.get(k)) for k in AMOUNT_FIELDS}
return {**{k: _won(a.get(k)) for k in AMOUNT_FIELDS}, "additional_discount_price": item_additional_discount(order)}
def order_total(order: dict[str, Any]) -> int:
"""결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰."""
"""결제합계 = 상품구매금액(− 품목 상품추가할인) + 배송비 − 할인 − 쿠폰."""
a = order_amounts(order)
return (a["order_price_amount"] + a["shipping_fee"]
return (a["order_price_amount"] - a["additional_discount_price"] + a["shipping_fee"]
- sum(a[k] for k in DISCOUNT_FIELDS) - sum(a[k] for k in COUPON_FIELDS))
@@ -154,7 +163,7 @@ def order_total_now(order: dict[str, Any]) -> int:
"""취소·반품 반영 후 현재 결제합계(actual_order_amount). 없으면 결제 당시 금액."""
a = order.get("actual_order_amount") or order.get("initial_order_amount") or {}
w = {k: _won(a.get(k)) for k in AMOUNT_FIELDS}
return (w["order_price_amount"] + w["shipping_fee"]
return (w["order_price_amount"] - item_additional_discount(order, active_only=True) + w["shipping_fee"]
- sum(w[k] for k in DISCOUNT_FIELDS) - sum(w[k] for k in COUPON_FIELDS))
@@ -416,7 +425,8 @@ class Cafe24Adapter(MarketplaceAdapter):
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="결제완료",
discount_amount=sum(order_amounts(order)[k] for k in DISCOUNT_FIELDS + COUPON_FIELDS),
discount_amount=sum(order_amounts(order)[k]
for k in ("additional_discount_price", *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()}},
)]
@@ -471,7 +481,8 @@ class Cafe24Adapter(MarketplaceAdapter):
self.authenticate(ctx)
def empty() -> dict[str, int]:
return {"orders": 0, "items": 0, "lines": 0, **{k: 0 for k in AMOUNT_FIELDS}, "total": 0}
return {"orders": 0, "items": 0, "lines": 0, **{k: 0 for k in AMOUNT_FIELDS},
"additional_discount_price": 0, "total": 0}
def channel(mid: Any, place: Any, place_name: Any = None) -> dict[str, Any]:
"""(market_id, 주문경로) 한 쌍 = 한 줄. self 안에도 PC쇼핑몰·모바일웹 경로가 섞여 있어 나눠 본다."""
@@ -669,5 +680,5 @@ class Cafe24Adapter(MarketplaceAdapter):
for c in no_record],
"reduced_orders": sorted(reduced.values(), key=lambda r: r["diff"] - r["refunded"], reverse=True),
"by_payment": sorted(by_payment.values(), key=lambda v: v["total"], reverse=True),
"formula": "결제합계 = 상품구매금액 + 배송비 − 할인(" + ", ".join(DISCOUNT_FIELDS) +
"formula": "결제합계 = 상품구매금액(− 품목 상품추가할인) + 배송비 − 할인(" + ", ".join(DISCOUNT_FIELDS) +
") − 쿠폰(" + ", ".join(COUPON_FIELDS) + ")"}
@@ -650,6 +650,23 @@ def test_cafe24_scope_and_replace_range():
("naver", "direct-naver-1"), ("cafe24", "sample")}, got
def test_cafe24_item_additional_discount():
"""카페24 상품구매금액 = 판매가 합계 − 품목 상품추가할인(additional_discount_price). 주문 금액에는 없다.
실데이터: 9/23 카페24 상품구매금액 1,860,738 — 판매가 합계 1,860,800 과 62원 차이."""
from app.modules.performance.adapters.cafe24 import order_total, order_total_now
o = _c24_order("A") # 50,000 + 3,000 − 1,000 − 5,000
o["items"][0]["additional_discount_price"] = "38.00"
o["items"][1]["additional_discount_price"] = "24.00"
assert order_total(o) == 47_000 - 62
ev = _FakeCafe24([]).normalize_order(o)[0]
assert ev.amount == 46_938 and ev.discount_amount == 62 + 1_000 + 5_000
# 현재 금액: 취소된 품목의 추가할인은 빼지 않는다
o["actual_order_amount"] = dict(o["initial_order_amount"])
o["items"][1]["order_status"] = "C40"
assert order_total_now(o) == 47_000 - 38
def test_daily_check_db_vs_live():
"""일별 비교: 저장값(카페24 경유 다른 마켓 열 포함) + 지금 API 값(저장 안 함)."""
import app.modules.performance.sync as syncmod
+28 -14
View File
@@ -474,6 +474,7 @@
}
// ── 카페24 매출 대조 — 카페24 "일별 매출내역" 열 순서대로 ──
let lastShop = {}; // 일별 비교에 붙여넣은 카페24 값(날짜 → 열) — 대조 표에 차이 열로 표시
const recon = document.getElementById("perf-recon");
if (recon) recon.addEventListener("click", async function () {
const day = document.getElementById("perf-recon-date").value;
@@ -497,34 +498,46 @@
coupon_discount_price: "상품쿠폰", coupon_shipping_fee_amount: "배송비쿠폰",
};
const sum = function (g, keys) { return keys.reduce(function (a, k) { return a + (g[k] || 0); }, 0); };
// x[4] = 붙여넣은 카페24 일별 매출내역 열 번호(일별 비교에서 이 날짜를 눌렀을 때 차이 표시)
const rows = [
["주문수", s.orders, m.orders, "cnt"], ["품목수(수량 합계)", s.items, m.items, "cnt"], ["품목수(품목 줄 수)", s.lines, m.lines, "cnt"],
["상품구매금액", s.order_price_amount, m.order_price_amount], ["배송비", s.shipping_fee, m.shipping_fee],
["할인 합계", sum(s, disc), sum(m, disc)],
["주문수", s.orders, m.orders, "cnt", 0], ["품목수(수량 합계)", s.items, m.items, "cnt", 1], ["품목수(품목 줄 수)", s.lines, m.lines, "cnt", 1],
["상품구매금액(− 상품추가할인)", s.order_price_amount - s.additional_discount_price, m.order_price_amount - m.additional_discount_price, "", 2],
[" · 판매가 합계", s.order_price_amount, m.order_price_amount, "sub"],
[" · 상품추가할인(품목)", s.additional_discount_price, m.additional_discount_price, "sub"],
["배송비", s.shipping_fee, m.shipping_fee, "", 3],
["할인 합계", sum(s, disc), sum(m, disc), "", 4],
].concat(disc.map(function (k) { return [" · " + LABEL[k], s[k], m[k], "sub"]; }))
.concat([["쿠폰 합계", sum(s, coup), sum(m, coup)]])
.concat([["쿠폰 합계", sum(s, coup), sum(m, coup), "", 5]])
.concat(coup.map(function (k) { return [" · " + LABEL[k], s[k], m[k], "sub"]; }))
.concat([
["결제합계(계산)", s.total, m.total, "key"],
[" 참고: 실결제금액", s.payment_amount, m.payment_amount, "sub"],
[" 참고: 적립금 사용", s.points_spent_amount, m.points_spent_amount, "sub"],
[" 참고: 예치금 사용", s.credits_spent_amount, m.credits_spent_amount, "sub"],
["결제합계(계산)", s.total, m.total, "key", 10],
[" 참고: 실결제금액", s.payment_amount, m.payment_amount, "sub", 6],
[" 참고: 적립금 사용", s.points_spent_amount, m.points_spent_amount, "sub", 7],
[" 참고: 예치금 사용", s.credits_spent_amount, m.credits_spent_amount, "sub", 8],
["환불 건수(환불 목록)", rs.count, rm.count, "cnt"],
[" · 실제 환불액", rs.actual_refund_amount, rm.actual_refund_amount, "sub"],
[" · 적립금 환불", rs.used_points, rm.used_points, "sub"],
[" · 예치금 환불", rs.used_credits, rm.used_credits, "sub"],
["환불 목록 없는 취소·반품 품목 수(네이버페이 등)", rs.no_record_count, rm.no_record_count, "cnt"],
[" · 취소·반품 금액", rs.no_record, rm.no_record, "sub"],
["환불합계", rs.total, rm.total, "key"],
["순매출(결제합계 − 환불합계)", s.total - rs.total, m.total - rm.total, "key"],
["환불합계", rs.total, rm.total, "key", 11],
["순매출(결제합계 − 환불합계)", s.total - rs.total, m.total - rm.total, "key", 12],
]);
const shopCols = (lastShop[r.date] || {}).cols || null;
out.innerHTML = '<table class="perf-table" style="margin-top:8px"><thead><tr><th class="perf-th-label">' + esc(r.date) +
"</th><th>카페24 열(자체몰 채널)</th><th>다른 쇼핑몰 열(외부 마켓)</th></tr></thead><tbody>" +
"</th><th>카페24 열(자체몰 채널)</th><th>다른 쇼핑몰 열(외부 마켓)</th>" +
(shopCols ? "<th>합계</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); };
let cmp = "";
if (shopCols) {
const both = (x[1] || 0) + (x[2] || 0), c = x[4] == null ? null : shopCols[x[4]];
cmp = '<td class="perf-num">' + f(both) + '</td><td class="perf-num">' + (c == null ? "" : f(c)) + '</td><td class="perf-num">' +
(c == null ? "" : both === c ? '<span class="perf-diff-ok">✓</span>' : '<span class="perf-diff-bad">' + (both > c ? "+" : "") + fmt(both - c) + "</span>") + "</td>";
}
return "<tr" + cls + '><th class="perf-td-label' + (x[3] === "sub" ? " perf-muted" : "") + '">' + esc(x[0]) +
'</th><td class="perf-num">' + f(x[1]) + '</td><td class="perf-num">' + f(x[2]) + "</td></tr>";
'</th><td class="perf-num">' + f(x[1]) + '</td><td class="perf-num">' + f(x[2]) + "</td>" + cmp + "</tr>";
}).join("") + "</tbody></table>" +
(r.refund_basis
? (function () {
@@ -674,14 +687,15 @@
.map(function (x) { return parseInt(x.replace(/,/g, ""), 10); });
if (nums.length < 3) return;
const n = nums.length;
out[m[1] + "-" + m[2] + "-" + m[3]] = { orders: n >= 13 ? nums[0] : null, paid: nums[n - 3], refund: nums[n - 2], net: nums[n - 1] };
out[m[1] + "-" + m[2] + "-" + m[3]] = { orders: n >= 13 ? nums[0] : null, paid: nums[n - 3], refund: nums[n - 2], net: nums[n - 1],
cols: n >= 13 ? nums.slice(n - 13) : null };
});
return out;
}
const dailyBtn = document.getElementById("perf-daily-check");
if (dailyBtn) dailyBtn.addEventListener("click", async function () {
const out = document.getElementById("perf-daily-result");
const shop = parseDaily(document.getElementById("perf-daily-paste").value);
const shop = lastShop = parseDaily(document.getElementById("perf-daily-paste").value);
const dates = Object.keys(shop).sort();
if (!dates.length) { out.innerHTML = '<p class="perf-notice is-warn">날짜가 있는 줄을 찾지 못했습니다. 카페24 일별 매출내역 표를 복사해 붙여 넣으세요.</p>'; return; }
const live = document.getElementById("perf-daily-live").checked;
+4
View File
@@ -71,6 +71,10 @@
매출내역 표를 붙여 넣으면(날짜 + 뒤 세 숫자 = 결제합계·환불합계·순매출, 첫 숫자 = 주문수) 날짜마다 저장값(`c24:` 사건 전체,
다른 마켓 열 포함)과 지금 API·현재 규칙으로 다시 계산한 값(`adapter.collect`, 저장 안 함)을 비교한다.
저장값만 틀림 → 예전 규칙으로 받은 것([다시 가져오기] 버튼), API 값도 틀림 → 규칙 차이(결제/환불) → 날짜 클릭으로 그날 대조.
날짜를 눌러 연 대조 표에는 붙여넣은 카페24 열(주문수·품목수·상품구매금액·배송비·할인·쿠폰·실결제·적립금·예치금·결제·환불·순매출)과
열별 차이가 같이 나온다.
- 결제합계의 상품구매금액 = 판매가 합계 − **품목 상품추가할인**(`items[].additional_discount_price`). 주문 금액(initial_order_amount)에는
이 할인이 없다(2026-09 실데이터: 카페24 상품구매금액이 100원 단위가 아닌 날만 결제합계가 그만큼 많았음, 예 9/23 +62).
### 연동 단계 체크리스트(쇼핑몰마다)