Criar uma transferência para assinaturas herdadas

Artigo
10/15/2024

Observação

Este artigo descreve a transferência somente de assinaturas herdadas . Conforme anunciado anteriormente, os parceiros CSP devem migrar suas assinaturas para o novo comércio. As etapas de transferência de parceiro para assinaturas de novo comércio podem ser encontradas no tópico transferir novas assinaturas de comércio.

Pré-requisitos

Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Uma ID do cliente (customer-tenant-id). Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando o workspace Clientes, o cliente da lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).
Funções apropriadas: Agente administrativo | Agente de vendas

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
POST	{baseURL}/v1/customers/{customer-id}/transfers HTTP/1.1

Parâmetro do URI

Use o seguinte parâmetro de caminho para identificar o cliente.

Nome	Digitar	Obrigatória	Descrição
id do cliente	string	Sim	Uma ID de cliente formatada em GUID que identifica o cliente

Cabeçalhos da solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Esta tabela descreve as propriedades TransferEntity no corpo da solicitação.

Propriedade	Type	Obrigatória	Descrição
ID	string	Não	Um identificador transferEntity que é fornecido após a criação bem-sucedida do transferEntity
createdTime	Datetime	Não	A data em que transferEntity foi criado, no formato de data e hora. Aplicado após a criação bem-sucedida do transferEntity
lastModifiedTime	Datetime	Não	A data em que transferEntity foi atualizada pela última vez, no formato de data e hora. Aplicado após a criação bem-sucedida do transferEntity
lastModifiedUser	string	Não	O usuário que atualizou a transferEntity pela última vez. Aplicado após a criação bem-sucedida de transferEntity
customerName	string	Não	Opcional. O nome do cliente cujas assinaturas estão sendo transferidas
customerTenantId	string	Não	Uma ID de cliente formatada em GUID que identifica o cliente. Aplicado após a criação bem-sucedida do transferEntity
PartnerTenantID	string	Não	Uma ID de parceiro formatada em GUID que identifica o parceiro
sourcePartnerName	string	Não	Opcional. O nome da organização do parceiro que está iniciando a transferência
sourcePartnerTenantId	string	Sim	Uma ID de parceiro formatada em GUID que identifica o parceiro que inicia a transferência
targetPartnerName	string	Não	Opcional. O nome da organização do parceiro para a qual a transferência é direcionada
targetPartnerTenantId	string	Sim	Uma ID de parceiro formatada em GUID que identifica o parceiro para o qual a transferência é direcionada
lineItems	Matriz de objetos	Sim	Uma matriz de recursos TransferLineItem
status	string	Não	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.

Esta tabela descreve as propriedades TransferLineItem no corpo da solicitação.

Propriedade	Type	Obrigatória	Descrição
ID	string	Não	Um identificador exclusivo para um item de linha de transferência. Aplicado após a criação bem-sucedida da transferEntity.
subscriptionId	string	Sim	O identificador de assinatura
quantity	int	Não	O número de licenças ou instâncias
billingCycle	Objeto	Não	O tipo de ciclo de faturamento definido para o período atual
friendlyName	string	Não	Opcional. O nome amigável do item definido pelo parceiro para ajudar a desambiguar
partnerIdOnRecord	string	Não	PartnerID on Record (anteriormente MPN ID) na compra que acontece quando a transferência é aceita
offerId	string	Não	O identificador da oferta
Itens de adição	Lista de objetos TransferLineItem	Não	Uma coleção de itens de linha transferEntity para complementos que serã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	Não	Aplicado depois que transferEntity for aceito se houver um erro
status	string	Não	O status do item de linha no transferEntity

Exemplo de solicitação

POST /v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/transfers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Expect: 100-continue

{
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lineItems": [
        {
            "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
            "partnerIdOnRecord": "517285"
        },
        {
            "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
            "partnerIdOnRecord": "517285"
        }
    ]
}

Resposta REST

Se for bem-sucedido, esse método retornará o recurso TransferEnity preenchido no corpo da resposta.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de Erro.

Exemplo de resposta

HTTP/1.1 201 Created
Content-Length: 138
Content-Type: application/json; charset=utf-8
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US,en-US
{
    "id": "67c5b05b-09b5-47ba-9047-5056fe2afa4f",
    "status": "Active",
    "createdTime": "2020-03-24T20:44:14.9602781Z",
    "lastModifiedTime": "2020-03-24T20:44:15Z",
    "customerTenantId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
    "partnertenantid": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
    "lastModifiedUser": "d0648481-b615-45c9-8cd1-ff87940dbdc4",
    "lineItems": [
        {
            "id": 0,
            "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
            "offerId": "50E9A47A-7B4D-4970-9D90-CAE927F53753",
            "billingCycle": "annual",
            "friendlyName": "Dynamics 365 for Sales Enterprise Attach to Qualifying Dynamics 365 Base Offer",
            "quantity": 1,
            "addonItems": [
                {
                    "id": 0,
                    "subscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
                    "offerId": "2BCF9FE8-8B65-4FCF-9240-419203FB8CF4",
                    "billingCycle": "annual",
                    "friendlyName": "Dynamics 365 - Additional Production Instance (Qualified Offer)",
                    "quantity": 4
                }
            ]
        },
        {
            "id": 0,
            "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
            "offerId": "455DDD41-32ED-4E2D-B3A2-BBCB22CAA467",
            "billingCycle": "annual",
            "friendlyName": "Dynamics 365 Customer Engagement Plan Patch",
            "quantity": 8,
            "addonItems": []
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/ccccdddd-2222-eeee-3333-ffff4444aaaa/transfers/67c5b05b-09b5-47ba-9047-5056fe2afa4f",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "TransferEntity"
    }
}

Compartilhar via