# 핵심 엔티티 구조 
모든 유형의 아이템(가상 아이템, 번들, 인게임 재화, 키)은 유사한 데이터 구조를 사용합니다. 기본 구조를 이해하면 API 작업이 간소화되고 문서를 더 쉽게 탐색할 수 있습니다.
<div class="note"><b>참고</b><br><br>일부 호출에는 추가 입력란이 포함될 수 있지만 기본 구조는 변경되지 않습니다.</div>
**식별**
- `merchant_id`- [관리자 페이지](https://publisher.xsolla.com/)의 회사 ID
- `project_id` - 관리자 페이지의 프로젝트 ID
- `sku` - 프로젝트 내의 고유한 아이템 SKU

**Store display**
- `name` - 아이템 이름
- `description` - 아이템 설명
- `image_url` - 이미지 URL
- `is_enabled` - 아이템 가용성
- `is_show_in_store` - 카탈로그에 아이템이 표시되는지 여부

카탈로그에서 아이템 가용성 관리에 대한 자세한 정보는 [문서](/ko/items-catalog/catalog-features/items-availability/)를 참조하세요.
**Organization**
- `type` - 아이템 유형, 예를 들어 가상 아이템(`virtual_item`) 또는 번들(`bundle`)
- `groups` - 아이템이 속한 그룹
- `order` - 카탈로그 내 디스플레이 순서

**판매 조건**
- `prices` - 실제 화폐 또는 인게임 재화로 된 가격
- `limits` - 구매 한도
- `periods` - 가용 기간
- `regions` - 지역 제한

**핵심 엔티티 구조 예시:**

```json
{
  "attributes": [],
  "bundle_type": "virtual_currency_package",
  "content": [
    {
      "description": {
        "en": "Main in-game currency"
      },
      "image_url": "https://.../image.png",
      "name": {
        "en": "Crystals",
        "de": "Kristalle"
      },
      "quantity": 500,
      "sku": "com.xsolla.crystal_2",
      "type": "virtual_currency"
    }
  ],
  "description": {
    "en": "Crystals x500"
  },
  "groups": [],
  "image_url": "https://.../image.png",
  "is_enabled": true,
  "is_free": false,
  "is_show_in_store": true,
  "limits": {
    "per_item": null,
    "per_user": null,
    "recurrent_schedule": null
  },
  "long_description": null,
  "media_list": [],
  "name": {
    "en": "Medium crystal pack"
  },
  "order": 1,
  "periods": [
    {
      "date_from": null,
      "date_until": "2020-08-11T20:00:00+03:00"
    }
  ],
  "prices": [
    {
      "amount": 20,
      "country_iso": "US",
      "currency": "USD",
      "is_default": true,
      "is_enabled": true
    }
  ],
  "regions": [],
  "sku": "com.xsolla.crystal_pack_2",
  "type": "bundle",
  "vc_prices": []
}
```