Compartir vía

Recursos de factura

  • Artículo

Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

Los siguientes recursos relacionados con la factura están disponibles a través de las API del Centro de partners.

Factura

Propiedad Tipo Descripción
id string Identificador de factura.
invoiceDate cadena en formato de fecha y hora UTC Fecha en que se generó la factura.
billingPeriodStartDate cadena en formato de fecha y hora UTC Fecha de inicio del período de facturación en UTC.
billingPeriodEndDate cadena en formato de fecha y hora UTC Fecha de finalización del período de facturación en UTC.
totalCharges number El total de cargos. Incluye cargos por transacciones y cualquier ajuste.
paidAmount number Importe pagado por el socio. Negativo si se recibió un pago.
currencyCode string Código que indica la moneda utilizada para todos los importes y totales de los artículos de factura.
currencySymbol string Símbolo de moneda utilizado para todos los importes y totales de los artículos de factura.
pdfDownloadLink string Vínculo para descargar la factura en formato PDF. Este vínculo no se devuelve como parte de los resultados de la búsqueda y solo se rellena si el identificador accede a la factura. Este vínculo expira automáticamente en 30 minutos.
invoiceDetails matriz de objetos InvoiceDetail Detalles de la factura.
Enmiendas matriz de objetos Invoice Las modificaciones de esta factura.
documentType string Tipo de documento de la factura: "Nota de crédito", "Factura".
amendsOf string Número de referencia del documento del que se trata de una modificación.
invoiceType string Tipo de factura: "periódica", "one_time".
vínculos ResourceLinks Vínculos de recursos.
atributos ResourceAttributes Atributos de metadatos.
collectionOfSummary matriz de objetos TaxReceipt Obtiene o establece el vínculo de descarga de recibo fiscal.
Estado string Obtiene el estado de la factura, como "activo", "void", etc.

InvoiceDetail

Una factura contiene una colección de elementos facturados y cada elemento se representa mediante un recurso InvoiceDetail.

Propiedad Tipo Descripción
invoiceLineItemType string Tipo de detalle de factura: "none", "usage_line_items", "billing/_line_items".
billingProvider string El proveedor de facturación: "None", "Office", "Azure", "OneTime".
vínculos ResourceLinks Vínculos de recursos.
atributos ResourceAttributes Atributos de metadatos.

InvoiceLineItem

Cada cargo individual dentro de una factura se representa como invoiceLineItem.

Propiedad Tipo Descripción
invoiceLineItemType string Tipo de elemento de línea de factura: "none", "usage_line_items", "billing/_line_items".
billingProvider string El proveedor de facturación: "None", "Office", "Azure", "OneTime".
atributos ResourceAttributes Atributos de metadatos.

InvoiceSummary

Describe un resumen del saldo y los cargos totales de una factura.

Propiedad Tipo Descripción
balanceAmount number Saldo de la factura. Esta es la cantidad total de facturas no pagadas.
currencyCode string Código que indica la moneda utilizada para el importe del saldo.
currencySymbol string Símbolo de moneda usado.
accountingDate cadena en formato de fecha y hora UTC Fecha en que se actualizó por última vez el importe del saldo.
firstInvoiceCreationDate cadena en formato de fecha y hora UTC Fecha en que se creó la primera factura del cliente.
lastPaymentDate cadena en formato de fecha y hora UTC Fecha del último pago.
lastPaymentAmount number Importe del último pago.
latestInvoiceDate cadena en formato de fecha y hora UTC Fecha en que se creó la última factura del cliente.
detalles matriz de objetos InvoiceSummaryDetail Detalle del resumen de la factura.
vínculos ResourceLinks Vínculos de recursos.
atributos ResourceAttributes Atributos de metadatos.

InvoiceSummaryDetail

Representa un resumen de los detalles individuales de un tipo de factura (por ejemplo, periódico, one_time).

Propiedad Tipo Descripción
invoiceType string Tipo de factura: "periódica", "one_time".
summary InvoiceSummary ( objeto) Resumen de la factura por tipo de factura.

InvoiceSummaries

Representa una colección de tipo InvoiceSummary que contiene los detalles individuales de un tipo de factura por moneda.

Propiedad Tipo Descripción
collectionOfSummary matriz de objetos InvoiceSummary Resumen de la factura por tipo de factura por moneda.

LicenseBasedLineItem

Representa un elemento de línea de facturación para suscripciones basadas en licencias.

Propiedad Tipo Descripción
amount string Obtiene o establece la cantidad total. Importe total = precio unitario * cantidad.
atributos string Obtiene los atributos.
billingCycleType string Obtiene o establece el tipo de ciclo de facturación.
billingProvider string Obtiene el proveedor de facturación.
chargeEndDate cadena en formato de fecha y hora UTC Obtiene o establece la fecha de finalización del cargo.
chargeStartDate cadena en formato de fecha y hora UTC Obtiene o establece la fecha de inicio del cargo.
chargeType string Obtiene o establece el tipo de cargo.
currency string Obtiene o establece la moneda utilizada para este elemento de línea.
customerId string Obtiene o establece el identificador único del cliente en la plataforma de facturación de Microsoft.
customerName cadena en formato de fecha y hora UTC Obtiene o establece el nombre del cliente.
domainName string Obtiene o establece el nombre de dominio.
durableOfferId string Obtiene o establece el identificador único de la oferta duradera.
invoiceLineItemType string Obtiene el tipo de elemento de línea de factura.
PartnerId number Obtiene o establece el PartnerID asociado a este elemento de línea. Para revendedores directos, este es el PartnerID del revendedor. En el caso de los revendedores indirectos, este es el PartnerID del revendedor de valor agregado (VAR).
offerId string Obtiene o establece el identificador único de la oferta.
offerName string Obtiene o establece el nombre de la oferta.
orderId string Obtiene o establece el identificador único del orden.
PartnerId string Obtiene o establece el identificador de inquilino de Microsoft Entra asociado.
cantidad number Obtiene o establece el número de unidades asociadas a este elemento de línea.
subscriptionDescription string Obtiene o establece la descripción de la suscripción.
subscriptionEndDate cadena en formato de fecha y hora UTC Obtiene o establece la fecha en que expira la suscripción.
subscriptionId string Obtiene o establece el identificador único de la suscripción.
subscriptionName string Obtiene o establece el nombre de la suscripción.
subscriptionStartDate cadena en formato de fecha y hora UTC Obtiene o establece la fecha en que se inicia la suscripción.
subtotal number Obtiene o establece el importe después del descuento.
syndicationPartnerSubscriptionNumber string Obtiene o establece el número de suscripción del asociado de distribución.
impuesto number Obtiene o establece los impuestos cargados.
tier2MpnId number Obtiene o establece el PartnerID del asociado de nivel 2 asociado a este elemento de línea.
totalForCustomer number Obtiene o establece el importe total después del descuento y el impuesto.
totalOtherDiscount number Obtiene o establece el descuento asociado a esta compra.
unitPrice number Obtiene o establece el precio unitario.

UsageBasedLineItem

Representa un elemento de línea de facturación para suscripciones basadas en uso.

Propiedad Tipo Descripción
atributos string Obtiene los atributos.
billingCycleType string Obtiene o establece el tipo de ciclo de facturación.
billingProvider string Obtiene el proveedor de facturación.
chargeEndDate cadena en formato de fecha y hora UTC Obtiene o establece la fecha de finalización del cargo.
chargeStartDate cadena en formato de fecha y hora UTC Obtiene o establece la fecha de inicio del cargo.
chargeType string Obtiene o establece el tipo de cargo.
consumedQuantity number Obtiene o establece el total de unidades consumidas.
consumptionDiscount string Obtiene o establece el descuento en el consumo.
consumptionPrice string Obtiene o establece el precio de la cantidad consumida.
currency string Obtiene o establece la moneda asociada a los precios.
customerName string Obtiene o establece el nombre del cliente.
customerId string Obtiene o establece el identificador único del cliente.
detailLineItemId number Obtiene o establece el identificador de elemento de línea de detalles. Identifica de forma única los elementos de línea para los casos en los que el cálculo es diferente para las unidades consumidas. Ejemplo: El total consumido = 1338, 1024 se cobra con una tarifa, 314 se cobra con una tarifa diferente.
domainName string Obtiene o establece el nombre de dominio.
includedQuantity number Obtiene o establece las unidades incluidas en el orden.
invoiceLineItemType string Obtiene el tipo de elemento de línea de factura.
invoiceNumber string Obtiene o establece el número de factura.
listPrice number Obtiene o establece el precio de cada unidad.
PartnerId number Obtiene o establece el PartnerID asociado a este elemento de línea. Para revendedores directos, este es el PartnerID del revendedor. En el caso de los revendedores indirectos, este es el PartnerID del revendedor de valor agregado (VAR).
orderId string Obtiene o establece el identificador único del orden.
overageQuantity number Obtiene o establece la cantidad consumida por encima del uso permitido.
partnerBillableAccountId string Obtiene o establece el identificador de cuenta facturable del asociado.
PartnerId string Obtiene o establece el identificador de inquilino de Microsoft Entra asociado.
partnerName string Obtiene o establece el nombre del asociado.
postTaxEffectiveRate number Obtiene o establece el precio efectivo después de los impuestos.
postTaxTotal number Obtiene o establece los cargos totales después del impuesto. Cargos por adelantado + Importe fiscal
preTaxCharges number Obtiene o establece el precio cargado antes de los impuestos.
preTaxEffectiveRate number Obtiene o establece el precio efectivo antes de los impuestos.
region string Obtiene o establece la región asociada a la instancia de recurso.
resourceGuid string Obtiene o establece el identificador de recursos.
resourceName string Obtiene o establece el nombre del recurso. Ejemplo: Base de datos (GB/mes).
serviceName string Obtiene o establece el nombre del servicio. Ejemplo: Azure Data Service.
serviceType string Obtiene o establece el tipo de servicio. Ejemplo: Azure SQL Azure DB.
sku string Obtiene o establece la SKU del servicio.
subscriptionDescription string Obtiene o establece la descripción de la suscripción.
subscriptionId string Obtiene o establece el identificador único de la suscripción.
subscriptionName string Obtiene o establece el nombre de la suscripción.
taxAmount number Obtiene o establece la cantidad de impuestos cargados.
tier2MpnId number Obtiene o establece el PartnerID del asociado de nivel 2 asociado a este elemento de línea.
unidad string Obtiene o establece la unidad de medida para el uso de Azure.

InvoiceStatement

Representa las operaciones disponibles en una instrucción de factura en application/pdf.

Propiedad Tipo Descripción
httpResponseMessage objeto ByteArrayContent con contentType = application/pdf.

OneTimeInvoiceLineItem

Representa un elemento de línea de facturación para suscripciones basadas en licencias.

Propiedad Tipo Descripción
PartnerId string Obtiene o establece el identificador de inquilino del asociado.
CustomerId string Obtiene o establece el identificador de inquilino del cliente.
CustomerName string Obtiene o establece el nombre del cliente.
CustomerDomainName string Obtiene o establece el nombre de dominio del cliente.
CustomerCountry string Obtiene o establece el país o región del cliente.
InvoiceNumber string Obtiene o establece el número de factura.
MpnId string Obtiene o establece el PartnerID asociado a este elemento de línea.
ResellerMpnId int Obtiene o establece el PartnerID del asociado de nivel 2 asociado a este elemento de línea.
OrderDate DateTime Obtiene o establece la fecha en que se creó el orden.
OrderId string Identificador único para un pedido en la plataforma de facturación de Microsoft.
ProductId string Obtiene o establece el identificador único del producto.
SkuId string Obtiene o establece el identificador único de SKU.
AvailabilityId string Obtiene o establece el identificador único de disponibilidad.
ProductName string Obtiene o establece el nombre del producto.
SkuName string Obtiene o establece el nombre de la SKU.
ChargeType string Obtiene o establece el tipo de cargo.
UnitPrice decimal Obtiene o establece el precio unitario.
EffectiveUnitPrice decimal Obtiene o establece el precio unitario efectivo.
UnitType string Obtiene o establece el tipo de unidad.
Cantidad int Obtiene o establece el número de unidades asociadas a este elemento de línea.
Subtotal decimal Obtiene o establece el importe después del descuento.
TaxTotal decimal Obtiene o establece los impuestos cargados.
TotalForCustomer decimal Obtiene o establece el importe total después del descuento y el impuesto.
Divisa string Obtiene o establece la moneda utilizada para este elemento de línea.
PublisherName string Obtiene o establece el nombre del publicador asociado a esta compra.
PublisherId string Obtiene o establece el identificador del publicador asociado a esta compra.
SubscriptionDescription string Obtiene o establece la descripción de la suscripción asociada a esta compra.
SubscriptionId string Obtiene o establece el identificador de suscripción asociado a esta compra.
ChargeStartDate DateTime Obtiene o establece la fecha de inicio del cargo asociada a esta compra.
ChargeEndDate DateTime Obtiene o establece la fecha de finalización del cargo asociada a esta compra.
TermAndBillingCycle string Obtiene o establece el término y el ciclo de facturación asociados a esta compra.
AlternateId string Obtiene o establece el identificador alternativo (id. de comilla).
PriceAdjustmentDescription string Obtiene o establece la descripción del ajuste de precios.
CreditReasonCode string Obtiene o establece el código de motivo de crédito.
DiscountDetails string Obsoleto. Obtiene o establece los detalles de descuento asociados a esta compra.
PricingCurrency string Obtiene o establece el código de moneda de precios.
PCToBCExchangeRate decimal Obtiene o establece la moneda de precios en el tipo de cambio de moneda de facturación.
PCToBCExchangeRateDate DateTime Obtiene o establece la fecha de tipo de cambio en la que se determinó la moneda de precios a la tasa de cambio de moneda de facturación.
BillableQuantity decimal Obtiene o establece las unidades compradas. Para cada columna de diseño denominada BillableQuantity.
MeterDescription string Obtiene o establece la descripción del medidor para el elemento de línea de consumo.
ReservationOrderId string Obtiene o establece el identificador de pedido de reserva para una compra de AZURE RI.
BillingFrequency string Obtiene o establece la frecuencia de facturación.
InvoiceLineItemType InvoiceLineItemType Devuelve el tipo de elemento de línea de factura.
BillingProvider BillingProvider Devuelve el proveedor de facturación.
ProductQualifiers string Identificador para conocer las compras de complementos o de prueba.
PromotionId string Identificador para recuperar información de promoción.

DailyRatedUsageLineItem

Representa elementos de línea de conciliación facturados no facturados para el uso clasificado diario.

Propiedad Tipo Descripción
PartnerId string Obtiene o establece el identificador de inquilino del asociado.
PartnerName string Obtiene o establece el nombre del asociado.
CustomerId string Obtiene o establece el identificador de inquilino del cliente al que pertenece el uso.
CustomerName string Obtiene o establece el nombre de la empresa cliente a la que pertenece el uso.
CustomerDomainName string Obtiene o establece el nombre de dominio del cliente al que pertenece el uso.
InvoiceNumber string Obtiene o establece el identificador de la factura a la que pertenece el uso.
ProductId string Obtiene o establece el identificador único del producto.
SkuId string Obtiene o establece el identificador único de SKU.
AvailabilityId string Obtiene o establece el identificador único de disponibilidad.
SkuName string Obtiene o establece el nombre de la SKU para el servicio.
ProductName string Obtiene o establece el nombre del producto.
PublisherName string Obtiene o establece el nombre del publicador.
PublisherId string Obtiene o establece el identificador del publicador.
SubscriptionId string Obtiene o establece el identificador de la suscripción.
SubscriptionDescription string Obtiene o establece la descripción de la suscripción.
ChargeStartDate DateTime Obtiene o establece la fecha de inicio del cargo.
ChargeEndDate DateTime Obtiene o establece la fecha de finalización del cargo.
UsageDate DateTime Obtiene o establece la fecha de uso.
MeterType string Obtiene o establece el tipo de medidor.
MeterCategory string Obtiene o establece la categoría de medidor.
MeterId string Obtiene o establece el identificador de medidor (GUID).
MeterSubCategory string Obtiene o establece la sub categoría de medidor.
MeterName string Obtiene o establece el nombre del medidor.
MeterRegion string Obtiene o establece la región del medidor.
UnitOfMeasure string Obtiene o establece la unidad de medida.
ResourceLocation string Obtiene o establece la ubicación del recurso.
ConsumedService string Obtiene o establece el nombre del servicio consumido.
ResourceGroup string Obtiene o establece el nombre del grupo de recursos.
ResourceUri string Obtiene o establece el URI de la instancia de recurso a la que se refiere el uso.
Etiquetas string Obtiene o establece las etiquetas agregadas por el cliente.
AdditionalInfo string Obtiene o establece los metadatos específicos del servicio. Por ejemplo, un tipo de imagen de una máquina virtual.
ServiceInfo1 string Obtiene o establece metadatos internos de Azure Service.
ServiceInfo2 string Obtiene o establece información de servicio, por ejemplo, un tipo de imagen para una máquina virtual y un nombre ISP para ExpressRoute.
CustomerCountry string Obtiene o establece el país o región del cliente.
MpnId string Obtiene o establece el PartnerID asociado a este elemento de línea.
ResellerMpnId string Obtiene o establece el PartnerID de revendedor del asociado de nivel 2 asociado a este elemento de línea.
ChargeType string Obtiene o establece el tipo de cargo.
UnitPrice decimal Obtiene o establece el precio de la unidad.
Quantity decimal Obtiene o establece la cantidad de uso.
UnitType string Obtiene o establece el tipo de unidad (por ejemplo, 1 hora).
BillingPreTaxTotal decimal Obtiene o establece el costo extendido o el costo total antes de impuestos en moneda local del cliente o la moneda de facturación.
BillingCurrency string Obtiene o establece la moneda ISO en la que el medidor se cobra en la moneda local del cliente o la moneda de facturación.
PricingPreTaxTotal decimal Obtiene o establece el costo extendido o el costo total antes de impuestos en USD o moneda de catálogo usada para la clasificación.
PricingCurrency string Obtiene o establece la moneda ISO en la que se cobra el medidor en USD o en la moneda del catálogo utilizada para la clasificación.
EntitlementId string Obtiene o establece el identificador de derechos (suscripción de Azure).
EntitlementDescription string Obtiene o establece la descripción de derechos (suscripción de Azure).
PCToBCExchangeRate string Obtiene o establece la moneda de precios en el tipo de cambio de moneda de facturación.
PCToBCExchangeRateDate DateTime Obtiene o establece la moneda de precios en la fecha de cambio de moneda de facturación.
EffectiveUnitPrice decimal Obtiene o establece el precio unitario efectivo.
RateOfPartnerEarnedCredit decimal Obtiene o establece la tasa de crédito obtenido por el asociado.
HasPartnerEarnedCredit bool Obtiene o establece que se aplica el crédito obtenido por el asociado.
RateOfCredit decimal Obtiene o establece la tasa de crédito para el tipo de crédito especificado.
CreditType string Obtiene o establece el tipo de crédito.
InvoiceLineItemType InvoiceLineItemType Devuelve el tipo de elemento de línea de factura.
BillingProvider BillingProvider Devuelve el proveedor de facturación.