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

# Paquete

> Enumera y obtén los paquetes de un juego de Partner Center, comprueba si una compilación se puede usar en un playtest y descubre cómo cargar una.

Un paquete es una compilación de un juego que Partner Center ha recibido y procesado. Los comandos `package`
enumeran y obtienen los paquetes de un juego, para que puedas comprobar si uno está listo para un
[playtest](https://docs.xbox.com/es/tools/xbox-cli/commands/playtest.md). Para cargar un paquete, consulta [Carga de paquetes](#uploading-packages).

Estos comandos son experimentales: sus opciones y su salida pueden cambiar. Consulta
[Comandos experimentales](https://docs.xbox.com/es/tools/xbox-cli/cli-command-lifecycle.md). Necesitan el permiso de lectura de paquetes de Partner Center
en el juego, que se incluye en el rol de desarrollador.

## Comandos

| Comando | Descripción |
| - | - |
| `package list` | Enumera los paquetes de la rama Main del juego. |
| `package get <package-id>` | Obtiene un paquete. |

## Argumentos y opciones

| Argumento u opción | Se aplica a | Obligatorio | Descripción |
| - | - | - | - |
| `<package-id>` | `get` | Sí | Identificador del paquete, de `package list`. |
| `--store-id <id>` | todos | Uno de los dos | Identificador de Store del juego, como `9N0000000000`. |
| `--xbox-title-id <id>` | todos | Uno de los dos | Identificador de título de XBOX del juego, no su identificador de título de PlayFab, como `1234ABCD`. Cuando el identificador de título tiene varios juegos, el comando pide `--store-id`. |
| `--seller-id <id>` | todos | No | Identificador de vendedor de Partner Center. |
| `--base-url <url>` | todos | No | URL base de las solicitudes, que invalida la clave de configuración `XboxPartner:BaseUrl`. |
| `--output <format>` | todos | No | `json` (predeterminado), `json-compact` o `table`. |

El vendedor procede de `--seller-id` o de tu vendedor guardado; consulta [Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md). Sin
ninguno, los comandos usan tu único vendedor y piden `--seller-id` cuando perteneces a varios.
`--xbox-title-id` siempre necesita un vendedor.

## Enumeración de paquetes

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

`package list` escribe el identificador de la rama Main del juego y una matriz `packages` con todos los campos
que devuelve el servicio. `package get` escribe un paquete con la misma forma. Un fragmento:

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

Un paquete está listo para un playtest cuando se cumple todo lo siguiente:

* `processingState` es `Processed`. Pasa de `PendingUpload` por `Uploaded` y
  `Processing` a `Processed`, o a `ProcessFailed`.
* `validationItems`, los problemas que Partner Center encontró al procesar el paquete, no tiene ningún elemento
  con gravedad `Error`.
* `isAvailableForPlaytest` es `true`.

`--output table` tiene las columnas `PACKAGE ID`, `VERSION`, `PLATFORM`, `STATE`, `PLAYTEST` y `CREATED`.
No muestra los resultados de la validación, así que comprueba `validationItems` en JSON.

## Carga de paquetes

La CLI no carga paquetes. Cárgalos con `makepkg` del XBOX Game Development Kit
(GDK); consulta la
[referencia de makepkg](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/deployment/makepkg)
y, para cargas desde la integración continua (CI),
[Package Uploader](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/package-uploader).
Después, ejecuta `package list` para comprobar que el paquete está listo.

## Errores

Los errores van a stderr como texto, sea cual sea `--output`, con el identificador de correlación. `--verbose` agrega
el cuerpo de la respuesta. Un error sale con `1`.

| Error | Qué hacer |
| - | - |
| HTTP 401 | Vuelve a iniciar sesión con `xbox auth login`. |
| HTTP 403, `package_permission_denied` | No tienes el permiso de lectura de paquetes en el juego para este vendedor. Pide el rol de desarrollador a un administrador de la cuenta de Partner Center, o pasa `--seller-id` si el juego pertenece a otro vendedor. |
| HTTP 403, `identity_override_not_authorized` | No perteneces a ese vendedor. Comprueba el vendedor y busca los tuyos con `xbox seller list`. |
| HTTP 400, `seller_selection_required` | Perteneces a varios vendedores. Pasa `--seller-id`. |
| HTTP 404, `game_not_found` | El vendedor no tiene ningún juego con ese identificador de Store. Comprueba `--store-id` y `--seller-id`. |

## Ejemplos

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

- [Paquetes](https://docs.xbox.com/es/publishing/game-publishing/concepts/game-package-management.md)
- [Paquetes (experiencia clásica)](https://docs.xbox.com/es/publishing/game-publishing/concepts/packages-overview.md)
- [Configuración avanzada para paquetes](https://docs.xbox.com/es/publishing/game-publishing/how-to/how-to-manage-advanced-settings-for-packages.md)
- [Administrar paquetes (wdapp.exe)](https://docs.xbox.com/es/tools/tools-console/console_commandlinetools/wdapp.md)
- [Paquetes de Publisher Content](https://docs.xbox.com/es/build/core-features/common/packaging/packaging-publisher-content.md)
