feat(performance): 토스쇼핑 원본 데이터 확인에 환불 후보 3가지(정산 REFUND·주문 취소 시각·클레임 환불 완료)

- 9/6 실데이터: 매출 29,600 일치, 환불 11,900 은 정산 건별 REFUND 에 없음(다른 날 주문을 9/6 에 환불)
- 후보 ① 정산 REFUND(현재 규칙) ② orders/v2 canceledAt(기간 90일 전 주문까지) ③ claims refundedDt(isRefunded)
  — 날짜별 합계를 나란히 + 건별(주문번호·금액·메모), 화면 숫자와 같은 후보로 규칙을 정한다
- 클레임 목록 개인정보(연락처·수거 주소·요청 사유·사진) 값·합계 숨김, 송장번호 합계도 숨김
- performance.js 캐시 버전 20261001c, 테스트·문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-01 10:16:29 +09:00
parent d75dec2a50
commit 01000757f3
6 changed files with 145 additions and 9 deletions
+6
View File
@@ -171,6 +171,12 @@
클레임 목록 API 는 날짜로 거를 수 없고(REQUESTED·REVOKED 만 7일 조회) 결제완료 단계의 고객 취소는 클레임으로 안 잡혀서 쓰지 않는다.
- `replace_range`(접두어 `toss:` — 매출·환불 함께 교체). 진행 막대 = 주문 + 정산 31일 구간 수. 개인정보(주문자·수령인·주소·요청사항·
송장)는 저장 안 함.
- **실데이터 대조(2026-10-01, 9/6)**: 매출 29,600 = 주문 2건 `price` 합 **일치**(`orderedAt` 은 시간대 없이 한국 시간 —
17:57 주문도 9/6). 환불 11,900 은 **정산 REFUND 에 없다**(9/6 거래일 정산 = PAY 2줄 + 배송비 2줄뿐, 9/6 주문은 둘 다 구매확정) →
다른 날 주문을 9/6 에 환불한 건이 정산 건별에 안 나온다(구매확정 전 취소는 정산에 안 올라오는 듯). 그래서 원본 데이터 확인에
**환불 후보 세 가지**(`refund_candidates`)를 날짜별로 나란히: ① 정산 REFUND(현재 규칙) ② 주문 `canceledAt`(기간 90일 전 주문까지
조회) ③ 클레임 목록 `refundedDt`(`isRefunded`, 금액 `order.price` — 클레임 목록은 날짜 조건이 없어 전체를 넘겨 거름, 최대 1만 건)
+ 건별(주문번호·금액·메모). 화면 11,900 과 같은 후보로 수집 규칙을 바꾼다(**미확정**).
- 정산 줄의 다른 항목: 셀러 부담 쿠폰 `shoppingDiscountMerchant`, 정산 지급액 `settlementAmount`, 수수료 `payFee`·`productFee`.
- 대조: 설정 화면 "쇼핑몰 원본 데이터 확인" → 토스쇼핑 — 날짜별 **매출(주문일)·환불(환불일)·순 거래액**(`day_cols`)과 주문 상태별·
정산 stepType 별 항목 합계. 파트너스 화면 숫자와 다르면 금액 항목(`price` / `price − totalDiscountPrice`, 환불 `orderProductPrice` /