Recursos de TransferEntity
Un asociado crea una transferencia al asociado actual de un cliente. El asociado actual o de origen acepta la transferencia y la envía para completar la transferencia.
TransferEntity
Describe una transferEntity para las nuevas transferencias comerciales.
| Propiedad | Tipo | Descripción |
|---|---|---|
| ID | string | Identificador transferEntity que se proporciona tras la creación correcta de transferEntity. |
| status | string | El estado de transferEntity. Los valores posibles son "Activo" (se puede eliminar o enviar) y "Completado" (ya se ha completado). Aplicado tras la creación correcta de transferEntity. |
| transferType | string | Número que representa el tipo de transferencia. 3 se resuelve en ModernAzure y 5 se resuelve en NewCommerce. Los partners que ejecutan asociados a nuevas transferencias comerciales pueden usar cualquiera de las dos opciones, pero deben estandarizarse en 5. |
| customerEmailId | string | Identifica el correo electrónico del cliente Usado para las notificaciones. |
| createdTime | DateTime | Fecha en que se creó transferEntity, en formato de fecha y hora. Aplicado tras la creación correcta de transferEntity. |
| lastModifiedTime | DateTime | Fecha en que transferEntity se actualizó por última vez, en formato de fecha y hora. Aplicado tras la creación correcta de transferEntity. |
| completedTime | DateTime | Fecha en que se completó transferEntity, en formato de fecha y hora. Aplicado tras la finalización correcta de transferEntity. |
| customerName | string | Opcional. Nombre del cliente cuyas suscripciones se transfieren. |
| customerTenantId | string | Identificador de cliente con formato GUID que identifica al cliente. Aplicado tras la creación correcta de transferEntity. |
| partnertenantid | string | Identificador de asociado con formato GUID que identifica al asociado. |
| sourcePartnerName | string | Opcional. Nombre de la organización del asociado que inicia la transferencia. |
| targetPartnerName | string | Opcional. Nombre de la organización del asociado a la que se dirige la transferencia. |
| targetPartnerTenantId | string | Identificador de asociado con formato GUID que identifica al asociado al que se dirige la transferencia. |
| targetPartnerEmailId | string | Guid con formato pid que identifica al asociado al que se dirige la transferencia. Este identificador es el mismo que targetPartnerTenantId. |
| transferDirection | string | Número que representa la dirección de la transferencia. 1 representa una transferencia entrante para el asociado que acepta la transferencia. 2 representa la transferencia saliente para el asociado que crea la transferencia. |
| ignoreEligibilityCheck | string | Este valor debe ser false. |
| lastModifiedUser | string | Identificador de usuario con formato GUID que identifica al último usuario para modificar la transferencia |
| lineItems | Matriz de objetos | Matriz de recursos TransferLineItem . |
TransferLineItem
Representa un elemento contenido en una nueva transferEntity comercial. Los asociados de origen ven elementos de línea para la transferencia de elementos que intentan transferir. Los asociados de destino ven los elementos de línea recién creados una vez completados. Los asociados de destino pueden usar los identificadores de elemento de línea para ayudar a comprender las suscripciones recién creadas resultantes de la transferencia.
| Propiedad | Tipo | Descripción |
|---|---|---|
| ID | string | Identificador único de un elemento de línea de transferencia. Aplicado tras la creación correcta de transferEntity. |
| subscriptionId | string | Identificador de la suscripción. |
| cantidad | int | Número de licencias o instancias. |
| billingCycle | Object | Tipo de ciclo de facturación establecido para el período actual. |
| productType | string | Cadena que representa el tipo de producto transferido. |
| status | string | El estado del lineitem en transferEntity. |
TransferEntity para transferencias tradicionales basadas en licencias
Describe una transferEntity.
| Propiedad | Tipo | Descripción |
|---|---|---|
| ID | string | Identificador transferEntity que se proporciona tras la creación correcta de transferEntity. |
| createdTime | DateTime | Fecha en que se creó transferEntity, en formato de fecha y hora. Aplicado tras la creación correcta de transferEntity. |
| lastModifiedTime | DateTime | Fecha en que transferEntity se actualizó por última vez, en formato de fecha y hora. Aplicado tras la creación correcta de transferEntity. |
| lastModifiedUser | string | Usuario que actualizó por última vez transferEntity. Aplicado tras la creación correcta de transferEntity. |
| customerName | string | Opcional. Nombre del cliente cuyas suscripciones se transfieren. |
| customerTenantId | string | Identificador de cliente con formato GUID que identifica al cliente. Aplicado tras la creación correcta de transferEntity. |
| partnertenantid | string | Identificador de asociado con formato GUID que identifica al asociado. |
| sourcePartnerName | string | Opcional. Nombre de la organización del asociado que inicia la transferencia. |
| sourcePartnerTenantId | string | Identificador de asociado con formato GUID que identifica al asociado que inicia la transferencia. |
| targetPartnerName | string | Opcional. Nombre de la organización del asociado a la que se dirige la transferencia. |
| targetPartnerTenantId | string | Identificador de asociado con formato GUID que identifica al asociado al que se dirige la transferencia. |
| lineItems | Matriz de objetos | Matriz de recursos TransferLineItem . |
| status | string | El estado de transferEntity. Los valores posibles son "Activo" (se puede eliminar o enviar) y "Completado" (ya se ha completado). Aplicado tras la creación correcta de transferEntity. |
TransferLineItem para transferencias tradicionales basadas en licencias
Representa un elemento contenido en un objeto transferEntity.
| Propiedad | Tipo | Descripción |
|---|---|---|
| ID | string | Identificador único de un elemento de línea de transferencia. Aplicado tras la creación correcta de transferEntity. |
| subscriptionId | string | Identificador de la suscripción. |
| cantidad | int | Número de licencias o instancias. |
| billingCycle | Object | Tipo de ciclo de facturación establecido para el período actual. |
| friendlyName | string | Opcional. Nombre descriptivo del elemento definido por el asociado para ayudar a desambiguar. |
| partnerIdOnRecord | string | PartnerId on Record en la compra que se produce cuando se acepta la transferencia. |
| offerId | string | El identificador de la oferta. |
| addonItems | Lista de objetos TransferLineItem | Colección de elementos de línea transferEntity para complementos que se transfieren junto con la suscripción base que se va a transferir. Aplicado tras la creación correcta de transferEntity. |
| transferError | string | Se aplica después de aceptar transferEntity en caso de que se produzca un error. |
| status | string | El estado del lineitem en transferEntity. |
TransferSubmitResult
Representa el resultado de una aceptación de transferencia para las transferencias tradicionales basadas en licencias.
| Propiedad | Tipo | Descripción |
|---|---|---|
| pedidos | Lista de objetos Order . | Colección de pedidos. |
| transferErrors | Lista de objetos TransferError . | Colección de errores de transferencia. |
TransferError
Representa un error que se produce cuando se acepta una transferencia tradicional basada en licencias.
| Propiedad | Tipo | Descripción |
|---|---|---|
| transferGroupId | string | Identificador del grupo de pedidos del pedido con el error. |
| code | int | Código de error. |
| descripción | string | Descripción del error. |
| lineItems | Lista de objetos TransferLineItem | Colección de elementos de línea transferEntity que forman parte del error de transferencia. |
TransferErrorCode
[Enum/dotnet/api/system.enum) con valores que indican un tipo de error de pedido para las transferencias tradicionales basadas en licencias.
| Valor | Position | Descripción |
|---|---|---|
| PartnerTokenMissing | 800001 | Falta el token de asociado en el contexto de solicitud. |
| InvalidInput | 800002 | Entrada de solicitud no válida. |
| ServiceException | 800003 | Error de servicio inesperado. |
| InvalidOfferId | 800004 | Identificador de oferta no válido. |
| CreateOrderError | 800005 | El orden de creación no se realiza correctamente. |
| MpnIdNotFound | 800015 | No se encuentra PartnerID. |
| NotValidIndirectResellerMpnId | 800016 | PartnerID no es un revendedor indirecto válido. |
| TransferIdNotFound | 900100 | No se encontró la solicitud de transferencia. |
| TransferNotAllowedIfStatusIsInProgress | 900101 | La solicitud de transferencia ya está en curso. |
| TransferNotAllowedIfStatusIsCompleted | 900102 | La solicitud de transferencia ya está completa. |
| TransferCreateOrderError | 900103 | El pedido de transferencia no se realiza correctamente. |
| TransferProcessedByAnotherRequest | 900104 | Otra solicitud procesa la transferencia. |