Compartir a través de


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.

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.