feat(performance): 11번가 매출 수집 — 주문 상태 목록 기준, 결제일·판매금액+배송비
"11번가 원본 데이터 확인"(9/9~9/29) 실데이터로 확정: - 주문 상태 목록(결제완료·발송대기·배송중·배송완료)은 지금 그 상태인 주문만 주고, 배송완료 목록에 구매확정 주문도 남는다. 취소된 주문은 취소완료 목록으로 빠진다 - ordAmt − ordPayAmt = 11번가 부담 쿠폰(tmallApplyDscAmt 11,060), 수수료는 판매금액 기준(34,900 × 13% = 4,537) - fetch_orders: 목록 4개를 [기간, 기간+30일(오늘까지)] 7일씩 불러 주문일(결제일)이 기간 안인 줄만, 주문번호+순번 중복 제거 - SALE 금액 = ordAmt + 배송비(주문번호마다 최댓값을 가장 앞 줄에 한 번), ordAmt − ordPayAmt 는 discount_amount 에. 구매자 정보는 raw 에 넣지 않음 - replace_range(11st: 접두어) — 다시 받으면 취소·반품된 주문이 빠진다 - "해당 건이 없습니다"(-1)는 0건. 테스트 추가, 미구현 시험은 G마켓으로 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -83,6 +83,22 @@
|
||||
그 주문의 마지막 클레임 품목에 한 번 더한다. 톡체크아웃·자체몰의 환불 기록 없는 취소는 카페24 환불합계에 없음
|
||||
(9/4: 98,700 + 네이버페이 19,900 + 배송비 3,500 = 122,100 / 9/16: 톡체크아웃 취소 9,900 제외 → 201,100).
|
||||
|
||||
### 11번가 (`adapters/elevenst.py`, 구현됨)
|
||||
|
||||
- 인증: 셀러오피스 Open API Key → 헤더 `openapikey`. **셀러 API 는 등록 IP 에서만** 호출된다(Seller API 정보 수정 →
|
||||
IP 직접 입력에 운영 서버 외부 IP, 셀링툴 사방넷과 함께 사용 가능). 응답은 XML(euc-kr 선언 → 직접 디코딩).
|
||||
- 없는 주소 = 500 + `-997 등록된 API 정보가 존재하지 않습니다`, 건 없음 = `-1 해당 건이 없습니다`(0건으로 처리).
|
||||
- 상세 문서가 로그인 뒤에만 있어 설정 화면 **"11번가 원본 데이터 확인"**(`reconcile(day, to)`, 후보 주소별 동작·항목 합계,
|
||||
개인정보 값 숨김)으로 실데이터를 보고 확정했다(2026-09-30).
|
||||
- 주문 상태 목록 4개(`/rest/ordservices/complete|packaging|shipping|completed/{yyyyMMddHHmm}/{…}`)는 **지금 그 상태인 주문만**
|
||||
준다. 배송완료 목록에 구매확정 주문도 남는다. 취소·반품된 주문은 목록에서 빠지고 `/rest/claimservice/canceledorders|…` 에 있다.
|
||||
- SALE = 주문 한 줄(`11st:{ordNo}-{ordPrdSeq}`), 날짜 = 결제일(`ordStlEndDt`, 없으면 주문일 `ordDt`), 금액 = `ordAmt`
|
||||
(판매금액, 11번가 부담 쿠폰 전) + 배송비(`dlvCst`, 주문번호마다 최댓값을 가장 앞 줄에 한 번). `ordAmt − ordPayAmt` = 11번가
|
||||
부담 할인(`discount_amount` 에 기록). 수수료는 판매금액 기준(정산 `selFee` = 34,900 × 13%).
|
||||
- `replace_range` — 기간을 통째로 다시 받아 취소·반품된 주문이 매출에서 빠진다(취소 사건을 따로 만들지 않음 → 지난 날짜
|
||||
금액이 나중에 줄 수 있음). 목록의 날짜 조건이 주문일인지 상태 변경일인지 몰라 **기간 뒤 30일(오늘까지)을 더 불러 주문일로 거른다.**
|
||||
- 정산 내역 `/rest/settlement/settlementList/{yyyyMMdd}/{yyyyMMdd}` 은 정산확정일(`stlDy`) 기준 — 확인 도구에서만 쓴다.
|
||||
|
||||
### 연동 단계 체크리스트(쇼핑몰마다)
|
||||
|
||||
- 공식 문서로 인증 방식·호출 제한·페이지네이션·주문 상태 코드·취소/반품 API·날짜 필드 확인
|
||||
|
||||
Reference in New Issue
Block a user