Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
s’applique à: Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires pour Microsoft Cloud pour le gouvernement des États-Unis
Un partenaire place une commande lorsqu’un client souhaite acheter un abonnement à partir d’une liste d’offres.
Panier
Décrit un chariot.
| Propriété | Type | Descriptif |
|---|---|---|
| pièce d'identité | ficelle | 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 | ficelle | 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 . |
| status | ficelle | État du panier. Les valeurs possibles sont « Active » (peut être mise à jour/envoyée) et « Ordonné » (a déjà été envoyé). |
Article du Panier
Représente un élément contenu dans un panier.
| Propriété | Type | Descriptif |
|---|---|---|
| pièce d'identité | ficelle | Identificateur unique d’un élément de ligne de panier. Appliqué lors de la création réussie du panier. |
| catalogItemId | ficelle | Identificateur de l’élément de catalogue. |
| friendlyName | ficelle | Optional. 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. |
| code de devise | ficelle | Code monétaire. |
| billingCycle | Objet | Type de cycle de facturation défini pour la période actuelle. |
| termDuration | ficelle | Une 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 | Une collection de chaînes pour l'identifiant du partenaire à l'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 | ficelle | Groupe pour indiquer quels éléments peuvent être envoyés ensemble dans le même ordre. |
| addonItems | Liste des objets CartLineItem | Collection d’articles de panier pour les extensions. Ces articles sont achetés dans le cadre de l'abonnement de base qui résulte de l'achat de l'élément principal du panier. |
| erreur | 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 | ficelle | ID de promotion sur le point d’être appliqué à l’article du panier. |
| customTermEndDate | Date et heure | Date de fin de la première période de facturation du nouvel abonnement. |
Participants
Représente les revendeurs du distributeur qui gèrent l'abonnement du client.
| Propriété | Type | Descriptif |
|---|---|---|
| transaction_reseller | ficelle | ID partenaire du revendeur gérant le client. |
| additional_transaction_reseller | ficelle | ID de partenaire supplémentaires d’autres partenaires impliqués dans la transaction ou la gestion du client. Cette propriété s’applique uniquement aux distributeurs qui opèrent sur les marchés de l’UE/AELE. |
Pricing
Représente les détails du prix. Les montants des prix sont fournis avant imposition.
| Propriété | Type | Obligatoire | Descriptif |
|---|---|---|---|
| listPrice | double | Non | Prix répertorié dans le catalogue sans modificateurs tarifaires appliqués. |
| prix réduit | double | Non | Prix après l’application de tous les modificateurs de tarification applicables. |
| prix au prorata | double | Non | Prix réduit après que la proration a été effectuée. |
| prix | double | Non | Prix dans la devise de facturation applicable une fois que toutes les remises sont appliquées et proration effectuées. |
| 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 | Descriptif |
|---|---|---|---|
| termDuration | ficelle | 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). |
ScheduledNextTermInstructions
Ce tableau décrit les propriétés scheduledNextTermInstructions pour le renouvellement de l’offre d’évaluation basée sur des licences dans le cadre des New Commerce Experiences (NCE). Si aucune valeur n’est spécifiée, les essais se renouvellent en abonnements payants et se renouvellent à un terme annuel, à une facturation mensuelle et à 25 licences.
| Propriété | Type | Obligatoire | Descriptif |
|---|---|---|---|
| produit | tableau | Non | Un tableau qui précise l'offre à laquelle un abonnement d'essai se renouvelle, ainsi que la durée et la fréquence de facturation de l'abonnement payant. |
| quantité | int | Non | Quantité de licence que l’abonnement payant correspondant a après que l’offre d’évaluation soit renouvelée. |
Produit
Ce tableau décrit les propriétés de productTerm pour le renouvellement de l’offre d’essai basée sur une licence NCE. Si aucune valeur n’est spécifiée dans ce tableau, les essais sont renouvelés dans les abonnements payants avec une période annuelle et une facturation mensuelle.
| Propriété | Type | Obligatoire | Descriptif |
|---|---|---|---|
| ID de produit | ficelle | Non | Un GUID mis en forme pour représenter le produit de l’abonnement payant dans lequel la version d’évaluation se renouvèle. |
| skuId | ficelle | Non | GUID formaté pour représenter la référence SKU de l'abonnement payant dans lequel l'essai est renouvelé. |
| availabilityId | ficelle | Non | Un GUID formaté pour indiquer la disponibilité de l'abonnement payant dans lequel la version d’évaluation est convertie lors du renouvellement. |
| billingCycle | ficelle | Non | La fréquence de facturation de l’abonnement payant correspondant après le renouvellement de la période d'essai. |
| termDuration | ficelle | Non | Durée de l'abonnement payant correspondant après le renouvellement de l'offre d'essai. |
Réussite de la réponse et codes d’erreur
Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et plus d’informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et les paramètres supplémentaires. Pour la liste complète, consultez les Codes d'erreur du Centre des partenaires.
CartError
Représente une erreur qui se produit après la création d’un panier.
| Propriété | Type | Descriptif |
|---|---|---|
| code d'erreur | CartErrorCode | Type d’erreur de panier. |
| errorDescription | ficelle | Description de l’erreur, y compris les notes sur les valeurs prises en charge, les valeurs par défaut ou les limites. |
| informations supplémentaires | Informations supplémentaires | Pour plus d’informations sur l’erreur. |
Informations supplémentaires
Informations supplémentaires sur l’erreur.
| Propriété | Type | Descriptif |
|---|---|---|
| quantitéDisponible | int | Nombre de licences restantes pouvant être achetées pour la référence SKU de produit donnée. |
| quantitéAchetée | int | Nombre de licences achetées. |
CartErrorCode
Types d’erreurs de panier.
| Nom | ErrorCode | Descriptif |
|---|---|---|
| La devise n'est pas prise en charge | 10000 | La devise n’est pas prise en charge pour un marché donné |
| IdentifiantDeLÉlémentDuCatalogueNonValide | 10001 | L’ID d’élément de catalogue n’est pas valide |
| QuotaNotAvailable | 10002 | Quota insuffisant disponible |
| InventaireIndisponible | 10003 | L’inventaire n’est pas disponible pour l’offre sélectionnée |
| Les participants ne sont pas pris en charge pour le partenaire | 10004 | La définition des participants n’est pas prise en charge pour Partner |
| ImpossibleDeTraiterLigneDuPanier | 10006 | Impossible de traiter la ligne de commande du panier. |
| AbonnementNestPasValide | 10007 | L’abonnement n’est pas valide. |
| L'abonnement n'est pas activé pour RI | 10008 | L’abonnement n’est pas activé pour les achats de réservation. |
| SandboxLimitExceeded | 10009 | La limite de bac à sable est dépassée. |
| EntréeInvalide | 10010 | L’entrée générique n’est pas valide. |
| SubscriptionNotRegistered | 10011 | L’abonnement n’est pas valide. |
| AttestationNonAcceptée | 10012 | L’attestation n’a pas été acceptée. |
| NombreMaxDePlacesParAbonnementDépassé | 10015 | Le nombre demandé de sièges dépasse la limite. |
| Inconnu | 0 | Valeur par défaut |
CartCheckoutResult
Représente le résultat d’une extraction de panier.
| Propriété | Type | Descriptif |
|---|---|---|
| orders | Liste des objets Order . | Collection de commandes. |
| erreursDeCommande | Liste des objets OrderError . | Collection d'erreurs liées aux commandes. |
ErreurDeCommande
Représente une erreur qui se produit lors du passage en caisse d’un panier au moment de la création d’une commande.
| Propriété | Type | Descriptif |
|---|---|---|
| orderGroupId | ficelle | ID du groupe de commandes de l’ordre avec l’erreur. |
| code | int | Code d’erreur. |
| descriptif | ficelle | Description de l'erreur. |