Заказ ресурсов

применимо к: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud для государственных организаций США

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

Заметка

Ресурс Order имеет ограничение скорости в 500 запросов в минуту на идентификатор клиента.

Заказ

Описывает заказ партнера.

Свойство	Тип	Описание
идентификатор	струна	Идентификатор заказа, предоставленный при успешном создании заказа.
alternateId	струна	Удобный идентификатор заказа.
идентификаторРеференсногоКлиента	струна	Идентификатор клиента.
платежный цикл	струна	Указывает частоту выставления счетов партнером за этот заказ. Поддерживаемые значения — это имена элементов, найденные в BillingCycleType. По умолчанию при создании заказа используется ежемесячный или одноразовый вариант. Это поле применяется при успешном создании заказа.
тип транзакции	струна	Только для чтения. Тип транзакции заказа. Поддерживаемые значения: UserPurchase, SystemPurchaseили SystemBilling
lineItems	массив ресурсов OrderLineItem	Детализированный список предложений, которые покупает клиент, включая количество.
код валюты	струна	Только для чтения. Валюта, используемая при размещении заказа. Применяется после успешного создания заказа.
символ валюты	струна	Только для чтения. Символ валюты, связанный с кодом валюты.
датаСоздания	дата и время	Только для чтения. Дата создания заказа в формате даты и времени. Применяется после успешного создания заказа.
статус	струна	Только для чтения. Состояние заказа. Поддерживаемые значения — это имена элементов, найденные в OrderStatus.
ссылки	OrderLinks	Ссылки на ресурсы, соответствующие заказу.
Атрибуты	ResourceAttributes	Атрибуты метаданных, соответствующие заказу.

ЭлементЗаказа

Заказ содержит детализованный список предложений, и каждый элемент представлен как OrderLineItem.

Свойство	Тип	Описание
номерПозицииЗаказа	int	Каждый элемент в коллекции строк получает уникальный номер, начиная с 0 и заканчивая count-1.
offerId	струна	Идентификатор предложения.
идентификатор подписки	струна	Идентификатор подписки.
идентификатор родительской подписки	струна	Необязательный. Идентификатор родительской подписки в предложении по дополнению. Применяется только к PATCH.
дружественное имя	струна	Необязательный. Удобное для понимания имя подписки, определенное партнером, чтобы помочь разрешить неоднозначность.
количество	int	Количество лицензий или экземпляров.
Дата окончания пользовательского срока	ДатаВремя	Дата окончания первого срока выставления счетов новой подписки.
срок действия	струна	Представление длительности термина в формате ISO 8601. Текущие поддерживаемые значения : P1M (1 месяц), P1Y (1 год) и P3Y (3 года).
тип транзакции	струна	Только для чтения. Тип транзакции элемента строки. Поддерживаемые значения: новое, продление, добавление количества, удаление количества, отмена, преобразованиеили кредит клиента.
ID партнера в записях	струна	Если непрямой поставщик размещает заказ от имени непрямого торгового посредника, заполните это поле PartnerID только непрямого торгового посредника (никогда не идентификатор непрямого поставщика). Это обеспечивает надлежащий учет стимулов.
контекст предоставления	ProvisioningContext	Сведения, необходимые для обеспечения некоторых элементов в каталоге. Свойство provisioningVariables в номере SKU указывает, какие свойства необходимы для определенных элементов в каталоге.
ссылки	OrderLineItemLinks	Только для чтения. Ссылки на ресурсы, соответствующие элементу строки заказа.
продлениеTo	обновляется как	Сведения о длительности срока продления.
Аттестация Принята	bool	Указывает подтверждение согласия на предложение или условия SKU. Требуется только для предложений или артикулов, где для SkuAttestationProperties или OfferAttestationProperties enforceAttestation равно True.
Ценообразование	Цены	Сведения о ценах по каталогу.
обязательство по покупке	Обязательство по покупке	Фиксированная сумма, выделенная на вычислительные услуги.

Продляется до

Представляет сведения о сроке продления.

Свойство	Тип	Обязательно	Описание
срок действия	струна	Нет	Представление длительности срока продления в формате ISO 8601. Текущие поддерживаемые значения: P1M (1 месяц) и P1Y (1 год).

Ценообразование

Представляет сведения о цене. Суммы цен предоставляются до налогообложения.

Свойство	Тип	Обязательно	Описание
listPrice	двойной	Нет	Цена, указанная в каталоге без каких-либо модификаторов цен.
цена со скидкой	двойной	Нет	Цена после применения всех применимых модификаторов цен.
пропорциональная цена	двойной	Нет	Цена со скидкой после выполнения пропорционального расчета.
цена	двойной	Нет	Цена в применимой валюте выставления счетов после применения всех скидок и пропорционального распределения выполнено.
расширенная цена	двухместный	Нет	Цена элемента строки с количеством, скидками и с применением пропорциональности в соответствующей валюте выставления счетов.

OrderLinks

Представляет ссылки на ресурсы, соответствующие заказу.

Свойство	Тип	Описание
provisioningStatus	ссылка	При наличии ссылка для получения статуса обеспечения для заказа.
сам	ссылка	Ссылка для извлечения информации о заказе.

OrderLineItemLinks

Представляет полную подписку, связанную с заказом.

Свойство	Тип	Описание
provisioningStatus	ссылка	При заполнении ссылка для получения состояния подготовки элемента строки.
SKU	Ссылка	Ссылка на получение сведений об номере SKU для приобретенного элемента каталога.
подписка	ссылка	При заполнении ссылка на полную информацию о подписке.
ссылки активации	ссылка	Когда ресурс GET заполнен, предоставляются ссылки для активации подписки.

Статус заказа

Объект [Enum/dotnet/api/system.enum] со значениями, указывающими на состояние заказа.

Ценность	Позиция	Описание
неизвестный	0	Инициализатор перечисления.
завершено	1	Заказ завершен.
в ожидании	2	Заказ обрабатывается.
Отменен	3	Заказ отменен.
приостановленный	4	Заказ приостановлен. Дополнительные сведения см. в статье состояния жизненного цикла подписки — NCE приостановлено.
Ожидание проверки	5	Заказ ожидает вторичной проверки. Партнёрам может потребоваться загрузка документации. Чтобы узнать, чего ожидать, если вас выбрали для дополнительного обзора сделки, ознакомьтесь с обучающим комплектом по вторичным сделкам.
ожидание загрузки заказа	6	Партнер должен загрузить свой заказ на покупку клиента и ввести сведения, как указано, для проверки Майкрософтом.
отправка po завершена	7	Заказ на покупку (PO) был отправлен партнером, и корпорация Майкрософт его рассматривает. Никаких дальнейших действий, необходимых партнеру.
обзор заказа отклонен	8	Этот заказ не прошел дополнительный обзор и не будет обработан.
частичный успех	9	Одна или несколько подписок в заказе имеют проблему. Партнеры должны повторно выкупить незаполненные подписки.
ошибка	10	Заказ вызвал ошибку. Партнеры должны повторно выкупить.

Статус обеспечения позиции заказа

Представляет статус обеспечения OrderLineItem.

Свойство	Тип	Описание
номер элемента строки	int	Уникальный номер позиции заказа. Диапазон значений от 0 до count-1.
статус	струна	Статус предоставления заказанного элемента. К значениям относятся: Выполнено: выполнение заказа успешно завершено, и пользователь сможет использовать резервирования Невыполнено: не выполнено из-за отмены PrefulfillmentPending: Ваш запрос по-прежнему обрабатывается, выполнение еще не завершено.
информация о предоставлении количества	Список<QuantityProvisioningStatus>	Список сведений о состоянии обеспечения количеств для позиции заказа.

СтатусОбеспеченияКоличество

Представляет статус предоставления по количеству.

Свойство	Тип	Описание
количество	int	Количество элементов.
статус	струна	Состояние количества элементов.

Контекст настройки

Сведения, необходимые для предоставления некоторых товаров в каталоге. Свойство provisioningVariables в номере SKU указывает, какие свойства необходимы для определенных элементов в каталоге.

Свойство	Тип	Описание
размах	струна	Тип области покупки, указывающий, где применяются преимущества: single,Shared.
идентификатор прав	струна	Идентификатор подписки Azure, которая будет использоваться для покупки. Требуется для одного скопа.

Покупательское обязательство

Фиксированная сумма, выделенная на вычислительные услуги.

Свойство	Тип	Описание
количество	int	Обязательство фиксированной суммы.
валюта	струна	Валюта обязательства.
зерно	струна	Период обязательства.