Získání fakturovaných řádkových položek komerčního využití na faktuře

Článek
04/26/2024

Poznámka:

Toto rozhraní API můžete dál používat po 30. září 2024 pro nová data o využití obchodu vygenerovaná před zářím 2022. Na základě těchto podrobností zvolte správnou verzi:

Pokud chcete získat přístup k denním položkám řádků využití faktur od září 2022 do září 2024, použijte toto rozhraní API až do 30. září 2024, pokud jste ještě nepřepnuli na obecně dostupnou verzi ROZHRANÍ API v2.
U fakturačních období před zářím 2022 získejte řádkové položky s denním hodnocením využití pouze s tímto rozhraním API.
Pokud chcete získat řádkové položky s denním hodnocením využití pro faktury ze září 2022, použijte pouze obecně dostupné rozhraní API v2.

Pomocí tohoto odkazu se připravte na nová rozhraní API:

Fakturované a nefakturované rozhraní API pro odsouhlasení využití v2 (GA)

Pomocí následujících metod můžete získat kolekci podrobností o řádkových položkách faktury za komerční spotřebu (označované také jako uzavřené položky řádku s denním hodnocením využití) pro zadanou fakturu.

Důležité

Data o denním poměru využití nezahrnují poplatky za tyto produkty:

Rezervace Azure
Úsporný plán pro Azure
Office
Dynamics
Microsoft Power Apps
Časově neomezený software
Předplatné softwaru
Produkt SaaS třetích stran

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID faktury pro získání řádkových položek.

C#

Pokud chcete získat komerční řádkové položky pro zadanou fakturu, musíte načíst objekt faktury:

Voláním metody ById získáte rozhraní pro operace faktury pro zadanou fakturu.
Voláním metody Get nebo GetAsync načtěte objekt faktury. Objekt faktury obsahuje všechny informace o zadané faktuře.

Zprostředkovatel identifikuje zdroj fakturovaných podrobných informací (například jednorázově). InvoiceLineItemType určuje typ (například UsageLineItem).

Následující příklad kódu používá smyčku foreach ke zpracování kolekce řádkových položek. Pro každou invoiceLineItemType se načte samostatná kolekce řádkových položek.

Získání kolekce řádkových položek, které odpovídají instanci InvoiceDetail :

Předejte instanci BillingProvider a InvoiceLineItemType metodě.
Volání Get nebo GetAsync metoda načíst přidružené řádkové položky.
Vytvořte enumerátor pro procházení kolekce, jak je znázorněno v následujícím příkladu.

// IAggregatePartner partnerOperations;
// string invoiceId;
// string curencyCode;
// string period;
// int pageMaxSizeReconLineItems = 2000;

// all the operations executed on this partner operation instance will share the same correlation Id but will differ in request Id
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));

var seekBasedResourceCollection = scopedPartnerOperations.Invoices.ById(invoiceId).By("onetime", "usagelineitems", curencyCode, period, pageMaxSizeReconLineItems).Get();

var fetchNext = true;

ConsoleKeyInfo keyInfo;

var itemNumber = 1;
while (fetchNext)
{
    Console.Out.WriteLine("\tLine line items count: " + seekBasedResourceCollection.Items.Count());

    seekBasedResourceCollection.Items.ToList().ForEach(item =>
    {
        // Instance of type DailyRatedUsageLineItem
        if (item is DailyRatedUsageLineItem)
        {
            Type t = typeof(DailyRatedUsageLineItem);
            PropertyInfo[] properties = t.GetProperties();

            foreach (PropertyInfo property in properties)
            {
                // Insert code here to work with the line item properties
            }
        }
        itemNumber++;
    });

    Console.Out.WriteLine("\tPress any key to fetch next data. Press the Escape (Esc) key to quit: \n");
    keyInfo = Console.ReadKey();

    if (keyInfo.Key == ConsoleKey.Escape)
    {
        break;
    }

    fetchNext = !string.IsNullOrWhiteSpace(seekBasedResourceCollection.ContinuationToken);

    if (fetchNext)
    {
        if (seekBasedResourceCollection.Links.Next.Headers != null && seekBasedResourceCollection.Links.Next.Headers.Any())
        {
            seekBasedResourceCollection = scopedPartnerOperations.Invoices.ById(invoiceId).By("onetime", "usagelineitems", curencyCode, period, pageMaxSizeReconLineItems).Seek(seekBasedResourceCollection.ContinuationToken, SeekOperation.Next);
        }
    }
}

Podívejte se na příklad:

Ukázka: Konzolová testovací aplikace
Projekt: Ukázky sady SDK v Partnerském centru
Třída: GetBilledConsumptionReconLineItemsPaging.cs

Požadavek REST

Syntaxe požadavku

První syntaxe slouží k vrácení úplného seznamu každé řádkové položky pro danou fakturu. U velkých faktur použijte druhou syntaxi se zadanou velikostí a posunem na základě 0 k vrácení stránkovaného seznamu řádků. Pomocí třetí syntaxe získáte další stránku s řádkovými položkami recon pomocí seekOperation = "Next".

metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/invoices/{invoice-id}/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode} HTTP/1.1
GET	{baseURL}/v1/invoices/{invoice-id}/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode}&size={size} HTTP/1.1
GET	{baseURL}/v1/invoices/{invoice-id}/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode}&size={size}&seekOperation=Next

Parametry identifikátoru URI

Při vytváření požadavku použijte následující identifikátor URI a parametry dotazu.

Name	Type	Požadováno	Popis
INVOICE-ID	string	Ano	Řetězec, který identifikuje fakturu.
Zprostředkovatel	string	Ano	Zprostředkovatel: OneTime.
invoice-line-item-type	string	Ano	Typ podrobností faktury: UsageLineItems.
currencyCode	string	Ano	Kód měny pro fakturované řádkové položky.
Období	string	Ano	Období fakturované recon. příklad: current, previous.
size	Číslo	No	Maximální počet položek, které se mají vrátit. Výchozí velikost je 2000
seekOperation	string	No	Nastavte funkci seekOperation=Next a získejte další stránku řádkových položek recon.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nezaokrouhlovat.

Odpověď REST

V případě úspěchu odpověď obsahuje kolekci podrobností o položce řádku.

U položky řádku ChargeType je hodnota Nákup namapována na Nový. Hodnota Refundace se mapuje na Storno.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklady REST

Příklad odpovědi požadavku 1

Podrobnosti pro tento příklad požadavku REST a odpovědi jsou následující:

Zprostředkovatel: OneTime
InvoiceLineItemType: UsageLineItems
Období: Předchozí

Příklad požadavku 1

GET https://api.partnercenter.microsoft.com/v1/invoices/T000001234/lineitems?provider=onetime&invoicelineitemtype=usagelineitems&currencycode=usd&period=previous&size=2000 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 1234ecb8-37af-45f4-a1a1-358de3ca2b9e
MS-CorrelationId: 5e612512-4345-4bb0-866e-47aeda031234
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com