Überblick über Abrechnungsdaten #
Die Abrechnungsressource bietet Zugriff auf den Download von Rechnungen und Abrechnungsdaten von ~.Dimensions.~.
/{VERSION}/billingdata
Schema der Rechnungsdetails #
Kunden stellen einen Tenant auf dem System dar, dem Endbenutzer über die API zugewiesen werden können.
| Legende | Beschreibung | Typ | Verfügbarkeit |
|---|---|---|---|
| Mieterort | Die ID des übergeordneten Reseller-Kontos | String | Alle |
| invoiceid | Eine eindeutige Nummer, um eine bestimmte Rechnung zu identifizieren | String | Alle |
| Rechnungsnummer | Die auf der Rechnung PDF angezeigt wird | String | Alle |
| Kontoname | Der Firmenname des Mutter-Reseller-Kontos | String | Alle |
| Abrechnungszeitraum starten | Das Datum, an dem der Abrechnungszeitraum beginnt | String | Alle |
| billingperiodend | Das Ende, an dem der Abrechnungszeitraum endet | String | Alle |
| Rechnungswert | Der Gesamtwert der Rechnung | Double | Alle |
| Rechnungsposten | Eine Sammlung von Rechnungsposten | Array (Rechnungspost) | Nur Rechnungsdetails erhalten |
Rechnungspostenschema #
Jeder Eintrag in den Abrechnungsdaten liefert die unten aufgeführten Parameter.
| Legende | Beschreibung | Typ |
|---|---|---|
| id | Die ID des übergeordneten Reseller-Kontos | String |
| Menge | Die verwendete Menge | Double |
| Wert | Die Kosten des Gegenstands | Double |
| fromdate | Das Datum, ab dem der Artikel abgerechnet wird | String |
| Bis heute | Das Datum, an das der Artikel abgerechnet wird | String |
| Berechnungsreihenfolge | Fortlaufende Nummer, die die Reihenfolge angibt, in der die Rechnungsposten verarbeitet werden sollen | Int |
| operatorused | Zeigt an, wie der Wert des Rechnungspostens auf die Rechnung angewendet wird | Rechnungsposten-Operator |
| operatorvalueused | Gibt den Wert des ADJUSTPERCENTAGE-Operators an. | Double |
| producttagname | Der Name des Features/Produkts, für das sich der Rechnungsposten befindet. Dies ist im Format '{PRODUCT_NAME} #{PART_NUMBER}' | String |
| billingoutputtags | Angabe, ob der Rechnungsposten für einen Kauf oder ein Zusammenfassungsfeld ist. | Array(String) |
| Stringvalues | Liefert Informationen über den Kunden und Endnutzer, für den der Kauf bestimmt ist | KeyValuePair<string,string> |
| Numerische Werte | Liefert Informationen über den Kunden und Endnutzer, für den der Kauf bestimmt ist | KeyValuePair<string,double> |
Rechnungspostoperatoren #
Der Operator für jeden Artikel gibt an, wie der Artikel auf die Rechnung angewendet wird. PurchaseResult enthält eine PRICE zur Identifizierung der Kosten des Artikels. Artikel mit anderen Ausgabe-Tags geben an, ob sie den Wert der Rechnung summieren oder einen Prozentwert auf frühere Posten wie Umsatzsteuer anwenden.
| Artikel | Beschreibung |
|---|---|
| PREIS | Zeigt an, dass der Rechnungsposten den Einheitspreis eines Artikels anzeigt |
| SUM | Zeigt an, dass der Rechnungsposten insgesamt mehrere Posten zeigt |
| ANPASSUNGSPROZENTSATZ | Zeigt an, dass der Rechnungsposten eine prozentuale Anpassung der SUMME anzeigt, was in der Regel darauf hinweist, dass die Mehrwertsteuer angewendet wird |
Abrechnungsausgabe-Tag-Posten #
Abrechnungsausgabe-Tags werden verwendet, um anzuzeigen, ob die Dateneingabe sich auf einen Kauf bezieht oder ob es sich um einen zusammenfassenden Eintrag handelt, der Informationen über die gesamte Rechnung liefert.
| Artikel | Beschreibung |
|---|---|
| PurchaseResult | Zeigt an, dass der Rechnungsposten ein steuerpflichtiger Kauf ist |
| Zusammenfassung | Zeigt an, dass der Rechnungsposten eine Zusammenfassung der Einkäufe ist und Informationen über die Gesamtsumme der Rechnung liefert. Wenn es allein ohne die Tags 'TotalVAT' oder 'TotalInclVAT' ist, zeigt es die Gesamtsumme der Rechnung vor der Mehrwertsteuer an. |
| TotalInklMVA | Zeigt an, dass der Rechnungsposten den Gesamtbetrag der Rechnung einschließlich der anfallenden Mehrwertsteuer anzeigt |
| TotalMVA | Zeigt an, dass der Rechnungsposten die gesamte anfallende Mehrwertsteuer für die Rechnung anzeigt |
String-Wertelemente #
Die String-Value-Items liefern Informationen, die spezifisch für den Kunden und Endnutzer des gekauften Artikels sind.
| Legende | Beschreibung | |
|---|---|---|
| TenantCode1 | Die Kunden-Tenant-ID | |
| TenantCodeext1 | Die Referenz des Wiederverkäufers für den Kunden | |
| TenantName1 | Der Name des Kunden | String |
| ResellerCode | Die Mieter-ID des Wiederverkäufers | |
| ResellerCodeExt2 | Die erweiterte Referenz für den Wiederverkäufer | |
| ResellerName | Der Name des Wiederverkäufers | |
| UserId | Die ID des Benutzers | |
| Benutzername | Der Benutzername des Nutzers | |
| Rolle | Der Rollenschlüssel für den abgestellten Posten |
Numerische Wertposten #
Die numerischen Wertposten liefern Informationen, die spezifisch für den Kunden und den Endnutzer des gekauften Artikels sind.
| Legende | Beschreibung |
|---|---|
| customer_licence_count | Die Gesamtzahl dieser Lizenzen, die der Kunde besitzt |
Verfügbare Schnittstellen #
| Schnittstelle | Beschreibung |
|---|---|
| Macht alles | Sendet eine Sammlung aller Rechnungen zurück. |
| Rechnung erhalten | Gibt die Details einer bestimmten Rechnung zurück. |
| Erhalten Sie Rechnungsdetails | Gibt JSON & CSV die Datenausgabe einer bestimmten Rechnung in einer ZIP-Datei zurück. |
| Erhalten Sie Rechnungsübersicht | Gibt die PDF Datenausgabe einer bestimmten Rechnung zurück. |
-
Die Felder 'TenantCode', 'TenantCodeExt' und 'TenantName' werden mit Informationen über das Kundenkonto ausgefüllt. ↩︎
-
Der ResellerCodeExt wird mit der Referenznummer ausgefüllt, die gegen den Reseller konfiguriert wurde. Dies kann bei Bedarf über das Enterprise Portal oder über das Customer API aktualisiert werden, um die Verknüpfung von Wiederverkäuferdaten mit externen Systemen zu ermöglichen. ↩︎