| Screen ID |
Screen Title |
Screen Path |
| ORD-LIST-01 |
전체 주문 내역 |
/mypage/order |
로그인 회원의 전체 주문 내역을 조회하는 화면. 매장 탭 필터 · 검색 · 무한 스크롤 제공.
| 탭 |
필터 기준 |
| 전체 매장 |
store 구분 없이 전체 조회 |
| 온라인 매장 |
isOffline = false |
| 오프라인 매장 |
isOffline = true |
| 라플 매장 |
라플 유형 주문 |
store 코드 값 및 탭 포함 여부는 스토어별 문서에서 정의한다. (예: YETI — 라플 탭 미포함)
탭 전환 동작
- 탭 클릭 시 해당 조건으로 목록 재조회
- 전환 중 스켈레톤 UI 표시
- 이전 탭 데이터는 캐시 사용 후 백그라운드 갱신
| 항목 |
표시 기준 |
| 배송 상태 |
products[].productStatus → 아래 상태 변환표 적용 |
| 배송 정보 |
택배사 + 송장번호 모두 있을 때만 링크 활성화 |
| 주문일 |
orderedAt |
배송 상태 변환표
| 상태 코드 |
표시 문구 |
PENDING |
상품 준비중 |
READY_DELIVERY |
배송 준비 중 |
IN_DELIVERY |
배송 중 |
DELIVERED |
배송 완료 |
CANCELED |
주문 취소 |
CONFIRMED |
구매 확정 |
| 미정의 코드 또는 값 없음 |
배송 상태 확인 중 |
| 항목 |
표시 기준 |
| 상품 이미지 |
thumbnailUrl |
| 브랜드명 |
brandName |
| 상품명 |
productName |
| 사이즈 |
sizeName |
| 가격 |
orderProduct.totalPrice |
| 조건 |
표시 기준 |
isOffline = false |
스토어별 온라인 매장명 |
isOffline = true |
offlineStoreName |
| 라플 유형 |
라플 스토어 |
온라인 매장 표시 문구는 스토어별 문서에서 정의한다.
주문 카드 상단 배송 상태는 주문 내 products[]의 상태를 아래 우선순위로 집계한다.
| 우선순위 |
조건 |
표시 상태 |
| 1 |
1개라도 IN_DELIVERY |
IN_DELIVERY |
| 2 |
전체가 DELIVERED 또는 CANCELED |
DELIVERED |
| 3 |
일부 READY_DELIVERY, 나머지 PENDING |
PENDING (개별 상품 상태만 변경된 것) |
| 4 |
그 외 |
가장 낮은 단계 상태 표시 |
| 상태 |
표시 방식 |
| 접힘 (기본) |
첫 번째 상품 + “총 N개 상품” 라벨 + ▼ 아이콘 |
| 펼침 |
주문 내 전체 상품 표시 + ▲ 아이콘 |
- 상품 수 1개이면 드롭다운 표시 안 함
- 펼침/접힘 상태는 주문 카드별 독립 관리
| 항목 |
기준 |
| 검색 대상 |
상품명 (productName) · 주문번호 (orderNumber) |
| 기본 페이지 사이즈 |
검색 시 size=4 |
| 검색 결과 없음 |
“주문 내역이 없습니다” |
| 필터 결과 없음 |
“해당 조건의 주문이 없습니다” |
| 상품 정보 누락 |
“상품 정보를 확인할 수 없습니다” |
검색 기본 사이즈가 4로 작다. 결과가 적어 보이는 경우 무한 스크롤로 추가 로드가 되는지 먼저 확인한다.
| 조건 |
표시 |
| 택배사 + 송장번호 모두 존재 |
{택배사명} {송장번호} + 클릭 시 배송조회 링크 활성화 |
| 둘 중 하나라도 없음 |
“배송 정보 없음” + 링크 비활성화 |
택배사별 배송조회 URL
| 택배사 |
URL |
| CJ대한통운 |
https://trace.cjlogistics.com/web/detail.jsp?slipno={송장번호} |
| 기타 |
https://service.epost.go.kr/trace.RetrieveDomRigiTraceList.comm?sid1={송장번호} |
엔드포인트: GET /v1/orders/histories
탭별 쿼리 파라미터
| 탭 |
공통 파라미터 |
스토어별 파라미터 |
| 전체 매장 |
page=0&size=20 |
— |
| 온라인 매장 |
page=0&size=20&isOffline=false |
store={스토어코드} 추가 |
| 오프라인 매장 |
page=0&size=20&isOffline=true |
store={스토어코드} 추가 |
| 라플 매장 |
page=0&size=20 |
store=RAFFLE 등 스토어 문서에서 정의 |
검색 시: GET /v1/orders/histories?keyword={검색어}&page=0&size=4
응답 주요 필드
| 필드 |
활용 |
orderNumber |
카드 식별 / 상세 이동 파라미터 |
orderedAt |
주문일, DESC 정렬 기준 |
store, isOffline, offlineStoreName |
매장 분류 |
products[].productStatus |
배송 상태 변환 및 집계 |
products[].shippingCompany |
택배사명 |
products[].shippingNumber |
송장번호 |
products[].thumbnailUrl |
상품 이미지 |
products[].brandName |
브랜드명 |
products[].productName |
상품명 |
products[].sizeName |
사이즈 |
products[].totalPrice |
상품 가격 (orderProduct.totalPrice) |
totalPrice |
주문 총 금액 |
| 항목 |
내용 |
| 송장번호 필드명 |
shippingTrackingNumber vs shippingNumber — 실제 API 응답 기준 확인 필요 |
| 버전 |
날짜 |
변경 내용 |
| v1.0 |
2026-07-06 |
최초 작성 |