Obtenir l’état de la signature directe d’un client (acceptation directe) du Contrat client Microsoft

Article
01/22/2025

s’applique à: Centre de Partenaires

ne s’applique pas à: Espace partenaires géré par 21Vianet | Espace partenaires pour Microsoft Cloud pour le gouvernement des États-Unis

La ressource DirectSignedCustomerAgreementStatus est actuellement prise en charge par l'Espace partenaires uniquement dans le cloud public de Microsoft.

Cet article explique comment récupérer l’état de l’acceptation directe du Contrat client Microsoft par un client.

Conditions préalables

Informations d'identification tel que décrit dansl'authentification de l'Espace partenaires. Ce scénario prend uniquement en charge l’authentification avec les informations d’identification App+Utilisateur.
Identifiant client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans Espace partenaires en sélectionnant l’espace de travail clients , puis le client dans la liste des clients, puis compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est identique à l’ID client (customer-tenant-id).
Le fournisseur indirect ou le partenaire de facturation directe doivent avoir une relation de revente active avec le client pour récupérer l’état de signature directe du contrat.

C#

Pour récupérer l’état de l’acceptation directe d’un contrat client Microsoft par un client, appelez la méthode IAggregatePartner.Customers.ById avec l’identificateur du client. Utilisez ensuite la propriété Contrats pour récupérer une interface Collection d’accord avec les clients. Enfin, appelez GetDirectSignedCustomerAgreementStatus() ou GetDirectSignedCustomerAgreementStatusAsync() pour obtenir le statut.

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

Exemple : Exemple d'application console. Projet : ExempleSdk Classe : GetDirectSignedCustomerAgreementStatus.cs

Requête REST

Pour récupérer l’état de l’acceptation directe d’un contrat client Microsoft par un client, créez une demande REST pour récupérer l'DirectSignedCustomerAgreementStatus pour le client.

Syntaxe de la requête

Utilisez la syntaxe de requête suivante :

Méthode	URI de requête
OBTENIR	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Paramètres d’URI

Vous pouvez utiliser les paramètres d’URI suivants avec votre requête :

Nom	Type	Obligatoire	Description
identifiant-client-locataire	GUID	Oui	La valeur est un identifiant de locataire client au format GUID qui vous permet de spécifier l'identifiant de locataire d'un client.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST d’Espace partenaires.

Corps de la requête

Aucun.

Exemple de requête

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

Réponse REST

Si elle réussit, cette méthode renvoie une ressourceStatut de l'accord direct avec le client dans le corps de la réponse.

La ressource a une propriété isSigned qui indique l’état de signature directe (acceptation directe) du client.

La valeur true indique que le contrat a été signé (accepté) directement par le client.
La valeur false indique que le contrat n’a pas été signé (accepté) directement par le client.

Réussite de la réponse et codes d’erreur

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et plus d’informations de débogage.

Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse

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}

Partager via