상품 등록/수정

post
https://api.imweb.me/v2/shop/products
​
patch
https://api.imweb.me/v2/shop/products/
{상품번호}
수정 시 변경할 항목만 전달해주세요.
요청 데이터
항목
타입
설명
categories
Array
상품 카테고리 코드
상품 카테고리 조회 API 바로가기​
showcase
Array
기획전 코드
​기획전 조회 API 바로가기​
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
상품정보고시 작성예시​
product: 상품정보고시명
상품정보고시 추가 데이터
​상품정보고시​
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​
ProdOptionsList Data
항목
타입
설명
type
String
옵션 타입
default: 기본
input: 입력형
color: 색상
name
String
옵션 구성
​ProdOptionsList Data​
values
Array
옵션값 데이터
기본, 색상 옵션만 해당됩니다.
​ProdOptionsListValueData​
is_require
Boolean
필수옵션 여부
입력형 옵션은 필수 옵션으로만 사용이 가능합니다.
ProdOptionsList Data
항목
타입
설명
type
String
옵션 타입
default: 기본
input: 입력형
color: 색상
name
String
옵션명
values
Array
옵션값 데이터
기본, 색상 옵션만 해당됩니다.
​ProdOptionsListValueData​
is_require
Boolean
필수옵션 여부
입력형 옵션은 필수 옵션으로만 사용이 가능합니다.
ProdOptionsListValue Data
항목
타입
설명
name
String
옵션값명
data
Array
옵션 추가 데이터
옵션 추가 데이터가 필요한 옵션 타입의 경우 추가 데이터를 필수로 전달해주셔야 합니다.
색상: ProdOptionsColorEtcData​
ProdOptionsColorEtc Data
항목
타입
설명
color
String
색상코드
예) #00000
image_url
String
색상옵션 이미지 URL
​

항목	타입	설명
categories	Array	상품 카테고리 코드 상품 카테고리 조회 API 바로가기
showcase	Array	기획전 코드 기획전 조회 API 바로가기
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	상품정보고시 작성예시 product: 상품정보고시명 상품정보고시 추가 데이터 상품정보고시
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	상품 옵션 데이터 작성예시

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

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

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

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

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

Last modified 1yr ago