Commander des ressources

  • 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.

Remarque

La ressource Order a une limite de débit de 500 requêtes par minute par identificateur de locataire.

Ordre

Décrit l’ordre d’un partenaire.

Propriété Type Description
id string Identificateur de commande fourni lors de la création réussie de l’ordre.
alternateId string Identificateur convivial de l’ordre.
referenceCustomerId string L’identificateur du client.
billingCycle string Indique la fréquence avec laquelle le partenaire est facturé pour cette commande. Les valeurs prises en charge sont les noms des membres trouvés dans BillingCycleType. La valeur par défaut est Monthly ou OneTime lors de la création de commandes. Ce champ est appliqué lors de la création réussie de l’ordre.
transactionType string Lecture seule. Type de transaction de l’ordre. Les valeurs prises en charge sont UserPurchase, SystemPurchase ou SystemBilling
lineItems tableau de ressources OrderLineItem Une liste détaillée des offres que le client achète, y compris la quantité.
currencyCode string Lecture seule. Devise utilisée lors du placement de la commande. Appliqué lors de la création réussie de l’ordre.
currencySymbol string Lecture seule. Symbole monétaire associé au code monétaire.
creationDate DATETIME Lecture seule. Date à laquelle la commande a été créée, au format date/heure. Appliqué lors de la création réussie de l’ordre.
statut string Lecture seule. État de l’ordre. Les valeurs prises en charge sont les noms de membres trouvés dans OrderStatus.
liens OrderLinks Les liens de ressource correspondant à l’ordre.
attributs ResourceAttributes Attributs de métadonnées correspondant à l’ordre.

OrderLineItem

Une commande contient une liste détaillée d’offres, et chaque élément est représenté sous la forme d’un OrderLineItem.

Propriété Type Description
lineItemNumber int Chaque élément de ligne dans la collection obtient un numéro de ligne unique, allant de 0 à nombre-1.
offerId string ID de l’offre.
subscriptionId string ID de l'abonnement.
parentSubscriptionId string facultatif. ID de l’abonnement parent dans une offre de module complémentaire. S’applique uniquement à PATCH.
friendlyName string facultatif. Nom convivial de l’abonnement défini par le partenaire pour aider à désambiguer.
quantité int Nombre de licences ou d’instances.
customTermEndDate Date/Heure Date de fin de la première période de facturation du nouvel abonnement.
termDuration string Représentation ISO 8601 de la durée du terme. Les valeurs prises en charge actuelles sont P1M (1 mois), P1Y (1 an) et P3Y (3 ans).
transactionType string Lecture seule. Type de transaction de l’élément de ligne. Les valeurs prises en charge sont nouvelles, renouvelées, addQuantity, removeQuantity, cancel, convert ou customerCredit.
partnerIdOnRecord string Lorsqu’un fournisseur indirect place une commande pour le compte d’un revendeur indirect, renseignez ce champ avec l’ID partenaire du revendeur indirect uniquement (jamais l’ID du fournisseur indirect). Cela garantit une comptabilité appropriée des incitations.
provisioningContext ProvisioningContext Informations requises pour l’approvisionnement de certains éléments du catalogue. La propriété provisioningVariables dans une référence SKU indique les propriétés requises pour des éléments spécifiques dans le catalogue.
liens OrderLineItemLinks Lecture seule. Liens de ressource correspondant à l’élément de ligne de commande.
renewsTo RenewsTo Détails de la durée du renouvellement.
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.
Tarification Tarification Détails du prix de liste.
purchaseCommitment PurchaseCommitment Montant fixe validé sur les services de calcul.

RenewsTo

Représente les détails de la durée du renouvellement.

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

Tarification

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

Propriété Type Requise 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 sont appliquées et que la proration est effectuée.
extendedPrice double Non Prix de l’article de ligne avec quantité, remises et proration appliquées, dans la devise de facturation applicable.

Représente les liens de ressources correspondant à l’ordre.

Propriété Type Description
provisioningStatus Lien Lorsqu’il est rempli, le lien pour récupérer l’état d’approvisionnement de la commande.
self Lien Lien permettant de récupérer la ressource de commande.

Représente l’abonnement complet associé à la commande.

Propriété Type Description
provisioningStatus Lien Une fois rempli, le lien permettant de récupérer l’état d’approvisionnement de l’élément de ligne.
sku Lien Lien permettant de récupérer les informations de référence SKU pour l’élément de catalogue acheté.
abonnement Lien Une fois renseigné, lien vers les informations d’abonnement complètes.
activationLinks Lien Lorsqu’elle est remplie, la ressource GET pour les liens permettant d’activer l’abonnement.

OrderStatus

[Enum/dotnet/api/system.enum) avec des valeurs qui indiquent l’état de l’ordre.

Valeur Position Description
unknown 0 Initialiseur d’énumération.
terminé 1 La commande est terminée.
en attente 2 La commande est en cours de traitement.
annulé 3 La commande est annulée.
interrompu 4 L’ordre est suspendu. Pour plus d’informations, consultez États du cycle de vie de l’abonnement - NCE suspendu.
examen en attente 5 L’ordre est en attente de révision secondaire. Les partenaires peuvent être tenus de charger la documentation. Consultez le jeu d’entraînement de révision des contrats secondaires pour découvrir ce qu’il faut attendre si vous êtes sélectionné pour une révision de transaction secondaire.
chargement de po en attente 6 Le partenaire doit charger son bon de commande client et entrer les détails, comme indiqué dans le cadre de la révision par Microsoft.
chargement de po terminé 7 Le bon de commande a été soumis par le partenaire et Microsoft examine. Aucune action supplémentaire requise par le partenaire.
révision de po rejetée 8 Cette commande n’a pas passé la révision secondaire et ne sera pas traitée.
réussite partielle 9 Un ou plusieurs abonnements dans l’ordre présentent un problème. Les partenaires doivent acheter des abonnements non remplis.
error 10 L’ordre a entraîné une erreur. Les partenaires doivent se réaffecter.

OrderLineItemProvisioningStatus

Représente l’état d’approvisionnement d’un OrderLineItem.

Propriété Type Description
lineItemNumber int Numéro de ligne unique de l’élément de ligne de commande. Les valeurs sont comprises entre 0 et 1.
statut string État d’approvisionnement de l’élément de ligne de commande. Valeurs include :Completeded :
Fulfillment of the order is successfully completed and the user will be able to use the reservations
Unfulfilled : Not completeded due to cancellation
PrefulfillmentPending : Your request is still processing, fulfillment is not yet completeed
quantityProvisioningInformation Répertorier<QuantityProvisioningStatus> Liste des informations d’état d’approvisionnement de quantité pour l’élément de ligne de commande.

QuantityProvisioningStatus

Représente l’état d’approvisionnement par quantité.

Propriété Type Description
quantité int Nombre d’éléments.
statut string État du nombre d’éléments.

ProvisioningContext

Informations requises pour l’approvisionnement de certains éléments du catalogue. La propriété provisioningVariables dans une référence SKU indique les propriétés requises pour des éléments spécifiques dans le catalogue.

Propriété Type Description
scope string Type d’étendue pour un achat qui indique où les avantages s’appliquent : Single,Shared.
entitlementId string ID de l’abonnement Azure qui serait utilisé pour un achat. Obligatoire pour l’étendue unique.

PurchaseCommitment

Montant fixe validé sur les services de calcul.

Propriété Type Description
montant int Engagement de montant fixe.
currency chaîne Devise de l’engagement.
Grain string Période de l’engagement.