Obter o status da assinatura direta de um cliente (aceitação direta) do Contrato de Cliente da Microsoft
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 é atualmente suportado 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 em Autenticação do Partner Center. Esse cenário dá suporte apenas à autenticação com credenciais de Aplicativo+Usuário.
Uma ID do cliente (
customer-tenant-id
). Se você não souber a ID do cliente, poderá pesquisá-la no Partner Center selecionando o workspace Clientes e, em seguida, o cliente na lista de clientes e 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 provedor indireto ou o parceiro de cobrança direta deve ter uma relação de revenda ativa com o cliente para recuperar o status de assinatura direta do contrato.
C#
Para recuperar o status da aceitação direta de um cliente do Contrato de Cliente da Microsoft, chame o método IAggregatePartner.Customers.ById com o identificador do cliente. Em seguida, use a propriedade Acordos 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: Aplicativo de Exemplo de Console. Projeto: Classe SdkSamples: GetDirectSignedCustomerAgreementStatus.cs
Solicitação 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 de solicitação
Use a seguinte sintaxe de solicitação:
Método | URI de solicitação |
---|---|
GET | {URLbase}/v1/customers/{id-de-locatário-do-cliente}/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-de-locatário-do-cliente | GUID | Sim | O valor é um CustomerTenantId formatado por GUID que permite especificar a ID do locatário de um cliente. |
Cabeçalhos de solicitação
Para obter mais informações, confira cabeçalhos REST do Partner Center.
Corpo da solicitação
Nenhum.
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 retornará um recurso DirectSignedCustomerAgreementStatus no corpo da resposta.
O recurso tem uma propriedade isSigned que indica o status 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 erro e êxito de resposta
Cada resposta vem com um código de status HTTP que indica êxito ou falha e mais informações de depuração.
Use uma ferramenta de rastreamento de rede para ler este código, tipo de erro e outros parâmetros. Para obter a lista completa, confira códigos de erro REST do 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}