상품 카탈로그

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

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

스키마

필수 필드

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

옵셔널 필드 (제휴사가 자유롭게 추가하실 수 있는 샘플)

아래 필드는 예시입니다. 제휴사 사정에 맞게 빼거나 다른 필드를 추가하셔도 됩니다. 매핑 정확도가 올라가도록 충분한 정보를 담아 주시면 됩니다.

• product_type · string · 옵셔널 — book, lecture 등 상품 유형 (샘플).
• identifier · string · 옵셔널 — ISBN, 강의 ID 같은 식별자 (샘플).
• valid_period · string · 옵셔널 — 유효기간 (샘플).

CSV 와 JSON 모두 받습니다. 형식은 제휴사가 다루기 편한 쪽을 선택해 주세요.

item_code,item_name,product_type,identifier,valid_period
BOOK_TOEIC_2026,토익 실전 2026,book,9791234567890,
LEC_GRAMMAR_01,기초 문법 강의,lecture,LEC-G-01,P1Y

[
  { "item_code": "BOOK_TOEIC_2026", "item_name": "토익 실전 2026", "product_type": "book", "identifier": "9791234567890" },
  { "item_code": "LEC_GRAMMAR_01", "item_name": "기초 문법 강의", "product_type": "lecture", "identifier": "LEC-G-01", "valid_period": "P1Y" }
]

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

업데이트 방법

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

관련 문서

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