3.2 옥션용 API – ESM Trading API

3.2 옥션용 API

URL은 제휴사에서 개발 후 전달 필요

Description
옥션 상품상세페이지에서 고객이 구매하기 버튼 클릭 or 최종 결제 시, eBay에서 제휴사로 실시간 주문체크 API 호출하여 실제 주문 가능한 상태인지 체크합니다
옥션에서는 해당 제휴사에서 반환하는 API의 상품 재고 여부(PRODUCT > REMAIN_YN) / 가격 확인여부(PRODUCT > PRICE_YN) / 선택정보 재고 여부(OPTION_INFO >> REMAIN_YN) / 옵션추가금 확인여부(OPTION_INFO >> PRICE_YN) 4가지을 필수로 체크하여 판단 합니다
즉, 위 4가지는 실시간 재고체크를 하는데 주문가능여부를 판단하는 중요한 Node이며 필수로 전달 해 주셔야 합니다
옥션에서 몇 초의 응답을 기다리다 Write된 Xml 결과로 고객에게 Notice합니다(주문가능할 경우 별도 Notice없이 주문진행시킴, 무응답이어도 주문진행됨)
반드시 아래 규약과 동일하게 구현되어야 합니다
본 API는 양사 개발 필요하므로 제한적으로 제공함
Request Description
실시간 주문체크 진행할 IP는 별도 받아서 진행 필요
항목항목명필수여부TypeDescription
ORDER_INFO > PRODUCT NO판매자관리번호Ystring
ORDER_INFO > ORDER_QTY주문수량Yint
ORDER_INFO > PRICE상품금액(판매가)Yint할인금액 미포함
**.0000 소수점 이하 .0000 포함하여 전달하고 있으니 가격 체크시에는 삭제하신 후 체크 필요
ORDER_INFO > EXT_GB구분자YintEXT_GB="02" 로 전달이 받으면 옥션에서의 재고체크 Request로 판단하시라는 의미의 Attribute
ORDER_INFO > ORDER_OPTION > OPTION_INFO > NAME옵션명Ystring옵션정보가 있을 경우
ORDER_INFO > ORDER_OPTION > OPTION_INFO > VALUE옵션값Ystring옵션정보가 있을 경우
ORDER_INFO > ORDER_OPTION > OPTION_INFO > PRICE옵션금액Yint옵션정보가 있을 경우
**.0000 소수점 이하 .0000 포함하여 전달하고 있으니 가격 체크시에는 삭제하신 후 체크 필요
ORDER_INFO > ORDER_OPTION > OPTION_INFO > QTY옵션수량Yint옵션정보가 있을 경우
ORDER_INFO > ORDER_OPTION > OPTION_INFO > QTY > STOCK_NO옵션 판매자관리번호Ystring
JSON_옵션정보 있을 경우JSON_옵션정보 없을 경우

<?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
항목항목명TypeDescription
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
JSON_Success_옵션정보 있을 경우JSON_Success_옵션정보 없을 경우
<?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>



Error Code
결과코드메시지원인