> ## 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. # Herramienta de derechos de desarrollo de la Store (DevEntitlementTool.exe) > Herramienta de línea de comandos DevEntitlementTool.exe que consulta, agrega y quita derechos de la Microsoft Store en cuentas de prueba de XBOX en sandboxes de desarrollo. Herramienta de línea de comandos para consultar, agregar y quitar derechos de la Microsoft Store en cuentas de prueba de XBOX en sandbox. ## Uso `deventitlementtool /e /s [/p ] [...]` | Comando | Descripción | | ------------------- | ------------------------------------------------------------------------------------ | | [query](#query) | Busca los derechos que posee una cuenta | | [add](#add) | Agrega uno o varios derechos especificados a la cuenta | | [delete](#delete) | Elimina uno o varios derechos especificados de la cuenta | | [catalog](#catalog) | Muestra los productos disponibles que puede vender el producto primario especificado | Todos los comandos requieren los parámetros /e (correo electrónico) y /s (sandbox). El inicio de sesión inicial con una cuenta invoca un cuadro de diálogo interactivo para escribir la contraseña. Una vez que se ha iniciado sesión correctamente, las operaciones posteriores con la misma cuenta y sandbox en el dispositivo ya no requieren escribir la contraseña. ## query `deventitlementtool query /e /s [/d]` Enumera todos los derechos de propiedad directa asociados a esta cuenta en el sandbox. ### Salida de query ```text theme={null} Entitlements found: {Number of entitlements} {ProductID}: {Last Updated Date (UTC)} {Status} ... ``` ### Ejemplo de query ```text theme={null} > DevEntitlementTool.exe query /e xdks-testaccount00000@xboxtest.com /s XDKS.1 Entitlements found: 2 9MT5TGW893HV: 4/18/2023 5:05:19 PM Active 9N30KZZF4BR9: 7/24/2024 2:34:08 AM Active ``` Use /d para mostrar algunos detalles más de cada derecho: ```text theme={null} > DevEntitlementTool.exe query /e xdks-testaccount00000@xboxtest.com /s XDKS.1 /d Entitlements found: 2 9MT5TGW893HV: 4/18/2023 5:05:19 PM Active Consumable ATG Sample Consumable 3 9N30KZZF4BR9: 7/24/2024 2:34:08 AM Active Durable ATG Sample Durable 1 ``` ## add `deventitlementtool add /e /s /p [ ...] [/q ] [/d]` Agrega a la cuenta un derecho para uno o varios productos especificados. Este comando es el equivalente a comprar el producto en la Store o mediante la API de compra. La operación `add` con un juego, un durable, un lote (bundle) o un consumible administrado por el desarrollador que ya está concedido, no agrega otro derecho y la herramienta informa del derecho existente. Para los productos consumibles administrados por la Store, se agrega una cantidad predeterminada de `1` al saldo del consumible con cada comando add. Se puede especificar un valor de cantidad opcional para cambiar este valor predeterminado, pero el campo de cantidad solo puede usarse si se pasa un único productID con /p. Esta opción es útil para los consumibles que conceden una cantidad mayor que `1` al comprarse. Se admite /d para obtener más detalles. La cantidad no puede verificarse con esta herramienta. Para determinar la cantidad actual de un artículo, examine la estructura [XStoreCollectionData](/reference/system/xstore/structs/xstorecollectiondata). La operación `add` con un producto de tipo lote concede todos los productos que incluye. Si se especifica una cantidad y el lote incluye consumibles administrados por la Store, se asigna la misma cantidad a cada consumible. No se admiten los productos de suscripción. ### Salida de add ```console theme={null} Entitlements added: {Number of entitlements} {ProductID}: {Last Updated Date (UTC)} {Status} ... ``` ### Ejemplos de add Un solo derecho agregado ```console theme={null} > DevEntitlementTool.exe add /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9MT5TGW893HV Entitlements added: 1 9MT5TGW893HV: 2/20/2024 12:21:25 AM Active ``` Varios derechos agregados ```console theme={null} > DevEntitlementTool.exe add /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9P23V43P0XZZ 9N30KZZF4BR9 9NCX1H100M18 Entitlements added: 4 9P23V43P0XZZ: 2/20/2024 12:33:20 AM Active 9N30KZZF4BR9: 2/20/2024 12:33:20 AM Active 9NCX1H100M18: 2/20/2024 12:33:20 AM Active ``` Agregar un consumible con cantidad ```console theme={null} > DevEntitlementTool.exe add /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9MT5TGW893HV /q 4321 Entitlements added: 1 9MT5TGW893HV: 2/20/2024 12:34:35 AM Active ``` ## delete `deventitlementtool delete /e /s /p [ ...] [/all] [/d]` Elimina uno o varios derechos especificados de la cuenta. Si se especifica `/all`, intenta eliminar todos los derechos asociados a la cuenta y el sandbox. Se muestra el estado Revoked al eliminar derechos concedidos por esta herramienta. Se muestra el estado Refunded al eliminar derechos que se compraron de forma convencional a través del cliente de la Store o de la API del juego. Se admite /d para obtener más detalles. ### Salida de delete ```console theme={null} Entitlements deleted: {Number of entitlements} {ProductID}: {Last Updated Date (UTC)} {Status} ... ``` ### Ejemplos de delete ```console theme={null} > DevEntitlementTool.exe delete /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9P23V43P0XZZ 9N30KZZF4BR9 9NCX1H100M18 Entitlements deleted: 3 9P23V43P0XZZ: 2/20/2024 2:26:13 AM Revoked 9N30KZZF4BR9: 2/20/2024 2:26:13 AM Revoked 9NCX1H100M18: 2/20/2024 2:26:13 AM Revoked ``` ```console theme={null} > DevEntitlementTool.exe delete /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9PLRFWZWWF91 Entitlements deleted: 1 9PLRFWZWWF91: 1/1/0001 12:00:00 AM Refunded ``` ## catalog `deventitlementtool catalog /e /s /p [/m]` Muestra el conjunto de productos que puede vender el identificador de producto proporcionado; es decir, los productos complementarios secundarios y los productos con una relación de *puede usar y vender* con el productID en Partner Center. Este comando es el equivalente de lo que devuelve [XStoreQueryAssociatedProductsAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsasync). Los productos no se devuelven cuando están configurados en Partner Center como *disponibles pero no detectables en la Microsoft Store*. Opcionalmente, se puede especificar un mercado para recuperar los precios de ese mercado en particular. El parámetro debe ser un código de región ISO de dos caracteres, por ejemplo, GB, CA, JP, ES, etc. ### Salida de catalog ```console theme={null} Parent product: {ProductID} ({Parent Product Name}) can sell {Number of products} products: 1. {ProductID} {Product Name} {Product Type} {Price} 2. {ProductID} {Product Name} {Product Type} {Price} ... ``` ### Ejemplo de catalog ```console theme={null} > DevEntitlementTool.exe catalog /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9NTL0QDWZ4FS /m SG Parent product: 9NTL0QDWZ4FS (ATG In-Game Store) can sell 16 products: 1. 9PHPTTDP88F7: ATG Season Pass 1 Durable 23.25 SGD 2. 9NMDDZC7ZWRM: ATG Sample Year 1 Pass Durable 2850 SGD 3. 9PGLXLWS7319: ATG Consumable Only Bundle Durable 7.2 SGD 4. 9P23V43P0XZZ: ATG Sample Durable 2 Durable 0 SGD 5. 9MZ0MGGFPLTP: ATG Sample Subscription 1 Durable 0 SGD 6. 9MT5TGW893HV: ATG Sample Consumable 3 Consumable 4.35 SGD 7. 9N30KZZF4BR9: ATG Sample Durable 1 Durable 0 SGD 8. 9PLRFWZWWF91: ATG Sample Durable 4 Durable 0 SGD 9. 9PLNMXRKNM4C: ATG Sample Durable 1 (with package) Durable 0 SGD 10. 9P8S15PJTB0P: ATG Sample Durable 3 Durable 48.75 SGD 11. 9NCX1H100M18: ATG Sample Consumable 2 Consumable 2.85 SGD 12. 9N0297GK108W: ATG Dev managed consumable 1 Consumable 2.1 SGD 13. 9NQWJKKNHF1L: ATG Downloadable Content Sample Game 0 SGD 14. 9NRGW2QG5PCW: ATG Sample Pre-Order 1 Durable 0 SGD 15. 9PHHWZ12RR23: ATG In-Game Store Deluxe Add-on Durable 0 SGD 16. 9PFL4RQTB1P6: ATG Sample Consumable 1 Consumable 1.5 SGD ``` ## Comentarios Esta herramienta es estrictamente para su uso con cuentas de prueba de XBOX y para productos de sandbox. Su uso con cuentas y escenarios de venta al público está bloqueado. Hay un límite de operaciones add y delete por cuenta y día. Este límite se ajusta en función del uso observado. Para solicitar el aumento de los límites o enviar otros comentarios, póngase en contacto a través de su representante de cuentas de Microsoft. ## Documentación de referencia de la API * [XStore (contenido de la API)](/reference/system/xstore/xstore_members) * Funciones * [XStoreQueryAssociatedProductsAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsasync) * Estructuras * [XStoreCollectionData](/reference/system/xstore/structs/xstorecollectiondata) ## Related topics - [Herramientas de desarrollo para los servicios XBOX](/es/tools/tools-services/live-tools.md) - [Herramientas para los servicios XBOX](/es/tools/tools-services/live-tools-nav.md) - [XStoreCollectionData](/es/reference/system/xstore/structs/xstorecollectiondata.md) - [Habilitación de las pruebas de licencias](/es/publishing/xstore-commerce/xstore-licensing-setup.md) - [Herramientas de servicios en vivo para XBOX y PlayFab](/es/tools/tools-services/index.md)