Ressources de panier

  • Article

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Un partenaire place une commande lorsqu’un client souhaite acheter un abonnement à partir d’une liste d’offres.

Panier

Décrit un panier.

Propriété Type Description
id string Identificateur de panier fourni lors de la création réussie du panier.
creationTimeStamp Date et heure Date de création du panier, au format date-heure. Appliqué lors de la création réussie du panier.
lastModifiedTimeStamp Date et heure Date de la dernière mise à jour du panier, au format date-heure. Appliqué lors de la création réussie du panier.
expirationTimeStamp Date et heure Date d’expiration du panier, au format date-heure. Appliqué lors de la création réussie du panier.
lastModifiedUser string Utilisateur qui a mis à jour le panier pour la dernière fois. Appliqué lors de la création réussie du panier.
lineItems Tableau d’objets Tableau de ressources CartLineItem .
statut string État du panier. Les valeurs possibles sont « Active » (peut être mise à jour/envoyée) et « Ordonné » (a déjà été envoyé).

CartLineItem

Représente un élément contenu dans un panier.

Propriété Type Description
id string Identificateur unique d’un élément de ligne de panier. Appliqué lors de la création réussie du panier.
catalogItemId string Identificateur de l’élément de catalogue.
friendlyName string facultatif. Nom convivial de l’élément défini par le partenaire pour aider à lever l’ambiguïté.
quantité int Nombre de licences ou d’instances.
currencyCode string Code devise.
billingCycle Objet Type de cycle de facturation défini pour la période actuelle.
termDuration string 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).
participants Liste des paires de chaînes d’objet Collection de PartnerID sur Enregistrement lors de l’achat.
provisioningContext Chaîne de<dictionnaire, chaîne> Contexte supplémentaire utilisé lors de l’approvisionnement de l’élément acheté. Pour déterminer les valeurs nécessaires pour un élément particulier, reportez-vous à la propriété provisioningVariables de la référence SKU.
orderGroup string Groupe pour indiquer quels éléments peuvent être envoyés ensemble dans le même ordre.
addonItems Liste des objets CartLineItem Collection d’éléments de ligne de panier pour les compléments. Ces éléments seront achetés vers l’abonnement de base qui résulte de l’achat de la ligne de panier racine.
error Objet Appliqué après la création du panier si une erreur s’est produite.
renewsTo Tableau d’objets Tableau de ressources RenewsTo .
AttestationAccepted bool Indique l’accord pour les conditions d’offre ou de référence SKU. Obligatoire uniquement pour les offres ou références SkuAttestationProperties ou OfferAttestationProperties enforceAttestation is True.
promotionId string ID de promotion sur le point d’être appliqué à l’élément de ligne de panier.
customTermEndDate Date et heure Date de fin de la première période de facturation du nouvel abonnement.

Tarification

Représente les détails du prix. Les montants des prix sont fournis avant imposition.

Propriété Type Obligatoire Description
Listprice double Non Prix répertorié dans le catalogue sans modificateurs tarifaires appliqués.
discountedPrice double Non Prix après l’application de tous les modificateurs de tarification applicables.
proratedPrice double Non Prix réduit après la proration.
price double Non Prix dans la devise de facturation applicable une fois que toutes les remises ont été appliquées et que la proration a été effectuée.
extendedPrice double Non Prix de l’article de ligne avec quantité, remises et proration appliquées, dans la devise de facturation applicable.

RenewsTo

Représente un élément contenu dans un élément de ligne de panier.

Propriété Type Obligatoire Description
termDuration string Non Représentation ISO 8601 de la durée du renouvellement. Les valeurs prises en charge actuelles sont P1M (un mois) et P1Y (un an).

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez les codes d’erreur de l’Espace partenaires.

CartError

Représente une erreur qui se produit après la création d’un panier.

Propriété Type Description
errorCode CartErrorCode Type d’erreur de panier.
errorDescription string Description de l’erreur, y compris les notes sur les valeurs prises en charge, les valeurs par défaut ou les limites.
additionalInformation AdditionalInformation Informations supplémentaires pour l’erreur.

AdditionalInformation

Informations supplémentaires sur l’erreur.

Propriété Type Description
availableQuantity int Nombre de licences restantes pouvant être achetées pour la référence SKU de produit donnée.
achetéQuantity int Nombre de licences achetées.

CartErrorCode

Types d’erreurs de panier.

Nom ErrorCode Description
CurrencyIsNotSupported 10000 La devise n’est pas prise en charge pour un marché donné
CatalogItemIdIsNotValid 10001 L’ID d’élément de catalogue n’est pas valide
QuotaNotAvailable 10002 Quota insuffisant disponible
InventoryNotAvailable 10003 L’inventaire n’est pas disponible pour l’offre sélectionnée
ParticipantsIsNotSupportedForPartner 10004 La définition des participants n’est pas prise en charge pour le partenaire
UnableToProcessCartLineItem 10006 Impossible de traiter l’élément de ligne du panier.
SubscriptionIsNotValid 10007 L’abonnement n’est pas valide.
SubscriptionIsNotEnabledForRI 10008 L’abonnement n’est pas activé pour les achats de réservation.
SandboxLimitExceededed 10009 La limite de bac à sable a été dépassée.
InvalidInput 10010 L’entrée générique n’est pas valide.
SubscriptionNotRegistered 10011 L’abonnement n’est pas valide.
AttestationNotAccepted 10012 L’attestation n’a pas été acceptée.
MaxAllowedSeatsPerSubscriptionExceededed 10015 Le nombre demandé de sièges dépasse la limite.
Inconnu 0 Default value

CartCheckoutResult

Représente le résultat d’un panier case activée out.

Propriété Type Description
orders Liste des objets Order . Collection de commandes.
orderErrors Liste des objets OrderError . Collection d’erreurs d’ordre.

OrderError

Représente une erreur qui se produit pendant un panier case activée out lors de la création d’une commande.

Propriété Type Description
orderGroupId string ID du groupe de commandes de l’ordre avec l’erreur.
code int Code d’erreur.
description string Description de l'erreur.