상품상세 배송정보

Owned by 신성석, created
Last updated: 2023-12-01 by 정현 도
2 min read

협력사번호(entrNo), 배송비 정책번호(deliPolcNo), 상품번호(goodsNo)를 기준으로 현재 사용 중인 배송 정책을 조회하며, Front 화면에서 상품상세 배송/교환/반품 레이어 팝업을 구성하기 위한 정보를 제공합니다. 또한, 협력사번호(entrNo)와 배송비 정책번호(deliPolcNo)를 기준으로 배송비와 배송교환반품 정보를 제공합니다.

주요 기능

배송비 정책 정보 조회

  • 배송비 형태, 기준 금액, 배송비 금액, 추가 배송비, 회수 배송비, 교환 배송비 등 배송비 정책 정보를 조회합니다.

  • 배송비 정책은 저장 이후 수정이 불가하며, 삭제가 불가능합니다. 사용 여부로 관리됩니다.

  • 배송 관련 금액은 100원 단위로 입력 가능하며, 배송비 형태에 따라 제약이 있습니다.

배송 관련 금액 입력 제약

  • 추가 배송비, 회수 배송비, 교환 배송비는 0원 이상 입력 가능합니다. (0원 입력 허용)

  • 배송비 형태가 '무료'인 경우, 기준 금액은 0원(비활성)이며 배송비 금액은 0원 이상 입력 가능합니다. (0원 입력 허용)

  • 배송비 형태가 '유료'인 경우, 기준 금액은 0원(비활성)이며 배송비 금액은 100원 이상 입력 가능합니다. (0원 입력 불가)

  • 배송비 형태가 '조건부 무료'인 경우, 기준 금액은 100원 이상 입력 가능(0원 입력 불가)이며 배송비 금액은 100원 이상 입력 가능합니다. (0원 입력 불가)

중복 저장 제한

  • 협력사 번호, 배송비 형태, 기준 금액, 배송비 금액, 추가 배송비, 회수 배송비, 교환 배송비가 동일한 경우, 배송비 정책 중복으로 저장이 불가합니다.

 

프로세스 정의

 

번호

구분

설명

번호

구분

설명

1

상품별 배송교환반품 정보 조회

  • 상품번호 기준으로 배송방식, 배송지역, 배송정보,배송비, 교환/반품 기간, 교환/반품 가능여부,교환/반품 배송비, 반품지를 조회하여 배송/교환/반품 팝업 화면에 노출합니다. 

2

배송정책번호 별 배송비 조회

  • 배송정책번호 기준으로 배송정책정보를 조회하여 해당 정보를 타 모듈에 제공합니다. 

API 기능 목록

API

설명

Server

메소드

비고

API

설명

Server

메소드

비고

배송정책번호별 배송비 조회

  • 협력사, 배송비 정책번호 기준으로 배송정책기본 정보 목록을 조합니다.

  • 배송정책기본 사용 여부가 Y인 배송 정책에 대해 조회합니다.

Goods

POST

🔗API 확인하기>

협력사별 배송교환반품 정보 조회

  • 협력사 번호 기준으로 배송정책기본 정보 목록을 조회합니다.

  • 배송정책기본 사용 여부가 Y인 배송 정책에 대해 조회합니다.

Goods

GET

🔗API 확인하기>

상품별 배송교환반품 정보 조회

  • 상품상세 화면의 배송/교환/반품 팝업에서 사용하는 API 입니다.

  • 상품번호 기준으로 배송정책 기본정보 및 협력사 배송지정보 목록을 조회합니다.

  • 배송정책기본 사용 여부가 Y인 배송 정책에 대해 조회합니다.

Goods

GET

🔗API 확인하기>

상품 배송비 조회

  • 상품번호 기준으로 배송정책 기본정보 목록을 조회합니다.

  • 배송정책기본 사용 여부가 Y인 배송 정책에 대해 조회합니다.

Goods

GET

🔗API 확인하기>

용어 정의

명칭

설명

비고

명칭

설명

비고

협력사

쇼핑몰에 상품 및 서비스를 제공하거나 제공받는 모든 거래업체를 의미합니다.

 

상품공급업체

쇼핑몰을 통해 고객에게 상품 및 서비스를 제공하는 협력사입니다.

 

제휴업체

쇼핑몰과 제휴하여 고객에게 상품 및 서비스를 제공하는 업체입니다. (ex. 네이버, 다음 등)

 

추가배송비 금액

기본 배송비 외 도서산간 지역에 붙는 추가 비용입니다.

 

기타 참고사항

  • 배송정책번호별 배송비 조회 API는 body의 협력사와 배송정책번호에 해당하는 정보를 조회합니다.

     ex)

    [ { “entrNo” : 1000181, ”deliPolcNo” : 10000371 }, { “entrNo” : 1000211, ”deliPolcNo” : 10000441 } ]



    •협력사별 배송교환반품 정보 조회 API는 path의 협력사 번호에 해당하는 정보를 조회합니다.

     ex) /v1/delivery/tr/1000001

    •상품별 배송교환반품 정보 조회 API는 path의 상품 번호에 해당하는 정보를 조회합니다.

     ex) /v1/delivery/pd/10000910

    •상품 배송비 조회 API는 파라미터의 상품 번호에 해당하는 정보를 조회합니다.

     ex) ?goodsNos=10001861,10001742