Analytics-ExportAnalytics Export

Store-Kennzahlen, Verkaufsdaten, Kassenbons und TSE-Signaturen per API abrufen.

Retrieve store KPIs, sales data, receipts and TSE signatures via API.

GROW oder PRIME erforderlich. Vollständige Analytics-Dashboards und getAnalytics sind exklusiv im PRIME-Paket enthalten. GROW or PRIME required. Full analytics dashboards and getAnalytics are exclusive to PRIME.

AnwendungsfälleUse Cases

POS-Rücksync

BEEP!-Transaktionen ins Kassensystem zurückschreiben.Write BEEP! transactions back to your POS. → pushToPOS

BuchhaltungAccounting

TSE-signierte Belege für die Steuererklärung exportieren.Export TSE-signed receipts for tax filing.

Custom Dashboard

Eigene Analytics-Oberfläche mit Rohdaten aufbauen.Build your own analytics UI with raw data.

ERP-Integration

Umsatzdaten automatisch ins Warenwirtschaftssystem übertragen.Transfer sales data automatically to your ERP system.

POST /api/v1/getAnalytics Store-Kennzahlen abrufenRetrieve store KPIs PRIME

Gibt voraggregierte Store-Kennzahlen zurück: Umsatz, Transaktionen, Conversion Rate, durchschnittlicher Warenkorb und Scan & Go Nutzung. Ideal für Dashboards und automatisierte Reports. Für Rohdaten und TSE-Belege siehe exportSalesData und exportReceiptData.

Returns pre-aggregated store KPIs: revenue, transactions, conversion rate, average basket size and Scan & Go usage. Ideal for dashboards and automated reports. For raw data and TSE receipts see exportSalesData and exportReceiptData.

Parameter	Typ	Pflicht	BeschreibungDescription
storeId	string	required	Store-IDStore ID
from	string	required	Startdatum (ISO 8601 oder YYYY-MM-DD)Start date (ISO 8601 or YYYY-MM-DD)
to	string	required	EnddatumEnd date
granularity	string	optional	`"day"` (default), `"week"`, `"month"`

Response: 200 OK

{ "success": true, "data": { "storeId": "store_abc123", "period": { "from": "2026-02-01", "to": "2026-02-28" }, "kpis": { "totalRevenue": 4821.30, "totalTransactions": 634, "avgBasketSize": 7.60, "conversionRate": 0.73, "scanGoCheckouts": 512, "loyaltyRedemptions": 89 }, "series": [ { "date": "2026-02-01", "revenue": 162.40, "transactions": 21 } ] }, "_sandbox": true }

POST /api/v1/exportSalesData Verkaufsdaten exportierenExport sales data GROW

Exportiert aggregierte Verkaufsdaten für einen Zeitraum: Umsatz, Transaktionen und Top-Produkte.

Exports aggregated sales data for a time period: revenue, transactions and top products.

Parameter	Typ	Pflicht	BeschreibungDescription
from	string	required	Startdatum (ISO 8601 oder YYYY-MM-DD)Start date (ISO 8601 or YYYY-MM-DD)
to	string	required	EnddatumEnd date
format	string	optional	`"json"` (default) oderor `"csv"`

Die storeId wird automatisch aus dem API-Key ermittelt. Kein separater Parameter nötig.The storeId is derived automatically from the API key. No separate parameter needed.

Response: 200 OK

{ "success": true, "data": { "period": { "from": "2026-02-01", "to": "2026-02-27" }, "storeId": "store_abc123", "summary": { "totalRevenue": 1847.93, "totalTransactions": 312, "avgBasketSize": 5.92, "topProducts": [ { "name": "Bio-Vollmilch", "sold": 89, "revenue": 132.61 } ] }, "transactions": [ { "id": "pur_sandbox_001", "timestamp": "2026-02-27T14:30:00.000Z", "total": 3.57, "items": 3, "paymentMethod": "card", "receiptNumber": "REC-001", "tseSignature": "sandbox_tse_sig_base64" } ] }, "_sandbox": true }

POST /api/v1/exportReceiptData Kassenbon + TSE abrufenFetch receipt + TSE GROW

Gibt vollständige Kassenbondaten mit MwSt-Aufschlüsselung und TSE-Signatur zurück. TSE-konform nach KassenSichV.

Returns complete receipt data with VAT breakdown and TSE signature. TSE-compliant per KassenSichV.

Parameter	Typ	Pflicht	BeschreibungDescription
receiptId	string	required	Kassenbon-ID (aus Transaktion oder Webhook)Receipt ID (from transaction or webhook)

Response: 200 OK

{ "success": true, "data": { "receiptId": "rec_001", "receiptNumber": "REC-SANDBOX-001", "storeId": "store_abc123", "total": 3.57, "items": [ { "name": "Bio-Vollmilch", "quantity": 1, "price": 1.49, "taxRate": 7 } ], "taxBreakdown": [ { "rate": 7, "net": 2.22, "tax": 0.16, "gross": 2.38 }, { "rate": 19, "net": 1.00, "tax": 0.19, "gross": 1.19 } ], "tse": { "serialNumber": "SANDBOX-TSE-001", "signature": "sandbox_tse_signature_base64", "transactionNumber": 42, "signatureCounter": 1337, "startTime": "2026-02-27T14:28:00.000Z", "endTime": "2026-02-27T14:29:00.000Z" } }, "_sandbox": true }