Заказы

В этом разделе

В этом разделе приведены примеры для выполнения указанных ниже действий.

Примеры

Create an order

Создание заказа немедленно возвращает ресурс заказа, но ресурс может обрабатывать в фоновом режиме. Чтобы определить текущее состояние обработки заказа, подписывайтесь для получения событий подписки.

Чтобы создать заказ, выполните перечисленные ниже действия.

  1. Загрузите список поддерживаемых предложений для приобретения и сведения о них. Ваш менеджер по работе с партнерами Майкрософт должен предоставить вам веб-ссылку на полный список предложений.
  2. Укажите строковые элементы, включенные в заказ. Строковый элемент означает предложение для приобретения.
    • Используйте элемент offer_URI в предоставленной таблице для создания элемента line-item. Не забудьте при создании строковых элементов установить уникальный последовательный номер line_item_number. См. также раздел Ресурс "Заказы".
    • После создания заказа элемент line-item содержит ссылку на подписку, созданную для предложения.
Примечание  

Чтобы создать заказ для добавления торгового посредника 2-го уровня к подписке, передайте идентификатор MPN в поле advisor_partner_id элемента line-item. Если торговый посредник 2-го уровня отсутствует, оставьте поле пустым.

Термин Торговые посредники 2-го уровня означает торговых посредников, которые работают со своими партнерами-дистрибьюторами 2-го уровня, чтобы продавать облачные службы Майкрософт. В других частях документации торговый посредник означает партнер.

 

Пример запроса


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"
}

Пример ответа


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

Пример запроса


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"
}

Пример ответа



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

Пример запроса


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"
}

Пример ответа


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

При переходе по подписке продукт, используемый получателем, меняется. В результате, предложение и SKU также меняются. Когда выполняется переход, создается новый заказ с новой подпиской и правами на вознаграждение. Типичный сценарий перехода происходит с продуктами, объединенными в пакеты. Например, когда клиент переходит из подписки Exchange на полную подписку на Office 365.

При переходе исходная подписка остается активной, пока не будет подготовлена новая подписка. После этого исходная подписка будет приостановлена.

Переходы подписки, для которых требуется переназначение лицензии, являются более углубленными, чем преобразования подписки. Преобразования подписки являются более простыми с точки зрения получателя. При этом отсутствуют какие-либо последствия переназначения лицензии.

Примечание  Не каждое предложение дает право на переход.
 

Пример запроса


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"
}

Пример ответа


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

Получите ресурс взимания платы, содержащий все заказы, которые принадлежат идентификатору recipient_customer_id, указанному в URI.

Пример запроса


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

Пример ответа


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

Получите конкретный заказ, которому присвоен идентификатор заказа.

Пример запроса


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

Пример ответа


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

Для ввода заказа PATCH используется тот же ресурс, что и для заказа POST. Чтобы изменить ресурс существующего заказа, используйте API PATCH /заказы/{идентификатор}. Задайте требуемые поля, которые проверяются в заказе POST, а также параметр reference_entitlement_uris подписки. Этот вызов API поддерживает сценарии:

  • Увеличение или уменьшение количества
  • Заказ подписки на надстройку
  • Преобразование подписки (примеры запроса и ответа в настоящее время недоступны)

Increase or decrease quantity

Этот сценарий включает в себя изменение количества элемента в успешно обработанном заказе. Обратите внимание, что количество — это число мест подписки. Например, подписка имеет 10 лицензий для 10 пользователей. Настройка свойства количества в подписке не вызывает фактическое назначение лицензии в каталоге или подготовку каких-либо фактических ресурсов нагрузки. Количество является всего лишь свойством подписки.

Пример запроса


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"]
		}
	]
}

Пример ответа


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

Подписка на надстройку — это заказ клиента для предложения, которое расширяется или добавляется к службе, на которую клиент уже подписан. Подписку на надстройку можно также считать дочерней подпиской.

Пример запроса


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"]
		}
	]
}

Пример ответа


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

Преобразование подписки

Преобразование подписки предусматривает преобразование существующей подписки в подписку с новыми условиями. SKU подписки и продукта, используемый получателем, остается неизменным. Это означает, что права на вознаграждение не меняются. Но предложение меняется, например, преобразование подписки с моделью оплаты по факту в подписку с денежными обязательствами. Обратите внимание, что в будущем могут быть другие типы преобразований.

По сравнению с переходами по подписке, преобразования являются более простыми с точки зрения получателя и не имеют каких-либо последствий назначения лицензии.

Примечание  Хотя переход от пробной к платной подписке является примером преобразования подписки, права на вознаграждение в данном случае меняются. Это обозначается потерей тега пробной версии.
 

Пример запроса

Пример ответа

 

 

Показ: