Metrics
Métriques iFood Financial via l'API
Votre client connecte son compte iFood Financial et votre produit interroge 52 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "ifood:total_sales",
"component": "number_v1",
"metrics": [
"total_sales"
],
"dimensions": [
"sales"
]
}
]
}Plus d'exemples d'appels iFood Financial
Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).
Graphique
Ventes par Jour
Évolution quotidienne du nombre de ventes terminées.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "ifood:sales_over_time",
"component": "chart_v1",
"metrics": [
"total_sales"
],
"dimensions": [
"date"
]
}
]
}Tableau
Paiements par Méthode
Nombre et valeur des ventes par méthode de paiement (Carte, Pix, Ticket Restaurant, etc.).
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "ifood:payments_by_method",
"component": "datatable_v1",
"metrics": [
"total_sales",
"total_sales_value"
],
"dimensions": [
"payment_method"
]
}
]
}Chiffre
Valeur totale des ventes
Somme de la valeur des commandes terminées : (articles + frais de livraison − remises financées par le commerçant et par le réseau). Les subventions financées par iFood ne sont pas déduites.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "ifood:total_sales_value",
"component": "number_v1",
"metrics": [
"total_sales_value"
],
"dimensions": [
"sales"
]
}
]
}Chiffres
33 métriques
Ventes Totales
Nombre de commandes terminées dans la période (exclut les annulées et Easy Delivery).
ifood:total_salesValeur totale des ventes
Somme de la valeur des commandes terminées : (articles + frais de livraison − remises financées par le commerçant et par le réseau). Les subventions financées par iFood ne sont pas déduites.
ifood:total_sales_valueTicket Moyen
Valeur totale des ventes divisée par le nombre de ventes terminées.
ifood:average_ticketTaux d'Annulation
Pourcentage de commandes annulées par rapport au total des commandes dans la période.
ifood:cancelled_rateValeur brute des ventes
Valeur brute totale des ventes : somme des entrées financières (iFood + magasin) et promotions (iFood + livraison magasin). Toutes les valeurs sont affichées comme positives (valeur absolue).
ifood:recon_gross_sales_valueDébit généré par Annulation Totale
Débit généré par Annulation Totale.
ifood:recon_debit_cancelamento_total_valueDébit généré par Annulation Partielle
Débit généré par Annulation Partielle.
ifood:recon_debit_cancelamento_parcial_valueCrédit généré par Remboursement/Indemnisation
Crédit généré par Remboursement/Indemnisation.
ifood:recon_credit_ressarcimento_valueAnnulations et remboursements
Valeur totale des remboursements/indemnisations des commandes annulées. Valeur positive représentant la compensation payée au magasin.
ifood:recon_refund_cancelled_orders_valueValeur totale (crédit ou débit) générée par les Occurrences de Vente
Valeur totale générée par les Occurrences de Vente.
ifood:recon_ocorrencia_venda_valueValeur totale générée par Occurrences Autonomes
Valeur totale générée par Occurrences Autonomes.
ifood:recon_ocorrencia_avulsa_valueValeur totale générée par Traitement Manuel
Valeur totale générée par Traitement Manuel.
ifood:recon_processamento_manual_valueEntrée financière (reçue via iFood)
Entrée financière reçue via iFood.
ifood:recon_financial_entry_ifood_valuePromotion financée par iFood
Valeur totale des promotions financées par iFood.
ifood:recon_promo_ifood_valueFrais facturés à l'utilisateur dus à iFood
Valeur totale des frais facturés à l'utilisateur dus à iFood.
ifood:recon_customer_fee_ifood_valueFrais de Livraison iFood
Total des frais de livraison iFood.
ifood:recon_delivery_fee_ifood_valueRemboursement iFood
Total des remboursements iFood.
ifood:recon_reembolso_ifood_valueAnnulation de commande reçue via Magasin (VR/VA)
Valeur totale des annulations de commandes reçues via Magasin (VR/VA).
ifood:recon_estorno_loja_vr_va_valueCommission iFood
Total de commission iFood facturée.
ifood:recon_commission_ifood_valueCommission iFood de livraison propre
Total iFood commission charged for orders with merchant's own delivery (not iFood logistics).
ifood:recon_commission_merchant_delivery_valueFrais de Transaction
Total des frais de transaction facturés.
ifood:recon_transaction_fee_valueFrais transaction iFood bénéfices
Total des frais de transaction pour iFood bénéfices.
ifood:recon_transaction_fee_benefits_valueFrais de Plan de Transfert
Total des frais de plan de transfert.
ifood:recon_settlement_plan_fee_valueDemande de Fret (iFood livraison)
Total des charges pour demandes de fret (iFood livraison).
ifood:recon_solicitacao_frete_ifood_valueFrais de Service Demande de Fret (iFood livraison)
Total des frais de service pour demande de fret (iFood livraison).
ifood:recon_solicitacao_frete_service_fee_valueRemise frais transaction iFood bénéfices
Total des remises ou remboursements des frais de transaction iFood bénéfices.
ifood:recon_discount_transaction_benefits_valueRemboursement frais acquéreur
Total des remboursements de frais d'acquéreur.
ifood:recon_acquirer_fee_refund_valueCharge Paquet Annonces
Total des charges pour paquets d'annonces.
ifood:recon_ads_package_charge_valueEntrée financière (reçue via Magasin)
Argent reçu directement via le Magasin.
ifood:recon_financial_entry_loja_valuePromotion financée par le Magasin
Valeur totale des promotions financées par le Magasin.
ifood:recon_promo_loja_valuePromotion financée par le Magasin en Livraison
Valeur totale des promotions de livraison financées par le Magasin.
ifood:recon_promo_loja_delivery_valueFrais de service iFood facturés au client
Total value of customer service fees charged by iFood but paid to the merchant (no impact on settlement).
ifood:recon_customer_fee_loja_valueValeur nette totale
Valeur nette à transférer au magasin uniquement pour les ventes.
ifood:recon_total_sales_value
Graphiques
15 métriques
Ventes par Jour
Évolution quotidienne du nombre de ventes terminées.
ifood:sales_over_timeValeur des Ventes par Jour
Évolution quotidienne de la valeur totale des ventes (nette).
ifood:sales_value_over_timeTicket Moyen par Jour
Évolution quotidienne du ticket moyen (valeur par vente).
ifood:average_ticket_over_timeHeures de Meilleures Ventes
Distribution des ventes par tranches horaires.
ifood:best_hoursMeilleurs Jours de Vente (Lun–Jeu)
Distribution des ventes par jour de la semaine en considérant seulement lundi à jeudi.
ifood:best_daysMeilleurs Jours de Vente (Ven–Dim)
Distribution des ventes par jour de la semaine en considérant seulement vendredi à dimanche.
ifood:best_days_weekendMéthodes de Paiement les Plus Utilisées
Nombre de ventes par méthode de paiement (ex. : Crédit, Débit, Pix, Espèces, Ticket Restaurant, Portefeuille Numérique).
ifood:payment_methodsPaiements par Responsabilité
Ventes et valeurs groupées par responsabilité de paiement (ex. : iFood, Commerçant).
ifood:payments_by_liabilityPaiements par Type
Ventes et valeurs par type de paiement (ex. : En ligne, Hors ligne).
ifood:payments_by_typePaiements par Marque de Carte
Ventes et valeurs par marque de carte (ex. : Visa, MasterCard).
ifood:payments_by_brandLogistique par Produit
Nombre de ventes par produit de livraison (ex. : Livraison Propre, Livraison iFood, Livraison Facile).
ifood:logistics_by_productLogistique par Fournisseur
Nombre de ventes par fournisseur logistique (ex. : iFood, Commerçant).
ifood:logistics_by_providerAnnulations par Origine
Nombre d'annulations par origine (ex. : Automatique, Client, Commerçant, Système).
ifood:cancellations_by_originAnnulations par Étape
Nombre d'annulations par étape de commande (ex. : Pré-Confirmé, Confirmé, Expédié, Conclu).
ifood:cancellations_by_stageAnnulations par Jour
Évolution quotidienne du nombre de commandes annulées.
ifood:cancelled_over_time
Tableaux
4 métriques
Paiements par Méthode
Nombre et valeur des ventes par méthode de paiement (Carte, Pix, Ticket Restaurant, etc.).
ifood:payments_by_methodAnnulations par Code
Nombre de commandes annulées groupées par code d'annulation iFood.
ifood:cancellations_by_codeRemboursements et Rétrofacturations
Nombre et valeur des remboursements et rétrofacturations associés aux commandes (ex. : Remboursement, Rétrofacturation).
ifood:refunds_and_chargebacksTemps Moyens (SLA)
SLA représente les objectifs de temps de niveau de service. Ce widget affiche les minutes moyennes écoulées entre les étapes clés de commande iFood : Passée→Confirmée (temps de confirmation du commerçant), Confirmée→Expédiée (préparation + remise au livreur) et Passée→Conclue (temps total d'exécution). Des valeurs plus faibles indiquent des opérations plus rapides.
ifood:avg_times
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
