Buscar na documentação
ctrl+4K
Módulos
Authentication
Merchant
Catalog
Order
Events
Logistics
Shipping
Review
Financial
Soluções

API Reconciliation

O arquivo de conciliação é disponibilizado no formato CSV compactado (.gz), com delimitador ";" e pode ser baixado através de um link retornado pela API de Conciliação.Este link tem tempo de expiração e um novo link é gerado a cada consulta. A API retorna também totalizadores de pedidos e linhas para auxiliar na validação do conteúdo do arquivo.Os lançamentos financeiros são agrupados em arquivos individuais por competência (mês e ano).
A cada semana, o arquivo mensal existente é atualizado, sendo incrementado com os lançamentos do período semanal anterior.O período semanal compreende de segunda-feira à domingo e a apuração ocorre na segunda-feira seguinte ao término do período. O arquivo é atualizado com o incremento deste período sete dias após a apuração, na próxima segunda-feira.Considere o seguinte exemplo:
  • Período de apuração: 01/07/2024 à 07/07/2024 (segunda-feira à domingo)
  • Apuração: 08/07/2024 (segunda-feira)
  • Atualização do arquivo da competência de Julho, com incremento referente à essa apuração, ocorre em 15/07/2024 (segunda-feira)
  • Após este incremento, o arquivo da competência de Julho ainda estará incompleto, pois continuará recebendo incrementos nas semanas seguintes.
  • Após os incrementos semanais seguintes, o arquivo da competência de Julho possuirá todos os lançamentos financeiros contidos no período de 01/07/2024 à 31/07/2024.
Importante: o arquivo vai incorporando mais dados a cada atualização semanal, mas os dados já contidos no arquivo são imutáveis, uma vez que ele é incrementado somente após a apuração, e nenhum novo lançamento financeiro pode incidir em um período após seu encerramento e apuração semanal.Caso dentro de uma semana de apuração haja quebra de mês, cada lançamento financeiro contido dentro desta semana irá ser incrementado no arquivo da sua respectiva competência.Considere o seguinte exemplo:
  • Período de apuração: 29/07/2024 à 04/08/2024 (segunda-feira à domingo)
  • Apuração: 05/08/2024 (segunda-feira)
  • Atualização do arquivo da competência de Julho, com incremento referente ao dias 29/07 à 31/07, ocorre em 12/08/2024 (segunda-feira)
  • Atualização do arquivo da competência de Agosto, com incremento referente ao dias 01/08 à 04/08, ocorre em em: 12/08/2024 (segunda-feira)
  • Após este incremento, o arquivo da competência de Julho estará completo, possuindo todos os lançamentos financeiros contidos no período de 01/07/2024 à 31/07/2024.
  • Após este incremento, o arquivo da competência de Agosto ainda estará incompleto, pois continuará recebendo incrementos nas semanas seguintes.
  • Após os incrementos semanais seguintes, o arquivo da competência de Agosto possuirá todos os lançamentos financeiros contidos no período de 01/08/2024 à 30/08/2024.
O campo 'impacto_no_repasse' segrega os lançamentos financeiros em dois principais grupos nos relatórios de conciliação financeira do iFood: com impacto no repasse e sem impacto no repasse.Para chegar no valor líquido que a loja tem a receber do iFood referente ao período de apuração analisado, ou ao pedido analisado, deve-se considerar apenas os lançamentos financeiros com impacto no repasse.Os lançamentos sem impacto no repasse são exibidos no relatório apenas com finalidade informativa para as lojas, para que saibam da existência desses eventos financeiros que não impactam positiva ou negativamente o montante a ser repassado para a loja parceira.Exemplos de lançamentos financeiros que não têm impacto no repasse: entrada financeira de pedidos em que o recebedor do pagamento é a loja parceira (como pedidos com método de pagamento meal voucher) e promoções incentivadas pela loja.Há três campos que indicam ao que se referem os lançamentos financeiros de débito e crédito contidos no período, são eles:
  • Campo 'fato_gerador': indica qual o fato/ação (venda, cancelamento total ou parcial, ressarcimento, ocorrências, etc.) que ocorreu durante o fluxo de vida do pedido e gerou aquele lançamento financeiro. Há fatos geradores que não possuem pedidos associados à eles, como por exemplo
  • Campo 'tipo_lancamento': é uma categorização/agrupamento dos lançamentos financeiros de acordo com sua natureza.
  • Campo 'descricao_lancamento': descrição detalhada do que se trata o lançamento financeiro.
Tabela Fato Gerador: O que gerou aquele lançamento financeiro
Fato geradorDescrição
VendaInformações sobre a venda efetiva do pedido, valor pago pelo pedido, subsídios, taxas, e demais créditos e débitos atrelados à venda
Cancelamento TotalInformações sobre o cancelamento do pedido, valor e motivo de cancelamento
Cancelamento ParcialInformações sobre o cancelamento do item
Processamento ManualQuando há uma falha sistêmica e precisamos realizar um processamento manual para incluir os registros que ficaram pendentes
Ressarcimento/IndenizaçãoInformações sobre um pedido que sofreu cancelamento, e foi ressarcido
Ocorrência VendaToda ocorrência gerada associada à um pedido, podendo ser ocorrência de crédito ou de débito
Solicitação freteInformações sobre uma solicitação do serviço de entrega iFood
Cancelamento Solicitação freteInformações sobre o cancelamento da solicitação do serviço de entrega iFood
Ocorrência AvulsaOcorrência de débito ou crédito, não necessariamente associada à um pedido
FechamentoInformação do fechamento contábil, restituição do imposto de renda
Carregamento de Saldo DevedorSaldo que a loja deve para o iFood, referente a cobranças de serviço (como por exemplo comissão de pedidos, frete e etc.), quando não foi possível realizar o débito via repasse
Tabela Tipo Lançamento:Categorização dos lançamentos financeiros
Tipo de LançamentoDescrição
RetençãoValor que é retido pelo iFood do montante de entrada financeira, ou seja, não é repassado à loja parceira
SubsídioUma promoção aplicada ao pedido, pode ser iFood ou Loja
Entrada FinanceiraInformação relacionada à uma venda, pois trata-se da entrada financeira, ou seja, o valor pago pelo cliente
ReembolsoReembolso realizado pelo iFood
Ajuste PontualAjustes realizados para correção de uma cobrança ou crédito indevido
RessarcimentoRessarcimento sobre um pedido que sofreu cancelamento
CobrançaUma cobrança que o iFood realiza para a loja parceira, por exemplo, cobrança de comissão iFood
OcorrênciaOcorrência de débito ou crédito gerada por um processo manual, para fazer um crédito ou cobrança devida
EstornoDevolução de um valor que anteriormente havia sido debitado ou creditado da loja
CréditoValor positivo repassado à loja
RestituiçãoInformação do fechamento contábil, restituição do imposto de renda
TBDNovos lançamentos financeiros que ainda estão sendo mapeados para inclusão em alguma categoria acima ou em uma nova categoria

Descrição do Lançamento: descrição detalhada do lançamento financeiro

Entrada Financeira: Valor pago pelo usuário final. Comissão do iFood: Linha com informações sobre o fato gerador Comissão, trazendo o valor cobrado pelo serviço da plataforma do iFood. Taxa entrega iFood: Valor de taxa cobrada do parceiro pelo serviço do iFood Entrega. Taxas cobradas do usuário devidas ao iFood: Valor de taxa de pedido mínimo que é cobrado do cliente final, esse valor não faz parte dos itens do pedido, e também não compõe repasse do parceiro, é um valor que fica retido no iFood. Promoção incentivada pelo iFood: Linha com informações sobre o fato gerador de subsídio iFood, traz informações como valor de subsídio(Desconto de venda) que o iFood incentiva destinado ao cliente final, e esse valor é repassado para o Merchant para compor o valor dos itens do pedido. Promoção incentivada pela loja: Linha com informações sobre o fato gerador de subsídio merchant, traz informações de valor de subsídio(Desconto de venda) que o Merchant(Mercado/Restaurante) incentiva destinado ao cliente final, e esse valor não entra no valor de repasse para o merchant. Reembolso ifood: Valor de ressarcimento feito pelo iFood no caso de pedido cancelado, e é devido o reembolso para o parceiro. Solicitação de Frete (iFood entrega): Informações de quando existe uma solicitação de frete de iFood entrega contratada. Taxa transação iFood benefícios: Taxa transacional de iFood benefícios. Desconto da taxa transação iFood benefícios: Valor cobrado sobre a taxa transacional de iFood benefícios. Ajuste falha sistêmica: Valor para quando existe um ajuste financeiro a débito ou a crédito realizado por ter acontecido uma falha sistêmica dentro da plataforma do iFood. Cobrança meses anteriores: Informações referente a cobranças realizadas sobre competências anteriores. Restituição I.R.: Restituição do Imposto de Renda TBD: Novos lançamentos financeiros, ainda não mapeadosO campo 'valor' concentra todos os valores dos lançamentos financeiros que são necessários para realizar a conciliação.Os valores se encontram com os sinais adequados de positivo e negativo, para indicar quais lançamentos financeiros representam créditos ou débitos.O valor da entrada financeira (valor pago pelo cliente) é representado como positivo, e é o valor de referência inicial de um pedido, a partir dele que somamos e subtraímos todos os outros lançamentos financeiros (de crédito e débito) e que portanto, o repasse do pedido é calculado.Exceto pela entrada financeira que é o valor base da venda, todos os outros lançamentos com sinal positivo representam créditos.Os lançamentos que estiverem com sinal negativo podem representar uma cobrança ou retenção.Importante: Para chegar no valor líquido que a loja tem a receber do iFood referente ao período de apuração analisado, ou ao pedido analisado, deve-se considerar apenas o 'valor' dos lançamentos financeiros com impacto no repasse.Os demais campos monetários do arquivo são apenas dados informativos e complementares, não sendo necessário considerá-los para compor o valor a ser recebido pela loja.Ao consultar um pedido pelo seu identificador único no campo 'pedido_associado_ifood', é possível identificar todos os lançamentos financeiros vinculados àquele pedido, dentro do período de apuração à qual se refere o arquivo.Há lançamentos financeiros que não são vinculados a nenhum pedido. Para estes casos, o campo 'pedido_associado_ifood' não é preenchido. Podemos citar como exemplo alguma ocorrência de débito ou crédito realizada para a loja parceira que não é referente a nenhum pedido, como eventuais cobranças de mensalidade.Cada título representa uma transação bancária realizada à loja parceira.Um repasse é composto por um ou mais títulos.E cada título é composto por diversos lançamentos financeiros.A soma do campo 'valor' de todos os lançamentos financeiros com impacto no repasse que compõem um mesmo título, deve ser igual ao valor apresentado no campo 'valor_transação' desse título.Um título negativo indica que a loja teve mais gastos (cancelamentos, débitos) do que receitas (vendas, créditos) naquele período. Esse valor pode ser compensado em repasses futuros ou cobrado via boleto.O valor correspondente a cada título é informado no campo 'valor_transação'.O campo 'data_repasse_esperada' indica a data programada para que a loja receba o repasse do iFood, caso não haja nenhuma falha no processo de liquidação dos títulos.O valor total previsto a ser repassado à loja em uma data específica é calculado somando-se o 'valor_transação' de todos os títulos com essa mesma data de repasse programada.
Nota: todas as datas serão enviadas no padrão ISO 8601
CampoDescriçãoTipoNullable
competenciaAno e mês referente à competência do período que possui lançamentos financeirosstringNão
data_fato_geradorData em que ocorreu o fato geradorstringNão
fato_geradorFato gerador do lançamento financeirostringNão
tipo_lancamentoTipo de lançamento financeirostringNão
descricao_lancamentoDescrição LançamentostringNão
valorValor do lançamentodoubleNão
base_calculoValor utilizado para aplicação do percentual de taxas e comissão do iFood, para obter-se o valor cobradodoubleSim
percentual_taxaPercentual de taxa aplicadadoubleSim
pedido_associado_ifoodIdentificador único do pedido na plataforma do iFoodstringNão
pedido_associado_ifood_curtoIdentificador curto do pedido composto por 4 dígitosstringNão
pedido_associado_externoIdentificador dos pedidos realizados por plataformas externas ao iFood (ex.: SiteMercado)stringSim
motivo_cancelamentoMotivo pelo qual o pedido ou item foi canceladostringSim
descricao_ocorrenciaMotivo de haver uma ocorrência de crédito ou débitostringSim
data_criacao_pedido_associadoData de criação do pedidostringNão
data_repasse_esperadaData esperada para a execução do pagamento para a lojastringSim
valor_transacaoValor total da transação bancária (título) para a lojadoubleSim
loja_idIdentificador único da loja na plataforma do iFoodstringNão
loja_id_curtoIdentificador curto da loja na plataforma do iFood composto de 4 dígitosstringNão
loja_id_externoIdentificador da loja em plataformas externas ao iFood (ex.: SiteMercado)stringSim
cnpjCNPJ da lojastringNão
tituloIdentificador de agrupamento. Ele é utilizado para vincular os lançamentos financeiros ao repasse realizado para a lojastringSim
data_faturamentoData de faturamento do fato geradorstringSim
data_apuracao_inicioData de início do período dos lançamentos financeirosstringNão
data_apuracao_fimData de fim do período dos lançamentos financeirosstringNão
valor_cesta_inicialValor total dos itens antes da edição de cestadoubleNão
valor_cesta_finalValor final dos itens após a edição de cesta, se houverdoubleNão
responsavel_transacaoEntidade que acolheu o pagamento do pedidostringSim
canal_vendasCanal de vendas pelo qual o pedido entra na plataforma (novos canais podem ser adicionados)stringSim
impacto_no_repasseIndica quais lançamentos financeiros impactam a composição do valor líquido de repasse à loja parceirastringSim
parcela_pagamentoEm vendas com pagamento parcelado, este campo especifica qual parcela está sendo paga à loja.stringSim
Nesta seção apresentamos alguns casos de uso do arquivo de conciliação.A soma de todos os lançamentos financeiros com impacto no repasse representa o valor líquido esperado para ser recebido pela loja no período analisado.O período escolhido para análise pode ser tanto competência (mês e ano), neste caso utilizar o campo 'competência' do arquivo, como pode ser alguma semana de apuração específica, neste caso utilizar os campos 'data_apuracao_inicio' e 'data_apuracao_fim'.Para os casos de uso apresentados na sequência, as análises foram realizadas por competência (Julho/2024). Campos utilizados:
  • impacto_no_repasse
  • valor (soma)
Neste caso, o valor líquido esperado para ser recebido pela loja, decorrente das movimentações financeiras que ocorreram na competência, é de R$ 491.442,31.A análise por totalizadores é útil para realizar a conciliação financeira em um nível macro e se dá por meio das possíveis maneiras de agrupar os dados do arquivo.Aqui trazemos algumas possibilidades de agrupamento dos dados, todas com foco no valor dos lançamentos, para se ter um panorama geral das movimentações financeiras ocorridas no período analisado e no impacto financeiro que tiveram.O período escolhido para análise pode ser tanto competência (mês e ano), neste caso utilizar o campo 'competência' do arquivo, como pode ser alguma semana de apuração específica, neste caso utilizar os campos 'data_apuracao_inicio' e 'data_apuracao_fim'.Para os casos de uso apresentados na sequência, as análises foram realizadas por competência (Julho/2024). Em todos agrupamentos é possível identificar que o valor líquido esperado para ser recebido pela loja, decorrente das movimentações financeiras que ocorreram na competência, é de R$ 491.442,31.

Agrupamento por Fato Gerador

Este agrupamento permite analisar qual foi o valor de lançamentos financeiros do período originados por cada fato gerador.Campos utilizados:
  • impacto_no_repasse
  • fato_gerador
  • valor (soma)
A soma dos fatos geradores com impacto no repasse representa o valor líquido esperado para ser recebido pela loja, que é de R$ 491.442,31.Exemplo: Análise do valor gerado pelas vendas
  • Para obter o valor (de crédito ou débito) gerado pelas vendas: R$ 496.379,94
  • Selecionar o período desejado para análise;
  • Selecionar o fato gerador desejado para análise, neste caso ‘fator_gerador = Venda’;
  • Selecionar ‘impacto_no_repasse = SIM';
  • Somar valores do campo 'valor';
Para obter o valor gerado pelas vendas que não possui impacto no repasse: R$ 71.525,06 (Esses valores referem-se à: entradas financeiras de pedidos recebidos via loja, promoção incentivada pela loja e promoção incentivada pela loja no delivery).
  • Selecionar o período desejado para análise;
  • Selecionar o fato gerador desejado para análise, neste caso ‘fator_gerador = Venda’;
  • Selecionar ‘impacto_no_repasse = NAO';
  • Somar valores do campo 'valor';

Agrupamento por Tipo de Lançamento

Este agrupamento permite analisar qual foi o valor de lançamentos financeiros do período de acordo com sua natureza.Campos utilizados:
  • impacto_no_repasse
  • tipo_lancamento
  • valor (soma)
A soma dos tipos de lançamento com impacto no repasse representa o valor líquido esperado para ser recebido pela loja, que é de R$ 491.442,31.Exemplo: Análise do valor de lançamentos financeiros categorizados como cobrançaPara obter o valor das cobranças realizadas pelo iFood: - R$ 135.073,09
  • Selecionar o período desejado para análise;
  • Selecionar o lançamento ‘tipo_lancamento = Cobrança’;
  • Somar valores do campo 'valor';

Agrupamento por Descrição do Lançamento

Este agrupamento permite analisar qual foi o valor de lançamentos financeiros do período de acordo com sua descrição.Campos utilizados:
  • impacto_no_repasse
  • descricao_lancamento
  • valor (soma)
A soma dos lançamentos financeiros com impacto no repasse representa o valor líquido esperado para ser recebido pela loja, que é de R$ 491.442,31.Exemplo: Análise do valor de entrada financeira (valor pago pelo cliente)Para obter o valor de entrada financeira de pedidos recebido via iFood: R$ 677.296,10
  • Selecionar o período desejado para análise;
  • Selecionar o lançamento ‘descricao_lancamento = Entrada financeira’;
  • Selecionar ‘impacto_no_repasse = SIM' ou 'responsavel_transacao = IFOOD';
  • Somar valores do campo 'valor';
Para obter o valor de entrada financeira de pedidos recebido via loja: R$ 90.332,35
  • Selecionar o período desejado para análise;
  • Selecionar o lançamento ‘descricao_lancamento = Entrada financeira’;
  • Selecionar ‘impacto_no_repasse = NAO' ou 'responsavel_transacao = LOJA';
  • Somar valores do campo 'valor';
Exemplo: Análise do valor total investido pela loja parceira em promoçõesPara obter o valor de promoções incentivadas pela loja: R$ 10.006,04
  • Selecionar o período desejado para análise;
  • Selecionar o lançamento ‘descricao_lancamento = Promoção incentivada pela loja’;
  • Somar valores do campo 'valor';
Para obter o valor de promoções incentivadas pela loja no delivery: R$ 8.961,84
  • Selecionar o período desejado para análise;
  • Selecionar o lançamento ‘descricao_lancamento = Promoção incentivada pela loja no delivery’;
  • Somar valores do campo 'valor';
Exemplo: Análise do valor de comissão do iFoodPara obter o valor de cobrança de comissão do iFood: - R$ 108.708,63
  • Selecionar o período desejado para análise;
  • Selecionar o lançamento ‘descricao_lancamento = Comissão do iFood’;
  • Somar valores do campo 'valor';

Agrupamento por Título

Este agrupamento permite analisar qual o valor de cada título e quais as datas esperadas para o repasse de cada um.Campos utilizados:
  • data_repasse_esperada
  • titulo
  • valor_transacao (média)
A soma dos títulos representa o valor líquido esperado para ser recebido pela loja, que é de R$ 491.442,31.Exemplo: Análise dos títulos com data esperada de repasse em 10/07/2024Para obter a quantidade de títulos que existem no repasse com data esperada em 10/07/2024: dois títulos (110825088 e 110825091)
  • Selecionar ‘data_repasse_esperada = 2024-07-10’;
  • Contar a quantidade única de títulos que aparece no campo 'titulo';
Para obter a soma dos valores dos títulos do repasse com data esperada em 10/07/2024: R$ 98.722,50
  • Selecionar ‘data_repasse_esperada = 2024-07-10’;
  • Somar apenas uma vez o valor de cada título no campo 'valor_transacao';
O valor de cada título deve corresponder à somatória do valor de todos os lançamentos financeiros vinculados àquele título. Esta validação é uma boa maneira de verificar se o arquivo está completo e correto.Campos utilizados:
  • data_repasse_esperada
  • titulo
  • valor_transacao (média)
  • valor (soma)
Realizar a validação da seguinte maneira:
  • Selecionar um título no campo 'titulo';
  • Verificar o valor do título, informado no campo 'valor_transacao';
  • Selecionar 'impacto_no_repasse = SIM';
  • Somar o valor de todos os lançamentos financeiros no campo 'valor';
  • Verificar se a soma do valor de todos os lançamentos financeiros corresponde ao mesmo valor do título.
A análise por totalizadores é útil para realizar a conciliação financeira em um nível macro e se dá por meio das possíveis maneiras de agrupar os dados do arquivo.Aqui trazemos algumas possibilidades de agrupamento dos dados, todas com foco na quantidade de pedidos, para se ter um panorama geral de quantos pedidos impactados por cada lançamento financeiro houveram no período analisado.O período escolhido para análise pode ser tanto competência (mês e ano), neste caso utilizar o campo 'competência' do arquivo, como pode ser alguma semana de apuração específica, neste caso utilizar os campos 'data_apuracao_inicio' e 'data_apuracao_fim'.

Agrupamento por Fato Gerador

Este agrupamento permite analisar a quantidade de pedidos do período de acordo com o fato gerador.Campos utilizados:
  • responsavel_transacao
  • fato_gerador
  • pedido_associado_ifood (contar únicos)
Exemplo: Análise da quantidade de vendasPara obter a quantidade de vendas total: 5.464
  • Selecionar o período desejado para análise;
  • Selecionar o fato gerador desejado para análise, neste caso ‘fator_gerador = Venda’;
  • Contar a quantidade única de pedidos que aparece no campo 'pedido_associado_ifood';
Para obter a quantidade de vendas em que o responsável da transação foi o iFood (pagamento recebido via iFood): 4.583
  • Selecionar o período desejado para análise;
  • Selecionar o fato gerador desejado para análise, neste caso ‘fator_gerador = Venda’;
  • Selecionar 'responsavel_transacao = IFOOD'
  • Contar a quantidade única de pedidos que aparece no campo 'pedido_associado_ifood';
Para obter a quantidade de vendas em que o responsável da transação foi a loja parceira (pagamento recebido via loja): 881
  • Selecionar o período desejado para análise;
  • Selecionar o fato gerador desejado para análise, neste caso ‘fator_gerador = Venda’;
  • Selecionar 'responsavel_transacao = LOJA'
  • Contar a quantidade única de pedidos que aparece no campo 'pedido_associado_ifood';
Valor a ser repassado pela venda do pedidoO valor líquido a ser repassado para a loja parceira pela venda de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'impacto_no_repasse = SIM'.O cálculo do repasse parte do valor de entrada financeira (valor pago pelo cliente), e então são sinalizadas todas as retenções, cobranças, eventuais subsídios, reembolsos e ressarcimentos que incidiram neste pedido, com seus devidos sinais de positivo e negativo, que sinalizam se foram créditos ou débitos realizados ao valor de entrada financeira.Neste caso o valor de repasse do pedido é de R$ 2,53.Os valores de promoções incentivadas pela loja são meramente informativos e por isso são sinalizados como 'impacto_no_repasse = NAO'.

Base de cálculo para taxas e comissão iFood

O campo 'base_calculo' informa qual foi o valor base utilizado para o cálculo das taxas e comissão iFood, enquanto o campo 'percentual_taxa' informa qual foi a taxa (de acordo com o percentual de taxas acordadas em contrato) aplicada em cima do valor base. Neste caso, podemos evidenciar que foram realizados os seguintes cálculos:Comissão do iFood = R$ 13,00 15% = R$ 1,95 Taxa de transação = R$ 13,00 2,6% = R$ 0,34 Taxa de antecipação do plano de repasse = R$ 13,00 * 1,49% = R$ 0,19

Venda com cancelamento total sem ressarcimento

Quando há cancelamento, desfazemos todos os lançamentos financeiros atrelados à venda. Para isso, há 2 fatos geradores, Venda e Cancelamento Total, que possuem os mesmos lançamentos porém com valores que se anulam, zerando o valor a ser repassado para a loja por este pedido.O valor líquido a ser repassado para a loja parceira pela venda de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Venda' e 'impacto_no_repasse = SIM'.Neste caso, o valor de repasse da venda do pedido é de R$ 165,06.O valor líquido a ser descontado da loja parceira pelo cancelamento de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Cancelamento Total' e 'impacto_no_repasse = SIM'.Neste caso, o valor de cobrança pelo cancelamento do pedido é de - R$ 165,06.Portanto, o valor final de repasse desse pedido é zero.

Venda com cancelamento total com ressarcimento

Assim como acontece no cancelamento sem ressarcimento, toda a venda é desfeita, criando os fatos geradores de Venda e Cancelamento Total que se anulam.Porém, é gerado um novo lançamento único de Ressarcimento/Indenização, que já desconta comissão e demais taxas, representando o valor de repasse da venda como se ela tivesse sido concluída. Portanto, o valor a ser repassado para a loja por este pedido é positivo.O valor líquido a ser repassado para a loja parceira pela Venda de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Venda' e 'impacto_no_repasse = SIM'.Neste caso, o valor de repasse da venda do pedido é de R$ 40,86.O valor líquido a ser descontado da loja parceira pelo Cancelamento Total de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Cancelamento Total' e 'impacto_no_repasse = SIM'.Neste caso, o valor de cobrança pelo cancelamento do pedido é de - R$ 40,86.O valor líquido a ser repassado para a loja parceira pelo Ressarcimento/Indenização de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Ressarcimento/Indenização' e 'impacto_no_repasse = SIM'.Neste caso, o valor de ressarcimento do pedido é de R$ 40,86.Portanto, o valor final de repasse desse pedido é de R$ 40,86.

Venda com cancelamento parcial sem ressarcimento

Os valores de cancelamentos parciais debitam do valor total líquido a receber por pedido.Os valores de taxas e comissões cobradas são recalculados proporcionalmente ao valor do cancelamento parcial.O valor líquido a ser repassado para a loja parceira pela Venda de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Venda' e 'impacto_no_repasse = SIM'.Neste caso, o valor de repasse da venda do pedido é de R$ 115,70.O valor líquido a ser descontado da loja parceira pelo Cancelamento Parcial de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Cancelamento Parcial' e 'impacto_no_repasse = SIM'.Neste caso, o valor de cobrança pelo cancelamento parcial do pedido é de - R$ 84,14.Portanto, o valor final de repasse desse pedido é de R$ 31,56.

Venda com cancelamento parcial com ressarcimento

Os pedidos com cancelamento parcial com ressarcimento seguem a mesma base de cálculo dos pedidos sem ressarcimento, porém, diferentemente do cancelamento total, os lançamentos de ressarcimento são demonstrados um a um, por terem base de cálculo diferentes do valor do pedido original.O valor líquido a ser repassado para a loja parceira pela Venda de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Venda' e 'impacto_no_repasse = SIM'. Neste caso, o valor de repasse da venda do pedido é de R$ 170,03.O valor líquido a ser descontado da loja parceira pelo Cancelamento Parcial de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Cancelamento Parcial' e 'impacto_no_repasse = SIM'. Neste caso, o valor de cobrança pelo cancelamento parcial do pedido é de - R$ 73,09.O valor líquido a ser repassado para a loja parceira pelo Ressarcimento/Indenização de um pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Ressarcimento/Indenização' e 'impacto_no_repasse = SIM'. Neste caso, o valor de ressarcimento do pedido é de R$ 73,09.Portanto, o valor final de repasse desse pedido é de R$ 170,03.

Como identificar os pedidos que foram realizados com pagamento offline ou utilizando meal voucher (VA/VR)

Em vendas com pagamento offline, o valor é recebido diretamente pela loja parceira, sem intermediação do iFood. Isso inclui pagamentos realizados:
  • Via maquininha: Utilizando cartões de crédito, débito ou outros meios disponíveis.
  • Em dinheiro: Pagamento em espécie diretamente ao estabelecimento.
  • Com vale-refeição/alimentação (VA/VR): Embora a transação seja iniciada na plataforma iFood, o valor é creditado diretamente à conta da loja parceira pela adquirente.
Importante: Mesmo não intermediando o pagamento, o iFood aplica taxas e comissões sobre essas vendas, as quais são debitadas do repasse da loja parceira.Para identificar os pedidos realizados com método de pagamento offline ou utilizando cartões VA/VR é necessário utilizar o campo 'responsavel_transacao = LOJA'.Se 'responsavel_transacao = LOJA' (Pagamento offline ou VA/VR), significa que o valor desse pedido não será repassado pelo iFood à loja parceira, pois ela receberá diretamente do adquirente.Se 'responsavel_transacao = IFOOD' (Pagamento online pela plataforma iFood), significa que o valor desse pedido será repassado pelo iFood à loja parceira.Para estes pedidos, o lançamento de Entrada Financeira (valor pago pelo cliente) possui 'impacto_no_repasse = NAO', uma vez que esse pagamento não foi acolhido pelo iFood e portanto não interfere no cálculo do repasse deste pedido. Exibimos esse lançamento apenas a fim de dar visibilidade para a loja parceira do valor que foi pago pelo cliente.O valor líquido a ser repassado ou cobrado da loja parceira pela Venda deste pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Venda' e 'impacto_no_repasse = SIM'.Neste caso, o valor de cobrança que o iFood necessita realizar da loja referente à venda do pedido é de - R$ 11,04.

Como identificar Solicitações de entrega iFood

Para identificar solicitações de frete iFood, verifique o campo 'descricao_lancamento'. Os valores possíveis são: "Solicitação de Frete (iFood entrega)", "Solicitação de entrega Sob Demanda On" e "Solicitação de entrega Sob Demanda Off". A descrição indica o tipo de serviço de entrega contratado e pode incluir uma taxa de serviço. A solicitação de frete pode ocorrer para pedidos que tiveram o pagamento offline via loja, ou online via iFood. A solicitação é informada como um pedido associado iFood, e a data da solicitação é informada como data de criação do pedido associado. Exemplo com 'responsavel_transacao = IFOOD':O valor líquido a ser repassado ou cobrado da loja parceira pela Venda deste pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Venda' e 'impacto_no_repasse = SIM'. Neste caso, o valor de repasse da venda do pedido é de R$ 256,44.Exemplo com 'responsavel_transacao = LOJA':O valor líquido a ser repassado ou cobrado da loja parceira pela Venda deste pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Venda' e 'impacto_no_repasse = SIM'. Neste caso, o valor de cobrança que o iFood necessita realizar da loja referente à venda do pedido é de - R$ 12,19.

Como identificar taxas cobradas do cliente final

As taxas que o iFood cobra do cliente final, são sinalizadas com 'tipo_lancamento = Retenção', como por exemplo a 'Taxa de Entrega iFood' e a 'Taxa de serviço iFood cobrada do cliente'.Esses valores não são cobrados da loja parceira, são apenas retidos pelo iFood do pagamento realizado pelo cliente final, tanto se o pagamento é recebido pelo iFood ('responsavel_transacao = IFOOD') quanto se é recebido pela loja ('responsavel_transacao = LOJA').Quando a loja é responsável por receber o pagamento do cliente, o iFood realiza o reembolso de um percentual da "Taxa de serviço iFood cobrada do cliente". Esse reembolso é previsto em contrato e tem como objetivo compensar a loja por ter sido a responsável pela transação financeira.O valor líquido a ser repassado ou cobrado da loja parceira pela Venda deste pedido, é a somatória do campo 'valor' de todas as linhas do arquivo atreladas a este pedido (campo 'pedido_associado_ifood'), que possuem 'fato gerador = Venda' e 'impacto_no_repasse = SIM'. Neste caso, o valor de cobrança pela venda do pedido é de - R$ 8,89.
Esta página foi útil?
Avalie sua experiência no novo Developer portal: