Získání souhrnu nákladů na služby zákazníka

Získá náklady na službu zákazníka za zadané fakturační období.

Požadavky

  • Přihlašovací údaje popsané v partnerském centru ověřování. Tento scénář podporuje ověřování pomocí přihlašovacích údajů pro aplikace a uživatele.

  • ID zákazníka ( customer-tenant-id ). Pokud ID zákazníka neznáte, můžete ho vyhledat na řídicím panelupartnerského centra. V nabídce partnerského centra klikněte na CSP a potom na zákazníci. Vyberte zákazníka ze seznamu Zákazník a pak vyberte možnost účet. Na stránce účet zákazníka vyhledejte v části informace o účtu zákazníka ID Microsoftu . ID společnosti Microsoft je stejné jako ID zákazníka ( customer-tenant-id ).

  • Indikátor fakturačního období ( mostrecent ).

C#

Postup načtení souhrnu nákladů služby pro zadaného zákazníka:

  1. Pro identifikaci zákazníka zavolejte metodu IAggregatePartner. Customers. ById s ID zákazníka.

  2. Pomocí vlastnosti ServiceCosts můžete získat rozhraní operací shromažďování nákladů na služby zákazníkům.

  3. Voláním metody ByBillingPeriod s členem výčtu ServiceCostsBillingPeriod se vrátí IServiceCostsCollection.

  4. K získání souhrnu nákladů na službu zákazníka použijte metodu IServiceCostsCollection. Summary. Get nebo GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

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

Žádost REST

Syntaxe žádosti

Metoda Identifikátor URI žádosti
Čtěte {baseURL}/v1/Customers/{Customer-ID}/servicecosts/{Billing-period} HTTP/1.1

Parametry identifikátoru URI

K identifikaci zákazníka a fakturačního období použijte následující parametry cesty.

Název Typ Vyžadováno Popis
ID zákazníka guid Yes Identifikátor zákazníka formátovaného identifikátorem GUID, který identifikuje zákazníka.
fakturace – období řetězec Yes Indikátor, který představuje fakturační období. Jediná podporovaná hodnota je MostRecent. Případ řetězce nezáleží.

Hlavičky požadavku

Další informace najdete v tématu záhlaví REST partnerského centra.

Text požadavku

Žádné

Příklad požadavku

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

Odpověď REST

V případě úspěchu obsahuje tělo odpovědi prostředek ServiceCostsSummary , který poskytuje informace o nákladech služby.

Úspěšné odpovědi a chybové kódy

Každá odpověď je dodávána se stavovým kódem HTTP, který označuje úspěch nebo selhání a další informace o ladění. Použijte nástroj pro trasování sítě ke čtení tohoto kódu, typu chyby a dalších parametrů. Úplný seznam najdete v tématu kódy chyb REST partnerského centra.

Příklad odpovědi

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"
    }
}