Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 comprar. Un producto por sí mismo no es un artículo que se puede comprar.
| Propiedad | Tipo | Descripción |
|---|---|---|
| identificación | Cuerda | Identificador de un producto. |
| título | Cuerda | Título del producto. |
| descripción | Cuerda | Descripción del producto. |
| tipoDeProducto | ItemType (Tipo de artículo) | Objeto que describe las categorizaciones de tipo de este producto. |
| esProductoDeMicrosoft | Bool | Indica si el producto es un producto de Microsoft. |
| nombre del editor | Cuerda | Nombre del publicador del producto si está disponible. |
| Enlaces | ProductLinks | Los vínculos de recursos contenidos en el producto. |
Tipo de elemento
Representa el tipo de un producto.
| Propiedad | Tipo | Descripción |
|---|---|---|
| identificación | Cuerda | Identificador de tipo. |
| Nombre para mostrar | Cuerda | Nombre de visualización de un tipo de elemento. |
| subtipo | ItemType (Tipo de artículo) | Opcional. Objeto que describe una categorización de subtipos para un tipo de elemento. |
Enlaces de productos
Contiene una lista de vínculos para un producto.
| Propiedad | Tipo | Descripción |
|---|---|---|
| skus | Vínculo | Vínculo para acceder a las SKU subyacentes. |
| Enlaces | Enlaces de recursos | Los vínculos de recursos contenidos en un recurso. |
SKU
Representa una unidad de mantenimiento de existencias (SKU) que se puede comprar dentro de un producto.
| Propiedad | Tipo | Descripción |
|---|---|---|
| identificación | Cuerda | Identificador de la SKU. El identificador es único solo dentro del contexto de su producto primario. |
| título | Cuerda | El título del SKU. |
| descripción | Cuerda | Descripción de la SKU. |
| ID de producto | Cuerda | Identificador del producto primario que contiene una SKU. |
| cantidad mínima | Int | Cantidad mínima permitida para la compra. |
| cantidadMáxima | Int | Cantidad máxima permitida para la compra. |
| isTrial | Bool | Indica si una SKU es un elemento de prueba. |
| ciclosDeFacturaciónSoportados | 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. |
| requisitos de compra | 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. |
| variablesInventario | 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 los DynamicAttributes del SKU. |
| variables de aprovisionamiento | Matriz de cadenas | Lista de variables que se deben proporcionar en el contexto de aprovisionamiento de un elemento de línea de carrito al comprar un artículo. Los valores admitidos son: Ámbito: el ámbito de una compra de reserva de Azure: "Único", "Compartido". "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: "1 Año", "3 Años". |
| 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 socios deben evitar crear fuertes dependencias en claves concretas existentes en el valor de una propiedad. |
| Enlaces | Enlaces de recursos | Vínculos de recursos contenidos en la SKU. |
| AttestationProperties | AttestationProperties | Las propiedades de atestación de una SKU. |
| tipoDeConsumo | Cuerda | Solo está disponible si la SKU admite el consumo, como el uso por encima del límite. |
| propiedadesDeOfertasEspecializadas | Lista de propiedadesDeOfertaEspecializada | Solo está disponible si el producto es un subtipo de Oferta Especializada. |
| compromiso mínimo de compra | CompromisoMínimoDeCompra | Cantidad fija comprometida en los servicios de computación. |
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 obtener más información, consulte información general sobre las nuevas experiencias comerciales.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tieneRestricciones | Booleano | Describe si la SKU contiene restricciones de activos |
| esComplemento | Booleano | Describe si la SKU es un complemento |
| prerequisiteSkus | Matriz de cadenas | Describe los productos y los SKU con los que puede funcionar el complemento. |
| upgradeTargetOffers | Matriz de cadenas | Una lista de productos y SKUs a los que el artículo puede actualizarse. |
| instrucciones de conversión | Lista de instrucciones de conversión | Lista de instrucciones aplicables a las operaciones de conversión |
propiedadesDeOfertasEspecializadas
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 obtener más información, consulte información general sobre las nuevas experiencias comerciales.
Solo se aplica a subTipos de producto "SpecializedOffers"
| Propiedad | Tipo | Descripción |
|---|---|---|
| Fecha de inicio | Cuerda | Identificadores de términos a los que se aplican las instrucciones |
| fecha de finalización | Cuerda | Opciones que definen renovaciones |
| políticas de precios | Lista de políticas de precios | Lista de directivas que definen los tipos y valores de descuento de promoción. |
CompromisoMínimoDeCompra
Atributos de la cantidad mínima que se puede comprometer en los servicios de computación.
| Propiedad | Tipo | Descripción |
|---|---|---|
| grano | Cuerda | Período del compromiso de compra mínimo. |
| código de moneda | Dictionary<String, String> | La "moneda" y el "símbolo" del importe mínimo que se puede comprometer. |
| importe | Int | Cantidad mínima que se puede reservar en los servicios informáticos. |
Políticas de Precios
Describir los tipos y valores de descuento de promoción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tipo | Cuerda | Describir si el descuento se basa en porcentajes o descuentos de tarifa plana. |
| valor | Cuerda | 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 |
|---|---|---|
| identificación | Cuerda | 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. |
| ID de producto | Cuerda | Identificador del producto que contiene esta disponibilidad. |
| skuId | Cuerda | El identificador del SKU que incluye esta disponibilidad. |
| catalogItemId | Cuerda | 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 durante un breve período de tiempo después de recuperarlo. Solo se debe acceder y usar en el momento de la compra. |
| defaultCurrency | Cuerda | Moneda predeterminada que admite esta disponibilidad. |
| segmento | Cuerda | Segmento del sector para esta disponibilidad. Los valores admitidos son: Comercial, Educación, Gobierno, Sin Fines de Lucro. |
| país | Cuerda | País o región (en formato de código de país ISO) donde se aplica esta disponibilidad. |
| esComprable | Bool | Indica si esta disponibilidad se puede comprar. |
| esRenovable | Bool | Indica si esta disponibilidad es renovable. |
| Instrucciones de Renovación | RenewalInstruction | Representa las instrucciones de renovación de una disponibilidad determinada. |
| producto | Producto | El producto al que corresponde esta disponibilidad. |
| código SKU | Sku | La SKU a la que corresponde esta disponibilidad. |
| términos | Matriz de recursos term | Colección de términos aplicables a esta disponibilidad. |
| Enlaces | Enlaces de recursos | Los enlaces de recursos contenidos en 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 obtener más información, consulte información general sobre 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érminos a los que se aplican las instrucciones |
| Opciones de renovación | Matriz de RenewalOption | Opciones que definen renovaciones |
Opció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 obtener más información, consulte información general sobre las nuevas experiencias comerciales.
Representa las instrucciones de renovación de una disponibilidad determinada.
| Propiedad | Tipo | Descripción |
|---|---|---|
| renewToId | Cuerda | Representa el producto y el SKU que se renovará. |
| esRenovableAutomáticamente | Bool | 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 | Cuerda | Una 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 | Cuerda | Descripción del término. |
| termLifeCycleState | Cuerda | Descripción del ciclo de vida. Estos valores admitidos incluyen disponibilidad general, fin de venta y fin de venta con conversiones. Esta propiedad solo se devuelve si includeLifeCycleState se establece en true al llamar a la API get availability by id. |
SolicitudDeVerificaciónDeInventario
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 evalúa la comprobación de inventario. |
| contexto de inventario | Pares clave-valor | Diccionario de valores de contexto necesarios para llevar a cabo las comprobaciones de inventario. Cada SKU de los productos determina qué valores (si los hay) son necesarios para llevar a cabo esta operación. |
| Enlaces | Enlaces de recursos | Los vínculos de recursos contenidos en la solicitud de comprobación de inventario. |
InventarioItem
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 |
|---|---|---|
| ID de producto | Cuerda | (Obligatorio) Identificador del producto. |
| skuId | Cuerda | Identificador del SKU. Este valor es opcional. Si no se proporciona este valor, todas las SKU del producto se consideran elementos de destino de la operación de comprobación de inventario. |
| estáRestringido | Bool | Indica si se halló que este elemento tiene restricción de inventario. |
| Restricciones | Matriz de InventoryRestriction | Detalles de las restricciones que se encuentran para este elemento. Esta propiedad solo se rellena si isRestricted = "true". |
Restricción de inventario
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 |
|---|---|---|
| códigoDeRazón | Cuerda | Código que identifica el motivo de la restricción. |
| descripción | Cuerda | Descripción de la restricción de inventario. |
| Propiedades | Pares clave-valor | Diccionario de propiedades que pueden proporcionar más detalles sobre la restricción. |
TipoDeCicloDeFacturación
[Enum/dotnet/api/system.enum) con valores que indican un tipo de ciclo de facturación.
| Importancia | Posición | Descripción |
|---|---|---|
| Desconocido | 0 | Inicializador de enumeración. |
| Mensualmente | 1 | Indica que se cobra al socio mensualmente. |
| Anual | 2 | Indica que al socio se le cobra anualmente. |
| Ninguno | 3 | Indica que al socio no se le cobra. Este valor se puede usar para los elementos de prueba. |
| Onetime | 4 | Indica que al socio se le cobra una vez. |
| Trienal | 5 | Indica que se le cobra al asociado cada tres años. |
AttestationProperties
Representa un tipo de certificación y si es necesario para la compra.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tipo de acreditación | Cuerda | Indica el tipo de atestación. Los productos de Windows 365 tienen el valor de Windows 365. El texto de atestación de Windows 365 es "Entiendo que cada persona que usa Windows 365 Empresa con la 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". |
| imponerAtestación | Booleano | Indica si se requiere la atestación para la compra. |