> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Información general sobre artículos e inventario

> Conozca los conceptos de catálogo e inventario de PlayFab Economy v2, incluidos los tipos de artículo, los paquetes, las tiendas, las monedas virtuales y el seguimiento de la propiedad de los jugadores.

# Información general sobre artículos e inventario de PlayFab

<Info>
  Economy v2 ya está disponible con carácter general. Para obtener soporte técnico y enviar comentarios, vaya al [foro de PlayFab](https://community.playfab.com).
</Info>

Los artículos y los inventarios son características esenciales para crear juegos atractivos e inmersivos. Le permiten ofrecer opciones de personalización, recompensas, sistemas de progresión y oportunidades de monetización a sus jugadores.

PlayFab Economy v2 proporciona una plataforma flexible y eficaz para crear y administrar bienes virtuales. Puede definir distintos tipos de artículos, como duraderos, consumibles, paquetes, suscripciones y monedas virtuales, y hacer un seguimiento de la propiedad y el uso de los artículos en los inventarios de los jugadores.

## Conceptos clave

* **Catálogo**: un catálogo es una colección de todos los artículos que están disponibles en el juego. Los catálogos ofrecen una manera sencilla de administrar los artículos virtuales del juego. Para obtener más información, consulte la [información general del catálogo](/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview).
* **Artículos de catálogo**: artículos individuales definidos en el catálogo. Pueden representar cualquier tipo de bien virtual, como armas, atuendos, potenciadores, cajas de botín, etc. Puede personalizar sus propiedades y comportamientos para adaptarlos al diseño del juego.
* **Tiendas de catálogo**: las tiendas le permiten crear varios listados de artículos para distintos fines, como eventos de temporada, promociones o pruebas. Consulte [Tiendas](/services/playfab/economy-monetization/economy-v2/catalog/stores).
* **Paquetes**: los paquetes son artículos de catálogo que contienen referencias a otros artículos. Cuando un jugador compra un paquete, los artículos referenciados se desempaquetan y se agregan a su inventario.
* **Suscripciones**: las suscripciones conceden acceso basado en tiempo a bienes duraderos. Los artículos de una suscripción están disponibles en el inventario de un jugador mientras dure la suscripción. Consulte [Suscripciones](/services/playfab/economy-monetization/economy-v2/catalog/subscriptions).
* **Colecciones de inventario del jugador**: el inventario es un registro de los artículos que un jugador posee en el juego. Contiene información sobre las cantidades de artículos, los saldos de moneda virtual y las propiedades personalizadas. Todas las cuentas de jugador pueden tener uno o varios inventarios denominados [colecciones](/services/playfab/economy-monetization/economy-v2/inventory/collections).
* **Pilas**: las pilas permiten que existan varias instancias distintas del mismo artículo dentro de un único inventario, cada una con su propia cantidad y propiedades personalizadas. Consulte [Pilas](/services/playfab/economy-monetization/economy-v2/inventory/stacks).
* **Moneda virtual**: la moneda virtual es un tipo de artículo que se usa como medio de intercambio en el juego. Puede usar la moneda virtual para comprar artículos del catálogo o de una tienda, implementar moneda blanda a partir de compras dentro de la aplicación o impulsar mecánicas de juego.

## API clave

Hay disponible un amplio conjunto de API para interactuar con los artículos y los inventarios del juego. Puede usar estas API para realizar acciones como comprar artículos, conceder artículos, actualizar el inventario, transferir artículos entre jugadores y consultar el historial de transacciones.

### Administración del inventario

* **[GetInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-inventory-items)**: recupera el inventario actual de una entidad. Admite la paginación con `ContinuationToken` y la carga masiva mediante [TurboLoading](/services/playfab/economy-monetization/economy-v2/inventory/turboloading).
* **[AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items)**: agrega artículos directamente al inventario de un jugador.
* **[SubtractInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/subtract-inventory-items)**: reduce las cantidades de artículos en el inventario de un jugador.
* **[UpdateInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/update-inventory-items)**: establece cantidades de artículos o modifica las [propiedades de presentación](/services/playfab/economy-monetization/economy-v2/inventory#display-properties) de los artículos del inventario.
* **[DeleteInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/delete-inventory-items)**: quita pilas completas de artículos del inventario de un jugador.

### Compra e intercambio

* **[PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items)**: compra artículos de catálogo o paquetes usando moneda virtual. Deduce la moneda del inventario del jugador y concede el artículo comprado.
* **[TransferInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/transfer-inventory-items)**: transfiere artículos entre jugadores, entre las colecciones de inventario de un jugador o entre pilas dentro del mismo inventario.

### Operaciones por lotes

* **[ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations)**: agrupa por lotes hasta 10 operaciones de inventario (Add, Subtract, Update, Purchase, Transfer, Delete) en una única solicitud atómica. Si alguna operación falla, se revierte todo el lote.

### Historial y diagnóstico

* **[GetTransactionHistory](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-transaction-history)**: recupera los eventos de transacciones del inventario de un jugador. Admite el filtrado por marca de tiempo y la paginación para revisar el historial completo de operaciones. Consulte [Historial de transacciones](/services/playfab/economy-monetization/economy-v2/inventory/transaction-history).

### Confiabilidad

* **Idempotencia**: todas las API de inventario admiten un parámetro `IdempotencyId` para reintentar solicitudes de forma segura sin efectos secundarios duplicados. Los identificadores se aplican durante 14 días. Consulte [Idempotencia](/services/playfab/economy-monetization/economy-v2/inventory#idempotency).

Para obtener la referencia completa de las API y ejemplos detallados de cada operación, consulte la [documentación de las API de inventario](/services/playfab/economy-monetization/economy-v2/inventory) y la [referencia de las API REST de PlayFab](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory).


## Related topics

- [Canje de marketplace: Información general](/es/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/overview.md)
- [Información general sobre discos](/es/publishing/game-publishing/concepts/discs-overview.md)
- [Información general sobre los eventos](/es/services/xbox-services/player-data/stats-leaderboards/event-based/events/live-game-events.md)
- [Información general sobre la configuración del portal](/es/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)
- [Inicio rápido](/es/services/playfab/economy-monetization/economy-v2/quickstart.md)
