NAV

History

버전 개정일자 내용
1.0 2012-02-06 최초작성
1.1 2012-04-26 전체주문내역, 상품승인상태확인 추가
2.0 2012-12-07 레퍼런스 수정 및 발송 지연 처리 추가
2.1 2013-03-04 판매거부 (발송전 주문취소) 처리 추가
2013-03-11 상품 이미지 업데이트(재등록)여부 필드 추가 (2-5. 상품등록/수정)
2013-05-06 상품 이미지 다중 등록 (2-5. 상품등록/수정)
2013-08-21 타임세일기능 추가 (2-5. 상품등록/수정)
2013-12-18 주문리스트 조회 조건 변경 및 결제일 추가
2.2 2014-04-09 상품등록 – 상품정보고시 4개 항목 추가.
주문리스트에 묶음배송코드(DeliveryPackge) 추가.
구매확정리스트 조회
3.00 2017-02-08 API가이드 전면 개편
3.01 2017-04-17 전상품 고유번호 조회 API 추가, 정보고시항목추가(인증서번호), 기타 마이너 업데이트
3.02 2017-04-20 KC인증정보추가, 입금확인 상태의 주문도 발송처리(OrderInvoice) 가능하도록 수정
3.03 2017-05-23 부분취소 관련 필드 추가, 정보고시그룹 추가, 배송비유형코드 필수항목 표기 오류 수정, 기타 마이너 업데이트
3.04 2017-07-24 전체카테고리조회 추가, 상품등록/수정 API 수정, 주문/취소리스트 API 수정 등. 기타 마이너 업데이트
3.1 2018-03-23 옵션관련 API추가
3.11 2018-04-19 주문관련 API 가이드 보완/수정, 기타 마이너 업데이트
3.2 2018-11-29 상품정보고시 그룹 추가
3.21 2019-01-09 주문리스트 검색 조건 추가, 상품정보조회 API 추가
3.22 2019-01-10 주문리스트 수정 검색 조건 및 기타 마이너 업데이트
3.23 2019-04-05 api 상품등록 결과메세지 utf8 추가
3.24 2019-05-07 API 호출 제한 추가
3.25 2019-06-14 API 추가 및 수정
3.26 2020-01-28 일부 비활성 기능 제거 및 오탈자 수정
3.27 2020-01-29 상품정보조회시 누락된 항목 추가 및 오탈자 수정
3.28 2020-03-05 API로 등록되지 않은 상품 수정가능 및 이미지저장 로직 변경
3.3 2020-03-06 고객 CS 문의 조회 / 답변 추가
3.4 2020-03-20 주문관련 반품/교환 수거완료 처리 기능 추가
3.41 2020-08-14 발송처리 API 송장 정보 유효성 체크 기능 추가
3.42 2020-08-20 상품 등록 수정 API 상품명 중복 체크 기능 추가
3.5 2020-08-28 상품판매상태, 옵션재고 I/F 추가 및 기타 마이너 업데이트
3.51 2020-09-08 상품삭제(DelGoods) I/F 수정
3.52 2020-09-11 주문리스트(OrderInfo) I/F 수정 및 기타 버그 수정
3.53 2020-10-06 상품정보고시 그룹 추가
3.54 2021-03-31 발주처리시 배송예정일 설정기능 및 배송예정일 입력 I/F 추가
3.55 2021-04-02 상품 삭제상태 추가
3.56 2021-04-22 셀러플랜 조회 추가
3.57 2021-07-28 취소주문리스트 타입조회 추가
3.58 2021-10-19 상품정보고시 그룹 추가
3.59 2022-01-10 정보고시 관련 업데이트
2022-02-07 정보고시 관련 업데이트
2022-02-09 정보고시 관련 업데이트
3.6 2022-04-18 상품문의 API 삭제
3.61 2022-07-12 주문서 정산 확정 리스트 조회 API 추가
3.62 2022-09-05 품번 및 모델명 관련 수정
3.63 2023-04-10 칼럼 추가
3.7 2023-08-28 정산조회 I/F 추가
3.8 2024-01-24 AK전용 출회수지, 배송비정책 등록 I/F추가
3.9 2024-02-05 배송완료 I/F(AK전용)추가
3.901 2024-05-28 마이너 업데이트
3.902 2024-06-11 마이너 업데이트
3.903 2024-07-23 마이너 업데이트
3.904 2024-08-29 마이너 업데이트
3.905 2025-02-07 마이너 업데이트
3.906 2025-06-04 마이너 업데이트
3.907 2025-12-23 마이너 업데이트

ChangeLog

v3.907 / 2025-12-23

v3.906 / 2025-06-04

v3.905 / 2025-02-07

v3.904 / 2024-08-29

v3.903 / 2024-07-23

v3.902 / 2024-06-11

v3.901 / 2024-05-28

v3.9 / 2024-02-05

v3.8 / 2024-01-24

v3.7 / 2023-08-28

v3.63 / 2023-04-10

v3.62 / 2022-09-15

v3.61 / 2022-07-12

v3.6 / 2022-04-18

v3.59 / 2022-01-10

v3.58 / 2021-10-19

v3.57 / 2021-07-28

v3.56 / 2021-04-22

v3.55 / 2021-04-02

v3.54 / 2021-03-31

v3.53 / 2020-10-06

v3.52 / 2020-09-11

v3.51 / 2020-09-08

v3.5 / 2020-08-28

v3.42 / 2020-08-20

v3.41 / 2020-08-14

v3.4 / 2020-03-20

v3.3 / 2020-03-06

v3.28 / 2020-03-05

v3.27 / 2020-01-29

v3.26 / 2020-01-28

v3.25 / 2019-06-14

v3.24 / 2019-05-07

v3.22 / 2019-01-10

v3.21 / 2019-01-09

v3.2 / 2018-11-29

v3.11 / 2018-04-19

v3.1 / 2018-03-23

v3.04 / 2017-07-24

v3.03 / 2017-05-23

v3.02 / 2017-04-20

v3.01 / 2017-04-17

v3.00 / 2017-02-08

1. 소개

1-0. API CALL LIMIT

1-1-1. REQUEST 예제 (PHP)

<?php
$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_URL => "https://pravs.co.kr/shop/_OpenAPI/link.GetCategory.php",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => array(
        'LinkerID' => '링커ID',
        'UserID' => '사용자ID',
        'UserPW' => '비밀번호',
    )
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error #:" . $err;
}

echo "<xmp>";
print_r($response);
echo "</xmp>";
?>

1-1-2. 기본 메세지 구조

<?xml version="1.0" encoding="euc-kr" ?>
<Pravs>
<Header>
<SendLinker>API 연동업체 ID</SendLinker>
<SendID>공급사 ID</SendID>
<SendDate>요청날짜</SendDate>
</Header>
<Result>FAIL</Result>
-- 아래 표 참조 --
</Pravs>

사유 내용
공급사인증실패(공통) <Msg><![CDATA[로그인 실패]]></Msg>
카테고리 조회 실패 <Msg><![CDATA[카테고리 조회 실패]]></Msg>
브랜드 조회 실패 <Msg><![CDATA[브랜드 조회 실패]]></Msg>
상품등록 실패 <ItemGoodCode>셀러허브상품고유번호</ItemGoodCode>
<ItemNo>업체 상품고유번호</ItemNo>
<ItemPartnerCode>상품품번</ItemPartnerCode>
<Msg><![CDATA[상품등록 실패]]></Msg>
주문(취소)조회 실패 <StartDt>조회 시작일자</StartDt>
<EndDt>조회 종료일자</EndDt>
<Msg><![CDATA[주문(취소)조회 실패]]></Msg>
발주처리 실패 <OrderID>주문번호</OrderID>
<OrderItemID>주문상세번호</OrderItemID>
<Msg><![CDATA[발주처리 실패]]></Msg>
발송처리 실패 <OrderID>주문번호</OrderID>
<OrderItemID>주문상세번호</OrderItemID>
<Delv_Cd>택배사 코드</Delv_Cd>
<Invoice>송장번호</Invoice>
<Msg><![CDATA[발송처리 실패]]></Msg>

1-2. TargetURL

1-3. API 통신 서버 등록

1-4. API 연동 순서

  1. 서비스 신청, 연동 서버 IP 등록
  2. LinkerID 및 Test 계정 발급
  3. API 개발 및 검수
  4. 실사용 계정 등록
  5. 서비스 시작

1-5. 문의처

셀러허브 개발팀 dev@sellerhub.co.kr / 070-4632-1666

2. 상품관련 API

2-1-1. 카테고리 목록 조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 CategoryDepth 카테고리단계 1차, 2차, 3차, 4차
2 CategoryCd 카테고리코드
3 CategoryNm 카테고리명 사용

2-1-2. 전체 카테고리 목록 조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 CategoryDepth 카테고리단계 1차, 2차, 3차, 4차
2 CategoryCd 카테고리코드
3 CategoryNm 카테고리명 사용

2-2-1. 브랜드 조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
3 BrandName 브랜드명 Varchar(40) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 BrandID 브랜드코드
2 BrandName 브랜드명 사용

2-2-2. 브랜드 등록

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 BrandName 브랜드명 Varchar(40) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 BrandID 브랜드코드
2 BrandName 브랜드명 사용

2-2-3. 사용브랜드 조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 BrandID 브랜드코드
2 BrandName 브랜드명 사용

2-2-4. 사용브랜드 등록

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 BrandId 브랜드번호 int 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과

2-2-5. 사용브랜드 삭제

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 BrandId 브랜드번호 int 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과

2-3. 택배사 리스트

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 DeliveryID 택배사코드
2 DeliveryName 택배사명 사용
3 DeliveryValidLength 유효 송장 자리수

2-4. 전체 택배사 리스트

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 DeliveryID 택배사코드
2 DeliveryName 택배사명 사용
3 DeliveryValidLength 유효 송장 자리수

2-5. 상품등록/수정

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemNo 업체 상품 고유번호 Varchar(50) 등록시 필수. 쇼핑몰로 보내는 업체 상품고유번호
5 ItemPartnerCode 상품품번 Varchar(255) 판매자가 별도로 관리하는 상품품번
6 ItemCategory 카테고리 Varchar(200) 필수 4차 카테고리 코드(형식:001001001001)
7 ItemBrand 브랜드 Int(10) 필수 브랜드 코드 (2-2.브랜드조회에서 확인)
8 ItemName 상품명 Varchar(100) 필수 한글 : 50자 제한
9 ItemGoodCode 셀러허브 상품고유번호 Int(10) 최초 상품등록시 셀러허브에서 생성되어 리턴됨
10 Itemkeyword 검색어 Varchar(200) 콤마(,)로 구분
11 Launchdate (공통)제조년월일 Varchar(200) yyyymmdd 형식으로 입력, 제조년월인 경우 자동으로 앞의 6자리(yyyymm)까지 입력됨
12 ItemMaker (공통)제조사(제조자) Varchar(200) 제조사 및 수입처
13 ItemMadeIn (공통)원산지 Varchar(50)
14 ItemDesc 상품간단설명 Varchar(200)
15 ItemDescDetail 상품상세설명 Text 필수
16 ItemImage 상품이미지 text 필수 상품 업데이트시에 공란인 경우 이미지 변경하지 않음. 상품 대표 이미지URL 가로 500px 이상
(http를 포함한 전체 URL을 전송)
상품이미지 2개 이상 등록 시 세로구분자 "|" 사용
(ex : http://pravs.co.kr/img/1.jpg
17 ItemCount 상품수량(재고) Int(10)
18 TaxYn 과세여부 Char(3) 필수 001:과세,002:비과세
19 BuyPrice 공급가 Int(10) 필수
20 MarginRate 마진율 Decimal(9,2) 필수 소수점 2자리까지
21 SalePrice 판매가 Int(10) 필수 셀러허브 계정 타입이 "벤더(공급가)"인 경우 입력 및 노출 되지 않습니다.
22 ConsumerPrice 소비자가 Int(10)
23 DeliveryCharge 배송비 구분 Char(3) 필수 코드 1. 배송비 유형 코드
24 Delfee 배송비 Int(10)
25 Unittype 옵션출력방식 Enum(single,double)
26 UnitInfo 옵션정보 Text 옵션명(색상/사이즈) 필수, 그 외 [부록 1. 상품옵션 전송 방법] 참조
27 OptPrice 옵션가사용 int(10) 값이 "1"일 경우 옵션가 사용, 아닐시 빈값
28 SaleStatus 판매상태 Enum(001,002,003,004) 필수 SaleStatus가 004로 입력될 경우 옵션재고는 무조건 0으로 입력됩니다. 5-9상품 판매 상태 코드표 참고
29 StockYn 재고 차감 사용여부 Enum(001,002) 필수 001:재고량차감,002:차감안함
30 ItemMode 등록/수정 Enum(I,M) 필수 I : 등록, M : 수정
31 ItemGoodsRequired 필수입력그룹코드 Char(2) 필수 Code 5-2 "상품정보 필수입력 그룹", 부록 6-2. "상품정보고시 관련 필수 입력 항목" 참조.
(공통) 및 (고시)라고 표기된 5,12~14, 35~53번 항목 중, 각 정보고시그룹별 필수입력 항목 확인.
32 ItemMatiere (고시)제품소재 Varchar(200)
33 ItemColors (고시)색상 Varchar(200)
34 ItemSizes (고시)치수 또는 크기 Varchar(200)
35 ItemKinds (고시)종류 Varchar(200)
36 ItemCaution (고시)취급 시 주의사항 Text 사용시 주의 사항
37 ItemVolume (고시)용량 또는 중량 Varchar(200)
38 ItemServiceLife (고시)사용기한, 유통기한 등 Varchar(200) 유통기한은 yyyymmdd 형식으로 입력
39 ItemUsages (고시)사용방법 Text
40 ItemSpec1 (고시)제품주요사양 Text
41 ItemSpec2 (고시)제품세부사양 Text
42 ItemUseAge (고시)사용연령 Varchar(200)
43 ItemWeight (고시)크기, 체중의 한계 Varchar(200)
44 ItemEqualModelLaunchdt (고시)동일모델의 출시 년월 Varchar(200)
45 ItemIngredient (고시)주요성분 Varchar(200)
46 ItemWarranty (고시)품질인증여부 Enum(Y,N) 보증서존재 여부 등
47 ItemWarranty_number (고시)보증서 인증번호 Varchar(50)
48 ItemWarrantyGov (고시)인증기관 Varchar(200) KC인증필 인증기관
49 ItemQualityAssurance (고시)품질보증기준 Varchar(200)
50 ItemAsTel (고시)AS 전화번호 Varchar(50) 필수
51 ItemAsName (고시)AS 책임자 Varchar(50) 필수
52 ItemNoRefund Varchar(200) 제품 하자가 아닌 소비자의 단순 변심, 착오 구매에
따른 청약 철회가 불가능한 경우 그 구체적 사유와 근거
53 ItemReturnQualityAssurance Varchar(200) 재화 등의 교환/반품/보증 조건 및 품질 보증 기준
54 ItemCompensation Varchar(200) 대금을 환불받기 위한 방법과 환불이 지연될 경우
지연에 따른 배상금을 지급받을 수 있다는 사실 및
배상금 지급의 구체적 조건 및 절차
55 ItemTroubleShooting Varchar(200) 소비자 피해 보상의 처리, 재화 등에 대한 불만 처리
및 소비자와 사업자 사이의 분쟁처리에 관한 사항
56 TimeSaleUse 타임세일 사용여부 Enum(0,1) 0:사용안함, 1:사용
57 TimeSaleValidSdate 타임세일 시작일시 Datetime 0000-00-00 00:00:00 (타임세일 사용시 필수)
58 TimeSaleValidEdate 타임세일 종료일시 Datetime 0000-00-00 00:00:00 (타임세일 사용시 필수)
59 TimeSaleDC 타임세일할인금액(쿠폰적용가) Int(10) 타임세일가 또는 쿠폰할인액이 적용된 금액
(타임세일 기능 사용시 필수)
60 TimeSaleViewType 타이머 노출여부 enum(0,1) 0:노출안함, 1:노출
61 TimeSaleSubjectTag 타임세일 말머리 Text 상품명 앞에 노출될 말머리
62 ItemCertification KC인증정보 유형 Varchar(200) 부록 3. KC인증유형표 참조 (텍스트로 전송)
63 ItemCertificationInfo KC인증 상세(인증번호등) Varchar(200) KC인증유형에 따라 입력여부 달라짐
64 OptIf 옵션API사용유무 Varchar(1) 옵션등록 API(2-11)를 따로 사용할경우 반드시 "Y"로 설정. "Y"로 설정한 경우 UnitInfo 및 기본옵션 삽입안됨.
65 ItemApproveAuto 승인요청 여부 Varchar(1) 따로 상품 승인 요청을 하실경우 반드시 "Y"로 설정 (미설정시 상품등록과 동시에 상품승인요청이 됩니다.).
66 Exhibition 전시용상품 여부 Enum(Y,N) 전시용상품인 경우 "Y"로 설정, 특정업체만 사용
67 MaxEa 최대구매가능수량 Int 기본값 0, 0인경우 제한없음
68 MinEa 최소구매가능수량 Int 기본값 1
69 DelivPricePolicyId AK배송정책ID Int 24번 배송비구분이 006인경우 필수입력
70 ShipDelivAddrId AK출회수지ID(출고지) Int 24번 배송비구분이 006인경우 필수입력
71 ReturnDelivAddrId AK출회수지ID(회수지) Int 24번 배송비구분이 006인경우 필수입력

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과 SUCC or FAIL
2 ItemPartnerCode 상품품번
3 ItemGoodCode 셀러허브상품고유번호
4 ItemNo 업체 상품고유번호
5 Msg 결과메시지 사용
6 Msgutf 결과메시지-utf8 사용

2-6-1. 상품 승인 상태 조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemGoodCode 셀러허브상품고유번호 Int(10) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 ItemGoodCode 셀러허브상품고유번호
2 ItemConfirm 승인상태 사용 승인상태 코드
3 approveDescription 승인보류및반려사유 사용
4 approveDescription2 승인보류및반려사유2 사용
5 DeleteStatus 상품삭제여부 사용 삭제된 상품인경우 "Y"
6 Msg 결과 사용 승인대기(0)/승인요청(1)/승인완료(2)/승인보류(3)/승인반려(-1)

2-6-2. 상품 정보 조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemGoodCode 셀러허브상품고유번호 Int(10) ItemGoodCode / ItemNo 둘중 하나 반드시 입력
5 ItemNo 업체 상품고유번호 Int(10)

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 ItemGoodCode 셀러허브상품고유번호
2 ItemName 상품명
3 ItemNo 업체 상품고유번호
4 RegDate 상품등록일
5 ItemPartnerCode 상품품번
6 ItemCategory 카테고리
7 ItemBrand 브랜드
8 Itemkeyword 검색어
9 ItemMaker 제조사(제조자)
10 ItemMadeIn 원산지
11 ItemDesc 상품간단설명
12 ItemDescDetail 상품상세설명
13 ItemImage 상품이미지
14 ItemCount 상품수량(재고)
15 TaxYn 과세여부
16 BuyPrice 공급가
17 MarginRate 마진율
18 SalePrice 판매가 셀러허브 계정 타입이 "벤더(공급가)"인 경우 입력 및 노출 되지 않습니다.
19 ConsumerPrice 소비자가
20 DeliveryCharge 배송비 구분
21 Delfee 배송비
22 Unittype 옵션출력방식
23 UnitInfo 옵션정보
24 SaleStatus 판매상태 5-9. 상품 판매 상태 코드표 참고
25 StockYn 재고 차감 사용여부
26 ItemGoodsRequired 필수입력그룹코드
27 ItemMatiere 제품소재
28 ItemColors 색상
29 ItemSizes 치수 또는 크기
30 ItemKinds 종류
31 ItemVolume 용량 또는 중량
32 ItemSpec1 제품주요사양
33 ItemSpec2 제품세부사양
34 ItemUseAge 사용연령
35 ItemWeight 크기, 체중의 한계
36 ItemEqualModelLaunchdt 동일모델의 출시 년월
37 ItemServiceLife 사용기한
38 Launchdate 제조년월
39 ItemUsages 사용방법
40 ItemIngredient 주요성분
41 ItemWarranty 품질인증여부
42 ItemWarranty_number 보증서 인증번호
43 ItemWarrantyGov 인증기관
44 ItemCaution 취급 시 주의사항
45 ItemQualityAssurance 품질보증기준
46 ItemNoRefund 제품 하자가 아닌 소비자의 단순 변심, 착오 구매에
따른 청약 철회가 불가능한 경우 그 구체적 사유와 근거
47 ItemReturnQualityAss 재화 등의 교환/반품/보증 조건 및 품질 보증 기준
48 ItemCompensation 대금을 환불받기 위한 방법과 환불이 지연될 경우
지연에 따른 배상금을 지급받을 수 있다는 사실 및
배상금 지급의 구체적 조건 및 절차
49 ItemTroubleShooting 소비자 피해 보상의 처리, 재화 등에 대한 불만 처리
및 소비자와 사업자 사이의 분쟁처리에 관한 사항
50 ItemAsName AS 책임자
51 ItemAsTel AS 전화번호
52 ItemCertification KC인증정보 유형
53 ItemCertificationInfo KC인증 상세(인증번호등)
54 ItemGoodscd 품목 및 제품명
55 ItemSpecialFood 사전심의필
56 ItemOrigin 제조국
57 ItemImporter 수입자
58 DeleteStatus 상품삭제여부 삭제된 상품인경우 "Y"

2-7. 상품 등록 고유번호 조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemGoodCode 셀러허브상품고유번호 Int(10) ItemGoodCode, ItemNo 중 한가지 이상 반드시 입력
5 ItemNo 업체 상품고유번호 Int(10)

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 ItemGoodCode 셀러허브상품고유번호
2 ItemNo 업체 상품고유번호
3 ItemConfirm 상품 승인여부 사용 승인완료/승인요청/상품대기

2-8. 전상품 고유번호 조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 StartDt 검색 시작일자 Date 결제일 기준. YYYY-MM-DD
5 EndDt 검색 종료일자 Date 결제일 기준. YYYY-MM-DD
6 Limit 검색 제한수량 Int(10) 예시1) Offset 0, Limit 1000 : 0번째부터 1000개 조회
7 Offset 검색 시작순번 Int(10) 예시2) Offset 1000, Limit 1000 : 1000번째부터 1000개 조회

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 ItemGoodCode 셀러허브상품고유번호
1 ItemName 상품명 사용
2 ItemNo 업체 상품고유번호
3 RegDate 등록일

2-9. 옵션조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemOptionCode 옵션코드 Int(10) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 ItemGoodCode 셀러허브상품고유번호
2 ItemOptionCode 옵션고유번호
3 OptName1 옵션1 사용
4 OptName2 옵션2 사용
5 ItemOptionPrice 판매가
6 ItemOptionConsumer 정가
7 ItemOptionSupply 공급가
8 ItemOptionStock 재고

2-10. 상품옵션조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemGoodCode 셀러허브상품고유번호 Int(10) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 ItemOptionCode 옵션고유번호
2 OptName1 옵션1 사용
3 OptName2 옵션2 사용
4 ItemOptionPrice 판매가
5 ItemOptionConsumer 정가
6 ItemOptionSupply 공급가
7 ItemOptionStock 재고

2-11. 옵션등록/수정

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemGoodCode 셀러허브상품고유번호 Int(10) 필수
5 ItemOptionCode 옵션고유번호 Int(10) 수정시에만 입력.
6 SalePrice 판매가 Int(10) 필수 셀러허브 계정 타입이 "벤더(공급가)"인 경우 입력 및 노출 되지 않습니다.
7 ConsumerPrice 소비자가 Int(10) 필수
8 BuyPrice 공급가 Int(10) 필수
9 OptName1 옵션1 Varchar(20) 필수
10 OptName2 옵션2 Varchar(20)
11 Stock 수량 Int(10) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과 SUCC or FAIL
2 ItemGoodCode 상품고유번호
3 ItemOptionCode 옵션고유번호
4 Msg 결과메시지 사용

2-12. 옵션재고수정

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemGoodCode 셀러허브상품고유번호 Int(10) 필수
5 ItemOptionCode 옵션고유번호 Int(10) 필수
6 Stock 수량 Int(10) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과 SUCC or FAIL
2 ItemGoodCode 상품고유번호
3 ItemOptionCode 옵션고유번호

2-13. 옵션삭제

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemOptionCode 옵션고유번호 Int(10) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 옵션고유번호 SUCC or FAIL
2 ItemOptionCode 옵션고유번호
3 Msg 결과메세지 사용

2-14. 상품 승인 요청

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemGoodCode 상품고유번호 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 성공여부 SUCC or FAIL
2 ItemGoodCode 상품고유번호
3 Msg 결과메세지 사용

2-15. 상품 승인 대기/요청/반려 상품 삭제

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemGoodCode 상품고유번호 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 성공여부 SUCC or FAIL
2 ItemGoodCode 상품고유번호
3 Msg 결과메세지 사용

2-16. 상품판매상태변경

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 ItemGoodCode 상품고유번호 필수
5 SaleStatus 판매상태 Enum(001,002,003,004) 필수 5-9. 상품 판매 상태 코드표 참고
6 Soldout 재고품절여부 Enum(Y,N) Y로 설정시 모든 재고 0으로 설정, 추후 재고원복 불가능

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 성공여부 SUCC or FAIL
2 ItemGoodCode 상품고유번호
3 SaleStatus 판매상태

2-17. 셀러플랜 조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 CompanyName 업체명 사용
2 SellerPlan 셀러플랜 사용 레이틀리 T, 레이틀리, V.I.P, 커스텀, 플러스, 베이직, 스타트, 벤더(공급가), 벤더(수수료), 백화점아울렛, 본사

2-18-1. 출회수지 조회(AK전용)

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Id 출회수지ID
2 AddrId 출회수지파트너ID
3 AddrDivCode 출회수지구분 30:출고지, 40:회수지
4 Zipcode 우편번호
5 BaseAddr 기본주소
6 DtlAddr 상세주소
7 RoadAddrZipcode 도로명주소 우편번호
8 RoadBaseAddr 도로명기본주소
9 RoadDtlAddr 도로명상세주소
10 BuildingCode 도로명주소 건물관리번호
11 CustTel 전화번호
12 CusthandTel 휴대폰번호
13 DeliveryCode 택배사코드 셀러허브 택배사코드
14 ContractNumber 계약번호
15 CustomerNumber 고객사용번호

2-18-2. 출회수지 등록/수정(AK전용)

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 Id 출회수지ID Int 미입력시 신규등록
5 AddrId 출회수지파트너ID Int 필수 기존에 입력된 AddrPartnerId가 있다면 수정모드로 작동
6 AddrDivCode 출회수지구분 Varchar(10) 필수 30:출고지, 40:회수지
7 Zipcode 우편번호 Varchar(7)
8 BaseAddr 기본주소 Varchar(255)
9 DtlAddr 상세주소 Varchar(255)
10 RoadAddrZipcode 도로명주소 우편번호 Varchar(7) 필수
11 RoadBaseAddr 도로명기본주소 Varchar(255) 필수
12 RoadDtlAddr 도로명상세주소 Varchar(255) 필수
13 BuildingCode 도로명주소 건물관리번호 Varchar(30) 필수
14 CustTel 전화번호 Varchar(30) 필수
15 CusthandTel 휴대폰번호 Varchar(30) 필수
16 DeliveryCode 택배사코드 Int 셀러허브 택배사코드
17 ContractNumber 계약번호 Varchar(50)
18 CustomerNumber 고객사용번호 Varchar(20)

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과 SUCC or FAIL
2 Id 출회수지ID
3 AddrId 출회수지파트너ID
4 Msg 결과메시지 사용

2-19-1. 배송정책 조회(AK전용)

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Id 배송정책ID
2 DelivPricePolicyId 배송정책파트너ID
3 DelivPriceImposeBaseCode 배송비부과기준코드
4 PriceType 배송비 지급 타입(기본값:선불) PREPAIED, CASH
5 DelivPrice 배송비 금액
6 DelivPriceFreeLowAmt 무료 배송 하한 금액
7 ReturnFee 반품 배송비
8 ExchangeFee 교환 배송비
9 DeliveryDays 출고 소요일
10 JejuFee 제주 추가 배송비
11 IslandFee 도서산간 추가 배송비
12 BundleFlag 개별배송 및 묶음배송 여부

2-19-2. 배송정책 등록/수정(AK전용)

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 Id 배송정책ID Int 미입력시 신규등록
5 DelivPricePolicyId 배송정책파트너ID Int 필수
6 DelivPriceImposeBaseCode 배송비부과기준코드 Varchar(10) 필수
7 PriceType 배송비 지급 타입(기본값:선불) Enum PREPAIED(선불), CASH(착불)
8 DelivPrice 배송비 금액 Int 필수
9 DelivPriceFreeLowAmt 무료 배송 하한 금액 Int
10 ReturnFee 반품 배송비 Int
11 ExchangeFee 교환 배송비 Int
12 DeliveryDays 출고 소요일 Int 필수
13 JejuFee 제주 추가 배송비 Int
14 IslandFee 도서산간 추가 배송비 Int
15 BundleFlag 개별배송 및 묶음배송 여부 Varchar(2)

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과 SUCC or FAIL
2 Id 배송정책ID
3 DelivPricePolicyId 출회수지파트너ID
4 Msg 결과메시지 사용

3. 주문관련 API

3-1. 주문리스트

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 StartDt 검색 시작일자 Date(+HH) 결제일 기준. YYYY-MM-DD (시간추가가능 YYYY-MM-DD-HH), 미입력시 현재 년월일 입력.
5 EndDt 검색 종료일자 Date(+HH) 결제일 기준. YYYY-MM-DD (시간추가가능 YYYY-MM-DD-HH), 미입력시 현재 년월일 입력.
6 OrderID 주문번호 bigint(20) 입력시 기간/상태 조건 무시됨. OrderID 및 OrderItemID 입력시 둘 중 하나만 입력.
7 OrderItemID 주문상세번호 int(10) 입력시 기간/상태 조건 무시됨. OrderID 및 OrderItemID 입력시 둘 중 하나만 입력.
8 vmode 주문상태구분 Varchar(10) null:입금확인 / all:입금대기,입금확인 / pre:배송준비중 / transit : 배송중 / delivered : 배송완료 / complete : 구매확정 / every : 전체주문
9 isCancel 취소주문여부 int(10) 1인경우 취소상태의 주문만 조회 / (vmode : every 설정시 해당값 무시됨)
10 isExchange 교환주문여부 int(10) 1인경우 교환상태의 주문만 조회 / (vmode : every 설정시 해당값 무시됨)
11 DateType 검색 기간 타입 varchar uptdt 입력시 주문데이터 업데이트 기준으로 검색, 기본값:주문일

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 OrderID 주문번호
2 OrderItemID 주문상세번호 (고유번호)
3 OrderDat 주문일자 사용 구버전 API용
4 OrderDate 주문일자 사용
5 PayDate 결제일 사용
6 OrderStep1 주문 상태 코드 3. 주문 상태 코드
7 OrderStep2 주문 취소 상태 코드 4. 취소 상태 코드
8 OrderExchange 교환상태 코드 5. 교환 상태 코드
9 OrderStatus 주문 상태 명 사용
10 MallProductID 셀러허브상품고유번호
11 PtnProductID 연동업체 상품고유번호
12 ItemPartnerCode 상품품번
13 PrdNM 상품명 사용
14 OptNo 옵션번호
15 OptNM 옵션정보 사용 OptNm1 + OptNm2 + AddOpt(옵션없는 상품인 경우 빈값)
16 OptNm1 옵션명1 사용 옵션명 분리 가능한경우 제공
17 OptNm2 옵션명2 사용 옵션명 분리 가능한경우 제공
18 AddOpt 추가옵션정보 사용 추가옵션이 있는경우 제공
19 Qty 주문수량
20 CancelQty 취소된수량 부분 수량취소된 주문은 OrderClaim에서 별도 수집가능
21 SalePrice 판매가
22 BuyPirce 공급가
23 PayPrice 결제가 실제결제금액
판매단가 * 수량 – 할인
(쿠폰할인+타임세일할인액+멤버할인)
24 DcPrice 할인가 쿠폰+멤버할인
25 TimeSaleDc 타임세일할인액 타임세일할인액이 있는경우 제공
26 DeliveryPackgeNum 묶음배송코드
27 DeliveryType 배송정보 사용
28 DeliveryPrice 배송비
29 DeliveryNum 택배사[송장번호] 사용
30 DeliveryCompanyNo 택배사번호
31 DeliveryCompanyName 택배사명 사용
32 InvoiceNumber 송장번호
33 BuyerName 주문자 사용
34 BuyerTel 주문자 전화번호 사용
35 BuyerHp 주문자 휴대전화 사용
36 BuyerMail 주문자 이메일
37 RcvName 수취인 사용
38 RcvTel 수취인 전화번호
39 RcvHp 수취인 휴대전화
40 RcvZip 수취인 우편번호
41 RcvAddr 배송지 주소 사용
42 RcvAddr1 배송지 기본주소 사용
43 RcvAddr2 배송지 상세주소 사용
44 Memo 배송 메세지 사용
45 CompanyName 업체명 사용
46 SettleKind 결제수단 사용
47 Maker 제조사 사용
48 Origin 제조국 사용
49 BrandName 브랜드명 사용
50 Coupon 쿠폰금액 사용
51 AddDelivery 추가배송비 사용
52 BundleDeliCnt (특수)합배송 매장수 사용 (특수업체용)동일지점 합배송 매장 갯수
53 RDelivery 배송예정일 사용
54 ErpFee 정산수수료 사용
55 SaleType 정산주체 사용 sellerhub, commercehub
56 ShopDiscountPrice 판매가에누리
57 ReDeliveryCompanyNo 재배송 택배사번호
58 ReDeliveryCompanyName 재배송 택배사명 사용
59 ReInvoiceNumber 재배송 송장번호

3-2. 구매확정 주문리스트

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 StartDt 검색 시작일자 Date(+HH) 구매확정일 기준. YYYY-MM-DD (시간추가가능 YYYY-MM-DD-HH), 미입력시 현재 년월일 입력.
5 EndDt 검색 종료일자 Date(+HH) 구매확정일 기준. YYYY-MM-DD (시간추가가능 YYYY-MM-DD-HH), 미입력시 현재 년월일 입력.

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 OrderID 주문번호
2 OrderItemID 주문상세번호 (고유번호)
3 OrderDate 주문일자 사용
4 PayDate 결제일 사용
5 BuyConfirmDate 구매확정일 사용
6 OrderStatus 주문 상태 사용
7 MallProductID 셀러허브상품고유번호
8 PrdNM 상품명 사용
9 OptNM 주문옵션정보 사용
10 Qty 주문수량
11 SalePrice 판매가
12 BuyPirce 공급가
13 PayPrice 결제가 실제결제금액
판매단가 * 수량 – 할인
(쿠폰할인+타임세일할인액+멤버할인)
14 DeliveryPackgeNum 묶음배송코드
15 DeliveryType 배송정보 사용
16 DeliveryPrice 배송비
17 DeliveryNum 택배사[송장번호] 사용
18 DeliveryCompanyNo 택배사번호
19 DeliveryCompanyName 택배사명 사용
20 InvoiceNumber 송장번호
21 BuyerName 주문자 사용
22 BuyerTel 주문자 전화번호 사용
23 BuyerHp 주문자 휴대전화 사용
24 BuyerMail 주문자 이메일
25 RcvName 수취인 사용
26 RcvTel 수취인 전화번호
27 RcvHp 수취인 휴대전화
28 RcvZip 수취인 우편번호
29 RcvAddr 배송지 주소 사용
30 RcvAddr1 배송지 기본주소 사용
31 RcvAddr2 배송지 상세주소 사용
32 Memo 배송 메세지 사용
33 BrandID 브랜드코드
34 BrandName 브랜드명 사용
35 SubAdminId 브랜드아이디 사용
36 ShopDiscountPrice 판매가에누리

3-3-1. 발주처리

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 OrderID 주문번호 BigInt(20) 필수
5 OrderItemID 주문상세번호 Int(10) 필수
6 DeliveryDate 배송예정일 Date (YYYY-MM-DD) NULL인경우 공급사에 설정된 배송예정일을 가져오거나 +2영업일이 기본 입력됨

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Return 결과 SUCC or FAIL
2 OrderID 주문번호
3 OrderItemID 주문상세번호
4 ReturnCD 결과값
5 Msg 결과메시지 사용

3-3-2. 배송예정일 입력/수정

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 OrderID 주문번호 BigInt(20) 필수
5 OrderItemID 주문상세번호 Int(10) 필수
6 DeliveryDate 배송예정일 Date 필수 YYYY-MM-DD

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과 SUCC or FAIL
2 OrderID 주문번호
3 OrderItemID 주문상세번호
4 ReturnCD 결과값
5 Msg 결과메시지 사용

3-4. 배송지연처리

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 OrderID 주문번호 BigInt(20) 필수
5 OrderItemID 주문상세번호 Int(10) 필수
6 DelayCd 발송지연사유 Char(2) 필수 코드 6. 발송지연사유 코드
7 DelayDt 발송기한 Date 필수
8 DelayDetail 발송지연상세사유 Varchar(200)

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과 SUCC or FAIL
2 OrderID 주문번호
3 OrderItemID 주문상세번호
4 ReturnCD 결과값
5 Msg 결과메시지 사용

3-5. 발송처리

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 OrderID 주문번호 BigInt(20) 필수
5 OrderItemID 주문상세번호 Int(10) 필수
6 Delv_Cd 택배사 코드 Char(2) 필수 2-3. 택배사 리스트 참고
7 Invoice 송장번호 Int(10) 필수 "-"제외, 숫자만 입력
8 Delv_date 발송일 Date

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과 SUCC or FAIL
2 OrderID 주문번호
3 OrderItemID 주문상세번호
4 Msg 결과메시지 사용

3-6. 배송완료처리(AK전용)

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 OrderID 주문번호 BigInt(20) 필수
5 OrderItemID 주문상세번호 Int(10) 필수

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과 SUCC or FAIL
2 OrderID 주문번호
3 OrderItemID 주문상세번호
4 Msg 결과메시지 사용

3-7. 주문취소/반품/교환리스트

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 StartDt 검색 시작일자 Date(+HH) 취소일 기준. YYYY-MM-DD (시간추가가능 YYYY-MM-DD-HH), 미입력시 현재 년월일 입력.
5 EndDt 검색 종료일자 Date(+HH) 취소일 기준. YYYY-MM-DD (시간추가가능 YYYY-MM-DD-HH), 미입력시 현재 년월일 입력.
6 OrderType 취소타입 Enum cancel : 취소, return : 반품, exchange : 교환, null : 전체
7 DateType 검색 기간 타입 varchar uptdt 입력시 주문데이터 업데이트 기준으로 검색, 기본값:취소접수일
8 CsProcess 클레임상세처리여부 Enum (Y,N) Y 입력시 1차CS처리된 주문만 조회, 기본값:N

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 OrderID 주문번호
2 OrderItemID 주문상세번호 (고유번호)
3 CancelNo 취소번호
4 OrderStep1 주문 상태 코드 3. 주문 상태 코드
5 OrderStep2 주문 취소 상태 코드 4. 취소 상태 코드
6 OrderExchange 교환상태 코드 5. 교환 상태 코드
7 OrderStatus 주문 상태 명 사용
8 OrderDate 주문일자 사용
9 OrderCancelDate 취소/반품/교환신청일자 사용
10 OrderRefundDate 취소/반품/교환완료일자 사용
11 MallProductID 셀러허브상품고유번호
12 PtnProductID 연동업체 상품고유번호
13 PrdNM 상품명 사용
14 OptNo 옵션번호 사용
15 OptNM 옵션정보 사용
16 Qty 주문수량
17 SalePrice 판매가
18 BuyerName 주문자 사용
19 Memo 취소/반품/교환사유 사용
20 ClaimCode 클레임코드 사용 코드 7. 클레임 코드 참조
21 OrderOldID 원주문상세번호 사용 부분취소시 원주문상세번호(OrderItemID)
22 OriOpt 원주문옵션 사용 교환건일경우 사용
23 CsProcess 클레임 상세내역 사용 처리:등록완료 / 미처리:등록대기 / 불필요:처리불필요
24 RegoodsReason 귀책사유 사용
25 RegoodsMethod 회수방법 사용
26 RegoodsPayment 추가배송비 지불방식 사용
27 CalcDelivery 반품/교환배송비
28 AddressSet 배송지 정보(SET) 이하 있을경우 출력
29 AddressSetId 배송지ID
30 UpdateType 배송지타입 사용 최초배송지/회수지/재배송지
31 Name 이름 사용
32 Phone1 연락처1
33 Phone2 연락처2
34 Zipcode 우편코드
35 Address 주소 사용
36 Memo 메모 사용
37 AddressSetDate 배송지생성일자

3-8. 구매확정 취소(반품)리스트

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 StartDt 검색 시작일자 Date(+HH) 취소처리일 기준. YYYY-MM-DD (시간추가가능 YYYY-MM-DD-HH), 미입력시 현재 년월일 입력.
5 EndDt 검색 종료일자 Date(+HH) 취소처리일 기준. YYYY-MM-DD (시간추가가능 YYYY-MM-DD-HH), 미입력시 현재 년월일 입력.

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 OrderID 주문번호
2 OrderItemID 주문상세번호 (고유번호)
3 CancelNo 취소번호
4 OrderStatus 주문 상태 명 사용
5 OrderDate 주문일자 사용
6 OrderCancelDate 취소/반품/교환신청일자 사용
7 OrderRefundDate 취소/반품/교환완료일자 사용
8 MallProductID 셀러허브상품고유번호
9 PrdNM 상품명 사용
10 OptNM 주문옵션정보 사용
11 BuyerName 주문자 사용
12 Qty 주문수량
13 SalePrice 판매가
14 BuyPirce 공급사
15 PayPrice 결제가 실제결제금액
판매단가 * 수량 – 할인
(쿠폰할인+타임세일할인액+멤버할인)
16 Memo 취소/반품/교환사유 사용
17 ShopDiscountPrice 판매가에누리

3-9. 판매거부(배송전 주문취소 요청)

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 OrderID 주문번호 BigInt(20) 필수
5 OrderItemID 주문상세번호 Int(10) 필수 (고유번호)
6 RejectCd 판매거부코드 Char(3) 필수 코드 7. 판매거부사유 코드
7 RejectMsg 상세사유 Varchar(200)

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Return 결과 SUCC or FAIL
2 OrderID 주문번호
3 OrderItemID 주문상세번호
4 ReturnCD 결과값
5 Msg 결과메시지 사용

3-10. 반품/교환 수거완료 처리

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 OrderID 주문번호 BigInt(20) 필수
5 OrderItemID 주문상세번호 Int(10) 필수 (고유번호)
6 regCode 반품/교환 코드값 Varchar(10) 필수 regoods:반품완료, exchange:교환수거완료
7 reDeliFee 배송비처리여부 Enum('Y','N','P') 반품완료 처리시 Y:동봉, N:착불, P:선불
8 reDeliVal 택배비 int(11) 반품완료 처리시
9 delivery 운송장 번호 Varchar(100) 반품완료 처리시
10 delivery_code 택배사코드 Varchar(20) 반품완료 처리시

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Return 결과 SUCC or FAIL
2 OrderID 주문번호
3 OrderItemID 주문상세번호
4 ReturnCD 결과값
5 Msg 결과메시지 사용

3-11. 주문서 정산 확정 리스트 조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 Type 기간 타입 Enum('month', 'day') 필수 기본값 "day"
day: 일자별, month: 월별
4 StartDt 일자별 시작일 Varchar(8) 기본값 현재 월 기준 1일
4 EndDt 일자별 종료일 Varchar(8) 기본값 현재 월 기준 말일
7 Year 월별 년도 Varchar(4) 기본값 현재 년도
예: 2022
8 Month 월별 월 Varchar(2) 기본값 현재 월
예: 04

Response Data (XML)

순번 필드명 필드설명 CDATA 비고
1 No 번호
2 Seller 판매처
3 RequestDate 정산 요청일
4 SaleOrderQty 판매 주문 수량
5 TotalSalePrice 총 판매금액
6 TotalFee 총 수수료
7 RefundPrice 환불 수수료
8 RefundFee 환불 수수료
9 TotalCalculatePrice 총 정산대상 금액
10 RefundCalculatePrice 환불 주문 금액
11 DeliveryCalculatePrice 배송비 정산 금액
12 DeductionQty 공제 수량
13 DeductionPrice 공제 금액
14 DcPrice 셀러허브 부담 쿠폰 비용
15 SettlePrice 총 지급예정 금액
16 DoneDate 정산 확정일
17 SettleDate 정산대금 지급일
18 TaxStatus 세금계산서 발급 상태
19 ShopDiscountPrice 판매가에누리

3-12. 정산조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 StartDt 조회 시작일 Varchar(8) YYYY-MM-DD
5 EndDt 조회 종료일 Varchar(8) YYYY-MM-DD

Response Data (XML)

순번 필드명 필드설명 CDATA 비고
1 CalculateNo 정산번호
2 GoodsPrice 판매상품금액
3 RefundPrice 반품상품금액
4 PayEa 판매상품수량
5 RefundEa 반품상품수량
6 CalculatePrice 정산금
7 DepositAmount 입금액
8 DeductionAmount 공제금액
9 RefundCalculatePrice 공제정산금액
10 Commission 정산수수료
11 RefundCommission 공제정산수수료
12 DepositDate 입금일
13 DoneDt 정산확정일
14 SaleType 거래처수수료

3-13. 정산아이템조회

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 CalculateNo 정산번호 Varchar(8)

Response Data (XML)

순번 필드명 필드설명 CDATA 비고
1 CalculateItemNo 정산번호
2 CalculateType 정산타입 normal(판매정산), refund(반품정산)
3 OrderID 주문번호
4 OrderItemID 주문상세번호
5 BrandID 브랜드번호
6 BrandName 브랜드이름
7 BrandNameKor 브랜드이름보조
8 ItemPrice 상품금액
9 Ea 수량
10 CalculatePrice 정산금액
11 Commission 수수료

4. 문의관련 API

4-1. CS 문의

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 StartDt 검색 시작일자 Date 필수 문의접수일 기준. YYYY-MM-DD
5 EndDt 검색 종료일자 Date 필수 문의접수일 기준. YYYY-MM-DD

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 CsInquiryID 상품문의 번호
2 OrderID SELLERHUB 주문번호
3 ItemGoodCode SELLERHUB 상품번호
4 ItemName SELLERHUB 상품명 사용
5 BrandName 브랜드명 사용
6 CsInquiryType 문의유형(긴급/고객/알림) 사용
7 CsInquiryTitle 문의제목 사용
8 CsInquiryContent 문의내용 사용
9 CsInquiryAContent 답변내용 사용
10 CsInquiryName 문의자명 사용
11 CsInquiryAName 답변자명 사용
12 CsInquiryStatus 상태(미답변/답변완료/전송완료/전송오류) 사용
13 CsInquiryDate 문의일
14 CsInquiryADate 답변일

4-2. CS 문의 답변

Request Data (POST)

순번 필드명 필드설명 타입 필수 비고
1 LinkerID Link 연동 ID Varchar(15) 필수
2 UserID 공급사 아이디 Varchar(20) 필수
3 UserPW 공급사 비밀번호 Varchar(20) 필수
4 CsInquiryID 문의글 번호 Int(11) 필수
5 CsInquiryAContent 답변내용 text 필수
6 CsInquiryAName 답변자명 Varchar(50)

Response Data(XML)

순번 필드명 필드설명 CDATA 비고
1 Result 결과 SUCC or FAIL
2 CsInquiryID 문의글 번호
3 Msg 결과메시지 사용

5. Code

5-1. 배송비 유형 코드

코드 설명 비고
001 무료
002 착불 상품필드 Delfee 필수입력
003 기본배송정책
004 고정배송비 상품필드 Delfee 필수입력
005 수량별배송비 상품필드 Delfee 필수입력
006 배송템플릿

5-2. 상품정보 필수입력 그룹

코드 설명 비고
g0 의류 부록 6-2. 의류 필수항목 참고
g1 구두,신발 부록 6-2. 구두,신발 필수항목 참고
g2 가방 부록 6-2. 가방 필수항목 참고
g3 패션잡화 부록 6-2. 패션잡화 필수항목 참고
g4 화장품 부록 6-2. 화장품 필수항목 참고
g5 귀금속/보석/시계류 부록 6-2. 귀금속/보석/시계류 필수항목 참고
g6 영유아용품 부록 6-2. 영유아용품 필수항목 참고
g7 스포츠용품 부록 6-2. 스포츠용품 필수항목 참고
g8 가공식품 부록 6-2. 가공식품 필수항목 참고
g9 침구류 부록 6-2. 침구류 필수항목 참고
g10 가전 부록 6-2. 가전 필수항목 참고
g11 주방용품 부록 6-2. 주방용품 필수항목 참고
g12 수납/청소/생활잡화 부록 6-2. 수납/청소/생활잡화 필수항목 참고
g13 가구 부록 6-2. 가구 필수항목 참고
g14 식품(농수산물) 부록 6-2. 식품(농수산물) 필수항목 참고
g15 건강기능식품 부록 6-2. 건강기능식품 필수항목 참고
g16 영상가전 부록 6-2. 영상가전 필수항목 참고
g17 계절가전 부록 6-2. 계절가전 필수항목 참고
g18 사무용기기 부록 6-2. 사무용기기 필수항목 참고
g19 광학기기 부록 6-2. 광학기기 필수항목 참고
g20 소형전자 부록 6-2. 소형전자 필수항목 참고
g21 네비게이션 부록 6-2. 네비게이션 필수항목 참고
g22 자동차용품 부록 6-2. 자동차용품 필수항목 참고
g23 의료기기 부록 6-2. 의료기기 필수항목 참고
g24 서적 부록 6-2. 서적 필수항목 참고
g25 악기 부록 6-2. 악기 필수항목 참고
g26 생활화확제품 부록 6-2. 생활화확제품 필수항목 참고
g27 살생물제품 부록 6-2. 살생물제품 필수항목 참고

5-3. 상품 주문 상태 코드

코드 설명 비고
0 주문접수(입금대기)
1 입금확인(결제완료)
2 배송준비 중
3 배송중
4 배송완료
5 구매확정

5-4. 상품 주문 취소 상태 코드

코드 설명 비고
0 정상주문
40 [취소,반품,환불] 요청
41 [취소,반품,환불] 접수
42 환불 접수 반품일때만
44 [취소,반품,환불] 완료

5-5. 교환 상태 코드

-교환은 상품 주문 상태가 "배송중" 이상일때만 사용하며 상품 주문 취소상태랑은 무관하게 진행됩니다.

코드 설명 비고
0 정상주문
1 교환요청
2 수거완료
3 재배송준비
4 재배송중
5 교환완료

5-6. 발송지연사유 코드

코드 설명 비고
01 상품준비중
02 주문제작
03 고객요청
04 예약발송
05 기타

5-7. 판매거부사유 코드

코드 설명 비고
001 수량부족(품절)
002 가격 변동
003 브랜드 자체 판매 거부
004 기타

5-8. 클레임 코드

코드 설명 비고
2 품절취소
3 배송지연취소(고객요청)
4 이중주문취소
5 시스템오류취소
6 누락배송
7 택배분실
9 기타
10 거래미성사
11 오배송
12 고객변심(사이즈)
13 고객변심(컬러)
14 고객변심(디자인)
15 고객변심(화면과다름)
16 고객변심(저품질)
17 상품불량(변경)
18 상품불량(파손)
19 상품불량(봉제불량)
20 상품불량(오염)
21 상품불량(포장)
22 상품수량부족 자동취소
23 직권취소(확인지연)
24 직권환불(반품지연)
25 배송지연 자동 취소
26 구매자 귀책
27 판매자 귀책
28 택배 파업
29 상품 품절
30 상품 품절(송장 삭제)
31 도선료 미입금 취소
32 기타
33 역마진

5-9. 상품 판매 상태 코드

코드 설명 비고
001 정상판매
004 판매중단 상품노출 안되고 품절됨

6. 부록

6-1. 상품옵션 전송 방법

[ 1차 옵션 등록 ]

옵션값 재고 판매가 정가 공급가 업체옵션번호
44 50 10,000 12,000 6,000 옵션번호
55 45 10,000 12,000 6,000 옵션번호
66 50 10,000 12,000 6,000 옵션번호

[ 2차 옵션 등록 ]

44 55 66 재고 판매가 정가 공급가 업체옵션번호
네이비 네이비 네이비 50 10,000 12,000 6,000 옵션번호
그레이 그레이 그레이 45 10,000 12,000 6,000 옵션번호

6-2. 상품정보고시 관련 필수 입력 항목

[g0] 의류 필수 항목

순번 항목명 필드명
1 소재 ItemMatiere
2 색상 ItemColors
3 치수 ItemSizes
4 제조사 ItemMaker
5 제조국 ItemMadeIn
6 제조년월 Launchdate
7 세탁방법 및 취급시 주의사항 ItemCaution
8 품질보증기준 ItemQualityAssurance
9 AS 책임자 ItemAsName
10 AS 전화번호 ItemAsTel

[g1] 구두/신발 필수 항목

순번 항목명 필드명
1 소재 ItemMatiere
2 색상 ItemColors
3 치수 ItemSizes
4 제조사 ItemMaker
5 제조국 ItemMadeIn
6 제조일 Launchdate
7 취급시 주의사항 ItemCaution
8 품질보증기준 ItemQualityAssurance
9 AS 책임자 ItemAsName
10 AS 전화번호 ItemAsTel

[g2] 가방 필수 항목

순번 항목명 필드명
1 소재 ItemMatiere
2 색상 ItemColors
3 크기 ItemSizes
4 제조사 ItemMaker
5 제조국 ItemMadeIn
6 취급시 주의사항 ItemCaution
7 종류 ItemKinds
8 품질보증기준 ItemQualityAssurance
9 AS 책임자 ItemAsName
10 AS 전화번호 ItemAsTel

[g3] 패션잡화 필수 항목

순번 항목명 필드명
1 소재 ItemMatiere
2 치수 ItemSizes
3 제조사 ItemMaker
4 제조국 ItemMadeIn
5 취급시 주의사항 ItemCaution
6 종류 ItemKinds
7 품질보증기준 ItemQualityAssurance
8 AS 책임자 ItemAsName
9 AS 전화번호 ItemAsTel

[g4] 화장품 필수 항목

순번 항목명 필드명
1 제조자 및 제조판매업자 ItemMaker
2 제조국 ItemMadeIn
3 취급시 주의사항 ItemCaution
4 용량 또는 중량 ItemVolume
5 제품주요사양 ItemSpec1
6 사용기한 ItemServiceLife
7 사용방법 ItemUsages
8 주요성분 ItemIngredient
9 기능성화장품 심사필유무 ItemWarranty
9 보증서 인증번호 ItemWarranty_number
11 품질보증기준 ItemQualityAssurance
12 AS 책임자 ItemAsName
13 AS 전화번호 ItemAsTel

[g5] 귀금속/보석/시계 필수 항목

순번 항목명 필드명
1 소재/순도/재질 ItemMatiere
2 치수 ItemSizes
3 제조사 ItemMaker
4 제조국 ItemMadeIn
5 취급시 주의사항 ItemCaution
6 중량 ItemVolume
7 주요사양 ItemSpec1
8 보증서 제공여부 ItemWarranty
9 보증서 인증번호 ItemWarranty_number
10 품질보증기준 ItemQualityAssurance
11 AS 책임자 ItemAsName
12 AS 전화번호 ItemAsTel

[g6] 영유아용품 필수 항목

순번 항목명 필드명
1 소재/순도/재질 ItemMatiere
2 색상 ItemColors
3 제조사 ItemMaker
4 제조국 ItemMadeIn
5 취급방법 및 취급시 주의사항 ItemCaution
6 크기 및 중량 ItemVolume
7 KC인증필 ItemWarranty
8 보증서 인증번호 ItemWarranty_number
9 인증기관 ItemWarrantyGov
10 사용연령 ItemUseAge
11 크기, 체중의 한계 ItemWeight
12 동일모델의 출시년월 ItemEqualModelLaunchdt
13 품명 및 모델명 ItemGoodscd
14 품질보증기준 ItemQualityAssurance
15 AS 책임자 ItemAsName
16 AS 전화번호 ItemAsTel

[g7] 스포츠용품 필수 항목

순번 항목명 필드명
1 재질 ItemMatiere
2 색상 ItemColors
3 제조사 ItemMaker
4 제조국 ItemMadeIn
5 크기 및 중량 ItemVolume
6 제품구성 ItemSpec1
7 동일모델의 출시년월 ItemEqualModelLaunchdt
8 상품별 세부사양 ItemSpec2
9 품명 및 모델명 ItemGoodscd
10 품질보증기준 ItemQualityAssurance
11 AS 책임자 ItemAsName
12 AS 전화번호 ItemAsTel

[g8] 가공식품 필수 항목

순번 항목명 필드명
1 식품의유형 ItemKinds
2 생산자 및 소재지 ItemMaker
3 제조국 ItemMadeIn
4 제조년월일 Launchdate
5 제조년월일(상세) ItemMakeDtDetail
6 유통기한 ItemServiceLife
7 용량,수량 ItemVolume
8 원재료 및 함량 ItemMatiere
9 영양성분 ItemIngredient
10 유전자재조합식품 여부 ItemGeneticallyMod
11 특수용도식품 사전심의필 ItemSpecialFood
12 수입식품여부 ItemImport
13 소비자안전을 위한 주의사항 ItemCaution
14 AS 전화번호 ItemAsTel

[g9] 침구류 필수 항목

순번 항목명 필드명
1 소재 ItemMatiere
2 색상 ItemColors
3 치수 ItemSizes
4 제조사 ItemMaker
5 제조국 ItemMadeIn
6 취급시 주의사항 ItemCaution
7 품질보증기준 ItemQualityAssurance
8 제품구성 ItemKinds
9 AS 책임자 ItemAsName
10 AS 전화번호 ItemAsTel

[g10] 가전 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 정격전압/소비전력/에너지소비 ItemSpec1
3 KC인증필 ItemWarranty
4 보증서 인증번호 ItemWarranty_number
5 동일모델의 출시년월 ItemEqualModelLaunchdt
6 용량,형태 ItemVolume
7 크기 ItemSizes
8 품질보증기준 ItemQualityAssurance
9 제조사 ItemMaker
10 제조국 ItemMadeIn
11 취급시 주의사항 ItemCaution
12 AS 책임자 ItemAsName
13 AS 전화번호 ItemAsTel

[g11] 주방용품 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 재질 ItemMatiere
3 구성품 ItemKinds
4 동일모델의 출시년월 ItemEqualModelLaunchdt
5 크기 ItemSizes
6 품질보증기준 ItemQualityAssurance
7 제조사 ItemMaker
8 식품위생법에 따른 수입신고 ItemImport
9 제조국 ItemMadeIn
10 AS 책임자 ItemAsName
11 AS 전화번호 ItemAsTel

[g12] 수납/청소/생활잡화 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 인증,허가 사항 ItemQualityAssurance
3 제조사 ItemMaker
4 제조국 ItemMadeIn
5 제품안전인증번호 ItemWarranty
6 보증서 인증번호 ItemWarranty_number
7 AS 책임자 ItemAsName
8 AS 전화번호 ItemAsTel

[g13] 가구 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 색상 ItemColors
3 KC인증필 ItemWarranty
4 보증서 인증번호 ItemWarranty_number
5 구성품 ItemKinds
6 재질 ItemMatiere
7 제조사 ItemMaker
8 제조국 ItemMadeIn
9 크기 ItemSizes
10 배송 설치비용 ItemServiceLife
11 인증,허가 사항 ItemQualityAssurance
12 AS 책임자 ItemAsName
13 AS 전화번호 ItemAsTel

[g14] 식품(농수산물) 필수 항목

순번 항목명 필드명
1 품목 또는 명칭 ItemGoodscd
2 포장단위별 용량(중량), 수량, 크기 ItemVolume
3 생산자, 수입품의 경우 수입자를 함께 표기 ItemMaker
4 농수산물의 원산지 표시에 관한 법률에 따른 원산지 ItemMadeIn
5 제조연월일(포장일 또는 생산연도) Launchdate
6 제조년월일(상세) ItemMakeDtDetail
7 유통기한 또는 품질유지기한 ItemServiceLife
8 상품구성 ItemSpec1
9 관련법상 표시사항 ItemSpec2
10 보관방법 또는 취급방법 ItemCaution
11 식품등의표시/광고에관한법률에 따른 소비자안전을 위한 주의사항 ItemUsages
12 소비자상담 관련 전화번호 ItemAsTel

[g15] 건강기능식품 필수 항목

순번 항목명 필드명
1 식품의 유형 ItemKinds
2 생산자 및 소재지(수입품의 경우 생산자, 수입자 및 제조국) ItemMaker
3 원산지 ItemMadeIn
4 제조연월일 Launchdate
5 유통기한 또는 품질유지기한 ItemServiceLife
6 포장단위별 용량(중량), 수량 ItemVolume
7 원재료명 및 함량(농수산물의 원산지 표시에 관한 법률에 따른 원산지 표시 포함) ItemMatiere
8 영양정보 ItemIngredient
9 기능정보 ItemSpec1
10 섭취량, 섭취방법 및 섭취 시 주의사항 및 부작용 가능성 ItemCaution
11 질병의 예방 및 치료를 위한 의약품이 아니라는 내용의 표현 ItemSpec2
12 유전자변형건강기능식 ItemGeneticallyMod
13 표시광고 사전심의필 ItemSpecialFood
14 소비자안전을 위한 주의사항 ItemQualityInfo
15 수입식품에 해당하는 경우 "건강기능식품에 관한 법률에 따른 수입신고를 필함"의 문구 ItemImport
16 소비자상담 관련 전화번호 ItemAsTel

[g16] 영상가전 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 정격전압, 소비전력 ItemSpec1
3 에너지소비효율등급 (에너지이용합리화법 상 의무대상상품에 한함) ItemSpec2
4 KC 인증 필 유무 (전기용품안전관리법 상 안전인증대상전기용품, 안전확인대상전기용품, 공급자적합성확인대상전기용품에 한함) ItemWarranty
5 동일모델의 출시년월 ItemEqualmodelLaunchdt
6 제조자 ItemMaker
7 수입품의 경우 수입자를 함께 표기 (병행수입의 경우 병행수입 여부로 대체 가능) ItemImporter
8 제조국 ItemOrigin
9 크기 (형태포함) ItemSizes
10 화면사양 (크기, 해상도, 화면비율 등) ItemVolume
11 품질보증기준 ItemQualityAssurance
12 AS 책임자 ItemAsName
13 AS 전화번호 ItemAsTel

[g17] 계절가전 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 정격전압, 소비전력 ItemSpec1
3 에너지소비효울등급 (에너지이용합리화법 상 의무대상상품에 한함) ItemSpec2
4 KC 인증 필 유무 (전기용품안전관리법 상 안전인증대상전기용품, 안전확인대상전기용품, 공급자적합성확인대상전기용품에 한함) ItemWarranty
5 동일모델의 출시년월 ItemEqualmodelLaunchdt
6 제조자 ItemMaker
7 수입품의 경우 수입자를 함께 표기 (병행수입의 경우 병행수입 여부로 대체 가능) ItemImporter
8 제조국 ItemOrigin
9 크기 (형태 및 실외기 포함) ItemSizes
10 냉난방면적 ItemVolume
11 추가설치비용 ItemServiceLife
12 품질보증기준 ItemQualityAssurance
13 AS 책임자 ItemASName
14 AS 전화번호 ItemASTel

[g18] 사무용기기 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 정격전압, 소비전력 ItemSpec1
3 에너지소비효율등급 (에너지이용합리화법 상 의무대상상품에 한함) ItemSpec2
4 KC 인증 필 유무 (전파법 상 인증대상상품에 한함, MIC 인증 필 혼용 가능) ItemWarranty
5 동일모델의 출시년월 ItemEqualmodelLaunchdt
6 제조자 ItemMaker
7 수입품의 경우 수입자를 함께 표기 (병행수입의 경우 병행수입 여부로 대체 가능) ItemImporter
8 제조국 ItemOrigin
9 크기, 무게 (무게는 노트북에 한함) ItemSizes
10 주요 사양 (컴퓨터와 노트북의 경우 성능, 용량, 운영체제 포함여부 등 / 프린터의 경우 인쇄 속도 등) ItemVolume
11 품질보증기준 ItemQualityAssurance
12 AS 책임자 ItemAsName
13 AS 전화번호 ItemAsTel

[g19] 광학기기 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 동일모델의 출시년월 ItemEqualmodelLaunchdt
3 KC인증필 (전파법 상 인증대상상품에 한함, MIC 인증 필 혼용 가능) ItemWarranty
4 제조자 ItemMaker
5 수입품의 경우 수입자를 함께 표기 (병행수입의 경우 병행수입 여부로 대체 가능) ItemImporter
6 제조국 ItemOrigin
7 크기, 무게 ItemSizes
8 주요 사양 ItemVolume
9 품질보증기준 ItemQualityAssurance
12 AS 책임자 ItemAsName
13 AS 전화번호 ItemAsTel

[g20] 소형전자 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 정격전압, 소비전력 ItemSpec1
3 KC인증 필 유무 (전파법 상 인증대상상품에 한함, MIC 인증 필 혼용 가능) ItemWarranty
4 동일모델의 출시년월 ItemEqualmodelLaunchdt
5 제조자 ItemMaker
6 수입품의 경우 수입자를 함께 표기 (병행수입의 경우 병행수입 여부로 대체 가능) ItemImporter
7 제조국 ItemOrigin
8 크기, 무게 ItemSizes
9 주요 사양 ItemVolume
10 품질보증기준 ItemQualityAssurance
11 AS 책임자 ItemAsName
12 AS 전화번호 ItemAsTel

[g21] 내비게이션 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 정격전압, 소비전력 ItemSpec1
3 KC인증 필 유무 (전파법 상 인증대상상품에 한함, MIC 인증 필 혼용 가능) ItemWarranty
4 동일모델의 출시년월 ItemEqualmodelLaunchdt
5 제조자 ItemMaker
6 수입품의 경우 수입자를 함께 표기 (병행수입의 경우 병행수입 여부로 대체 가능) ItemImporter
7 제조국 ItemOrigin
8 크기. 무게 ItemSizes
9 주요 사양 ItemVolume
10 앱 업데이트 비용 및 무상기간 ItemServiceLife
11 품질보증기준 ItemQualityAssurance
12 AS 책임자 ItemAsName
13 AS 전화번호 ItemAsTel

[g22] 자동차용품 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 동일모델의 출시년월 ItemEqualmodelLaunchdt
3 KC인증 필 유무 (전파법 상 인증대상상품에 한함, MIC 인증 필 혼용 가능) ItemWarranty
4 제조자 ItemMaker
5 수입품의 경우 수입자를 함께 표기 (병행수입의 경우 병행수입 여부로 대체 가능) ItemImporter
6 제조국 ItemOrigin
7 크기 ItemSizes
8 적용차종 ItemVolume
9 품질보증기준 ItemQualityAssurance
10 제품사용으로 인한 위험 및 유의사항 (연료절감장치에 한함) ItemCaution
11 검사합격증 번호 ItemKinds
12 AS 책임자 ItemAsName
13 AS 전화번호 ItemAsTel

[g23] 의료기기 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 정격전압, 소비전력 (전기용품에 한함) ItemSpec1
3 의료기기법상 허가/신고 번호 (허가/신고 대상 의료기기에 한함 및 광고사전심의필 유무) ItemWarranty
4 동일모델의 출시년월 ItemEqualmodelLaunchdt
5 제조자 ItemMaker
6 수입품의 경우 수입자를 함께 표기 (병행수입의 경우 병행수입 여부로 대체 가능) ItemImporter
7 제조국 ItemOrigin
8 제품의 사용목적 및 사용방법 ItemUsages
9 취급시 주의사항 ItemCaution
10 품질보증기준 ItemQualityAssurance
11 AS 책임자 ItemAsName
12 AS 전화번호 ItemAsTel

[g24] 서적 필수 항목

순번 항목명 필드명
1 도서명 ItemGoodscd
2 저자 ItemMaker
3 출판사 ItemKinds
4 ISBN코드 ItemImport
5 크기 ItemSizes
6 쪽수 ItemVolume
7 제품구성 ItemMatiere
8 출판년월일 ItemEqualModelLaunchdt
9 목차 또는 책소개 ItemSpec1

[g25] 악기 필수 항목

순번 항목명 필드명
1 품명 및 모델명 ItemGoodscd
2 크기 ItemSizes
3 재질 ItemMatiere
4 제조국 ItemMadeIn
6 수입자 ItemImporter
7 동일모델의 출시년월 ItemEqualModelLaunchdt
8 제품구성 ItemKinds
9 상품별 세부 사양 ItemSpec1
10 색상 ItemColors
11 품질보증기준 ItemQualityAssurance
12 A/S 책임자 ItemAsName
13 A/S 전화번호 ItemAsTel

[g26] 생활화학제품 필수 항목

순번 항목명 필드명
1 품목 및 제품명 ItemGoodscd
2 제조사 ItemMaker
3 제조국 ItemMadeIn
4 수입자 ItemImporter
5 제조연월일 Launchdate
6 제품에 사용된 화학물질 명칭 ItemIngredient
7 안전기준 적합확인 신고번호(자가검사번호) 또는 안전확인대상 생활화학제품 승인유무 ItemWarranty
8 용도(표백제의 경우 계열을 함께 표시) 및 제형 ItemSpec1
9 효과/효능 (승인대상 제품에 한함) ItemSpec2
10 중량/용량/매수 ItemVolume
11 사용상 주의사항 ItemCaution
12 어린이 보호포장 대상 제품 유무 ItemUsages
13 유통기한 또는 품질유지기한 ItemServiceLife
14 소비자상담 관련 전화번호 ItemAsTel

[g27] 살생물제품 필수 항목

순번 항목명 필드명
1 제품명 및 제품유형 ItemGoodscd
2 승인번호 ItemWarranty_number
3 제조사 ItemMaker
4 제조국 ItemMadeIn
5 수입자 ItemImporter
6 살생물물질, 나노물질, 기타 화학물질(유해화학물질 또는 중점관리물질)의 명칭 ItemIngredient
7 어린이 보호포장 대상 제품 유무 ItemUsages
8 중량 또는 용량 및 표준사용량 ItemVolume
9 사용대상자 및 사용범위 ItemUseAge
10 제품 유해성/위해성 표시 ItemSpec1
11 효능/효과 ItemSpec2
12 사용방법 및 사용상 주의사항 ItemCaution
13 소비자상담 관련 전화번호 ItemAsTel

6-3. KC 안전인증 유형

내용 상세여부
해당없음
상세설명참조
[생활용품]안전인증 입력
[생활용품]안전확인 입력
[생활용품]공급자적합성확인
[생활용품]어린이보호포장 입력
[어린이제품]안전인증 입력
[어린이제품]안전확인 입력
[어린이제품]공급자적합성확인
[전기용품]안전인증 입력
[전기용품]안전확인 입력
[전기용품]공급자적합성확인
[방송통신기자재]적합성평가 입력
[위해우려제품]자가검사번호 입력

Etc

End. 감사합니다 :)