회원 배송지

Owned by X2BEE 관리자, created
Last updated: 2023-11-30
2 min read

회원이 주문, 반품, 교환 등의 서비스를 이용할 때 사용할 배송지 정보를 관리하는 기능입니다. 이를 통해 회원은 여러 배송지를 등록하고, 편리하게 주문 및 교환이 가능합니다.

주요 기능

  1. 회원 배송지 등록

    • 로그인한 회원은 신규 배송지를 등록하여 주문 시 해당 배송지로 상품을 수령할 수 있습니다.

    • 한 회원당 최대 10개의 배송지를 등록할 수 있습니다.

  2. 기본 배송지 설정

    • 기본 배송지는 필수로 1개가 존재해야 합니다.

    • 회원가입 시 입력한 배송지가 초기 기본 배송지로 설정되며, 이후에도 변경 가능합니다.

  3. 배송지 정보 수정 및 삭제

    • 등록된 배송지 정보는 언제든지 수정하거나 삭제할 수 있습니다.

    • 수정된 정보는 주문서나 반품/교환 페이지에서 반영됩니다.

  4. 배송지 선택 및 주문

    • 주문 시 기본 배송지가 자동으로 선택되며, 필요에 따라 다른 배송지로 변경 가능합니다.

    • 주문서 작성 시 저장된 배송지 목록 중 선택하여 사용할 수 있습니다.

 

프로세스 정의

번호

구분

설명

번호

구분

설명

1

비밀번호 재확인

마이페이지에서 회원 배송지정보 페이지에 접근할 시 로그인 비밀번호 재확인을 거쳐야 합니다.

2

회원 배송지 조회

로그인 된 회원에 대한 회원배송지 전체 목록을 조회합니다.

해당 api 는 기본배송지여부를 Y로 보내면 기본배송지만 조회할 수 있습니다.

3

회원 배송지 등록

로그인 된 회원에 대한 신규 배송지를 등록합니다.

기 등록된 회원배송지의 개수가 10개일 시 등록할 수 없습니다.

최초 배송지 등록일 시 기본 배송지로 등록됩니다.

이벤트 데이터베이스와 동기화하기 위해 이벤트 api를 호출합니다.

4

회원 배송지 수정

로그인 된 회원에 대한 배송지를 수정합니다.

현재 기본배송지로 등록 되어있으면 기본배송지를 N으로 수정할 수 없습니다.

이벤트 데이터베이스와 동기화하기 위해 이벤트 api를 호출합니다.

5

회원 배송지 삭제

로그인 된 회원에 대한 배송지를 삭제합니다.

기본배송지로 등록된 배송지는 삭제할 수 없습니다.

이벤트 데이터베이스와 동기화하기 위해 이벤트 api를 호출합니다.

6

기본 배송지로 변경

로그인 된 회원에 대한 배송지를 기본배송지로 변경합니다.

이벤트 데이터베이스와 동기화하기 위해 이벤트 api를 호출합니다.

API 기능 목록

API

설명

Server

메소드

비고

API

설명

Server

메소드

비고

회원배송지 목록 조회

로그인된 회원의 배송지 목록을 조회합니다. 파라미터 baseDlvpYn 을 Y로 할 시 기본배송지만 조회합니다.

Member

GET

🔗API 확인하기 >

회원배송지 등록

로그인한 회원의 배송지를 신규로 등록합니다.

Member

POST

🔗API 확인하기 >
api/event/v1/common/mergeMbrDlvp

회원배송지 수정

로그인한 회원의 배송지를 수정합니다.

Member

PUT

🔗API 확인하기 >
api/event/v1/common/mergeMbrDlvp

회원배송지 삭제

로그인한 회원의 배송지를 삭제합니다.

Member

DELETE

🔗API 확인하기 >
api/event/v1/common/mergeMbrDlvp

회원 기본배송지 저장

로그인한 회원이 선택한 배송지를 기본 배송지로 변경합니다.

Member

PUT

🔗API 확인하기 >
api/event/v1/common/mergeMbrDlvp

용어 정의

명칭

설명

비고

명칭

설명

비고

기본배송지

기본배송지는 해당 고객이 서비스를 이용할 때 자주 사용되며, 사용자가 새로운 배송지를 지정하지 않을 경우에는 기본적으로 이 주소로 상품이 배송됩니다.

 

기타 참고사항

  • 배송지 목록 조회 api 에서 쿼리스트링으로 baseDlvpYn (기본배송지여부) 를 Y로 보낼 시 기본배송지만 조회합니다.

  • 1개의 기본 배송지가 필수로 존재해야 합니다.

    • 배송지 삭제 시 해당 배송지가 기본배송지여부 Y이면 삭제 불가

    • 배송지 수정 시 해당 배송지가 기본배송지여부 Y인데 N으로 수정 불가

  • 회원 메인 데이터베이스와 이벤트 메인 데이터베이스가 분리되어 있기 때문에 배송지 정보가 변경될 시 배송지 정보를 동기화 하는 이벤트 API 를 호출합니다.

구분

파라미터 체크 항목

구분

파라미터 체크 항목

회원 배송지 등록

  • 회원번호

  • 배송지명

  • 수취인명

  • 휴대폰번호 (구분번호, 국번번호, 끝번호)

  • 우편번호

  • 주소, 상세주소

  • 기본배송지유무

회원 배송지 수정

  • 회원번호

  • 회원배송지순번

  • 배송지명

  • 수취인명

  • 휴대폰번호 (구분번호, 국번번호, 끝번호)

  • 우편번호

  • 주소, 상세주소

  • 기본배송지유무

회원 배송지 삭제

  • 회원번호

  • 회원배송지순번

기본 배송지로 변경

  • 회원번호

  • 회원배송지순번