feat(performance): 카페24 적립금 제외 · 네이버 배송비 포함·환불일 환불 차감 · 주문 내역 칸·합계
- 카페24 매출 = 결제합계 − 적립금, 환불도 적립금 환불 제외, 주문 내역 [적립금 사용] 칸·합계
- 네이버 매출 = 판매금액(총) + 배송비, 환불 = 클레임 완료일 기준 취소·반품 완료(naver:{상품주문}-RF)
- 주문 내역 [배송비]·[환불금액] 칸·합계, 예전 자료는 과거 매출 가져오기로 다시 받으면 새 규칙
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -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