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. |
| segmento | 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 |
|---|---|---|
| duration | 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.
| Valor | 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. |