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

# Economy

> Inspecciona y modifica los elementos del inventario, las colecciones y las transacciones de Economy v2, y ejecuta operaciones de inventario por lotes.

Lee y cambia el inventario de PlayFab Economy v2 con `playfab economy inventory`, incluidas
las colecciones, el historial de transacciones y las operaciones de inventario por lotes.

Los comandos de inventario actúan sobre la entidad que realiza la llamada, a menos que pases tanto `--entity-id` como
`--entity-type`. Para un jugador, pasa su identificador de cuenta de jugador de título con
`--entity-type title_player_account`, no su identificador de cuenta de jugador maestra;
[`playfab player account get`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/player) lo devuelve como
`UserInfo.TitleInfo.TitlePlayerAccount.Id`. `--collection-id` selecciona una colección de inventario
distinta de `default`.

`operation execute` rechaza un lote que contiene una operación `Delete` a menos que pases
`--confirm` (`--yes`, `-y`), incluso en un terminal. Los demás cambios de inventario se ejecutan sin preguntar.
Consulta [Seguridad y operaciones destructivas](https://docs.xbox.com/es/tools/xbox-cli/safety.md).

## Elementos del inventario

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab economy inventory list` | `/Inventory/GetInventoryItems` | `--entity-id`, `--entity-type`, `--collection-id`, `--limit`, `--continuation-token` y `--filter` opcionales. |
| `playfab economy inventory add` | `/Inventory/AddInventoryItems` | `--entity-id`, `--entity-type`, `--collection-id` e `--idempotency-id` opcionales. El elemento: `--item-id` con `--stack-id` opcional, o un objeto JSON `InventoryItemReference` con `--item`. `--amount` establece la cantidad. |

* `inventory list` devuelve una página de `--limit` elementos, 10 de forma predeterminada. Para obtener la página siguiente,
  pasa el token de continuación de la respuesta con `--continuation-token`.
* `--filter` es un filtro de OData sobre las propiedades de elemento `type`, `id` y `stackId`.
* `inventory add` devuelve `ETag`, `IdempotencyId` y los `TransactionIds` que registró, no
  el inventario modificado. Ejecuta `inventory list` para ver el resultado.

## Colecciones del inventario

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab economy inventory collection list` | `/Inventory/GetInventoryCollectionIds` | `--entity-id`, `--entity-type`, `--limit` y `--continuation-token` opcionales. |

## Operaciones de inventario

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab economy inventory operation execute` | `/Inventory/ExecuteInventoryOperations` | `--entity-id`, `--entity-type`, `--collection-id` e `--idempotency-id` opcionales. Las operaciones, como una matriz JSON, con exactamente una de `--operations` o `--operations-file`. |
| `playfab economy inventory operation status` | `/Inventory/GetInventoryOperationStatus` | `--operation-token` (obligatoria); `--entity-id` y `--entity-type` de la entidad que entregó los elementos; `--collection-id` opcional. |

`operation execute` ejecuta el lote como una sola transacción. Al igual que `inventory add`, devuelve
`ETag`, `IdempotencyId` y `TransactionIds` para todo el lote. Ejecuta `inventory list` o
`inventory transaction list` para ver lo que hizo.

`operation status` comprueba una transferencia de inventario que no había terminado cuando se devolvió su
solicitud. `TransferInventoryItems` y `ExecuteTransferOperations` devuelven un
`OperationToken` mientras su `OperationStatus` es `InProgress`; pasa ese token y el
`GivingEntity` de la transferencia como `--entity-id` y `--entity-type`. La CLI no tiene ningún comando para
esas API de transferencia, así que llámalas con [`playfab api`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/api). Un identificador de transacción no es un
token de operación, y PlayFab lo rechaza con `Bad OperationToken.`

## Transacciones de inventario

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab economy inventory transaction list` | `/Inventory/GetTransactionHistory` | `--entity-id`, `--entity-type`, `--collection-id`, `--limit`, `--continuation-token`, `--filter` y `--order-by` opcionales. |

`--filter` puede hacer referencia a `timestamp`, `transactionid`, `apiname` y `operationtype`.
`--order-by` acepta `timestamp asc` o `timestamp desc`.

## Salida en tabla

Estos comandos aceptan `--output table`; `inventory add` y `operation execute` no. Consulta
[Salida en tabla](https://docs.xbox.com/es/tools/xbox-cli/commands.md#table-output).

| Comando | Columnas |
| - | - |
| `playfab economy inventory list` | `ID`, `TYPE`, `STACK`, `AMOUNT` |
| `playfab economy inventory collection list` | `COLLECTION ID` |
| `playfab economy inventory transaction list` | `TRANSACTION ID`, `TIMESTAMP`, `API`, `OPERATION` |
| `playfab economy inventory operation status` | `STATUS` |

Una tabla no muestra el token de continuación, así que usa la salida JSON para pasar de la primera
página.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory list --entity-id TITLEPLAYER123 --entity-type title_player_account --output table
```

```text theme={null}
ID                                    TYPE      STACK    AMOUNT
------------------------------------  --------  -------  ------
11111111-2222-3333-4444-555555555555  currency  default  500
22222222-3333-4444-5555-666666666666  bundle    default  1
```

## Ejemplos

Leer el inventario, las colecciones y el historial de transacciones de un jugador:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory list --entity-id TITLEPLAYER123 --entity-type title_player_account --limit 50 --data-only --output json-compact
xbox --playfab-title-id ABC123 playfab economy inventory collection list --entity-id TITLEPLAYER123 --entity-type title_player_account
xbox --playfab-title-id ABC123 playfab economy inventory transaction list --entity-id TITLEPLAYER123 --entity-type title_player_account --order-by "timestamp desc"
```

Agregar una unidad de un elemento al inventario de un jugador:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory add --entity-id TITLEPLAYER123 --entity-type title_player_account --item-id 11111111-2222-3333-4444-555555555555 --amount 1 --idempotency-id 22222222-3333-4444-5555-666666666666
```

Ejecutar un lote de operaciones de inventario desde `ops.json`:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory operation execute --entity-id TITLEPLAYER123 --entity-type title_player_account --operations-file ops.json --idempotency-id 33333333-4444-5555-6666-777777777777
```

Si `ops.json` contiene una operación `Delete`, agrega `--confirm`:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory operation execute --entity-id TITLEPLAYER123 --entity-type title_player_account --operations-file ops.json --confirm
```

Comprobar una transferencia que devolvió `"OperationStatus": "InProgress"`, con el
`OperationToken` de su respuesta y el jugador que entregó los elementos:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory operation status --entity-id TITLEPLAYER123 --entity-type title_player_account --operation-token OPERATIONTOKEN123
```


## Related topics

- [Lotes de Economy v2](https://docs.xbox.com/es/services/playfab/economy-monetization/economy-v2/catalog/bundles.md)
- [Tiendas de Economy v2](https://docs.xbox.com/es/services/playfab/economy-monetization/economy-v2/catalog/stores.md)
- [Suscripciones de Economy v2](https://docs.xbox.com/es/services/playfab/economy-monetization/economy-v2/catalog/subscriptions.md)
- [Límites de Economy V2](https://docs.xbox.com/es/services/playfab/economy-monetization/economy-v2/limits.md)
- [Localización de Economy v2](https://docs.xbox.com/es/services/playfab/economy-monetization/economy-v2/catalog/localization.md)
