Conciliação

O Endpoint /{merchantId}/period, retorna informações dos “ids” que o parceiro possui em um determinado mês, esses “ids” são os identificadores que agrupam um conjunto de lançamentos que compõe o repasse do parceiro e que devem ser utilizados nas requisições dos demais endpoints a fim de entender qual o conjunto de dados que impactou um determinado repasse. Vale lembrar, que os periods podem estar com o status ABERTO ou FECHADO, quando o mesmo encontra-se com o status ABERTO, quer dizer que o período ainda não foi apurado, podendo sofrer alterações de inclusão ou remoção de lançamentos que impactam o repasse, podemos citar como exemplo o aceite do iFood de uma contestação que estava em análise, somente após aprovar a contestação, ela vai entrar como um lançamento no período que encontra-se em aberto do parceiro.

O Endpoint /{merchantId}/payments, retorna informações sobre o repasse do parceiro realizado pelo iFood. O valor total se dará pela somatória dos valores de todas as API's, sendo eles valores a receber ou a pagar, lembrando que podemos ter vários repasses para o parceiro em um mesmo dia, a depender de diversos fatores durante o faturamento do iFood.

O Endpoint /{merchantId}/salesAdjustments, retorna informações de alterações que impactam o valor dos pedidos após a sua conclusão. Para estes casos, ocorrerá um refaturamento do pedido que foi concluído (CONCLUDED), lembrando que podemos ter vários faturamentos para o mesmo pedido. Podemos considerar como exemplo, um pedido que após a sua conclusão, houve cancelamento de um item da cesta pelo consumidor, que entrou em contato e relatou que o produto não foi enviado. Nestes casos, ocorrerá o refaturamento do pedido, descontando o item cancelado, gerando assim um novo valor para o repasse ao parceiro.

O Endpoint /{merchantId}/occurrences, retorna informações sobre lançamentos realizados pelo iFood e que impactam o repasse do parceiro. Ocorrências são lançamentos financeiros manuais de crédito ou débito que servem aos mais diversos propósitos. De maneira geral, podemos resumir em 2 grupos:

• Ocorrências para correções financeiras - Quando necessário, o iFood realiza um ajuste na operação financeira que foi lançada erroneamente, como exemplo, ajuste de comissão cobrada com valor errado, ou para fazer algum lançamento financeiro pontual.
• Ocorrências que viabilizam novas regras e ou novos produtos – O iFood anda em constante evolução, lançando sempre novas funcionalidades para nossos parceiros e visando atender essas novas mecânicas de negócio, o sistema financeiro do iFood possui esse recurso, reduzindo o tempo de implementação e conseguindo validar com nossos parceiros.

O Endpoint /{merchantId}/incomeTaxes, retorna informações sobre os reembolsos efetivados pelo iFood para o parceiro, em virtude das operações que houve incidência do imposto de renda nas operações realizadas. Esse valor é calculado em todo fechamento mensal do iFood e o valor a ser reembolsado é lançado, referente ao mês anterior.

O Endpoint /{merchantId}/chargeCancellations, retorna informações sobre o valor que foi repassado para o parceiro pelo iFood, quando o cancelamento do pedido é de responsabilidade do iFood. Podemos considerar como exemplo, um cancelamento ocasionado por um problema enfrentado pelo entregador. Se o parceiro utiliza a logística de entrega do iFood e durante o trajeto ao destinatário ocorrer um problema e a encomenda não chega ao destino, entende-se que o parceiro cumpriu o seu dever de preparar e despachar o pedido, porém o mesmo não foi entregue por motivos fora de seu controle. Neste caso, o iFood realiza um crédito para o parceiro, descontando as devidas taxas.

O Endpoint /{merchantId}/cancellations, retorna informações sobre o cancelamento total do pedido. Podemos considerar como exemplo, um pedido que teve seu status como concluído, porém o parceiro não conseguiu realizar a entrega ao consumidor, logo esse pedido será cancelado. Os pedidos com cancelamento parcial aparecem na API de Sales, pois o status dele é concluído.

O Endpoint /{merchantId}/maintenanceFees, retorna informações sobre a cobrança de mensalidade do iFood para o parceiro, mediante regras e termos do contrato realizado entre as entidades.

O Endpoint /{merchantId}/paymentDetails, retorna informações sobre os detalhes da transação de pagamento de cartões MEAL VOUCHER. Importante ressaltar que a api não tem vínculo com a api de payments. Podemos considerar como exemplo, um pedido feito no aplicativo do iFood e pago pelo app, com cartão VA ou VR. Nesse cenário, a Api mostrará informações sobre adquirência, NSU, status do pagamento, local de reembolso cliente, se foi realizado na bandeira ou na carteira iFood.

O Endpoint /{merchantId}/receivableRecords, retorna informações sobre os registros de recebíveis, ou seja, valor repassado a uma instituição financeira que o parceiro tem algum tipo contrato de antecipação realizado e que tenha concedido a agenda do iFood como garantia.

O Endpoint /{merchantId}/salesBenefits, retorna informações sobre as vendas que foram pagas pelo consumidor no app com o cartão iFood benefícios. A api mostrará uma seção que conterá dados sobre os pedidos e taxas aplicadas pelo iFood e o valor líquido que a loja receberá pela operação.

O Endpoint /{merchantId}/adjustmentsBenefits, retorna informações de alterações que impactam o valor dos pedidos após a sua conclusão e que foram pagos com iFood Benefícios no app. Para estes casos ocorreu um refaturamento do pedido que foi concluído (CONCLUDED), lembrando que um pedido pode ter vários faturamentos. Por exemplo, um pedido que após ser concluído, foi cancelado um item da cesta pelo consumidor, que entrou em contato e relatou que o produto não foi enviado. Nestes casos, ocorrerá o refaturamento do pedido, descontando o item cancelado, gerando assim um novo valor para o repasse ao parceiro.