재고입고등록

[E1] 상품입고관리 입고(일반) 전표 등록 (엑셀대량입고등록과 동일)

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

요청

필드	설명	타입	형식	필수	비고
`<reqst>`
`<apiStockIn>`
`login_id`	로그인ID	CDATA		Y
`company_id`	고객사 아이디			Y	shopPling 발급
`api_auth_key`	API 인증코드			Y	shopPling 발급
`strage_cd`	입고창고 코드			Y	[E] 창고관리에 등록된 사용중 창고코드
`detail_tp`	입고구분			Y	O:정상 R:반품 E:교환 M:이동 S:실사 Z:기타
`inout_dt`	입고일자		YYYYMMDD		미선언시 호출일자. 행별 inout_dt 가 있으면 그 값 우선
`invntry_nm`	전표명	CDATA			미선언시 "API 입고전표"
`memo`	전표 메모	CDATA
`apply_yn`	재고반영여부				Y:등록 즉시 재고반영 / N:미반영 등록(기본) - [E1] 상품입고관리에서 재고반영
`fail_tp`	오류처리방식				A:한 건이라도 오류면 전체 미등록(기본) / P:오류건만 제외하고 등록
`<stockInfo>` 반복 1회 최대 5,000건
`barcode`	바코드	CDATA			barcode 또는 prod_id+opt_id 중 하나 필수 (barcode 우선)
`prod_id`	샵플링 상품코드	number
`opt_id`	샵플링 옵션코드	number
`qty`	입고수량	number		Y	0 제외 정수
`unit`	상태	CDATA			"불량" 포함시 불량재고로 입고
`cust_cd`	매입처코드				매입처(공급처) 코드. 매입처+입고일자가 같은 행끼리 한 전표로 등록
`loct_nm`	로케이션	CDATA
`memo`	명세 메모	CDATA
`inout_dt`	입고일자		YYYYMMDD

응답

필드	설명	타입	필수	비고
`<rspns>`
`<apiStockInRst>`
`login_id`	로그인ID		Y
`company_id`	고객사 아이디		Y
`<stockListRst>` 반복 요청 stockInfo 순서대로
`seq`	요청 행번호	number
`barcode`	바코드
`prod_id`	샵플링 상품코드	number
`opt_id`	샵플링 옵션코드	number
`invntry_no`	등록된 입고전표번호			등록된 경우만
`code`	결과코드	CDATA
`msg`	결과메세지	CDATA
`succs_cnt`	성공건수
`fail_cnt`	실패건수

요청 예시

<?xml version="1.0" encoding="UTF-8"?>
<reqst>
   <apiStockIn>
      <login_id><![CDATA[shoppling]]></login_id>
      <company_id>S001</company_id>
      <api_auth_key>fgsddfgfkdgdkfgk</api_auth_key>
      <strage_cd>A001</strage_cd>
      <detail_tp>O</detail_tp>
      <inout_dt>20261008</inout_dt>
      <apply_yn>Y</apply_yn>
      <fail_tp>A</fail_tp>
      <stockInfo>
         <barcode><![CDATA[8801234567890]]></barcode>
         <qty>3</qty>
      </stockInfo>
      <stockInfo>
         <prod_id>100058</prod_id>
         <opt_id>2</opt_id>
         <qty>1</qty>
         <cust_cd>B001</cust_cd>
      </stockInfo>
   </apiStockIn>
</reqst>

응답 예시

<?xml version="1.0" encoding="UTF-8"?>
<rspns>
   <apiStockInRst>
      <login_id>shoppling</login_id>
      <company_id>S001</company_id>
      <stockListRst>
         <seq>1</seq>
         <barcode>8801234567890</barcode>
         <prod_id>100057</prod_id>
         <opt_id>1</opt_id>
         <invntry_no>261008-3-0001</invntry_no>
         <code><![CDATA[000]]></code>
         <msg><![CDATA[정상]]></msg>
      </stockListRst>
      <stockListRst>
         <seq>2</seq>
         <barcode></barcode>
         <prod_id>100058</prod_id>
         <opt_id>2</opt_id>
         <invntry_no>261008-3-0002</invntry_no>
         <code><![CDATA[000]]></code>
         <msg><![CDATA[정상]]></msg>
      </stockListRst>
      <succs_cnt>2</succs_cnt>
      <fail_cnt>0</fail_cnt>
   </apiStockInRst>
</rspns>

결과코드

000 : 정상
901 : 입력값 오류 (상품정보 누락, 코드·수량·매입처·일자 형식 오류)
910 : 대상 상품 없음 (재고관리 대상 상품이 아니거나 재고연결상품)
920 : 다른 행의 오류로 등록되지 않음 (fail_tp=A)
930 : 등록 실패
940 : 입고전표는 등록되었으나 재고반영 실패 (미반영 전표로 남음, apply_yn=Y)

※ 요청 전체 오류(인증 실패, 재고관리 미사용 업체, 창고·입고구분 코드 오류, 5,000건 초과 등)는 XML 이 아닌 안내 문구로 응답합니다.