# Structure de l'entité principale 
Les objets de tous types (objets virtuels, lots, monnaie virtuelle et clés) partagent une structure de données similaire. Comprendre cette structure de base facilite l’utilisation de l'API et la navigation dans la documentation.
<div class="note"><b>Note</b><br><br>Certains appels peuvent inclure des champs supplémentaires, mais ils ne modifient pas la structure de base.</div>
**Identification**
- `merchant_id` — ID de l'entreprise dans le [Compte éditeur](https://publisher.xsolla.com/)
- `project_id` — ID de projet dans le Compte éditeur
- `sku` — UGS de l'objet, unique au sein du projet

**Affichage en magasin**
- `name` — nom de l'objet
- `description` — description de l'objet
- `image_url` — URL de l'image
- `is_enabled` — disponibilité de l'objet
- `is_show_in_store` — affichage de l'objet dans le catalogue

Pour plus d'informations sur la gestion de la disponibilité des objets dans le catalogue, consultez la [documentation](/fr/items-catalog/catalog-features/items-availability/).
**Organisation**
- `type` — type d'objet, par exemple, un objet virtuel (`virtual_item`) ou un lot (`bundle`)
- `groups` — groupes auxquels l'objet appartient
- `order` — ordre d'affichage dans le catalogue

**Conditions de vente**
- `prices` — prix en devise réelle ou monnaie virtuelle
- `limits` — limites d'achat
- `periods` — périodes de disponibilité
- `regions` — restrictions régionales

**Exemple de structure d'entité principale :**

```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": []
}
```
