Ресурсы корзины

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

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

Корзина

Описывает тележку.

Свойство	Тип	Описание
идентификатор	струна	Идентификатор корзины, предоставленный при успешном создании корзины.
creationTimeStamp	Дата и время	Дата создания корзины в формате даты и времени. Применено после успешного создания корзины.
ВремяПоследнегоИзменения	Дата и время	Дата последнего обновления корзины в формате даты и времени. Применено после успешного создания корзины.
отметкаВремениИстечения	Дата и время	Дата, когда истекает срок действия корзины, указана в формате даты и времени. Применено после успешного создания корзины.
последнийПользовательИзменил	струна	Пользователь, который последний раз обновил корзину. Применено после успешного создания корзины.
lineItems	Массив объектов	Массив ресурсов CartLineItem.
статус	струна	Состояние корзины. Допустимые значения: "Активный" (можно обновить/отправить) и "Заказанный" (уже отправлено).

Элемент строки корзины

Представляет один элемент, содержащийся в корзине.

Свойство	Тип	Описание
идентификатор	струна	Уникальный идентификатор для элемента строки корзины. Применено после успешного создания корзины.
идентификаторЭлементаКаталога	струна	Идентификатор элемента каталога.
дружественное имя	струна	Необязательный. Понятное имя элементa, заданного партнёром, чтобы помочь с уточнением.
количество	int	Количество лицензий или экземпляров.
код валюты	струна	Код валюты.
платежный цикл	Объект	Тип цикла выставления счетов, заданный в течение текущего периода.
Длительность срока	струна	Представление продолжительности термина в формате ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года).
Участники	Список пар строк объекта	Коллекция строк для идентификатора партнёра, зафиксированного при покупке.
контекст настройки	Строка<словаря, строка>	Дополнительный контекст, используемый при настройке приобретенного товара. Чтобы определить, какие значения необходимы для определенного элемента, обратитесь к свойству provisioningVariables SKU.
группа заказов	струна	Группа, указывающая, какие элементы можно отправить вместе в одном порядке.
дополнительные элементы	Список объектов CartLineItem	Набор элементов корзины для дополнений. Эти элементы приобретаются в рамках базовой подписки, которая является следствием покупки основного элемента корзины.
ошибка	Объект	Применяется после создания корзины, если произошла ошибка.
продлениеTo	Массив объектов	Массив ресурсов RenewsTo.
АттестацияПринята	bool	Указывает на согласие с условиями предложения или SKU. Требуется только для предложений или артикулов, где SkuAttestationProperties или OfferAttestationProperties строго обязательны, и значение Attestation установлено как Истина.
promotionId	струна	Идентификатор акции, который будет применен к элементу корзины.
дата окончания пользовательского срока	Дата и время	Дата окончания первого срока выставления счетов новой подписки.

Участники

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

Свойство	Тип	Описание
транзакция_реселлер	струна	Идентификатор партнера торгового посредника, управляющего клиентом.
дополнительная_транзакция_перепродавец	струна	Дополнительные идентификаторы других партнеров, участвующих в транзакции или управлении клиентом. Это свойство применимо только к распространителям, работающим на рынках ЕС/EFTA.

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

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

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

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

Представляет один элемент, содержащийся в строке товара в корзине.

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

ScheduledNextTermInstructions

В этой таблице описываются свойства scheduledNextTermInstructions для обновления пробного предложения на основе лицензии для новых коммерческих возможностей (NCE). Если значения не указаны, пробные версии преобразуются в платные подписки, которые обновляются на ежегодный срок с ежемесячным выставлением счетов и 25 лицензиями.

Свойство	Тип	Обязательно	Описание
продукт	массив	Нет	Массив, который указывает на предложение, в которое преобразуется пробная подписка, а также на срок и частоту выставления счетов, применяемые к платной подписке.
количество	int	Нет	Количество лицензий, которое имеет соответствующая платная подписка после продления пробного предложения.

Продукт

В этой таблице описываются свойства productTerm для продления пробного предложения NCE, основанного на лицензиях. Если в этом массиве нет значений, пробные версии преобразуются в платные подписки с ежегодной длительностью и ежемесячной оплатой.

Свойство	Тип	Обязательно	Описание
productId	струна	Нет	Идентификатор GUID, отформатированный для описания продукта платной подписки, в которую преобразуется пробная версия.
skuId	струна	Нет	Идентификатор GUID, отформатированный для представления номера SKU платной подписки, в которую продлевается пробная версия.
availabilityId	струна	Нет	Идентификатор GUID, отформатированный для представления доступности платной подписки, в которую преобразуется пробная версия.
платежный цикл	струна	Нет	Частота выставления счетов для соответствующей платной подписки после продления пробного периода.
Длительность срока	струна	Нет	Срок действия соответствующей платной подписки после продления пробного предложения.

Коды успешных ответов и ошибок

Каждый ответ поставляется с кодом состояния HTTP, который указывает на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и дополнительных параметров. Полный список см. в коды ошибок Центра партнеров.

CartError

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

Свойство	Тип	Описание
Код ошибки	CartErrorCode	Тип ошибки корзины.
описание ошибки	струна	Описание ошибки, включая любые заметки о поддерживаемых значениях, значениях по умолчанию или ограничениях.
дополнительная информация	ДополнительнаяИнформация	Дополнительные сведения об ошибке.

Дополнительная информация

Дополнительные сведения об ошибке.

Свойство	Тип	Описание
доступное количество	int	Количество оставшихся лицензий, которые можно приобрести для заданного номера SKU продукта.
купленное количество	int	Количество приобретенных лицензий.

CartErrorCode

Типы ошибок корзины.

Имя	Код ошибки	Описание
ВалютаНеПоддерживается	10000	Валюта не поддерживается для данного рынка
ИдентификаторТовараКаталогаНедействителен	10001	Недопустимый идентификатор элемента каталога
КвотаНедоступна	10002	Недостаточно квоты
ИнвентарьНедоступен	10003	Инвентаризация недоступна для выбранного предложения
УчастникиНеПоддерживаютсяДляПартнера	10004	Настройка участников не поддерживается для Партнера.
Невозможно обработать элемент строки корзины	10006	Не удалось обработать элемент строки корзины.
Подписка недействительна	10007	Подписка недействительна.
Подписка не активирована для RI	10008	Подписка не поддерживается для покупки по предварительному бронированию.
Превышен лимит песочницы	10009	Превышено ограничение песочницы.
НедопустимыйВвод	10010	Универсальные входные данные недопустимы.
ПодпискаНеЗарегистрирована	10011	Подписка недействительна.
АттестацияНеПринята	10012	Аттестация не была принята.
Превышено максимальное количество мест на подписку	10015	Запрошенное количество мест превышает ограничение.
Неизвестный	0	Значение по умолчанию

Результат оформления заказа корзины

Представляет результат оформления заказа.

Свойство	Тип	Описание
Заказы	Список объектов Order.	Коллекция заказов.
ошибки заказа	Список объектов OrderError.	Коллекция ошибок заказа.

Ошибка заказа

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

Свойство	Тип	Описание
идентификаторГруппыЗаказа	струна	Идентификатор группы заказа с ошибкой.
код	int	Код ошибки.
описание	струна	Описание ошибки.