Recursos de productos

Recursos que representan bienes o servicios que se pueden comprar. Incluye recursos para describir el tipo de producto y la forma (SKU) y para comprobar la disponibilidad del producto en un inventario.

Producto

Representa un bien o servicio que se puede purgar. Un producto por sí mismo no es un artículo que se puede purgar.

Propiedad	Tipo	Descripción
id	Cadena	Identificador de un producto.
title	Cadena	Título del producto.
descripción	Cadena	Descripción del producto.
productType	ItemType	Objeto que describe las categorizaciones de tipo de este producto.
isMicrosoftProduct	Booleano	Indica si el producto es un producto de Microsoft.
publisherName	Cadena	Nombre del publicador del producto si está disponible.
vínculos	ProductLinks	Los vínculos de recursos contenidos en el producto.

ItemType

Representa el tipo de un producto.

Propiedad	Tipo	Descripción
id	Cadena	Identificador de tipo.
DisplayName	Cadena	Nombre para mostrar de un tipo de elemento.
subType	ItemType	Opcional. Objeto que describe una categorización de subtipos para un tipo de elemento.

ProductLinks

Contiene una lista de vínculos para un producto.

Propiedad	Tipo	Descripción
skus	Vínculo	Vínculo para acceder a las SKU subyacentes.
vínculos	ResourceLinks	Los vínculos de recursos contenidos en un recurso.

SKU

Representa una unidad de mantenimiento de existencias (SKU) purchasable en un producto.

Propiedad	Tipo	Descripción
id	Cadena	Identificador de la SKU. El identificador es único solo dentro del contexto de su producto primario.
title	Cadena	Título de la SKU.
descripción	Cadena	Descripción de la SKU.
productId	Cadena	Identificador del producto primario que contiene una SKU.
minimumQuantity	Int	Cantidad mínima permitida para la compra.
maximumQuantity	Int	Cantidad máxima permitida para la compra.
isTrial	Booleano	Indica si una SKU es un elemento de prueba.
supportedBillingCycles	Matriz de cadenas	Lista de ciclos de facturación admitidos para una SKU. Los valores admitidos son los nombres de los miembros que se encuentran en BillingCycleType.
purchasePrerequisites	Matriz de cadenas	Lista de pasos o acciones de requisitos previos necesarios antes de comprar un artículo. Los valores admitidos son: "InventoryCheck": indica que el inventario del artículo debe evaluarse antes de intentar comprar un artículo. "AzureSubscriptionRegistration": indica que se necesita una suscripción de Azure y debe registrarse antes de intentar comprar un artículo.
inventoryVariables	Matriz de cadenas	Lista de variables necesarias para ejecutar una comprobación de inventario en un elemento. Los valores admitidos son: "CustomerId": el identificador del cliente para el que sería la compra. "AzureSubscriptionId": el identificador de la suscripción de Azure que se usaría para una compra de reserva de Azure. "ArmRegionName" : la región para la que se va a comprobar el inventario. Este valor debe coincidir con "ArmRegionName" de dynamicAttributes de la SKU.
provisioningVariables	Matriz de cadenas	Lista de variables que se deben proporcionar en el contexto de aprovisionamiento de un elemento de línea de carro al comprar un artículo. Los valores admitidos son: Ámbito: el ámbito de una compra de reserva de Azure: "Single", "Shared". "SubscriptionId": el identificador de la suscripción de Azure que se usaría para una compra de reserva de Azure. "Duración": la duración de la reserva de Azure: "1Year", "3Year".
dynamicAttributes	pares clave-valor	Diccionario de propiedades dinámicas que se aplican a un elemento. Las propiedades de un diccionario son dinámicas y pueden cambiar sin previo aviso. Los asociados deben evitar crear dependencias seguras en claves concretas existentes en el valor de una propiedad.
vínculos	ResourceLinks	Vínculos de recursos contenidos en la SKU.
AttestationProperties	AttestationProperties	Las propiedades de atestación de una SKU.
consumptionType	Cadena	Solo está disponible si la SKU admite el consumo, como el uso por encima del límite.
specializedOfferProperties	Lista de specializedOfferProperties	Solo está disponible si el producto es subType de SpecializedOffer.
minimumPurchaseCommitment	MinimumPurchaseCommitment	Cantidad fija confirmada en los servicios de proceso.

Atributos de SKU dinámicos

Propiedades importantes relevantes para nuevos productos y servicios basados en licencias comerciales.

Nota:

Las nuevas experiencias comerciales para los servicios basados en licencias incluyen muchas funcionalidades nuevas y están disponibles para todos los Proveedores de soluciones en la nube (CSP). Para más información, consulte Introducción a las nuevas experiencias comerciales.

Propiedad	Tipo	Descripción
hasConstraints	Booleano	Describe si la SKU contiene assetContraints
isAddon	Booleano	Describe si la SKU es un complemento
prerequisiteSkus	Matriz de cadenas	Describe los productos y las sku con los que el complemento puede funcionar
upgradeTargetOffers	Matriz de cadenas	Una lista de productos y sku a los que puede actualizar el elemento
conversionInstructions	Lista de conversionInstructions	Lista de instrucciones aplicables a las operaciones de conversión

specializedOfferProperties

Nota:

Las nuevas experiencias comerciales para los servicios basados en licencias incluyen muchas funcionalidades nuevas y están disponibles para todos los Proveedores de soluciones en la nube (CSP). Para más información, consulte Introducción a las nuevas experiencias comerciales.

Solo se aplica a subTipos de producto "SpecializedOffers"

Propiedad	Tipo	Descripción
startDate	Cadena	Identificadores de término a los que se aplican las instrucciones
endDate	Cadena	Opciones que definen renovaciones
pricingPolicies	Lista de preciosPolicies	Lista de directivas que definen los tipos y valores de descuento de promoción.

MinimumPurchaseCommitment

Atributos de la cantidad mínima que se puede confirmar en los servicios de proceso.

Propiedad	Tipo	Descripción
Grano	Cadena	Período del compromiso de compra mínimo.
currencyCode	Dictionary<String, String>	La "moneda" y el "símbolo" del importe mínimo que se puede confirmar.
amount	Int	Cantidad mínima que se puede confirmar en los servicios de proceso.

PricingPolicies

Describir los tipos y valores de descuento de promoción.

Propiedad	Tipo	Descripción
type	String	Describir si el descuento se basa en porcentajes o descuentos de tarifa plana.
value	Cadena	Define el importe del descuento aplicado.

Disponibilidad

Representa una configuración en la que está disponible una SKU para su compra (por ejemplo, país o región, moneda y segmento del sector).

Propiedad	Tipo	Descripción
id	Cadena	Identificador de esta disponibilidad. Este identificador es único solo en el contexto de su producto principal y SKU. Nota Los identificadores de disponibilidad pueden cambiar con el tiempo. Los asociados solo deben confiar en este valor en un breve intervalo de tiempo después de recuperarlo.
productId	Cadena	Identificador del producto que contiene esta disponibilidad.
skuId	Cadena	Identificador de la SKU que contiene esta disponibilidad.
catalogItemId	Cadena	Identificador único de este elemento en el catálogo. Este identificador debe rellenarse en las propiedades OrderLineItem.OfferId o CartLineItem.CatalogItemId al comprar la SKU primaria. Nota Este identificador puede cambiar con el tiempo. Solo debe confiar en este valor en un breve período de tiempo después de recuperarlo. Solo se debe acceder y usar en el momento de la compra.
defaultCurrency	Cadena	Moneda predeterminada admitida para esta disponibilidad.
segment	Cadena	Segmento del sector para esta disponibilidad. Los valores admitidos son: Commercial, Education, Government, NonProfit.
country	Cadena	País o región (en formato de código de país ISO) donde se aplica esta disponibilidad.
isPurchasable	Booleano	Indica si esta disponibilidad se puede purgar.
isRenewable	Booleano	Indica si esta disponibilidad es renovable.
RenewalInstructions	RenewalInstruction	Representa las instrucciones de renovación de una disponibilidad determinada.
producto	Identificador	El producto al que corresponde esta disponibilidad.
sku	Sku	La SKU a la que corresponde esta disponibilidad.
terms	Matriz de recursos term	Colección de términos aplicables a esta disponibilidad.
vínculos	ResourceLinks	Los vínculos de recursos contenidos dentro de la disponibilidad.

Instrucción de renovación

Nota:

Las nuevas experiencias comerciales para los servicios basados en licencias incluyen muchas funcionalidades nuevas y están disponibles para todos los Proveedores de soluciones en la nube (CSP). Para más información, consulte Introducción a las nuevas experiencias comerciales.

Representa las instrucciones de renovación de una disponibilidad determinada.

Propiedad	Tipo	Descripción
applicableTermIds	Matriz de cadenas	Identificadores de término a los que se aplican las instrucciones
RenewalOptions	Matriz de RenewalOption	Opciones que definen renovaciones

RenewalOption

Nota:

Las nuevas experiencias comerciales para los servicios basados en licencias incluyen muchas funcionalidades nuevas y están disponibles para todos los Proveedores de soluciones en la nube (CSP). Para más información, consulte Introducción a las nuevas experiencias comerciales.

Representa las instrucciones de renovación de una disponibilidad determinada.

Propiedad	Tipo	Descripción
renewToId	Cadena	Representa el producto y la SKU a los que se va a renovar.
isAutoRenewable	Booleano	Si la disponibilidad se puede renovar automáticamente o no

Término

Representa un término para el que se puede comprar la disponibilidad.

Propiedad	Tipo	Descripción
duración	Cadena	Representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (un mes), P1Y (un año) y P3Y (tres años).
descripción	Cadena	Descripción del término.

InventoryCheckRequest

Representa una solicitud para comprobar el inventario con determinados elementos de catálogo.

Propiedad	Tipo	Descripción
targetItems	Matriz de InventoryItem	Lista de elementos de catálogo que evaluará la comprobación de inventario.
inventoryContext	Pares clave-valor.	Diccionario de valores de contexto necesarios para llevar a cabo las comprobaciones de inventario. Cada SKU de los productos definirá los valores (si los hay) necesarios para llevar a cabo esta operación.
vínculos	ResourceLinks	Los vínculos de recursos contenidos en la solicitud de comprobación de inventario.

InventoryItem

Representa un solo elemento en una operación de comprobación de inventario. Este recurso se usa para especificar los elementos de destino en una solicitud de entrada y también se usa para representar los resultados de salida de la operación de comprobación de inventario.

Propiedad	Tipo	Descripción
productId	Cadena	(Obligatorio) Identificador del producto.
skuId	Cadena	Identificador de la SKU. Cuando se usa este recurso como entrada para una solicitud de inventario, este valor es opcional. Si no se proporciona este valor, todas las SKU del producto se considerarán elementos de destino de la operación de comprobación de inventario.
isRestricted	Booleano	Indica si se encontró este elemento para tener un inventario restringido.
restrictions	Matriz de InventoryRestriction	Detalles de las restricciones que se encuentran para este elemento. Esta propiedad solo se rellenará si isRestricted = "true".

InventoryRestriction

Representa los detalles de una restricción de inventario. Estos detalles solo son aplicables a los resultados de la comprobación de inventario, no para las solicitudes de entrada.

Propiedad	Tipo	Descripción
reasonCode	Cadena	Código que identifica el motivo de la restricción.
descripción	Cadena	Descripción de la restricción de inventario.
properties	Pares clave-valor.	Diccionario de propiedades que pueden proporcionar más detalles sobre la restricción.

BillingCycleType

[Enum/dotnet/api/system.enum) con valores que indican un tipo de ciclo de facturación.

Value	Position	Descripción
Unknown	0	Inicializador de enumeración.
Mensualmente	1	Indica que el partner se cobrará mensualmente.
Anual	2	Indica que el partner se cobrará anualmente.
None	3	Indica que el asociado no se cobrará. Este valor se puede usar para los elementos de prueba.
Una vez	4	Indica que el asociado se cobrará una vez.
Trienal	5	Indica que el partner se cobrará cada tres años.

AttestationProperties

Representa un tipo de atestación y si es necesario para la compra.

Propiedad	Tipo	Descripción
attestationType	Cadena	Indica el tipo de atestación. Los productos de Windows 365 tendrán el valor de Windows 365. El texto de atestación de Windows 365 es "Entiendo que cada persona que usa Windows 365 Empresa con Ventaja híbrida de Windows también debe tener instalada una copia válida de Windows 10/11 Pro en su dispositivo de trabajo principal".
enforceAttestation	Booleano	Indica si se requiere la atestación para la compra.