Поделиться через


Manage billing - Get invoice by ID

Возвращает счет по идентификатору партнера.

GET https://api.partnercenter.microsoft.com/v1/invoices/{invoice_id}

Параметры URI

Имя В Обязательно Тип Описание
invoice_id
path True

string

Идентификатор счета.

Заголовок запроса

Имя Обязательно Тип Описание
Authorization True

string

Маркер носителя авторизации

ms-correlationid

string

Используется для отслеживания запросов внутри системы. Если ms-correlationid не указан, сервер создаст новый для каждого запроса.

ms-cv

string

Используется для отслеживания запросов внутри системы. Если ms-cv не предоставлено, сервер создаст новый для каждого запроса.

ms-requestid

string

Используется для идемпотентности запросов. Если ms-requestid не указан, сервер создаст новый для каждого запроса.

Ответы

Имя Тип Описание
200 OK

Invoice

Запрос выполнен успешно. Текст ответа содержит запрошенный счет.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

400 Bad Request

Отсутствуют или недопустимые входные данные. Текст ответа предоставит сведения об ошибке.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

401 Unauthorized

Запрос не прошел проверку подлинности. Сначала клиент должен пройти проверку подлинности с помощью службы API партнеров.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

403 Forbidden

Запрос прошел проверку подлинности, но был отклонен, так как вызывающий объект не имеет прав на его вызов.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

404 Not Found

Ресурс не найден или недоступен с заданными входными параметрами.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

500 Internal Server Error

Служба API партнера или одна из зависимостей не выполнила запрос. Вызывающие могут повторить это.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Определения

Имя Описание
Invoice
InvoiceDetail
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]
TaxReceipt

Invoice

Имя Тип Описание
amendments

Invoice[]

amendsOf

string

attributes

ResourceAttributes

billingPeriodEndDate

string

billingPeriodStartDate

string

currencyCode

string

currencySymbol

string

documentType enum:
  • adjustmentNote
  • invoice
  • none
  • reconciliation
  • voidNote
id

string

invoiceDate

string

invoiceDetails

InvoiceDetail[]

invoiceType

string

links

ResourceLinks

paidAmount

number

pdfDownloadLink

string

programName

string

state

string

taxReceipts

TaxReceipt[]

totalCharges

number

InvoiceDetail

Имя Тип Описание
attributes

ResourceAttributes

billingProvider enum:
  • all
  • azure
  • marketplace
  • none
  • office
  • oneTime
invoiceLineItemType enum:
  • billingLineItems
  • none
  • usageLineItems
links

ResourceLinks

Имя Тип Описание
headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

Имя Тип Описание
etag

string

objectType

string

Имя Тип Описание
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

Имя Тип Описание
key

string

value

string

TaxReceipt

Имя Тип Описание
createdDate

string

id

string

receiptType

string

taxReceiptPdfDownloadLink

string