Delen via


Manage billing - Get a collection of invoices

Haalt de facturen voor de partner op.

GET https://api.partnercenter.microsoft.com/v1/invoices
GET https://api.partnercenter.microsoft.com/v1/invoices?size={size}&offset={offset}&invoiceType={invoiceType}&filter.operator={filter.operator}

URI-parameters

Name In Vereist Type Description
filter.operator
query

string

invoiceType
query

string

Het factuurtype.

offset
query

integer

int32

De pagina-offset.

size
query

integer

int32

Het paginaformaat.

Aanvraagkoptekst

Name Vereist Type Description
Authorization True

string

Bearer-token voor autorisatie

ms-correlationid

string

Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-correlationid is opgegeven, genereert de server een nieuwe voor elke aanvraag

ms-cv

string

Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-cv is opgegeven, genereert de server een nieuwe voor elke aanvraag

ms-requestid

string

Wordt gebruikt voor idempotentie van aanvragen. Als er geen ms-requestid is opgegeven, genereert de server een nieuwe voor elke aanvraag

Antwoorden

Name Type Description
200 OK

Collections.PagedResourceCollection[Invoice]

De aanvraag is voltooid. De hoofdtekst van het antwoord bevat de verzameling aangevraagde facturen.

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

400 Bad Request

Er is een ontbrekende of ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails.

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

401 Unauthorized

De aanvraag is niet geverifieerd. De client moet eerst worden geverifieerd met de partner-API-service.

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

403 Forbidden

De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt om deze aan te roepen.

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

404 Not Found

De resource is niet gevonden of niet beschikbaar met de opgegeven invoerparameters.

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

500 Internal Server Error

De partner-API-service of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag. Bellers kunnen dit opnieuw proberen.

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

Definities

Name Description
Collections.PagedResourceCollection[Invoice]
Invoice
InvoiceDetail
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]
TaxReceipt

Collections.PagedResourceCollection[Invoice]

Name Type Description
attributes

ResourceAttributes

continuationToken

string

items

Invoice[]

links

ResourceLinks

totalCount

integer

Invoice

Name Type Description
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

Name Type Description
attributes

ResourceAttributes

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

ResourceLinks

Name Type Description
headers

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

method

string

uri

string

ResourceAttributes

Name Type Description
etag

string

objectType

string

Name Type Description
next

Link

previous

Link

self

Link

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

Name Type Description
key

string

value

string

TaxReceipt

Name Type Description
createdDate

string

id

string

receiptType

string

taxReceiptPdfDownloadLink

string