KCTC Fulfillment

API 연동 가이드

고객사 ERP 연계를 주목적으로 하는 B2C 표준API 입니다

표준 API 사용

표준 API 사용
- API 목록
- 이용안내
SKU
- SKU 등록/수정
- SKU 조회
주문
- 주문 / 교환 배송 지시
- 주문 취소
- 주문 조회
- 운송장 조회
- 주문 상태 조회
- 배송 진행 상태 조회
회수
- 반품 / 교환 회수 지시
- 반품 취소
- 반품 조회
- 반품 수거 송장 등록
- 반송장 조회
입고
- 입고 등록
- 입고 처리 결과 조회
재고
- SKU별 재고현황 조회
- SKU별 재고수불 조회
반출
- 반출 지시
- 반출 처리 결과 조회

API 목록

고객사 ERP 연계를 주목적으로 하는 B2C 표준API 입니다.

분류	항목	설명
SKU	SKU 등록/수정	SKU 정보를 등록/수정 요청합니다.
SKU	SKU 조회	SKU 정보를 조회 요청합니다.
주문	주문 / 교환 배송 지시	주문 등록 요청합니다.
	주문 취소	주문 취소 요청합니다.
	주문 조회	주문 조회 요청합니다.
	운송장 조회	운송장 조회 요청합니다.
	주문 상태 조회	주문 상태 조회 요청합니다.
	배송 진행 상태 조회	배송 진행 상태 조회 요청합니다.
회수	반품 / 교환 회수 지시	반품 / 교환 회수 지시 요청합니다.
	반품 취소	반품 취소 요청합니다.
	반품 조회	반품 조회 요청합니다.
	반품 수거 송장 등록	반품 수거 송장 등록 요청합니다.
	반송장 조회	반송장 조회 요청합니다.
입고	입고 등록	입고 등록 요청합니다.
입고	입고 처리 결과 조회	입고 처리 결과 조회 요청합니다.
재고	SKU별 재고현황 조회	SKU별 재고현황 조회 요청합니다.
재고	SKU별 재고수불 조회	SKU별 재고수불 조회 요청합니다.
반출	반출 지시	반출 지시 조회 요청합니다.
반출	반출 처리 결과 조회	반출 처리 결과 조회 요청합니다.

표준API 사용신청
- 1. K-ONE 사이트의 표준API 사용신청을 클릭합니다.
- 2. 이용약관을 읽으시고 "이용약관" 에 동의 또는 전체동의를 클릭합니다.
- 3. "회원가입" 을 클릭합니다.
- 4. 로그인에 사용할 회사정보, 가입자정보를 입력합니다.
  ※ 이메일은 API 토큰 발급 또는 비밀번호 찾기에서 사용되므로 정확히 입력합니다.
- 5. 이메일 및 아이디, 사업자등록번호를 입력하시고 "중복확인" 를 클릭합니다.
- 6. 비밀번호는 비밀번호 규칙에 맞게 입력하시고 비밀번호 확인에 동일한 비밀번호를 입력합니다.
- 7. "가입하기" 를 클릭하시면 승인 후 이용 신청자에게 이메일로 인증번호가 전달됩니다.
API 토큰 발행
- 사용자 아이디, 비밀번호, 이메일로 부여받은 인증번호를 매개변수로 해당 액세스 API의 요청을 진행합니다.
  ※ 토큰의 유효시간은 24시간이고 만료된 토큰을 이용한 API 사용은 할 수 없습니다.
API 사용
- 1. API 토큰 발행을 진행합니다.
- 2. 테스트 대상 API 호출합니다.
  ※ API 호출시 매개변수로 API토큰은 필수값입니다.
API 가이드 다운로드
- 1. API 목록을 클릭합니다.
- 2. 표준 API 개발 가이드 다운로드합니다.
  ※ 자료 다운로드는 승인된 사용자만 가능합니다.

Request Parameters

Method	URL	Content Type
Post	/sku/insertSku	application/json

Request Field

Key	Type	Required	Description	Example
BARCODE	string	Yes	바코드	7709809427887
SET_SKU_YN			세트여부	N / Y
BRD_CD			브랜드	01238
MK_CD			제조사	01
SKU_NM			SKU명	클립형차량용디퓨저2구다크그레이소프트솝
COLOR			색상	01
MDL_NM			모델	01
CATE_CD			물류카테고리	1010100000
SKU_PRICE			SKU공급원가	1000
SKU_MNGR_CD			관리코드	30220763
STK_NO			상품관리코드	226513
UNIT_CD			판매단위	1
UNIT_QTY			단위 입수량	40
SKU_WIDTH			가로	8
SKU_HEIGHT			세로	8
SKU_VERTICAL			높이	8
SKU_WEIGHT			중량	170
EXPY_DAY			상미기한(유통기한 최대,최소일수)	0
EXPY_LMT_LW_DAY			입고제한일수	0
EXPY_LMT_OW_DAY			출고제한일수	0
SERIAL_YN			시리얼여부	N / Y
DIFF_STK_YN			이형상품여부	N / Y
COMB_PACK_YN			합포장가능여부	N / Y
REPACK_YN			재포장가능여부	N / Y
GIFT_YN			사은품여부	N / Y

An Example request

[ {
"barcode":"7709809427887",
"setSkuYn":Y,
"brdCd":"01238",
"mkCd":"01",
"suNm":"클립형차량용디퓨저2구다크그레이소프트솝",
"color":"01",
"mdlNm":01,
"cateCd":"1010100000",
"skuPrice ":"1000"
“skuMngrCd”:”30220763”,
“stkNo”:”226513”,
“unitCd”:”1”,
“unitQty”:”40”,
“skuWidth”:”8”,
“skuHeight”:”8”,
“skuVertical”:”8”,
“skuWeight”:”170”,
“expyDay”:”0”,
“expyLmtLwDay”:”0”,
“expyLmtOwDay”:”0”,
“serialYn”:”Y”,
“diffStkYn”:”Y”,
“combPackYn”:”Y”,
“repackYn”:”Y”,
“giftYn”:”N”
},]

Request Parameters

Method	URL	Content Type
Get	/sku/selectSKU	application/json

Request Field

Key	Type	Required	Description	Example
SELLER_ID	string	No	셀러ID	115096
SS_DC_CD		Yes	* B2C 센터코드 BS :백사센터 BB :부발센터	BS
SS_USER_NM		No	사용자명
BARCODE			바코드
SKU_NO			SKU번호	511422
USE_YN		Yes	사용여부	Y,N

An Example Response Structure

[
{
"ssDcCd ":"BS",
“useYn”:”Y”,
“sellerId”:””,
“ssUserNm”:””
“barcode”:””
“skuNo”:”511422”
}, ]

Response json structure Response Field

	Key	Type	Description
HEADER	RESPONSE_STATUS	string	상태
	RESPONSE_MESSAGE		메시지
	RESPONSE_SYSTEM		시스템
BODY	SKU_STATE		SKU상태
	UNIT		단위
	EXPY_MNGR_DV_CD		유통기한_관리구분_코드
	REPACK_YN		재포장_가능_여부
	LENGTH
	SKU_NO		SKU_번호
	BARCODE		바코드
	SERIAL_YN		시리얼여부
	SKU_NM		SKU_명
	DIFF_STK_YN		이형물상품여부
	WIDTH		가로
	CUST_NO		거래처_번호
	BOX_QTY		박스입수
	HEIGHT		높이
	BASE_LOCATION		기본적치로케이션
	CUST_NM		고객 명
	CBM		CBM
	COMB_PACK_YN		합포장_가능_여부
	EXPY_DAY		유통기한_일수
	USE_YN		사용여부
	EXPY_LMT_LW_DAY		유통기한_입고_제한일수
	EXPY_LMT_OW_DAY		유통기한_출고_제한일수
	WEIGHT		중량

An Example Response Structure

{"KCTC_RES":{
"RESPONSE_HEADER":
{"responseStatus":"200",
"responseMessage":"data length : 1579",
"responseSystem":"KCTC"
},
"RESPONSE_BODY":[
{
"skuState":"SI304",
"unit":"1",
"expyMngrDvCd":"Y",
"repackYn":"N",
"length":10,
"skuNo":"1045",
"barcode":"20230821001111",
"serialYn":"N",
"skuNm":"8월21일유통가공테스트",
"diffStkYn":"N",
"width":10,
"custNo":"115096",
"boxQty":10,
"height":10,
"baseLocation":"1F-D01-01-01",
"custNm":"(테스트)셀러",
"cbm":1000,
"combPackYn":"N",
"expyDay":100,
"useYn":"Y",
"expyLmtLwDay":10,
"expyLmtOwDay":10,
"weight":10
},
{
" skuState":"SN100",
" unit":"1",
"expyMngrDvCd":"Y",
"repackYn":"Y",
" length":7.5,
" skuNo":"1046",
" barcode":"8809693252794",
"serialYn":"N",
"skuNm":"지성샴푸500ml1구체리블라썸",
"diffStkYn":"N",
" width":7.5,
" custNo":"115096",
" boxQty":20,
" height":17.5,
" baseLocation":"1F-D01-01-02",
"custNm":"(테스트)셀러",
" cbm":984.375,
"combPackYn":"Y",
" expyDay":730,
"useYn":"Y",
" expyLmtLwDay":210,
" expyLmtOwDay":0,
" weight":598
}, }

Request Parameters

Method	URL	Content Type
Post	/ord/insertOrd	application/json

Request Field

Key	Type	Required	Description	Example
CUST_NO	string	Yes	고객번호	115096
ORD_DTM		Yes	주문일자
SITE_DV_CD		No	쇼핑몰	98
ORD_NO		Yes	주문번호	20000126605
CART_NO			장바구니번호	10857783
RECV_ZIP_CD			우편번호	30062
RECV_ADDR1			기본주소	-
DELV_TYPE			배송유형	20
RECV_ADDR2		No	상세주소	1804-603
DELV_CPY_NO		Yes	택배사	4
RECV_MOBILE		Yes	휴대폰	-
RECV_PHONE		No	전화번호	-
RECV_NM		Yes	수령자명	-
REMARK		No	비고
DELV_MEMO		No	배송요청사항
SKU_NO		Yes	SKU번호	511471
SKU_NM		No	SKU명
ORD_QTY		Yes	수량	1

An Example request

[
{
"custNo":"115096 ",
"ordDtm":,
"siteDvCd":"98 ",
"ordNo":"20000126605 ",
"cartNo":"10857783 ",
"recvZipCd":"30062 ",
"recvAddr1":””,
"delvType":"20 ",
"recvAddr2":" 1804-603 "
"delvCpyNo":"4 ",
"recvMobile":"",
"recvPhone":"",
"recvNm":"한란*",
"remark ":"",
"delvMemo":"",
"skuNo":"511471 ",
"skuNm":"",
"ordQty":"1" }]

Request Parameters

Method	URL	Content Type
Post	/ord/cancelOrd	application/json

Request Field

Key	Type	Required	Description	Example
CUST_NO	string	Yes	셀러ID	115096
SITE_DV_CD			구매사이트코드	98
CART_NO			장바구니 번호	10857783
ORD_TP			주문유형
USER_ID			사용자ID	admin

An Example request

[
{
"custNo":"115096",
"siteDvCd":98,
"cartNo":"10857783",
"ordTp":"",
"userId":"admin”
},
]

Request Parameters

Method	URL	Content Type
Post	/ord/selectOrd	application/json

Request Field

Key	Type	Required	Description	Example
SS_DC_CD	string	Yes	B2C 센터코드	BS :백사센터 BB :부발센터
calTo			조회 날짜to	20231201
calFrom			조회 날짜 from	20231204
SS_USER_NM		No	사용자 명	관리자
whState			출고 상태	99990101
SS_USER_ID			사용자 ID	admin
skuNo			SKU 번호	511471
custId			셀러 ID	115096

An Example request

[
{
"ssDcCd":"BS",
"calTo":,
"calFrom":"",
"ssUserNm":"20230824",
"whState":"99990101",
"ssUserId":"100",
"skuNo":511471,
"custId":"623113"
},
]

Response json structure Response Field

	Key	Type	Description
HEADER	RESPONSE_STATUS	string	상태
	RESPONSE_MESSAGE		메시지
	RESPONSE_SYSTEM		시스템
BODY	SITE_NM		사이트_명
	ORD_TYPE_CD		주문유형
	KFM_CART_NO		내부_장바구니_번호
	DLV_TYPE		배송방식(10:화물,20:택배)
	RECV_ADDR_1		수령인_주소_1
	RECV_ADDR_2		수령인_주소_2
	ORD_STATE		OMS주문_상태_코드
	ORD_NO		OMS주문번호
	WH_FAIL_RESON		출고실패_사유
	CNCL_YN		취소여부
	RECV_PHONE		수령인_휴대폰번호
	RECV_ZIP_CD		수령인_우편번호
	RECV_ADDR		수령인_주소
	WMS_IF_YN		WMS인터페이스여부
	CART_NO		장바구니_번호
	ORD_DTM		주문_일시
	KFM_ORD_NO		KFM주문번호
	DELV_CPY_NO		택배사코드
	ORG_ORD_ID		원주문ID
	WH_STATE		출고진행_상태
	REG_DTM		등록일시
	KFM_ORD_ST_CD		KFM주문상태코드
	SKU_NO		SKU 번호
	CUST_NO		거래처_번호
	ORD_ID		주문ID
	WH_REQ_DTM		출고_요청_일시
	LC_ID		물류센터코드
	RECV_NM		수령인_명
	SITE_DV_CD		사이트_구분_코드
	ORG_ORD_NO		원주문번호
	RECV_MOBILE		수령인_휴대폰번호
	REG_NO		등록자ID
	WH_FAIL_CD		출고실패_코드
	ORD_QTY		주문 수량

An Example Response Structure

Request Parameters

Method	URL	Content Type
Post	/ord/selectINV	application/json

Request Field

Key	Type	Required	Description
SS_USER_NM	string	No	사용자 명
SS_COMP_CD		Yes	회사 코드
SS_DC_CD		Yes	물류센터 코드
INVC_PRN_DT		No	검수일시
BATCH_NO			배치번호
CARTON_NO			카톤번호
INVC_NO			송장번호
ORDER_TP_CD			주문특성
INVC_PRN_YN			운송장발행여부
EFM_BKT_NO			EFM장바구니번호

An Example request

[
{
" ssUserNm ":"",
" ssCompCd ":115096,
" ssDcCd ":"BS",
" inDt":"",
" invcPrnDt ":"",
" batchNo ":"",
" cartonNo ":””,
" invcNo ":"",
" orderTpCd ":"",
" invcPrnYn ":"",
" efmBktNo ":""
},
]

Response json structure Response Field

	Key	Type	Description
HEADER	RESPONSE_STATUS	string	상태
	RESPONSE_MESSAGE		메시지
	RESPONSE_SYSTEM		시스템
BODY	SELLER_NM		셀러 명
	SELLER_ID		Seller ID
	COMP_CD		회사코드
	CRR_CD		운송사코드
	CRR_NM		운송사명
	CARTON_NO		카톤번호
	BATCH_NO		배치번호
	STAT		상태
	INVC_NO		운송장번호
	ORD_YMD		주문일자
	ORD_ALLOC_YMD		주문할당일자
	DC_CD		물류센터코드
	UPT_DT		수정일자
	UPT_USER		수정자

Request Parameters

Method	URL	Content Type
Post	/ord/selectOrdState	application/json

Request Field

Key	Type	Required	Description
SS_USER_NM	string	No	사용자명
SS_DC_CD		Yes	B2C 센터코드
WH_STATE		No	출고상태
SS_USER_ID			사용자 ID
calTo			거래처 ID
skuNo			SKU 번호
CUST_ID			거래처 ID
calFrom	number		검색날짜 From
seltoOrdStateNm	string		샐러툴 주문상태명

An Example request

[
{
" ssUserNm ":"",
" ssDcCd ": BS,
" whState ":"",
" ssUserId ":"",
" calTo ":"",
" skuNo ":"",
" custId ":””,
" calFrom ":"",
" seltoOrdStateNm ":""
}, ]

Request Parameters

Method	URL	Content Type
Post	/ord/selectDlvProgState	application/json

Request Field

Key	Type	Required	Description	Example
sellerId	string	Yes	셀러ID	115096
lcId			B2C 센터코드 BS :백사센터 BB :부발센터 IC :이천센터	BS
locCd			공유로케이션 코드
skuNo			SKU번호
makeDt			제조일자
expiryDt			유통일자
inDt			입고일자
qty			이동수량

An Example request

[
{
" ssUserNm ":"",
" ssDcCd ":BS,
" whState ":"",
" ssUserId ":"",
" calTo ":"",
" skuNo ":"",
" custId ":,
" calFrom ":"",
" dlvStat ":"",
" ordNo ":"”
},
]

Request Parameters

Method	URL	Content Type
Post	/rtn/directRtnExchg	application/json

Request Field

Key	Type	Required	Description	Example
sellerId	string	Yes	셀러ID	115096
lcId			B2C 센터코드 BS :백사센터 BB :부발센터 IC :이천센터	BS
locCd			공유로케이션 코드	SHARED1
skuNo			SKU번호	731241
makeDt			제조일자	99991231
expiryDt			유통일자	99991231
inDt			입고일자	20220915
qty			이동수량	1000

An Example request

[
{
" sellerId ":"115096",
" lcId ": BS,
" locCd ":"",
" skuNo ":"",
" makeDt ":"",
" expiryDt ":"",
" inDt ":,
" qty ":""}
,]

Request Parameters

Method	URL	Content Type
Post	/rtn/cancelRtn	application/json

Request Field

Key	Type	Required	Description	Example
sellerId	string	Yes	셀러ID	115096
lcId			B2C 센터코드 BS :백사센터 BB :부발센터 IC :이천센터	BS
locCd			공유로케이션 코드	SHARED1
skuNo			SKU번호	731241
makeDt			제조일자	99991231
expiryDt			유통일자	99991231
inDt			입고일자	20220915
qty			이동수량	1000

An Example request

[
{
" sellerId ":"",
" lcId ": BS,
" locCd ":"",
" skuNo ":"",
" makeDt ":"",
" expiryDt ":"",
" inDt ":0,
" qty ":""
}
,]

Request Parameters

Method	URL	Content Type
Post	/rtn/selectRtnItem	application/json

Request Field

Key	Type	Required	Description
sellerId	string	Yes	셀러ID
lcId			B2C 센터코드 BS :백사센터 BB :부발센터 IC :이천센터
locCd			공유로케이션 코드
skuNo			SKU번호
makeDt			제조일자
expiryDt			유통일자
inDt			입고일자
qty			이동수량

An Example request

[
{
" reqFmDt ":"",
" ssDcCd ": BS,
" reqToDt ":"",
" ssUserNm ":"",
" ssCompCd ":"10"
}
]

Request Parameters

Method	URL	Content Type
Post	/rtn/saveRtnInv	application/json

Request Field

Key	Type	Required	Description
sellerId	string	Yes	셀러ID
ssDcCd			B2C 센터코드 BS :백사센터 BB :부발센터
transNum			원송장번호
rtnTransNum			반품송장번호

An Example request

[
{
" sellerId ":"115096",
" ssDcCd ":BS,
" transNum ":"12345",
" rtnTransNum ":"67890"
}
]

Request Parameters

Method	URL	Content Type
Post	/rtn/selectRtnInv	application/json

Request Field

Key	Type	Required	Description	Example
SS_DC_CD	string	Yes	물류센터코드	BS
SS_COMP_CD			회사코드	10
SS_USER_NM			사용자명	admin
RTN_INVC_NO			반품송장번호	12345
REQ_FM_DT			요청일자(시작)	20231101
REQ_TO_DT			요청일자(끝)	20231130

An Example request

[
{
" ssDcCd ":"BS",
" ssCompCd ":10,
" ssUserNm ":"admin",
" rtnInvcNo ":"12345",
" reqFmDt ":"20231101",
" reqToDt ":"20231130"
}
]

Response Field

	Key	Type	Description
HEADER	RESPONSE_STATUS	string	상태
	RESPONSE_MESSAGE		메시지
	RESPONSE_SYSTEM		시스템
BODY	ORG_IO_NO		원 반품지시번호
	RTN_REQ_DT		반품요청일
	HOME_TEL		전화번호
	RCPNT		수취인
	GDI_TP		입고유형
	HP		핸드폰번호
	REG_DT		등록일자
	REG_USER		등록자
	UPT_DT		수정일자
	UPT_USER_NM		수정자
	EFM_IO_NO		EFM 반품번호
	IO_NO		반품지시번호
	STAT		상태
	ORG_INVC_NO		원송장번호
	REG_USER_NM		등록자명
	RTN_INVC_NO		반송장번호
	EFM_BKT_NO		수정자

Request Parameters

Method	URL	Content Type
Post	/in/insertAsn	application/json

Request Field

Key	Type	Required	Description	Example
SKU_NO	string	Yes	SKU번호	123456
IST_SCHD_DTM			입고예정일	20231201
IST_NM			입고명	test
IST_MTH			입고방식	10
DTCT_CD			요청창고	BS
DISP_ORG_ADDR			주소	100
DIST_ORG_ZIP_CD			우편번호	0
IST_SCHD_QTY			입고예정수량	10
BARCD_ATTCH_YN			바코드부착여부	N / Y
MNFC_DT			제조일자	99990101

An Example request

[
{
" skuNo ":"123456",
" istSchdDtm ":20231201,
" istNm ":"test",
" istMth ":"10",
" dtctCd ":"BS",
" dispOrgAddr ":"100",
" distOrgZipCd ":0,
" istSchdQty ":"10",
" barcdAttchYn ":"Y"
" mnfcDt ":"99990101"
}
]

Request Parameters

Method	URL	Content Type
Post	/in/selectIn	application/json

Request Field

Key	Type	Required	Description
SS_DC_CD	string	Yes	센터코드
GDI_TP		No	입고유형
ITEM_CD			SKU 번호
IO_NO			입고지시번호
EFM_IO_NO			EFM입출고번호
SELLER			Seller ID
SKU_NM			SKU 명

An Example request

[
{
" ssDcCd ":"BS",
" gdiTp ":,
" itemCd ":"",
" ioNo ":"",
" efmIoNo ":"",
" seller ":"",
" skuNm ":””
}
]

Response json structure Response Field

	Key	Type	Description
HEADER	RESPONSE_STATUS	string	상태
	RESPONSE_MESSAGE		메시지
	RESPONSE_SYSTEM		시스템
BODY	SELLER_NM		Seller 명
	MOVE_STAT
	COMP_CD		회사코드
	ITEM_CD		SKU 번호
	FAULT_QTY		파손수량
	SELLER_ID		Seller ID
	ITEM_NM		SKU 명
	MNFC_DT		제조일자
	EXPT_GDI_DT		입고예정일자
	PALLET_NO		팔렛트 번호
	GDI_DT		입고일자
	EFM_IO_NO		EFM입출고번호
	BOX_ID		박스ID
	IO_NO		입고지시번호
	SALE_UNIT		판매 단위
	EXPRY_DT		유통일자
	BARCD_YN		바코드부착여부
	SERIAL_YN		시리얼관리여부
	CAR_DT_TM		입차일시
	NORM_QTY		정상수량
	DC_CD		물류센터코드 ( WM_DC )

Request Parameters

Method	URL	Content Type
Post	/stock/selectSKUStock	application/json

Request Field

Key	Type	Required	Description	Example
SS_DC_CD	string	Yes	물류센터 코드	BS
SS_COMP_CD			회사 코드	10
SS_USER_NM			사용자 명	admin
CLS_1			대분류
CLS_2			중분류
CLS_3			소분류
ITEM_CD			SKU ID	123456
SELLER_ID			Seller ID	115096

An Example request

[
{
" ssDcCd ":"BS",
" ssCompCd ":10,
" ssUserNm ":"admin",
" cls1":"",
" cls2":"",
" cls3":"",
" itemCd ":123456,
" sellerId ":"115096"
}
]

Response json structure Response Field

	Key	Type	Description
HEADER	RESPONSE_STATUS	string	상태
	RESPONSE_MESSAGE		메시지
	RESPONSE_SYSTEM		시스템
BODY	SELLER_NM		Seller 명
	STALOC_QTY		할당수량
	COMP_CD		회사코드
	ITEM_CD		SKU 번호
	RUIN_QTY		파손수량
	SELLER_ID		Seller ID
	ITEM_NM		SKU 명
	MNFC_DT		제조일자
	BARCODE		바코드
	EXP_YN		유통기한 관리여부
	GDI_DT		입고일자
	UNIT_CD		단위구분코드
	BAD_QTY		불량수량
	BOX_QTY		박스입수량
	CLS_3		소분류
	EXPRY_DT		유통일자
	HOLD_QTY		보류수량
	CLS_2		중분류
	CLS_1		대분류
	LOT		LOT
	QTY		현재고수량
	PSBL_QTY		가용수량
	DC_CD		물류센터코드 ( WM_DC )

Request Parameters

Method	URL	Content Type
Post	/stock/selectSKUStockRecPay	application/json

Request Field

Key	Type	Required	Example	Description
SS_DC_CD	string	Yes	물류센터코드	BS
SS_COMP_CD			회사코드
BASE_DT			기준날짜	20230101
FROM_DT			검색기간	20231201
TO_DT			검색기간	20231231
SELLER_ID		No	Seller ID	115096
ITEM_CD		No	SKU 번호

An Example request

[
{
" ssDcCd ":"BS",
" ssCompCd ":””,
" baseDt ":"20230101",
" fromDt ":"20231201",
" toDt ":"20231231",
" sellerId ":"115096",
" itemCd ":””
},
]

Response json structure Response Field

	Key	Type	Description
HEADER	RESPONSE_STATUS	string	상태
	RESPONSE_MESSAGE		메시지
	RESPONSE_SYSTEM		시스템
BODY	P_RTR_QTY		반품수량(+)
	P_GOD_QTY		양품수량(+)
	P_ESC_QTY		이관수량(+)
	P_RCV_QTY		입고수량(+)
	M_DSP_QTY		폐기수량(-)
	ITEM_NM		SKU명
	M_EPR_QTY		반출수량(-)
	M_ESC_QTY		이관수량(-)
	M_ADJ_HOLD_QTY		조정 보류수량(-)
	UNIT_CD		단위코드
	M_ADJ_QTY		조정수량(-)
	P_NOR_QTY		정상수량(+)
	STCK_QTY		재고수량
	STOCK		재고
	P_ADJ_NOR_QTY		조정 정상수량(+)
	P_RAD_QTY		반품(불량)수량(+)
	P_ADJ_QTY		조정수량(+)
	M_BAD_QTY		불량수량(-)
	M_NOR_QTY		정상수량(-)
	ITEM_CD		SKU 번호
	M_ADJ_BAD_QTY		조정 불량수량(-)
	INBW_QTY
	P_BSS_QTY
	M_RLS_QTY		출고수량(-)
	CUST_NM		고객사 명
	P_BAD_QTY		불량수량(+)
	P_ETC_QTY		기타수량(+)
	P_ADJ_BAD_QTY		조정 불량수량(+)
	M_GOD_QTY		양품수량(-)
	P_ADJ_HOLD_QTY		조정 보류수량(+)
	M_ADJ_NOR_QTY		조정 정상수량(-)
	M_ETC_QTY		기타 수량(-)

Request Parameters

Method	URL	Content Type
Post	/out/selectOutDirection	application/json

Request Field

Key	Type	Required	Description	Example
outDt	string	Yes	반출날짜	20231201
ordType			주문유형	10
sellerId			sellerId	admin
state			상태	01
siteDvCd			사이트코드
ssDcCd	number		B2C 센터코드	BS

An Example request

[
{
" outDt ":"20231201",
" ordType ":”10”,
" sellerId ":"admin",
" state ":"01",
" siteDvCd ":"",
" ssDcCd ":"BS"
}
]

Request Parameters

Method	URL	Content Type
Post	/out/selectOutResult	application/json

Request Field

Key	Type	Required	Description	Example
SS_COMP_CD	string	Yes	회사 코드	10
OUT_REQ_NO		No	반출요청번호
SKU_ID			SKU 번호	123456
CUST_NO			Seller ID	115096
FROM_SR_DT			검색기간 시작	20231201
TO_SR_DT			검색기간 끝	20231231

An Example request

[
{
" ssCompCd ":"10",
" outReqNo ":””,
" skuId ":"123456",
" custNo ":"115096",
" fromSrDt ":"20231201",
" toSrDt ":"20231231"
}
]

TOP

이커머스 풀필먼트의 시작, K-ONE FULFILLMENT와 함께

㈜케이씨티시

주소04532 서울특별시 중구 남대문로 63, 22층(소공동, 한진빌딩)
번호+82-2-310-0667

쿠키정책 개인정보취급방침

FAMILY SITE

KCTC