Ressources de facture

  • Article

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Les ressources associées à la facture suivantes sont disponibles via les API de l’Espace partenaires.

Facture

Propriété Type Description
id string Identificateur de la facture.
invoiceDate chaîne au format date/heure UTC Date de génération de la facture.
billingPeriodStartDate chaîne au format date/heure UTC Date de début de la période de facturation au format UTC.
billingPeriodEndDate chaîne au format date/heure UTC Date de fin de la période de facturation au format UTC.
totalCharges number Frais totaux. Inclut les frais pour les transactions et les ajustements.
paidAmount number Montant payé par le partenaire. Négatif si un paiement a été reçu.
currencyCode string Code qui indique la devise utilisée pour tous les montants et totaux des éléments de facture.
currencySymbol string Symbole monétaire utilisé pour tous les montants et totaux des éléments de facture.
pdfDownloadLink string Lien pour télécharger la facture au format PDF. Ce lien n’est pas retourné dans le cadre des résultats de la recherche et n’est renseigné que si la facture est accessible par ID. Ce lien expire automatiquement en 30 minutes.
invoiceDetails tableau d’objets InvoiceDetail Détails de la facture.
Amendements tableau d’objets Invoice Modifications apportées à cette facture.
documentType string Type de document de la facture : « Note de crédit », « Facture ».
amendsOf string Numéro de référence du document dont ce document est un amendement.
invoiceType string Type de facture : « périodique », « one_time ».
liens ResourceLinks Liens de ressources.
attributs ResourceAttributes Attributs de métadonnées.
collectionOfSummary tableau d’objets TaxReceipt Obtient ou définit le lien de téléchargement du reçu fiscal.
État string Obtient l’état de la facture, par exemple « actif », « void », etc.

InvoiceDetail

Une facture contient une collection d’éléments facturés, et chaque élément est représenté par une ressource InvoiceDetail.

Propriété Type Description
invoiceLineItemType string Type de détail de facture : « none », « usage_line_items », « billing_line_items ».
billingProvider string Fournisseur de facturation : « None », « Bureau », « Azure », « OneTime ».
liens ResourceLinks Liens de ressources.
attributs ResourceAttributes Attributs de métadonnées.

InvoiceLineItem

Chaque frais individuels au sein d’une facture est représenté sous la forme d’un InvoiceLineItem.

Propriété Type Description
invoiceLineItemType string Type d’élément de ligne de facture : « none », « usage_line_items », « billing_line_items ».
billingProvider string Fournisseur de facturation : « None », « Bureau », « Azure », « OneTime ».
attributs ResourceAttributes Attributs de métadonnées.

InvoiceSummary

Décrit un résumé du solde et des frais totaux d’une facture.

Propriété Type Description
balanceAmount number Solde de la facture. Il s’agit du montant total des factures non payées.
currencyCode string Code qui indique la devise utilisée pour le montant du solde.
currencySymbol string Symbole monétaire utilisé.
accountingDate chaîne au format date/heure UTC Date de la dernière mise à jour du montant du solde.
firstInvoiceCreationDate chaîne au format date/heure UTC Date de création de la première facture du client.
lastPaymentDate chaîne au format date/heure UTC Date du dernier paiement.
lastPaymentAmount number Montant du dernier paiement.
latestInvoiceDate chaîne au format date/heure UTC Date de création de la dernière facture du client.
details tableau d’objets InvoiceSummaryDetail Détail du résumé de la facture.
liens ResourceLinks Liens de ressources.
attributs ResourceAttributes Attributs de métadonnées.

InvoiceSummaryDetail

Représente un résumé des détails individuels d’un type de facture (par exemple, périodique, one_time).

Propriété Type Description
invoiceType string Type de facture : « périodique », « one_time ».
résumé Objet InvoiceSummary Résumé de la facture par type de facture.

InvoiceSummaries

Représente une collection de types InvoiceSummary qui contiennent les détails individuels d’un type de facture par devise.

Propriété Type Description
collectionOfSummary tableau d’objets InvoiceSummary Résumé de la facture par type de facture par devise.

LicenseBasedLineItem

Représente un élément de ligne de facturation de facture pour les abonnements sous licence.

Propriété Type Description
montant string Obtient ou définit le montant total. Montant total = prix unitaire * quantité.
attributs string Obtient les attributs.
billingCycleType string Obtient ou définit le type de cycle de facturation.
billingProvider string Obtient le fournisseur de facturation.
chargeEndDate chaîne au format date/heure UTC Obtient ou définit la date de fin pour les frais.
chargeStartDate chaîne au format date/heure UTC Obtient ou définit la date de début de la charge.
chargeType string Obtient ou définit le type de frais.
currency chaîne Obtient ou définit la devise utilisée pour cet élément de ligne.
customerId string Obtient ou définit l’identificateur unique du client dans la plateforme de facturation Microsoft.
customerName chaîne au format date/heure UTC Obtient ou définit le nom du client.
domainName string Obtient ou définit le nom de domaine.
durableOfferId string Obtient ou définit l’identificateur unique de l’offre durable.
invoiceLineItemType string Obtient le type d’élément de ligne de facture.
partnerId number Obtient ou définit l’ID de partenaire associé à cet élément de ligne. Pour les revendeurs directs, il s’agit de l’ID partenaire du revendeur. Pour les revendeurs indirects, il s’agit de l’ID partenaire du revendeur à valeur ajoutée (VAR).
offerId string Obtient ou définit l’identificateur unique de l’offre.
offerName string Obtient ou définit le nom de l’offre.
orderId string Obtient ou définit l’identificateur unique de l’ordre.
partnerId string Obtient ou définit l’ID de locataire Microsoft Entra partenaire.
quantité number Obtient ou définit le nombre d’unités associées à cet élément de ligne.
subscriptionDescription string Obtient ou définit la description de l’abonnement.
subscriptionEndDate chaîne au format date/heure UTC Obtient ou définit la date à laquelle l’abonnement expire.
subscriptionId string Obtient ou définit l’identificateur unique d’abonnement.
subscriptionName string Obtient ou définit le nom de l’abonnement.
subscriptionStartDate chaîne au format date/heure UTC Obtient ou définit la date à laquelle l’abonnement démarre.
subtotal number Obtient ou définit le montant après remise.
syndicationPartnerSubscriptionNumber string Obtient ou définit le numéro d’abonnement du partenaire de syndication.
taxe number Obtient ou définit les taxes facturées.
tier2MpnId number Obtient ou définit l’ID partenaire du partenaire de niveau 2 associé à cet élément de ligne.
totalForCustomer number Obtient ou définit le montant total après remise et taxe.
totalOtherDiscount number Obtient ou définit la remise associée à cet achat.
unitPrice number Obtient ou définit le prix unitaire.

UsageBasedLineItem

Représente un élément de ligne de facturation de facture pour les abonnements basés sur l’utilisation.

Propriété Type Description
attributs string Obtient les attributs.
billingCycleType string Obtient ou définit le type de cycle de facturation.
billingProvider string Obtient le fournisseur de facturation.
chargeEndDate chaîne au format date/heure UTC Obtient ou définit la date de fin pour les frais.
chargeStartDate chaîne au format date/heure UTC Obtient ou définit la date de début de la charge.
chargeType string Obtient ou définit le type de frais.
consumedQuantity number Obtient ou définit le nombre total d’unités consommées.
consumptionDiscount string Obtient ou définit la remise sur la consommation.
consommationPrice string Obtient ou définit le prix de la quantité consommée.
currency chaîne Obtient ou définit la devise associée aux prix.
customerName string Obtient ou définit le nom du client.
customerId string Obtient ou définit l’identificateur unique du client.
detailLineItemId number Obtient ou définit l’ID de l’élément de ligne de détail. Identifie de manière unique les éléments de ligne pour les cas où le calcul est différent pour les unités consommées. Exemple : Le total consommé = 1338, 1024 est facturé avec un tarif unique, 314 est facturé avec un taux différent.
domainName string Obtient ou définit le nom de domaine.
includedQuantity number Obtient ou définit les unités incluses dans l’ordre.
invoiceLineItemType string Obtient le type d’élément de ligne de facture.
invoiceNumber string Obtient ou définit le numéro de facture.
Listprice number Obtient ou définit le prix de chaque unité.
partnerId number Obtient ou définit l’ID de partenaire associé à cet élément de ligne. Pour les revendeurs directs, il s’agit de l’ID partenaire du revendeur. Pour les revendeurs indirects, il s’agit de l’ID partenaire du revendeur à valeur ajoutée (VAR).
orderId string Obtient ou définit l’identificateur unique de l’ordre.
overageQuantity number Obtient ou définit la quantité consommée au-dessus de l’utilisation autorisée.
partnerBillableAccountId string Obtient ou définit l’ID de compte facturable du partenaire.
partnerId string Obtient ou définit l’ID de locataire Microsoft Entra partenaire.
partnerName string Obtient ou définit le nom du partenaire.
postTaxEffectiveRate number Obtient ou définit le prix effectif après les taxes.
postTaxTotal number Obtient ou définit le total des frais après impôt. Frais de prétaxe + Montant fiscal
preTaxCharges number Obtient ou définit le prix facturé avant les taxes.
preTaxEffectiveRate number Obtient ou définit le prix effectif avant taxes.
region string Obtient ou définit la région associée à l’instance de ressource.
resourceGuid string Obtient ou définit l’identificateur de ressource.
resourceName string Obtient ou définit le nom de la ressource. Exemple : Base de données (Go/mois).
serviceName string Obtient ou définit le nom du service. Exemple : Azure Data Service.
serviceType string Obtient ou définit le type de service. Exemple : Azure SQL Azure DB.
sku string Obtient ou définit la référence SKU du service.
subscriptionDescription string Obtient ou définit la description de l’abonnement.
subscriptionId string Obtient ou définit l’identificateur unique d’abonnement.
subscriptionName string Obtient ou définit le nom de l’abonnement.
taxAmount number Obtient ou définit le montant de la taxe facturée.
tier2MpnId number Obtient ou définit l’ID partenaire du partenaire de niveau 2 associé à cet élément de ligne.
unitéé string Obtient ou définit l’unité de mesure pour l’utilisation d’Azure.

InvoiceStatement

Représente les opérations disponibles sur une instruction de facture dans application/pdf.

Propriété Type Description
httpResponseMessage object ByteArrayContent avec contentType = application/pdf.

OneTimeInvoiceLineItem

Représente un élément de ligne de facturation de facture pour les abonnements sous licence.

Propriété Type Description
PartnerId string Obtient ou définit l’ID de locataire du partenaire.
CustomerId string Obtient ou définit l’ID de locataire du client.
CustomerName string Obtient ou définit le nom du client.
CustomerDomainName string Obtient ou définit le nom de domaine du client.
CustomerCountry string Obtient ou définit le pays/la région du client.
InvoiceNumber string Obtient ou définit le numéro de facture.
MpnId string Obtient ou définit l’ID de partenaire associé à cet élément de ligne.
ResellerMpnId int Obtient ou définit l’ID partenaire du partenaire de niveau 2 associé à cet élément de ligne.
OrderDate Date/Heure Obtient ou définit la date de création de l’ordre.
OrderId string Identificateur unique d’une commande dans la plateforme de facturation Microsoft.
ProductId string Obtient ou définit l’identificateur unique du produit.
SkuId string Obtient ou définit l’identificateur unique de la référence SKU.
AvailabilityId string Obtient ou définit l’identificateur unique de disponibilité.
ProductName string Obtient ou définit le nom du produit.
SkuName string Obtient ou définit le nom de la référence SKU.
ChargeType string Obtient ou définit le type de frais.
UnitPrice decimal Obtient ou définit le prix unitaire.
EffectiveUnitPrice decimal Obtient ou définit le prix unitaire effectif.
UnitType string Obtient ou définit le type d’unité.
Quantité int Obtient ou définit le nombre d’unités associées à cet élément de ligne.
Sous-total decimal Obtient ou définit le montant après remise.
TaxTotal decimal Obtient ou définit les taxes facturées.
TotalForCustomer decimal Obtient ou définit le montant total après remise et taxe.
Devise chaîne Obtient ou définit la devise utilisée pour cet élément de ligne.
PublisherName string Obtient ou définit le nom de l’éditeur associé à cet achat.
PublisherId string Obtient ou définit l’ID de l’éditeur associé à cet achat.
SubscriptionDescription string Obtient ou définit la description de l’abonnement associée à cet achat.
SubscriptionId string Obtient ou définit l’ID d’abonnement associé à cet achat.
ChargeStartDate Date/Heure Obtient ou définit la date de début des frais associée à cet achat.
ChargeEndDate Date/Heure Obtient ou définit la date de fin des frais associée à cet achat.
TermAndBillingCycle string Obtient ou définit le terme et cycle de facturation associés à cet achat.
AlternateId string Obtient ou définit l’ID de remplacement (ID de guillemet).
PriceAdjustmentDescription string Obtient ou définit la description de l’ajustement des prix.
CreditReasonCode string Obtient ou définit le code du motif de crédit.
DiscountDetails string Déconseillé. Obtient ou définit les détails de remise associés à cet achat.
PricingCurrency string Obtient ou définit le code monétaire de tarification.
PCToBCExchangeRate decimal Obtient ou définit la devise de tarification sur le taux de change de devise de facturation.
PCToBCExchangeRateDate Date/Heure Obtient ou définit la date du taux de change à laquelle la devise de tarification du taux de change de devise de facturation a été déterminée.
BillableQuantity decimal Obtient ou définit les unités achetées. Pour chaque colonne de conception nommée BillableQuantity.
MeterDescription string Obtient ou définit la description du compteur pour l’élément de ligne de consommation.
ReservationOrderId string Obtient ou définit l’identificateur de commande de réservation pour un achat Azure RI.
BillingFrequency string Obtient ou définit la fréquence de facturation.
InvoiceLineItemType InvoiceLineItemType Retourne le type d’élément de ligne de facture.
BillingProvider BillingProvider Retourne le fournisseur de facturation.
ProductQualifiers string Identificateur pour connaître les achats d’extension ou d’essai.
PromotionId string Identificateur de récupération des informations de promotion.

DailyRatedUsageLineItem

Représente les éléments de ligne de rapprochement facturés non facturés pour l’utilisation quotidienne.

Propriété Type Description
PartnerId string Obtient ou définit l’ID de locataire du partenaire.
PartnerName string Obtient ou définit le nom du partenaire.
CustomerId string Obtient ou définit l’ID de locataire du client auquel appartient l’utilisation.
CustomerName string Obtient ou définit le nom de l’entreprise cliente à laquelle appartient l’utilisation.
CustomerDomainName string Obtient ou définit le nom de domaine du client auquel appartient l’utilisation.
InvoiceNumber string Obtient ou définit l’ID de la facture à laquelle appartient l’utilisation.
ProductId string Obtient ou définit l’identificateur unique du produit.
SkuId string Obtient ou définit l’identificateur unique de la référence SKU.
AvailabilityId string Obtient ou définit l’identificateur unique de disponibilité.
SkuName string Obtient ou définit le nom de la référence SKU pour le service.
ProductName string Obtient ou définit le nom du produit.
PublisherName string Obtient ou définit le nom de l’éditeur.
PublisherId string Obtient ou définit l’ID du serveur de publication.
SubscriptionId string Obtient ou définit l'ID d'abonnement.
SubscriptionDescription string Obtient ou définit la description de l’abonnement.
ChargeStartDate Date/Heure Obtient ou définit la date de début des frais.
ChargeEndDate Date/Heure Obtient ou définit la date de fin des frais.
UsageDate Date/Heure Obtient ou définit la date d’utilisation.
MeterType string Obtient ou définit le type de compteur.
MeterCategory string Obtient ou définit la catégorie de compteur.
ID du compteur string Obtient ou définit l’ID du compteur (GUID).
MeterSubCategory string Obtient ou définit la sous-catégorie du compteur.
MeterName string Obtient ou définit le nom du compteur.
MeterRegion string Obtient ou définit la région du compteur.
UnitOfMeasure string Obtient ou définit l’unité de mesure.
ResourceLocation string Obtient ou définit l’emplacement de la ressource.
ConsumedService string Obtient ou définit le nom du service consommé.
ResourceGroup string Obtient ou définit le nom du groupe de ressources.
ResourceUri string Obtient ou définit l’URI de l’instance de ressource sur laquelle l’utilisation est à propos.
Balises string Obtient ou définit les balises ajoutées par le client.
AdditionalInfo string Obtient ou définit les métadonnées spécifiques au service. Par exemple, le type d’image d’une machine virtuelle.
ServiceInfo1 string Obtient ou définit les métadonnées internes du service Azure.
ServiceInfo2 string Obtient ou définit des informations de service, par exemple, un type d’image pour une machine virtuelle et un nom ISP pour ExpressRoute.
CustomerCountry string Obtient ou définit le pays/la région du client.
MpnId string Obtient ou définit l’ID de partenaire associé à cet élément de ligne.
ResellerMpnId string Obtient ou définit le Reseller PartnerID du partenaire de niveau 2 associé à cet élément de ligne.
ChargeType string Obtient ou définit le type de frais.
UnitPrice decimal Obtient ou définit le prix de l’unité.
Quantité decimal Obtient ou définit la quantité d’utilisation.
UnitType string Obtient ou définit le type d’unité (par exemple, 1 heure).
BillingPreTaxTotal decimal Obtient ou définit le coût étendu ou le coût total avant taxe dans la devise locale du client ou de la devise de facturation.
BillingCurrency string Obtient ou définit la devise ISO dans laquelle le compteur est facturé en devise locale du client ou de la devise de facturation.
PricingPreTaxTotal decimal Obtient ou définit le coût étendu ou le coût total avant taxe en USD ou devise de catalogue utilisée pour l’évaluation.
PricingCurrency string Obtient ou définit la devise ISO dans laquelle le compteur est facturé en USD ou devise de catalogue utilisée pour l’évaluation.
EntitlementId string Obtient ou définit l’ID de droit (abonnement Azure).
EntitlementDescription string Obtient ou définit la description des droits d’utilisation (abonnement Azure).
PCToBCExchangeRate string Obtient ou définit la devise de tarification sur le taux de change de devise de facturation.
PCToBCExchangeRateDate Date/Heure Obtient ou définit la devise de tarification à la date du taux de change de devise de facturation.
EffectiveUnitPrice decimal Obtient ou définit le prix unitaire effectif.
RateOfPartnerEarnedCredit decimal Obtient ou définit le taux de crédit gagné par un partenaire.
HasPartnerEarnedCredit bool Obtient ou définit le crédit partenaire appliqué.
RateOfCredit decimal Obtient ou définit le taux de crédit pour le type de crédit donné.
CreditType string Obtient ou définit le type de crédit.
InvoiceLineItemType InvoiceLineItemType Retourne le type d’élément de ligne de facture.
BillingProvider BillingProvider Retourne le fournisseur de facturation.