{"ok":true,"commandType":"read-item-sales-by-customer","module":"Sales","mode":"read","summary":"Rank customers who bought an item by quantity and amount.","payloadSchema":{"itemCode":"required stock item code","fromDate":"YYYY-MM-DD optional; dateFrom also accepted","toDate":"YYYY-MM-DD optional; dateTo also accepted","limit":"optional maximum customer rows, default 100, max 500","includeInvoices":"optional boolean, default true","includeCashSales":"optional boolean, default true"},"examplePayload":{"itemCode":"00002","fromDate":"2020-01-01","toDate":"2026-07-19","limit":10},"notes":"Use this when asking who bought the most of one item. It reads sales invoice and cash sale detail lines, groups by debtor/customer, and returns TotalQty, TotalAmount, DocumentCount, FirstDocDate, and LastDocDate.","nativePayload":{"supported":false,"sections":[{"name":"Master","fields":[]},{"name":"Details","fields":[]},{"name":"KnockOffDetails","fields":[]},{"name":"TransferDetails","fields":[]},{"name":"PaymentDetails","fields":[]},{"name":"Options","fields":[]}]}}