Recursos de TransferEntity
Um parceiro cria uma transferência para o parceiro atual de um cliente. O parceiro atual ou de origem aceita a transferência e a envia para concluir a transferência.
Entidade de transferência
Descreve um transferEntity para transferências de novo comércio.
| Propriedade | Type | Descrição |
|---|---|---|
| ID | string | Um identificador transferEntity que é fornecido após a criação bem-sucedida do transferEntity. |
| status | string | O status do transferEntity. Os valores possíveis são "Ativo" (pode ser excluído/enviado) e "Concluído" (já foi concluído). Aplicado após a criação bem-sucedida da transferEntity. |
| Tipo de transferência | string | Um número que representa o tipo de transferência. 3 é resolvido para ModernAzure e 5 é resolvido para NewCommerce. Os parceiros que executam transferências de novo comércio de parceiro para parceiro podem usar qualquer um, mas devem padronizar em 5. |
| customerEmailId | string | Identifica o e-mail do cliente Usado para notificações. |
| createdTime | Datetime | A data em que transferEntity foi criado, no formato de data e hora. Aplicado após a criação bem-sucedida da transferEntity. |
| lastModifiedTime | Datetime | A data em que transferEntity foi atualizada pela última vez, no formato de data e hora. Aplicado após a criação bem-sucedida da transferEntity. |
| concluídoTempo | Datetime | A data em que transferEntity foi concluída, no formato de data e hora. Aplicado após a conclusão bem-sucedida da transferEntity. |
| customerName | string | Opcional. O nome do cliente cujas assinaturas estão sendo transferidas. |
| customerTenantId | string | Uma ID de cliente formatada em GUID que identifica o cliente. Aplicado após a criação bem-sucedida da transferEntity. |
| PartnerTenantID | string | Uma ID de parceiro formatada em GUID que identifica o parceiro. |
| sourcePartnerName | string | Opcional. O nome da organização do parceiro que está iniciando a transferência. |
| targetPartnerName | string | Opcional. O nome da organização do parceiro para a qual a transferência é direcionada. |
| targetPartnerTenantId | string | Uma ID de parceiro formatada em GUID que identifica o parceiro para o qual a transferência é direcionada. |
| targetPartnerEmailId | string | Um pid formatado em GUID que identifica o parceiro para o qual a transferência é direcionada. Essa ID é a mesma que targetPartnerTenantId |
| Direção de transferência | string | Um número que representa a direção da transferência. 1 representa uma transferência de entrada para o parceiro que aceita a transferência. 2 representa a transferência de saída para o parceiro que cria a transferência. |
| ignoreEligibilityCheck | string | Esse valor deve ser false. |
| lastModifiedUser | string | Um ID de usuário formatado em GUID que identifica o último usuário a modificar a transferência |
| lineItems | Matriz de objetos | Uma matriz de recursos TransferLineItem . |
TransferLineItem
Representa um item contido em uma nova transferEntity de comércio. Os parceiros de origem veem os itens de linha para a transferência de itens que estão tentando transferir. Os parceiros do Target veem os itens de linha recém-criados depois que eles são concluídos. Os parceiros do Target podem usar os IDs de itens de linha para ajudar a entender as assinaturas recém-criadas que resultam da transferência.
| Propriedade | Type | Descrição |
|---|---|---|
| ID | string | Um identificador exclusivo para um item de linha de transferência. Aplicado após a criação bem-sucedida da transferEntity. |
| subscriptionId | string | O identificador da assinatura. |
| quantity | int | O número de licenças ou instâncias. |
| billingCycle | Objeto | O tipo de ciclo de faturamento definido para o período atual. |
| productType | string | Uma cadeia de caracteres que representa o tipo de produto transferido. |
| status | string | O status do item de linha na transferEntity. |
TransferEntity para transferências tradicionais baseadas em licença
Descreve uma transferEntity.
| Propriedade | Type | Descrição |
|---|---|---|
| ID | string | Um identificador transferEntity que é fornecido após a criação bem-sucedida do transferEntity. |
| createdTime | Datetime | A data em que transferEntity foi criado, no formato de data e hora. Aplicado após a criação bem-sucedida da transferEntity. |
| lastModifiedTime | Datetime | A data em que transferEntity foi atualizada pela última vez, no formato de data e hora. Aplicado após a criação bem-sucedida da transferEntity. |
| lastModifiedUser | string | O usuário que atualizou a transferEntity pela última vez. Aplicado após a criação bem-sucedida de transferEntity. |
| customerName | string | Opcional. O nome do cliente cujas assinaturas estão sendo transferidas. |
| customerTenantId | string | Uma ID de cliente formatada em GUID que identifica o cliente. Aplicado após a criação bem-sucedida da transferEntity. |
| PartnerTenantID | string | Uma ID de parceiro formatada em GUID que identifica o parceiro. |
| sourcePartnerName | string | Opcional. O nome da organização do parceiro que está iniciando a transferência. |
| sourcePartnerTenantId | string | Uma ID de parceiro formatada em GUID que identifica o parceiro que inicia a transferência. |
| targetPartnerName | string | Opcional. O nome da organização do parceiro para a qual a transferência é direcionada. |
| targetPartnerTenantId | string | Uma ID de parceiro formatada em GUID que identifica o parceiro para o qual a transferência é direcionada. |
| lineItems | Matriz de objetos | Uma matriz de recursos TransferLineItem . |
| status | string | O status do transferEntity. Os valores possíveis são "Ativo" (pode ser excluído/enviado) e "Concluído" (já foi concluído). Aplicado após a criação bem-sucedida da transferEntity. |
TransferLineItem para transferências tradicionais baseadas em licença
Representa um item contido em um transferEntity.
| Propriedade | Type | Descrição |
|---|---|---|
| ID | string | Um identificador exclusivo para um item de linha de transferência. Aplicado após a criação bem-sucedida da transferEntity. |
| subscriptionId | string | O identificador da assinatura. |
| quantity | int | O número de licenças ou instâncias. |
| billingCycle | Objeto | O tipo de ciclo de faturamento definido para o período atual. |
| friendlyName | string | Opcional. O nome amigável do item definido pelo parceiro para ajudar a desambiguar. |
| partnerIdOnRecord | string | PartnerId no registro na compra que acontece quando a transferência é aceita. |
| offerId | string | O identificador da oferta. |
| Itens de adição | Lista de objetos TransferLineItem | Uma coleção de itens de linha transferEntity para complementos que são transferidos junto com a assinatura base que está sendo transferida. Aplicado após a criação bem-sucedida da transferEntity. |
| erro de transferência | string | Aplicado depois que transferEntity é aceito caso haja um erro. |
| status | string | O status do item de linha na transferEntity. |
TransferSubmitResult
Representa o resultado de uma aceitação de transferência para transferências tradicionais baseadas em licença.
| Propriedade | Type | Descrição |
|---|---|---|
| pedidos | Lista de objetos Order . | A coleta de pedidos. |
| transferErrors | Lista de objetos TransferError . | A coleção de erros de transferência. |
Erro de transferência
Representa um erro que ocorre quando uma transferência tradicional baseada em licença é aceita.
| Propriedade | Type | Descrição |
|---|---|---|
| ID do Grupo de Transferência | string | O ID do grupo de pedidos do pedido com o erro. |
| código | int | O código de erro. |
| descrição | string | A descrição do erro. |
| lineItems | Lista de objetos TransferLineItem | Uma coleção de itens de linha transferEntity que fazem parte do erro de transferência. |
Código de erro de transferência
Um [Enum/dotnet/api/system.enum) com valores que indicam um tipo de erro de ordem para transferências tradicionais baseadas em licença.
| Valor | Posição | Descrição |
|---|---|---|
| TokenParceiroAusente | 800001 | Token de parceiro ausente no contexto da solicitação. |
| InvalidInput | 800002 | Entrada de solicitação inválida. |
| Exceção de serviço | 800003 | Erro de serviço inesperado. |
| InvalidOfferId | 800004 | ID de oferta inválida. |
| CreateOrderError | 800005 | Criar ordem não foi bem-sucedida. |
| MpnIdNotFound | 800015 | PartnerID não foi encontrado. |
| NotValidIndirectResellerMpnId | 800016 | PartnerID não é um revendedor indireto válido. |
| TransferIdNotFound | 900100 | Solicitação de transferência não encontrada. |
| TransferNotAllowedIfStatusIsInProgress | 900101 | A solicitação de transferência já está em andamento. |
| TransferNotAllowedIfStatusIsCompleted | 900102 | A solicitação de transferência já está concluída. |
| TransferCreateOrderError | 900103 | A ordem de transferência não foi bem-sucedida. |
| TransferProcessedByAnotherRequest | 900104 | A transferência está sendo processada por outra solicitação. |