Ресурсы корзины
Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government
Партнер помещает заказ, когда клиент хочет приобрести подписку из списка предложений.
Корзина
Описывает корзину.
| Свойство | Тип | Описание |
|---|---|---|
| id | строка | Идентификатор корзины, предоставленный при успешном создании корзины. |
| creationTimeStamp | Дата и время | Дата создания корзины в формате даты и времени. Применено к успешному созданию корзины. |
| lastModifiedTimeStamp | Дата и время | Дата последнего обновления корзины в формате даты и времени. Применено к успешному созданию корзины. |
| dateTimeStamp | Дата и время | Срок действия корзины истекает в формате даты и времени. Применено к успешному созданию корзины. |
| lastModifiedUser | строка | Пользователь, который последний раз обновил корзину. Применено к успешному созданию корзины. |
| lineItems | Массив объектов | Массив ресурсов CartLineItem . |
| status | строка | Состояние корзины. Возможные значения: "Активный" (можно обновить или отправить) и "Упорядочено" (уже отправлено). |
CartLineItem
Представляет один элемент, содержащийся в корзине.
| Свойство | Тип | Описание |
|---|---|---|
| id | строка | Уникальный идентификатор для элемента строки корзины. Применено к успешному созданию корзины. |
| catalogItemId | строка | Идентификатор элемента каталога. |
| friendlyName | строка | Необязательно. Понятное имя элемента, определенного партнером, чтобы помочь диамбигуат. |
| quantity | INT | Количество лицензий или экземпляров. |
| currencyCode | строка | Код валюты. |
| billingCycle | Объект | Тип период выставления счетов задан для текущего периода. |
| termDuration | строка | Представление срока действия термина ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года). |
| participants | Список пар строк объекта | Коллекция PartnerID on Record для покупки. |
| provisioningContext | Строка словаря<, строка> | Дополнительный контекст, используемый при подготовке приобретенного элемента. Чтобы определить, какие значения необходимы для определенного элемента, обратитесь к свойству подготовки номера SKU. |
| orderGroup | строка | Группа, указывающая, какие элементы можно отправить вместе в одном порядке. |
| addonItems | Список объектов CartLineItem | Коллекция элементов строки корзины для надстроек. Эти элементы будут приобретены в сторону базовой подписки, которая приводит к покупке корневого элемента корзины. |
| error | Объект | Применяется после создания корзины, если произошла ошибка. |
| продлениеTo | Массив объектов | Массив ресурсов RenewsTo . |
| АттестацияAccepted | bool | Указывает соглашение о предложении или условии SKU. Требуется только для предложений или номеров skus, где SkuAttestationProperties или OfferAttestationProperties принудительное применениеAttestation имеет значение True. |
| promotionId | строка | Идентификатор продвижения, который будет применен к элементу строки корзины. |
| customTermEndDate | Дата и время | Дата окончания первого срока выставления счетов новой подписки. |
Ценообразование
Представляет сведения о цене. Суммы цен предоставляются до налогообложения.
| Свойство | Тип | Обязательное поле | Description |
|---|---|---|---|
| listPrice | двойной точности | Нет | Цена, указанная в каталоге без каких-либо модификаторов цен. |
| скидкаPrice | двойной точности | Нет | Цена после применения всех применимых модификаторов цен. |
| ProratedPrice | двойной точности | Нет | Скидка на цену после того, как была выполнена пропорциональность. |
| цена | двойной точности | Нет | Цена в применимой валюте выставления счетов после применения всех скидок и пропорциональности была выполнена. |
| extendedPrice | двойной точности | Нет | Цена элемента строки с количеством, скидками и пропорциональности применена в применимой валюте выставления счетов. |
ПродлениеTo
Представляет один элемент, содержащийся в строке корзины.
| Свойство | Тип | Обязательное поле | Description |
|---|---|---|---|
| termDuration | строка | Нет | Представление срока продления срока продления в формате ISO 8601. Текущие поддерживаемые значения: P1M (один месяц) и P1Y (один год). |
Коды успешного выполнения и ошибок в ответе
Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. Полный список см. в разделе "Коды ошибок Центра партнеров".
CartError
Представляет ошибку, возникающую после создания корзины.
| Свойство | Тип | Описание |
|---|---|---|
| errorCode | CartErrorCode | Тип ошибки корзины. |
| errorDescription | строка | Описание ошибки, включая любые заметки о поддерживаемых значениях, значениях по умолчанию или ограничениях. |
| additionalInformation | Дополнительная информация | Дополнительные сведения об ошибке. |
AdditionalInformation
Дополнительные сведения об ошибке.
| Свойство | Тип | Описание |
|---|---|---|
| availableQuantity | INT | Количество оставшихся лицензий, которые можно приобрести для заданного номера SKU продукта. |
| purchasedQuantity | INT | Количество приобретенных лицензий. |
CartErrorCode
Типы ошибок корзины.
| Имя | ErrorCode | Description |
|---|---|---|
| CurrencyIsNotSupported | 10000 | Валюта не поддерживается для данного рынка |
| CatalogItemIdIsNotValid | 10001 | Недопустимый идентификатор элемента каталога |
| QuotaNotAvailable | 10002 | Недостаточно квоты |
| InventoryNotAvailable | 10003 | Инвентаризация недоступна для выбранного предложения |
| УчастникиIsNotSupportedForPartner | 10004 | Настройка участников не поддерживается для партнера |
| Не удается ВыполнитьProcessCartLineItem | 10006 | Не удалось обработать элемент строки корзины. |
| SubscriptionIsNotValid | 10007 | Подписка недействительна. |
| SubscriptionIsNotEnabledForRI | 10008 | Подписка не включена для покупок резервирования. |
| SandboxLimitExceeded | 10009 | Превышено ограничение песочницы. |
| InvalidInput | 10010 | Универсальные входные данные недопустимы. |
| SubscriptionNotRegistered | 10011 | Подписка недействительна. |
| АттестацияNotAccepted | 10012 | Аттестация не была принята. |
| MaxAllowedSeatsPerSubscriptionExceeded | 10015 | Запрошенное количество мест превышает ограничение. |
| Неизвестно | 0 | Default value |
CartCheckoutResult
Представляет результат проверка выхода корзины.
| Свойство | Тип | Описание |
|---|---|---|
| заказы | Список объектов Order. | Коллекция заказов. |
| orderErrors | Список объектов OrderError. | Коллекция ошибок заказа. |
OrderError
Представляет ошибку, возникающую во время проверка корзины при создании заказа.
| Свойство | Тип | Описание |
|---|---|---|
| orderGroupId | строка | Идентификатор группы заказов заказа с ошибкой. |
| кодом | INT | Код ошибки. |
| description | строка | Описание ошибки. |