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. |
ProductLinks
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. |