Données de facturation JSON #
Les informations ci-dessous fournissent des détails sur le JSON Données fournies lors du téléchargement des données pour une facture spécifique. Le JSON Les données fournissent le niveau d'information le plus granulaire, y compris des entrées pour chaque licence utilisateur utilisée et des entrées récapitulatives fournissant des informations sur les totaux des factures et les taxes applicables.
Schéma des détails de la facture #
Le principal JSON L'entrée fournit des détails sur le numéro de facture, la période et la date. Il contient également un tableau des éléments de facturation individuels qui se rapportent à chaque licence facturée.
| Clé | Description | Type |
|---|---|---|
| TenantID | L'identifiant du compte revendeur parent | corde |
| ID de la facture | Un numéro unique pour identifier une facture particulière | corde |
| Numéro de facture | Le numéro de facture affiché sur le PDF facture | corde |
| nom de compte | Nom de l'entreprise pour le compte revendeur parent | corde |
| BillingPeriodStart | La date de début de la période de facturation | corde |
| facturationfin | La date de fin de la période de facturation | corde |
| Valeur de la facture | La valeur totale de la facture | double |
| facturearticles | Une collection d'éléments de facture | array(Élément de facture) |
JSON Schéma de l'élément de facture #
Chaque entrée d'élément de facture dans le JSON Les données de facturation fournissent les paramètres répertoriés ci-dessous. Il s'agit d'une utilisation individuelle par un utilisateur avec les plages de dates applicables.
| Clé | Description | Type |
|---|---|---|
| id | Un identifiant unique pour l'achat individuel | corde |
| quantité1 | La quantité utilisée | double |
| valeur | Le coût de l'article | double |
| date d'arrivée | La date à partir de laquelle l'article est facturé | corde |
| à ce jour | La date à partir de laquelle l'article est facturé | corde |
| de calculordre | Numéro séquentiel indiquant l'ordre dans lequel les articles de la facture doivent être traités | Int |
| UtilisateurUtilisé | Indique comment la valeur de l'élément de facture est appliquée à la facture | Opérateur d'élément de facture |
| opérateurvaleurutilisé | Indique la valeur de l'opérateur ADJUSTPERCENTAGE | double |
| producttagname | Le nom de la fonctionnalité/du produit auquel l'élément de facture est destiné. Ce sera au format '{PRODUCT_NAME} #{PART_NUMBER}' | corde |
| facturationsortiebalises | Indication indiquant si l'élément de facture est destiné à un achat ou à un champ récapitulatif | tableau(chaîne) |
| chaînevaleurs | Fournit des informations sur le client et l'utilisateur final pour lequel l'achat est effectué | KeyValuePair< chaîne,chaîne> |
| numériquevaleurs | Fournit des informations sur le client et l'utilisateur final pour lequel l'achat est effectué | KeyValuePair< chaîne,double> |
Opérateurs d'élément de facture #
L'opérateur de chaque article indique comment l'effet est appliqué à la facture. PurchaseResult aura un PRIX pour identifier le coût de l'article. Les articles avec d'autres balises de sortie indiquent s'ils additionnent la valeur de la facture ou s'ils appliquent une valeur en pourcentage aux éléments précédents tels que la taxe de vente.
| Articles | Description |
|---|---|
| PRIX | Indique que l'article facturé affiche le prix unitaire d'un article |
| SOMME | Indique que l'élément de facture affiche un total de plusieurs éléments |
| AJUSTERPOURCENTAGE | Indique que l'élément de facture affiche un ajustement en pourcentage de la SOMME, cela indique généralement que la TVA est appliquée |
Éléments de balise de sortie de facturation #
Les balises 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 récapitulative fournissant des informations sur l'ensemble de la facture.
| Articles | Description |
|---|---|
| PurchaseResult | Indique que l'article facturé est un achat facturable |
| Résumé | Indique que l'élément de facture est un récapitulatif des achats, fournissant des informations sur le total de la facture. Lorsqu'il est seul sans les balises 'TotalVAT' ou 'TotalInclVAT', il indique le montant total de la facture avant l'ajout de la TVA. |
| TotalTVA incluse | Indique que l'élément de facture affiche le total de la facture, y compris la TVA applicable. |
| TotalTVA | Indique que l'élément de la facture affiche le montant total de la TVA applicable à la facture. |
Éléments de valeur de chaîne #
Les articles de valeur de chaîne fournissent des informations spécifiques au client et à l'utilisateur final de l'article acheté.
| Clé | Description | |
|---|---|---|
| TenantCode2 | L'ID de locataire du revendeur | |
| TenantCodeext2 | La référence du revendeur pour le revendeur | |
| TenantName2 | Le nom du revendeur | corde |
| Code du revendeur | L'ID de locataire du revendeur | |
| ResellerCodeExt | La référence étendue pour le revendeur | |
| Nom du revendeur | Le nom du revendeur | |
| Identifiant utilisateur | L'identifiant de l'utilisateur | |
| Nom d’utilisateur | Le nom d'utilisateur de l'utilisateur | |
| rôle | Clé de rôle pour l'article facturé |
Éléments de valeur numérique #
Les éléments de valeur numérique fournissent des informations spécifiques au client et à l'utilisateur final de l'article acheté.
| Clé | Description |
|---|---|
| customer_licence_count | Le nombre total de ces licences dont dispose le client |
Exemple JSON Sortie #
{
« tenantId » : « 00000000-0000-0000-0000-123456789123 »,
« invoiceId » : « 00000000000000000000000a »,
« invoiceNumber » : « 9000004 »,
« accountName » : « Exemple de locataire 1 »,
« billingPeriodStart » : « 2020-04-01T00:00:00.0000000 »,
« billingPeriodEnd » : « 2020-04-30T23:59:59.0000000 »,
« invoiceDate » : « 2020-04-09T00:00:00.0000000 »,
« invoiceValue » : 17,50,
« invoiceItems » : \[
{
« id » : « 000000000000000000000001 »,
« quantité » : 1,0,
« valeur » : 1,25,
« fromDate » : « 2020-04-01T00:00:00.000+00:00 »,
« toDate » : « 2020-04-30T23:59:59.000+00:00 »,
« calculationOrder » : 1,
« operatorUsed » : « PRIX »,
« operatorValueUsed » : 1.25,
« productTagName » : « Utilisateur essentiel #XDM00001 »,
« billingOutputTags » : [« PurchaseResult »][ "PurchaseResult" ],
« stringValues » : [
{
« name » : « Rôle »,
« value » : « client.utilisateur.pbx »
},
{
« name » : « ResellerCode »,
« value » : « 00000000-0000-0000-0000-00000000222 »
},
{
« name » : « ResellerCodeExt »,
« value » : « revendeur ref 1 »
},
{
« name » : « ResellerName »,
« value » : « Revendeur ABC »
},
{
« name » : « TenantCode »,
« value » : « 00000000-0000-0000-0000-0000000111 »
},
{
« name » : « TenantCodeExt »,
« value » : « Réf personnalisée 1 »
},
{
« name » : « TenantName »,
« value » : « Exemple de client 1 »
},
{
« name » : « UserId »,
« value » : « 00000000-0000-0000-0000-00000-0000000001 »
},
{
« name » : « Nom d'utilisateur »,
« value » : « [email protected] »
}
][
{
"name": "Role",
"value": "customer.user.pbx"
},
{
"name": "ResellerCode",
"value": "00000000-0000-0000-0000-000000000222"
},
{
"name": "ResellerCodeExt",
"value": "reseller ref 1"
},
{
"name": "ResellerName",
"value": "ABC Reseller"
},
{
"name": "TenantCode",
"value": "00000000-0000-0000-0000-000000000111"
},
{
"name": "TenantCodeExt",
"value": "custom ref 1"
},
{
"name": "TenantName",
"value": "Example Customer 1"
},
{
"name": "UserId",
"value": "00000000-0000-0000-0000-000000000001"
},
{
"name": "UserName",
"value": "[email protected]"
}
],
« numericValues » : [
{
« name » : « customer_licence_count »,
« valeur » : 1
}
][
{
"name": "customer_licence_count",
"value": 1
}
]
},
{
« id » : « 000000000000000000000003 »,
« quantité » : 1,0,
« valeur » : 15.0,
« fromDate » : « 2020-04-01T00:00:00.000+00:00 »,
« toDate » : « 2020-04-30T23:59:59.000+00:00 »,
« calculationOrder » : 3,
« operatorUsed » : « PRIX »,
« operatorValueUsed » : 15.00,
« productTagName » : « Superviseur en temps réel #XDM00010 »,
« billingOutputTags » : [« PurchaseResult »][ "PurchaseResult" ],
« stringValues » : [
{
« name » : « Rôle »,
« value » : « client.utilisateur.supervisorl2 »
},
{
« name » : « ResellerCode »,
« value » : « 00000000-0000-0000-0000-00000000222 »
},
{
« name » : « ResellerCodeExt »,
« value » : « revendeur ref 1 »
},
{
« name » : « ResellerName »,
« value » : « Revendeur ABC »
},
{
« name » : « TenantCode »,
« value » : « 00000000-0000-0000-0000-0000000111 »
},
{
« name » : « TenantCodeExt »,
« value » : « Réf personnalisée 1 »
},
{
« name » : « TenantName »,
« value » : « Exemple de client 1 »
},
{
« name » : « UserId »,
« value » : « 00000000-0000-0000-0000-00000-0000000001 »
},
{
« name » : « Nom d'utilisateur »,
« value » : « [email protected] »
}
][
{
"name": "Role",
"value": "customer.user.supervisorl2"
},
{
"name": "ResellerCode",
"value": "00000000-0000-0000-0000-000000000222"
},
{
"name": "ResellerCodeExt",
"value": "reseller ref 1"
},
{
"name": "ResellerName",
"value": "ABC Reseller"
},
{
"name": "TenantCode",
"value": "00000000-0000-0000-0000-000000000111"
},
{
"name": "TenantCodeExt",
"value": "custom ref 1"
},
{
"name": "TenantName",
"value": "Example Customer 1"
},
{
"name": "UserId",
"value": "00000000-0000-0000-0000-000000000001"
},
{
"name": "UserName",
"value": "[email protected]"
}
],
« numericValues » : [
{
« name » : « customer_licence_count »,
« valeur » : 1
}
][
{
"name": "customer_licence_count",
"value": 1
}
]
},
{
« id » : « 000000000000000000000004 »,
« quantité » : 3.0,
« valeur » : 17,50,
« fromDate » : « 2020-04-01T00:00:00.000+00:00 »,
« toDate » : « 2020-04-30T23:59:59.000+00:00 »,
« calculationOrder » : 4,
« operatorUsed » : « SOMME »,
« operatorValueUsed » : 0.0,
« productTagName » : « Tous les produits »,
« billingOutputTags » : [« Résumé », « Total », « GL », « GL_Entry :0000 ; crédit ;"][ "Summary", "Total", "GL", "GL_Entry:0000;credit;" ],
« stringValues » : [][ ]
},
{
« id » : « 000000000000000000000005 »,
« quantité » : 3.0,
« valeur » : 17,50,
« fromDate » : « 2020-04-01T00:00:00.000+00:00 »,
« toDate » : « 2020-04-30T23:59:59.000+00:00 »,
« calculationOrder » : 5,
« operatorUsed » : « ADJUSTPERCENTAGE »,
« operatorValueUsed » : 0.0,
« productTagName » : « Tous les produits »,
« billingOutputTags » : [« TotalInclVAT », « Summary », « GL_Balance », « GL_Entry :2222 ; débit; Débiteurs"][ "TotalInclVAT", "Summary", "GL_Balance", "GL_Entry:2222;debit;Debtors" ],
« stringValues » : [][ ]
},
{
« id » : « 000000000000000000000006 »,
« quantité » : 345.0,
« valeur » : 0,0,
« fromDate » : « 2020-04-01T00:00:00.000+00:00 »,
« toDate » : « 2020-04-30T23:59:59.000+00:00 »,
« calculationOrder » : 6,
« operatorUsed » : « ADJUSTPERCENTAGE »,
« operatorValueUsed » : 0.0,
« productTagName » : « Tous les produits »,
« billingOutputTags » : [« TotalVAT », « Summary », « GL_VAT », « VAT :S », « GL_Entry :1111 ; crédit; TVA"][ "TotalVAT", "Summary", "GL_VAT", "VAT:S", "GL_Entry:1111;credit;VAT" ],
« stringValues » : [][ ]
}
],
« invoiceType » : 0
}