> ## 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.
# Guía de inicio rápido del inventario del jugador
> Use el SDK beta de PlayFab para autenticar a un jugador, buscar en el catálogo, comprar un artículo y comprobar que aparece en el inventario de Economy v2 del jugador.
# Inicio rápido: Adición del primer artículo al inventario de un jugador
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).
Familiarícese con los inventarios de jugador usando el SDK beta de PlayFab para comprar un artículo y comprobar que se agregó al inventario de su jugador. Después de obtener un token de entidad para interactuar con el título mediante las API, buscará un artículo en el catálogo, lo comprará y, a continuación, obtendrá el inventario del jugador para encontrar el artículo comprado.
## Requisitos previos
* Una [cuenta de desarrollador de PlayFab](https://developer.playfab.com)
* El SDK beta de PlayFab (puede encontrar más información en la [guía de inicio rápido de Postman](/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections))
* Al menos un artículo en el catálogo (puede encontrar más información en la [guía de inicio rápido de Economy v2](/services/playfab/economy-monetization/economy-v2/quickstart))
* Al menos un jugador con suficiente moneda virtual para comprar un artículo
## Inicio de sesión como el jugador
Primero debe iniciar la sesión del jugador para recibir el token de seguridad necesario para el resto de las llamadas a la API de esta guía de inicio rápido. Puede encontrar más información en la página de [autenticación de jugadores](/services/playfab/identity/player-identity/login).
## Búsqueda del artículo
Para encontrar el artículo en el catálogo, llame a `Search`. En el cuerpo de la llamada:
```json theme={null}
{
"Search": "[Item Title]",
"Top": 1
}
```
* `Search` es la cadena de búsqueda con la que se realiza una búsqueda aproximada en el título, la descripción y las palabras clave de cada artículo del catálogo
* `Top` es un entero que determina cuántos resultados se devuelven; en este caso, solo necesitamos uno
Hay más campos sobre los que puede obtener información en la [guía de inicio rápido de búsqueda](/services/playfab/economy-monetization/economy-v2/catalog/search).
En la respuesta, tome los campos siguientes:
* `Items` > `Id`: identificador de catálogo del artículo
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `ItemId`: identificador de la moneda virtual usada para comprar el artículo
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `Amount`: cantidad de la moneda virtual necesaria para comprar el artículo
Solo las entidades de título pueden establecer precios para los artículos.
## Compra del artículo
Para comprar el artículo, llame a `PurchaseInventoryItems`. En el cuerpo de la llamada:
```json theme={null}
{
"Item": {
"Id": "{{ItemID}}",
},
"Amount": 1,
"PriceAmounts": [
{
"ItemId": "{{CurrencyId}}",
"Amount": 15
}
]
}
```
* `Item.Id` es el identificador del artículo (obtenido de la respuesta de `Search` en el paso anterior)
* `Amount` es el número de artículos que el jugador está comprando
* `ItemId` es el identificador de la moneda virtual usada para comprar el artículo (obtenido de la respuesta de `Search` en el paso anterior)
* `Amount` es la cantidad de la moneda virtual necesaria para comprar el artículo (obtenida de la respuesta de `Search` en el paso anterior)
## Obtención de los artículos del inventario del jugador
Vea el artículo recién comprado del jugador mediante `GetInventoryItems`. En la llamada, asegúrese de que el cuerpo esté vacío: puede especificar la entidad en el cuerpo, pero no es necesario, ya que la información ya se pasa a través del token de entidad en el encabezado.
La respuesta contiene los identificadores de cada artículo que posee el jugador y la cantidad de cada artículo. El artículo recién comprado está en el inventario del jugador.
Si el jugador ya tiene ese artículo en su inventario con el mismo `StackId`, no verá otra instancia del artículo después de la compra; en su lugar, verá que el campo `Amount` aumenta.
## Solución de problemas
* Fondos insuficientes
* Si llama a `PurchaseInventoryItems` y recibe un error `422: InsufficientFunds`, el jugador no tiene suficiente moneda virtual para comprar el artículo. Puede conceder moneda virtual al jugador llamando a `AddInventoryItems` (requiere un token de entidad de título) o yendo a **\[Title]** > **Players** > **\[Player]** > **`Inventory (V2)`** en Game Manager.
* El artículo no se puede comprar al precio especificado.
* Si llama a `PurchaseInventoryItems` y recibe un código de error `1071`, el campo `PriceAmounts` no coincide con los precios especificados en el catálogo.
## Pasos siguientes
Ahora que ha comprado el primer artículo del jugador, puede consumir el artículo, agregarlo a una tienda para ponerlo a la venta, y crear y comprar un paquete que contenga el artículo.
\[!div class="nextstepaction"] [Tutorial de inventario del jugador](/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android)
\[!div class="nextstepaction"] [Tiendas](/services/playfab/economy-monetization/economy-v2/catalog/stores)
\[!div class="nextstepaction"] [Paquetes](/services/playfab/economy-monetization/economy-v2/catalog/bundles)
## Related topics
- [Inicio rápido de datos del jugador](/es/services/playfab/player-progression/player-data/quickstart.md)
- [Inicio rápido (Windows): configuración del SDK de Core](/es/services/playfab/sdks/unified-sdk/quickstart-core.md)
- [Inicio rápido del complemento de Party para Unity](/es/services/playfab/multiplayer/networking/party-unity-plugin-quickstart.md)
- [Inicio rápido de datos del título](/es/services/playfab/live-service-management/game-configuration/titledata/quickstart.md)
- [Inicio rápido del complemento de Unity de Multiplayer](/es/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-plugin-quickstart.md)