Obtenir le profil de facturation d’un client

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Obtient le profil de facturation d’un client.

Dans l’Espace partenaires, cette opération peut être effectuée en sélectionnant d’abord un client. Le profil de facturation se trouve sous le titre Informations de facturation.

Prérequis

• Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification d’application et d’application+utilisateur autonomes.

• ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace partenaires. Sélectionnez l’espace de travail Clients dans la page d’accueil de l’Espace partenaires. Sélectionnez le client dans la liste Des clients, puis sélectionnez Compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Détails du compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).

C#

Pour obtenir le profil de facturation d’un client, utilisez votre collection IPartner.Customers et appelez la méthode ById(). Appelez ensuite la propriété Profiles, suivie de la propriété Billing. Enfin, appelez les méthodes Get() ou GetAsync().

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;

var billingProfile = partnerOperations.Customers.ById(selectedCustomerId).Profiles.Billing.Get();

Exemple : Application de test de console. Projet : PartnerSDK.FeatureSamples , classe : GetCustomerBillingProfile.cs

Demande REST

Syntaxe de la requête

Méthode	URI de demande
GET	{baseURL}/v1/customers/{customer-tenant-id}/profiles/billing HTTP/1.1

Paramètre d’URI

Utilisez le paramètre de requête suivant pour obtenir le profil de facturation.

Nom	Type	Obligatoire	Description
id-locataire-client	guid	Y	La valeur est un ID client au format GUID qui permet au revendeur de filtrer les résultats d’un client donné qui appartient au revendeur.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la demande

Aucun

Exemple de requête

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/profiles/billing HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: a5581a74-2778-4e34-9172-18baa4877081
MS-CorrelationId: 51d521b3-62db-4682-b75d-fb8ab09113b2

Réponse REST

Si elle réussit, cette méthode retourne une collection de ressources Profile dans le corps de la réponse.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

HTTP/1.1 200 OK
Content-Length: 1206
Content-Type: application/json
MS-CorrelationId: 51d521b3-62db-4682-b75d-fb8ab09113b2
MS-RequestId: a5581a74-2778-4e34-9172-18baa4877081
Date: Mon, 23 Nov 2015 18:13:43 GMT

{
    "id": "<billing-profile-id>",
    "firstName": "FirstName",
    "lastName": "LastName",
    "email": "email@sample.com",
    "culture": "en-US",
    "language": "en",
    "companyName": "CompanyName",
    "defaultAddress": {
        "country": "US",
        "city": "Redmond",
        "state": "WA",
        "addressLine1": "1 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"
    }
}