Obtenga los artículos de la línea de consumo comercial sin facturar

Artículo
04/25/2024

Nota:

Después del 30 de septiembre de 2024, esta API ya no funcionará. Use la información para elegir la versión y planear con antelación.

Para acceder a los detalles de uso diario no facturados de los períodos de facturación actuales y anteriores, use esta API. Puede usarlo hasta el 30 de septiembre de 2024, a menos que cambie a disponibilidad general v2 antes de esa fecha.
Para obtener el uso de clasificación diaria no facturada para los períodos actuales y anteriores, cambie a la DISPONIBILIDAD general de LA API v2 para el 30 de septiembre de 2024.

Para ver los pasos de migración de API v2, vaya a:

API de conciliación de uso facturada y no facturada diaria v2 (GA)

Cómo obtener una colección de detalles de artículos de línea de consumo comercial no facturados.

Puede usar los métodos siguientes para obtener una colección de detalles de elementos de línea de consumo comercial no facturados (también conocidos como elementos de línea de uso abiertos) mediante programación.

Importante

Los datos de uso clasificados diariamente no incluyen los cargos por estos productos:

Reserva de Azure
Plan de ahorro de Azure
Office
Dynamics
Microsoft Power Apps
Software perpetuo
Suscripción de software
Producto SaaS de Marketplace

Nota:

Puede recuperar los datos de uso no facturados diarios a través de la API o el portal del Centro de partners. Los datos pueden tardar hasta 24 horas en estar disponibles. Sin embargo, puede haber más retrasos en función de su ubicación y cuando los medidores notifiquen el uso.

A veces, es posible que no vea los datos de uso no facturados más recientes hasta que se entreguen los datos de uso facturados del mes anterior. Esto se hace para asegurarse de que los datos de uso facturados se entregan dentro del tiempo acordado. Una vez que reciba los datos de uso facturados, debería poder recuperar todos los datos de uso no facturados actualizados desde el inicio del mes.

Requisitos previos

Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.

C#

Para obtener los elementos de línea de la factura especificada:

Llame al método ById para obtener una interfaz para las operaciones de factura de la factura especificada.
Llame al método Get o GetAsync para recuperar el objeto invoice.

El objeto invoice contiene toda la información de la factura especificada. El proveedor identifica el origen de la información detallada no facturada (por ejemplo, OneTime). InvoiceLineItemType especifica el tipo (por ejemplo, UsageLineItem).

En el código de ejemplo siguiente se usa un bucle foreach para procesar la colección InvoiceLineItems . Se recupera una colección independiente de elementos de línea para cada InvoiceLineItemType.

Para obtener una colección de elementos de línea que corresponden a una instancia de InvoiceDetail :

Pase billingProvider y InvoiceLineItemType de la instancia al método By.
Llame al método Get o GetAsync para recuperar los elementos de línea asociados.
Cree un enumerador para recorrer la colección como se muestra en el ejemplo siguiente.

// IAggregatePartner partnerOperations;
// string curencyCode;
// string period;
// int pageMaxSizeReconLineItems = 2000;

// all the operations executed on this partner operation instance will share the same correlation Id but will differ in request Id
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));

var seekBasedResourceCollection = scopedPartnerOperations.Invoices.ById("unbilled").By("onetime", "usagelineitems", curencyCode, period, pageMaxSizeReconLineItems).Get();

var fetchNext = true;

ConsoleKeyInfo keyInfo;

var itemNumber = 1;
while (fetchNext)
{
    Console.Out.WriteLine("\tLine items count: " + seekBasedResourceCollection.Items.Count());

    seekBasedResourceCollection.Items.ToList().ForEach(item =>
    {
        // Instance of type DailyRatedUsageLineItem
        if (item is DailyRatedUsageLineItem)
        {
            Type t = typeof(DailyRatedUsageLineItem);
            PropertyInfo[] properties = t.GetProperties();

            foreach (PropertyInfo property in properties)
            {
                // Insert code here to work with the line item properties
            }
        }
        itemNumber++;
    });

    Console.Out.WriteLine("\tPress any key to fetch next data. Press the Escape (Esc) key to quit: \n");
    keyInfo = Console.ReadKey();

    if (keyInfo.Key == ConsoleKey.Escape)
    {
        break;
    }

    fetchNext = !string.IsNullOrWhiteSpace(seekBasedResourceCollection.ContinuationToken);

    if (fetchNext)
    {
        if (seekBasedResourceCollection.Links.Next.Headers != null && seekBasedResourceCollection.Links.Next.Headers.Any())
        {
            seekBasedResourceCollection = scopedPartnerOperations.Invoices.ById("unbilled").By("onetime", "usagelineitems", curencyCode, period, pageMaxSizeReconLineItems).Seek(seekBasedResourceCollection.ContinuationToken, SeekOperation.Next);
        }
    }
}

Para obtener un ejemplo similar, consulte:

Ejemplo: Aplicación de prueba de consola
Proyecto: Ejemplos del SDK del Centro de partners
Clase: GetUnBilledConsumptionReconLineItemsPaging.cs

Solicitud REST

Sintaxis de la solicitud

Puede usar las sintaxis siguientes para la solicitud REST, en función del caso de uso. Para obtener más información, consulte las descripciones de cada sintaxis.

Método	URI de solicitud	Descripción del caso de uso de sintaxis
GET	{baseURL}/v1/invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode}&period={period} HTTP/1.1	Use esta sintaxis para devolver una lista completa de cada elemento de línea de la factura especificada.
GET	{baseURL}/v1/invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode}&period={period}&size={size} HTTP/1.1	Use esta sintaxis para facturas grandes. Use esta sintaxis con un tamaño especificado y un desplazamiento basado en 0 para devolver una lista paginada de elementos de línea.
GET	{baseURL}/v1/invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode}&period={period}&size={size}&seekOperation=Next	Use esta sintaxis para obtener la siguiente página de elementos de línea de conciliación mediante `seekOperation = "Next"`.

Parámetros de URI

Use los siguientes parámetros de consulta y URI al crear la solicitud.

Nombre	Type	Obligatorio	Descripción
proveedor	string	Sí	El proveedor: "OneTime".
invoice-line-item-type	string	Sí	Tipo de detalle de factura: "UsageLineItems", "UsageLineItems".
currencyCode	string	Sí	Código de moneda para los elementos de línea no facturados.
period	string	Sí	Período para la conciliación sin facturar (por ejemplo: actual, anterior). Supongamos que necesita consultar los datos de uso no facturados del ciclo de facturación (01/01/2020 – 31/01/2020) en enero, elija el período como "Actual", en caso contrario , "Anterior".
size	number	No	Número máximo de elementos que se van a devolver. El tamaño predeterminado es 2000.
seekOperation	string	No	Establézcalo `seekOperation=Next` para obtener la página siguiente de los elementos de línea de conciliación.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Ninguno.

Respuesta REST

Si se ejecuta correctamente, la respuesta contiene la colección de detalles del elemento de línea.

Para el elemento de línea ChargeType, el valor Compra se asigna a Nuevo y el valor Reembolso se asigna a Cancelar.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica éxito o error y otra información de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y más parámetros. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.

Ejemplos de solicitud-respuesta

Ejemplo de solicitud-respuesta 1

Los detalles siguientes se aplican a este ejemplo:

Proveedor: OneTime
InvoiceLineItemType: UsageLineItems
Período: Anterior

Ejemplo de solicitud 1

GET https://api.partnercenter.microsoft.com/v1//invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=usagelineitems&currencycode=usd&period=previous&size=2000 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 1234ecb8-37af-45f4-a1a1-358de3ca2b9e
MS-CorrelationId: 5e612512-4345-4bb0-866e-47aeda031234
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com