Ressources de facture
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 | nombre | Frais totaux. Inclut les frais pour les transactions et les ajustements. |
| paidAmount | nombre | 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 », « Office », « 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 », « Office », « 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 | nombre | 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 | nombre | 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. |
| devise | 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 | nombre | 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é | nombre | 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 | nombre | 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 | nombre | Obtient ou définit les taxes facturées. |
| tier2MpnId | nombre | Obtient ou définit l’ID partenaire du partenaire de niveau 2 associé à cet élément de ligne. |
| totalForCustomer | nombre | Obtient ou définit le montant total après remise et taxe. |
| totalOtherDiscount | nombre | Obtient ou définit la remise associée à cet achat. |
| unitPrice | nombre | 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 | nombre | 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. |
| devise | 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 | nombre | 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 | nombre | 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 | nombre | Obtient ou définit le prix de chaque unité. |
| partnerId | nombre | 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 | nombre | 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 | nombre | Obtient ou définit le prix effectif après les taxes. |
| postTaxTotal | nombre | Obtient ou définit le total des frais après impôt. Frais de prétaxe + Montant fiscal |
| preTaxCharges | nombre | Obtient ou définit le prix facturé avant les taxes. |
| preTaxEffectiveRate | nombre | 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 | nombre | Obtient ou définit le montant de la taxe facturée. |
| tier2MpnId | nombre | 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. |
| MeterId | 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. |