Klantacceptatie van de Microsoft-klantovereenkomst bevestigen met behulp van Partnercentrum-API's

Artikel
03/11/2025

van toepassing op: Partnercentrum

Is niet van toepassing op: Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Het Partnercentrum ondersteunt momenteel alleen bevestiging van de acceptatie van de Microsoft-klantovereenkomst in de openbare Cloud van Microsoft.

In dit artikel wordt beschreven hoe u de acceptatie van de Microsoft-klantovereenkomst bevestigt of opnieuw bevestigt.

Voorwaarden

Als u de .NET SDK van Partnercentrum gebruikt, is versie 1.14 of hoger vereist.

Belangrijk

Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHubsamen met een readme-bestand met nuttige informatie.

Partners worden aangemoedigd om de Partner center REST API'ste blijven gebruiken.

Referenties zoals beschreven in Partner Center-authenticatie. Dit scenario biedt alleen ondersteuning voor app+gebruikersverificatie.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens. De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).
De datum (dateAgreed) wanneer de klant de Microsoft-klantovereenkomst heeft geaccepteerd.
Informatie over de gebruiker van de klantorganisatie die de Microsoft-klantovereenkomst heeft geaccepteerd. Dit omvat:
- Voornaam
- Achternaam
- E-mailadres
- Telefoonnummer (optioneel)
Als de volgende waarden voor een klant worden gewijzigd, staat het Partnercentrum toe dat er een andere overeenkomst voor die klant wordt gemaakt: Voornaam achternaam telefoonnummer, anders ontvangen partners de volgende foutcode, omdat er een dubbele klant wordt gemaakt

{
"code": 600061,
"message": "A partner confirmed agreement already exists for the customer.",
"description": "A partner confirmed agreement already exists for the customer.",
"errorName": "PartnerConfirmedAgreementAlreadyExists",
"isRetryable": false,
"parameters": {},
"errorMessageExtended": "InternalErrorCode=600061"
}

.NET

Ga als volgt te werk om de acceptatie van de klant bij de Microsoft Customer Agreement te bevestigen of opnieuw te bevestigen:

Haal de metagegevens van de overeenkomst op voor de Microsoft-klantovereenkomst. U moet de templateId van de Microsoft-klantovereenkomst verkrijgen. Zie Metagegevens van overeenkomst ophalen voor Microsoft-klantovereenkomstvoor meer informatie.
```
// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
```
Maak een nieuw Overeenkomst object met details van de bevestiging.
Gebruik de IAgreggatePartner.Customers verzameling en roep de methode ById aan met de opgegeven klant-tenant-id.

Gebruik de eigenschap Agreements, gevolgd door het aanroepen van Create of het aanroepen van CreateAsync.

// string selectedCustomerId;

var agreementToCreate = new Agreement
{
    DateAgreed = DateTime.UtcNow,
    TemplateId = microsoftCustomerAgreementDetails.TemplateId,
    PrimaryContact = new Contact
    {
        FirstName = "Tania",
        LastName = "Carr",
        Email = "someone@example.com",
        PhoneNumber = "1234567890"
    }
};

Agreement agreement = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Create(agreementToCreate);

Een volledig voorbeeld vindt u in de CreateCustomerAgreement klasse uit de consoletest-app project.

REST-aanvraag

Ga als volgt te werk om de acceptatie van de klant bij de Microsoft Customer Agreement te bevestigen of opnieuw te bevestigen:

Haal de metagegevens van de overeenkomst op voor de Microsoft-klantovereenkomst. U moet de templateId van de Microsoft-klantovereenkomst verkrijgen. Zie Metagegevens van overeenkomst ophalen voor Microsoft-klantovereenkomstvoor meer informatie.
Maak een nieuwe overeenkomst resource om te bevestigen dat een klant de Microsoft-klantovereenkomst heeft geaccepteerd. Gebruik de volgende REST-aanvraagsyntaxis.

Aanvraagsyntaxis

Methode	Aanvraag URI
VERZENDEN	{baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om de klant op te geven die u aan het bevestigen bent.

Naam	Soort	Verplicht	Beschrijving
klant-huurder-id	GUID	Ja	De waarde is een GUID-geformateerde klant-tenant-id, die een identificator is waarmee u een klant kunt opgeven.

Aanvraagheaders

Zie Partnercentrum REST-headersvoor meer informatie.

Aanvraaginhoud

In deze tabel worden de vereiste eigenschappen in de hoofdtekst van de REST-aanvraag beschreven.

Naam	Soort	Beschrijving
Overeenkomst	object	Details geleverd door de partner om de acceptatie door de klant van de Microsoft-klantovereenkomst te bevestigen.

Overeenkomst

In deze tabel worden de minimale vereiste velden beschreven voor het maken van een Overeenkomst resource.

Eigendom	Soort	Beschrijving
hoofdcontact	contact opnemen met	Informatie over de gebruiker van de klantorganisatie die de Microsoft-klantovereenkomst heeft geaccepteerd, waaronder: firstName, lastName, e-mailen phoneNumber (optioneel)
datumOvereengekomen	tekenreeks in UTC-datum- en tijdnotatie	De datum waarop de klant de overeenkomst heeft geaccepteerd.
templateId	snaar	Unieke identificatie van het overeenkomsttype dat door de klant wordt geaccepteerd. U kunt de templateId voor de Microsoft-klantovereenkomst verkrijgen door de metagegevens van deze overeenkomst op te halen. Zie Metagegevens van overeenkomst ophalen voor microsoft-klantovereenkomst voor meer informatie.
soort	touwtje	Overeenkomsttype geaccepteerd door de klant. Gebruik MicrosoftCustomerAgreement als de klant de Microsoft-klantovereenkomst heeft geaccepteerd.

Aanvraagvoorbeeld

POST https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

REST-antwoord

Als dit lukt, retourneert deze methode een Overeenkomst bron.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of het succesvol of mislukt is en aanvullende informatie voor foutopsporing.

Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partnercentrum REST-foutcodesvoor de volledige lijst.

Voorbeeld van antwoord

HTTP/1.1 201 Created
Content-Length: 261
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "userId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

Delen via