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"
      ]
    }
  ]
}
Exemple : « Ventes Totales » en octobre, comparé à septembre.

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_sales
  • 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.

    ifood:total_sales_value
  • Ticket Moyen

    Valeur totale des ventes divisée par le nombre de ventes terminées.

    ifood:average_ticket
  • Taux d'Annulation

    Pourcentage de commandes annulées par rapport au total des commandes dans la période.

    ifood:cancelled_rate
  • Valeur 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_value
  • Débit généré par Annulation Totale

    Débit généré par Annulation Totale.

    ifood:recon_debit_cancelamento_total_value
  • Débit généré par Annulation Partielle

    Débit généré par Annulation Partielle.

    ifood:recon_debit_cancelamento_parcial_value
  • Crédit généré par Remboursement/Indemnisation

    Crédit généré par Remboursement/Indemnisation.

    ifood:recon_credit_ressarcimento_value
  • Annulations 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_value
  • Valeur 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_value
  • Valeur totale générée par Occurrences Autonomes

    Valeur totale générée par Occurrences Autonomes.

    ifood:recon_ocorrencia_avulsa_value
  • Valeur totale générée par Traitement Manuel

    Valeur totale générée par Traitement Manuel.

    ifood:recon_processamento_manual_value
  • Entrée financière (reçue via iFood)

    Entrée financière reçue via iFood.

    ifood:recon_financial_entry_ifood_value
  • Promotion financée par iFood

    Valeur totale des promotions financées par iFood.

    ifood:recon_promo_ifood_value
  • Frais facturés à l'utilisateur dus à iFood

    Valeur totale des frais facturés à l'utilisateur dus à iFood.

    ifood:recon_customer_fee_ifood_value
  • Frais de Livraison iFood

    Total des frais de livraison iFood.

    ifood:recon_delivery_fee_ifood_value
  • Remboursement iFood

    Total des remboursements iFood.

    ifood:recon_reembolso_ifood_value
  • Annulation 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_value
  • Commission iFood

    Total de commission iFood facturée.

    ifood:recon_commission_ifood_value
  • Commission iFood de livraison propre

    Total iFood commission charged for orders with merchant's own delivery (not iFood logistics).

    ifood:recon_commission_merchant_delivery_value
  • Frais de Transaction

    Total des frais de transaction facturés.

    ifood:recon_transaction_fee_value
  • Frais transaction iFood bénéfices

    Total des frais de transaction pour iFood bénéfices.

    ifood:recon_transaction_fee_benefits_value
  • Frais de Plan de Transfert

    Total des frais de plan de transfert.

    ifood:recon_settlement_plan_fee_value
  • Demande de Fret (iFood livraison)

    Total des charges pour demandes de fret (iFood livraison).

    ifood:recon_solicitacao_frete_ifood_value
  • Frais de Service Demande de Fret (iFood livraison)

    Total des frais de service pour demande de fret (iFood livraison).

    ifood:recon_solicitacao_frete_service_fee_value
  • Remise frais transaction iFood bénéfices

    Total des remises ou remboursements des frais de transaction iFood bénéfices.

    ifood:recon_discount_transaction_benefits_value
  • Remboursement frais acquéreur

    Total des remboursements de frais d'acquéreur.

    ifood:recon_acquirer_fee_refund_value
  • Charge Paquet Annonces

    Total des charges pour paquets d'annonces.

    ifood:recon_ads_package_charge_value
  • Entrée financière (reçue via Magasin)

    Argent reçu directement via le Magasin.

    ifood:recon_financial_entry_loja_value
  • Promotion financée par le Magasin

    Valeur totale des promotions financées par le Magasin.

    ifood:recon_promo_loja_value
  • Promotion financée par le Magasin en Livraison

    Valeur totale des promotions de livraison financées par le Magasin.

    ifood:recon_promo_loja_delivery_value
  • Frais 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_value
  • Valeur 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_time
  • Valeur des Ventes par Jour

    Évolution quotidienne de la valeur totale des ventes (nette).

    ifood:sales_value_over_time
  • Ticket Moyen par Jour

    Évolution quotidienne du ticket moyen (valeur par vente).

    ifood:average_ticket_over_time
  • Heures de Meilleures Ventes

    Distribution des ventes par tranches horaires.

    ifood:best_hours
  • Meilleurs Jours de Vente (Lun–Jeu)

    Distribution des ventes par jour de la semaine en considérant seulement lundi à jeudi.

    ifood:best_days
  • Meilleurs Jours de Vente (Ven–Dim)

    Distribution des ventes par jour de la semaine en considérant seulement vendredi à dimanche.

    ifood:best_days_weekend
  • Mé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_methods
  • Paiements par Responsabilité

    Ventes et valeurs groupées par responsabilité de paiement (ex. : iFood, Commerçant).

    ifood:payments_by_liability
  • Paiements par Type

    Ventes et valeurs par type de paiement (ex. : En ligne, Hors ligne).

    ifood:payments_by_type
  • Paiements par Marque de Carte

    Ventes et valeurs par marque de carte (ex. : Visa, MasterCard).

    ifood:payments_by_brand
  • Logistique par Produit

    Nombre de ventes par produit de livraison (ex. : Livraison Propre, Livraison iFood, Livraison Facile).

    ifood:logistics_by_product
  • Logistique par Fournisseur

    Nombre de ventes par fournisseur logistique (ex. : iFood, Commerçant).

    ifood:logistics_by_provider
  • Annulations par Origine

    Nombre d'annulations par origine (ex. : Automatique, Client, Commerçant, Système).

    ifood:cancellations_by_origin
  • Annulations par Étape

    Nombre d'annulations par étape de commande (ex. : Pré-Confirmé, Confirmé, Expédié, Conclu).

    ifood:cancellations_by_stage
  • Annulations 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_method
  • Annulations par Code

    Nombre de commandes annulées groupées par code d'annulation iFood.

    ifood:cancellations_by_code
  • Remboursements et Rétrofacturations

    Nombre et valeur des remboursements et rétrofacturations associés aux commandes (ex. : Remboursement, Rétrofacturation).

    ifood:refunds_and_chargebacks
  • Temps 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.