청구서에 청구된 상업용 사용 품목 가져오기

아티클
04/26/2024

참고 항목

2024년 9월 30일 이후에 2022년 9월 이전에 생성된 새 상거래 사용량 데이터에 대해 이 API를 계속 사용할 수 있습니다. 다음 세부 정보에 따라 올바른 버전을 선택합니다.

2022년 9월부터 2024년 9월까지 청구서의 일일 등급 사용량 품목에 액세스하려면 API v2 GA로 이미 전환하지 않는 한 이 API를 2024년 9월 30일까지 사용합니다.
2022년 9월 이전의 청구 기간의 경우 이 API로만 일일 등급 사용량 품목을 가져옵니다.
2022년 9월부터 청구서에 대한 일일 등급 사용 현황 품목을 가져오려면 API v2 GA만 사용합니다.

새 API를 준비하려면 다음 링크를 따르세요.

청구 및 청구되지 않은 일일 등급 사용량 조정 API v2(GA)

다음 방법을 사용하여 지정된 청구서에 대한 상용 소비 송장 품목(일별 정격 사용량 품목이라고도 함)에 대한 세부 정보 컬렉션을 가져올 수 있습니다.

Important

일일 등급 사용량 데이터에는 다음 제품에 대한 요금이 포함되지 않습니다.

Azure 예약
Azure 절약 플랜
Office
Dynamics
Microsoft Power Apps
영구 소프트웨어
소프트웨어 구독
타사 SaaS 제품

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
품목을 가져올 청구서 ID입니다.

C#

지정된 청구서의 상용 품목을 가져오려면 청구서 개체를 검색해야 합니다.

ById 메서드를 호출하여 지정된 청구서에 대한 청구서 작업에 대한 인터페이스를 가져옵니다.
Get 또는 GetAsync 메서드를 호출하여 청구서 개체를 검색합니다. 청구서 개체에는 지정된 청구서에 대한 모든 정보가 포함됩니다.

공급자는 청구된 세부 정보(예: 일회성)의 원본을 식별합니다. InvoiceLineItemType은 형식(예: UsageLineItem)을 지정합니다.

다음 예제 코드는 foreach 루프를 사용하여 품목 컬렉션을 처리합니다. 각 InvoiceLineItemType에 대해 별도의 품목 컬렉션이 검색됩니다.

InvoiceDetail 인스턴스에 해당하는 품목 컬렉션을 가져오려면 다음을 수행합니다.

인스턴스의 BillingProvider 및 InvoiceLineItemType을 By 메서드에 전달합니다.
Get 또는 GetAsync 메서드를 호출하여 연결된 품목을 검색합니다.
다음 예제와 같이 컬렉션을 트래버스하는 열거자를 만듭니다.

// 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);
        }
    }
}

예제를 참조하세요.

샘플: 콘솔 테스트 앱
프로젝트: 파트너 센터 SDK 샘플
클래스: GetBilledConsumptionReconLineItemsPaging.cs

REST 요청

요청 구문

첫 번째 구문을 사용하여 지정된 청구서에 대한 모든 품목의 전체 목록을 반환합니다. 큰 청구서의 경우 지정된 크기 및 0부터 시작하는 오프셋이 있는 두 번째 구문을 사용하여 페이지가 지정된 품목 목록을 반환합니다. 세 번째 구문을 사용하여 을 사용하여 seekOperation = "Next"다시 정렬 항목의 다음 페이지를 가져옵니다.

메서드	요청 URI
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

URI 매개 변수

요청을 만들 때 다음 URI 및 쿼리 매개 변수를 사용합니다.

속성	Type	필수	설명
invoice-id	string	예	청구서를 식별하는 문자열입니다.
provider	string	예	공급자: "OneTime".
invoice-line-item-type	string	예	청구서 세부 정보 유형: "UsageLineItems".
currencyCode	string	예	청구된 품목의 통화 코드입니다.
기간	string	예	청구된 정찰 기간입니다. 예: 현재, 이전.
size	번호	아니요	반환할 항목의 최대 수입니다. 기본 크기는 2000입니다.
seekOperation	string	아니요	seekOperation=Next를 설정하여 다시 정렬 항목의 다음 페이지를 가져옵니다.

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

요청 본문

없음

REST 응답

성공하면 응답에 품목 세부 정보 컬렉션이 포함됩니다.

품목 ChargeType의 경우 구매 값이 New에 매핑됩니다. 환불 값은 Cancel에 매핑됩니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패 및 기타 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 기타 매개 변수를 읽습니다. 전체 목록은 파트너 센터 REST 오류 코드를 참조하세요.

REST 예제

요청-응답 예제 1

이 예제 REST 요청 및 응답에 대한 세부 정보는 다음과 같습니다.

공급자: OneTime
InvoiceLineItemType: UsageLineItems
기간: 이전

요청 예제 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