정기주문 서비스

쇼핑몰에서 고객을 위한 서비스로, 자동으로 정기 주문이 생성되어 상품이 배송되는 API입니다. 고객은 편리하게 원하는 상품을 정기 주문 서비스를 신청하면, 지정된 주기와 날짜에 맞춰 자동 주문이 생성되어 상품을 손쉽게 배송 받을 수 있습니다.

---

주요 기능

• 정기주문 신청

  • 정기주문 가능한 상품을 장바구니에 담아 신청합니다.

  • 배송 및 결제 정보는 회원의 기본 정보로 자동 설정됩니다.

  • 선택 옵션으로 배송 요청사항, 신청 기간, 신청 일자를 지정할 수 있습니다.

  • 비회원은 정기주문 서비스 신청이 불가합니다.

• 정기주문 데이터 생성

  • 신청한 상품의 다음 주문 생성일에 자동으로 정기배송 주문이 생성됩니다.

• 정기주문 서비스 신청 목록 조회

  • 회원 번호에 해당하는 정기주문 서비스 신청 목록을 조회합니다.

  • 조회 기간 내의 주문 목록만 반환됩니다.

• 정기주문 서비스 상세 조회

  • 정기주문번호를 기반으로 정기주문 상세 내역을 조회합니다.

• 정기주문 변경 및 해지

  • 정기주문 서비스 상세에서 해지 및 주문 주기 변경이 가능합니다.

  • 전체 건너뛰기로 다음 주문 예정일을 변경할 수 있습니다.

프로세스 정의 — 정기주문 신청

1

주문가능여부 검증

사용자는 장바구니 화면에서 정기주문신청서에 진입할 수 있습니다. 신청서 진입 시 주문가능한 상품인지, 회원이 주문 가능한 상태인지 전체적으로 검증합니다.

2

주문신청서조회

자동결제카드, 회원 기본배송지, 주문상품, 배송, 적립 정보를 주문서 노출에 필요한 주문서 정보와 주문신청 생성을 위한 주문생성 정보로 구분하여 전달합니다.

3

정기주문번호 채번

정기주문신청 생성을 위한 정기주문번호를 채번합니다.

4

정기주문신청하기

화면에서 선택한 주문정보를 바탕으로 정기주문 신청을 생성합니다.

5

신청완료정보 조회

신청완료 페이지를 노출하기 위한 정기주문신청완료정보를 조회합니다.

6

정기주문 생성

일배치로 다음주문생성예정일이 도래한 정기주문 신청 건들을 주문 생성 합니다.

프로세스 정의 — 정기 주문 신청 조회

1

정기주문목록 조회

회원인 경우 마이페이지 > 정기주문신청 내역을 통해 정기주문신청 목록을 조회할 수 있습니다.

2

정기주문내역상세조회

정기주문번호 클릭 시 정기주문신청 상세로 이동합니다.

API 기능 목록

API	설명	Server	매소드	비고
정기주문신청서 조회	회원의 정기주문신청서 정보를 조회합니다.	Order	POST	🔗API 확인하기> 상품 조회: /api/goods/v1/detail/goods 회원 기본배송지 조회: /api/member/v1/front/dlvpInfo​ 배송정책 조회: /api/goods/v1/delivery/deliProcInfo
정기주문번호 채번	정기주문번호를 채번합니다.	Order	GET	🔗API 확인하기>
정기주문 신청	정기주문을 신청합니다.	Order	POST	🔗API 확인하기>
정기주문신청완료정보 조회	정기주문신청 성공 후 정기주문신청 정보를 조회합니다.	Order	GET	🔗API 확인하기>
정기주문내역 조회	회원번호에 해당하는 주문 목록을 조회합니다. 비회원은 주문 내역 리스트 조회 불가능합니다. 조회시작일시, 조회종료일시 사이에 포함된 주문 목록만 조회합니다.	Order	GET	🔗API 확인하기>
정기주문내역 상세 조회	정기주문번호에 해당하는 정기주문내역를 조회합니다.	Order	GET	🔗API 확인하기>

용어 정의

명칭	설명
정기배송주기값	콤마로 나뉜 연결된 숫자 형태로 이루어진 문자열(EX:”1,2,3”)이며 주기코드가 월(month)일 때는 일자, 주(week)일 때는 요일을 뜻합니다.
다음주문생성일자	정기배송주기값을 기반으로 생성하는 일자입니다. 신청할 때 최초 생성되며 해당 일자가 도래 시 정기주문 생성이 이루어집니다.

기타 참고사항

• 정기배송주기는 공통코드로 관리한다. (OM034)

• 정기주문예정일 최초 생성 시에 OM021의 값(주문신청예정안내일자, 주문생성일자) 중 더 큰 값의 일수(days)가 지나야 생성 대상의 일자가 된다.