상품 연결 (연동코드·카탈로그)
구매내역 API 의 item_code 를 쏠브 전자책에 연결하는 방법입니다. 파트너 어드민 등록 또는 카탈로그 파일로 진행합니다.
구매내역 API 가 돌려준 item_code 가 쏠브의 어떤 전자책인지 알려주는 단계입니다. 방법은 두 가지이고, 제휴사 상황에 맞는 하나를 고르면 됩니다.
| 방법 | 이런 제휴사 | 제휴사가 할 일 |
|---|---|---|
| A. 파트너 어드민 등록 (권장) | 쏠브 파트너 어드민에 전자책 PDF 를 직접 등록 | 등록할 때 연동코드 입력. 이미 등록한 전자책은 상품 상세에서 한 번 입력. |
| B. 카탈로그 파일 | 쏠브가 전자책을 대신 등록 | 상품 목록 파일 전달, 신상품마다 갱신 |
연결되지 않은 item_code 는 책장에 들어가지 않습니다
구매내역 API 가 돌려준 item_code 중 연동코드나 카탈로그에 없는 코드는 무시됩니다. 판매 중인 전자책 상품을 빠짐없이 연결해 주세요.
A. 파트너 어드민에 등록하기
전자책 등록 화면 열기
쏠브 파트너 어드민에서 전자책 PDF 등록을 시작합니다. 어드민 계정은 계약 시 안내해 드립니다.
판매유형 고르기
| 판매유형 | 뜻 |
|---|---|
연동형 | 제휴사 사이트에서 구매한 회원에게만 제공합니다. |
연동+쏠브북스 | 제휴사 구매 회원에게 제공하고, 쏠브북스에서도 판매합니다. |
쏠브북스 | 쏠브북스에서만 판매합니다. 연동과 무관하며 연동코드란이 보이지 않습니다. |
연동코드 입력
연동코드란에 구매내역 API 가 돌려주는 item_code 를 그대로 입력합니다. 쏠브는 item_code 의 앞뒤 공백을 떼고 비교합니다. 그 밖은 대소문자까지 글자 그대로 같아야 합니다. 연동코드 앞뒤에는 공백을 넣지 마세요.
이렇게 등록하면 그 item_code 를 구매한 회원의 책장에 책이 자동으로 들어갑니다. 등록 전에 구매한 회원도 다음 동기화(책장 진입 등) 때 책이 들어갑니다. 카탈로그 파일은 따로 보내지 않아도 됩니다.
이미 등록한 전자책에 연동코드 넣기
이미 등록한 전자책은 파트너 어드민의 상품 상세 화면에서 연동코드를 넣을 수 있습니다.
- 연동코드가 비어 있을 때 한 번만 넣을 수 있습니다. 저장하면 바꿀 수 없으니 제휴사 쇼핑몰의 상품코드와 똑같이 넣어 주세요.
- 쏠브북스에서만 판매하던 전자책은 저장하면 판매유형이
연동+쏠브북스로 바뀝니다. - 한 상품코드에 여러 권이 묶인 패키지는 포함된 각 전자책에 같은 연동코드를 넣습니다. 같은 연동코드가 이미 다른 전자책에 들어 있으면 저장할 때 한 번 더 확인합니다.
패키지·세트 상품
| 경우 | 입력 방법 |
|---|---|
| 한 상품코드에 여러 권이 묶인 패키지 | 포함된 각 전자책을 등록할 때 같은 연동코드를 입력합니다. |
| 한 권이 여러 상품코드에 동시에 포함 (단품 + 패키지 등) | 연동코드란에는 코드 하나만 들어가므로, 나머지 코드는 쏠브 담당자에게 알려주세요. 쏠브에서 연결해 드립니다. |
| 종이책 + 전자책 혼합 세트 | 전자책을 등록할 때 세트의 상품코드를 입력합니다. |
B. 카탈로그 파일로 전달하기
쏠브가 전자책을 대신 등록하는 경우, 상품코드가 어떤 책인지 정리한 파일을 보내주세요. 엑셀·CSV·JSON 중 편한 형식이면 됩니다.
| 필드 | 필수 | 설명 |
|---|---|---|
item_code | 필수 | 구매내역 API 의 item_code 와 같은 값 |
item_name | 필수 | 상품명 |
isbn_list | 권장 | 상품에 포함된 도서의 ISBN 목록. 쏠브 전자책과 매칭하는 핵심 키입니다. 패키지는 여러 개, 혼합 세트는 전자책 ISBN 만 적어도 됩니다. |
product_type | 선택 | book, package, lecture 등 |
valid_period | 선택 | 이용 기간 |
item_code,item_name,product_type,isbn_list
BOOK_TOEIC_2026,토익 실전 2026,book,9791234567890
PKG_TOEIC_FULL,토익 풀패키지(LC+RC+해설),package,9791234567890;9791234567891;9791234567892
SET_TOEIC_PAPER_EBOOK,토익 실전 종이+전자 세트,package,9791234567890[
{ "item_code": "BOOK_TOEIC_2026", "item_name": "토익 실전 2026", "product_type": "book", "isbn_list": ["9791234567890"] },
{ "item_code": "PKG_TOEIC_FULL", "item_name": "토익 풀패키지(LC+RC+해설)", "product_type": "package", "isbn_list": ["9791234567890", "9791234567891", "9791234567892"] }
]CSV 에서 여러 ISBN 은 ; 로 구분합니다(다른 구분자도 협의 가능). 필드를 더 넣어도 괜찮고, 매칭은 쏠브가 책임지고 진행합니다.
- 출시 전: 판매 중인 전자책 상품 전체를 한 번 보내주세요.
- 출시 후: 신상품이 생길 때마다 해당 행을 추가해 다시 보내주세요.
item_code 규칙 (A·B 공통)
- 상품 단위입니다. 책 단위가 아닙니다. 단품 A·B·C 와 이를 묶은 패키지 D 는 각각 다른 코드입니다.
- 같은 책이 여러 코드에 들어가도 괜찮습니다.
- 한 번 쓴 코드는 의미를 바꾸거나 다른 상품에 다시 쓰지 마세요. 과거 구매자의 책장이 엉뚱한 책으로 바뀝니다.