Erhalten Sie Rechnungsdetails

Erhalten Sie Rechnungsdetails #

Erhalten Sie eine detaillierte Aufschlüsselung aller für eine bestimmte Rechnung abgerechnete Artikel. Aus dieser Abfrage wird eine ZIP-Datei zurückgegeben, die eine detaillierte Datei JSON sowie eine vereinfachte Datei CSV enthält. Jede Datei enthält eine Aufzeichnung jeder Transaktion in der Rechnung.

GET /v1.0/billingdata/{INVOICE_ID}/detail

Beispiel #

Diese Anfrage liefert eine Aufschlüsselung der Artikel für eine bestimmte Rechnungsnummer.

Anfrage #

GET /api/v1.0/billingdata/{INVOICE_ID}/detail HTTP/1.1
Autorisierung: Inhaber {TOKEN}

Reaktion #

HTTP/1.1 200 OK
Inhaltstyp: Anwendung/Oktettstrom; charset=utf-8
Inhalt-Länge: xx
{
	"Status": "Erfolg",
	"Zeitstempel": "2019-01-01T10:00:00.2890319Z"
}

Beispiel JSON Daten #

{
	"tenantId": "00000000-0000-0000-0000-123456789123",
	"invoiceId": "00000000000000000000000a",
	"invoiceNumber": "9000004",
	"accountName": "Beispiel Tenant 1",
	"billingPeriodStart": "2020-04-01T00:00:00.0000000",
	"billingPeriodEnd": "2020-04-30T23:59:0000000",
	"invoiceDate": "2020-04-09T00:00:00.0000000",
	"invoiceValue": 17,50,
	"invoiceItems": \[
		{
			"id": "000000000000000000000001",
			"Menge": 1,0,
			"Wert": 1,25,
			"fromDate": "2020-04-01T00:00:00.000+00:00",
			"toDate": "2020-04-30T23:59:59.000+00:00",
			"BerechnungOrdnung": 1,
			"operatorUsed": "PRICE",
			"operatorValueUsed": 1.25,
			"productTagName": "Essential User #XDM00001",
			"billingOutputTags": ["PurchaseResult"][ "PurchaseResult" ],
			"stringValues": [
				{
					"Name": "Rolle",
					"value": "customer.user.pbx"
				},
				{
					"name": "ResellerCode",
					"Wert": "00000000-0000-0000-00000-000000002222"
				},
				{
					"name": "ResellerCodeExt",
					"Value": "Reseller Ref 1"
				},
				{
					"name": "ResellerName",
					"Value": "ABC Reseller"
				},
				{
					"name": "TenantCode",
					"Wert": "00000000-0000-0000-00000-00000000111"
				},
				{
					"name": "TenantCodeExt",
					"Value": "Custom Ref 1"
				},
				{
					"name": "TenantName",
					"Wert": "Beispielkunde 1"
				},
				{
					"name": "UserId",
					"Wert": "00000000-0000-0000-00000-0000000001"
				},
				{
					"name": "UserName",
					"Wert": "[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",
					"Wert": 1
				}
			][
				{
					"name": "customer_licence_count",
					"value": 1
				}
			]
		},
		{
			"id": "000000000000000000000003",
			"Menge": 1,0,
			"Wert": 15,0,
			"fromDate": "2020-04-01T00:00:00.000+00:00",
			"toDate": "2020-04-30T23:59:59.000+00:00",
			"BerechnungOrdnung": 3,
			"operatorUsed": "PRICE",
			"operatorValueUsed": 15,00,
			"productTagName": "Real-Time Supervisor #XDM00010",
			"billingOutputTags": ["PurchaseResult"][ "PurchaseResult" ],
			"stringValues": [
				{
					"Name": "Rolle",
					"value": "customer.user.supervisorl2"
				},
				{
					"name": "ResellerCode",
					"Wert": "00000000-0000-0000-00000-000000002222"
				},
				{
					"name": "ResellerCodeExt",
					"Value": "Reseller Ref 1"
				},
				{
					"name": "ResellerName",
					"Value": "ABC Reseller"
				},
				{
					"name": "TenantCode",
					"Wert": "00000000-0000-0000-00000-00000000111"
				},
				{
					"name": "TenantCodeExt",
					"Value": "Custom Ref 1"
				},
				{
					"name": "TenantName",
					"Wert": "Beispielkunde 1"
				},
				{
					"name": "UserId",
					"Wert": "00000000-0000-0000-00000-0000000001"
				},
				{
					"name": "UserName",
					"Wert": "[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",
					"Wert": 1
				}
			][
				{
					"name": "customer_licence_count",
					"value": 1
				}
			]
		},
		{
			"id": "000000000000000000000004",
			"Menge": 3,0,
			"Wert": 17,50,
			"fromDate": "2020-04-01T00:00:00.000+00:00",
			"toDate": "2020-04-30T23:59:59.000+00:00",
			"BerechnungOrdnung": 4,
			"operatorUsed": "SUM",
			"operatorValueUsed": 0,0,
			"productTagName": "Alle Produkte",
			"billingOutputTags": ["Summary", "Total", "GL", "GL_Entry:0000; Quelle;"][ "Summary", "Total", "GL", "GL_Entry:0000;credit;" ],
			"stringValues": [][ ]
		},
		{
			"id": "000000000000000000000005",
			"Menge": 3,0,
			"Wert": 17,50,
			"fromDate": "2020-04-01T00:00:00.000+00:00",
			"toDate": "2020-04-30T23:59:59.000+00:00",
			"BerechnungOrdnung": 5,
			"operatorUsed": "ADJUSTPERCENTAGE",
			"operatorValueUsed": 0,0,
			"productTagName": "Alle Produkte",
			"billingOutputTags": ["TotalInclVAT", "Summary", "GL_Balance", "GL_Entry:2222; Debit; Schuldner"][ "TotalInclVAT", "Summary", "GL_Balance", "GL_Entry:2222;debit;Debtors" ],
			"stringValues": [][ ]
		},
		{
			"id": "000000000000000000000006",
			"Menge": 345,0,
			"Wert": 0,0,
			"fromDate": "2020-04-01T00:00:00.000+00:00",
			"toDate": "2020-04-30T23:59:59.000+00:00",
			"BerechnungOrdnung": 6,
			"operatorUsed": "ADJUSTPERCENTAGE",
			"operatorValueUsed": 0,0,
			"productTagName": "Alle Produkte",
			"billingOutputTags": ["TotalVAT", "Summary", "GL_VAT", "VAT:S", "GL_Entry:1111; Anerkennung; VAT"][ "TotalVAT", "Summary", "GL_VAT", "VAT:S", "GL_Entry:1111;credit;VAT" ],
			"stringValues": [][ ]
		}
	],
	"invoiceType": 0
}

Beispiel CSV Daten #

id,quantity,value,fromdate,todate,productname,partnumber,tenantcode,tenantcodeext,tenantname,userid,username,resellercode,ext,resellercodeext,resellername
000000000000000000000001,1,1.25,2020-04-01T00:00:00.000+00:00,2020-04-30T23:59:59.000+00:00,Essential User,#XDM00001,00000000-0000-00000-000000-000000111,Custom ref 1,Beispielkunde 1,00000000-0000-00000-00000-0000000-00000001,[[email protected]](mailto:[email protected]),00000000-00000-00000-00000-0000000222,Reseller ref 1,ABC Reseller
000000000000000000000003,1,15,2020-04-01T00:00:00.000+00:00,2020-04-30T23:59:59.000+00:00,Real-Time Supervisor,#XDM00010,00000000-0000-00000-000000-000000111,Custom ref 1,Beispielkunde 1,00000000-0000-00000-00000-000000001,[[email protected]](mailto:[email protected]),000000000-00000-00000-00000-000000-000000222,Reseller ref 1,ABC Reseller

Fehler #

Unautorisiert #

Wenn der Token nicht bereitgestellt wird, ungültig oder abgelaufen ist

HTTP/1.1 401 Unautorisiert

Nicht gefunden #

Wenn es keine Rechnungen mit einer passenden Rechnungsnummer gibt.

HTTP/1.1 404 Nicht gefunden
Datum: Do, 06. Feb 2020 12:46:58 GMT
Inhaltstyp: application/json; charset=utf-8
Inhalt-Länge: 95
{
	"error": 404,
	"Nachricht": "Nicht gefunden",
	"status": "fehler",
	"Zeitstempel": "2020-02-06T12:46:58.7669535Z"
}