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

# Pacote

> Liste e obtenha os pacotes de um jogo do Partner Center, verifique se um build pode ser usado em um playtest e descubra como carregar um pacote.

Um pacote é um build de um jogo que o Partner Center recebeu e processou. Os comandos `package`
listam e obtêm os pacotes de um jogo, para que você possa verificar se um deles está pronto para um
[playtest](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playtest.md). Para carregar um pacote, consulte [Carregar pacotes](#uploading-packages).

Esses comandos são Experimentais: suas opções e sua saída podem mudar. Consulte
[Comandos experimentais](https://docs.xbox.com/pt-BR/tools/xbox-cli/cli-command-lifecycle.md). Eles precisam da permissão Packages Read
do Partner Center no jogo, que a função Developer inclui.

## Comandos

| Comando | Descrição |
| - | - |
| `package list` | Lista os pacotes do branch Main do jogo. |
| `package get <package-id>` | Obtém um pacote. |

## Argumentos e opções

| Argumento ou opção | Aplica-se a | Obrigatório | Descrição |
| - | - | - | - |
| `<package-id>` | `get` | Sim | ID do pacote, de `package list`. |
| `--store-id <id>` | todos | Uma das duas | ID da Store do jogo, como `9N0000000000`. |
| `--xbox-title-id <id>` | todos | Uma das duas | ID de título do XBOX do jogo, e não sua ID de título do PlayFab, como `1234ABCD`. Quando a ID de título tem vários jogos, o comando solicita `--store-id`. |
| `--seller-id <id>` | todos | Não | ID do vendedor no Partner Center. |
| `--base-url <url>` | todos | Não | URL base das solicitações, que substitui a chave de configuração `XboxPartner:BaseUrl`. |
| `--output <format>` | todos | Não | `json` (padrão), `json-compact` ou `table`. |

O vendedor vem de `--seller-id` ou do vendedor salvo; consulte [Contexto](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context.md). Sem
nenhum deles, os comandos usam seu único vendedor e solicitam `--seller-id` quando você pertence a vários.
`--xbox-title-id` sempre precisa de um vendedor.

## Listar pacotes

```bash theme={null}
xbox package list --store-id 9N0000000000 --output json-compact
```

`package list` grava a ID do branch Main do jogo e uma matriz `packages` com todos os campos
que o serviço retorna. `package get` grava um pacote no mesmo formato. Um trecho:

```json theme={null}
{
  "packageSetId": "22222222-3333-4444-5555-666666666666",
  "packages": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "version": "1.0.0.0",
      "platform": "PC",
      "packageType": "Msixvc",
      "processingState": "Processed",
      "isAvailableForPlaytest": true,
      "validationItems": [],
      "fileName": "Nod.Arena_1.0.0.0_x64.msixvc",
      "createdAt": "2026-11-04T18:00:00Z"
    }
  ]
}
```

Um pacote está pronto para um playtest quando todas estas condições são verdadeiras:

* `processingState` é `Processed`. Ele passa de `PendingUpload` por `Uploaded` e
  `Processing` até `Processed` ou `ProcessFailed`.
* `validationItems`, os problemas que o Partner Center encontrou ao processar o pacote, não tem nenhum item
  com gravidade `Error`.
* `isAvailableForPlaytest` é `true`.

`--output table` tem as colunas `PACKAGE ID`, `VERSION`, `PLATFORM`, `STATE`, `PLAYTEST` e `CREATED`.
Ela não mostra os resultados da validação; portanto, verifique `validationItems` no JSON.

## Carregar pacotes

A CLI não carrega pacotes. Carregue-os com `makepkg` do XBOX Game Development Kit
(GDK); consulte a
[referência do makepkg](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/deployment/makepkg)
e, para carregamentos a partir de integração contínua (CI), o
[Package Uploader](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/package-uploader).
Em seguida, execute `package list` para verificar se o pacote está pronto.

## Erros

Os erros vão para stderr como texto, qualquer que seja o valor de `--output`, com a ID de correlação. `--verbose` adiciona
o corpo da resposta. Uma falha sai com `1`.

| Erro | O que fazer |
| - | - |
| HTTP 401 | Entre novamente com `xbox auth login`. |
| HTTP 403, `package_permission_denied` | Você não tem a permissão Packages Read no jogo para este vendedor. Peça a função Developer a um gerente da conta do Partner Center ou passe `--seller-id` se o jogo pertencer a outro vendedor. |
| HTTP 403, `identity_override_not_authorized` | Você não pertence a esse vendedor. Verifique o vendedor e encontre os seus com `xbox seller list`. |
| HTTP 400, `seller_selection_required` | Você pertence a vários vendedores. Passe `--seller-id`. |
| HTTP 404, `game_not_found` | O vendedor não tem nenhum jogo com essa ID da Store. Verifique `--store-id` e `--seller-id`. |

## Exemplos

```bash theme={null}
xbox package list --store-id 9N0000000000
xbox package list --xbox-title-id 1234ABCD --seller-id 1234567 --output table
xbox package get 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```


## Related topics

- [Pacotes](https://docs.xbox.com/pt-BR/publishing/game-publishing/concepts/game-package-management.md)
- [Pacotes (experiência clássica)](https://docs.xbox.com/pt-BR/publishing/game-publishing/concepts/packages-overview.md)
- [Pacotes e passes de temporada](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-bundles-season-passes.md)
- [Pacotes do Economy v2](https://docs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/bundles.md)
- [Criar pacote (makepkg.exe)](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/deployment/makepkg.md)
