상품 등록을 위한 사전 정보
•
브랜드 소싱 조회 : GET /seller/brand-sourcings
◦
브랜드 소싱 생성은 사전 협의 상태에서 퀸잇 시스템 내에서 생성 가능합니다. 생성 완료 후에 위의 API 통해 조회 가능합니다.
•
카테고리 조회 : GET /seller/categories
◦
◦
API 연동이 아닌 수동 맵핑 하시는 경우를 통하여 관리하시는 경우에는 전체 목록 요청 부탁드립니다.
•
배송정책 생성 : POST /seller/policy-targets
◦
배송정책은 셀러사 기본 배송 정책, 브랜드코드 단위, 상품 단위 로 설정이 가능합니다.
◦
배송정책이 설정되는 순서는 상품별 배송정책 > 브랜드별 배송정책 > 기본 배송 정책 순서로 적용됩니다.
상품 최초 등록
위 사항에 대해 먼저 필요합니다.
•
퀸잇 서비스(웹/앱)에 상품 노출하기
◦
두 가지 Step 으로 진행되며 등록된 이후에도 동일 순서로 처리해주셔야 합니다.
1.
상품의 Proposal 을 생성 API 호출
PUT /seller/product-proposals
2.
발급된 ProposalID 로 승인 API 호출
POST /seller/product-proposals/{proposalId}/submit
•
특이사항
◦
판매자 상품코드(mallProductCode) 는 중복해서 등록할 수 없습니다.
◦
한 상품 내 옵션명과 옵션코드는 중복될 수 없습니다.
◦
생성 API만 호출하는 상태는 셀러어드민 내에서는 임시저장 상태입니다. 승인이 완료되어야 퀸잇의 상품 ID(productId 이며, 생성시 발급되는 ID와는 다름)가 발행됩니다.
상품 수정
•
상품 수정(PUT /seller/product-proposals)
◦
최초 등록시에 발급된 productProposalId 을 넣어주셔야 등록이 아닌 수정으로 인지하고 있으므로 내부적으로 저장하시는 것을 추천드립니다.
◦
상품의 전체 업데이트를 전제로 하고 있으므로 전체 정보를 갖고 있지 않고 일부 필드만 변경해야하는 상황이라면, 두 가지 방법을 제안드립니다.
▪
상품 조회(GET /seller/product-proposals/{proposalId} )하여 최신 정보를 조회 후 필요한 부분 수정 API 호출하시는 방법
▪
또는, 부분업데이트 API PUT /seller/product-proposals/{proposalId}/partial 활용 (파라미터에 따라 승인 파라미터 바로 호출가능)
•
상품 승인(POST /seller/product-proposals/{proposalId}/submit)
•
상품 조회
◦
단건 상품 조회 : GET /seller/product-proposals/{proposalId}
◦
다건 상품 조회 : POST /seller/product-proposals/search/cursored
기타
•
각 API 상세 스펙에 대해서는 스웨거 문서를 참고 부탁드립니다.