Заказ ресурсов
применимо к: Центр партнеров | Центр партнеров, управляемый 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 | Обязательство фиксированной суммы. |
| валюта | струна | Валюта обязательства. |
| зерно | струна | Период обязательства. |