n8n-nodes-ifood-completo 0.1.21 → 0.1.23

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.1.23
+
+- Corrige o node `iFood Analise Conciliacao` para nao usar eventos logisticos/operacionais em `diferencas`.
+- Passa a montar `diferencas` apenas com lancamentos financeiros com valor numerico, priorizando `billingSummary.billingEntries`.
+- Completa o valor bruto com `saleGrossValue` ou `ORDER_PAYMENT` e calcula `liquidoVenda` por `billingEntries` quando `saleBalance` nao vier na resposta.
+- Melhora a leitura de lote, valor e status do repasse a partir de `closingItems`, priorizando o item `REPASSE`.
+
+## 0.1.22
+
+- Altera a saida do node `iFood Analise Conciliacao` para um unico item JSON consolidado com `merchantId`, `periodo`, `vendas` e `repasses`.
+- Remove os payloads brutos de origem e campos extras da resposta, mantendo apenas o modelo sintetico de conciliacao solicitado.
+
 ## 0.1.21
 
 - Ajusta `Financial Events` para paginar a partir de `page=1` e consultar o periodo semanal do corte, respeitando o limite da API.

package/README.md

@@ -60,7 +60,7 @@ O node `iFood Authentication` nao exige credencial nem recebe `Access Token`; el
 
 `iFood Produtos do Catalogo` gera o token internamente por `client_credentials`. Informe somente `Client ID`, `Client Secret`, `Merchant ID` e `Catalog ID`; a saída contém um item n8n por produto, com categoria, código externo, valor, situação, pausa e grupos de complementos.
 
-`iFood Analise Conciliacao` tambem gera o token internamente por `client_credentials`. Informe `Client ID`, `Client Secret`, `Merchant ID da Loja` e `Data` no formato `yyyy-mm-dd`; o node consulta vendas do dia, eventos financeiros e repasses relacionados, retornando um item JSON por venda com corte semanal, lote de repasse, valores e diferencas financeiras.
+`iFood Analise Conciliacao` tambem gera o token internamente por `client_credentials`. Informe `Client ID`, `Client Secret`, `Merchant ID da Loja` e `Data` no formato `yyyy-mm-dd`; o node consulta vendas do dia, eventos financeiros e repasses relacionados, retornando um unico JSON consolidado com `merchantId`, `periodo`, `vendas` e `repasses`.
 
 ## Tutorial
 

package/TUTORIAL.md

@@ -421,7 +421,8 @@ Reconciliation Arquivo:
 
 O node `iFood Analise Conciliacao` executa o fluxo financeiro consolidado para uma
 data especifica. Ele recebe os dados de credenciamento manualmente, gera o token
-OAuth internamente e retorna um item n8n por venda localizada no dia informado.
+OAuth internamente e retorna um unico item n8n consolidado com as vendas e repasses
+da data informada.
 
 Parametros obrigatorios:
 
@@ -436,41 +437,54 @@ Fluxo executado:
 
 1. Gera o token em `/authentication/v1.0/oauth/token`.
 2. Consulta vendas em `/v3/sales` no dia informado.
-3. Consulta eventos financeiros em `/v3/financial-events` em janela ampliada para vincular impactos e repasse.
+3. Consulta eventos financeiros em `/v3/financial-events` quando disponivel para vincular impactos e repasse.
 4. Consulta repasses em `/financial/v3.0/merchants/{merchantId}/settlements` para identificar lote, valor e data de pagamento.
-5. Agrupa eventos por pedido e retorna a conciliacao de cada venda.
+5. Monta `diferencas` apenas com lancamentos financeiros com valor, priorizando `billingSummary.billingEntries` da venda.
 
-Modelo de saida por venda:
+Modelo de saida consolidada:
 
 ```json
 {
   "merchantId": "MERCHANT_ID",
-  "dataConsulta": "2026-09-06",
-  "venda": {
-    "orderId": "ORDER_ID",
-    "shortId": "1234",
-    "statusFinal": "CONCLUDED",
-    "dataVenda": "2026-09-06T18:40:00Z"
-  },
-  "corteSemanal": {
-    "inicio": "2026-08-31",
+  "periodo": {
+    "inicio": "2026-09-06",
     "fim": "2026-09-06"
   },
-  "repasse": {
-    "dataPrevista": "2026-09-16",
-    "dataPagamento": "2026-09-16",
-    "loteId": "LOTE_ID",
-    "valorLote": 14082.41,
-    "status": "SUCCEED"
-  },
-  "valores": {
-    "bruto": 100,
-    "descontos": 10,
-    "acrescimos": 0,
-    "liquidoVenda": 90,
-    "liquidoRepasse": 72.5
-  },
-  "diferencas": []
+  "vendas": [
+    {
+      "orderId": "ORDER_ID",
+      "shortId": "1234",
+      "statusFinal": "CONCLUDED",
+      "dataVenda": "2026-09-06T18:40:00Z",
+      "corteSemanal": {
+        "inicio": "2026-08-31",
+        "fim": "2026-09-06"
+      },
+      "repasse": {
+        "dataPrevista": "2026-09-16",
+        "dataPagamento": "2026-09-16",
+        "loteId": "LOTE_ID",
+        "valorLote": 14082.41,
+        "status": "SUCCEED"
+      },
+      "valores": {
+        "bruto": 100,
+        "descontos": 10,
+        "acrescimos": 0,
+        "liquidoVenda": 90,
+        "liquidoRepasse": 72.5
+      },
+      "diferencas": []
+    }
+  ],
+  "repasses": [
+    {
+      "dataPagamento": "2026-09-16",
+      "loteId": "LOTE_ID",
+      "valor": 14082.41,
+      "vendas": ["ORDER_ID"]
+    }
+  ]
 }
 ```
 

package/nodes/IfoodCompletoAnaliseConciliacao/IfoodCompletoAnaliseConciliacao.node.js

@@ -69,6 +69,8 @@ class IfoodCompletoAnaliseConciliacao {
 
 			const eventsByOrder = groupFinancialEventsByOrder(financialEvents);
 			const settlementsIndex = indexSettlements(settlements);
+			const vendas = [];
+			const repassesMap = {};
 
 			for (const sale of sales) {
 				const saleId = saleIdentifier(sale);
@@ -77,10 +79,19 @@ class IfoodCompletoAnaliseConciliacao {
 				const orderEvents = mergeEvents(saleId && eventsByOrder[saleId] ? eventsByOrder[saleId] : [], salesOrderEvents);
 				const corte = weekCut(saleDate.slice(0, 10));
 				const settlement = matchSettlement(orderEvents, settlementsIndex, corte);
-				returnData.push({
-					json: buildSaleConciliation({ merchantId, data, sale, saleId, saleDate, orderEvents, corte, settlement }),
-				});
+				const venda = buildSaleConciliation({ sale, saleId, saleDate, orderEvents, corte, settlement });
+				vendas.push(venda);
+				addRepasseSale(repassesMap, venda);
 			}
+
+			returnData.push({
+				json: {
+					merchantId,
+					periodo: { inicio: data, fim: data },
+					vendas,
+					repasses: Object.keys(repassesMap).map((key) => repassesMap[key]),
+				},
+			});
 		}
 
 		return [returnData];
@@ -215,11 +226,8 @@ function groupFinancialEventsByOrder(events) {
 
 function normalizeSaleOrderEvents(sale) {
 	const events = [];
-	for (const event of arrayFrom(sale, ['orderEvents'])) {
-		events.push(event);
-	}
 	for (const entry of arrayFrom(sale, ['billingEntries', 'billingSummary.billingEntries'])) {
-		events.push(Object.assign({ hasTransferImpact: true }, entry));
+		events.push(Object.assign({ hasTransferImpact: true, source: 'billingEntries' }, entry));
 	}
 	return events;
 }
@@ -290,33 +298,34 @@ function periodMatches(settlement, corte) {
 }
 
 function settlementSummary(settlement, matchedId) {
+	const closingItem = settlementClosingItem(settlement);
 	return {
-		loteId: matchedId || firstText(settlement, ['id', 'settlementId', 'transactionId', 'closingItemId']),
-		dataPagamento: firstText(settlement, ['paymentDate', 'paidAt', 'date', 'settlementDate']),
-		valorLote: firstNumber(settlement, ['balance', 'amount', 'value', 'totalAmount']),
-		status: firstText(settlement, ['status', 'situation']),
-		banco: objectValue(settlement, ['accountDetails', 'bankAccount', 'bank']),
-		origem: settlement,
+		loteId: matchedId || firstText(closingItem, ['id', 'settlementId', 'transactionId', 'closingItemId']) || firstText(settlement, ['id', 'settlementId', 'transactionId', 'closingItemId']),
+		dataPagamento: firstText(closingItem, ['paymentDate', 'paidAt', 'date', 'settlementDate']) || firstText(settlement, ['paymentDate', 'paidAt', 'date', 'settlementDate']),
+		valorLote: firstNumber(closingItem, ['balance', 'amount', 'value', 'totalAmount']) || firstNumber(settlement, ['balance', 'amount', 'value', 'totalAmount']),
+		status: firstText(closingItem, ['status', 'situation']) || firstText(settlement, ['status', 'situation']),
 	};
 }
 
+function settlementClosingItem(settlement) {
+	const items = arrayFrom(settlement, ['closingItems', 'items']);
+	if (!items.length) return {};
+	return items.find((item) => firstText(item, ['type']).toUpperCase() === 'REPASSE') || items[0];
+}
+
 function buildSaleConciliation(ctx) {
-	const { merchantId, data, sale, saleId, saleDate, orderEvents, corte, settlement } = ctx;
+	const { sale, saleId, saleDate, orderEvents, corte, settlement } = ctx;
 	const valoresVenda = saleValues(sale);
-	const diferencas = orderEvents.map(normalizeFinancialEvent);
+	const diferencas = orderEvents.map(normalizeFinancialEvent).filter(isFinancialDifference);
 	const liquidoRepasse = calculateTransferNet(diferencas, valoresVenda.liquidoVenda);
 	const descontosEventos = sumBySignAndType(diferencas, 'desconto');
 	const acrescimosEventos = sumBySignAndType(diferencas, 'acrescimo');
 
 	return {
-		merchantId,
-		dataConsulta: data,
-		venda: {
-			orderId: saleId,
-			shortId: firstText(sale, ['shortId', 'displayId', 'order.displayId']),
-			statusFinal: firstText(sale, ['currentStatus', 'status', 'order.status']),
-			dataVenda: saleDate,
-		},
+		orderId: saleId,
+		shortId: firstText(sale, ['shortId', 'displayId', 'order.displayId']),
+		statusFinal: firstText(sale, ['currentStatus', 'status', 'order.status']),
+		dataVenda: saleDate,
 		corteSemanal: corte,
 		repasse: settlement ? {
 			dataPrevista: firstTextFromEvents(orderEvents, ['settlement.expectedDate', 'expectedPaymentDate', 'paymentDate']) || settlement.dataPagamento,
@@ -324,14 +333,12 @@ function buildSaleConciliation(ctx) {
 			loteId: settlement.loteId,
 			valorLote: settlement.valorLote,
 			status: settlement.status,
-			banco: settlement.banco,
 		} : {
 			dataPrevista: firstTextFromEvents(orderEvents, ['settlement.expectedDate', 'expectedPaymentDate', 'paymentDate']),
 			dataPagamento: '',
 			loteId: '',
 			valorLote: null,
 			status: '',
-			banco: null,
 		},
 		valores: {
 			bruto: valoresVenda.bruto,
@@ -341,37 +348,104 @@ function buildSaleConciliation(ctx) {
 			liquidoRepasse,
 		},
 		diferencas,
-		repassesRelacionados: settlement ? [settlement.origem] : [],
-		origem: {
-			sale,
-			financialEvents: orderEvents,
-		},
 	};
 }
 
+function addRepasseSale(map, venda) {
+	const repasse = venda && venda.repasse ? venda.repasse : null;
+	if (!repasse || !repasse.loteId) return;
+	const key = `${repasse.dataPagamento}|${repasse.loteId}`;
+	if (!map[key]) {
+		map[key] = {
+			dataPagamento: repasse.dataPagamento,
+			loteId: repasse.loteId,
+			valor: repasse.valorLote,
+			vendas: [],
+		};
+	}
+	if (venda.orderId && map[key].vendas.indexOf(venda.orderId) === -1) {
+		map[key].vendas.push(venda.orderId);
+	}
+}
+
 function saleValues(sale) {
+	const billingEntries = arrayFrom(sale, ['billingEntries', 'billingSummary.billingEntries']);
+	const bruto = saleGrossValue(sale) || billingEntryValue(billingEntries, 'ORDER_PAYMENT');
+	const liquidoVenda = firstNumber(sale, ['billingSummary.saleBalance', 'billingSummary.netValue', 'netValue', 'saleBalance']);
 	return {
-		bruto: firstNumber(sale, ['billingSummary.grossValue', 'billingSummary.total', 'total.orderAmount', 'total.price', 'orderAmount', 'amount']),
-		descontos: firstNumber(sale, ['billingSummary.discount', 'billingSummary.discounts', 'total.discount', 'discount', 'discounts']),
-		acrescimos: firstNumber(sale, ['billingSummary.additionalFees', 'billingSummary.addition', 'total.additionalFees', 'additionalFees', 'additions']),
-		liquidoVenda: firstNumber(sale, ['billingSummary.saleBalance', 'billingSummary.netValue', 'netValue', 'saleBalance']),
+		bruto: bruto !== null ? bruto : firstNumber(sale, ['billingSummary.grossValue', 'billingSummary.total', 'total.orderAmount', 'total.price', 'orderAmount', 'amount']),
+		descontos: saleDiscountValue(sale),
+		acrescimos: firstNumber(sale, ['billingSummary.additionalFees', 'billingSummary.addition', 'total.additionalFees', 'additionalFees', 'additions', 'additionalFee']),
+		liquidoVenda: liquidoVenda !== null ? liquidoVenda : billingEntriesBalance(billingEntries),
 	};
 }
 
+function billingEntryValue(entries, name) {
+	for (const entry of entries) {
+		if (firstText(entry, ['name', 'type']).toUpperCase() !== name) continue;
+		const value = firstNumber(entry, ['value', 'amount.value', 'amount', 'total']);
+		if (value !== null) return value;
+	}
+	return null;
+}
+
+function billingEntriesBalance(entries) {
+	if (!entries.length) return null;
+	let total = 0;
+	let found = false;
+	for (const entry of entries) {
+		if (firstText(entry, ['name', 'type']).toUpperCase() === 'STORE_SUBSIDY') continue;
+		const value = firstNumber(entry, ['value', 'amount.value', 'amount', 'total']);
+		if (value !== null) {
+			total += value;
+			found = true;
+		}
+	}
+	return found ? roundCurrency(total) : null;
+}
+
+function saleGrossValue(sale) {
+	const total = firstNumber(sale, ['saleGrossValue.total', 'saleGrossValue.grossValue', 'saleGrossValue.value']);
+	if (total !== null) return total;
+	const bag = firstNumber(sale, ['saleGrossValue.bag']);
+	const deliveryFee = firstNumber(sale, ['saleGrossValue.deliveryFee']);
+	const serviceFee = firstNumber(sale, ['saleGrossValue.serviceFee']);
+	if (bag === null && deliveryFee === null && serviceFee === null) return null;
+	return roundCurrency((bag || 0) + (deliveryFee || 0) + (serviceFee || 0));
+}
+
+function saleDiscountValue(sale) {
+	const direct = firstNumber(sale, ['billingSummary.discount', 'billingSummary.discounts', 'total.discount', 'discount', 'discounts']);
+	if (direct !== null) return direct;
+	let total = 0;
+	let found = false;
+	for (const benefit of arrayFrom(sale, ['benefits', 'benefits.items', 'benefits.delivery'])) {
+		const value = firstNumber(benefit, ['value', 'amount', 'discount', 'sponsorshipValues.IFood', 'sponsorshipValues.MERCHANT', 'sponsorshipValues.CHAIN']);
+		if (value !== null) {
+			total += Math.abs(value);
+			found = true;
+		}
+	}
+	return found ? roundCurrency(total) : null;
+}
+
 function normalizeFinancialEvent(event) {
-	const tipo = firstText(event, ['type', 'eventType', 'code', 'classification']);
-	const valor = firstNumber(event, ['amount.value', 'amount', 'value', 'total']);
+	const tipo = firstText(event, ['name', 'type', 'eventType', 'code', 'classification']);
+	const valor = firstNumber(event, ['value', 'amount.value', 'amount', 'total']);
 	return {
 		tipo,
 		descricao: firstText(event, ['description', 'name', 'title', 'detail.description']),
 		valor,
 		impactaRepasse: Boolean(valueAt(event, 'hasTransferImpact')),
-		dataEvento: firstText(event, ['eventDate', 'date', 'createdAt', 'paymentDate']),
-		loteId: firstText(event, ['settlement.id', 'settlementId', 'payment.id', 'paymentId', 'closingItem.id', 'closingItemId']),
-		origem: event,
 	};
 }
 
+function isFinancialDifference(event) {
+	if (!event || typeof event.valor !== 'number') return false;
+	if (!event.tipo && !event.descricao) return false;
+	return true;
+}
+
 function calculateTransferNet(events, fallback) {
 	const impacting = events.filter((event) => event.impactaRepasse && typeof event.valor === 'number');
 	if (!impacting.length) return fallback;
@@ -422,14 +496,6 @@ function valueAt(object, path) {
 	}, object);
 }
 
-function objectValue(object, paths) {
-	for (const path of paths) {
-		const value = valueAt(object, path);
-		if (value && typeof value === 'object') return value;
-	}
-	return null;
-}
-
 function arrayFrom(object, paths) {
 	for (const path of paths) {
 		const value = valueAt(object, path);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "n8n-nodes-ifood-completo",
-	"version": "0.1.21",
+	"version": "0.1.23",
     "description": "Nodes n8n modulares para Merchant API iFood: autenticação, lojas, eventos, pedidos, financeiro, análise de conciliação, catálogo, produtos de catálogo, logística, shipping e avaliações.",
     "keywords": [
         "n8n-community-node-package",