Ressources de panier
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. |