Promotieresources
Van toepassing op
- Partnercentrum
Juiste rollen
- Globale beheerder
- Beheer agent
Notitie
De nieuwe commerce-ervaringen voor services op basis van licenties bevatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie overzicht van nieuwe commerce-ervaringen voor meer informatie.
Beschrijft de resources voor promoties die worden toegepast op transacties voor nieuwe commerce-abonnementen.
Promotie
Korting die wordt toegepast bij de aanschaf van een product-SKU als aan de geschiktheidscriteria wordt voldaan.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| id | tekenreeks | De promotie-id. |
| naam | tekenreeks | De beschrijvende naam van de promotie. |
| beschrijving | tekenreeks | Een beschrijving van de promotie. |
| startDate | tekenreeks | De begindatum voor het moment waarop de promotie van toepassing is. |
| endDate | tekenreeks | De einddatum voor het moment waarop de promotie van toepassing is. |
| requiredProducts | lijst met requiredProducts | Product-, SKU-details en prijsbeleid waarvoor de promotie van toepassing is. |
| properties | lijst met eigenschappen | Eigenschappen voor de promotie, inclusief of de promotie automatisch van toepassing is. |
RequiredProducts
Product-, SKU-details en prijsbeleid waarvoor de promotie van toepassing is.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| productId | tekenreeks | Een id van het product waarvoor de promotie beschikbaar is. |
| skuId | tekenreeks | Een id van de SKU waarvoor de promotie beschikbaar is. |
| Termijn | Termijn | Een term met de duur en factureringscyclus waarvoor de promotie beschikbaar is. |
| pricingPolicies | Lijst met pricingPolicies | Een lijst met beleidsregels die de kortingstypen en -waarden voor promotie definiëren. |
Termijn
Vertegenwoordigt een term waarvoor de promotie kan worden gekocht.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| duur | tekenreeks | 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). |
| billingCycle | tekenreeks | Beschrijft hoe vaak de promotie wordt toegepast op de facturering. Waarden kunnen Maandelijks, Jaarlijks, OneTime of Onbekend zijn. |
PricingPolicies
Beschrijf de kortingstypen en -waarden voor promoties.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| type | tekenreeks | Beschrijf of de korting is gebaseerd op percentages of vaste kortingen. |
| waarde | tekenreeks | Definieert het bedrag van de toegepaste korting. |
Eigenschappen
Eigenschappen voor de promotie.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| isAutoApplicable | booleaans | Hiermee wordt aangegeven of de promotie automatisch wordt toegepast of dat deze moet worden doorgegeven door de partner. |
PromotionEligibilitiesRequestItem
Eigenschappen die een transactie en de geschiktheid van een promotie vertegenwoordigen.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| id | int | De item-id voor promoties eligibilities. |
| catalogItemId | tekenreeks | De catalogusitem-id waar de promotie op wordt toegepast. Bevat product-id, SKU-id en beschikbaarheids-id. |
| quantity | int | Het aantal licenties of exemplaren. |
| termDuration | tekenreeks | 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). |
| billingCycle | tekenreeks | Hierin wordt beschreven hoe vaak de promotie wordt toegepast op de facturering. Waarden kunnen Maandelijks, Jaarlijks, OneTime of Onbekend zijn. |
| promotionID | tekenreeks | De promotie-id. |
PromotionEligibilities
Een lijst met producten, SKU's en hun promotiemogelijkheden.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| id | int | De item-id promoties eligibilities. |
| catalogItemId | tekenreeks | De catalogusitem-id waar de promotie op wordt toegepast. Bevat product-id, SKU-id en beschikbaarheids-id. |
| quantity | int | Het aantal licenties of exemplaren. |
| termDuration | tekenreeks | 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). |
| billingCycle | tekenreeks | Hierin wordt beschreven hoe vaak de promotie wordt toegepast op de facturering. Waarden kunnen Maandelijks, Jaarlijks, OneTime of Onbekend zijn. |
| eligibiliteit | Lijst met PromotionEligibilities | Vertegenwoordigt een lijst met geschiktheidsresultaten voor promoties. |
PromotionEligibiliteit
Een lijst met producten, SKU's en hun promotiemogelijkheden.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| promotionId | tekenreeks | De promotie-id. |
| isEligible | booleaans | Hierin wordt beschreven of de promotie in aanmerking komt voor het opgegeven geschiktheidsaanvraagitem. |
| fouten | Lijst met PromotionEligibilityErrors | Fouten die beschrijven waarom een aanvraagitem voor promotie-eligibiliteit niet in aanmerking kwam. |
PromotionEligibilityError
Dit verklaart waarom een aanvraag voor promotie in aanmerking komt niet in aanmerking komt.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| type | tekenreeks | De fouttypen voor geschiktheid voor promoties kunnen InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously of Term zijn. |
| beschrijving | tekenreeks | Hierin wordt beschreven of de promotie in aanmerking komt voor het opgegeven geschiktheidsaanvraagitem. |
RedemptionLimitPromotionEligibilityError
Bevat informatie over waarom de inwisselingslimiet is overschreden.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| maxPromotionRedemptionCount | int | Het maximum aantal keren dat een promotie kan worden verkregen. |
| remainingPromotionRedemptionCount | int | Het resterende aantal keren dat een promotie kan worden verkregen. |
SeatCountPromotionEligibilityError
Bevat informatie over waarom de limiet voor het aantal zitplaatsen is overschreden. Alle waarden kunnen op null worden uitgevoerd.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| minimumRequiredSeats | int | De minimale licenties die een promotie ondersteunt. |
| maximumRequiredSeats | int | Het maximum aantal licenties dat een promotie ondersteunt. |
| availableSeats | int | Het resterende aantal licenties dat een partner kan verkrijgen voor een bepaalde promotie. |
TermPromotionEligibilityError
Bevat informatie over waarom de promotietermijn niet is geaccepteerd.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| eligibleTerms | Promotieterm | De in aanmerking komende voorwaarden die door een promotie worden ondersteund. |
Promotieterm
Bevat informatie over waarom de limiet voor het aantal zitplaatsen is overschreden.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| billingCycle | tekenreeks | Beschrijft hoe vaak de promotie wordt toegepast op de facturering. Waarden kunnen Maandelijks, Jaarlijks, OneTime of Onbekend zijn. |
| duur | tekenreeks | Duur van de aangeschafte termijn. |
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor