@liiift-studio/sales-portal 1.2.1

package/api/utils/processors/invoiceProcessor.js

@@ -0,0 +1,337 @@
+/**
+ * Processor for Stripe invoice data
+ * Fixed to handle fee calculations correctly for items with discounts and refunds
+ */
+
+import { calculateFees, formatRefunds } from '../feeCalculator';
+
+const debuggingAccounts = ["colby@liiift.studio", "quinn@liiift.studio", "qkeave@gmail.com", "quinn@quitetype.com"];
+
+/**
+ * Finds matching order and typeface for an invoice line
+ * @param {Object} params - Search parameters
+ * @param {Object} params.invoice - Invoice to match
+ * @param {Object} params.line - Invoice line item
+ * @param {Array} params.sanitySales - Sanity orders to search
+ * @returns {Object} Matching order and typeface
+ */
+function findMatches({ invoice, line = {}, sanitySales = [] }) {
+	// Find matching order
+	const associatedOrder = 
+		(invoice?.id && sanitySales.find(order => order.orderStatus.invoiceId === invoice.id)) || 
+		(invoice?.payment_intent && sanitySales.find(order => order.orderStatus.paymentIntentId === invoice.payment_intent)) || 
+		(invoice?.customer?.email && sanitySales.find(order => {
+			const orderDate = new Date(order._createdAt);
+			const invoiceDate = new Date(invoice.created * 1000);
+			return (
+				order.title === invoice.customer.email &&
+				Math.abs(orderDate - invoiceDate) < (1000 * 60 * 60)
+			);
+		})) || null;
+
+	// Fix description for unknown items before finding typeface
+	if (line?.description === 'Unknown item') {
+		line.description = associatedOrder?.typefaces?.map(typeface => 
+			`${typeface?.typeface?.title?.toUpperCase()} (${(typeface?.fonts?.length || 0) + 1} styles)`
+		).join(', ') || line.description;
+	}
+
+	// Find matching typeface
+	let associatedTypeface = null;
+	if (associatedOrder?.typefaces?.length) {
+		const sortedTypefaces = [...associatedOrder.typefaces]
+			.filter(t => t?.typeface?.title)
+			.sort((a, b) => b.typeface.title.length - a.typeface.title.length);
+
+		const matchingTypeface = sortedTypefaces.find(typeface => 
+			line?.description?.toLowerCase().includes(typeface.typeface.title.toLowerCase())
+		);
+		associatedTypeface = matchingTypeface?.typeface || null;
+	}
+
+	return { associatedOrder, associatedTypeface };
+}
+
+/**
+ * Processes a single line item from an invoice
+ * @param {Object} params - Processing parameters
+ * @param {Object} params.line - Invoice line item
+ * @param {Object} params.invoice - Parent invoice
+ * @param {Object} params.associatedOrder - Matching Sanity order if found
+ * @param {Object} params.associatedTypeface - Matching typeface if found
+ * @param {boolean} params.isPrimaryItem - Whether this is the first/primary item in the invoice
+ * @param {number} [params.totalFee] - Total transaction fee for the invoice (for non-primary items)
+ * @returns {Object} Processed line item data
+ */
+function processLineItem({ line, invoice, associatedOrder, associatedTypeface, isPrimaryItem = false, totalFee = null, paymentMethodData = null }) {
+	// Check if this is a refund - we'll consider it a refund if it has a negative amount
+	const isRefund = line.amount < 0;
+
+	// Calculate discount-adjusted amounts
+	const lineTotalDiscounted = line.discount_amounts.reduce((acc, discount) => acc + discount.amount, 0);
+	const lineAmount = line.amount_excluding_tax - lineTotalDiscounted;
+	const invoiceTotal = invoice.total_excluding_tax;
+	
+	// Calculate fees and dispute amounts using discount-adjusted values
+	const result = calculateFees({
+		charge: invoice.charge,
+		amount: lineAmount, // Use discount-adjusted amount
+		total: invoiceTotal, // Use discount-adjusted total
+		isPrimaryItem,
+		isRefund,
+		totalFee
+	});
+	
+	const { disputed, disputeAmount, totalFees, disputeDetails, totalTransactionFee } = result;
+
+	// Calculate final totals
+	const lineTotal = lineAmount; // Pre-tax total with discounts applied
+	const lineTotalWithTax = (line.amount || 0) - (disputeAmount || 0) - lineTotalDiscounted + line.tax_amounts.reduce((acc, tax) => acc + tax.amount, 0);
+
+	if (associatedOrder?.orderNumber === "201028") {
+		console.log("lineTotal", lineTotal);
+		console.log("lineTotalWithTax", lineTotalWithTax);
+		console.log("invoice.total_excluding_tax", invoice.total_excluding_tax);
+		console.log("line", line);
+	}
+
+	console.log("invoice?.payment_intent?.payment_method", invoice?.payment_intent?.payment_method);
+	return {
+		// Quantities
+		totalWithTax: lineTotalWithTax,
+		total: lineTotal, // Pre-tax total
+		invoiceTotal: invoice.total_excluding_tax,
+		invoiceTotalWithTax: invoice.total,
+		discountAmounts: line.discount_amounts,
+		taxAmounts: line.tax_amounts,
+		stripeFees: totalFees,
+		disputed,
+		disputeDetails,
+
+		// Refunds
+		refunds: formatRefunds(
+			invoice.charge?.refunds?.data,
+			lineTotal,
+			invoice.total_excluding_tax
+		),
+
+		// Other properties
+		description: line.description,
+		discounts: !!line?.discounts.length ? line?.discounts : invoice?.discounts,
+		lineId: line.id,
+		created: invoice.created,
+		id: invoice.id,
+		invoicePdf: invoice.invoice_pdf,
+		number: invoice.number,
+		customer: invoice?.customer,
+		testSale: debuggingAccounts.includes(invoice?.customer?.email) ||
+			debuggingAccounts.includes(invoice?.customer_shipping?.email) ||
+			debuggingAccounts.includes(invoice?.customer_address?.email) ||
+			debuggingAccounts.includes(associatedOrder?.billingAddress?.email) ||
+			debuggingAccounts.includes(associatedOrder?.shippingAddress?.email) ||
+			debuggingAccounts.includes(associatedOrder?.licenseeAddress?.email),
+		customerAddress: {
+			postal_code: invoice?.customer_address?.postal_code,
+			country: invoice?.customer_address?.country,
+		},
+		// Payment method data - use the invoice.payment_method (stored from payment_intent) if available
+		paymentMethod: {
+			type: paymentMethodData?.type || invoice?.payment_method?.type || invoice?.payment_intent?.payment_method?.type,
+			card: paymentMethodData?.card || invoice?.payment_method?.card || invoice?.payment_intent?.payment_method?.card,
+			origin: (paymentMethodData?.card?.country || invoice?.payment_method?.card?.country || invoice?.payment_intent?.payment_method?.card?.country) ? {
+				country: paymentMethodData?.card?.country || invoice?.payment_method?.card?.country || invoice?.payment_intent?.payment_method?.card?.country
+			} : null
+		},
+		order: associatedOrder || null,
+		orderNumber: associatedOrder?.orderNumber || null,
+		author: associatedTypeface?.author || null,
+		typeface: associatedTypeface || null,
+		saleType: "invoice"
+	};
+}
+
+/**
+ * Processes shipping costs from an invoice
+ * @param {Object} params - Processing parameters
+ * @param {Object} params.invoice - Parent invoice
+ * @param {Object} params.associatedOrder - Matching Sanity order if found
+ * @param {number} [params.totalFee] - Total transaction fee for the invoice (for proportional distribution)
+ * @returns {Object} Processed shipping data
+ */
+function processShippingCost({ invoice, associatedOrder, totalFee = null, paymentMethodData = null }) {
+	if (!invoice?.shipping_cost?.amount_total) {
+		return null;
+	}
+
+	// Check if this is a refund shipping cost
+	const isRefund = invoice.shipping_cost.amount_total < 0;
+
+	// Calculate fees and dispute amounts - shipping should get proportional fee
+	const { disputed, disputeAmount, totalFees, disputeDetails } = calculateFees({
+		charge: invoice.charge,
+		amount: invoice.shipping_cost.amount_total,
+		total: invoice.total,
+		isPrimaryItem: false, // Shipping never gets the primary transaction fee
+		isRefund,
+		totalFee // Use the total fee for proportional distribution
+	});
+
+	return {
+		// Quantities
+		totalWithTax: invoice.shipping_cost.amount_total - disputeAmount,
+		total: invoice.shipping_cost.amount_subtotal, // Pre-tax total
+		invoiceTotal: invoice.total_excluding_tax,
+		invoiceTotalWithTax: invoice.total,
+		discountAmounts: null,
+		stripeFees: totalFees,
+		disputed,
+		disputeDetails,
+		taxAmounts: [{
+			amount: invoice.shipping_cost.amount_tax,
+			inclusive: null,
+			tax_rate: null,
+			taxability_reason: null,
+			taxable_amount: invoice.shipping_cost.amount_subtotal
+		}],
+
+		// Refunds
+		refunds: formatRefunds(
+			invoice.charge?.refunds?.data,
+			invoice.shipping_cost.amount_subtotal,
+			invoice.total_excluding_tax
+		),
+
+		// Other properties
+		shippingProvision: true,
+		description: `Shipping for ${associatedOrder?.orderNumber || "?"} : ${invoice?.id}`,
+		discounts: null,
+		lineId: invoice.shipping_cost.shipping_rate,
+		created: invoice.created,
+		id: invoice.id,
+		invoicePdf: invoice.invoice_pdf,
+		number: invoice.number,
+		customer: invoice?.customer,
+		testSale: debuggingAccounts.includes(invoice?.customer?.email) ||
+			debuggingAccounts.includes(invoice?.customer_shipping?.email) ||
+			debuggingAccounts.includes(invoice?.customer_address?.email) ||
+			debuggingAccounts.includes(associatedOrder?.billingAddress?.email) ||
+			debuggingAccounts.includes(associatedOrder?.shippingAddress?.email) ||
+			debuggingAccounts.includes(associatedOrder?.licenseeAddress?.email),
+		customerAddress: {
+			postal_code: invoice?.customer_address?.postal_code,
+			country: invoice?.customer_address?.country,
+		},
+		// Payment method data - use the invoice.payment_method (stored from payment_intent) if available
+		paymentMethod: {
+			type: paymentMethodData?.type || invoice?.payment_method?.type || invoice?.payment_intent?.payment_method?.type,
+			card: paymentMethodData?.card || invoice?.payment_method?.card || invoice?.payment_intent?.payment_method?.card,
+			origin: (paymentMethodData?.card?.country || invoice?.payment_method?.card?.country || invoice?.payment_intent?.payment_method?.card?.country) ? {
+				country: paymentMethodData?.card?.country || invoice?.payment_method?.card?.country || invoice?.payment_intent?.payment_method?.card?.country
+			} : null
+		},
+		order: associatedOrder || null,
+		orderNumber: associatedOrder?.orderNumber || null,
+		author: null,
+		typeface: null,
+		saleType: "invoice"
+	};
+}
+
+/**
+ * Processes an invoice and its line items
+ * @param {Object} params - Processing parameters
+ * @param {Object} params.invoice - Invoice to process
+ * @param {Array} params.sanitySales - Sanity orders to match against
+ * @param {Set} params.processedPaymentIntents - Set of already processed payment intents
+ * @returns {Array} Processed sales data
+ */
+export function processInvoice({ invoice, sanitySales, processedPaymentIntents }) {
+	// Skip if payment intent already processed
+	let paymentIntentId = null;
+	
+	// Handle payment_intent which could be a string ID or an object with an id property
+	let paymentMethodData = null;
+	
+	if (invoice.payment_intent) {
+		if (typeof invoice.payment_intent === 'string') {
+			paymentIntentId = invoice.payment_intent;
+		} else if (invoice.payment_intent && invoice.payment_intent.id) {
+			// Extract payment method data before potentially using just the ID
+			if (invoice.payment_intent.payment_method) {
+				paymentMethodData = invoice.payment_intent.payment_method;
+			}
+			paymentIntentId = invoice.payment_intent.id;
+		}
+	}
+	
+	// Store payment method information for debugging
+	console.log(`Invoice ${invoice.id} payment method data:`, paymentMethodData ? 
+		JSON.stringify({
+			type: paymentMethodData.type,
+			card_country: paymentMethodData.card?.country
+		}) : 'null');
+	
+	// Skip if this payment intent was already processed
+	if (paymentIntentId && processedPaymentIntents.has(paymentIntentId)) {
+		console.log(`Invoice ${invoice.id} with payment intent ${paymentIntentId} already processed - skipping`);
+		return [];
+	}
+
+	// Track this payment intent
+	if (paymentIntentId) {
+		console.log(`Adding payment intent ${paymentIntentId} from invoice ${invoice.id} to tracked set`);
+		processedPaymentIntents.add(paymentIntentId);
+	}
+
+	const sales = [];
+	let totalStripeFee = null;
+
+	// Process each line item
+	invoice.lines.data.forEach((line, index) => {
+		const { associatedOrder, associatedTypeface } = findMatches({ invoice, line, sanitySales });
+		
+		// Check if this is a refund item
+		const isRefund = line.amount < 0;
+		
+		// Calculate parameters for fee calculation
+		const feeParams = {
+			line, 
+			invoice, 
+			associatedOrder, 
+			associatedTypeface,
+			isPrimaryItem: index === 0, // First item calculates the total fee
+			isRefund,
+			paymentMethodData
+		};
+		
+		// For the first non-refund item, calculate the total fee
+		if (index === 0 && !isRefund) {
+			const processedLine = processLineItem(feeParams);
+			// Store the total transaction fee for distribution
+			totalStripeFee = processedLine.totalTransactionFee || processedLine.stripeFees;
+			sales.push(processedLine);
+		} else {
+			// For subsequent items, pass the total fee for proportional distribution
+			const processedLine = processLineItem({
+				...feeParams,
+				totalFee: totalStripeFee
+			});
+			sales.push(processedLine);
+		}
+	});
+
+	// Process shipping if present
+	if (invoice?.shipping_cost?.amount_total) {
+		const shippingCost = processShippingCost({ 
+			invoice, 
+			associatedOrder: findMatches({ invoice, sanitySales }).associatedOrder,
+			totalFee: totalStripeFee, // Pass the total fee for proportional distribution
+			paymentMethodData // Pass the payment method data
+		});
+		if (shippingCost) {
+			sales.push(shippingCost);
+		}
+	}
+
+	return sales;
+}