Metrics

Métricas de iFood Financial con la API

Tu cliente conecta su cuenta de iFood Financial y tu producto consulta 52 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.

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"
      ]
    }
  ]
}
Ejemplo: "Ventas Totales" en octubre, comparado con septiembre.

Más ejemplos de llamadas a iFood Financial

El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).

Gráfico

Ventas por Día

Evolución diaria del número de ventas completadas.

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"
      ]
    }
  ]
}

Tabla

Pagos por Método

Recuento y valor de ventas por método de pago (Tarjeta, Pix, Vale de Comida, 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"
      ]
    }
  ]
}

Número

Valor total de las ventas

Suma del valor de los pedidos completados: (artículos + tarifa de entrega − descuentos financiados por la tienda y por la red). Los subsidios financiados por iFood no se descuentan.

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"
      ]
    }
  ]
}

Números

33 métricas

  • Ventas Totales

    Número de pedidos completados en el período (excluye cancelados y Easy Delivery).

    ifood:total_sales
  • Valor total de las ventas

    Suma del valor de los pedidos completados: (artículos + tarifa de entrega − descuentos financiados por la tienda y por la red). Los subsidios financiados por iFood no se descuentan.

    ifood:total_sales_value
  • Ticket Promedio

    Valor total de ventas dividido por el número de ventas completadas.

    ifood:average_ticket
  • Tasa de Cancelación

    Porcentaje de pedidos cancelados en relación al total de pedidos en el período.

    ifood:cancelled_rate
  • Valor bruto de las ventas

    Valor bruto total de las ventas: suma de las entradas financieras (iFood + tienda) y promociones (iFood + entrega tienda). Todos los valores se muestran como positivos (valor absoluto).

    ifood:recon_gross_sales_value
  • Débito generado por Cancelación Total

    Débito generado por Cancelación Total.

    ifood:recon_debit_cancelamento_total_value
  • Débito generado por Cancelación Parcial

    Débito generado por Cancelación Parcial.

    ifood:recon_debit_cancelamento_parcial_value
  • Crédito generado por Reembolso/Indemnización

    Crédito generado por Reembolso/Indemnización.

    ifood:recon_credit_ressarcimento_value
  • Cancelaciones y reembolsos

    Valor total de reembolsos/indemnizaciones de pedidos cancelados. Valor positivo que representa compensación pagada a la tienda.

    ifood:recon_refund_cancelled_orders_value
  • Valor total (crédito o débito) generado por Ocurrencias de Venta

    Valor total generado por Ocurrencias de Venta.

    ifood:recon_ocorrencia_venda_value
  • Valor total generado por Ocurrencias Independientes

    Valor total generado por Ocurrencias Independientes.

    ifood:recon_ocorrencia_avulsa_value
  • Valor total generado por Procesamiento Manual

    Valor total generado por Procesamiento Manual.

    ifood:recon_processamento_manual_value
  • Entrada financiera (recibido vía iFood)

    Entrada financiera recibida vía iFood.

    ifood:recon_financial_entry_ifood_value
  • Promoción costeada por iFood

    Valor total de promociones costeadas por iFood.

    ifood:recon_promo_ifood_value
  • Tasas cobradas al usuario debidas a iFood

    Valor total de tasas cobradas al usuario debidas a iFood.

    ifood:recon_customer_fee_ifood_value
  • Tasa de Entrega iFood

    Total de tasas de entrega de iFood.

    ifood:recon_delivery_fee_ifood_value
  • Reembolso iFood

    Total de reembolsos de iFood.

    ifood:recon_reembolso_ifood_value
  • Reversión de pedido recibido vía Tienda (VR/VA)

    Valor total de reversiones de pedidos recibidos vía Tienda (VR/VA).

    ifood:recon_estorno_loja_vr_va_value
  • Comisión de iFood

    Total de comisión de iFood cobrada.

    ifood:recon_commission_ifood_value
  • Comisión iFood de entrega propia

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

    ifood:recon_commission_merchant_delivery_value
  • Tasa de Transacción

    Total de tasas de transacción cobradas.

    ifood:recon_transaction_fee_value
  • Tasa transacción iFood beneficios

    Total de tasas de transacción para iFood beneficios.

    ifood:recon_transaction_fee_benefits_value
  • Tasa de Plan de Transferencia

    Total de tasas de plan de transferencia.

    ifood:recon_settlement_plan_fee_value
  • Solicitud de Flete (iFood entrega)

    Total de cobros por solicitudes de flete (iFood entrega).

    ifood:recon_solicitacao_frete_ifood_value
  • Tasa de Servicio Solicitud de Flete (iFood entrega)

    Total de tasas de servicio para solicitud de flete (iFood entrega).

    ifood:recon_solicitacao_frete_service_fee_value
  • Descuento tasa transacción iFood beneficios

    Total de descuentos o reembolsos de tasas de transacción de iFood beneficios.

    ifood:recon_discount_transaction_benefits_value
  • Reembolso tasa adquirente

    Total de reembolsos de tasa de adquirente.

    ifood:recon_acquirer_fee_refund_value
  • Cargo Paquete Anuncios

    Total de cargos por paquetes de anuncios.

    ifood:recon_ads_package_charge_value
  • Entrada financiera (recibido vía Tienda)

    Dinero recibido directamente vía Tienda.

    ifood:recon_financial_entry_loja_value
  • Promoción costeada por la Tienda

    Valor total de promociones costeadas por la Tienda.

    ifood:recon_promo_loja_value
  • Promoción costeada por la Tienda en Delivery

    Valor total de promociones de delivery costeadas por la Tienda.

    ifood:recon_promo_loja_delivery_value
  • Tarifa de servicio iFood cobrada al cliente

    Total value of customer service fees charged by iFood but paid to the merchant (no impact on settlement).

    ifood:recon_customer_fee_loja_value
  • Valor líquido total

    Valor neto a ser transferido a la tienda solo por las ventas.

    ifood:recon_total_sales_value

Gráficos

15 métricas

  • Ventas por Día

    Evolución diaria del número de ventas completadas.

    ifood:sales_over_time
  • Valor de Ventas por Día

    Evolución diaria del valor total de ventas (neto).

    ifood:sales_value_over_time
  • Ticket Promedio por Día

    Evolución diaria del ticket promedio (valor por venta).

    ifood:average_ticket_over_time
  • Horas de Mayor Venta

    Distribución de ventas por rangos de tiempo.

    ifood:best_hours
  • Mejores Días de Venta (Lun–Jue)

    Distribución de ventas por día de la semana considerando solo lunes a jueves.

    ifood:best_days
  • Mejores Días de Venta (Vie–Dom)

    Distribución de ventas por día de la semana considerando solo viernes a domingo.

    ifood:best_days_weekend
  • Métodos de Pago Más Utilizados

    Número de ventas por método de pago (ej.: Crédito, Débito, Pix, Efectivo, Vale de Comida, Billetera Digital).

    ifood:payment_methods
  • Pagos por Responsabilidad

    Ventas y valores agrupados por responsabilidad de pago (ej.: iFood, Comerciante).

    ifood:payments_by_liability
  • Pagos por Tipo

    Ventas y valores por tipo de pago (ej.: En línea, Fuera de línea).

    ifood:payments_by_type
  • Pagos por Marca de Tarjeta

    Ventas y valores por marca de tarjeta (ej.: Visa, MasterCard).

    ifood:payments_by_brand
  • Logística por Producto

    Número de ventas por producto de entrega (ej.: Entrega Propia, Entrega iFood, Entrega Fácil).

    ifood:logistics_by_product
  • Logística por Proveedor

    Número de ventas por proveedor logístico (ej.: iFood, Comerciante).

    ifood:logistics_by_provider
  • Cancelaciones por Origen

    Recuento de cancelaciones por origen (ej.: Automático, Cliente, Comerciante, Sistema).

    ifood:cancellations_by_origin
  • Cancelaciones por Etapa

    Recuento de cancelaciones por etapa del pedido (ej.: Pre-Confirmado, Confirmado, Despachado, Concluido).

    ifood:cancellations_by_stage
  • Cancelaciones por Día

    Evolución diaria del número de pedidos cancelados.

    ifood:cancelled_over_time

Tablas

4 métricas

  • Pagos por Método

    Recuento y valor de ventas por método de pago (Tarjeta, Pix, Vale de Comida, etc.).

    ifood:payments_by_method
  • Cancelaciones por Código

    Recuento de pedidos cancelados agrupados por código de cancelación de iFood.

    ifood:cancellations_by_code
  • Reembolsos y Contracargos

    Recuento y valor de reembolsos y contracargos asociados con pedidos (ej.: Reembolso, Contracargo).

    ifood:refunds_and_chargebacks
  • Tiempos Promedio (SLA)

    SLA representa objetivos de tiempo de nivel de servicio. Este widget muestra los minutos promedio transcurridos entre las etapas clave del pedido de iFood: Realizado→Confirmado (tiempo de confirmación del comerciante), Confirmado→Despachado (preparación + entrega al repartidor) y Realizado→Concluido (tiempo total de cumplimiento). Valores más bajos indican operaciones más rápidas.

    ifood:avg_times

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.