연동 방식은 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 를 이용하여 주문 또는 편집기 호출 하면 됩니다.