Obtenir un récapitulatif des coûts de service d’un clientGet a customer's service costs summary

S’applique à :Applies to:

  • Espace partenairesPartner Center

Obtient les coûts de service d’un client pour la période de facturation spécifiée.Gets a customer's service costs for the specified billing period.

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur.This scenario supports authentication with App+User credentials.

  • ID du client (customer-tenant-id).A customer ID (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans le tableau de bord de l’Espace partenaires.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Sélectionnez CSP dans le menu Espace partenaires, puis Clients.Select CSP from the Partner Center menu, followed by Customers. Sélectionnez le client dans la liste des clients, puis Compte.Select the customer from the customer list, then select Account. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Un indicateur de période de facturation ( mostrecent ).A billing period indicator (mostrecent).

C#C#

Pour récupérer un récapitulatif des coûts de service pour le client spécifié :To retrieve a service costs summary for the specified customer:

  1. Appelez la méthode collection iaggregatepartner. Customers. méthode BYID avec l’ID client pour identifier le client.Call the IAggregatePartner.Customers.ById method with the customer ID to identify the customer.

  2. Utilisez la propriété ServiceCosts pour accéder à une interface pour les opérations de collecte des coûts du service client.Use the ServiceCosts property to get an interface to customer service costs collection operations.

  3. Appelez la méthode ByBillingPeriod avec un membre de l’énumération ServiceCostsBillingPeriod pour retourner un méthode iservicecostscollection.Call the ByBillingPeriod method with a member of the ServiceCostsBillingPeriod enumeration to return an IServiceCostsCollection.

  4. Utilisez la méthode méthode iservicecostscollection. Summary. obten ou GetAsync pour afficher le résumé des coûts de service du client.Use the IServiceCostsCollection.Summary.Get or GetAsync method to get the customer's service costs summary.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var serviceCostsSummary = partnerOperations.Customers.ById(selectedCustomerId).ServiceCosts.ByBillingPeriod(ServiceCostsBillingPeriod.MostRecent).Summary.Get();

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
GETGET {baseURL}/v1/Customers/{Customer-ID}/servicecosts/{Billing-period} http/1.1{baseURL}/v1/customers/{customer-id}/servicecosts/{billing-period} HTTP/1.1

Paramètres URIURI parameters

Utilisez les paramètres de chemin d’accès suivants pour identifier le client et la période de facturation.Use the following path parameters to identify the customer and the billing period.

NomName TypeType ObligatoireRequired DescriptionDescription
customer-idcustomer-id guidguid OuiYes ID de client au format GUID qui identifie le client.A GUID formatted customer ID that identifies the customer.
billing-periodbilling-period stringstring OuiYes Indicateur qui représente la période de facturation.An indicator that represents the billing period. La seule valeur prise en charge est MostRecent.The only supported value is MostRecent. La casse de la chaîne n’a pas d’importance.The case of the string does not matter.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Aucun.None.

Exemple de requêteRequest example

GET https://api.partnercenter.microsoft.com/v1/customers/65726577-c208-40fd-9735-8c85ac9cac68/servicecosts/mostrecent HTTP/1.1
Authorization: Bearer <authorization token>
Accept: application/json
MS-RequestId: e6a3b6b2-230a-4813-999d-57f883b60d38
MS-CorrelationId: a687bc47-8d08-4b78-aff6-5a59aa2055c2
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Réponse RESTREST response

En cas de réussite, le corps de la réponse contient une ressource ServiceCostsSummary qui fournit des informations sur les coûts du service.If successful, the response body contains a ServiceCostsSummary resource that provides information about the service costs.

Codes d’erreur et de réussite de la réponseResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.For the full list, see Partner Center REST error codes.

Exemple de réponseResponse example

HTTP/1.1 200 OK
Content-Length: 766
Content-Type: application/json; charset=utf-8
MS-CorrelationId: a687bc47-8d08-4b78-aff6-5a59aa2055c2
MS-RequestId: e6a3b6b2-230a-4813-999d-57f883b60d38
MS-CV: gPPoyNX1X0asAAcw.0
MS-ServerId: 101112202
Date: Fri, 02 Dec 2016 18: 54: 38 GMT

{
    "billingStartDate": "2015-12-12T00:00:00Z",
    "billingEndDate": "2016-01-11T00:00:00Z",
    "pretaxTotal": 17.22,
    "tax": 0.0,
    "afterTaxTotal": 17.22,
    "currencySymbol": "$",
    "customerId": "ae1d5b32-f9ff-4252-b2bf-40e21937a51a",
    "details":
     [
        {
            "invoiceType": "Recurring",
            "summary": {
                "billingStartDate": "2015-12-12T00:00:00Z",
                "billingEndDate": "2016-01-11T00:00:00Z",
                "pretaxTotal": 17.22,
                "tax": 0.0,
                "afterTaxTotal": 17.22,
                "currencyCode": "USD",
                "currencySymbol": "$",
                "customerId": "ae1d5b32-f9ff-4252-b2bf-40e21937a51a",
                "links": {},
                "attributes": {
                    "objectType": "ServiceCostsSummary"
                }
            }
        },
        {
            "invoiceType": "OneTime",
            "summary": {
                "billingStartDate": "2019-04-01T00:00:00Z",
                "billingEndDate": "2019-04-30T23:59:59.9999999Z",
                "pretaxTotal": 2,
                "tax": 0.2,
                "afterTaxTotal": 2.2,
                "currencyCode": "USD",
                "currencySymbol": "$",
                "customerId": "ae1d5b32-f9ff-4252-b2bf-40e21937a51a",
                "links": {},
                "attributes": {
                    "objectType": "ServiceCostsSummary"
                }
            }
        }
    ],
    "links": {
        "serviceCostLineItems": {
            "uri": "/customers/ae1d5b32-f9ff-4252-b2bf-40e21937a51a/servicecosts/MostRecent/lineitems",
            "method": "GET",
            "headers": []
        },
        "self": {
            "uri": "/customers/ae1d5b32-f9ff-4252-b2bf-40e21937a51a/servicecosts/MostRecent",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "ServiceCostsSummary"
    }
}