KonsoleZur Website

Flavoso APILeitfädenBerichte

Berichte

Umsätze je Tag, Woche oder Monat und Verkaufszahlen je Gericht, mit denselben Regeln wie die Zahlen im Dashboard.

Umsatzbericht

GET /reports/sales braucht reports:read und nimmt diese Parameter:

ParameterBedeutung
from, toKalendertage (YYYY-MM-DD) in der Ortszeit des Betriebs, höchstens 366 Tage. Für Oktober: from=2026-10-01&to=2026-10-31.
group_byday, week, month oder total.

Die Antwort nennt currency, timezone, den Zeitraum, totals über alles und buckets je Zeitabschnitt. Jeder Abschnitt hat dieselben Felder:

FeldBedeutung
period_start, period_endDer Abschnitt.
ordersAnzahl der Bestellungen, die zählen.
gross, net, taxUmsatz brutto und netto und die Steuer, in Cent.
tipsTrinkgeld. Kein Umsatz, getrennt ausgewiesen.
delivery_fees, service_feesLiefer- und Servicegebühren.
discountsRabatte, etwa aus der Stempelkarte.
by_tax_rateJe Steuersatz rate_bps, gross, net, tax; ein Anteil ohne hinterlegten Satz mit rate_bps: null und net und tax als null.
by_payment_methodAufgeteilt nach online und on_site.
by_typeAufgeteilt nach pickup, delivery, dine_in.
cancelledStornierte Bestellungen: Anzahl und Brutto, getrennt.

Die genaue Form jedes Feldes steht in der Referenz.

# October by day, in the restaurant's local time
curl "https://api.flavoso.com/v1/reports/sales?from=2026-10-01&to=2026-10-31&group_by=day" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# The whole year as one total (at most 366 days per request)
curl "https://api.flavoso.com/v1/reports/sales?from=2026-01-01&to=2026-12-31&group_by=total" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Was zählt

Gezählt wird nach denselben Regeln wie die Zahlen im Dashboard, und in der Datenbank summiert, nicht aus Listen zusammengerechnet. Eine unbezahlte Online-Bestellung zählt nie; stornierte Bestellungen stehen nicht im Umsatz, sondern getrennt unter cancelled. Ein Tag ist der Kalendertag des Betriebs in seiner Zeitzone.

Verkaufszahlen je Gericht

GET /reports/products?from=…&to=…&limit=… liefert die meistverkauften Gerichte eines Zeitraums, nach Menge sortiert, mit Menge und Brutto: { "object": "list", "data": [{ "product_id", "name", "quantity", "gross" }] }. limit nimmt 1 bis 100 (Vorgabe 25); geblättert wird nicht, has_more sagt nur, ob es weitere Gerichte gibt. Gezählt wird wie der Umsatz, ohne Stornos. Ein gelöschtes Gericht steht mit product_id: null und seinem Namen aus den Bestellungen da.

# The 20 best-selling dishes of October
curl "https://api.flavoso.com/v1/reports/products?from=2026-10-01&to=2026-10-31&limit=20" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Abgleich mit der Kasse oder Buchhaltung

  • Einmal am Tag, nach Mitternacht in der Zeitzone des Betriebs, den Vortag holen.
  • Brutto, Steuer je Satz und Trinkgeld mit dem eigenen Abschluss für den Kanal Flavoso vergleichen.
  • Unterschiede entstehen meist durch Bestellungen, die nach der Übernahme storniert wurden, oder durch Trinkgeld, das als Umsatz gebucht wurde.
  • Für eine Buchhaltung: group_by=month und by_tax_rate ergeben die Zahlen je Steuersatz.

Etwas unklar geblieben? Schreib an support@flavoso.com und nenne die Kennung aus X-Request-Id. Damit finden wir deine Anfrage im Protokoll.