버전 비교

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

...

API

설명

Server

메소드

비고

대체가능 상품단품정보 조회(장바구니)

  • 단건의 상품 조회 시 호출하는 API입니다.

  • 요청 받은 상품에 대하여 요청한 단품외의 단품 중에 상품+단품+수량 으로 대체가능(판매가격+단품추가금 동일한 다른 단품)한 단품목록을 조회합니다.

  • 상품가격은 동일하므로 단품추가금만 확인하여 조회합니다.

  • 단품재고가 요청수량보다 많은 경우만 조회합니다.

  • 쿠키에 저장된 언어코드를 사용하여 조회합니다.

Goods

POST

🔗API 확인하기>

단품별 재고증차감

  • 차감한 단품수량이 재고수량보다 클경우 (마이너스 재고),에러를 리턴합니다.

  • 증가한 단품수량이 안전재고수량보다 클경우 단품판매상태코드 판매 중으로 변경합니다.

Goods

PUT

🔗API 확인하기>

옵션정보 조회 (옵션팝업)

  • 상품에 대한 옵션목록을 조회하기 위한 API 입니다.

  • 묶음상품을 조회하는 경우 해당 묶음상품의 대표 상품의 옵션목록을 조회합니다.

  • 상품의 전시여부가 Y이고, 단품의 판매상태가 판매중/품절인 단품이 속한 옵션들을 조회합니다.

  • 단품목록이 없는 단일상품은 조회에서 제외합니다.

  • 리프옵션에 해당하는 단품의 기본정보를 포함합니다.

  • 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.

  • 미리보기의 경우 request의 미리보기 언어코드를 사용하여 조회하고, 그외의 경우는 쿠키에 저장된 언어코드를 사용하여 조회합니다.

Goods

GET

🔗API 확인하기>

상품별 단품정보 조회(장바구니전용)

  • 장바구니에서 단품별 상세정보를 조회하기 위해 호출합니다.

  • 리스트로 받은 단품번호 기준으로 단품의 상세정보를 조회합니다.

  • 쿠키에 저장된 언어코드, 몰번호를 사용하여 조회합니다.

Goods

POST

🔗API 확인하기>

상품별 단품정보 조회(주문전용)

  • 다건의 상품 조회 시 호출합니다.

  • 요청 받은 각 상품에 대하여 요청한 단품외의 단품 중에 상품+단품+수량 으로 대체가능(판매가격+단품추가금동일한 다른 단품)한 상품별로 단품목록을 조회합니다.

  • 단품재고가 요청수량보다 많은 경우만 조회합니다.

  • 쿠키에 저장된 언어코드를 사용하여 조회합니다.

Goods

POST

🔗API 확인하기>

상품별 단품정보 조회

  • 상품번호에 따라 상품 내 모든 단품의 정보를 조회합니다.

  • 쿠키에 저장된 언어코드를 사용하여 조회합니다.

  • 단품명, 재고정보, 가격정보를 조회합니다.

Goods

POST

🔗API 확인하기>

상품별 최대혜택가 조회 (프로모션 제공)

  • 상품의 최대혜택가를 조회하는 API 입니다.

  • request에 단품번호가 없는 경우는 상품의 단품번호가 가장 빠른 단품을 기준으로 프로모션 최대혜택가를 적용하여 조회합니다.

  • request에 단품번호가 있는 경우는 상품의 해당 단품번호를 기준으로 프로모션 최대혜택가를 적용하여 조회합니다.

  • 최대혜택가에 해당하는 프로모션리스트를 조회합니다.

  • 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.

  • request에 채널번호가 있는 경우 해당 채널번호를 사용하여 조회하고, 그외의 경우는 쿠키에 저장된 채널번호를 사용하여 조회합니다.

  • 로그인을 한 경우 로그인 사용자 정보가 프로모션 최대혜택가 계산 조건에 적용됩니다.

Goods

GET

🔗API 확인하기>
[상품상세 최대혜택가조회]
/api/order/v1/marketing/maxDcAmt

단품별 즉시할인가 조회

  • 단품별 즉시할인가를 조회하는 API 입니다.

  • 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.

  • 단품에 즉시할인가가 적용된 가격정보를 조회합니다.

Goods

GET

🔗API 확인하기>
[상품별 즉시할인가 조회]
/api/order/v1/marketing/goodsDirectDiscountList

상품별 결제가능수단 조회

  • 다건의 상품별 각각의 결제수단을 조회합니다.

  • 쿠키에 저장된 언어코드를 사용하여 조회합니다.

  • 결제수단의 사용여부가 'Y'인 결제수단만 조회합니다

Goods

POST

🔗API 확인하기>

증정품 정보 조회

  • 상품에 해당하는 증정품을 조회합니다.

  • 1001: request값이 없거나, request값에 상품번호가 없는 경우 발생하는 오류입니다.

Goods

POST

🔗API 확인하기>

상품 상세정보 조회

  • 상품의 상세페이지에서 상품정보를 상세 조회하기 위한 API 입니다.

  • 전시여부가 Y이고, 판매상태가 판매중/품절이고, 판매기간에 해당하는 상품을 조회합니다.

  • 상품의 기본/단품/브랜드/이미지/가격/결제수단/연관상품/묶음상품/배송비정책/프로모션/증정품/리뷰별점통계정보를 조회합니다.

  • 쿠키에 저장된 언어코드, 사이트번호, 몰번호를 사용하여 조회합니다.

Goods

GET

🔗API 확인하기>

전시상품정보(전시상품요약)조회

  • 다건의 상품조회가 가능합니다.

  • 이미지는 상품의 대표이미지를 제공합니다.

  • 미리보기의 경우 request의 미리보기 언어코드를 사용하여 조회하고, 그외의 경우는 쿠키에 저장된 언어코드를 사용하여 조회합니다

Goods

POST

🔗API 확인하기>

용어 정의

명칭

설명

비고

상품

  • 상거래 채널을 통해 판매의 대상이 되는 모든 재화를 의미합니다.

  • 상품을 전시하는 기본 단위이며 상품 상세 화면을 구성하는 기본 단위가 됩니다.

  • 상품은 가격을 관리하는 단위입니다.

단품

  • 상품 하위의 최소 관리 단위로 상품 재고 및 판매의 최소 단위, 즉 고객이 구입하게 되는 단위입니다.

  • 고객의 선택 옵션에 따른, 주문 상품 정보를 관리하는 단위입니다.

  • 재고를 관리하는 단위입니다. (솔루션에서 재고는 ‘웹재고’를 의미합니다.)

  • 옵션의 조합으로 단품 정보가 생성됩니다. 
    (예) 단품A : 컬러-블랙/사이즈-260  / 단품B : 컬러-블랙/사이즈-250

옵션

  • 상품을 베리에이션하는 기본 단위입니다.

  • ‘컬러’, ‘사이즈’ 등의 항목을 옵션명이라 하며 ‘블랙’, ‘XL’등을 옵션값이라 합니다.

  • 션 유형은 성별, 색상, 크기, 중량, 용량, 지역 등 대부분의 커머스에 사용하는 유형이 존재하며 사이트별 필요시 추가하여 사용할 수 있습니다.

일반상품 (구분)

  • 일반적인 배송이 이루어지는 모든 재화 상품을 의미합니다.

사은품 (구분)

프로모션이나 이벤트 등을 통해 특정 상품 구매 혹은 특정한 액수 이상 구매 등과 같이 일정한 조건을 충족하는 고객에 한하여, 추가 비용 없이 지급하는 상품을 의미합니다.  

일반상품

  • 단품에 상품의 옵션을 코드화에서 관리하는 상품을 의미합니다.

  • 재고 차감은 단품 단위로 이루어 집니다.

묶음상품

  • 할인 여부와 상관없이 전시 활용을 위한 묶음 상품을 의미합니다. 

  • 옵션 구성 상품을 일부 선택하여 구매합니다.

예약상품

  • 일정 기간 동안 사전 주문하여 배송안내일에 일괄 배송하는 상품을 의미합니다.

  • 예약상품은 판매단위인 단품 단위로 선택하여 등록합니다.

  • 예약상품 정보의 전시기간이 상품의 전시기간에 포함되는 경우만 단품 조회 및 선택 가능합니다.