Obtenir les détails de la facture #
Obtenez une ventilation détaillée de tous les articles facturés pour une facture spécifique. Un fichier ZIP est retourné à partir de cette requête qui contient un JSON et un fichier simplifié CSV fichier. Chaque fichier contient un enregistrement de chaque transaction dans la facture.
GET /v1.0/billingdata/{INVOICE_ID}/detail
Exemple #
Cette demande récupérera une ventilation des articles pour un numéro de facture spécifique.
Demande #
GET /api/v1.0/billingdata/{INVOICE_ID}/detail HTTP/1.1
Autorisation : Porteur {TOKEN}Réponse #
HTTP/1.1 200 OK
Type de contenu : application/volet d'octuor; charset=utf-8
Longueur du contenu : xx
{
« status » : « succès »,
« timestamp » : « 2019-01-01T10:00:00.2890319Z »
}Exemple JSON Données #
{
« locataireId » : « 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 »,
« ValeurFacture » : 17,50,
« invoiceItems » : \[
{
« id » : « 000000000000000000000001 »,
« quantity » : 1,0,
« value » : 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 » : « customer.user.pbx »
},
{
« name » : « ResellerCode »,
« value » : « 00000000-00000-0000-00000-0000000000222 »
},
{
« name » : « ResellerCodeExt »,
« value » : « reseller ref 1 »
},
{
« name » : « ResellerName »,
« value » : « ABC Reseller »
},
{
« name » : « Code locataire »,
« value » : « 00000000-00000-00000-0000000000000111 »
},
{
« name » : « TenantCodeExt »,
« value » : « Custom Ref 1 »
},
{
« name » : « LocataireName »,
« value » : « Exemple de client 1 »
},
{
« name » : « UserId »,
« value » : « 00000000-0000-0000-0000-0000000000000001 »
},
{
« 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 »,
« quantity » : 1,0,
« value » : 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 » : « customer.user.supervisorl2 »
},
{
« name » : « ResellerCode »,
« value » : « 00000000-00000-0000-00000-0000000000222 »
},
{
« name » : « ResellerCodeExt »,
« value » : « reseller ref 1 »
},
{
« name » : « ResellerName »,
« value » : « ABC Reseller »
},
{
« name » : « Code locataire »,
« value » : « 00000000-00000-00000-0000000000000111 »
},
{
« name » : « TenantCodeExt »,
« value » : « Custom Ref 1 »
},
{
« name » : « LocataireName »,
« value » : « Exemple de client 1 »
},
{
« name » : « UserId »,
« value » : « 00000000-0000-0000-0000-0000000000000001 »
},
{
« 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 »,
« quantity » : 3,0,
« value » : 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 » : [« Sommaire », « Total », « GL », « GL_Entry :0000; crédit;"][ "Summary", "Total", "GL", "GL_Entry:0000;credit;" ],
« stringValues » : [][ ]
},
{
« id » : « 000000000000000000000005 »,
« quantity » : 3,0,
« value » : 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 », « Sommaire », « GL_Balance », « GL_Entry :2222; débit; Débiteurs »][ "TotalInclVAT", "Summary", "GL_Balance", "GL_Entry:2222;debit;Debtors" ],
« stringValues » : [][ ]
},
{
« id » : « 000000000000000000000006 »,
« quantité » : 345,0,
« value » : 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, « Sommaire », « GL_VAT », « TVA :S », « GL_Entry :1111; crédit; TVA"][ "TotalVAT", "Summary", "GL_VAT", "VAT:S", "GL_Entry:1111;credit;VAT" ],
« stringValues » : [][ ]
}
],
« TypeFacture » : 0
}Exemple CSV Données #
id,quantity,value,fromdate,todate,productname,partnumber,tenantcode,tenantcodeext,tenantname,userid,username,resellercodeext,resellernameext,resellername
0000000000000000000000001,1,1.25,2020-04-01T00:00:00.000+00:00,2020-04-30T23:59:59.000+00:00,Utilisateur essentiel,#XDM00001,00000000-0000-0000-0000-000000000011,custom ref 1,Exemple client 1,000000000-0000-0000-00000-0000000000001,[[email protected]](mailto:[email protected]),000000000-00000-0000-00000-000000000222,revendeur ref 1,ABC Revendeur
0000000000000000000000003,1,15,2020-04-01T00:00:00.000+00:00,2020-04-30T23:59:59.000+00:00,Superviseur en temps réel,#XDM00010,00000000-0000-0000-0000-0000000000011,custom ref 1,Exemple client 1,000000000-0000-0000-00000-00000000001,[[email protected]](mailto:[email protected]),000000000-00000-0000-00000-000000000222,revendeur ref 1,ABC RevendeurErreurs #
Non autorisé #
Lorsque le jeton n'est pas fourni, invalide ou expiré
HTTP/1.1 401 Non autoriséNon trouvé #
Lorsqu'il n'y a pas de factures qui ont un identifiant de facture correspondant
HTTP/1.1 404 Introuvable
Date : Thu, 06 Feb 2020 12:46:58 GMT
Type de contenu : application/json; charset=utf-8
Longueur du contenu : 95
{
« error » : 404,
« message » : « Introuvable »,
« status » : « erreur »,
« timestamp » : « 2020-02-06T12:46:58.7669535Z »
}