청구서 리소스
적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터
다음 청구서 관련 리소스는 파트너 센터 API를 통해 사용할 수 있습니다.
송장
| 속성 | Type | 설명 |
|---|---|---|
| id | string | 청구서 식별자입니다. |
| invoiceDate | UTC 날짜-시간 형식의 문자열 | 청구서가 생성된 날짜입니다. |
| billingPeriodStartDate | UTC 날짜-시간 형식의 문자열 | 청구 기간 시작 날짜(UTC)입니다. |
| billingPeriodEndDate | UTC 날짜-시간 형식의 문자열 | 청구 기간 종료 날짜(UTC)입니다. |
| totalCharges | number | 총 요금입니다. 트랜잭션 및 조정에 대한 요금을 포함합니다. |
| paidAmount | number | 파트너가 지불한 금액입니다. 지불이 수신된 경우 음수입니다. |
| currencyCode | string | 모든 청구서 항목 금액 및 합계에 사용되는 통화를 나타내는 코드입니다. |
| currencySymbol | string | 모든 청구서 항목 금액 및 합계에 사용되는 통화 기호입니다. |
| pdfDownloadLink | string | PDF 형식으로 청구서를 다운로드하는 링크입니다. 이 링크는 검색 결과의 일부로 반환되지 않으며 ID로 청구서에 액세스하는 경우에만 채워집니다. 이 링크는 30분 후에 자동으로 만료됩니다. |
| invoiceDetails | InvoiceDetail 개체의 배열 | 청구서 세부 정보입니다. |
| 개정 | Invoice 개체의 배열 | 이 청구서의 수정 사항입니다. |
| documentType | string | 청구서의 문서 유형: "Credit Note", "Invoice". |
| amendsOf | string | 이 문서가 수정된 문서의 참조 번호입니다. |
| invoiceType | string | 청구서 유형: "되풀이", "one_time" |
| 링크 | ResourceLinks | 리소스 링크입니다. |
| attributes | ResourceAttributes | 메타데이터 특성입니다. |
| collectionOfSummary | TaxReceipt 개체의 배열 | 세금 영수증 다운로드 링크를 가져오거나 설정합니다. |
| 상태 | string | "활성", "void" 등과 같은 청구서 상태를 가져옵니다. |
InvoiceDetail
청구서에는 청구된 항목의 컬렉션이 포함되며 각 항목은 InvoiceDetail 리소스로 표시됩니다.
| 속성 | Type | 설명 |
|---|---|---|
| invoiceLineItemType | string | 청구서 세부 정보 유형: "none", "usage_line_items", "billing/_line_items". |
| billingProvider | string | 청구 공급자: "None", "Office", "Azure", "OneTime". |
| 링크 | ResourceLinks | 리소스 링크입니다. |
| attributes | ResourceAttributes | 메타데이터 특성입니다. |
InvoiceLineItem
청구서 내의 각 개별 요금은 InvoiceLineItem으로 표시됩니다.
| 속성 | Type | 설명 |
|---|---|---|
| invoiceLineItemType | string | 청구서 품목 유형: "none", "usage_line_items", "billing/_line_items". |
| billingProvider | string | 청구 공급자: "None", "Office", "Azure", "OneTime". |
| attributes | ResourceAttributes | 메타데이터 특성입니다. |
InvoiceSummary
청구서의 잔액 및 총 요금에 대한 요약을 설명합니다.
| 속성 | Type | 설명 |
|---|---|---|
| balanceAmount | number | 청구서의 잔액입니다. 이것은 미지급 청구서의 총 금액입니다. |
| currencyCode | string | 잔액 금액에 사용되는 통화를 나타내는 코드입니다. |
| currencySymbol | string | 사용되는 통화 기호입니다. |
| accountingDate | UTC 날짜-시간 형식의 문자열 | 잔액 금액이 마지막으로 업데이트된 날짜입니다. |
| firstInvoiceCreationDate | UTC 날짜-시간 형식의 문자열 | 고객에 대한 첫 번째 청구서가 만들어진 날짜입니다. |
| lastPaymentDate | UTC 날짜-시간 형식의 문자열 | 마지막 결제 날짜입니다. |
| lastPaymentAmount | number | 마지막 결제 금액입니다. |
| latestInvoiceDate | UTC 날짜-시간 형식의 문자열 | 고객에 대한 마지막 청구서가 만들어진 날짜입니다. |
| details | InvoiceSummaryDetail 개체의 배열 | 청구서 요약 정보입니다. |
| 링크 | ResourceLinks | 리소스 링크입니다. |
| attributes | ResourceAttributes | 메타데이터 특성입니다. |
InvoiceSummaryDetail
청구서 유형(예: 되풀이, one_time)에 대한 개별 세부 정보의 요약을 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| invoiceType | string | 청구서 유형: "되풀이", "one_time" |
| 요약 | InvoiceSummary 개체 | 청구서 유형별 청구서 요약입니다. |
InvoiceSummaries
통화당 송장 유형에 대한 개별 세부 정보가 포함된 InvoiceSummary 형식의 컬렉션을 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| collectionOfSummary | InvoiceSummary 개체의 배열 | 통화당 청구서 유형별 청구서 요약입니다. |
LicenseBasedLineItem
라이선스 기반 구독에 대한 청구서 청구 품목을 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| 금액 | string | 총 금액을 가져오거나 설정합니다. 총 금액 = 단가 * 수량입니다. |
| attributes | string | 특성을 가져옵니다. |
| billingCycleType | string | 청구 주기 형식을 가져오거나 설정합니다. |
| billingProvider | string | 청구 공급자를 가져옵니다. |
| chargeEndDate | UTC 날짜-시간 형식의 문자열 | 요금의 종료 날짜를 가져오거나 설정합니다. |
| chargeStartDate | UTC 날짜-시간 형식의 문자열 | 요금의 시작 날짜를 가져오거나 설정합니다. |
| chargeType | string | 요금 유형을 가져오거나 설정합니다. |
| 통화 | string | 이 품목에 사용되는 통화를 가져오거나 설정합니다. |
| customerId | string | Microsoft 청구 플랫폼에서 고객 고유 식별자를 가져오거나 설정합니다. |
| customerName | UTC 날짜-시간 형식의 문자열 | 고객 이름을 가져오거나 설정합니다. |
| domainName | string | 도메인 이름을 가져오거나 설정합니다. |
| durableOfferId | string | 지속성 제품 고유 식별자를 가져오거나 설정합니다. |
| invoiceLineItemType | string | 청구서 품목의 유형을 가져옵니다. |
| partnerId | number | 이 품목에 연결된 PartnerID를 가져오거나 설정합니다. 직접 재판매인의 경우 재판매인의 PartnerID입니다. 간접 재판매인의 경우 VAR(Value Added Reseller)의 PartnerID입니다. |
| offerId | string | 제품 고유 식별자를 가져오거나 설정합니다. |
| offerName | string | 제품 이름을 가져오거나 설정합니다. |
| orderId | string | 순서 고유 식별자를 가져오거나 설정합니다. |
| partnerId | string | 파트너 Microsoft Entra 테넌트 ID를 가져오거나 설정합니다. |
| quantity | number | 이 품목과 연결된 단위 수를 가져오거나 설정합니다. |
| subscriptionDescription | string | 구독 설명을 가져오거나 설정합니다. |
| subscriptionEndDate | UTC 날짜-시간 형식의 문자열 | 구독이 만료되는 날짜를 가져오거나 설정합니다. |
| subscriptionId | string | 구독 고유 식별자를 가져오거나 설정합니다. |
| subscriptionName | string | 구독 이름을 가져오거나 설정합니다. |
| subscriptionStartDate | UTC 날짜-시간 형식의 문자열 | 구독이 시작되는 날짜를 가져오거나 설정합니다. |
| 소계 | number | 할인 후 금액을 가져오거나 설정합니다. |
| syndicationPartnerSubscriptionNumber | string | 배포 파트너 구독 번호를 가져오거나 설정합니다. |
| 세금 | number | 부과되는 세금을 가져오거나 설정합니다. |
| tier2MpnId | number | 이 품목에 연결된 계층 2 파트너의 PartnerID를 가져오거나 설정합니다. |
| totalForCustomer | number | 할인 및 세금 이후의 총 금액을 가져오거나 설정합니다. |
| totalOtherDiscount | number | 이 구매와 관련된 할인을 가져오거나 설정합니다. |
| unitPrice | number | 단가를 가져오거나 설정합니다. |
UsageBasedLineItem
사용량 기반 구독에 대한 청구서 청구 품목을 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| attributes | string | 특성을 가져옵니다. |
| billingCycleType | string | 청구 주기 형식을 가져오거나 설정합니다. |
| billingProvider | string | 청구 공급자를 가져옵니다. |
| chargeEndDate | UTC 날짜-시간 형식의 문자열 | 요금의 종료 날짜를 가져오거나 설정합니다. |
| chargeStartDate | UTC 날짜-시간 형식의 문자열 | 요금의 시작 날짜를 가져오거나 설정합니다. |
| chargeType | string | 요금 유형을 가져오거나 설정합니다. |
| consumedQuantity | number | 사용된 총 단위를 가져오거나 설정합니다. |
| consumptionDiscount | string | 사용량 할인을 가져오거나 설정합니다. |
| consumptionPrice | string | 사용된 수량의 가격을 가져오거나 설정합니다. |
| 통화 | string | 가격과 연결된 통화를 가져오거나 설정합니다. |
| customerName | string | 고객 이름을 가져오거나 설정합니다. |
| customerId | string | 고객 고유 식별자를 가져오거나 설정합니다. |
| detailLineItemId | number | 세부 정보 줄 항목 ID를 가져오거나 설정합니다. 사용된 단위에 대해 계산이 다른 경우의 줄 항목을 고유하게 식별합니다. 예: 사용된 총액 = 1338, 1024는 한 요율로 청구되고, 314는 다른 요금으로 청구됩니다. |
| domainName | string | 도메인 이름을 가져오거나 설정합니다. |
| includedQuantity | number | 순서에 포함된 단위를 가져오거나 설정합니다. |
| invoiceLineItemType | string | 청구서 품목의 유형을 가져옵니다. |
| invoiceNumber | string | 청구서 번호를 가져오거나 설정합니다. |
| listPrice | number | 각 단위의 가격을 가져오거나 설정합니다. |
| partnerId | number | 이 품목에 연결된 PartnerID를 가져오거나 설정합니다. 직접 재판매인의 경우 재판매인의 PartnerID입니다. 간접 재판매인의 경우 VAR(Value Added Reseller)의 PartnerID입니다. |
| orderId | string | 순서 고유 식별자를 가져오거나 설정합니다. |
| overageQuantity | number | 허용되는 사용량보다 많이 사용되는 수량을 가져오거나 설정합니다. |
| partnerBillableAccountId | string | 파트너 청구 가능 계정 ID를 가져오거나 설정합니다. |
| partnerId | string | 파트너 Microsoft Entra 테넌트 ID를 가져오거나 설정합니다. |
| partnerName | string | 파트너의 이름을 가져오거나 설정합니다. |
| postTaxEffectiveRate | number | 세금 이후의 유효 가격을 가져오거나 설정합니다. |
| postTaxTotal | number | 세금 이후의 총 요금을 가져오거나 설정합니다. 세전 요금 + 세금 금액 |
| preTaxCharges | number | 세금 전에 청구되는 가격을 가져오거나 설정합니다. |
| preTaxEffectiveRate | number | 세금 이전의 유효 가격을 가져오거나 설정합니다. |
| region | string | 리소스 인스턴스와 연결된 지역을 가져오거나 설정합니다. |
| resourceGuid | string | 리소스 식별자를 가져오거나 설정합니다. |
| resourceName에 대한 추천 사항을 찾았음 | string | 리소스 이름을 가져오거나 설정합니다. 예: 데이터베이스(GB/월). |
| serviceName | string | 서비스 이름을 가져오거나 설정합니다. 예: Azure Data Service. |
| serviceType | string | 서비스 유형을 가져오거나 설정합니다. 예: Azure SQL Azure DB. |
| sku | string | 서비스 SKU를 가져오거나 설정합니다. |
| subscriptionDescription | string | 구독 설명을 가져오거나 설정합니다. |
| subscriptionId | string | 구독 고유 식별자를 가져오거나 설정합니다. |
| subscriptionName | string | 구독 이름을 가져오거나 설정합니다. |
| taxAmount | number | 부과되는 세금 금액을 가져오거나 설정합니다. |
| tier2MpnId | number | 이 품목에 연결된 계층 2 파트너의 PartnerID를 가져오거나 설정합니다. |
| 단위 | string | Azure 사용량에 대한 측정 단위를 가져오거나 설정합니다. |
InvoiceStatement
애플리케이션/pdf의 청구서 문에서 사용할 수 있는 작업을 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| httpResponseMessage | 개체 | contentType = application/pdf를 사용하는 ByteArrayContent입니다. |
OneTimeInvoiceLineItem
라이선스 기반 구독에 대한 청구서 청구 품목을 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| PartnerId | string | 파트너 테넌트 ID를 가져오거나 설정합니다. |
| 고객 ID | string | 고객 테넌트 ID를 가져오거나 설정합니다. |
| CustomerName | string | 고객 이름을 가져오거나 설정합니다. |
| CustomerDomainName | string | 고객 도메인 이름을 가져오거나 설정합니다. |
| CustomerCountry | string | 고객 국가/지역을 가져오거나 설정합니다. |
| InvoiceNumber | string | 청구서 번호를 가져오거나 설정합니다. |
| MpnId | string | 이 품목에 연결된 PartnerID를 가져오거나 설정합니다. |
| ResellerMpnId | int | 이 품목에 연결된 계층 2 파트너의 PartnerID를 가져오거나 설정합니다. |
| OrderDate | DateTime | 주문이 만들어진 날짜를 가져오거나 설정합니다. |
| OrderId | string | Microsoft 청구 플랫폼에서 사용되는 주문의 고유 식별자입니다. |
| ProductId | string | 제품 고유 식별자를 가져오거나 설정합니다. |
| SkuId | string | SKU 고유 식별자를 가져오거나 설정합니다. |
| AvailabilityId | string | 가용성 고유 식별자를 가져오거나 설정합니다. |
| ProductName | string | 제품 이름을 가져오거나 설정합니다. |
| SkuName | string | SKU 이름을 가져오거나 설정합니다. |
| ChargeType | string | 요금 유형을 가져오거나 설정합니다. |
| UnitPrice | decimal | 단가를 가져오거나 설정합니다. |
| EffectiveUnitPrice | decimal | 유효 단가를 가져오거나 설정합니다. |
| UnitType | string | 단위 형식을 가져오거나 설정합니다. |
| 수량 | int | 이 품목과 연결된 단위 수를 가져오거나 설정합니다. |
| 소계 | decimal | 할인 후 금액을 가져오거나 설정합니다. |
| TaxTotal | decimal | 부과되는 세금을 가져오거나 설정합니다. |
| TotalForCustomer | decimal | 할인 및 세금 이후의 총 금액을 가져오거나 설정합니다. |
| 통화 | string | 이 품목에 사용되는 통화를 가져오거나 설정합니다. |
| PublisherName | string | 이 구매와 연결된 게시자 이름을 가져오거나 설정합니다. |
| PublisherId | string | 이 구매와 연결된 게시자 ID를 가져오거나 설정합니다. |
| SubscriptionDescription | string | 이 구매와 연결된 구독 설명을 가져오거나 설정합니다. |
| SubscriptionId | string | 이 구매와 연결된 구독 ID를 가져오거나 설정합니다. |
| ChargeStartDate | DateTime | 이 구매와 관련된 요금 시작 날짜를 가져오거나 설정합니다. |
| ChargeEndDate | DateTime | 이 구매와 관련된 요금 종료 날짜를 가져오거나 설정합니다. |
| TermAndBillingCycle | string | 이 구매와 관련된 용어 및 청구 주기 가져오거나 설정합니다. |
| AlternateId | string | 대체 ID(견적 ID)를 가져오거나 설정합니다. |
| PriceAdjustmentDescription | string | 가격 조정 설명을 가져오거나 설정합니다. |
| CreditReasonCode | string | 신용 이유 코드를 가져오거나 설정합니다. |
| DiscountDetails | string | 더 이상 사용되지 않음 이 구매와 관련된 할인 세부 정보를 가져오거나 설정합니다. |
| PricingCurrency | string | 가격 책정 통화 코드를 가져오거나 설정합니다. |
| PCToBCExchangeRate | decimal | 가격 책정 통화를 청구 환율로 가져오거나 설정합니다. |
| PCToBCExchangeRateDate | DateTime | 청구 통화 환율에 대한 가격 책정 통화가 결정된 환율 날짜를 가져오거나 설정합니다. |
| BillableQuantity | decimal | 구매한 단위를 가져오거나 설정합니다. BillableQuantity라는 각 디자인 열에 대해 |
| MeterDescription | string | 소비 품목에 대한 미터 설명을 가져오거나 설정합니다. |
| ReservationOrderId | string | Azure RI 구매에 대한 예약 주문 식별자를 가져오거나 설정합니다. |
| BillingFrequency | string | 청구 빈도를 가져오거나 설정합니다. |
| InvoiceLineItemType | InvoiceLineItemType | 청구서 품목의 유형을 반환합니다. |
| BillingProvider | BillingProvider | 청구 공급자를 반환합니다. |
| ProductQualifiers | string | 추가 기능 또는 평가판 구매를 알 수 있는 식별자입니다. |
| PromotionId | string | 승격 정보를 검색하기 위한 식별자입니다. |
DailyRatedUsageLineItem
일일 등급 사용량에 대한 청구되지 않는 청구된 조정 품목을 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| PartnerId | string | 파트너 테넌트 ID를 가져오거나 설정합니다. |
| PartnerName | string | 파트너 이름을 가져오거나 설정합니다. |
| 고객 ID | string | 사용량이 속한 고객의 테넌트 ID를 가져오거나 설정합니다. |
| CustomerName | string | 사용량이 속한 고객 회사의 이름을 가져오거나 설정합니다. |
| CustomerDomainName | string | 사용량이 속한 고객의 도메인 이름을 가져오거나 설정합니다. |
| InvoiceNumber | string | 사용량이 속한 청구서의 ID를 가져오거나 설정합니다. |
| ProductId | string | 제품 고유 식별자를 가져오거나 설정합니다. |
| SkuId | string | SKU 고유 식별자를 가져오거나 설정합니다. |
| AvailabilityId | string | 가용성 고유 식별자를 가져오거나 설정합니다. |
| SkuName | string | 서비스의 SKU 이름을 가져오거나 설정합니다. |
| ProductName | string | 제품의 이름을 가져오거나 설정합니다. |
| PublisherName | string | 게시자의 이름을 가져오거나 설정합니다. |
| PublisherId | string | 게시자의 ID를 가져오거나 설정합니다. |
| SubscriptionId | string | 구독 ID를 가져오거나 설정합니다. |
| SubscriptionDescription | string | 구독 설명을 가져오거나 설정합니다. |
| ChargeStartDate | DateTime | 요금 시작 날짜를 가져오거나 설정합니다. |
| ChargeEndDate | DateTime | 요금 종료 날짜를 가져오거나 설정합니다. |
| UsageDate | DateTime | 사용 날짜를 가져오거나 설정합니다. |
| MeterType | string | 미터 유형을 가져오거나 설정합니다. |
| MeterCategory | string | 미터 범주를 가져오거나 설정합니다. |
| MeterId | string | 미터 ID(GUID)를 가져오거나 설정합니다. |
| MeterSubCategory | string | 미터 하위 범주를 가져오거나 설정합니다. |
| MeterName | string | 미터 이름을 가져오거나 설정합니다. |
| MeterRegion | string | 미터 영역을 가져오거나 설정합니다. |
| UnitOfMeasure | string | 측정 단위를 가져오거나 설정합니다. |
| ResourceLocation | string | 리소스의 위치를 가져오거나 설정합니다. |
| ConsumedService | string | 사용된 서비스 이름을 가져오거나 설정합니다. |
| ResourceGroup | string | 리소스 그룹의 이름을 가져오거나 설정합니다. |
| ResourceUri | string | 사용량이 있는 리소스 인스턴스의 URI를 가져오거나 설정합니다. |
| 태그 | string | 고객이 추가한 태그를 가져오거나 설정합니다. |
| AdditionalInfo | string | 서비스별 메타데이터를 가져오거나 설정합니다. 예를 들어 가상 머신용 이미지 형식입니다. |
| ServiceInfo1 | string | 내부 Azure 서비스 메타데이터를 가져오거나 설정합니다. |
| ServiceInfo2 | string | 서비스 정보(예: 가상 머신의 이미지 형식 및 ExpressRoute의 ISP 이름)를 가져오거나 설정합니다. |
| CustomerCountry | string | 고객의 국가/지역을 가져오거나 설정합니다. |
| MpnId | string | 이 품목에 연결된 PartnerID를 가져오거나 설정합니다. |
| ResellerMpnId | string | 이 품목에 연결된 계층 2 파트너의 Reseller PartnerID를 가져오거나 설정합니다. |
| ChargeType | string | 요금 유형을 가져오거나 설정합니다. |
| UnitPrice | decimal | 단가를 가져오거나 설정합니다. |
| 수량 | decimal | 사용량을 가져오거나 설정합니다. |
| UnitType | string | 단위 형식(예: 1시간)을 가져오거나 설정합니다. |
| BillingPreTaxTotal | decimal | 고객 또는 청구 통화의 현지 통화로 세전 연장 비용 또는 총 비용을 가져오거나 설정합니다. |
| BillingCurrency | string | 미터가 고객 또는 청구 통화의 현지 통화로 청구되는 ISO 통화를 가져오거나 설정합니다. |
| PricingPreTaxTotal | decimal | 등급에 사용되는 USD 또는 카탈로그 통화로 세금 이전의 확장 비용 또는 총 비용을 가져오거나 설정합니다. |
| PricingCurrency | string | 미터가 USD로 청구되는 ISO 통화 또는 등급에 사용되는 카탈로그 통화를 가져오거나 설정합니다. |
| EntitlementId | string | 권한(Azure 구독) ID를 가져오거나 설정합니다. |
| EntitlementDescription | string | 권한(Azure 구독) 설명을 가져오거나 설정합니다. |
| PCToBCExchangeRate | string | 가격 책정 통화를 청구 환율로 가져오거나 설정합니다. |
| PCToBCExchangeRateDate | DateTime | 가격 책정 통화를 청구 환율 날짜로 가져오거나 설정합니다. |
| EffectiveUnitPrice | decimal | 유효 단가를 가져오거나 설정합니다. |
| RateOfPartnerEarnedCredit | decimal | 파트너 획득 크레딧의 비율을 가져오거나 설정합니다. |
| HasPartnerEarnedCredit | bool | 파트너 획득 크레딧을 가져오거나 설정합니다. |
| RateOfCredit | decimal | 지정된 크레딧 유형에 대한 크레딧 비율을 가져오거나 설정합니다. |
| CreditType | string | 크레딧 유형을 가져오거나 설정합니다. |
| InvoiceLineItemType | InvoiceLineItemType | 청구서 품목의 유형을 반환합니다. |
| BillingProvider | BillingProvider | 청구 공급자를 반환합니다. |