Commandes

Dans cette section

Cette section fournit des exemples permettant d’effectuer les actions suivantes :

Exemples

Create an order

La création d’une commande renvoie immédiatement une ressource de commande, mais la ressource peut être traitée en arrière-plan. Pour déterminer l’état actuel du traitement de commande, abonnez-vous à la liste de diffusion des événements d’abonnement.

Pour créer une commande, procédez comme suit :

  1. Téléchargez une liste des offres d’achat prises en charge et des informations associées. Votre responsable de compte Microsoft doit vous communiquer un lien Internet vers une liste exhaustive des offres.
  2. Spécifiez les postes inclus dans la commande. Un poste correspond à une offre à acheter.
    • Utilisez l’URI d’offre fourni dans la feuille de calcul pour définir le poste. Lorsque vous créez les postes, définissez des numéros de postes consécutifs uniques. Consultez également la ressource Commandes.
    • Une fois que la commande est créée, le poste contient un lien vers l’abonnement créé pour l’offre.
Remarque  

Pour créer une commande afin d’ajouter un revendeur de niveau 2 à un abonnement, placez un ID MPN dans le champ advisor_partner_id du poste. Lorsqu’aucun revendeur de niveau 2 n’est impliqué, laissez ce champ vide.

L’expression revendeurs de niveau 2 désigne les revendeurs qui collaborent avec leurs partenaires de distribution de niveau 2 à la vente de services cloud Microsoft. Ailleurs dans la documentation, revendeur est synonyme de partenaire.

 

Exemple de requête


POST https : //api.cp.microsoft.com/d51a0512-02a2-4363-8184-ef4b470568db/orders HTTP/1.1
Accept : application / json
api - version : 2015 - 03 - 31
Authorization : Bearer < SA_Token >
x - ms - correlation - id : 08c673d5 - a828 - 419e-b053 - bb0f15c92662
x - ms - tracking - id : bd45836f - 3a12 - 422e-9739 - 263d80044346
{
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/16071d9f-efec-4282-a42e-a495eea76ae0/offers/195416C1-3447-423A-B37B-EE59A99A19C4",
			"quantity" : 875
		}
	],
	"recipient_customer_id" : "1bbbe60b-e174-4a4c-8e5a-ed9f09e02010"
}

Exemple de réponse


HTTP / 1.1 200 OK
api - version : 2015 - 03 - 31
Cache - Control : no - cache
Date : Sat, 21 Mar 2015 03 : 50 : 07 GMT
Pragma : no - cache
Server : Microsoft - IIS / 7.5
Strict - Transport - Security : max - age = 15724800;
includeSubDomains
X - AspNet - Version : 4.0.30319
x - ms - correlation - id : 08c673d5 - a828 - 419e-b053 - bb0f15c92662
x - ms - session - id : 423dde88 - aa86 - 4425 - 947a - 156fc24eab4f
X - Server : BLUOS3OMSORDW01
{
	"id" : "843dc548-0564-4457-a4e4-ecc15a0e6b11",
	"recipient_customer_id" : "1bbbe60b-e174-4a4c-8e5a-ed9f09e02010",
	"etag" : "eyJpZCI6Ijg0M2RjNTQ4LTA1NjQtNDQ1Ny1hNGU0LWVjYzE1YTBlNmIxMSIsInZlcnNpb24iOjF9",
	"creation_date" : "2015-03-21T03:50:08.063+00:00",
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/195416C1-3447-423A-B37B-EE59A99A19C4",
			"quantity" : 875,
			"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/ef947115-efc7-4558-b2d0-75a72bf183db?recipient_customer_id=1bbbe60b-e174-4a4c-8e5a-ed9f09e02010"		
		}
	],
	"object_type" : "Order",
	"contract_version" : "1.3",
	"links" : {
		"self" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/843dc548-0564-4457-a4e4-ecc15a0e6b11?recipient_customer_id=1bbbe60b-e174-4a4c-8e5a-ed9f09e02010",
			"method" : "GET"
		},
		"patch" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/843dc548-0564-4457-a4e4-ecc15a0e6b11",
			"method" : "PATCH"
		},
		"payer" : {
			"href" : "/commerce-accounts/d51a0512-02a2-4363-8184-ef4b470568db",
			"method" : "GET"
		},
		"recipient" : {
			"href" : "/commerce-accounts/1bbbe60b-e174-4a4c-8e5a-ed9f09e02010",
			"method" : "GET"
		}
	}
}

Create an order with multiple line items

Exemple de requête


POST https : //api.cp.microsoft.com/d51a0512-02a2-4363-8184-ef4b470568db/orders HTTP/1.1
Accept : application / json
api - version : 2015 - 03 - 31
Authorization : Bearer < SA_Token >
x - ms - correlation - id : 14ce9687 - 301d - 4a75 - b34e - 273bb3fb2844
x - ms - tracking - id : 1ae39c56 - 2e58 - 450d - a21d - 501effebb694
{
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/16071d9f-efec-4282-a42e-a495eea76ae0/offers/195416C1-3447-423A-B37B-EE59A99A19C4",
			"quantity" : 825
		}, {
			"line_item_number" : 1,
			"offer_uri" : "/16071d9f-efec-4282-a42e-a495eea76ae0/offers/ACA0C06C-890D-4ABB-83CF-BC519A2565E5",
			"quantity" : 962
		}, {
			"line_item_number" : 2,
			"offer_uri" : "/16071d9f-efec-4282-a42e-a495eea76ae0/offers/51E95709-DC35-4780-9040-22278CB7C0E1",
			"quantity" : 244
		}
	],
	"recipient_customer_id" : "606586db-e766-464c-a4cb-e8e90ac24a3e"
}

Exemple de réponse



HTTP / 1.1 200 OK
api - version : 2015 - 03 - 31
Cache - Control : no - cache
Date : Mon, 23 Mar 2015 18 : 11 : 28 GMT
Pragma : no - cache
Server : Microsoft - IIS / 7.5
Strict - Transport - Security : max - age = 15724800;
includeSubDomains
X - AspNet - Version : 4.0.30319
x - ms - correlation - id : 14ce9687 - 301d - 4a75 - b34e - 273bb3fb2844
x - ms - session - id : 0ac85bd4 - 4478 - 458e-88e1 - 6ec5171aa80c
X - Server : BLUOS3OMSORDW03
{
	"id" : "ef4f972f-219f-4d5d-9de2-f033933328c4",
	"recipient_customer_id" : "606586db-e766-464c-a4cb-e8e90ac24a3e",
	"etag" : "eyJpZCI6ImVmNGY5NzJmLTIxOWYtNGQ1ZC05ZGUyLWYwMzM5MzMzMjhjNCIsInZlcnNpb24iOjF9",
	"creation_date" : "2015-03-23T18:11:28.437+00:00",
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/195416C1-3447-423A-B37B-EE59A99A19C4",
			"quantity" : 825,
			"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/9dc365c2-74b5-4a29-bec8-ed2c3a3da224?recipient_customer_id=606586db-e766-464c-a4cb-e8e90ac24a3e"
		}, {
			"line_item_number" : 1,
			"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/ACA0C06C-890D-4ABB-83CF-BC519A2565E5",
			"quantity" : 962,
			"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/60d000f8-cf6c-413b-9127-b33dc190e2a6?recipient_customer_id=606586db-e766-464c-a4cb-e8e90ac24a3e"
		}, {
			"line_item_number" : 2,
			"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/51E95709-DC35-4780-9040-22278CB7C0E1",
			"quantity" : 244,
			"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/2a6f44db-03bc-4ebc-a38c-c5f6c9697bfa?recipient_customer_id=606586db-e766-464c-a4cb-e8e90ac24a3e"
		}
	],
	"object_type" : "Order",
	"contract_version" : "1.3",
	"links" : {
		"self" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/ef4f972f-219f-4d5d-9de2-f033933328c4?recipient_customer_id=606586db-e766-464c-a4cb-e8e90ac24a3e",
			"method" : "GET"
		},
		"patch" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/ef4f972f-219f-4d5d-9de2-f033933328c4",
			"method" : "PATCH"
		},
		"payer" : {
			"href" : "/commerce-accounts/d51a0512-02a2-4363-8184-ef4b470568db",
			"method" : "GET"
		},
		"recipient" : {
			"href" : "/commerce-accounts/606586db-e766-464c-a4cb-e8e90ac24a3e",
			"method" : "GET"
		}
	}
}

Create an order to add a 2-Tier reseller to a subscription

Exemple de requête


POST https : //api.cp.microsoft.com/d51a0512-02a2-4363-8184-ef4b470568db/orders HTTP/1.1
Accept : application / json
api - version : 2015 - 03 - 31
Authorization : Bearer < SA_Token >
x - ms - correlation - id : 1776eddb - 3d41 - 4bfc - b9a3 - ccc95e457682
x - ms - tracking - id : 978ff197 - 7d68 - 47c0 - b3c5 - 7ade0072de0c
{
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/16071d9f-efec-4282-a42e-a495eea76ae0/offers/195416C1-3447-423A-B37B-EE59A99A19C4",
			"advisor_partner_id" : "4224837",
			"quantity" : 600
		}
	],
	"recipient_customer_id" : "1f37edb4-ad6f-404d-924f-885062dc4e71"
}

Exemple de réponse


HTTP / 1.1 200 OK
api - version : 2015 - 03 - 31
Cache - Control : no - cache
Date : Sat, 21 Mar 2015 05 : 14 : 49 GMT
Pragma : no - cache
Server : Microsoft - IIS / 7.5
Strict - Transport - Security : max - age = 15724800;
includeSubDomains
X - AspNet - Version : 4.0.30319
x - ms - correlation - id : 1776eddb - 3d41 - 4bfc - b9a3 - ccc95e457682
x - ms - session - id : dd99cd34 - c456 - 4cdc - a924 - 2edf734d51d7
X - Server : BLUOS3OMSORDW02
{
	"id" : "0349051c-032b-4269-97bb-6ea24dda6abe",
	"recipient_customer_id" : "1f37edb4-ad6f-404d-924f-885062dc4e71",
	"etag" : "eyJpZCI6IjAzNDkwNTFjLTAzMmItNDI2OS05N2JiLTZlYTI0ZGRhNmFiZSIsInZlcnNpb24iOjF9",
	"creation_date" : "2015-03-21T05:14:49.627+00:00",
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/195416C1-3447-423A-B37B-EE59A99A19C4",
			"quantity" : 600,
			"advisor_partner_id" : "4224837",
			"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/c8e60346-ab8b-4dd4-a63d-d05264249a6f?recipient_customer_id=1f37edb4-ad6f-404d-924f-885062dc4e71"
		}
	],
	"object_type" : "Order",
	"contract_version" : "1.3",
	"links" : {
		"self" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/0349051c-032b-4269-97bb-6ea24dda6abe?recipient_customer_id=1f37edb4-ad6f-404d-924f-885062dc4e71",
			"method" : "GET"
		},
		"patch" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/0349051c-032b-4269-97bb-6ea24dda6abe",
			"method" : "PATCH"
		},
		"payer" : {
			"href" : "/commerce-accounts/d51a0512-02a2-4363-8184-ef4b470568db",
			"method" : "GET"
		},
		"recipient" : {
			"href" : "/commerce-accounts/1f37edb4-ad6f-404d-924f-885062dc4e71",
			"method" : "GET"
		}
	}
}

Transition a subscription

Dans une transition d’abonnement, le produit utilisé par le destinataire change. En conséquence, l’offre et la référence sont également modifiées. Lorsque vous effectuez une transition, une nouvelle commande associée à un nouvel abonnement et de nouveaux droits d’éligibilité est créée. Un scénario typique de transition se produit, dans lequel les produits sont regroupés dans des suites. Par exemple, lorsque le client passe d’un abonnement Exchange à un abonnement complet à Office 365.

Pendant une transition, l’abonnement source demeure actif jusqu’à ce que le nouvel abonnement soit approvisionné. Après l’approvisionnement, l’abonnement source est suspendu.

Les transitions d’abonnement, qui nécessitent des ré-attributions de licences, sont plus complexes que les conversions d’abonnement. Les conversions d’abonnement sont plus simples pour le destinataire, qui ne subit aucune conséquence en matière d’attribution de licence.

Remarque  Toutes les offres ne sont pas éligibles pour la transition.
 

Exemple de requête


POST https : //api.cp.microsoft.com/d51a0512-02a2-4363-8184-ef4b470568db/orders HTTP/1.1
Accept : application / json
api - version : 2015 - 03 - 31
Authorization : Bearer < SA_Token >
x - ms - correlation - id : 58c78823 - 061b - 4c68 - 9146 - 0d1c5f8ad5b6
x - ms - tracking - id : 31757d2d - 461a - 49f4 - af40 - 007e5e681edc
{
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/91FD106F-4B2C-4938-95AC-F54F74E9A239",
			"quantity" : 512,
			"reference_entitlement_uris" : ["/1ce7cffd-c4e9-41bc-8138-a0fdcff927d8/Entitlements/a5ef5c98-e2de-43b6-9ee7-a9df88c82aba"]
		}
	],
	"recipient_customer_id" : "1ce7cffd-c4e9-41bc-8138-a0fdcff927d8"
}

Exemple de réponse


HTTP / 1.1 200 OK
api - version : 2015 - 03 - 31
Cache - Control : no - cache
Date : Thu, 26 Mar 2015 23 : 02 : 35 GMT
Pragma : no - cache
Server : Microsoft - IIS / 7.5
Strict - Transport - Security : max - age = 15724800;
includeSubDomains
X - AspNet - Version : 4.0.30319
x - ms - correlation - id : 58c78823 - 061b - 4c68 - 9146 - 0d1c5f8ad5b6
x - ms - session - id : 4ecd72c1 - 761f - 48f3 - a283 - 9c1b7cdf8d56
X - Server : BLUOS3OMSORDW01
{
	"id" : "8130411d-cf87-4646-9a0b-206fd3850c1c",
	"recipient_customer_id" : "1ce7cffd-c4e9-41bc-8138-a0fdcff927d8",
	"etag" : "eyJpZCI6IjgxMzA0MTFkLWNmODctNDY0Ni05YTBiLTIwNmZkMzg1MGMxYyIsInZlcnNpb24iOjF9",
	"creation_date" : "2015-03-26T23:02:36.4+00:00",
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/91FD106F-4B2C-4938-95AC-F54F74E9A239",
			"quantity" : 512,
			"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/4c041bb0-086e-4101-ad6b-f6f729a5d836?recipient_customer_id=1ce7cffd-c4e9-41bc-8138-a0fdcff927d8"
		}
	],
	"object_type" : "Order",
	"contract_version" : "1.3",
	"links" : {
		"self" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/8130411d-cf87-4646-9a0b-206fd3850c1c?recipient_customer_id=1ce7cffd-c4e9-41bc-8138-a0fdcff927d8",
			"method" : "GET"
		},
		"patch" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/8130411d-cf87-4646-9a0b-206fd3850c1c",
			"method" : "PATCH"
		},
		"payer" : {
			"href" : "/commerce-accounts/d51a0512-02a2-4363-8184-ef4b470568db",
			"method" : "GET"
		},
		"recipient" : {
			"href" : "/commerce-accounts/1ce7cffd-c4e9-41bc-8138-a0fdcff927d8",
			"method" : "GET"
		}
	}
}

Get all orders

Obtenez une ressource de collections contenant l’ensemble des commandes appartenant à l’ID recipient_customer_id spécifié dans l’URI.

Exemple de requête


GET https : //api.cp.microsoft.com/d51a0512-02a2-4363-8184-ef4b470568db/orders?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f HTTP/1.1
Accept : application / json
api - version : 2015 - 03 - 31
Authorization : Bearer < SA_Token >
x - ms - correlation - id : 413e7878 - 8887 - 4874 - 971d - aabc33a8de74
x - ms - tracking - id : 1dff92cb - d66c - 4aa7 - aae1 - b860a7c2c5bd

Exemple de réponse


HTTP / 1.1 200 OK
api - version : 2015 - 03 - 31
Cache - Control : no - cache
Date : Sat, 21 Mar 2015 04 : 13 : 32 GMT
Pragma : no - cache
Server : Microsoft - IIS / 7.5
Strict - Transport - Security : max - age = 15724800;
includeSubDomains
X - AspNet - Version : 4.0.30319
x - ms - correlation - id : 413e7878 - 8887 - 4874 - 971d - aabc33a8de74
x - ms - session - id : e4803aa3 - 3199 - 4c8f - 89e2 - 2d1b0aa47704
X - Server : BLUOS3OMSORDW02
{
	"object_type" : "Orders",
	"contract_version" : "1.1",
	"items" : [{
			"id" : "0b325989-8553-4c18-b498-505f0c9f4283",
			"recipient_customer_id" : "5f0c5985-e502-439d-be26-efdee6212c6f",
			"etag" : "eyJpZCI6IjBiMzI1OTg5LTg1NTMtNGMxOC1iNDk4LTUwNWYwYzlmNDI4MyIsInZlcnNpb24iOjF9",
			"creation_date" : "2015-03-21T04:13:32.62+00:00",
			"line_items" : [{
					"line_item_number" : 0,
					"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/195416C1-3447-423A-B37B-EE59A99A19C4",
					"quantity" : 522,
					"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/3410f869-fe2a-4528-a2ca-19b791519280?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f"
				}, {
					"line_item_number" : 1,
					"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/ACA0C06C-890D-4ABB-83CF-BC519A2565E5",
					"quantity" : 545,
					"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/78fe43bc-6aab-4b03-9155-d2813292b239?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f"
				}
			],
			"object_type" : "Order",
			"contract_version" : "1.3",
			"links" : {
				"self" : {
					"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/0b325989-8553-4c18-b498-505f0c9f4283?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f",
					"method" : "GET"
				},
				"patch" : {
					"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/0b325989-8553-4c18-b498-505f0c9f4283",
					"method" : "PATCH"
				},
				"payer" : {
					"href" : "/commerce-accounts/d51a0512-02a2-4363-8184-ef4b470568db",
					"method" : "GET"
				},
				"recipient" : {
					"href" : "/commerce-accounts/5f0c5985-e502-439d-be26-efdee6212c6f",
					"method" : "GET"
				}
			}
		}, {
			"id" : "9806c28c-634c-4bfd-a016-519ee25cb778",
			"recipient_customer_id" : "5f0c5985-e502-439d-be26-efdee6212c6f",
			"etag" : "eyJpZCI6Ijk4MDZjMjhjLTYzNGMtNGJmZC1hMDE2LTUxOWVlMjVjYjc3OCIsInZlcnNpb24iOjF9",
			"creation_date" : "2015-03-21T04:13:25.547+00:00",
			"line_items" : [{
					"line_item_number" : 0,
					"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/195416C1-3447-423A-B37B-EE59A99A19C4",
					"quantity" : 815,
					"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/997c9748-fbfe-4000-80b6-040041cfca30?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f"
				}, {
					"line_item_number" : 1,
					"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/ACA0C06C-890D-4ABB-83CF-BC519A2565E5",
					"quantity" : 729,
					"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/86b70f6d-8c96-4b7d-93ac-38ce27172761?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f"
				}
			],
			"object_type" : "Order",
			"contract_version" : "1.3",
			"links" : {
				"self" : {
					"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/9806c28c-634c-4bfd-a016-519ee25cb778?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f",
					"method" : "GET"
				},
				"patch" : {
					"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/9806c28c-634c-4bfd-a016-519ee25cb778",
					"method" : "PATCH"
				},
				"payer" : {
					"href" : "/commerce-accounts/d51a0512-02a2-4363-8184-ef4b470568db",
					"method" : "GET"
				},
				"recipient" : {
					"href" : "/commerce-accounts/5f0c5985-e502-439d-be26-efdee6212c6f",
					"method" : "GET"
				}
			}
		}
	],
	"total_count" : 2,
	"links" : {
		"self" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f",
			"method" : "GET"
		},
		"add" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders",
			"method" : "POST"
		}
	}
}

Get an order

Obtenez une commande spécifique, conforme à l’ID de commande.

Exemple de requête


GET https : //api.cp.microsoft.com/d51a0512-02a2-4363-8184-ef4b470568db/orders/0b325989-8553-4c18-b498-505f0c9f4283 HTTP/1.1
Accept : application / json
api - version : 2015 - 03 - 31
Authorization : Bearer < SA_Token >
x - ms - correlation - id : e2f93c39 - ca17 - 4ef8 - b450 - 34e445ff6f1e
x - ms - tracking - id : b0d1236b - 0c4f - 4d2f - 86fb - 6d301f7a46fc

Exemple de réponse


HTTP / 1.1 200 OK
api - version : 2015 - 03 - 31
Cache - Control : no - cache
Date : Sat, 21 Mar 2015 04 : 13 : 33 GMT
Pragma : no - cache
Server : Microsoft - IIS / 7.5
Strict - Transport - Security : max - age = 15724800;
includeSubDomains
X - AspNet - Version : 4.0.30319
x - ms - correlation - id : e2f93c39 - ca17 - 4ef8 - b450 - 34e445ff6f1e
x - ms - session - id : 9581d204 - a9cd - 495c - a535 - ffcac742577c
X - Server : BLUOS3OMSORDW02
{
	"id" : "0b325989-8553-4c18-b498-505f0c9f4283",
	"recipient_customer_id" : "5f0c5985-e502-439d-be26-efdee6212c6f",
	"etag" : "eyJpZCI6IjBiMzI1OTg5LTg1NTMtNGMxOC1iNDk4LTUwNWYwYzlmNDI4MyIsInZlcnNpb24iOjF9",
	"creation_date" : "2015-03-21T04:13:32.62+00:00",
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/195416C1-3447-423A-B37B-EE59A99A19C4",
			"quantity" : 522,
			"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/3410f869-fe2a-4528-a2ca-19b791519280?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f"
		}, {
			"line_item_number" : 1,
			"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/ACA0C06C-890D-4ABB-83CF-BC519A2565E5",
			"quantity" : 545,
			"resulting_subscription_uri" : "/d51a0512-02a2-4363-8184-ef4b470568db/subscriptions/78fe43bc-6aab-4b03-9155-d2813292b239?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f"
		}
	],
	"object_type" : "Order",
	"contract_version" : "1.3",
	"links" : {
		"self" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/0b325989-8553-4c18-b498-505f0c9f4283?recipient_customer_id=5f0c5985-e502-439d-be26-efdee6212c6f",
			"method" : "GET"
		},
		"patch" : {
			"href" : "/d51a0512-02a2-4363-8184-ef4b470568db/orders/0b325989-8553-4c18-b498-505f0c9f4283",
			"method" : "PATCH"
		},
		"payer" : {
			"href" : "/commerce-accounts/d51a0512-02a2-4363-8184-ef4b470568db",
			"method" : "GET"
		},
		"recipient" : {
			"href" : "/commerce-accounts/5f0c5985-e502-439d-be26-efdee6212c6f",
			"method" : "GET"
		}
	}
}

Change an order

L’entrée d’une commande PATCH (correctif) utilise une ressource identique à celle d’une commande POST (publication). Pour ajuster une ressource existante de commande, utilisez l’API PATCH /orders/{id}. Transmettez les champs requis qui sont validés dans une commande POST, plus les URI d’éligibilité de référence de l’abonnement. Cet appel d’API prend en charge les scénarios suivants :

  • Diminuer ou augmenter la quantité
  • Commander des abonnements à des modules complémentaires
  • Convertir un abonnement (les exemples de requête et de réponse ne sont actuellement pas disponibles)

Increase or decrease quantity

Ce scénario implique la modification de la quantité d’un poste dans une commande traitée avec succès. Notez que la quantité correspond au nombre d’utilisateurs d’un abonnement. Par exemple, un abonnement présente 10 licences pour 10 utilisateurs. La définition de la propriété de quantité d’un abonnement ne provoque aucune attribution de licence dans le répertoire, ni aucun approvisionnement de ressources de charge de travail. La quantité est simplement l’une des propriétés de l’abonnement.

Exemple de requête


PATCH https : //api.cp.microsoft.com/d51a0512-02a2-4363-8184-ef4b470568db/orders/57bbcebd-4c98-4fc2-a2a8-fce5a64ba889 HTTP/1.1
Accept : application / json
api - version : 2015 - 03 - 31
Authorization : Bearer < SA_Token >
If - Match : "eyJpZCI6IjU3YmJjZWJkLTRjOTgtNGZjMi1hMmE4LWZjZTVhNjRiYTg4OSIsInZlcnNpb24iOjF9"
x - ms - correlation - id : 87815769 - 7754 - 42fa - b15a - df59be3350f3
x - ms - tracking - id : 2a18704d - 9fe7 - 41a0 - a50f - 56cdeeefe11b
{
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/3c95518e-8c37-41e3-9627-0ca339200f53/offers/195416C1-3447-423A-B37B-EE59A99A19C4",
			"quantity" : 580,
			"reference_entitlement_uris" : ["/24903bf3-9acf-4656-90d8-d71c8ba8545a/Entitlements/bdd7d173-889c-4496-a23d-3ec874535736"]
		}
	]
}

Exemple de réponse


HTTP / 1.1 200 OK
api - version : 2015 - 03 - 31
Cache - Control : no - cache
Date : Sat, 21 Mar 2015 04 : 19 : 59 GMT
Pragma : no - cache
Server : Microsoft - IIS / 7.5
Strict - Transport - Security : max - age = 15724800;
includeSubDomains
X - AspNet - Version : 4.0.30319
x - ms - correlation - id : 87815769 - 7754 - 42fa - b15a - df59be3350f3
x - ms - session - id : 69ec8846 - e0a6 - 4a97 - a002 - d4c1736d7122
X - Server : BLUOS3OMSORDW02

Order an add-on subscription

Un abonnement à un module complémentaire est une commande de client relative à une extension ou à un ajout à un service auquel un client est déjà abonné. Un abonnement à un module complémentaire peut également être considéré comme un abonnement enfant.

Exemple de requête


PATCH https : //api.cp.microsoft.com/d51a0512-02a2-4363-8184-ef4b470568db/orders/501a860c-1698-442b-808c-4b612ccf35f2 HTTP/1.1
Accept : application / json
api - version : 2015 - 03 - 31
Authorization : Bearer < SA_Token >
If - Match : "eyJpZCI6IjUwMWE4NjBjLTE2OTgtNDQyYi04MDhjLTRiNjEyY2NmMzVmMiIsInZlcnNpb24iOjF9"
x - ms - correlation - id : cbc61661 - c3a4 - 4dc4 - 9b22 - 02c55e089f31
x - ms - tracking - id : 9100e1ad - 3845 - 4c0d - 8563 - 75a56017ccad{
	"line_items" : [{
			"line_item_number" : 0,
			"offer_uri" : "/16071d9f-efec-4282-a42e-a495eea76ae0/offers/2828BE95-46BA-4F91-B2FD-0BEF192ECF60",
			"quantity" : 874,
			"reference_entitlement_uris" : ["/ea87085f-f91a-4d10-85e0-60782592ffbb/Entitlements/9a9c8ec2-4506-4ebf-9a88-eed21a5eb556"]
		}
	]
}

Exemple de réponse


HTTP / 1.1 200 OK
api - version : 2015 - 03 - 31
Cache - Control : no - cache
Date : Sat, 21 Mar 2015 04 : 35 : 42 GMT
Pragma : no - cache
Server : Microsoft - IIS / 7.5
Strict - Transport - Security : max - age = 15724800;
includeSubDomains
X - AspNet - Version : 4.0.30319
x - ms - correlation - id : cbc61661 - c3a4 - 4dc4 - 9b22 - 02c55e089f31
x - ms - session - id : 868979ea - bf3d - 47e9 - 92a5 - 8f748709813e
X - Server : BLUOS3OMSORDW02

Convertir un abonnement

Une conversion d’abonnement consiste en la transition d’un abonnement existant vers un abonnement présentant de nouvelles conditions. La référence de l’abonnement et le produit utilisé par le destinataire restent inchangés, ce qui signifie que le droit d’éligibilité demeure identique. Mais l’offre est modifiée, par exemple, un abonnement associé à un paiement à l’utilisation est converti en un abonnement à engagement monétaire. Notez que d’autres types de conversions peuvent apparaître à l’avenir.

Par rapport aux transitions d’abonnements, les conversions sont plus simples pour le destinataire, qui ne subit aucune modification d’attribution de licences.

Remarque  Bien que le passage d’une version d’évaluation vers un abonnement payant soit un exemple de conversion d’abonnement, les droits d’éligibilité sont ici modifiés ; en effet, l’indicateur d’évaluation disparaît.
 

Exemple de requête


NA

Exemple de réponse


NA

 

 

Afficher: