버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

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

배송비 조회 API는 배송정책기본 관련 정보를 제공하며, 배송교환반품 정보 조회 API는 배송정책기본과 배송교환반품 관련 정보를 제공합니다.

...

주요 기능

배송비 정책 정보 조회

  • 배송비

    정책 정보(배송비

    형태, 기준 금액, 배송비 금액, 추가 배송비, 회수 배송비, 교환 배송비

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

  • 해당 배송비 정책으로 등록된 상품이 있는 경우, 사용 여부를 N으로 변경할 수 없습니다.

  • 배송 관련 금액(배송비 금액, 추가 배송비, 회수 반품비, 교환 배송비)은 100원 단위로 입력 가능합니다.

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

  • 배송비 형태 별 배송 관련 금액등 배송비 정책 정보를 조회합니다.

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

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

배송 관련 금액 입력 제약

  • 추가 배송비, 회수 배송비, 교환 배송비는

    배송비 형태와 관계없이

    0원 이상 입력 가능합니다. (0원 입력 허용)

  • 배송비 형태가

    ‘무료’인

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

  • 배송비 형태가

    ‘유료’인

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

  • 배송비 형태가

    ‘조건부 무료’인

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

중복 저장 제한

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

프로세스 정의

...

번호

구분

설명

1

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

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

2

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

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

API 기능 목록

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
               }

          

    코드 블럭
    languagejs
    [
      {  
          “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