Ресурсы корзины
применимо к: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud для государственных организаций США
Партнер помещает заказ, когда клиент хочет приобрести подписку из списка предложений.
Корзина
Описывает тележку.
| Свойство | Тип | Описание |
|---|---|---|
| идентификатор | струна | Идентификатор корзины, предоставленный при успешном создании корзины. |
| creationTimeStamp | Дата и время | Дата создания корзины в формате даты и времени. Применено после успешного создания корзины. |
| ВремяПоследнегоИзменения | ДатаВремя | Дата последнего обновления корзины в формате даты и времени. Применяется после успешного создания корзины. |
| отметкаВремениИстечения | Дата и Время | Дата истечения срока действия корзины, приведенная в формате даты и времени. Применено после успешного создания корзины. |
| последнийПользовательИзменил | струна | Пользователь, который последний раз обновил корзину. Применяется после успешного создания корзины. |
| lineItems | Массив объектов | Массив ресурсов CartLineItem. |
| статус | струна | Состояние корзины. Возможные значения: "Активный" (можно обновить или подать) и "Оформлено" (уже отправлено). |
Элемент строки корзины
Представляет один элемент, содержащийся в корзине.
| Свойство | Тип | Описание |
|---|---|---|
| идентификатор | струна | Уникальный идентификатор для элемента строки корзины. Применено после успешного создания корзины. |
| идентификаторЭлементаКаталога | струна | Идентификатор элемента каталога. |
| дружественное имя | струна | Необязательный. Понятное имя элементa, заданного партнёром, чтобы помочь с уточнением. |
| количество | int | Количество лицензий или экземпляров. |
| код валюты | струна | Код валюты. |
| платежный цикл | Объект | Тип цикла выставления счетов, заданный в течение текущего периода. |
| Длительность срока | струна | Представление продолжительности термина в формате ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года). |
| Участники | Список пар строк объекта | Коллекция PartnerID on Record для покупки. |
| контекст настройки | Строка<словаря, строка> | Дополнительный контекст, используемый при предоставлении приобретенного элемента. Чтобы определить, какие значения необходимы для определенного элемента, обратитесь к свойству provisioningVariables SKU. |
| группа заказов | струна | Группа, указывающая, какие элементы можно отправить вместе в одном порядке. |
| дополнительные элементы | Список объектов CartLineItem | Набор элементов корзины для дополнений. Эти позиции будут приобретаться в рамках основной подписки, которая формируется на основе покупки главного элемента корзины. |
| ошибка | Объект | Применяется после создания корзины, если произошла ошибка. |
| продлениеTo | Массив объектов | Массив ресурсов RenewsTo. |
| АттестацияПринята | bool | Указывает на согласие с условиями предложения или SKU. Требуется только для предложений или артикулов, где SkuAttestationProperties или OfferAttestationProperties строго обязательны, и значение Attestation установлено как Истина. |
| promotionId | струна | Идентификатор акции, который будет применен к элементу корзины. |
| дата окончания пользовательского срока | DateTime | Дата окончания первого срока выставления счетов новой подписки. |
Ценообразование
Представляет сведения о цене. Суммы цен предоставляются до налогообложения.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
| цена по прейскуранту | двойной | Нет | Цена, указанная в каталоге без каких-либо модификаторов цен. |
| цена со скидкой | двойной | Нет | Цена после применения всех применимых модификаторов цен. |
| пропорциональная цена | двойной | Нет | Цена со скидкой после перерасчета. |
| цена | двойной | Нет | Цена в применимой валюте выставления счетов после применения всех скидок и проведения пропорционального расчета. |
| расширенная цена | двойной | Нет | Цена элемента строки с учетом количества, скидок и пропорционального распределения в соответствующей валюте выставления счетов. |
Продлевается до
Представляет один элемент, содержащийся в строке товара в корзине.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
| срок действия | струна | Нет | Представление срока продления в формате ISO 8601. Текущие поддерживаемые значения : P1M (один месяц) и P1Y (один год). |
Коды успешных ответов и ошибок
Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и дополнительных параметров. Полный список см. в коды ошибок Центра партнеров.
CartError
Представляет ошибку, возникающую после создания корзины.
| Свойство | Тип | Описание |
|---|---|---|
| Код ошибки | CartErrorCode | Тип ошибки корзины. |
| описание ошибки | струна | Описание ошибки, включая любые заметки о поддерживаемых значениях, значениях по умолчанию или ограничениях. |
| дополнительная информация | ДополнительнаяИнформация | Дополнительные сведения об ошибке. |
Дополнительная информация
Дополнительные сведения об ошибке.
| Свойство | Тип | Описание |
|---|---|---|
| доступное количество | int | Количество оставшихся лицензий, которые можно приобрести для заданного номера SKU продукта. |
| купленное количество | int | Количество приобретенных лицензий. |
CartErrorCode
Типы ошибок корзины.
| Имя | Код ошибки | Описание |
|---|---|---|
| ВалютаНеПоддерживается | 10000 | Валюта не поддерживается для данного рынка |
| ИдентификаторТовараКаталогаНедействителен | 10001 | Недопустимый идентификатор элемента каталога |
| КвотаНедоступна | 10002 | Недостаточно квоты |
| ИнвентарьНедоступен | 10003 | Инвентаризация недоступна для выбранного предложения |
| УчастникиНеПоддерживаютсяДляПартнера | 10004 | Настройка участников не поддерживается для Партнера. |
| Невозможно обработать элемент строки корзины | 10006 | Не удалось обработать элемент строки корзины. |
| Подписка недействительна | 10007 | Подписка недействительна. |
| Подписка не активирована для RI | 10008 | Подписка не поддерживается для покупки по предварительному бронированию. |
| Превышен лимит песочницы | 10009 | Превышено ограничение песочницы. |
| НедопустимыйВвод | 10010 | Универсальные входные данные недопустимы. |
| ПодпискаНеЗарегистрирована | 10011 | Подписка недействительна. |
| АттестацияНеПринята | 10012 | Аттестацию не приняли. |
| Превышено максимальное количество мест на подписку | 10015 | Запрошенное количество мест превышает ограничение. |
| Неизвестный | 0 | Значение по умолчанию |
Результат оформления заказа корзины
Представляет результат оформления заказа.
| Свойство | Тип | Описание |
|---|---|---|
| Заказы | Список объектов Order. | Коллекция заказов. |
| ошибки заказа | Список объектов OrderError. | Коллекция ошибок заказа. |
Ошибка заказа
Представляет ошибку, возникающую при оформлении корзины при создании заказа.
| Свойство | Тип | Описание |
|---|---|---|
| идентификаторГруппыЗаказа | струна | Идентификатор группы заказа с ошибкой. |
| код | инт | Код ошибки. |
| описание | струна | Описание ошибки. |