본문 바로가기
서비스 API/실시간 가격,재고 체크

실시간 가격, 재고 체크 - 옥션용

Description
URL은 제휴사에서 개발 후 전달 필요
상품상세페이지에서 고객이 장바구니 or 구매하기 버튼 클릭 실시간 주문체크 API 호출하여 실제 주문 가능한 상태인지 체크합니다
실시간 재고 체크를 위하여 주문수량, 선택옵션정보를 제휴사 재고체크 URL로 XML형식으로 전송해 드립니다. (XmlHttpRequest)

제휴사에서는 XML을 Request 하여 상품 가격/재고 체크를 하고 주문가능여부를 XML형식으로 응답 주셔야 합니다.

응답주신 결과로 고객에게 안내 합니다. (주문가능할 경우 별도 Notice없이 주문진행시킴, 무응답이어도 주문진행됨)

반드시 아래 규약과 동일하게 구현되어야 하며 
본 API는 양사 개발 필요하므로 제한적으로 제공합니다.

 

Request Description

항목 항목명 필수여부 Type Description
ORDER_INFO > PRODUCT NO 판매자관리번호 Y string  
ORDER_INFO > ORDER_QTY 주문수량 Y int  
ORDER_INFO > PRICE 상품금액(판매가) Y int 할인금액 미포함
**.0000
소수점 이하 .0000 포함하여 전달하고 있으니 가격 체크시에는 삭제하신 체크 필요
ORDER_INFO > EXT_GB 구분자 Y int EXT_GB="02" 전달 받으면 옥션에서의 재고체크 Request 판단하시라는 의미의 Attribute
ORDER_INFO > ORDER_OPTION > OPTION_INFO > NAME 옵션명 Y string 옵션정보가 있을 경우
ORDER_INFO > ORDER_OPTION > OPTION_INFO > VALUE 옵션값 Y string 옵션정보가 있을 경우
ORDER_INFO > ORDER_OPTION > OPTION_INFO > PRICE 옵션금액 Y int 옵션정보가 있을 경우
**.0000
소수점 이하 .0000 포함하여 전달하고 있으니 가격 체크시에는 삭제하신 체크 필요
ORDER_INFO > ORDER_OPTION > OPTION_INFO > QTY 옵션수량 Y int 옵션정보가 있을 경우
ORDER_INFO > ORDER_OPTION > OPTION_INFO > QTY > STOCK_NO 옵션 판매자관리번호 Y string  
옵션정보 있을 경우
<?xml version="1.0" encoding="utf-8" ?>
<ORDER_INFO>
      <PRODUCT NO="123456789" ORDER_QTY="2" PRICE="100.0000" EXT_GB="02" />
      <ORDER_OPTION>
          <OPTION_INFO>
                <NAME><![CDATA[사이즈]]></NAME>
                <VALUE><![CDATA[55]]></VALUE>
                <PRICE>1000.0000</PRICE>
                <QTY>1</QTY>
                        <STOCK_NO>2</STOCK_NO>
          </OPTION_INFO>
      </ORDER_OPTION>
</ORDER_INFO>

옵션정보 없을 경우
<?xml version="1.0" encoding="utf-8" ?>
<ORDER_INFO>
      <PRODUCT NO="123456789" ORDER_QTY="1" PRICE="100.0000" EXT_GB="02" />
      <ORDER_OPTION>
          <OPTION_INFO>
                        <STOCK_NO></STOCK_NO>
                <NAME><![CDATA[_]]></NAME>
                <VALUE><![CDATA[_]]></VALUE>
                <PRICE>0.0000</PRICE>
                <QTY>1</QTY>
          </OPTION_INFO>
      </ORDER_OPTION>
</ORDER_INFO>

 

Response Description

항목 항목명 Type Description
STOCK_REMAIN_INFO > PRODUCT NO 판매자관리번호 int  
STOCK_REMAIN_INFO > REMAIN_YN 재고확인여부 string 제휴사 상품번호(PRODUCT > NO) 해당하는 상품 주문 수량(옥션 전송 XML: PRODUCT > ORDER_QTY) 상품 재고 확인 여부
STOCK_REMAIN_INFO > PRICE_YN 가격확인여부 string 제휴사 상품번호(PRODUCT > NO) 해당하는 상품 판매 가격(옥션 전송 XML: PRODUCT > PRICE) 가격 확인여부
STOCK_REMAIN_INFO > GOODS_QTY 옵션수량 int  
STOCK_REMAIN_INFO > ORDER_OPTION > OPTION_INFO > NAME 옵션명 string  
STOCK_REMAIN_INFO > ORDER_OPTION > OPTION_INFO >VALUE 옵션값 string  
STOCK_REMAIN_INFO > ORDER_OPTION > OPTION_INFO > REMAIN_YN 옵션별 재고확인여부 string 해당 상품의 옵션번호(OPTION_INFO >> STOCK_NO) 해당하는 옵션 상품의 선택정보 재고 여부
STOCK_REMAIN_INFO > ORDER_OPTION > OPTION_INFO > PRICE_YN 옵션별 가격확인여부 string 해당 상품의 옵션번호(OPTION_INFO >> STOCK_NO) 해당하는 옵션 상품의 선택정보 재고 여부
STOCK_REMAIN_INFO > ORDER_OPTION > OPTION_INFO > GOODS_QTY 옵션수량 int  
STOCK_REMAIN_INFO > ORDER_OPTION > OPTION_INFO > STOCK_NO 옵션 판매자관리번호 int  

 Sample

옵션정보 있을 경우
<?xml version='1.0' encoding='utf-8' ?>
<STOCK_REMAIN_INFO>
    <PRODUCT NO="123456789" REMAIN_YN="Y" PRICE_YN="Y" GOODS_QTY="100"/>
    <ORDER_OPTION>
        <OPTION_INFO>
            <NAME><![CDATA[사이즈]]></NAME>
            <VALUE><![CDATA[55]]></VALUE>
            <REMAIN_YN>Y</REMAIN_YN>
            <PRICE_YN>Y</PRICE_YN>
            <GOODS_QTY>100</GOODS_QTY>
            <STOCK_NO>2</STOCK_NO>
         </OPTION_INFO>
    </ORDER_OPTION>
</STOCK_REMAIN_INFO>

옵션정보 없을 경우
<?xml version='1.0' encoding='utf-8' ?>
<STOCK_REMAIN_INFO>
    <PRODUCT NO="123456789" REMAIN_YN="Y" PRICE_YN="Y" GOODS_QTY="100"/>
    <ORDER_OPTION>
        <OPTION_INFO>
            <NAME></NAME>
            <VALUE></VALUE>
            <REMAIN_YN>Y</REMAIN_YN>
            <PRICE_YN>Y</PRICE_YN>
            <GOODS_QTY>0</GOODS_QTY>
            <STOCK_NO></STOCK_NO>
         </OPTION_INFO>
    </ORDER_OPTION>
</STOCK_REMAIN_INFO>