Delen via


Resources voor producten

Resources die inkoopbare goederen of diensten vertegenwoordigen. Bevat resources voor het beschrijven van het producttype en de vorm (SKU) en voor het controleren van de beschikbaarheid van het product in een inventaris.

Product

Vertegenwoordigt een goed of service die kan worden gekocht. Een product zelf is geen artikel dat kan worden gekocht.

Eigenschap Type Beschrijving
id String De id voor een product.
title String De producttitel.
beschrijving String De productbeschrijving.
productType ItemType Een object dat de typecategorisatie(s) van dit product beschrijft.
isMicrosoftProduct Bool Geeft aan of het product een Microsoft-product is.
publisherName String De naam van de uitgever van het product, indien beschikbaar.
koppelingen ProductLinks De resourcekoppelingen in het product.

ItemType

Vertegenwoordigt het type van een product.

Eigenschap Type Beschrijving
id String De type-id.
displayName String De weergavenaam voor een itemtype.
subType ItemType Optioneel. Een object dat een subtypecategorisatie voor een itemtype beschrijft.

Bevat een lijst met koppelingen voor een product.

Eigenschap Type Description
SKU's Koppeling De koppeling voor toegang tot de onderliggende SKU's.
koppelingen ResourceLinks De resourcekoppelingen in een resource.

Sku

Vertegenwoordigt een inkoopbare SKU (Stock Keeping Unit) onder een product.

Eigenschap Type Beschrijving
id String De id voor de SKU. De id is alleen uniek binnen de context van het bovenliggende product.
title String De titel van de SKU.
beschrijving String De beschrijving van de SKU.
productId String De id van het bovenliggende product dat een SKU bevat.
minimumQuantity Int De minimale hoeveelheid die is toegestaan voor aankoop.
maximumQuantity Int De maximale hoeveelheid die is toegestaan voor aankoop.
isTrial Bool Geeft aan of een SKU een proefitem is.
supportedBillingCycles Matrix tekenreeksen De lijst met ondersteunde factureringscycli voor een SKU. Ondersteunde waarden zijn de ledennamen in BillingCycleType.
purchasePrerequisites Matrix tekenreeksen De lijst met vereiste stappen of acties die nodig zijn voordat u een artikel aanschaft. De ondersteunde waarden zijn:
'InventoryCheck': geeft aan dat de inventaris van het artikel moet worden geëvalueerd voordat u een artikel probeert aan te schaffen.
'AzureSubscriptionRegistration': geeft aan dat een Azure-abonnement nodig is en moet worden geregistreerd voordat u een item probeert aan te schaffen.
inventoryVariables Matrix tekenreeksen De lijst met variabelen die nodig zijn om een inventariscontrole uit te voeren op een item. De ondersteunde waarden zijn:
'CustomerId': de id van de klant waarvoor de aankoop zou zijn bedoeld.
'AzureSubscriptionId': de id van het Azure-abonnement dat wordt gebruikt voor een azure-reserveringsaankoop.
'ArmRegionName': de regio waarvoor de inventaris moet worden gecontroleerd. Deze waarde moet overeenkomen met de 'ArmRegionName' uit de DynamicAttributes van de SKU.
provisioningVariables Matrix tekenreeksen De lijst met variabelen die moeten worden opgegeven in de inrichtingscontext van een winkelwagenregelitem bij het kopen van een item. De ondersteunde waarden zijn:
Bereik: het bereik voor een azure-reserveringsaankoop: 'Enkel', 'Gedeeld'.
'SubscriptionId': de id van het Azure-abonnement dat wordt gebruikt voor een azure-reserveringsaankoop.
'Duur': de duur van de Azure-reservering: '1Year', '3Year'.
dynamicAttributes sleutel-/waardeparen De woordenlijst met dynamische eigenschappen die van toepassing zijn op een item. De eigenschappen in een woordenlijst zijn dynamisch en kunnen zonder kennisgeving worden gewijzigd. Partners moeten voorkomen dat er sterke afhankelijkheden worden gemaakt van bepaalde sleutels die aanwezig zijn in de waarde van een eigenschap.
koppelingen ResourceLinks De resourcekoppelingen in de SKU.
AttestationProperties AttestationProperties De attestation-eigenschappen voor een SKU.
consumptionType String Is alleen beschikbaar als de sku verbruik ondersteunt, zoals overschrijding.
specializedOfferProperties Lijst met specializedOfferProperties Is alleen beschikbaar als het product subType van SpecializedOffer is.
minimumPurchaseCommitment MinimumPurchaseCommitment Het vaste bedrag dat is vastgelegd voor rekenservices.

Dynamische SKU-kenmerken

Belangrijke eigenschappen die relevant zijn voor nieuwe producten en services op basis van handelslicenties.

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie het overzicht van nieuwe commerce-ervaringen voor meer informatie.

Eigenschap Type Description
hasConstraints Booleaanse waarde Beschrijft of de SKU assetContraints bevat
isAddon Booleaanse waarde Beschrijft of de SKU een invoegtoepassing is
prerequisiteSkus matrix tekenreeksen Beschrijft producten en sku's waarmee de invoegtoepassing kan werken
upgradeTargetOffers matrix tekenreeksen Een lijst met producten en sku's waar het item naar kan upgraden
conversieInstructions Lijst met conversieinstructies Lijst met instructies die van toepassing zijn op conversiebewerkingen

specializedOfferProperties

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie het overzicht van nieuwe commerce-ervaringen voor meer informatie.

Alleen van toepassing op productsubtypes "SpecializedOffers"

Eigenschap Type Description
startDate String Term-id's die van toepassing zijn op
endDate String Opties voor het definiëren van verlengingen
pricingPolicies Lijst met pricingPolicies Een lijst met beleidsregels waarmee de aanbiedingskortingstypen en -waarden worden gedefinieerd.

MinimumPurchaseCommitment

Kenmerken van het minimumbedrag dat kan worden vastgelegd voor rekenservices.

Eigenschap Type Description
graan String De periode van de minimale aankoopverplichting.
currencyCode Woordenlijsttekenreeks<, tekenreeks> De valuta en het symbool van het minimumbedrag dat kan worden vastgelegd.
aantal Int Het minimale bedrag dat kan worden vastgelegd voor rekenservices.

PricingPolicies

Beschrijf de aanbiedingskortingstypen en -waarden.

Eigenschap Type Description
type String Beschrijf of de korting is gebaseerd op percentages of vaste kortingen.
waarde String Hiermee definieert u het bedrag van de toegepaste korting.

Beschikbaarheid

Vertegenwoordigt een configuratie waarin een SKU beschikbaar is voor aankoop (zoals land/regio, valuta en branchesegment).

Eigenschap Type Beschrijving
id String De id voor deze beschikbaarheid. Deze id is alleen uniek binnen de context van het bovenliggende product en de SKU. Let op: beschikbaarheids-id's kunnen na verloop van tijd veranderen. Partners mogen deze waarde slechts binnen een korte periode vertrouwen nadat ze deze hebben opgehaald.
productId String De id van het product dat deze beschikbaarheid bevat.
skuId String De id van de SKU die deze beschikbaarheid bevat.
catalogItemId String De unieke id voor dit item in de catalogus. Deze id moet worden ingevuld in de eigenschappen OrderLineItem.OfferId of CartLineItem.CatalogItemId bij het aanschaffen van de bovenliggende SKU. Houd er rekening mee dat deze id na verloop van tijd kan worden gewijzigd. U moet deze waarde slechts binnen korte tijd vertrouwen nadat u deze hebt opgehaald. Deze mag alleen worden geopend en gebruikt op het moment van aankoop.
defaultCurrency String De standaardvaluta die wordt ondersteund voor deze beschikbaarheid.
segment String Het branchesegment voor deze beschikbaarheid. Ondersteunde waarden zijn: Commercieel, Onderwijs, Overheid, NonProfit.
land String Het land of de regio (in iso-landcodeindeling) waar deze beschikbaarheid van toepassing is.
isPurchasable Bool Geeft aan of deze beschikbaarheid kan worden aangeschaft.
isRenewable Bool Geeft aan of deze beschikbaarheid kan worden verlengd.
Vernieuwingsinstructies RenewalInstruction Vertegenwoordigt verlengingsinstructies voor een bepaalde beschikbaarheid.
product Product- Het product met deze beschikbaarheid komt overeen.
sku SKU Deze beschikbaarheid komt overeen met de SKU.
voorwaarde Matrix van termenbronnen De verzameling voorwaarden die van toepassing zijn op deze beschikbaarheid.
koppelingen ResourceLinks De resourcekoppelingen in de beschikbaarheid.

Verlengingsinstructie

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie het overzicht van nieuwe commerce-ervaringen voor meer informatie.

Vertegenwoordigt verlengingsinstructies voor een bepaalde beschikbaarheid.

Eigenschap Type Description
applicableTermIds Matrix tekenreeksen Term-id's die van toepassing zijn op
RenewalOptions Matrix van RenewalOption Opties voor het definiëren van verlengingen

RenewalOption

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie het overzicht van nieuwe commerce-ervaringen voor meer informatie.

Vertegenwoordigt verlengingsinstructies voor een bepaalde beschikbaarheid.

Eigenschap Type Description
renewToId String Vertegenwoordigt het product en de SKU om te verlengen naar
isAutoRenewable Bool Of de beschikbaarheid automatisch kan worden vernieuwd

Term

Vertegenwoordigt een term waarvoor de beschikbaarheid kan worden aangeschaft.

Eigenschap Type Description
duur String Een ISO 8601-weergave van de duur van de term. De huidige ondersteunde waarden zijn P1M (één maand), P1Y (één jaar) en P3Y (drie jaar).
beschrijving String De beschrijving van de term.

InventoryCheckRequest

Vertegenwoordigt een aanvraag om de inventaris te controleren op bepaalde catalogusitems.

Eigenschap Type Description
targetItems Matrix van InventoryItem De lijst met catalogusitems die door de inventariscontrole worden geëvalueerd.
inventoryContext Sleutel-/waardeparen De woordenlijst met contextwaarden die nodig zijn om de inventariscontrole(en) uit te voeren. Elke SKU van de producten bepaalt welke waarden (indien aanwezig) nodig zijn om deze bewerking uit te voeren.
koppelingen ResourceLinks De resourcekoppelingen in de inventariscontroleaanvraag.

InventoryItem

Vertegenwoordigt één item in een voorraadcontrolebewerking. Deze resource wordt gebruikt voor het opgeven van de doelitems in een invoeraanvraag en wordt ook gebruikt om de uitvoerresultaten van de inventarisatiecontrolebewerking weer te geven.

Eigenschap Type Description
productId String (Vereist) De id van het product.
skuId String De id van de SKU. Wanneer u deze resource gebruikt als invoer voor een inventarisaanvraag, is deze waarde optioneel. Als deze waarde niet is opgegeven, worden alle SKU's onder het product beschouwd als doelitems van de inventarisatiecontrolebewerking.
isRestricted Bool Hiermee wordt aangegeven of dit item een beperkte voorraad heeft.
Beperkingen Matrix van InventoryRestriction De details van eventuele beperkingen die voor dit item worden gevonden. Deze eigenschap wordt alleen ingevuld als isRestricted = "true".

InventoryRestriction

Vertegenwoordigt de details van een inventarisbeperking. Deze details zijn alleen van toepassing op uitvoerresultaten van inventariscontrole, niet voor invoeraanvragen.

Eigenschap Type Description
reasonCode String De code die de reden voor de beperking aangeeft.
beschrijving String De beschrijving van de inventarisbeperking.
properties Sleutel-/waardeparen De woordenlijst met eigenschappen die meer informatie over de beperking kunnen bieden.

BillingCycleType

Een [Enum/dotnet/api/system.enum) met waarden die duiden op een type factureringscyclus.

Weergegeven als Position Beschrijving
Onbekend 0 Enum initializer.
Maandelijks 1 Geeft aan dat de partner maandelijks in rekening wordt gebracht.
Jaarlijks 2 Geeft aan dat de partner jaarlijks in rekening wordt gebracht.
Geen 3 Geeft aan dat er geen kosten in rekening worden gebracht voor de partner. Deze waarde kan worden gebruikt voor proefitems.
Eenmalige 4 Geeft aan dat er eenmalig kosten in rekening worden gebracht voor de partner.
Driejaarlijks 5 Geeft aan dat de partner om de drie jaar in rekening wordt gebracht.

AttestationProperties

Vertegenwoordigt een attestation-type en als dit vereist is voor aankoop.

Eigenschap Type Description
attestationType String Geeft het attestation-type aan. Windows 365-producten hebben de waarde van Windows 365. Tekst voor Windows 365-attestation is "Ik begrijp dat elke persoon die Windows 365 Business gebruikt met Windows Hybrid Benefit ook een geldig exemplaar van Windows 10/11 Pro moet hebben geïnstalleerd op hun primaire werkapparaat."
enforceAttestation Booleaanse waarde Geeft aan of attestation vereist is voor aankoop.