API FlavosoGuidesRapports
Rapports
Chiffre d'affaires par jour, semaine ou mois et ventes par plat, selon les mêmes règles que les chiffres du tableau de bord.
Rapport de chiffre d'affaires
GET /reports/sales nécessite reports:read et accepte ces paramètres :
| Paramètre | Signification |
|---|---|
from, to | Jours calendaires (YYYY-MM-DD) dans l'heure locale de l'établissement, 366 jours au maximum. Pour octobre : from=2026-10-01&to=2026-10-31. |
group_by | day, week, month ou total. |
La réponse indique currency, timezone, la période, totals sur l'ensemble et buckets par tranche. Chaque tranche a les mêmes champs :
| Champ | Signification |
|---|---|
period_start, period_end | La tranche. |
orders | Nombre de commandes prises en compte. |
gross, net, tax | Chiffre d'affaires TTC et HT, et la TVA, en centimes. |
tips | Pourboires. Pas du chiffre d'affaires, indiqués séparément. |
delivery_fees, service_fees | Frais de livraison et de service. |
discounts | Remises, par exemple celles de la carte de fidélité. |
by_tax_rate | Par taux de TVA : rate_bps, gross, net, tax ; une part sans taux enregistré avec rate_bps: null et net et tax à null. |
by_payment_method | Ventilé par online et on_site. |
by_type | Ventilé par pickup, delivery, dine_in. |
cancelled | Commandes annulées : nombre et montant TTC, séparément. |
La forme exacte de chaque champ figure dans la référence.
# 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"Ce qui compte
Le calcul suit les mêmes règles que les chiffres du tableau de bord, avec des sommes calculées dans la base de données et non additionnées à partir de listes. Une commande en ligne non payée ne compte jamais ; les commandes annulées ne figurent pas dans le chiffre d'affaires mais séparément sous cancelled. Un jour est le jour calendaire de l'établissement dans son fuseau horaire.
Ventes par plat
GET /reports/products?from=…&to=…&limit=… renvoie les plats les plus vendus d'une période, triés par quantité, avec quantité et montant TTC : { "object": "list", "data": [{ "product_id", "name", "quantity", "gross" }] }. limit accepte de 1 à 100 (25 par défaut) ; il n'y a pas de pagination, has_more indique seulement s'il y a d'autres plats. Le calcul suit celui du chiffre d'affaires, sans les annulations. Un plat supprimé figure avec product_id: null et son nom tiré des commandes.
# 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"Rapprochement avec une caisse ou la comptabilité
- Une fois par jour, après minuit dans le fuseau horaire de l'établissement, récupérer la veille.
- Comparer le TTC, la TVA par taux et les pourboires avec votre propre clôture pour le canal Flavoso.
- Les écarts viennent le plus souvent de commandes annulées après leur prise en charge, ou de pourboires enregistrés comme chiffre d'affaires.
- Pour la comptabilité :
group_by=monthetby_tax_ratedonnent les chiffres par taux de TVA.
Une question reste ouverte ? Écrivez à support@flavoso.com en indiquant l'identifiant de X-Request-Id. Il nous permet de retrouver votre requête dans le journal.