Compartir a través de

Manage billing - Get invoice line items

  • Referencia
Servicio:
Partner Center Rest
Versión de la API:
v1

Obtiene elementos de línea para escenarios GTM. Uso no facturado diario de primera y tercera parte para los meses actuales y anteriores. Primer y tercero facturan el uso diario valorado por un invoceid. Reconocimiento de primera y terceros sin facturar para los meses actuales y anteriores.

GET https://api.partnercenter.microsoft.com/v1/invoices/{invoice_id}/lineitems
Con parámetros opcionales: 
GET https://api.partnercenter.microsoft.com/v1/invoices/{invoice_id}/lineitems?provider={provider}&invoiceLineItemType={invoiceLineItemType}&hasPartnerEarnedCredit={hasPartnerEarnedCredit}&currencyCode={currencyCode}&period={period}&size={size}&offset={offset}&seekOperation={seekOperation}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
invoice_id
 path True

string

Identificador de factura. Para los elementos de línea no facturados invoiceId se establece en "no facturado".
currencyCode
 query

string

El código de moneda.
hasPartnerEarnedCredit
 query

boolean

Valor que indica si se devuelven los elementos de línea con el crédito obtenido por el asociado aplicado.
invoiceLineItemType
 query

string

Elemento de línea de factura. ejemplo: BillingLineItems, UsageLineItems.
offset
 query

integer

int32

Desplazamiento de página.
period
 query

string

Período de conciliación sin facturar. ejemplo: actual, anterior.
provider
 query

string

Tipo de proveedor. ejemplo: All, Marketplace.
seekOperation
 query

string

Operación de búsqueda que se va a realizar. Solo se admite Next.
size
 query

integer

int32

Tamaño de página.

Encabezado de la solicitud

Nombre Requerido Tipo Description
Authorization True

string

Token de portador de autorización
ms-correlationid

string

Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-correlationid, el servidor generará uno nuevo para cada solicitud.
ms-cv

string

Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-cv, el servidor generará uno nuevo para cada solicitud.
ms-requestid

string

Se usa para la idempoencia de las solicitudes. Si no se proporciona un ms-requestid, el servidor generará uno nuevo para cada solicitud.

Respuestas

Nombre Tipo Description
200 OK

Collections.PagedResourceCollection[InvoiceLineItem]

La solicitud se realizó correctamente. El cuerpo de la respuesta contiene los elementos de línea de conciliación solicitados.

Media Types: "application/json", "text/json"
400 Bad Request

Faltaba o faltaba una entrada no válida. El cuerpo de la respuesta proporcionará los detalles del error.

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

La solicitud no se autenticó. El cliente debe autenticarse primero con el servicio de API del asociado.

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

La solicitud se autenticó pero se rechazó, ya que el autor de la llamada no tiene los derechos para invocarla.

Media Types: "application/json", "text/json"
404 Not Found

El recurso no se encuentra o no está disponible con los parámetros de entrada especificados.

Media Types: "application/json", "text/json"
500 Internal Server Error

El servicio de API del asociado o una de sus dependencias no pudieron cumplir la solicitud. Los autores de llamadas pueden volver a intentarlo.

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

Definiciones

Nombre Description
Collections.PagedResourceCollection[InvoiceLineItem]
InvoiceLineItem
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]

Collections.PagedResourceCollection[InvoiceLineItem]

Nombre Tipo Description
attributes

ResourceAttributes

continuationToken

string

items

InvoiceLineItem[]

links

ResourceLinks

totalCount

integer

InvoiceLineItem

Nombre Tipo Description
attributes

ResourceAttributes

billingProvider enum:
  • all
  • azure
  • marketplace
  • none
  • office
  • oneTime
invoiceLineItemType enum:
  • billingLineItems
  • none
  • usageLineItems
Nombre Tipo Description
headers

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

method

string

uri

string

ResourceAttributes

Nombre Tipo Description
etag

string

objectType

string

Nombre Tipo Description
next

Link

previous

Link

self

Link

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

Nombre Tipo Description
key

string

value

string