상품 카탈로그

제휴사의 item_code 가 각각 어떤 상품인지 정리한 매핑표입니다. 쏠브는 이 표를 보고 item_code 를 쏠브 상품에 연결합니다.

카탈로그에 없는 item_code 는 권한이 부여되지 않습니다. 모든 상품을 빠짐없이 담아 주세요. 하나의 item_code 가 여러 쏠브 상품·패키지에 연결될 수도 있습니다 (1:N).

상품 단위 정리 (책 단위가 아닙니다)

item_code 는 상품 단위 입니다. 책 단위가 아닙니다.

• 단품 도서 A·B·C 와, 이들을 묶은 패키지 상품 D 는 각각 독립된 별도 item_code 로 등록됩니다.
• 하나의 item_code 에 여러 권의 책이 포함될 수 있습니다 (패키지·세트 상품).
• 같은 책이 여러 item_code 에 동시에 포함되어도 무방합니다 (단품 A, 패키지 D, 또 다른 패키지 E 등).
• 종이책과 전자책이 함께 묶인 혼합 세트도 하나의 item_code 로 관리하시면 됩니다. 쏠브는 카탈로그에 적힌 ISBN 중 쏠브에서 서비스하는 전자책 부분만 매핑합니다.

스키마

필수 필드

• item_code · string · 필수 — 구매내역 API 의 item_code 와 같은 값.
• item_name · string · 필수 — 상품·강의명.

권장 필드

도서 상품의 경우 ISBN 이 쏠브 상품과의 매핑에 사용되는 핵심 키입니다. 가능한 모든 상품에 ISBN 을 적어 주세요.

• isbn_list · string[] · 권장 — 상품에 포함된 도서의 ISBN 목록.
  • 단품 상품 → ISBN 1개
  • 패키지·세트 상품 → 포함된 도서들의 ISBN 여러 개
  • 혼합 세트 (종이책 + 전자책) → 전자책 부분의 ISBN 만 적어 주셔도 되고, 전체 ISBN 을 모두 적어 주셔도 됩니다. 쏠브에서 서비스 대상만 자동으로 매핑됩니다.

옵셔널 필드 (자유 추가)

매핑 정확도가 올라가도록 필요한 정보를 자유롭게 추가하실 수 있습니다. 아래는 예시입니다.

• product_type · string · 옵셔널 — book, package, lecture 등 상품 유형.
• valid_period · string · 옵셔널 — 유효기간.

엑셀, CSV, JSON 중 제휴사가 다루기 편한 형식을 선택해 주세요. CSV 에서 isbn_list 같은 배열 필드는 ; 등 단일 문자로 구분해 주시면 됩니다 (구분자는 협의 가능합니다).

예시

item_code,item_name,product_type,isbn_list,valid_period
BOOK_TOEIC_2026,토익 실전 2026,book,9791234567890,
PKG_TOEIC_FULL,토익 풀패키지(LC+RC+해설),package,9791234567890;9791234567891;9791234567892,
SET_TOEIC_PAPER_EBOOK,토익 실전 종이+전자 세트,package,9791234567890,
LEC_GRAMMAR_01,기초 문법 강의,lecture,,P1Y

[
  { "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"] },
  { "item_code": "SET_TOEIC_PAPER_EBOOK", "item_name": "토익 실전 종이+전자 세트", "product_type": "package", "isbn_list": ["9791234567890"] },
  { "item_code": "LEC_GRAMMAR_01", "item_name": "기초 문법 강의", "product_type": "lecture", "valid_period": "P1Y" }
]

필드를 추가하거나 다르게 구성하셔도 무방합니다. 매핑은 쏠브 측에서 책임지고 진행하며, 모호한 부분은 협의해 보강합니다.

업데이트 방법

• 출시 전에 전체 카탈로그를 한 번 전달해 주세요.
• 신상품을 추가할 때마다 해당 item_code 를 카탈로그에 함께 반영해 주세요. 카탈로그에 없는 상품은 쏠브에서 권한을 부여하지 못합니다.

관련 문서

• 구매내역 API · 테스트와 출시