feat(performance): GS샵 매출 수집 — 매출 내역 custChrAmt(할인 후 고객 결제금액), 매출인식일 기준
- 9/3 실데이터로 항목 확인: salePrice − dcTotAmt = custChrAmt, supGiveAmt = 협력사 지급액 - 매출 내역 한 줄 = 사건, SALE 이 아닌 줄은 RETURN 음수, 배송비 제외, replace_range - GS API 에는 주문일 기준 조회가 없어 포털 주문 통계(총주문금액)와 날짜 기준이 다름 — 문서에 기록 - 원본 데이터 확인에 날짜별 현재 규칙 매출(열 이름은 쇼핑몰별 day_cols) - 테스트 1개 추가(29개 통과), performance.js 캐시 버전 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -29,7 +29,7 @@
|
||||
|
||||
오류 클래스 = 연결 상태: `NotConfigured`(인증정보 미설정) · `AuthFailed`(인증 실패) · `TokenExpired` · `ApiError` · `NotImplementedYet`(연동 준비 중).
|
||||
|
||||
**연동 현황**: 카페24·11번가·네이버 스마트스토어 = **구현됨**, 나머지 7개는 입력칸만 정의(수집은 `NotImplementedYet`). 쇼핑몰별 입력칸은
|
||||
**연동 현황**: 카페24·11번가·네이버 스마트스토어·GS샵 = **구현됨**, 나머지 7개는 입력칸만 정의(수집은 `NotImplementedYet`). 쇼핑몰별 입력칸은
|
||||
**연동 단계에서 공식 API 문서로 확정**한다.
|
||||
|
||||
### 카페24 (`adapters/cafe24.py`, 구현됨)
|
||||
@@ -125,7 +125,7 @@
|
||||
- 설정 화면 **"쇼핑몰 원본 데이터 확인"**(네이버 선택): 결제일 기준 상품주문 전체의 항목별 합계, 상태별 합계, 날짜별
|
||||
매출·그중 결제 뒤 취소/반품(참고)·배송비(참고). 개인정보(주문자·수령인·주소·연락처·메모)는 값 없이 이름만.
|
||||
|
||||
### GS샵 (`adapters/gsshop.py`, 연결·원본 확인까지 — 매출 규칙 확정 전)
|
||||
### GS샵 (`adapters/gsshop.py`, 구현됨)
|
||||
|
||||
- 문서: 협력사 포털 → 제휴 API → 개발가이드(`partners.gsshop.com/api/apiDevGuide`, 본문은 `/docs/withgs-api-docs.html` Redoc).
|
||||
- 인증: 헤더 `supCd`(협력사코드) + `token` = base64(AES256(`yyyyMMddHHmmss` + 협력사코드)), 키는 제휴 API 메인 화면(로그인 후).
|
||||
@@ -135,8 +135,14 @@
|
||||
`atwithgs-api` 는 테스트용 — 두 곳 모두 응답). 입력칸 키는 처음 만든 `vendor_code`·`api_key` 그대로(라벨만 협력사코드·AES256 키).
|
||||
- 매출: `GET /api/v2/settlement/out/sales/period?supCode&fromDate&toDate&pageIdx&rowsPerPage` — **매출인식일** 기준, 한 번에 10일,
|
||||
쪽당 1만 건, `{data, hasMorePage, totalCount}`. 배송비는 `/shippingFee/period`. 응답 줄 항목 이름이 문서 예시에 없어
|
||||
("property1") 설정 화면 "쇼핑몰 원본 데이터 확인"(GS샵)으로 항목별 합계를 보고 협력사 포털 매출 화면과 맞춰 규칙을 정한다.
|
||||
그 전까지 매출 수집은 "연동 준비 중"(`implemented=False`).
|
||||
("property1") 실데이터로 확인(2026-09-30, 9/3): `saleAwareDt`·`ordNo`·`ordItemNo`·`ordType`(SALE…)·`prdNm`·`chrQty`·
|
||||
`salePrice`(할인 전, 줄 합계)·`dcTotAmt`·`custChrAmt`(= salePrice − dcTotAmt, 고객 결제금액)·`supGiveAmt`(협력사 지급액).
|
||||
9/3: 211,100 − 19,528 = 191,572, 지급 179,435, 배송비 내역 7,000.
|
||||
- **주문일 기준 조회 API 는 없다** — 협력사 포털 주문 통계(총주문금액·주문일, 할인 후 금액: 45,900 × 85% = 39,015)와는 날짜 기준이
|
||||
달라 날마다 똑같이 맞지 않는다(매출인식일 = 정산 기준).
|
||||
- **매출 규칙**: 매출 내역 한 줄 = 사건(`gs:{ordNo}-{ordItemNo}-{ordType}-{saleAwareDt}`), 날짜 = 매출인식일, 금액 = `custChrAmt`
|
||||
(할인 후 고객 결제금액), 배송비 제외(네이버와 같은 기준). `ordType` 이 SALE 이 아니면 RETURN 음수. `replace_range`.
|
||||
원본 데이터 확인에 날짜별 현재 규칙 매출·취소/반품·배송비(참고).
|
||||
|
||||
### 연동 단계 체크리스트(쇼핑몰마다)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user