Commander des ressources
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. |
OrderLinks
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. |
OrderLineItemLinks
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 |
| 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 : unique, partagé. |
| 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. |
| devise | chaîne | Devise de l’engagement. |
| grain | string | Période de l’engagement. |