Aperçu des données de facturation #
La ressource Facturation permet de télécharger les factures et les données de facturation à partir de ~.Dimensions.~.
/{VERSION}/billingdata
Schéma des détails de la facture #
Les clients représentent un locataire sur le système auquel les utilisateurs finaux peuvent être affectés via le API.
| Clé | Descriptif | Type | Disponibilité |
|---|---|---|---|
| LocataireID | L'identifiant du compte de revendeur parent | Chaîne | Tous |
| Numéro de facture | Un numéro unique pour identifier une facture particulière | Chaîne | Tous |
| numéro de facture | Le numéro de facture affiché sur le bouton PDF facture | Chaîne | Tous |
| nom du compte | Le nom de l'entreprise pour le compte de revendeur parent | Chaîne | Tous |
| Période de facturationDébut | La date de début de la période de facturation | Chaîne | Tous |
| facturationpériodefin | La date à laquelle la période de facturation se termine | Chaîne | Tous |
| valeur de la facture | La valeur totale de la facture | double | Tous |
| Éléments de facture | Une collection d'articles de facture | array(Élément de facture | Obtenir les détails de la facture Seulement |
Schéma de l'article de facture #
Chaque entrée dans les données de facturation fournit les paramètres énumérés ci-dessous.
| Clé | Descriptif | Type |
|---|---|---|
| Identifiant | L'identifiant du compte de revendeur parent | Chaîne |
| Quantité | La quantité utilisée | double |
| Valeur | Le coût de l'article | double |
| à partir de la date | La date à partir de laquelle l'article est facturé | Chaîne |
| à ce jour | La date à partir de laquelle l'article est facturé | Chaîne |
| Ordre de calcul | Numéro séquentiel indiquant l'ordre dans lequel les articles de facture doivent être traités | int |
| Utilisé par l'utilisateur | Indique comment la valeur de l'élément de facture est appliquée à la facture | Opérateur d'article de facture |
| operatorvalueused | Indique la valeur de l'opérateur ADJUSTPERCENTAGE | double |
| producttagname | Le nom de la fonctionnalité ou du produit pour lequel l'article de facture est destiné. Ce sera dans le format '{PRODUCT_NAME} #{PART_NUMBER}' | Chaîne |
| billingoutputtags | Indiquer si l'article de la facture est destiné à un achat ou s'il s'agit d'un champ sommaire | tableau(chaîne) |
| stringValeurs | Fournit des renseignements sur le client et l'utilisateur final auquel l'achat est destiné | Paire clés-valeurs< chaîne,chaîne> |
| valeurs numériques | Fournit des renseignements sur le client et l'utilisateur final auquel l'achat est destiné | Paire clés-valeurs< corde,double> |
Opérateurs d'articles de facture #
L'opérateur de chaque article indique comment l'article est appliqué à la facture. PurchaseResult aura un PRIX pour déterminer le coût de l'article. Les articles avec d'autres étiquettes de sortie indiqueront s'ils additionnent la valeur de la facture ou s'ils appliquent une valeur en pourcentage à des articles précédents, comme la taxe de vente.
| Objets | Descriptif |
|---|---|
| PRIX | Indique que l'article de la facture indique le prix unitaire d'un article |
| SOMME | Indique que l'article de la facture affiche un total de plusieurs articles |
| AJUSTEMENTPOURCENTAGE | Indique que l'article de la facture affiche un ajustement en pourcentage de la SOMME, ce qui indique généralement que la TVA est appliquée |
Éléments de la balise de sortie de facturation #
Les étiquettes de sortie de facturation sont utilisées pour indiquer si la saisie de données se rapporte à un achat ou s'il s'agit d'une entrée sommaire fournissant des renseignements sur l'ensemble de la facture.
| Objets | Descriptif |
|---|---|
| Résultat de l'achat | Indique que l'article de la facture est un achat facturable |
| Résumé | Indique que l'article de la facture est un résumé des achats, fournissant des informations sur le total de la facture. Lorsqu'il est seul sans les balises « TotalVATA » ou « TotalInclVAT, il indique le total de la facture avant l'ajout de la TVA. |
| TotalInclVAT | Indique que l'article de la facture affiche le total de la facture, y compris la TVA applicable. |
| TVA totale | Indique que l'article de la facture affiche la TVA totale applicable à la facture |
Éléments de valeur de chaîne #
Les éléments de valeur de chaîne fournissent des informations spécifiques au client et à l'utilisateur final de l'article acheté.
| Clé | Descriptif | |
|---|---|---|
| CodeLocataire1 | L'identifiant du client locataire | |
| TenantCodeext1 | La référence du revendeur pour le client | |
| NomLocataire1 | Le nom du client | Chaîne |
| Code revendeur | L'identifiant du locataire du revendeur | |
| ResellerCodeExt2 | La référence étendue pour le revendeur | |
| Nom du revendeur | Le nom du revendeur | |
| Identifiant de l'utilisateur | L'identifiant de l'utilisateur | |
| Nom d'utilisateur | Le nom d'utilisateur de l'utilisateur | |
| rôle | La clé de rôle pour l'article facturé |
Éléments à valeur numérique #
Les éléments à valeur numérique fournissent des renseignements spécifiques au client et à l'utilisateur final de l'article acheté.
| Clé | Descriptif |
|---|---|
| customer_licence_count | Le nombre total de ces licences que le client détient |
Interfaces disponibles #
| Interface | Descriptif |
|---|---|
| Obtenir tout | Retourne une collection de toutes les factures. |
| Obtenir la facture | Retourne les détails d'une facture spécifique. |
| Obtenir les détails de la facture | Retours JSON & CSV la sortie des données d'une facture spécifique dans un fichier ZIP. |
| Obtenir le sommaire de la facture | Renvoie le module PDF la sortie des données d'une facture spécifique. |
-
Les champs « TenantCode », « TenantCodeExt » et « TenantName » sont remplis avec des informations sur le compte du client. ↩︎
-
Le ResellerCodeExt sera rempli avec le numéro de référence qui a été configuré par rapport au revendeur. Cela peut être mis à jour au besoin par l'intermédiaire du portail d'entreprise ou par l'intermédiaire du Client API, pour permettre le lien des dossiers des revendeurs avec des systèmes externes. ↩︎