Analytics-ExportAnalytics Export

Store-Kennzahlen, Verkaufsdaten und Kassenbons per API abrufen.

Retrieve store KPIs, sales data and receipts 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

Belegdaten mit MwSt-Aufschlüsselung und Transaktionsnummer exportieren.Export receipt data with VAT breakdown and transaction number.

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 Belegdaten 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 receipt data 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 }

Fiskalisierung: Das Feld tse ist im Datenmodell vorhanden, wird derzeit aber nicht von einer zertifizierten Technischen Sicherheitseinrichtung befüllt. In der Sandbox liefert es feste Platzhalterwerte. Die Anbindung einer TSE ist geplant. Verwende dieses Feld nicht als Nachweis gegenüber dem Finanzamt. Fiscalisation: The tse field exists in the data model but is currently not populated by a certified Technical Security Device. In the sandbox it returns fixed placeholder values. A TSE integration is planned. Do not use this field as evidence towards tax authorities.

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

Gibt vollständige Kassenbondaten mit MwSt-Aufschlüsselung und TSE-Signatur zurück. Die Fiskalisierung ist noch nicht angebunden, siehe Hinweis zur Fiskalisierung.

Returns complete receipt data with VAT breakdown and TSE signature. Fiscalisation is not connected yet, see the note on fiscalisation.

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 }