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

Artikel
10/13/2023

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 bevestiging van de acceptatie van de klant van de Microsoft-klantovereenkomst alleen in de openbare Cloud van Microsoft.

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

Vereisten

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 GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.

Partners worden aangemoedigd om de REST API's van partnercentrum te blijven gebruiken.

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor App+User-verificatie.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het 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) waarop de klant de Microsoft-klantovereenkomst heeft geaccepteerd.
Informatie over de gebruiker van de klantorganisatie die de Microsoft-klantovereenkomst heeft geaccepteerd. Dit zijn onder andere de nieuwe mogelijkheden:
- Voornaam
- Achternaam
- E-mailadres
- Telefoon getal (optioneel)
Als de volgende waarden voor een klant worden gewijzigd, staat partnercentrum toe dat er een andere overeenkomst voor die klant wordt gemaakt: Voornaam achternaam-e-mailadres Telefoon nummer, 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

De klantacceptatie van de Microsoft-klantovereenkomst bevestigen of 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-klantovereenkomst voor meer informatie.
```
// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

Gebruik de eigenschap Agreements , gevolgd door het aanroepen van Create of 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 klasse CreateCustomerAgreement van het consoletest-app-project .

REST-aanvraag

De klantacceptatie van de Microsoft-klantovereenkomst bevestigen of 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-klantovereenkomst voor meer informatie.
Maak een nieuwe overeenkomstresource om te bevestigen dat een klant de Microsoft-klantovereenkomst heeft geaccepteerd. Gebruik de volgende REST-aanvraagsyntaxis.

Aanvraagsyntaxis

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

URI-parameter

Gebruik de volgende queryparameter om de klant op te geven die u bevestigt.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	GUID	Ja	De waarde is een door de GUID opgemaakte klant-tenant-id. Dit is een id waarmee u een klant kunt opgeven.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

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

Naam	Type	Omschrijving
Overeenkomst	object	Details van de partner om de acceptatie van de Microsoft-klantovereenkomst te bevestigen.

Overeenkomst

In deze tabel worden de minimaal vereiste velden beschreven voor het maken van een overeenkomstresource.

Eigenschappen	Type	Omschrijving
primaryContact	Contact	Informatie over de gebruiker van de klantorganisatie die de Microsoft-klantovereenkomst heeft geaccepteerd, waaronder: firstName, lastName, email en phoneNumber (optioneel)
dateAgreed	tekenreeks in utc-datum/tijdnotatie	De datum waarop de klant de overeenkomst heeft geaccepteerd.
templateId	tekenreeks	Unieke id van het overeenkomsttype dat door de klant is geaccepteerd. U kunt de templateId voor Microsoft-klantovereenkomst verkrijgen door de metagegevens van de overeenkomst voor Microsoft-klantovereenkomst op te halen. Zie Metagegevens van overeenkomst ophalen voor Microsoft-klantovereenkomst voor meer informatie.
type	tekenreeks	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: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

REST-antwoord

Als dit lukt, retourneert deze methode een overeenkomstresource.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing.

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

Responsvoorbeeld

HTTP/1.1 201 Created
Content-Length: 261
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "userId": "3d6f2c09-eb40-48ca-a4b3-d24c9c007531",
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

Delen via