Rejeitar uma transferência

Artigo
03/07/2025

Nota

Este tópico aplica-se apenas a serviços tradicionais baseados em licenças e não a novas experiências comerciais. Para mais informações sobre a transferência de subscrições baseadas em licença do new commerce, consulte o tópico de transferência do new commerce.

Pré-requisitos

Credenciais conforme descrito na autenticação do Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Partner Center selecionando a área de trabalho Clientes e, em seguida, o cliente na 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 é a mesma que a ID do cliente (customer-tenant-id).
Um identificador de transferência para uma transferência existente.

Funções apropriadas: Agente administrativo | Agente de vendas

Pedido REST

Sintaxe da solicitação

Método	URI do pedido
CORREÇÃO	{baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} HTTP/1.1

Parâmetro URI

Use o seguinte parâmetro path para identificar o cliente e especificar a transferência a ser aceita.

Nome	Tipo	Obrigatório	Descrição
ID do cliente	string	Sim	Um ID de cliente formatado em GUID que identifica o cliente.
ID de transferência	string	Sim	Um ID de transferência formatado em GUID que identifica a transferência.

Cabeçalhos do pedido

Para obter mais informações, consulte Partner Center REST Headers.

Corpo do pedido

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

Propriedade	Tipo	Obrigatório	Descrição
id	string	Não	Um identificador da entidade de transferência que é fornecido após a criação bem-sucedida da entidade de transferência.
estado	cadeia de caracteres	Não	O estado da entidade de transferência. Para rejeitar uma transferência, o valor deve ser definido como "rejeitar"

Exemplo de solicitação

PATCH /v1/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ac4a9d22-ba07-444e-890f-cfe084eed498 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 5b46e795-b661-428e-a2e7-f208b8d0d25c
Connection: keep-alive
Content-Length: 63

{"id":"ac4a9d22-ba07-444e-890f-cfe084eed498","status":"reject"}

Resposta do REST

Se bem-sucedido, esse método retorna o recurso TransferEntity preenchido no corpo da resposta.

Códigos de sucesso e erro de resposta

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

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 1069
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 5b46e795-b661-428e-a2e7-f208b8d0d25c
X-Locale: en-US
Date: Fri, 27 Mar 2020 17:50:33 GMT

{
  "id": "ac4a9d22-ba07-444e-890f-cfe084eed498",
  "status": "Reject",
  "createdTime": "2020-03-25T22:05:25.1057725Z",
  "lastModifiedTime": "2020-03-27T17:50:32Z",
  "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
  "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
  "sourcePartnerName": "Test_Test_09092019GBL",
  "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "targetPartnerName": "Test_Test_09032019GBL",
  "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
  "lastModifiedUser": "01a7548d-1136-4cf0-ba9a-300f921ffb22",
  "lineItems": [
    {
      "id": 0,
      "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "offerId": "13D32E13-A1B0-400D-96C0-4EAAA14DCED5",
      "billingCycle": "monthly",
      "friendlyName": "Dynamics 365 for Supply Chain Management Attach to Qualifying Dynamics 365 Base Offer (Qualified Offer)",
      "quantity": 20,
      "partnerIdOnRecord": "5139005",
      "addonItems": [

      ]
    }
  ],
  "links": {
    "self": {
      "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ac4a9d22-ba07-444e-890f-cfe084eed498",
      "method": "GET",
      "headers": [

      ]
    }
  },
  "attributes": {
    "objectType": "TransferEntity"
  }
}

Partilhar via