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"
]
}
]
}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_salesValor 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_valueTicket Promedio
Valor total de ventas dividido por el número de ventas completadas.
ifood:average_ticketTasa de Cancelación
Porcentaje de pedidos cancelados en relación al total de pedidos en el período.
ifood:cancelled_rateValor 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_valueDébito generado por Cancelación Total
Débito generado por Cancelación Total.
ifood:recon_debit_cancelamento_total_valueDébito generado por Cancelación Parcial
Débito generado por Cancelación Parcial.
ifood:recon_debit_cancelamento_parcial_valueCrédito generado por Reembolso/Indemnización
Crédito generado por Reembolso/Indemnización.
ifood:recon_credit_ressarcimento_valueCancelaciones 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_valueValor total (crédito o débito) generado por Ocurrencias de Venta
Valor total generado por Ocurrencias de Venta.
ifood:recon_ocorrencia_venda_valueValor total generado por Ocurrencias Independientes
Valor total generado por Ocurrencias Independientes.
ifood:recon_ocorrencia_avulsa_valueValor total generado por Procesamiento Manual
Valor total generado por Procesamiento Manual.
ifood:recon_processamento_manual_valueEntrada financiera (recibido vía iFood)
Entrada financiera recibida vía iFood.
ifood:recon_financial_entry_ifood_valuePromoción costeada por iFood
Valor total de promociones costeadas por iFood.
ifood:recon_promo_ifood_valueTasas cobradas al usuario debidas a iFood
Valor total de tasas cobradas al usuario debidas a iFood.
ifood:recon_customer_fee_ifood_valueTasa de Entrega iFood
Total de tasas de entrega de iFood.
ifood:recon_delivery_fee_ifood_valueReembolso iFood
Total de reembolsos de iFood.
ifood:recon_reembolso_ifood_valueReversió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_valueComisión de iFood
Total de comisión de iFood cobrada.
ifood:recon_commission_ifood_valueComisión iFood de entrega propia
Total iFood commission charged for orders with merchant's own delivery (not iFood logistics).
ifood:recon_commission_merchant_delivery_valueTasa de Transacción
Total de tasas de transacción cobradas.
ifood:recon_transaction_fee_valueTasa transacción iFood beneficios
Total de tasas de transacción para iFood beneficios.
ifood:recon_transaction_fee_benefits_valueTasa de Plan de Transferencia
Total de tasas de plan de transferencia.
ifood:recon_settlement_plan_fee_valueSolicitud de Flete (iFood entrega)
Total de cobros por solicitudes de flete (iFood entrega).
ifood:recon_solicitacao_frete_ifood_valueTasa de Servicio Solicitud de Flete (iFood entrega)
Total de tasas de servicio para solicitud de flete (iFood entrega).
ifood:recon_solicitacao_frete_service_fee_valueDescuento tasa transacción iFood beneficios
Total de descuentos o reembolsos de tasas de transacción de iFood beneficios.
ifood:recon_discount_transaction_benefits_valueReembolso tasa adquirente
Total de reembolsos de tasa de adquirente.
ifood:recon_acquirer_fee_refund_valueCargo Paquete Anuncios
Total de cargos por paquetes de anuncios.
ifood:recon_ads_package_charge_valueEntrada financiera (recibido vía Tienda)
Dinero recibido directamente vía Tienda.
ifood:recon_financial_entry_loja_valuePromoción costeada por la Tienda
Valor total de promociones costeadas por la Tienda.
ifood:recon_promo_loja_valuePromoción costeada por la Tienda en Delivery
Valor total de promociones de delivery costeadas por la Tienda.
ifood:recon_promo_loja_delivery_valueTarifa 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_valueValor 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_timeValor de Ventas por Día
Evolución diaria del valor total de ventas (neto).
ifood:sales_value_over_timeTicket Promedio por Día
Evolución diaria del ticket promedio (valor por venta).
ifood:average_ticket_over_timeHoras de Mayor Venta
Distribución de ventas por rangos de tiempo.
ifood:best_hoursMejores Días de Venta (Lun–Jue)
Distribución de ventas por día de la semana considerando solo lunes a jueves.
ifood:best_daysMejores Días de Venta (Vie–Dom)
Distribución de ventas por día de la semana considerando solo viernes a domingo.
ifood:best_days_weekendMé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_methodsPagos por Responsabilidad
Ventas y valores agrupados por responsabilidad de pago (ej.: iFood, Comerciante).
ifood:payments_by_liabilityPagos por Tipo
Ventas y valores por tipo de pago (ej.: En línea, Fuera de línea).
ifood:payments_by_typePagos por Marca de Tarjeta
Ventas y valores por marca de tarjeta (ej.: Visa, MasterCard).
ifood:payments_by_brandLogística por Producto
Número de ventas por producto de entrega (ej.: Entrega Propia, Entrega iFood, Entrega Fácil).
ifood:logistics_by_productLogística por Proveedor
Número de ventas por proveedor logístico (ej.: iFood, Comerciante).
ifood:logistics_by_providerCancelaciones por Origen
Recuento de cancelaciones por origen (ej.: Automático, Cliente, Comerciante, Sistema).
ifood:cancellations_by_originCancelaciones por Etapa
Recuento de cancelaciones por etapa del pedido (ej.: Pre-Confirmado, Confirmado, Despachado, Concluido).
ifood:cancellations_by_stageCancelaciones 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_methodCancelaciones por Código
Recuento de pedidos cancelados agrupados por código de cancelación de iFood.
ifood:cancellations_by_codeReembolsos y Contracargos
Recuento y valor de reembolsos y contracargos asociados con pedidos (ej.: Reembolso, Contracargo).
ifood:refunds_and_chargebacksTiempos 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.
