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는 양사 개발 필요하므로 제한적으로 제공함
옥션에서는 해당 제휴사에서 반환하는 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는 별도 받아서 진행 필요
| 항목 | 항목명 | 필수여부 | 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 |
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
| 항목 | 항목명 | 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 |
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
| 결과코드 | 메시지 | 원인 |
|---|