시스템 구조
[Returns ERP] 반품 재고·검수·등급·사진·출고·배송·반품 (SoT)
│ 카탈로그 동기화(폴링) ↓ ↑ 주문 전달(sellerOrderId 멱등)
[resale — 이 시스템]
고객: 카탈로그 → 상품 선택 → 배송지 입력 → 결제 바코드 발급(intent)
CU POS: 바코드 스캔 = 승인(HOLD) → 결제완료 = 확정 → Returns 주문 생성(출고 트리거)
취소/망취소/TTL 만료 = 해제 → 재고 복귀
추적: Returns 송장·배송 상태 자동 반영 → 고객 화면에 배송 추적
정산: 점포별 매출/공급가/마진 집계 (CU 정산 + Returns 정산 대사)
CU/중계사 경계는 파트너 키 + POS 시뮬레이터(규격 확정 전).
Returns 연동은 RETURNS_FAKE=true면 내장 목업으로 동작합니다.
🛍️
고객 카탈로그
상품 열람 → 배송지 입력 → 결제 바코드 → 배송 추적
🏪
CU POS 시뮬레이터
바코드 스캔(승인) → 결제완료(확정) / 취소 전문 발사
🧰
운영 어드민
카탈로그 동기화 현황 · 주문/배송 추적 · 정산(마진) · Returns 반영 상태
데모 시나리오 (5분)
- 카탈로그 — Returns에서 동기화된 반품 상품 확인, 상품 선택
- 배송지 입력 → 결제 바코드 발급 (고객 폰 화면)
- POS에서 바코드 입력 → 스캔(승인) → 결제완료(확정)
- 확정과 동시에 Returns 주문 생성 → 잠시 후 송장 발급·배송 진행이 고객 화면에 반영
- 어드민 — 주문 탭에서 Returns 상태/송장, 정산 탭에서 점포별 매출·마진 확인