Invoices - Get By Billing Account

서비스:

Billing

API 버전:

2024-04-01

청구 계정 이름 및 ID로 청구서를 가져옵니다. 이 작업은 계약 유형이 Microsoft 파트너 계약 또는 Microsoft 고객 계약인 청구 계정에 대해 지원됩니다.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}?api-version=2024-04-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountName	path	True	string	청구 계정을 고유하게 식별하는 ID입니다. regex 패턴: ^([0-9]+|([Pp][Cc][Nn]\.[A-Za-z0-9]+)|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$
invoiceName	path	True	string	청구서를 고유하게 식별하는 ID입니다. regex 패턴: ^(H[0-9]-[A-Z0-9]+)$|^(?:([GHT]|HT){1}[A-Z0-9]{9})$|^(?:[D]{1}[A-Z0-9]{9})$|^(?:E{1}[B-Z0-9]{1}[A-Z0-9]{8})$|^(?:EA[A-Z0-9]{8})$
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2024-04-01입니다.

응답

Name	형식	Description
200 OK	Invoice	청구서 목록입니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

예제

InvoicesGetByBillingAccount

샘플 요청

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G123456789?api-version=2024-04-01

샘플 응답

상태 코드:

200

{
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G123456789",
  "name": "G123456789",
  "properties": {
    "amountDue": {
      "currency": "USD",
      "value": 8.53
    },
    "azurePrepaymentApplied": {
      "currency": "USD",
      "value": 25.46
    },
    "billedAmount": {
      "currency": "USD",
      "value": 33.99
    },
    "billingProfileDisplayName": "Contoso Operations Billing",
    "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
    "creditAmount": {
      "currency": "USD",
      "value": 0
    },
    "documents": [
      {
        "kind": "Invoice",
        "name": "12345678"
      },
      {
        "kind": "TaxReceipt",
        "name": "22345678"
      }
    ],
    "documentType": "Invoice",
    "dueDate": "2023-02-16T17:32:28Z",
    "freeAzureCreditApplied": {
      "currency": "USD",
      "value": 0
    },
    "invoiceDate": "2023-02-01T17:32:28Z",
    "invoicePeriodEndDate": "2023-02-15T17:32:28Z",
    "invoicePeriodStartDate": "2023-02-01T17:32:28Z",
    "isMonthlyInvoice": false,
    "purchaseOrderNumber": "123456",
    "rebillDetails": {
      "invoiceDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/I000002",
      "creditNoteDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/CreditNote2",
      "rebillDetails": {
        "invoiceDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/I000001",
        "creditNoteDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/CreditNote"
      }
    },
    "status": "Due",
    "specialTaxationType": "SubtotalLevel",
    "subTotal": {
      "currency": "USD",
      "value": 33.99
    },
    "taxAmount": {
      "currency": "USD",
      "value": 1
    },
    "totalAmount": {
      "currency": "USD",
      "value": 7.53
    }
  },
  "type": "Microsoft.Billing/billingAccounts/invoices"
}

정의

Name	Description
Amount	금액입니다.
AmountDue	현재 기한입니다.
AmountRefunded	환불된 금액입니다.
AmountRequested	요청된 환불 금액입니다.
AzurePrepaymentApplied	요금에 적용되는 Azure 선불 금액입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
BilledAmount	청구서 청구 기간의 총 요금입니다.
createdByType	리소스를 만든 ID의 형식입니다.
CreditAmount	청구서 청구 기간 동안 반환 및 취소에 대한 총 환불입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
DocumentSource	문서의 원본입니다. 세계의 나머지 부분에 대한 브라질 및 DRS에 대한 ENF.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
FailedPayment	실패한 지불입니다.
FailedPaymentReason	결제에 실패한 이유입니다.
FreeAzureCreditApplied	요금에 적용되는 무료 Azure 크레딧의 양입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
Invoice	청구서입니다.
InvoiceDocument	문서의 속성입니다.
InvoiceDocumentType	문서의 형식입니다.
InvoiceProperties	청구서입니다.
InvoiceStatus	청구서의 현재 상태입니다.
InvoiceType	청구서 유형입니다.
Payment	청구서 지불입니다.
PaymentMethodFamily	결제 방법의 제품군입니다.
RebillDetails	청구서의 리빌 세부 정보입니다.
RefundDetails	환불 요청의 세부 정보입니다.
RefundReasonCode	환불 이유입니다.
RefundStatus	환불 요청의 상태입니다.
SpecialTaxationType	청구서에 사용되는 세금 계산 유형을 식별합니다. 이 필드는 특별 세금 계산 논리가 있는 청구서에만 적용됩니다.
SubTotal	세전 금액입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
TaxAmount	청구 기간에 대해 부과되는 세금 금액입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
TotalAmount	청구서가 생성되었을 때의 기한입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.

Amount

금액입니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

AmountDue

현재 기한입니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

AmountRefunded

환불된 금액입니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

AmountRequested

요청된 환불 금액입니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

AzurePrepaymentApplied

요금에 적용되는 Azure 선불 금액입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

BilledAmount

청구서 청구 기간의 총 요금입니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

createdByType

리소스를 만든 ID의 형식입니다.

Name	형식	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CreditAmount

청구서 청구 기간 동안 반환 및 취소에 대한 총 환불입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

DocumentSource

문서의 원본입니다. 세계의 나머지 부분에 대한 브라질 및 DRS에 대한 ENF.

Name	형식	Description
DRS	string
ENF	string
Other	string

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

FailedPayment

실패한 지불입니다.

Name	형식	Description
date	string	결제가 시도된 날짜입니다.
failedPaymentReason	FailedPaymentReason	결제에 실패한 이유입니다.

FailedPaymentReason

결제에 실패한 이유입니다.

Name	형식	Description
BankDeclined	string
CardExpired	string
IncorrectCardDetails	string
Other	string

FreeAzureCreditApplied

요금에 적용되는 무료 Azure 크레딧의 양입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

Invoice

청구서입니다.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	리소스의 이름
properties	InvoiceProperties	청구서입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스와 연결된 메타데이터의 사전입니다. 모든 리소스 종류에 대해 채워지지 않을 수 있습니다. 최대 키/값 길이는 256자로 지원됩니다. 키/값은 값이나 null을 비워서는 안 됩니다. 키에는 <> % & \ ? /
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

InvoiceDocument

문서의 속성입니다.

Name	형식	Description
documentNumbers	string[]	청구서 문서의 문서 번호입니다.
externalUrl	string	원본이 Microsoft.Billing 외부에 있는 경우 청구서 문서를 다운로드할 URL입니다.
kind	InvoiceDocumentType	문서의 형식입니다.
name	string	청구서 문서를 고유하게 식별하는 ID입니다. 이 ID는 청구서 PDF, 신용 메모 또는 세금 영수증의 식별자일 수 있습니다.
source	DocumentSource	문서의 원본입니다. 세계의 나머지 부분에 대한 브라질 및 DRS에 대한 ENF.
url	string	원본이 Microsoft.Billing 내부인 경우 청구서 문서를 다운로드할 URL입니다.

InvoiceDocumentType

문서의 형식입니다.

Name	형식	Description
CreditNote	string
Invoice	string
Other	string
Summary	string
TaxReceipt	string
Transactions	string
VoidNote	string

InvoiceProperties

청구서입니다.

Name	형식	Description
amountDue	AmountDue	현재 기한입니다.
azurePrepaymentApplied	AzurePrepaymentApplied	요금에 적용되는 Azure 선불 금액입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
billedAmount	BilledAmount	청구서 청구 기간의 총 요금입니다.
billedDocumentId	string	이 청구서가 무효화된 후 원래 청구된 활성 청구서의 ID입니다. 이 필드는 void 청구서에만 적용됩니다.
billingProfileDisplayName	string	청구서가 생성되는 청구 프로필의 이름입니다.
billingProfileId	string	청구서가 생성되는 청구 프로필의 ID입니다.
creditAmount	CreditAmount	청구서 청구 기간 동안 반환 및 취소에 대한 총 환불입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
creditForDocumentId	string	무효화된 청구서의 ID이며, 그 결과 이 크레딧 메모가 발행되었습니다. 이 필드는 크레딧 노트에만 적용됩니다.
documentType	InvoiceDocumentType	문서의 형식입니다.
documents	InvoiceDocument[]	송장, 신용 메모 또는 세금 영수증과 같이 다운로드하여 볼 수 있는 문서 목록입니다.
dueDate	string	청구서의 기한입니다.
failedPayments	FailedPayment[]	실패한 결제 목록입니다.
freeAzureCreditApplied	FreeAzureCreditApplied	요금에 적용되는 무료 Azure 크레딧의 양입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
invoiceDate	string	청구서가 생성된 날짜입니다.
invoicePeriodEndDate	string	청구서가 생성되는 청구 기간의 종료 날짜입니다. 날짜는 MMDD-YYYY 형식입니다.
invoicePeriodStartDate	string	청구서가 생성되는 청구 기간의 시작 날짜입니다. 날짜는 MMDD-YYYY 형식입니다.
invoiceType	InvoiceType	청구서 유형입니다.
isMonthlyInvoice	boolean	청구서가 월별 송장 송장 주기의 일부로 생성되는지 여부를 지정합니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
payments	Payment[]	지불 목록입니다.
purchaseOrderNumber	string	청구서에 대한 선택적 구매 주문 번호입니다.
rebillDetails	RebillDetails	청구서에 대한 세부 정보를 다시 입력합니다.
refundDetails	RefundDetails	환불 요청의 세부 정보입니다.
specialTaxationType	SpecialTaxationType	청구서에 사용되는 세금 계산 유형을 식별합니다. 이 필드는 특별 세금 계산 논리가 있는 청구서에만 적용됩니다.
status	InvoiceStatus	청구서의 현재 상태입니다.
subTotal	SubTotal	세전 금액입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
subscriptionDisplayName	string	청구서가 생성되는 청구 구독의 이름입니다.
subscriptionId	string	청구서가 생성되는 구독의 ID입니다.
taxAmount	TaxAmount	청구 기간에 대해 부과되는 세금 금액입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.
totalAmount	TotalAmount	청구서가 생성되었을 때의 기한입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.

InvoiceStatus

청구서의 현재 상태입니다.

Name	형식	Description
Due	string
Locked	string
Other	string
OverDue	string
Paid	string
Void	string

InvoiceType

청구서 유형입니다.

Name	형식	Description
AzureMarketplace	string
AzureServices	string
AzureSupport	string
Other	string

Payment

청구서 지불입니다.

Name	형식	Description
amount	Amount	유료 금액입니다.
date	string	결제한 날짜입니다.
paymentMethodFamily	PaymentMethodFamily	결제 방법의 제품군입니다.
paymentMethodId	string	청구서에 사용되는 결제 방법을 고유하게 식별하는 ID입니다.
paymentMethodType	string	결제 방법의 유형입니다.
paymentType	string	결제 유형입니다.

PaymentMethodFamily

결제 방법의 제품군입니다.

Name	형식	Description
CheckWire	string
CreditCard	string
Credits	string
DirectDebit	string
EWallet	string
None	string
Other	string
TaskOrder	string

RebillDetails

청구서의 리빌 세부 정보입니다.

Name	형식	Description
creditNoteDocumentId	string	신용 메모의 ID입니다.
invoiceDocumentId	string	청구서의 ID입니다.
rebillDetails	RebillDetails	청구서의 리빌 세부 정보입니다.

RefundDetails

환불 요청의 세부 정보입니다.

Name	형식	Description
amountRefunded	AmountRefunded	환불된 금액입니다.
amountRequested	AmountRequested	요청된 환불 금액입니다.
approvedOn	string	환불이 승인된 날짜입니다.
completedOn	string	환불이 완료된 날짜입니다.
rebillInvoiceId	string	환불 청구서의 청구서 ID입니다.
refundOperationId	string	환불 작업의 ID입니다.
refundReason	RefundReasonCode	환불 이유입니다.
refundStatus	RefundStatus	환불 요청의 상태입니다.
requestedOn	string	환불이 요청된 날짜입니다.
transactionCount	integer	환불된 트랜잭션 수입니다.

RefundReasonCode

환불 이유입니다.

Name	형식	Description
AccidentalConversion	string
AccidentalPurchase	string
ForgotToCancel	string
Other	string
UnclearDocumentation	string
UnclearPricing	string

RefundStatus

환불 요청의 상태입니다.

Name	형식	Description
Approved	string
Cancelled	string
Completed	string
Declined	string
Expired	string
Other	string
Pending	string

SpecialTaxationType

청구서에 사용되는 세금 계산 유형을 식별합니다. 이 필드는 특별 세금 계산 논리가 있는 청구서에만 적용됩니다.

Name	형식	Description
InvoiceLevel	string
SubtotalLevel	string

SubTotal

세전 금액입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

TaxAmount

청구 기간에 대해 부과되는 세금 금액입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.

TotalAmount

청구서가 생성되었을 때의 기한입니다. 이 필드는 계약 유형이 Microsoft 고객 계약인 청구 계정에 적용됩니다.

Name	형식	Description
currency	string	금액 값의 통화입니다.
value	number	금액 값입니다. 예를 들어 통화가 USD이면 600의 값은 $600.00입니다.