> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/webshop/register-item.md).

# 카탈로그

웹샵에서 판매할 상품을 구성하는 메뉴예요. 게임 내 재화·아이템을 에셋으로 등록한 뒤, 실제 판매 단위인 아이템으로 만들어 웹샵에 노출할 수 있어요.

* **에셋이란?** 게임 내 재화나 아이템의 원형을 등록해요.
* **아이템이란?** 웹샵에서 판매할 상품을 만들고 가격·전시 정보를 관리해요.

***

## 에셋 <a href="#id-1" id="id-1"></a>

게임 내 에셋을 생성하고 관리해요. 아이템에 연결하면 웹샵에서 판매할 수 있어요.

<div data-with-frame="true"><figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2Fi90dJY7HRsEnFkgIZFJX%2Fimage.png?alt=media&amp;token=84cb2151-1a19-4eda-bf59-03218fe35bdb" alt=""><figcaption></figcaption></figure></div>

### 에셋 생성

**에셋 이름** (필수) 에셋을 구분할 이름을 입력해요.

**이미지** 에셋의 대표 이미지나 아이콘을 업로드해요. JPG·PNG, 최대 1MB.

**설명** 에셋에 대한 설명을 입력해요.

| 항목     | 용도              | 해상도       | 포맷       | 용량     |
| ------ | --------------- | --------- | -------- | ------ |
| 에셋 아이콘 | 목록·검색에서 타이틀을 식별 | 512×512px | JPG, PNG | 최대 1MB |

<details>

<summary>ℹ️ 이미지 제작 가이드라인</summary>

이미지 제작 시 이미지 제작 [이미지 제작 가이드라인](/dev/tools/icon-guide.md)을 참고해 주세요.

</details>

***

## 아이템 <a href="#id-1" id="id-1"></a>

웹샵에서 판매할 아이템을 등록하고 가격·전시 정보를 관리해요.

### 아이템 목록

아이템은 상태별로 **전체 / 등록중 / 판매중 / 판매중지 / 판매불가** 탭에서 확인할 수 있고, 이름 또는 아이템ID로 검색할 수 있어요. 목록에는 상품 이름, 아이템ID, 가격, 업데이트 일자, 상태가 표시돼요.

<div data-with-frame="true"><figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FE39fPux7d7Q2sNLVX31z%2Fimage.png?alt=media&amp;token=0b284f12-9d74-4145-8e22-77869bf98f0c" alt=""><figcaption></figcaption></figure></div>

### 아이템 만들기

**아이템ID** (필수) 숫자 또는 소문자로 시작해야 하며, 숫자(0~~9)·소문자(a~~z)·밑줄(\_)·마침표(.)를 포함할 수 있어요. 최대 255자이며, **저장 후에는 변경할 수 없어요.** 예: `gem_100`, `sword_legendary`, `monthly_pass`

<div data-with-frame="true"><figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FfXHdW9xyx5sK11qLMDaS%2Fimage.png?alt=media&amp;token=9dab8bca-1e80-4646-8766-b4b8880ebc9c" alt=""><figcaption></figcaption></figure></div>

#### 상품 기본 정보

**상품 이미지** 웹샵 상품 카드에 표시되는 이미지예요. JPG·PNG·GIF·WebP, 최대 2MB.

**이름** (필수, 최대 50자) / **설명** (필수, 최대 300자) 사용자에게 노출되는 상품명과 설명이에요.

#### 상품 세부 정보

**아이템 속성** (필수) 아이템의 종류를 선택해요.

**가격설정** (필수) 기준 가격을 입력해요. **통화 관리**에서 설정한 국가는 여기서 국가별 현지가격을 직접 정할 수 있고, 따로 설정하지 않은 국가는 기준가를 환율로 자동 계산한 금액이 그대로 적용돼요.

**할인율(%)** 0을 입력하면 할인이 없어요. 할인율을 설정하면 웹샵에 원가와 할인가가 함께 표시돼요.

**확률형 아이템 포함 여부** (필수) 포함 / 미포함 중 선택해요.

#### 구성 에셋 (선택 사항)

이 상품에 다른 아이템을 묶어서 포함시킬 수 있어요. (예: 번들 구성)

#### 다중 수량 구매

켜면 한 번에 최대 10개까지, 끄면 1개만 구매할 수 있어요.

{% hint style="info" %}
다만 실제 구매 가능한 최대 수량은 국가별 최대 결제 금액 기준에 따라 10개보다 더 낮게 제한될 수 있어요. 총 결제 금액이 해당 국가의 최대 결제 금액을 넘지 않는 범위에서만 구매할 수 있기 때문이에요.

**예시**: 다중 수량 구매를 10개로 설정했더라도, 아이템 가격이 50만 원이고 해당 국가의 최대 결제 금액이 200만 원이면, 유저의 구매 팝업에는 최대 구매 수량이 **4개** (50만 원 × 4 = 200만 원)까지만 표시돼요.
{% endhint %}