Een factureringsprofiel van een klant bijwerken
Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid
Hiermee werkt u het factureringsprofiel van een klant bij, inclusief het adres dat is gekoppeld aan het profiel.
Vereisten
Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een klant-id (
customer-tenant-id
). Als u de klant-id niet weet, kunt u deze opzoeken in partnercentrum. Selecteer Klanten op de startpagina, selecteer vervolgens de klant in de lijst met klanten en selecteer 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
).
C#
Als u het factureringsprofiel van een klant wilt bijwerken, haalt u het factureringsprofiel op en werkt u de eigenschappen zo nodig bij. Haal vervolgens de verzameling IPartner.Customers op en roep vervolgens de Methode ById() aan. Roep vervolgens de eigenschap Profielen aan, gevolgd door de eigenschap Facturering. Voltooi vervolgens de methoden Update() of UpdateAsync().
// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;
var billingProfile = partnerOperations.Customers.ById(selectedCustomerId).Profiles.Billing.Get();
// Apply changes to profile;
billingProfile = partnerOperations.Customers.ById(selectedCustomerId).Profiles.Billing.Update(billingProfile);
Voorbeeld: consoletest-app. Project: Klasse PartnerSDK.FeatureSamples: UpdateCustomerBillingProfile.cs
REST-aanvraag
Aanvraagsyntaxis
Wijze | Aanvraag-URI |
---|---|
PUT | {baseURL}/v1/customers/{customer-tenant-id}/profiles/billing HTTP/1.1 |
URI-parameter
Gebruik de volgende queryparameter om het factureringsprofiel bij te werken.
Name | Type | Vereist | Beschrijving |
---|---|---|---|
klant-tenant-id | Guid | J | De waarde is een door een GUID opgemaakte klant-tenant-id waarmee de reseller de resultaten kan filteren op een bepaalde klant die deel uitmaakt van de reseller. |
Aanvraagheaders
- If-Match: "<ETag>" is vereist voor gelijktijdigheidsdetectie. Zie Rest-headers in Partnercentrum voor meer informatie.
Aanvraagtekst
De volledige resource.
Aanvraagvoorbeeld
PUT https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/profiles/billing HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ff85f13a-eb65-4b8e-9b67-05beb0565410
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 639
Expect: 100-continue
{
"Id": "a58ceba5-60ac-48e4-a0bc-2a855811807a",
"FirstName": "FirstName",
"LastName": "LastName",
"Email": "email@sample.com",
"Culture": "en-US",
"Language": "en",
"CompanyName": "CompanyName",
"DefaultAddress": {
"Country": "US",
"Region": null,
"City": "Redmond",
"State": "WA",
"AddressLine1": "One Microsoft Way",
"AddressLine2": null,
"PostalCode": "98052",
"FirstName": "FirstName",
"LastName": "LastName",
"PhoneNumber": "4255555555"
},
"Links": {
"Self": {
"Uri": "/v1/customers/<customer-tenant-id>/profiles/billing",
"Method": "GET",
"Headers": []
}
},
"Attributes": {
"Etag": "<etag>",
"ObjectType": "CustomerBillingProfile"
}
}
REST-antwoord
Als dit lukt, retourneert deze methode bijgewerkte profielresource-eigenschappen in de hoofdtekst van het antwoord. Voor deze aanroep is een ETag vereist voor gelijktijdigheidsdetectie.
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 Foutcodes voor de volledige lijst.
Responsvoorbeeld
HTTP/1.1 200 OK
Content-Length: 1210
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: ff85f13a-eb65-4b8e-9b67-05beb0565410
Date: Mon, 23 Nov 2015 18:20:43 GMT
{
"id": "a58ceba5-60ac-48e4-a0bc-2a855811807a",
"firstName": "FirstName",
"lastName": "LastName",
"email": "email@sample.com",
"culture": "en-US",
"language": "en",
"companyName": "companyName",
"defaultAddress": {
"country": "US",
"city": "Redmond",
"state": "WA",
"addressLine1": "One Microsoft Way",
"postalCode": "98052",
"firstName": "FirstName",
"lastName": "LastName",
"phoneNumber": "4255555555"
},
"links": {
"self": {
"uri": "/v1/customers/<customer-tenant-id>/profiles/billing",
"method": "GET",
"headers": []
}
},
"attributes": {
"etag": "<etag>",
"objectType": "CustomerBillingProfile"
}
}