Obter o status da assinatura direta (aceitação direta) de um cliente do Contrato de Cliente Microsoft

Artigo
01/02/2025

Aplica-se a: Partner Center

Não se aplica a: Partner Center operado pela 21Vianet | Centro de Parceiros para a Nuvem Microsoft para o Governo dos EUA

O recurso DirectSignedCustomerAgreementStatus é suportado atualmente apenas pelo Partner Center na nuvem pública da Microsoft.

Este artigo explica como você pode recuperar o status da aceitação direta de um cliente do Contrato de Cliente da Microsoft.

Pré-requisitos

Credenciais, conforme descrito na autenticação do Partner Center . Este cenário suporta autenticação apenas com credenciais App+User.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Partner Center, selecionando o espaço de trabalho Clientes, em seguida, o cliente da lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure o 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).
O fornecedor indireto ou parceiro de faturação direta deve ter uma relação de revenda ativa com o cliente para recuperar o estado de assinatura direta do contrato.

C#

Para recuperar o status da aceitação direta do Contrato de Cliente Microsoft por um cliente, chame o método IAggregatePartner.Customers.ById com o identificador do cliente. Em seguida, use a propriedade Agreements para recuperar uma interface ICustomerAgreementCollection. Por fim, chame GetDirectSignedCustomerAgreementStatus() ou GetDirectSignedCustomerAgreementStatusAsync() para recuperar o status.

// IAggregatePartner partnerOperations;
// string customerId;
var customerDirectSigningStatus = partnerOperations.Customers.ById(selectedCustomerId).Agreements.GetDirectSignedCustomerAgreementStatus();

Exemplo: Aplicação de Exemplo para Consola. Projeto: SdkSamples Classe: GetDirectSignedCustomerAgreementStatus.cs

Pedido REST

Para recuperar o status da aceitação direta de um cliente do Contrato de Cliente da Microsoft, crie uma solicitação REST para recuperar o DirectSignedCustomerAgreementStatus para o cliente.

Sintaxe da solicitação

Use a seguinte sintaxe de solicitação:

Método	Solicitar URI
OBTER	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Parâmetros de URI

Você pode usar os seguintes parâmetros de URI com sua solicitação:

Nome	Tipo	Necessário	Descrição
ID do cliente-locatário	Identificador Globalmente Único (GUID)	Sim	O valor é um CustomerTenantId formatado em GUID que permite especificar o ID do cliente como inquilino.

Cabeçalhos de solicitação

Para obter mais informações, consulte cabeçalhos REST do Partner Center.

Corpo do pedido

Nenhuma.

Exemplo de solicitação

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Resposta REST

Se bem-sucedido, esse método retorna um de recurso DirectSignedCustomerAgreementStatus no corpo da resposta.

O recurso tem uma propriedade isSigned que indica o estado de assinatura direta (aceitação direta) do cliente.

Um valor de verdadeiro indica que o contrato foi assinado (aceito) diretamente pelo cliente.
Um valor de falso indica que o contrato não foi assinado (aceito) diretamente pelo cliente.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e mais informações de depuração.

Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para ver a lista completa, consulte os códigos de erro REST no Partner Center .

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

{"isSigned":true}

Partilhar via