상품수정

상품 수정 요청 (수정만 가능)

POST https://api.shopling.co.kr/prod/prod_modify_api.phtml?mode=2 호출 방식

요청

필드설명타입형식최대필수비고
<reqst>
<apiProdMdy>
login_id로그인IDCDATAY
company_id고객사 아이디YshopPling 발급
api_auth_keyAPI 인증코드YshopPling 발급
partner_id제휴사 전용 (샵플링 발급)
<goodsInfo> 반복 상품 정보 시작 태그(상품당1개)
goods_key샵플링 상품코드Y존재하면 먼저 검색함 우선순의 첫번째 (수정 key)
ptn_goods_cd고객사 상품코드CDATAY샵플링 상품코드가 없을시 검색함 우선순의 두번째 (수정key)
goods_var_name상품정보 변수명CDATA(상품필드 기술서 변수 참조) 변수 미선언시 수정되지않음
<options> 반복 옵션정보 시작 미선언시 수정되지않음
optClear옵션삭제여부CDATAY: 삭제
<optList> 반복 옵션 단수만큼 반복 (단품은 한번만 옴) 조합으로 매치되는 옵션만 수정합니다.
title옵션명 (옵션항목명)CDATAY(단품은 "단품" 으로 표기)
value옵션구성값(구분자 “,” 로 구분)CDATAY(단품은 "단품" 으로 표기)
optStatus판매상태(구분자 “,” 로 구분)Y조합으로 B:판매, C:품절, X:미사용
optQty현재고(구분자 “,” 로 구분)Y조합으로 현재수량
optVrtlQty가상재고(구분자 “,” 로 구분)조합으로 가상재고수량
optSaveQty안전재고(구분자 “,” 로 구분)조합으로 안전재고수량
optBundleQty묶음수량(구분자 “,” 로 구분)조합으로 묶음수량
optAmt추가금액(구분자 “,” 로 구분)조합으로 추가금액 없으면 “0”
optWeight무게 g단위(구분자 “,” 로 구분)
optBarcode바코드(구분자 “,” 로 구분)
optStoreMemo창고메모(구분자 “,” 로 구분)CDATA(구분자 “,” 로 구분)
optNo옵션정렬순서(구분 “,” 로 구분)CDATA(구분자 “,” 로 구분)
optPtnOptCd자체관리옵션코드(구분 “,” 로 구분)
optImgUrl옵션 이미지 urlCDATA(구분 “,” 로 구분) 2017.03.22 추가
optDescUrl옵션 상세설명 urlCDATA(구분 “,” 로 구분) 2017.03.22 추가
optOrgAmt옵션 원가 추가금액CDATA(구분 “,” 로 구분) 2017.09.06 추가
<goodsAttri> 반복 상품고시정보 시작태그 (여러개 가능) 미선언시 수정되지않음
<attriList> 반복
code상품정보고시분류코드CDATAY(상품정보고시 분류코드참조)
attri_var_name상품속성변수CDATA(상품정보고시 분류코드 속성 변수 참조) 변수 미선언시 수정되지않음

응답

필드설명타입형식최대필수비고
<rspns>
<apiProdMdyRst>
login_id로그인IDCDATAY
company_id고객사 아이디YshopPling 발급
<goodsRst> 반복
goods_key샵플링 상품코드
ptn_goods_cd고객사 상품코드CDATA
code성공,실패 결과코드CDATA
msg성공,실패 결과메세지CDATA
succs_cnt성공건수실패시 에러코드 반환
fail_cnt실패건수실패시 에러메세지 반환

요청 예시

<?xml version="1.0" encoding="UTF-8"?>
<reqst>
   <apiProdMdy>
      <login_id><![CDATA[shoppling]]></login_id>
      <company_id>S001</company_id>
      <api_auth_key>fgsddfgfkdgdkfgk</api_auth_key>
      <goodsInfo>
         <goods_key>100051</goods_key>
         <ptn_goods_cd><![CDATA[A1000045]]></ptn_goods_cd>
         <prod_tp><![CDATA[A]]></prod_tp>
         <prod_nm><![CDATA[수정상품명]]></prod_nm>
         <org_price><![CDATA[45000]]></org_price>
         <sale_price><![CDATA[60000]]></sale_price>
         <list_price><![CDATA[80000]]></list_price>
         <tax_tp><![CDATA[A]]></tax_tp>
         <sex_tp><![CDATA[해당없음]]></sex_tp>
         <sale_area><![CDATA[수도권]]></sale_area>
         <sale_status><![CDATA[B]]></sale_status>
         <origin_nm><![CDATA[국산]]></origin_nm>
         <dtl_desc><![CDATA[상세설명]]></dtl_desc>
         <img_0><![CDATA[http://img.aaa.co.kr/aaa.jpg]]></img_0>
         <img_19><![CDATA[http://img.aaa.co.kr/aaa.jpg]]></img_19>
         <options>
            <optList>
               <title><![CDATA[색상]]></title>
               <value><![CDATA[파랑,검정]]></value>
            </optList>
            <optList>
               <title><![CDATA[사이즈]]></title>
               <value><![CDATA[대,중,소]]></value>
            </optList>
            <optStatus>B,B,B,B,B,B</optStatus>
            <optQty>50,51,52,53,54,55</optQty>
            <optVrtlQty>500,500,500,500,500,500</optVrtlQty>
            <optAmt>2500,2000,2500,3000,5000,5000</optAmt>
         </options>
         <goodsAttri>
            <attriList>
               <code><![CDATA[03]]></code>
               <a002><![CDATA[3일]]></a002>
               <a003><![CDATA[파랑색과 검정색]]></a003>
               <a005><![CDATA[행복물산 / 국산]]></a005>
               <a006><![CDATA[대한민국]]></a006>
               <a009><![CDATA[상세설명참조]]></a009>
               <a010><![CDATA[AS번호 : 080-000-0000]]></a010>
               <a011><![CDATA[비뚤어짜기 금지]]></a011>
               <a012><![CDATA[상세설명참조]]></a012>
               <a013><![CDATA[소가죽]]></a013>
               <a014><![CDATA[가로30cm, 세로20cm]]></a014>
            </attriList>
         </goodsAttri>
      </goodsInfo>
      <goodsInfo>
         <goods_key>100052</goods_key>
         <ptn_goods_cd><![CDATA[A1000046]]></ptn_goods_cd>
         <prod_tp><![CDATA[A]]></prod_tp>
         <prod_nm><![CDATA[수정상품명]]></prod_nm>
         <org_price><![CDATA[45000]]></org_price>
         <sale_price><![CDATA[60000]]></sale_price>
         <list_price><![CDATA[80000]]></list_price>
         <tax_tp><![CDATA[A]]></tax_tp>
         <sex_tp><![CDATA[해당없음]]></sex_tp>
         <sale_area><![CDATA[수도권]]></sale_area>
         <sale_status><![CDATA[B]]></sale_status>
         <origin_nm><![CDATA[국산]]></origin_nm>
         <dtl_desc><![CDATA[상세설명]]></dtl_desc>
         <img_0><![CDATA[http://img.aaa.co.kr/aaa.jpg]]></img_0>
         <img_19><![CDATA[http://img.aaa.co.kr/aaa.jpg]]></img_19>
         <options>
            <optList>
               <title><![CDATA[색상]]></title>
               <value><![CDATA[파랑,검정]]></value>
            </optList>
            <optList>
               <title><![CDATA[사이즈]]></title>
               <value><![CDATA[대,중,소]]></value>
            </optList>
            <optStatus>B,B,B,B,B,B</optStatus>
            <optQty>50,51,52,53,54,55</optQty>
            <optVrtlQty>500,500,500,500,500,500</optVrtlQty>
            <optAmt>2500,2000,2500,3000,5000,5000</optAmt>
         </options>
         <goodsAttri>
            <attriList>
               <code>03</code>
               <a002><![CDATA[3일]]></a002>
               <a003><![CDATA[파랑색과 검정색]]></a003>
               <a005><![CDATA[행복물산 / 국산]]></a005>
               <a006><![CDATA[대한민국]]></a006>
               <a009><![CDATA[상세설명참조]]></a009>
               <a010><![CDATA[AS번호 : 080-000-0000]]></a010>
               <a011><![CDATA[비뚤어짜기 금지]]></a011>
               <a012><![CDATA[상세설명참조]]></a012>
               <a013><![CDATA[소가죽]]></a013>
               <a014><![CDATA[가로30cm, 세로20cm]]></a014>
            </attriList>
         </goodsAttri>
      </goodsInfo>
   </apiProdMdy>
</reqst>

응답 예시

<?xml version="1.0" encoding="UTF-8"?>
<rspns>
   <apiProdMdyRst>
      <login_id><![CDATA[shoppling]]></login_id>
      <company_id>S001</company_id>
      <goodsRst>
         <goods_key>100051</goods_key>
         <ptn_goods_cd><![CDATA[A1000045]]></ptn_goods_cd>
         <code><![CDATA[000]]></code>
         <msg><![CDATA[정상]]></msg>
      </goodsRst>
      <goodsRst>
         <goods_key>100052</goods_key>
         <ptn_goods_cd><![CDATA[A1000046]]></ptn_goods_cd>
         <code><![CDATA[000]]></code>
         <msg><![CDATA[정상]]></msg>
      </goodsRst>
      <succs_cnt>2</succs_cnt>
      <fail_cnt>0</fail_cnt>
   </apiProdMdyRst>
</rspns>

결과코드

000 정상
001 상품옵션수정 실패
002 상품이미지수정 실패
003 상품정보고시수정 실패
004 상품상세설명 수정 실패
100 상품명 누락
101 판매상태 누락
102 제조사 누락
103 원산지 누락
104 소비자가 누락
105 판매가 누락
106 공급가 누락
107 대표이미지 누락
108 상세설명 누락
109 상품기본정보수정 실패
110 패키지 구성상품 삭제 불가 (패키지 상품의 구성상품은 판매상태를 삭제(Z)로 변경할 수 없음)