Een klant maken

Artikel
04/01/2024

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Als CSP-partner (Cloud Solution Provider) kunt u, wanneer u een klant maakt, orders plaatsen namens de klant. Wanneer u een klant maakt, maakt u ook het volgende:

Een Microsoft Entra-tenantobject voor de klant
Een relatie tussen de reseller en de klant (gebruikt voor gedelegeerde beheerdersbevoegdheden)
Een gebruikersnaam en wachtwoord om u aan te melden als beheerder voor de klant

Nadat de klant is gemaakt, slaat u de klant-id en de details van de Microsoft Entra-id op.

Belangrijk

Als u een indirecte provider bent en u een klant wilt maken voor een indirecte reseller, raadpleegt u Een klant maken voor een indirecte reseller.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

Belangrijk

Als u een klanttenant wilt maken, moet u een geldig fysiek adres opgeven tijdens het maken. Een adres kan worden gevalideerd door de stappen te volgen die worden beschreven in het scenario Een adres valideren. Als u een klant maakt met een ongeldig adres in de sandbox-omgeving, kunt u die klanttenant niet verwijderen.

Belangrijk

Als het doorgeven van het wachtwoord userCredentials niet wordt geaccepteerd.

C#

Een klant toevoegen:

Instantieer een nieuw klantobject. Vul de BillingProfile en CompanyProfile in.
Voeg de nieuwe klant toe aan uw verzameling IAggregatePartner.Customers door Create or CreateAsync aan te roepen.

C#-voorbeeld

// IAggregatePartner partnerOperations;

var partnerOperations = this.Context.UserPartnerOperations;

var customerToCreate = new Customer()
{
    CompanyProfile = new CustomerCompanyProfile()
    {
        Domain = string.Format(CultureInfo.InvariantCulture,
            "SampleApplication{0}.{1}",
            new Random().Next(),
            this.Context.Configuration.Scenario.CustomerDomainSuffix),
        //// OrganizationRegistrationNumber = "123456" // Please add if in specific country/region that requires
    },
    BillingProfile = new CustomerBillingProfile()
    {
        Culture = "EN-US",
        Email = "gena@wingtiptoys.com",
        Language = "En",
        CompanyName = "Wingtip Toys"
        DefaultAddress = new Address()
        {
            FirstName = "Gena",
            MiddleName = "Coralie",
            LastName = "Soto",
            AddressLine1 = "One Microsoft Way",
            City = "Redmond",
            State = "WA",
            Country = "US",
            PostalCode = "98052",
            PhoneNumber = ""
        }
    }
};

var newCustomer = partnerOperations.Customers.Create(customerToCreate);

C#-voorbeeld-app

Consoletest-app. Project: Voorbeeldklasse partnercentrum-SDK: CreateCustomer.cs

REST

Aanvraagsyntaxis

Methode	Aanvraag-URI
POST	{baseURL}/v1/customers HTTP/1.1

Aanvraagheaders

Deze API is idempotent (het levert geen ander resultaat op als u deze meerdere keren aanroept).
Een aanvraag-id en correlatie-id zijn vereist.
Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

In deze tabel worden de vereiste eigenschappen in de aanvraagbody beschreven.

Name	Type	Description
BillingProfile	object	De gegevens van het factureringsprofiel van de klant.
CompanyProfile	object	De bedrijfsprofielgegevens van de klant.

Factureringsprofiel

In deze tabel worden de minimaal vereiste velden van de Resource CustomerBillingProfile beschreven die nodig zijn om een nieuwe klant te maken.

Name	Type	Description
e-mail	tekenreeks	Het e-mailadres van de klant.
cultuur	tekenreeks	Hun voorkeurscultuur voor communicatie en valuta, zoals `en-US`. Zie ondersteunde talen en landinstellingen voor het Partnercentrum voor de ondersteunde culturen.
taal	tekenreeks	De standaardtaal. Er worden twee tekentaalcodes (bijvoorbeeld `en` of `fr`) ondersteund.
companyName	tekenreeks	De naam van het geregistreerde bedrijf/de organisatie.
defaultAddress	Adres	Het geregistreerde adres van het bedrijf/de organisatie van de klant. Zie de adresresource voor informatie over lengtebeperkingen.

Bedrijfsprofiel

In deze tabel worden de minimaal vereiste velden van de Resource CustomerCompanyProfile beschreven die nodig zijn om een nieuwe klant te maken.

Name	Type	Description
domain	tekenreeks	De domeinnaam van de klant, zoals contoso.onmicrosoft.com.
organizationRegistrationNumber	String	Het registratienummer van de organisatie van de klant (ook wel INN-nummer genoemd in bepaalde landen/regio's). Alleen vereist voor het bedrijf/de organisatie van de klant in de volgende landen/regio's: Armenië(AM), Azerbeidzja(AZ), Wit-Rusland(BY), Hongarije(HU), Kazachstan(KZ), Kirgizië(KG), Moldavië(MD), Rusland(RU), Tadzjikistan(TJ), Contoso(UZ), Oekraïne(UA), Brazilië(BR), India, Zuid-Afrika, Polen, Verenigde Arabische Emiraten, Saoedi-Arabië,, Thailand, Vietnam, Myanmar, Irak, Zuid-Soedan, Venezuela en China. Voor het bedrijf/de organisatie van de klant in andere landen/regio's is dit een optioneel veld.

GDAP standaard

Name	Type	Description
enableGDAPByDefault	bool	Booleaanse waarde die aangeeft of we GDAP standaard willen inschakelen. Als waar is, maken we standaard GDAP. Als dit onwaar is, maken we geen GDAP. Opmerking: dit wordt alleen gehonoreerd in clouds die GDAP ondersteunen. Als dit niet wordt ondersteund, wordt DAP standaard gemaakt.

Aanvraagvoorbeeld

POST https://api.partnercenter.microsoft.com/v1/customers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 789
Expect: 100-continue
Connection: Keep-Alive

{
    "enableGDAPByDefault": false,
    "CompanyProfile": {
        "Domain": "xyz.onmicrosoft.com"
    },
    "BillingProfile": {
        "Culture": "EN-US",
        "Email": "gena@wingtiptoys.com",
        "Language": "en",
        "CompanyName": "Wingtip Toys",
        "DefaultAddress": {
            "FirstName": "Gena",
            "LastName": "Soto",
            "AddressLine1": "One Microsoft Way",
            "City": "Redmond",
            "State": "WA",
            "PostalCode": "98052",
            "Country": "US"
        }
    }
}

REST-antwoord

Als dit lukt, retourneert deze API een klantresource voor de nieuwe klant. Sla de klant-id en microsoft Entra-id op voor toekomstig gebruik met de Partner Center SDK. U hebt ze bijvoorbeeld nodig voor gebruik met accountbeheer.

Geslaagde antwoorden en foutcodes

Antwoorden worden geleverd met een HTTP-statuscode die aangeeft dat het succes of de fout is 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: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CV: ObwhuhD2tUKJoM+Z.0
MS-ServerId: 202010223
Date: Tue, 14 Feb 2017 20:06:02 GMT

{
    "id": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "commerceId": "0a4ce58a-6f96-4273-8035-d9c7d31b9ba4",
    "companyProfile": {
        "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "domain": "xyz.onmicrosoft.com",
        "attributes": {
            "objectType": "CustomerCompanyProfile"
        }
    },
    "billingProfile": {
        "id": "d17c0275-da92-5c33-9032-782ef1d0b69b",
        "email": "gena@wingtiptoys.com",
        "culture": "en-US",
        "language": "en",
        "companyName": "Wingtip Toys",
        "defaultAddress": {
            "country": "US",
            "city": "Redmond",
            "state": "WA",
            "addressLine1": "One Microsoft Way",
            "postalCode": "98052",
            "firstName": "Gena",
            "lastName": "Soto",
            "phoneNumber": ""
        },
        "attributes": {
            "etag": "5920358838484612121",
            "objectType": "CustomerBillingProfile"
        }
    },
    "enableGDAPByDefault": false,
    "relationshipToPartner": "none",
    "userCredentials": {
        "userName": "admin",
        "password": "=;;n.=s9Z"
    },
    "attributes": {
        "objectType": "Customer"
    }
}

Java

Notitie

De Partner Center SDK voor Java is een opensource-project dat wordt onderhouden door de partnercommunity.

Gebruik de volgende stappen om een nieuwe klant te maken.

Maak een nieuw exemplaar van het CustomerBillingProfile en de objecten CustomerCompanyProfile . Vul de vereiste velden in.
Maak de klant door de functie IAggregatePartner.getCustomers().create aan te roepen.

Java-voorbeeld

// IAggregatePartner partnerOperations;

Address address = new Address();

address.setFirstName( "Gena" );
address.setLastName( "Soto" );
address.setAddressLine1( "One Microsoft Way" );
address.setCity( "Redmond" );
address.setState( "WA" );
address.setCountry( "US" );
address.setPostalCode( "98052" );
address.setPhoneNumber( "4255550101" );

CustomerBillingProfile billingProfile = new CustomerBillingProfile();

billingProfile.setCulture( "en-US" );
billingProfile.setEmail( "gena@wingtiptoys.com" );
billingProfile.setLanguage( "en" );
billingProfile.setCompanyName( "Wingtip Toys" );
billingProfile.setDefaultAddress( address );

CustomerCompanyProfile companyProfile = new CustomerCompanyProfile();

companyProfile.setDomain( "WingtipToys" + Math.abs( new Random().nextInt() ) + ".onmicrosoft.com" );

Customer customerToCreate = new Customer();

customerToCreate.setBillingProfile( billingProfile );
customerToCreate.setCompanyProfile( companyProfile );

Customer newCustomer = partnerOperations.getCustomers().create( customerToCreate );

Powershell

Notitie

De Partner Center SDK voor PowerShell is een opensource-project dat wordt onderhouden door de partnercommunity.

Als u een klant wilt maken, voert u de opdracht New-PartnerCustomer uit zoals in het volgende voorbeeld.

New-PartnerCustomer -BillingAddressLine1 '1 Microsoft Way' -BillingAddressCity 'Redmond' -BillingAddressCountry 'US' -BillingAddressPostalCode '98052' -BillingAddressState 'WA' -ContactEmail 'gena@wingtiptoys.com' -ContactFirstName 'Gena' -ContactLastName 'Soto' -Culture 'en-US' -Domain 'newcustomer.onmicrosoft.com' -Language 'en' -Name 'New Customer'

Delen via

Een klant maken

Vereisten

C#

C#-voorbeeld

C#-voorbeeld-app

REST

Aanvraagsyntaxis

Aanvraagheaders

Aanvraagtekst

Factureringsprofiel

Bedrijfsprofiel

GDAP standaard

Aanvraagvoorbeeld

REST-antwoord

Geslaagde antwoorden en foutcodes

Responsvoorbeeld

Java

Java-voorbeeld

Powershell

Feedback

Aanvullende resources