Partager via


Ressources de produits

Ressources qui représentent des biens ou services purchasables. Inclut des ressources pour décrire le type de produit et la forme (SKU) et pour vérifier la disponibilité du produit dans un inventaire.

Produit

Représente un bon ou un service purchasable. Un produit lui-même n’est pas un élément purchasable.

Propriété Type Description
id Chaîne ID d’un produit.
title Chaîne Titre du produit.
description Chaîne Description du produit.
productType Type d'élément Objet qui décrit la ou les catégorisations de type de ce produit.
isMicrosoftProduct Bool Indique si le produit est un produit Microsoft.
publisherName Chaîne Nom de l’éditeur du produit s’il est disponible.
liens ProductLinks Liens de ressources contenus dans le produit.

ItemType

Représente le type d’un produit.

Propriété Type Description
id Chaîne Identificateur de type.
displayName Chaîne Nom complet d’un type d’élément.
subType Type d'élément facultatif. Objet qui décrit une catégorisation de sous-type pour un type d’élément.

Contient une liste de liens pour un produit.

Propriété Type Description
skus Lien Lien permettant d’accéder aux références SKU sous-jacentes.
liens ResourceLinks Liens de ressources contenus dans une ressource.

Sku

Représente une unité de conservation de stock purchasable (SKU) sous un produit.

Propriété Type Description
id Chaîne ID de la référence SKU. L’ID est unique uniquement dans le contexte de son produit parent.
title Chaîne Titre de la référence SKU.
description Chaîne Description de la référence SKU.
productId Chaîne ID du produit parent qui contient une référence SKU.
minimumQuantity Int Quantité minimale autorisée pour l’achat.
maximumQuantity Int Quantité maximale autorisée pour l’achat.
isTrial Bool Indique si une référence SKU est un élément d’évaluation.
supportedBillingCycles Tableau de chaînes Liste des cycle de facturation prises en charge pour une référence SKU. Les valeurs prises en charge sont les noms des membres trouvés dans BillingCycleType.
purchasePrerequisites Tableau de chaînes Liste des étapes ou actions requises avant l’achat d’un élément. Les valeurs prises en charge sont :
« InventoryCheck » : indique que l’inventaire de l’élément doit être évalué avant de tenter d’acheter un article.
« AzureSubscriptionRegistration » : indique qu’un abonnement Azure est nécessaire et doit être inscrit avant de tenter d’acheter un élément.
inventoryVariables Tableau de chaînes Liste des variables nécessaires pour exécuter une vérification d’inventaire sur un élément. Les valeurs prises en charge sont :
« CustomerId » : ID du client pour lequel l’achat serait destiné.
« AzureSubscriptionId » : ID de l’abonnement Azure qui serait utilisé pour un achat de réservation Azure.
« ArmRegionName » : région pour laquelle vérifier l’inventaire. Cette valeur doit correspondre à « ArmRegionName » à partir de DynamicAttributes de la référence SKU.
provisioningVariables Tableau de chaînes Liste des variables qui doivent être fournies dans le contexte d’approvisionnement d’un élément de ligne de panier lors de l’achat d’un élément. Les valeurs prises en charge sont :
Étendue : étendue d’un achat de réservation Azure : « Unique », « Partagé ».
« SubscriptionId » : ID de l’abonnement Azure qui serait utilisé pour un achat de réservation Azure.
« Duration » - Durée de la réservation Azure : « 1Year », « 3Year ».
dynamicAttributes paires clé/valeur Dictionnaire de propriétés dynamiques qui s’appliquent à un élément. Les propriétés d’un dictionnaire sont dynamiques et peuvent changer sans préavis. Les partenaires doivent éviter de créer des dépendances fortes sur des clés particulières existantes dans la valeur d’une propriété.
liens ResourceLinks Liens de ressources contenus dans la référence SKU.
AttestationProperties AttestationProperties Propriétés d’attestation d’une référence SKU.
consumptionType Chaîne N’est disponible que si la référence SKU prend en charge la consommation telle que le dépassement.
specializedOfferProperties Liste de specializedOfferProperties Est disponible uniquement si le produit est sous-type de SpecializedOffer.
minimumPurchaseCommitment MinimumPurchaseCommitment Montant fixe validé sur les services de calcul.

Attributs de référence SKU dynamiques

Propriétés notables pertinentes pour les nouveaux produits et services basés sur des licences commerciales.

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Propriété Type Description
hasConstraints Boolean Décrit si la référence SKU contient assetContraints
isAddon Boolean Décrit si la référence SKU est un module complémentaire
prérequisSkus tableau de chaînes Décrit les produits et références SKU que le module complémentaire peut utiliser
upgradeTargetOffers tableau de chaînes Une liste de produits et de références SKU que l’élément peut mettre à niveau vers
conversionInstructions Liste des conversionInstructions Liste des instructions applicables aux opérations de conversion

specializedOfferProperties

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Applicable uniquement aux sous-types de produits « SpecializedOffers »

Propriété Type Description
startDate Chaîne ID de terme les instructions s’appliquent à
endDate Chaîne Options qui définissent les renouvellements
pricingPolicies Liste des tarifsPolicies Liste des stratégies qui définissent les types et valeurs de remise de promotion.

MinimumPurchaseCommitment

Attributs de la quantité minimale pouvant être validée sur les services de calcul.

Propriété Type Description
grain Chaîne Période de l’engagement d’achat minimal.
currencyCode Chaîne de<dictionnaire, chaîne> La « devise » et le « symbole » du montant minimal pouvant être validé.
montant Int Montant minimal pouvant être validé sur les services de calcul.

PricingPolicies

Décrire les types et valeurs de remise de promotion.

Propriété Type Description
type Chaîne Décrivez si la remise est basée sur des pourcentages ou des remises à taux fixe.
value Chaîne Définit le montant de la remise appliquée.

Disponibilité

Représente une configuration dans laquelle une référence SKU est disponible pour l’achat (par exemple, pays/région, devise et segment du secteur).

Propriété Type Description
id Chaîne ID de cette disponibilité. Cet ID est unique uniquement dans le contexte de son produit parent et de sa référence SKU. Notez que les ID de disponibilité peuvent changer au fil du temps. Les partenaires ne doivent compter que sur cette valeur dans un court intervalle de temps après sa récupération.
productId Chaîne ID du produit qui contient cette disponibilité.
skuId Chaîne ID de la référence SKU qui contient cette disponibilité.
catalogItemId Chaîne Identificateur unique de cet élément dans le catalogue. Cet ID doit être renseigné dans les propriétés OrderLineItem.OfferId ou CartLineItem.CatalogItemId lors de l’achat de la référence SKU parente. Notez que cet ID peut changer au fil du temps. Vous ne devez compter que sur cette valeur dans un court délai après sa récupération. Il doit être accessible uniquement et utilisé au moment de l’achat.
defaultCurrency Chaîne Devise par défaut prise en charge pour cette disponibilité.
segment Chaîne Segment du secteur pour cette disponibilité. Les valeurs prises en charge sont les suivantes : Commercial, Education, Government, NonProfit.
country Chaîne Pays ou région (au format de code pays ISO) où cette disponibilité s’applique.
isPurchasable Bool Indique si cette disponibilité est purchassable.
isRenewable Bool Indique si cette disponibilité est renouvelable.
RenewalInstructions RenewalInstruction Représente des instructions de renouvellement pour une disponibilité donnée.
product Produit Le produit à laquelle cette disponibilité correspond.
sku Sku La référence SKU à laquelle cette disponibilité correspond.
terms Tableau de ressources de terme Collection de termes applicables à cette disponibilité.
liens ResourceLinks Liens de ressources contenus dans la disponibilité.

Instruction de renouvellement

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Représente des instructions de renouvellement pour une disponibilité donnée.

Propriété Type Description
applicableTermIds Tableau de chaînes ID de terme les instructions s’appliquent à
RenewalOptions Tableau de RenewalOption Options qui définissent les renouvellements

RenewalOption

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Représente des instructions de renouvellement pour une disponibilité donnée.

Propriété Type Description
renewToId Chaîne Représente le produit et la référence sku à renouveler vers
isAutoRenewable Bool Indique si la disponibilité peut être renouvelée automatiquement ou non

Terme

Représente un terme pour lequel la disponibilité peut être achetée.

Propriété Type Description
durée Chaîne Représentation ISO 8601 de la durée du terme. Les valeurs prises en charge actuelles sont P1M (un mois), P1Y (un an) et P3Y (trois ans).
description Chaîne Description du terme.

InventoryCheckRequest

Représente une demande de vérification de l’inventaire sur certains éléments de catalogue.

Propriété Type Description
targetItems Tableau d’InventoryItem Liste des éléments de catalogue évalués par la vérification de l’inventaire.
inventoryContext Paires clé-valeur. Dictionnaire des valeurs de contexte nécessaires pour effectuer les vérifications d’inventaire. Chaque référence SKU des produits définit les valeurs (le cas échéant) nécessaires pour effectuer cette opération.
liens ResourceLinks Liens de ressources contenus dans la demande de vérification de l’inventaire.

InventoryItem

Représente un élément unique dans une opération de vérification d’inventaire. Cette ressource est utilisée pour spécifier les éléments cibles dans une demande d’entrée et est également utilisée pour représenter les résultats de sortie de l’opération de vérification de l’inventaire.

Propriété Type Description
productId Chaîne (Obligatoire) ID du produit.
skuId Chaîne ID de la référence SKU. Lorsque vous utilisez cette ressource comme entrée à une demande d’inventaire, cette valeur est facultative. Si cette valeur n’est pas fournie, toutes les références SKU sous le produit sont considérées comme des éléments cibles de l’opération de vérification de l’inventaire.
isRestricted Bool Indique si cet élément a été trouvé pour avoir un inventaire restreint.
restrictions Tableau d’InventoryRestriction Détails des restrictions trouvées pour cet élément. Cette propriété ne sera remplie que si isRestricted = « true ».

InventoryRestriction

Représente les détails d’une restriction d’inventaire. Ces détails s’appliquent uniquement aux résultats de sortie de vérification de l’inventaire, et non aux demandes d’entrée.

Propriété Type Description
reasonCode Chaîne Code qui identifie la raison de la restriction.
description Chaîne Description de la restriction d’inventaire.
properties Paires clé-valeur. Dictionnaire de propriétés qui peuvent fournir des détails supplémentaires sur la restriction.

BillingCycleType

[Enum/dotnet/api/system.enum) avec des valeurs qui indiquent un type de cycle de facturation.

Valeur Position Description
Inconnu 0 Initialiseur d’énumération.
Mensuelle 1 Indique que le partenaire sera facturé mensuellement.
Annuelle 2 Indique que le partenaire sera facturé annuellement.
Aucune 3 Indique que le partenaire ne sera pas facturé. Cette valeur peut être utilisée pour les éléments d’évaluation.
OneTime 4 Indique que le partenaire sera facturé une seule fois.
Tous les trois ans 5 Indique que le partenaire sera facturé tous les trois ans.

AttestationProperties

Représente un type d’attestation et s’il est requis pour l’achat.

Propriété Type Description
attestationType Chaîne Indique le type d’attestation. Les produits Windows 365 ont la valeur de Windows 365. Le texte d’attestation Windows 365 est « Je comprends que chaque personne utilisant Windows 365 Affaires avec Avantage Windows hybride doit également avoir une copie valide de Windows 10/11 Pro installée sur son appareil professionnel principal . »
enforceAttestation Boolean Indique si l’attestation est requise pour l’achat.