[상품API] 사은품/덤 관련 신규 API 및 기존 API 스펙 변경 안내 +반영일자변경 – G마켓/옥션/G9 서비스를 위한 API 개발지원사이트 입니다

ESM Trading API

ESM Trading API에 대한 사용 방법, 가이드와 문서 및 F&Q를 통해

다양한 지원을 받아보세요

ESM Trading API는 인증/상품/주문/클레임/정산/CS커뮤니케이션 까지

동일한 Interface로 G마켓/옥션/G9 서비스를 지원합니다

공지 : API 및 정책 변경사항을 확인하세요

제목[상품API] 사은품/덤 관련 신규 API 및 기존 API 스펙 변경 안내 +반영일자변경2021-05-03 14:29:36
작성자
첨부파일사은품 덤 API 가이드 문서 (G마켓)_ver.1.1.5.pdf (281KB)

안녕하세요. ESM Trading API 관리자입니다. 


사은품덤 관련 신규 API 및 기존 API 스펙 변경 관련하여 공지 드립니다.

 

주문 조회 API 운영 반영 일자 참고하시어 G마켓 주문 수집 관련 이슈 없도록 내부 개발 소스 확인 부탁드립니다.

(옥션 1.0 상품에 대한 사은품덤 등록/수정 API는 추후 제공 예정입니다.)


[사은품/덤 관련 공지 내용]

  • 주문 조회 API response 스펙 변경 반영 일자 2021-05-20 8:30 (예정)
    >> G
    마켓 주문에 대해서만 주문조회 API response 변경됨
       (
    옥션 주문은 추후 제공 예정이며제공 시 관련 내용은 별도로 추가 공지 예정)
    >> 
    상기 일정 변경되는 경우 별도 추가 공지 진행
  • 사은품 &  API 관련 주요 사항


API 
신규 추가변경 대상
[TPL]

1. AddPurchaseBenefit(
사은품&덤 등록/수정) API 신규 추가
  >> 사은품&덤 정보 연동 가능한 신규 API 추가됨
      
신규 추가 API에 대한 정보는 첨부 드리는 가이드 문서 참고 부탁 드립니다.

2. AddItem(
상품 등록) Request 스펙 변경
  >> 기존 상품 등록 시 사용하던 AddItem >> AddItem >> FreeGift 항목 사용하지 않음
      AddItem API 
호출 시 해당 항목 포함된 경우 에러는 발생하지 않으나연동 값 저장되지 않음

3. RequestOrder API response 
스펙 변경
  >> RequestOrderResultT 하위에 FreeGift, FreeGiftCode, Bonus, BonusCode 항목 추가
  >> 
주문조회 API에서 Return 되는 Bonus 항목의 경우 AddPurchaseBenefit API에서 연동한 BonusBase, Bonus의 값이

BonusBase+Bonus” 형태로 return 

[
통합 API]
1. 
사은품 API 신규 추가
>> 사은품덤 정보 연동 가능한 신규 API 추가됨

    API URL

사은품 등록/수정/조회/삭제 API : http://sa.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/free-gift

덤 등록/수정/조회/삭제 API : http://sa.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/bonus

개발자사이트 URL

사은품 API : https://etapi.ebaykorea.com/goods/listing/3-13-%ec%82%ac%ec%9d%80%ed%92%88-api/

 API : https://etapi.ebaykorea.com/goods/listing/3-14-%eb%8d%a4-api/


2. 
기존 상품 등록/수정 API Request 스펙 변경
   >> 기존 상품 등록/수정 시 사용하던 addtional >> gift 항목 사용하지 않음
        
상품 등록/수정 시 additional >> gift 항목 포함된 경우 에러는 발생하지 않으나연동 값 저장되지 않음
        상품 조회 시 additional > gift 항목 null로 조회됨
        
       [
스펙 변경 대상 API]
      상품등록 : [POST] https://sa.esmplus.com/item/v1/goods?isSync=true

상품수정 : [PUT] https://sa.esmplus.com/item/v1/goods/{goodsNo}?isSync=true

상품수정(구옵션사용_제한) : [PUT] https://sa.esmplus.com/item/v1/goods/{goodsNo}/sync-options?isSync=true

3. 
주문조회 API response 항목 추가/변경
   
API URL :  [POST] https://sa.esmplus.com/shipping/v1/Order/RequestOrders (주문 조회)

         [POST] https://sa.esmplus.com/shipping/v1/Order/PreRequestOrders (입금확인 전 주문 조회)

  - 
기존 OptionGoods 항목 삭제
  - RequestOrders 
하위에 FreeGift, FreeGiftCode, Bonus, BonusCode 항목 추가



세부 내용은 첨부파일 확인 부탁드리며,

궁금한 사항 있으시면 언제든지 Q&A로 문의 부탁드립니다.


감사합니다.