Ресурсы TransferEntity
Партнер создает передачу текущему партнеру клиента. Текущий или исходный партнер принимает передачу и отправляет его для завершения передачи.
TransferEntity
Описывает передачу данных для новых коммерческих переводов.
| Свойство | Type | Описание |
|---|---|---|
| Идентификатор | строка | Идентификатор transferEntity, предоставленный при успешном создании transferEntity. |
| статус | строка | Состояние transferEntity. Возможные значения: "Активный" (можно удалить или отправить) и "Завершено" (уже завершено). Применено к успешному созданию transferEntity. |
| transferType | строка | Число, представляющее тип передачи. 3 разрешается в ModernAzure и 5 разрешается в New Commerce. Партнеры, выполняющие партнерские передачи новой коммерции, могут использовать либо, но должны стандартизировать 5. |
| customerEmailId | строка | Определяет электронную почту клиента, используемую для уведомлений. |
| createdTime | Дата/время | Дата создания transferEntity в формате даты и времени. Применено к успешному созданию transferEntity. |
| lastModifiedTime | Дата/время | Дата последнего обновления transferEntity в формате даты и времени. Применено к успешному созданию transferEntity. |
| completedTime | Дата/время | Дата завершения передачиEntity в формате даты и времени. Применено к успешному завершению transferEntity. |
| customerName | строка | Необязательно. Имя клиента, подписки которого передаются. |
| customerTenantId | строка | Идентификатор guid, отформатированный идентификатором клиента, идентифицирующий клиента. Применено к успешному созданию transferEntity. |
| partnertenantid | строка | Идентификатор партнера в формате GUID, определяющий партнера. |
| sourcePartnerName | строка | Необязательно. Имя организации партнера, инициирующей передачу. |
| targetPartnerName | строка | Необязательно. Имя организации партнера, на которую направлена передача. |
| targetPartnerTenantId | строка | Идентификатор guid отформатированного партнера, определяющий партнера, которому предназначен перенос. |
| targetPartnerEmailId | строка | Идентификатор GUID, отформатированный pid, определяющий партнера, которому направлена передача. Этот идентификатор совпадает с targetPartnerTenantId |
| transferDirection | строка | Число, представляющее направление передачи. 1 представляет входящие передачи для партнера, который принимает передачу. 2 представляет исходящую передачу для партнера, который создает передачу. |
| ignoreEligibilityCheck | строка | Это значение должно быть false. |
| lastModifiedUser | строка | Идентификатор пользователя с форматированием GUID, определяющий последнего пользователя для изменения передачи. |
| lineItems | Массив объектов | Массив ресурсов TransferLineItem . |
TransferLineItem
Представляет один элемент, содержащийся в новой коммерческой передачеEntity. Исходные партнеры видят элементы строки для передачи элементов, которые они пытаются передать. Целевые партнеры видят только что созданные элементы строки после завершения. Целевые партнеры могут использовать идентификаторы элементов строки, чтобы понять только что созданные подписки, которые приводят к передаче.
| Свойство | Type | Описание |
|---|---|---|
| Идентификатор | строка | Уникальный идентификатор для элемента строки передачи. Применено к успешному созданию transferEntity. |
| subscriptionId | строка | Идентификатор подписки. |
| quantity | INT | Количество лицензий или экземпляров. |
| billingCycle | Object | Тип период выставления счетов задан для текущего периода. |
| productType | строка | Строка, представляющая тип переданного продукта. |
| статус | строка | Состояние lineitem в transferEntity. |
TransferEntity для традиционных передач на основе лицензий
Описывает transferEntity.
| Свойство | Type | Описание |
|---|---|---|
| Идентификатор | строка | Идентификатор transferEntity, предоставленный при успешном создании transferEntity. |
| createdTime | Дата/время | Дата создания transferEntity в формате даты и времени. Применено к успешному созданию transferEntity. |
| lastModifiedTime | Дата/время | Дата последнего обновления transferEntity в формате даты и времени. Применено к успешному созданию transferEntity. |
| lastModifiedUser | строка | Пользователь, который последний раз обновил transferEntity. Применено к успешному созданию transferEntity. |
| customerName | строка | Необязательно. Имя клиента, подписки которого передаются. |
| customerTenantId | строка | Идентификатор guid, отформатированный идентификатором клиента, идентифицирующий клиента. Применено к успешному созданию transferEntity. |
| partnertenantid | строка | Идентификатор партнера в формате GUID, определяющий партнера. |
| sourcePartnerName | строка | Необязательно. Имя организации партнера, инициирующей передачу. |
| sourcePartnerTenantId | строка | Идентификатор guid отформатированного партнера, определяющий партнера, инициирующего передачу. |
| targetPartnerName | строка | Необязательно. Имя организации партнера, на которую направлена передача. |
| targetPartnerTenantId | строка | Идентификатор guid отформатированного партнера, определяющий партнера, которому предназначен перенос. |
| lineItems | Массив объектов | Массив ресурсов TransferLineItem . |
| статус | строка | Состояние transferEntity. Возможные значения: "Активный" (можно удалить или отправить) и "Завершено" (уже завершено). Применено к успешному созданию transferEntity. |
TransferLineItem для традиционных передач на основе лицензий
Представляет один элемент, содержащийся в transferEntity.
| Свойство | Type | Описание |
|---|---|---|
| Идентификатор | строка | Уникальный идентификатор для элемента строки передачи. Применено к успешному созданию transferEntity. |
| subscriptionId | строка | Идентификатор подписки. |
| quantity | INT | Количество лицензий или экземпляров. |
| billingCycle | Object | Тип период выставления счетов задан для текущего периода. |
| friendlyName | строка | Необязательно. Понятное имя элемента, определенного партнером, чтобы помочь диамбигуат. |
| partnerIdOnRecord | строка | PartnerId on Record на покупку, которая происходит при принятии передачи. |
| offerId | строка | Идентификатор предложения. |
| addonItems | Список объектов TransferLineItem | Коллекция элементов строки transferEntity для надстроек, передаваемых вместе с базовой подпиской, которая передается. Применено к успешному созданию transferEntity. |
| transferError | строка | Применяется после принятия transferEntity в случае возникновения ошибки. |
| статус | строка | Состояние lineitem в transferEntity. |
TransferSubmitResult
Представляет результат передачи для традиционных передач на основе лицензий.
| Свойство | Type | Описание |
|---|---|---|
| заказы | Список объектов Order. | Коллекция заказов. |
| transferErrors | Список объектов TransferError. | Коллекция ошибок передачи. |
TransferError
Представляет ошибку, возникающую при принятии традиционной передачи на основе лицензий.
| Свойство | Type | Описание |
|---|---|---|
| transferGroupId | строка | Идентификатор группы заказов заказа с ошибкой. |
| кодом | INT | Код ошибки. |
| описание | строка | Описание ошибки. |
| lineItems | Список объектов TransferLineItem | Коллекция элементов строки transferEntity, которые являются частью ошибки передачи. |
TransferErrorCode
[Enum/dotnet/api/system.enum) со значениями, указывающими тип ошибки заказа для традиционных передач на основе лицензий.
| Значение | Position | Description |
|---|---|---|
| PartnerTokenMissing | 800001 | Маркер партнера отсутствует в контексте запроса. |
| InvalidInput | 800002 | Недопустимые входные данные запроса. |
| ServiceException | 800003 | Непредвиденная ошибка службы. |
| InvalidOfferId | 800004 | Недопустимый идентификатор предложения. |
| CreateOrderError | 800005 | Порядок создания не выполнен. |
| MpnIdNotFound | 800015 | Идентификатор партнера не найден. |
| NotValidIndirectResellerMpnId | 800016 | PartnerID не является допустимым косвенным торговым посредником. |
| TransferIdNotFound | 900100 | Запрос на передачу не найден. |
| TransferNotAllowedIfStatusIsInProgress | 900101 | Запрос на передачу уже выполняется. |
| TransferNotAllowedIfStatusIsCompleted | 900102 | Запрос на передачу уже завершен. |
| TransferCreateOrderError | 900103 | Заказ на передачу не выполнен. |
| TransferProcessedByAnotherRequest | 900104 | Передача обрабатывается другим запросом. |