Delen via

Resources voor promoties

  • Artikel

Van toepassing op

  • Partnercentrum

Juiste rollen

  • Beheerderagent

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.

Beschrijft de resources voor promoties die worden toegepast op transacties voor nieuwe commerce-abonnementen.

Promotie

Korting die wordt toegepast bij het aanschaffen 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 wanneer de promotie van toepassing is.
endDate tekenreeks De einddatum voor wanneer de promotie van toepassing is.
requiredProducts lijst met requiredProducts Product-, SKU-gegevens 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-gegevens en prijsbeleid waarvoor de promotie van toepassing is.

Eigenschap Type Description
productId tekenreeks Een id van het product waarvoor de promotie beschikbaar is.
skuId tekenreeks Een id van de SKU waarvoor de promotie beschikbaar is.
term Term Een term met de duur van de looptijd en de factureringscyclus waarvoor de promotie beschikbaar is.
pricingPolicies Lijst met pricingPolicies Een lijst met beleidsregels waarmee de aanbiedingskortingstypen en -waarden worden gedefinieerd.

Term

Vertegenwoordigt een term waarvoor de promotie kan worden aangeschaft.

Eigenschap Type Description
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 aanbiedingskortingstypen en -waarden.

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

Eigenschappen

Eigenschappen voor de promotie.

Eigenschap Type Description
isAutoApplicable bool Geeft aan of de promotie automatisch wordt toegepast of of deze door de partner moet worden doorgegeven.

PromotionEligibilitiesRequestItem

Eigenschappen die een transactie vertegenwoordigen en de geschiktheid van een promotie.

Eigenschap Type Beschrijving
id int De item-id van de 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 Beschrijft 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 van de 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 Beschrijft 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 promotie.

PromotionEligibility

Een lijst met producten, SKU's en hun promotiemogelijkheden.

Eigenschap Type Description
promotionId tekenreeks De promotie-id.
isEligible bool Hierin wordt beschreven of de promotie in aanmerking komt voor het opgegeven item van de geschiktheidsaanvraag.
fouten Lijst met PromotionEligibilityErrors Fouten die beschrijven waarom een aanvraagitem voor promotie niet in aanmerking komt.

PromotionEligibilityError

Hier wordt uitgelegd waarom een item voor de geschiktheidsaanvraag voor promotie niet in aanmerking komt.

Eigenschap Type Description
type tekenreeks De typen subsidiabiliteitsfouten van de promotie kunnen InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously of Term bevatten.
beschrijving tekenreeks Hierin wordt beschreven of de promotie in aanmerking komt voor het opgegeven item van de geschiktheidsaanvraag.

RedemptionLimitPromotionEligibilityError

Bevat details over waarom de inwisselingslimiet is overschreden.

Eigenschap Type Description
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 null worden.

Eigenschap Type Description
minimumRequiredSeats int De minimale licenties die een promotie zal ondersteunen.
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 promotieterm niet is geaccepteerd.

Eigenschap Type Description
eligibleTerms PromotionTerm De in aanmerking komende voorwaarden worden ondersteund door een promotie.

PromotionTerm

Bevat informatie over waarom de limiet voor het aantal zitplaatsen is overschreden.

Eigenschap Type Description
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 duur die wordt gekocht.