Imweb
Search
⌃K

상품 등록/수정

post
https://api.imweb.me/v2/shop/products
patch
https://api.imweb.me/v2/shop/products/
{상품번호}
수정 시 변경할 항목만 전달해주세요.

요청 데이터

항목
타입
설명
categories
Array
상품 카테고리 코드 상품 카테고리 조회 API 바로가기
showcase
Array
기획전 코드
images
Array
상품 이미지
이미지 URL로 등록해주세요.
name
String
상품명
simple_content
String
요약설명
content
String
상세설명
use_mobile_prod_content
Boolean
모바일 상세설명 사용여부
mobile_content
String
모바일 상세설명
모바일 상세설명 사용여부가 true일 때만 필수
prod_status
String
상태
  • sale판매중
  • soldout품절
  • nosale숨김
prod_type
String
판매 방식 설정
  • normal: 일반 상품
  • digital: 디지털 상품
  • subscribe: 회원그룹 이용권
subscribe_group_code
String
대상 그룹 코드
회원그룹 이용권 시 필수
subscribe_period
Integer
그룹 유지 기간(일)
회원그룹 이용권 시 필수
is_badge_new
Boolean
신상품
is_badge_best
Boolean
베스트
is_badge_md
Boolean
MD추천
is_badge_hot
Boolean
주문폭주
origin
String
원산지
maker
String
제조사
brand
String
브랜드
seo_title
String
SEO 검색엔진 최적화 - 제목
seo_description
String
SEO 검색엔진 최적화 - 메타 설명
seo_access_bot
Boolean
SEO 검색엔진 최적화 - 검색엔진에서 제외 여부
price
Float
상품가격
price_org
Float
할인 이전 가격
price_tax
Boolean
세금 포함 여부
price_none
Boolean
가격 없음 여부
prodinfo
Array
상품정보고시 작성예시
give_point_type
String
적립금 설정 타입
  • common: 기본 설정을 따름
  • individual: 개별 적립금 설정
give_point_value_type
String
적립금 단위
  • percent: 퍼센트
  • price: 통화 단위
give_point_value
Float
적립금 값
적립금 값 타입이 percent일 경우 백분율 단위로 입력
product_discount_options
Array
할인 사용 설정
  • coupon: 쿠폰
  • point: 적립금
  • shopping_group_dc: 쇼핑등급 할인
  • period: 즉시/기간 할인
period_discount_data
Array
즉시/기간할인 설정
  • group_type: 할인적용 대상
    guest(회원+비회원)
    member(회원)
    그룹지정은 미지원
  • dc_price: 할인 금액
  • dc_type: 할인금액 단위:
use_pre_sale
Boolean
판매기간 사용 유무
pre_sale_start_date
String
판매기간 시작일
예) 2020-06-01 14:00:00
pre_sale_end_date
String
판매기간 종료일
예) 2020-06-01 16:00:00
weight
Float
상품 무게
custom_prod_code
String
자체 상품 코드
pay_product_name
String
외부 연동용 정보 - 네이버, 카카오 노출용 상품명
event_words
String
외부 연동용 정보 - 네이버 쇼핑 이벤트 문구
naver_category
String
외부 연동용 정보 - 네이버 쇼핑 카테고리 ID
condition
String
외부 연동용 정보 - 상품 상태
  • 신상품
  • 중고
  • 리퍼
  • 전시
  • 반품
  • 스크래치
product_flag
String
외부 연동용 정보 - 판매 방식
  • 소매
  • 도매
  • 렌탈
  • 대여
  • 할부
  • 예약판매
  • 구매대행
order_made
Boolean
외부 연동용 정보 - 주문제작 상품
parallel_import
Boolean
외부 연동용 정보 - 병행수입
import_flag
Boolean
외부 연동용 정보 - 해외구매대행
is_culture_benefit
Boolean
외부 연동용 정보 - 도서공연비 소득공제
minimum_purchase_quantity
Integer
최소 구매 수량
minimum_purchase_quantity
Integer
1회 구매 시 최대 수량
member_maximum_purchase_quantity
Integer
1인 구매 시 최대 수량
optional_limit_type
String
0원 선택옵션 구매 시 최대 구매수량 제한 타입
  • relative: 본상품 구매 수량만큼 구매 가능
  • limit: 최대 구매 수량 제한
  • unique: 1개만 구매 가능
optional_limit
Integer
0원 선택옵션 구매 시 최대 구매수량 - 최대 구매 수량 제한
use_unipass_number
String
개인통관고유부호 사용 설정
  • default: 기본 방법을 따름 (쇼핑 환경설정)
  • Y: 사용
  • N: 사용안함
adult
Boolean
미성년자 구매 제한
display
Array
외부 노출
  • NAVER: 네이버 쇼핑
  • DAUM: 다음(카카오) 쇼핑하우
  • NPAY: 네이버페이 구매가능
  • TALKPAY: 카카오페이 구매가능
  • FACEBOOK: Facebook 다이내믹 광고
  • CRITEO: CRITEO 광고
stock_use
Boolean
재고관리 사용유무
stock_unlimit
Boolean
재고 소진후에도 주문 가능 유무
stock_no_option
Integer
본 상품 재고
sku_no_option
String
본 상품 재고번호(SKU)
options
Array
상품 옵션 데이터 작성예시

prodinfo 작성예시

$data['prodinfo'] = [];
$data['prodinfo']['product'] = '구두';
$data['prodinfo']['material'] = '가죽';
$data['prodinfo']['color'] = '그레이';
$data['prodinfo']['size'] = '270';
...

options 작성예시

$data['options'] = [];
$data['options']['is_mix'] = false; // 조합형 옵션
$data['options']['list'] = [
[
'is_require' => true,
'type' => 'default', // 기본 옵션
'name' => '테스트 옵션',
'values' => ['A', 'B', 'C'],
],
[
'is_require' => true,
'type' => 'color', // 색상 옵션
'name' => '테스트 옵션2',
'values' => [
[
'name' => 'X',
'data' => [
'color' => '#AAA',
'image_url' => ''
]
],
[
'name' => 'Y',
'data' => [
'color' => '#AAA',
'image_url' => ''
]
],
[
'name' => 'Z',
'data' => [
'color' => '#AAA',
'image_url' => ''
]
],
]
],
];

ProdOptions Data

항목
타입
설명
is_mix
Boolean
조합형 옵션 여부
list
Array
옵션 구성

ProdOptionsList Data

항목
타입
설명
type
String
옵션 타입
  • default: 기본
  • input: 입력형
  • color: 색상
name
String
옵션 구성
values
Array
옵션값 데이터
기본, 색상 옵션만 해당됩니다.
is_require
Boolean
필수옵션 여부
입력형 옵션은 필수 옵션으로만 사용이 가능합니다.

ProdOptionsList Data

항목
타입
설명
type
String
옵션 타입
  • default: 기본
  • input: 입력형
  • color: 색상
name
String
옵션명
values
Array
옵션값 데이터
기본, 색상 옵션만 해당됩니다.
is_require
Boolean
필수옵션 여부
입력형 옵션은 필수 옵션으로만 사용이 가능합니다.

ProdOptionsListValue Data

항목
타입
설명
name
String
옵션값명
data
Array
옵션 추가 데이터
옵션 추가 데이터가 필요한 옵션 타입의 경우 추가 데이터를 필수로 전달해주셔야 합니다.

ProdOptionsColorEtc Data

항목
타입
설명
color
String
색상코드
예) #00000
image_url
String
색상옵션 이미지 URL