상품 등록/수정

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