시작하기
home
둘러보기
home

상품 / 옵션 연동 방식

연동 방식은 2가지를 안내 드리고 있습니다. 실제 주문 및 엔드유저의 편집기 이용시 필요한 항목은 channelProductId, designTemplateId, channelOptionVariantId 가 필요하며 아래 예시로 제공한 방식은 개발 편의성을 위해 참고용으로 제공 드리고 있습니다. 실제 개발사 상품과 Pod Shop 상품 매핑은 API를 참고하여 자유롭게 개발 진행하시면 됩니다.
목차
⚠️
주의 사항
옵션 API의 경우 옵션 구성이 옵션:값 단건일 경우 매핑 제외 항목으로 Response에서 제외됩니다.
채널 상품 + 디자인 템플릿 키를 이용한 API는 상품, 디자인에 설정된 옵션이 조합되어 상품 구성이 이루어 지므로 상품의 옵션과 채널 상품+디자인 템플릿의 옵션 구성이 다를 수 있습니다.

방식 1. 상품 / 디자인템플릿 / 베리언트(ChannelOptionVariantId) 매핑

* 상품의 옵션은 모든 옵션 조합에 대한 하나의 ID를 가지며 이를 베리언트(channelOptionVariantId) 라고 부릅니다. * POD상품의 경우 상품+디자인을 세트로 한개의 상품의 구성되는데 이 구성을 관리하는 주체가 하나의 시스템 일때 이용

1. [개발사 시스템] 개발사 상품 ↔ POD Shop Product & DesignTemplate 매핑

Pod Shop의 상품 판매 구성은 상품 + 디자인 템플릿 으로 구성되며
개발사 상품 한개와 Pod Shop의 channelProductId, designTemplateId로 상품 매핑을 진행해 주시면 됩니다.

1.1. 참고 API

2. [개발사 시스템] 개발사 상품 옵션 ↔ POD Shop 상품 옵션 매핑

개발사에 조합해 놓은 옵션 구성 하나에 대해 1:1로 channelOptionVariantId 매핑 진행
예) 반팔티셔츠 사이즈 : S, M, L 색상 : White, Black, Green 인쇄방식 : 날염, 디지털플러스 위와 같은 구성에서 반팔티셔츠 S White 날염 = 1001 = channelOptionVariantId 반팔티셔츠 S White 디지털플러스 = 1002 = channelOptionVariantId 개발사 "반팔티셔츠 S White 날염" 구성에 대한 키 = T001 개발사 "반팔티셔츠 S White 디지털플러스" 구성에 대한 키 = T002 매핑 T001 - 1001 T002 - 1002
Plain Text
복사

2.1. 참고 API

* 위 API 기반으로 상품 및 상품 옵션 조합에 대해 매핑 진행 후 엔드유저의 주문 또는 편집기 이용시 매핑된 channelProductId, designTemplateId, channelOptionVariantId 를 이용하여 호출 하면 됩니다.

방식 2. 상품 / 디자인템플릿 / 옵션 값 (optionValueId) 매핑, 이후 베리언트 획득

* 옵션 상세의 값을 매핑할때 이용 (베리언트 조합을 이용하여 매핑 불가능한 경우 추천) * POD상품의 경우 상품+디자인을 세트로 한개의 상품의 구성되는데 이 구성을 관리하는 주체가 하나의 시스템 일때 이용

1. [개발사 시스템] 개발사 상품 ↔ POD Shop Product & DesignTemplate 매핑

Pod Shop의 상품 판매 구성은 상품 + 디자인 템플릿 으로 구성되며
개발사 상품 한개와 Pod Shop의 channelProductId, designTemplateId로 상품 매핑을 진행해 주시면 됩니다.

1.1. 참고 API

2. [개발사 시스템] 옵션 값 (optionValueId) 기준 매핑

개발사의 옵션 구성 상세 데이터에 대해 1:1로 optionValueId 매핑 진행
) optionValueId 사이즈 개발사 키 PODShop optionValueId S : 20 - 1001 M : 21 - 1002 L : 22 - 1003 XL : 23 - 1004 2XL : 24 - 1005 색상 흰색 : 31 - 2001 검정 : 32 - 2002 파랑 : 33 - 2003
SQL
복사
* 개발사의 옵션의 Value와 PosShop의 optionValueId 매핑 진행

2.1. 참고 API

옵션 목록 조회 - 채널 상품, 디자인 템플릿에 해당하는 옵션 목록 조회 * 주의 : 옵션 구성이 옵션:값 의 구성이 단건 일 경우 매핑이 제외 항목으로 Response에서 제외 됩니다. 옵션 구성이 실제 상품 구매에 적용되지 않는 옵션 일 경우 Response 제외됩니다. ex) 색상 : 블랙 만 구성시 color:black 옵션은 매핑 제외 핸드폰 케이스 상품에서 디바이스 컬러 옵션

3. [스토어] 베리언트 조회

선택된 channelProductId, designTemplateId, optionValueId 목록에 해당하는 channelOptionVariantId 획득

3.1. 참고 API

옵션 Variant 조회 - 채널 상품, 디자인 템플릿, 선택한 옵션 Value에 해당하는 variant ID 를 정보를 응답합니다. * 상품의 옵션 value를 누락 할 경우 실제 상품데이터와 다를 수있음에 주의
* 위 API 기반으로 상품 및 상품 옵션 값에 대해 매핑 선진행 후 엔드유저의 옵션 선택 완료 이후 3.1. 항목 참고하여 channelOptionVariantId 획득한 후 매핑된 channelProductId, designTemplateId, channelOptionVariantId 를 이용하여 주문 또는 편집기 호출 하면 됩니다.