> ## 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

> Inspecione e modifique itens, coleções e transações de inventário do Economy v2 e execute operações de inventário em lote.

Leia e altere o inventário do PlayFab Economy v2 com `playfab economy inventory`, incluindo
coleções, histórico de transações e operações de inventário em lote.

Os comandos de inventário têm como destino a entidade chamadora, a menos que você passe `--entity-id` e
`--entity-type`. Para um jogador, passe a ID da conta de jogador do título dele com
`--entity-type title_player_account`, e não a ID da conta de jogador mestre;
[`playfab player account get`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab/player) a retorna como
`UserInfo.TitleInfo.TitlePlayerAccount.Id`. `--collection-id` seleciona uma coleção de inventário
diferente de `default`.

`operation execute` recusa um lote que contenha uma operação `Delete`, a menos que você passe
`--confirm` (`--yes`, `-y`), mesmo em um terminal. As outras alterações de inventário são executadas sem perguntar.
Consulte [Segurança e operações destrutivas](https://docs.xbox.com/pt-BR/tools/xbox-cli/safety.md).

## Itens de inventário

| Comando | Caminho da API do PlayFab | Opções |
| - | - | - |
| `playfab economy inventory list` | `/Inventory/GetInventoryItems` | `--entity-id`, `--entity-type`, `--collection-id`, `--limit`, `--continuation-token`, `--filter` opcionais. |
| `playfab economy inventory add` | `/Inventory/AddInventoryItems` | `--entity-id`, `--entity-type`, `--collection-id`, `--idempotency-id` opcionais. O item: `--item-id` com `--stack-id` opcional, ou um objeto JSON `InventoryItemReference` com `--item`. `--amount` define a quantidade. |

* `inventory list` retorna uma página de `--limit` itens, 10 por padrão. Para obter a próxima página,
  passe o token de continuação da resposta com `--continuation-token`.
* `--filter` é um filtro OData sobre as propriedades de item `type`, `id` e `stackId`.
* `inventory add` retorna `ETag`, `IdempotencyId` e as `TransactionIds` que registrou, e não
  o inventário alterado. Execute `inventory list` para ver o resultado.

## Coleções de inventário

| Comando | Caminho da API do PlayFab | Opções |
| - | - | - |
| `playfab economy inventory collection list` | `/Inventory/GetInventoryCollectionIds` | `--entity-id`, `--entity-type`, `--limit`, `--continuation-token` opcionais. |

## Operações de inventário

| Comando | Caminho da API do PlayFab | Opções |
| - | - | - |
| `playfab economy inventory operation execute` | `/Inventory/ExecuteInventoryOperations` | `--entity-id`, `--entity-type`, `--collection-id`, `--idempotency-id` opcionais. As operações, como uma matriz JSON, com exatamente uma entre `--operations` ou `--operations-file`. |
| `playfab economy inventory operation status` | `/Inventory/GetInventoryOperationStatus` | `--operation-token` (obrigatória); `--entity-id` e `--entity-type` da entidade que deu os itens; `--collection-id` opcional. |

`operation execute` executa o lote como uma única transação. Assim como `inventory add`, ele retorna
`ETag`, `IdempotencyId` e `TransactionIds` para o lote inteiro. Execute `inventory list` ou
`inventory transaction list` para ver o que ele fez.

`operation status` verifica uma transferência de inventário que não havia terminado quando sua solicitação
retornou. `TransferInventoryItems` e `ExecuteTransferOperations` retornam um
`OperationToken` enquanto o `OperationStatus` deles é `InProgress`; passe esse token e a
`GivingEntity` da transferência como `--entity-id` e `--entity-type`. A CLI não tem nenhum comando para
essas APIs de transferência; portanto, chame-as com [`playfab api`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab/api). Uma ID de transação não é um
token de operação, e o PlayFab a rejeita com `Bad OperationToken.`

## Transações de inventário

| Comando | Caminho da API do PlayFab | Opções |
| - | - | - |
| `playfab economy inventory transaction list` | `/Inventory/GetTransactionHistory` | `--entity-id`, `--entity-type`, `--collection-id`, `--limit`, `--continuation-token`, `--filter`, `--order-by` opcionais. |

`--filter` pode se referir a `timestamp`, `transactionid`, `apiname` e `operationtype`.
`--order-by` aceita `timestamp asc` ou `timestamp desc`.

## Saída em tabela

Estes comandos aceitam `--output table`; `inventory add` e `operation execute` não. Consulte
[Saída em tabela](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands.md#table-output).

| Comando | Colunas |
| - | - |
| `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` |

Uma tabela não mostra o token de continuação; portanto, use a saída JSON para paginar além da primeira
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
```

## Exemplos

Ler o inventário, as coleções e o histórico de transações de um jogador:

```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"
```

Adicionar uma unidade de um item ao inventário de um jogador:

```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
```

Executar um lote de operações de inventário de `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
```

Se `ops.json` contiver uma operação `Delete`, adicione `--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
```

Verificar uma transferência que retornou `"OperationStatus": "InProgress"`, usando o
`OperationToken` da resposta dela e o jogador que deu os itens:

```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

- [Catálogos (Economy Legado)](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy/items/catalogs.md)
- [Lojas (Economy Legado)](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy/stores/index.md)
- [Itens (Economy Legado)](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy/items/index.md)
- [Limites do Economy V2](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/limits.md)
- [Assinaturas do Economy v2](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/subscriptions.md)
