상품 등록 조회(일자)(문의 : km1262@nate.com)

기본설정

  • FORM POST 전송
  • data = {"id":"조회 아이디","date":"조회 날짜(YYYY-MM-DD)"}
  • data = {"id":"조회 아이디","date":"조회 날짜(YYYY-MM-DD)","exclude_category":["10","20"]}
  • 상품 등록 데이터

전달값

필드명 설명
id(필수) 조회 아이디(국민클럽비투비 회원 아이디)
date(필수) 조회 일자(YYYY-MM-DD)
exclude_category(선택) 제외할 카테고리 배열

리턴값

필드명 하위필드명 하위필드명 설명
state - - success or fail
message - - fail 일 경우 오류 메세지
total - - 총 개수
help - - data 필드와 매칭되며 각 필드별 설명
data id - 상품고유번호
ca_id - 카테고리코드
ca_id2 - 카테고리코드
ca_id3 - 카테고리코드
ca_id4 - 카테고리코드
ca_id5 - 카테고리코드
ca_id6 - 카테고리코드
name - 상품명
basic - 기본설명
it_type2 - 추천상품여부
img_url - 썸네일 URL
text_subject - 텍스트 입력옵션명
option_subject - 선택옵션명(최대 3개)
예제 : 성별,색상,크기

결합문자 : ,

supply_subject - 추가옵션명
예제 : 추가옵션1,추가옵션2,추가옵션3

결합문자 : ,

tax - 과세/비과세여부 0 => 과세, 1=> 비과세
it_origin - 원산지
lowest_price_company - 최저가몰
lowest_price - 최저가
supply_price - 공급가
cust_price - 소비자가
soldout - 0 => 판매, 1 => 품절
discontinued - 0 => 판매, 1 => 단종
sc_type - 배송비유형, 1 => 무료배송, 2 => 조건부무료, 3 => 유료, 4 => 수량별부과
sc_method - 배송비결제유형 0 => 선불, 1 => 착불, 2 => 사용자선택
sc_price - 기본배송비
sc_minimum - 조건부무료시 조건금액
sc_qty - 수량별부과시 수량
register_time - 등록일시
update_time - 수정일시
it_serial - 상품고유코드
delivery_notice - 배송특이사항(2순위)
delivery_notice_product - 배송특이사항(1순위)
explan - 상세설명
mobile_explan - 모바일 상세설명
shelf_life - 유통기한(2022-11-25 추가)
is_only - 전용상품여부. 0 => 일반, 1 => 전용(2022-11-25 추가)
option io_id

선택옵션(옵션값만 조합)

옵션조합명
예제 : 블루그린110

결합문자 : 아스키코드 30번 문자

추가옵션(추가옵션명과 추가옵션값을 조합)

예제 : 추가옵션1블루그린

결합문자 : 아스키코드 30번 문자

io_type 0 => 선택옵션, 1 => 추가옵션
it_id 상폼고유번호
io_price 옵션가격
io_stock_qty 옵션재고
io_use 옵션 사용여부. 0 => 사용안함, 1 => 사용함

HTTP

POST /item/registed HTTP/1.1
Host: api.kmclubb2b.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="data"

{"id":"비투비 아이디","date":"2020-05-06"}
----WebKitFormBoundary7MA4YWxkTrZu0gW

HTTP

POST /item/registed HTTP/1.1
Host: api.kmclubb2b.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="data"

{"id":"kmclub","date":"2020-06-19","exclude_category":["10","20"]}
----WebKitFormBoundary7MA4YWxkTrZu0gW

성공 예제

{
    "state": "success",
    "help": [
        {
            "id": "고유번호",
            "ca_id": "카테고리코드",
            "ca_id2": "카테고리코드",
            "ca_id3": "카테고리코드",
            "ca_id4": "카테고리코드",
            "ca_id5": "카테고리코드",
            "ca_id6": "카테고리코드",
            "name": "상품명",
            "basic": "기본설명",
            "it_type2": "추천상품여부",
            "img_url": "썸네일 URL",
            "text_subject": "텍스트 입력옵션명",
            "option_subject": "선택옵션명(최대 3개)",
            "supply_subject": "추가옵션명",
            "tax": "과세/비과세여부 0 => 과세, 1 => 비과세",
            "it_origin": "원산지",
            "lowest_price_company": "최저가몰",
            "lowest_price": "최저가",
            "supply_price": "공급가",
            "cust_price": "소비자가(시중가)",
            "soldout": "0 => 판매, 1 => 품절",
            "discontinued": "0 => 판매, 1 => 단종",
            "sc_type": "배송비유형, 1 => 무료배송, 2 => 조건부무료, 3 => 유료, 4 => 수량별부과",
            "sc_method": "배송비결제유형 0 => 선불, 1 => 착불, 2 => 사용자선택",
            "sc_price": "기본배송비",
            "sc_minimum": "조건부무료시 조건금액",
            "sc_qty": "수량별 부과시 수량",
            "register_time": "등록일시",
            "update_time": "수정일시",
            "it_serial": "상품고유코드",
            "delivery_notice": "배송특이사항",
            "explan": "상세설명",
            "mobile_explan": "모바일 상세설명",
            "option": [
                {
                    "io_id": "옵션조합명",
                    "io_type": "0 => 선택옵션, 1 => 추가옵션",
                    "it_id": "상품고유번호",
                    "io_price": "옵션가격",
                    "io_stock_qty": "옵션재고",
                    "io_use": "옵션사용여부 0 => 사용안함, 1 => 사용함"
                }
            ]
        }
    ],
    "total": 74,
    "data": [
                {
            "id": "1588733371",
            "ca_id": "50",
            "ca_id2": "5080",
            "ca_id3": "",
            "ca_id4": "",
            "ca_id5": "",
            "ca_id6": "",
            "name": "아가호호 퓨어오가닉 밀크화이트 라운드점프슈트",
            "basic": "",
            "it_type2": "0",
            "it_origin": "",
            "img_url": "http://dbimg.co.kr/editor/2005/0506/interonic03-01-m.jpg",
            "text_subject": "",
            "option_subject": "사이즈",
            "supply_subject": "",
            "tax": "0",
            "lowest_price_company": "지마켓",
            "lowest_price": "51980",
            "supply_price": "공급가",
            "cust_price": "85000",
            "soldout": "0",
            "discontinued": "0",
            "sc_type": "1",
            "sc_method": "0",
            "sc_price": "0",
            "sc_minimum": "0",
            "sc_qty": "0",
            "register_time": "2020-05-06 11:49:30",
            "update_time": "2020-05-06 11:49:30",
            "it_serial": "73585",
            "delivery_notice": "",
            "explan": "<p align=\"center\" style=\"text-align: center;\"><img src=\"http://dbimg.co.kr/editor/2005/0506/interonic03-d.jpg\"></p>",
            "mobile_explan": "<p align=\"center\" style=\"text-align: center;\"><img src=\"http://dbimg.co.kr/editor/2005/0506/interonic03-d.jpg\"></p>",
            "option": [
                {
                    "io_id": "60",
                    "io_type": "0",
                    "it_id": "1588733371",
                    "io_price": "0",
                    "io_stock_qty": "9999",
                    "io_use": "1"
                },
                {
                    "io_id": "70",
                    "io_type": "0",
                    "it_id": "1588733371",
                    "io_price": "0",
                    "io_stock_qty": "9999",
                    "io_use": "1"
                },
                {
                    "io_id": "80",
                    "io_type": "0",
                    "it_id": "1588733371",
                    "io_price": "0",
                    "io_stock_qty": "9999",
                    "io_use": "1"
                }
            ]
        },
        ....
    ]
}