@bisondesk/core-sdk 1.0.609 → 1.0.610

package/lib/utils/accounting.js

@@ -17,4 +17,10 @@ export const tenantHasAccounting = (tenant) => {
     }
     return tenant.branches.some((b) => branchHasAccounting(b));
 };
+export const branchHasAccountingInTenant = (tenant, branchId) => {
+    if (tenant == null) {
+        return false;
+    }
+    return branchHasAccounting(tenant.branches.find((b) => b.id === branchId));
+};
 //# sourceMappingURL=accounting.js.map

package/lib/utils/accounting.js.map

@@ -1 +1 @@
-{"version":3,"file":"accounting.js","sourceRoot":"/","sources":["utils/accounting.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAA0B,EAAkC,EAAE;IAC3F,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAA0B,EAAW,EAAE,CACzE,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AAEjC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAA0B,EAAW,EAAE;IACzE,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC,CAAC","sourcesContent":["import { AccountingProvider, Branch, Tenant } from '../types/tenants.js';\n\nexport const branchProvider = (branch: Branch | undefined): AccountingProvider | undefined => {\n  if (branch == null) {\n    return undefined;\n  }\n  if (branch.accounting != null) {\n    return branch.accounting;\n  }\n  return branch.exactAccounting ? 'exact' : undefined;\n};\n\nexport const branchHasAccounting = (branch: Branch | undefined): boolean =>\n  branchProvider(branch) != null;\n\nexport const tenantHasAccounting = (tenant: Tenant | undefined): boolean => {\n  if (tenant == null) {\n    return false;\n  }\n  if (tenant.exactAccounting) {\n    return true;\n  }\n  return tenant.branches.some((b) => branchHasAccounting(b));\n};\n"]}
+{"version":3,"file":"accounting.js","sourceRoot":"/","sources":["utils/accounting.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAA0B,EAAkC,EAAE;IAC3F,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAA0B,EAAW,EAAE,CACzE,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AAEjC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAA0B,EAAW,EAAE;IACzE,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,MAA0B,EAC1B,QAAgB,EACP,EAAE;IACX,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC;AAC7E,CAAC,CAAC","sourcesContent":["import { AccountingProvider, Branch, Tenant } from '../types/tenants.js';\n\nexport const branchProvider = (branch: Branch | undefined): AccountingProvider | undefined => {\n  if (branch == null) {\n    return undefined;\n  }\n  if (branch.accounting != null) {\n    return branch.accounting;\n  }\n  return branch.exactAccounting ? 'exact' : undefined;\n};\n\nexport const branchHasAccounting = (branch: Branch | undefined): boolean =>\n  branchProvider(branch) != null;\n\nexport const tenantHasAccounting = (tenant: Tenant | undefined): boolean => {\n  if (tenant == null) {\n    return false;\n  }\n  if (tenant.exactAccounting) {\n    return true;\n  }\n  return tenant.branches.some((b) => branchHasAccounting(b));\n};\n\n/**\n * Whether a specific branch books through an accounting integration. Resolves\n * purely per branch — a tenant can mix accounting and non-accounting branches.\n * Accounting is carried on the branch (`accounting`, or the deprecated\n * `exactAccounting`), so the tenant-wide flag is not consulted.\n */\nexport const branchHasAccountingInTenant = (\n  tenant: Tenant | undefined,\n  branchId: string,\n): boolean => {\n  if (tenant == null) {\n    return false;\n  }\n  return branchHasAccounting(tenant.branches.find((b) => b.id === branchId));\n};\n"]}

package/lib/utils/accounting.test.js

@@ -1,4 +1,4 @@
-import { branchHasAccounting, branchProvider, tenantHasAccounting } from './accounting.js';
+import { branchHasAccounting, branchHasAccountingInTenant, branchProvider, tenantHasAccounting, } from './accounting.js';
 const makeBranch = (overrides = {}) => ({
     id: 'b1',
     name: 'Branch 1',
@@ -72,4 +72,22 @@ describe('tenantHasAccounting', () => {
         expect(tenantHasAccounting(undefined)).toBe(false);
     });
 });
+describe('branchHasAccountingInTenant', () => {
+    it('resolves per branch in a mixed tenant', () => {
+        const tenant = makeTenant([
+            makeBranch({ id: 'odoo-branch', accounting: 'odoo' }),
+            makeBranch({ id: 'plain-branch' }),
+        ]);
+        expect(branchHasAccountingInTenant(tenant, 'odoo-branch')).toBe(true);
+        expect(branchHasAccountingInTenant(tenant, 'plain-branch')).toBe(false);
+    });
+    it('ignores the deprecated tenant-wide flag and resolves per branch', () => {
+        const tenant = makeTenant([makeBranch({ id: 'plain-branch' })], { exactAccounting: true });
+        expect(branchHasAccountingInTenant(tenant, 'plain-branch')).toBe(false);
+    });
+    it('is false for an unknown branch or missing tenant', () => {
+        expect(branchHasAccountingInTenant(makeTenant([makeBranch()]), 'nope')).toBe(false);
+        expect(branchHasAccountingInTenant(undefined, 'b1')).toBe(false);
+    });
+});
 //# sourceMappingURL=accounting.test.js.map

package/lib/utils/accounting.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"accounting.test.js","sourceRoot":"/","sources":["utils/accounting.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Branch, Tenant } from '../types/tenants.js';\nimport { branchHasAccounting, branchProvider, tenantHasAccounting } from './accounting.js';\n\nconst makeBranch = (overrides: Partial<Branch> = {}): Branch => ({\n  id: 'b1',\n  name: 'Branch 1',\n  country: 'ci',\n  language: 'fr',\n  currency: 'XOF',\n  adminNumberPrefix: '',\n  stockNumberPrefix: '',\n  vatNumber: '',\n  vatRates: { standard: '18' },\n  location: { country: 'ci' },\n  ...overrides,\n});\n\nconst makeTenant = (branches: Branch[], overrides: Partial<Tenant> = {}): Tenant =>\n  ({\n    id: 't',\n    name: 't',\n    region: 'eu-west-1',\n    defaultCountry: 'ci',\n    defaultCurrency: 'XOF',\n    defaultLanguage: 'fr',\n    subdomains: ['t'],\n    languages: ['fr'],\n    emailDomain: 'example.com',\n    branches: branches as [Branch, ...Branch[]],\n    modules: [],\n    opportunities: { types: [] },\n    ...overrides,\n  }) as Tenant;\n\ndescribe('branchProvider', () => {\n  it('returns undefined for missing branch', () => {\n    expect(branchProvider(undefined)).toBeUndefined();\n  });\n\n  it('prefers the new discriminator over the legacy boolean', () => {\n    const branch = makeBranch({ accounting: 'odoo', exactAccounting: true });\n    expect(branchProvider(branch)).toBe('odoo');\n  });\n\n  it('falls back to legacy boolean as exact', () => {\n    const branch = makeBranch({ exactAccounting: true });\n    expect(branchProvider(branch)).toBe('exact');\n  });\n\n  it('returns undefined when neither field is set', () => {\n    expect(branchProvider(makeBranch())).toBeUndefined();\n  });\n\n  it('returns undefined when legacy boolean is false', () => {\n    expect(branchProvider(makeBranch({ exactAccounting: false }))).toBeUndefined();\n  });\n});\n\ndescribe('branchHasAccounting', () => {\n  it('is true when accounting is set', () => {\n    expect(branchHasAccounting(makeBranch({ accounting: 'odoo' }))).toBe(true);\n  });\n\n  it('is true when legacy exactAccounting is true', () => {\n    expect(branchHasAccounting(makeBranch({ exactAccounting: true }))).toBe(true);\n  });\n\n  it('is false otherwise', () => {\n    expect(branchHasAccounting(makeBranch())).toBe(false);\n    expect(branchHasAccounting(undefined)).toBe(false);\n  });\n});\n\ndescribe('tenantHasAccounting', () => {\n  it('is true when tenant-level legacy flag is set', () => {\n    const tenant = makeTenant([makeBranch()], { exactAccounting: true });\n    expect(tenantHasAccounting(tenant)).toBe(true);\n  });\n\n  it('is true when any branch has accounting', () => {\n    const tenant = makeTenant([makeBranch(), makeBranch({ id: 'b2', accounting: 'odoo' })]);\n    expect(tenantHasAccounting(tenant)).toBe(true);\n  });\n\n  it('is false when no branch has accounting and tenant flag is not set', () => {\n    expect(tenantHasAccounting(makeTenant([makeBranch()]))).toBe(false);\n    expect(tenantHasAccounting(undefined)).toBe(false);\n  });\n});\n"]}
+{"version":3,"file":"accounting.test.js","sourceRoot":"/","sources":["utils/accounting.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Branch, Tenant } from '../types/tenants.js';\nimport {\n  branchHasAccounting,\n  branchHasAccountingInTenant,\n  branchProvider,\n  tenantHasAccounting,\n} from './accounting.js';\n\nconst makeBranch = (overrides: Partial<Branch> = {}): Branch => ({\n  id: 'b1',\n  name: 'Branch 1',\n  country: 'ci',\n  language: 'fr',\n  currency: 'XOF',\n  adminNumberPrefix: '',\n  stockNumberPrefix: '',\n  vatNumber: '',\n  vatRates: { standard: '18' },\n  location: { country: 'ci' },\n  ...overrides,\n});\n\nconst makeTenant = (branches: Branch[], overrides: Partial<Tenant> = {}): Tenant =>\n  ({\n    id: 't',\n    name: 't',\n    region: 'eu-west-1',\n    defaultCountry: 'ci',\n    defaultCurrency: 'XOF',\n    defaultLanguage: 'fr',\n    subdomains: ['t'],\n    languages: ['fr'],\n    emailDomain: 'example.com',\n    branches: branches as [Branch, ...Branch[]],\n    modules: [],\n    opportunities: { types: [] },\n    ...overrides,\n  }) as Tenant;\n\ndescribe('branchProvider', () => {\n  it('returns undefined for missing branch', () => {\n    expect(branchProvider(undefined)).toBeUndefined();\n  });\n\n  it('prefers the new discriminator over the legacy boolean', () => {\n    const branch = makeBranch({ accounting: 'odoo', exactAccounting: true });\n    expect(branchProvider(branch)).toBe('odoo');\n  });\n\n  it('falls back to legacy boolean as exact', () => {\n    const branch = makeBranch({ exactAccounting: true });\n    expect(branchProvider(branch)).toBe('exact');\n  });\n\n  it('returns undefined when neither field is set', () => {\n    expect(branchProvider(makeBranch())).toBeUndefined();\n  });\n\n  it('returns undefined when legacy boolean is false', () => {\n    expect(branchProvider(makeBranch({ exactAccounting: false }))).toBeUndefined();\n  });\n});\n\ndescribe('branchHasAccounting', () => {\n  it('is true when accounting is set', () => {\n    expect(branchHasAccounting(makeBranch({ accounting: 'odoo' }))).toBe(true);\n  });\n\n  it('is true when legacy exactAccounting is true', () => {\n    expect(branchHasAccounting(makeBranch({ exactAccounting: true }))).toBe(true);\n  });\n\n  it('is false otherwise', () => {\n    expect(branchHasAccounting(makeBranch())).toBe(false);\n    expect(branchHasAccounting(undefined)).toBe(false);\n  });\n});\n\ndescribe('tenantHasAccounting', () => {\n  it('is true when tenant-level legacy flag is set', () => {\n    const tenant = makeTenant([makeBranch()], { exactAccounting: true });\n    expect(tenantHasAccounting(tenant)).toBe(true);\n  });\n\n  it('is true when any branch has accounting', () => {\n    const tenant = makeTenant([makeBranch(), makeBranch({ id: 'b2', accounting: 'odoo' })]);\n    expect(tenantHasAccounting(tenant)).toBe(true);\n  });\n\n  it('is false when no branch has accounting and tenant flag is not set', () => {\n    expect(tenantHasAccounting(makeTenant([makeBranch()]))).toBe(false);\n    expect(tenantHasAccounting(undefined)).toBe(false);\n  });\n});\n\ndescribe('branchHasAccountingInTenant', () => {\n  it('resolves per branch in a mixed tenant', () => {\n    const tenant = makeTenant([\n      makeBranch({ id: 'odoo-branch', accounting: 'odoo' }),\n      makeBranch({ id: 'plain-branch' }),\n    ]);\n    expect(branchHasAccountingInTenant(tenant, 'odoo-branch')).toBe(true);\n    expect(branchHasAccountingInTenant(tenant, 'plain-branch')).toBe(false);\n  });\n\n  it('ignores the deprecated tenant-wide flag and resolves per branch', () => {\n    const tenant = makeTenant([makeBranch({ id: 'plain-branch' })], { exactAccounting: true });\n    expect(branchHasAccountingInTenant(tenant, 'plain-branch')).toBe(false);\n  });\n\n  it('is false for an unknown branch or missing tenant', () => {\n    expect(branchHasAccountingInTenant(makeTenant([makeBranch()]), 'nope')).toBe(false);\n    expect(branchHasAccountingInTenant(undefined, 'b1')).toBe(false);\n  });\n});\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bisondesk/core-sdk",
-  "version": "1.0.609",
+  "version": "1.0.610",
   "description": "",
   "type": "module",
   "author": "TheTruckCompany",

package/src/constants.ts

@@ -1000,8 +1000,14 @@ export const AXLE_CONFIG: { [config: string]: VehicleAxle[] } = {
   ],
 };
 
+// The operational debtors index / browse table keeps 6 months. The leasing report's
+// deeper history lives in a separate `debtors_history` index (see DEBTORS_HISTORY_MONTHS).
 export const DEBTORS_MONTHS_UNTIL_TODAY_COUNT = 6;
 
+// Depth of the separate `debtors_history` index that backs the leasing report. 24 covers
+// "last year" and its YoY (which needs the December of two years ago, up to 24 months back).
+export const DEBTORS_HISTORY_MONTHS = 24;
+
 // Email Template IDs
 export const VEHICLE_SHARE_TEMPLATE_ID = 'vehicle-share';
 export const VEHICLE_MARKETING_CAMPAIGN_TEMPLATE_ID = 'vehicle-marketing-campaign';

package/src/types/leasing-debtors.ts

@@ -14,6 +14,9 @@ export type MonthData = {
   overdueInvoiceIds: string[];
   riskLevel: number;
   monthlyInvoicedAmount: string;
+  // Non-leasing ("extra") debt for this month, computed as-of month-end.
+  nonLeasingOverdueAmount: string;
+  nonLeasingUnpaidAmount: string;
 };
 
 export type DebtorInfo = {

package/src/types/opportunities.ts

@@ -316,6 +316,14 @@ export type QuoteInfo = {
   status: QuoteStatus;
   roi: string;
   id: string;
+  // Leasing-only metrics, denormalized from the active leasing quote so the leasing report
+  // can take medians without re-reading each quote. Absent on non-leasing quotes.
+  /** Leasing term in months (`calculatorInput.leasing.duration`). */
+  durationMonths?: number;
+  /** Yearly ROI as a percentage 0–100 (`calculatorOutput.roi.perYear`). */
+  roiPerYear?: number;
+  /** Advance (deposit) as a percentage 0–100 (`calculatorInput.leasing.depositPercentage`). */
+  advancePercentage?: number;
 };
 
 export type SearchOpportunity = {
@@ -341,6 +349,9 @@ export type SearchOpportunity = {
     // Calendar days from min(marketingAt, evaluationAt, purchaseAgreedAt) until validatedAt.
     // Mirrors `daysInVirtualInventory` on the vehicle Business Overview page.
     daysAvailable?: number;
+    // Operational supplier for reporting. For SLB clones this is the source vehicle supplier,
+    // not the bank supplier on the clone purchase.
+    realSupplierId?: string;
   };
 };
 

package/src/types/reports-leasing.ts

@@ -0,0 +1,186 @@
+/**
+ * Leasing report — the payload for the `Reports → Leasing` tab. Computed entirely from
+ * OpenSearch: receivables (`finance_docs`), contracts (`leasing_contracts`), leasing
+ * opportunities (`opportunities`) and client risk (`debtors`).
+ *
+ * Every metric except the fixed cumulative chart is evaluated over — or as of the end
+ * of — the selected whole-month window. `asOf = window.end`: `now` for `mtd`/`ytd`, and
+ * the period boundary for historical ranges (so "last year" shows the state at the end
+ * of last year). Flow metrics (invoiced, contracts started/ended, opportunities) sum over
+ * the window; point-in-time metrics (overdue, aging, active contracts, risk) are
+ * reconstructed as of `asOf`.
+ *
+ * The API returns raw numbers only; the client formats (€, %) and colors the deltas.
+ */
+
+import { YoyMetric } from './reports-sales.js';
+
+/**
+ * Period presets driving every metric except the fixed cumulative chart, in selector
+ * order. All are month-aligned (contracts start on the 1st of a month), so there are no
+ * day-based ranges. `mtd`/`ytd` are to-date; `last{3,6,12}Months` are complete months
+ * from the first of a month back to the start of the current month; `lastMonth`/
+ * `lastYear` are the previous complete calendar month/year.
+ */
+export const LEASING_PERIOD_KEYS = [
+  'mtd',
+  'ytd',
+  'lastMonth',
+  'last3Months',
+  'last6Months',
+  'last12Months',
+  'lastYear',
+] as const;
+
+export type LeasingPeriodKey = (typeof LEASING_PERIOD_KEYS)[number];
+
+export const DEFAULT_LEASING_PERIOD: LeasingPeriodKey = 'mtd';
+
+export type LeasingReportRequest = { period: LeasingPeriodKey };
+
+export type { YoyMetric };
+
+/** Outstanding-invoice age bands, in calendar months from issue date as of the window end. */
+export type LeasingAgingBucketKey = '0-1' | '1-2' | '2-3' | '3-12' | '1y+';
+
+export type LeasingAgingBucket = {
+  bucket: LeasingAgingBucketKey;
+  /** Outstanding amount (excl VAT) in this age band, as of the window end. */
+  amount: number;
+};
+
+export type LeasingCategorySplit = {
+  /** Vehicle category from `vehicle.external.general.category` (e.g. "Tractor Head"). */
+  category: string;
+  count: number;
+  /** Share of opportunities into preparation in the current window, 0–100. */
+  sharePct: number;
+};
+
+export type LeasingSalesperson = {
+  /** User id from `opportunity.accountManager`; the client resolves name + avatar. */
+  id: string;
+  units: number;
+  yoyPct: number | null;
+};
+
+export type LeasingOppCountry = {
+  /** ISO country code (lowercase) from `org.countryCode`. */
+  code: string;
+  units: number;
+  /** Share of opportunities into preparation in the current window, 0–100. */
+  sharePct: number;
+};
+
+export type LeasingRealSupplier = {
+  /** CRM organization id for the operational supplier. */
+  id: string;
+  /** CRM organization name at report generation time; falls back to `id` when unavailable. */
+  name: string;
+  units: number;
+  /** Share of opportunities with a resolved real supplier in the current window, 0–100. */
+  sharePct: number;
+  yoyPct: number | null;
+};
+
+export type LeasingCumulativeBucket = {
+  /** Calendar month, 1–12. */
+  month: number;
+  /** Cumulative new contracts started this calendar year through this month. */
+  thisYear: number;
+  /** Cumulative new contracts started last calendar year through this month. */
+  lastYear: number;
+};
+
+export type LeasingOverdueBucket = {
+  /** `YYYY-MM` month. */
+  month: string;
+  /** Overdue rent amount (excl VAT) as of the end of that month. */
+  amount: number;
+};
+
+export type LeasingReportResponse = {
+  period: {
+    key: LeasingPeriodKey;
+    /** Current window, half-open `[start, end)` (ISO strings). `end` is `asOf`. */
+    start: string;
+    end: string;
+    /** Number of days in the window. */
+    days: number;
+    /** Year-ago window `[yoyStart, yoyEnd)`. */
+    yoyStart: string;
+    yoyEnd: string;
+  };
+  receivables: {
+    /** Net invoiced (invoices − credit notes), excl VAT, over the window. */
+    invoiced: YoyMetric;
+    /** Overdue (excl VAT) as of the window end (+ as of end − 1y). */
+    overdue: YoyMetric;
+    /**
+     * `overdue / total outstanding` as a fraction 0–1, both from finance_docs as of the window
+     * end (overdue ÷ all unpaid rent). Null when nothing is outstanding.
+     */
+    overdueShareOfOutstanding: number | null;
+    /**
+     * Share of total outstanding rent held by the 10 largest debtors (concentration), as a
+     * fraction 0–1. Null when nothing is outstanding.
+     */
+    top10ClientShare: number | null;
+  };
+  /** Outstanding leasing invoices by issue-date age, as of the window end. */
+  aging: LeasingAgingBucket[];
+  contracts: {
+    /** Active contracts as of the window end (+ as of end − 1y). */
+    active: YoyMetric;
+    /** New contracts started over the window. */
+    started: YoyMetric;
+    /** Contracts that ended over the window (actual end date in range, excludes discarded). */
+    ended: YoyMetric;
+  };
+  opportunities: {
+    /** Leasing opportunities entering Preparation over the window. */
+    intoPreparation: YoyMetric;
+    /** Median opportunity amount over the window. */
+    medianPrice: YoyMetric;
+    /** Median leasing term in months, from each opp's active leasing quote. */
+    medianDuration: YoyMetric;
+    /** Median yearly ROI as a percentage 0–100, from each opp's active leasing quote. */
+    medianRoiPerYear: YoyMetric;
+    /** 75th-percentile yearly ROI (%) over the current window; null if no quotes. */
+    roiPerYearP75: number | null;
+    /** Median advance (deposit) as a percentage 0–100, from each opp's active leasing quote. */
+    medianAdvancePct: YoyMetric;
+    /** Vehicle category split of opportunities into Preparation (current window). */
+    categorySplit: LeasingCategorySplit[];
+    /** Sellers ranked by opportunities into Preparation (current units desc), with YoY. */
+    salespeople: LeasingSalesperson[];
+    /** Real suppliers ranked by opportunities into Preparation (current units desc), with YoY. */
+    realSuppliers: LeasingRealSupplier[];
+    /** Org-country split of opportunities into Preparation (current window). */
+    countries: LeasingOppCountry[];
+  };
+  // Client risk, as of the snapshot month. `riskLevel` is zero-inflated (most clients
+  // are 0), so this is the at-risk tail shape, not a central statistic.
+  risk: {
+    /** Active-contract clients with non-zero risk, with YoY. */
+    clientsAtRisk: YoyMetric;
+    /** Total active-contract clients (the at-risk denominator). */
+    activeClients: number;
+    /** Severity-band counts of at-risk clients (`riskLevel` floored: levels 1/2/3/4+). */
+    bands: { band: string; count: number }[];
+  };
+  /** Fixed 12-month cumulative new contracts, this calendar year vs last. */
+  cumulativeContracts: LeasingCumulativeBucket[];
+  /** Fixed trailing-6-month overdue rent amount (excl VAT), as of each month-end. */
+  overdueHistory: LeasingOverdueBucket[];
+  /** Track-and-trace fleet usage over the window. */
+  fleet: {
+    /**
+     * Median `last30DaysKm` across wired track-and-trace devices that pinged within the window;
+     * null when no such device. From the `track_and_trace_devices` index.
+     */
+    medianKm30d: number | null;
+    /** Number of wired devices (carrying a km value) the median was taken over. */
+    deviceCount: number;
+  };
+};

package/src/types/reports-sales.ts

@@ -1,8 +1,9 @@
 /**
- * Sales report — the payload for the `Reports → Sales` tab. Everything is computed
- * from the per-tenant `opportunities` OpenSearch index, keyed on
+ * Sales report — the payload for the `Reports → Sales` tab. Sales-side metrics
+ * are computed from the per-tenant `opportunities` OpenSearch index, keyed on
  * `opportunity.reviewedAt` (the moment an opportunity ENTERS Preparation — our
- * "sale" event; `preparedAt` is when it leaves Preparation into Delivery).
+ * "sale" event; `preparedAt` is when it leaves Preparation into Delivery). The
+ * buyer ranking comes from the vehicles index, keyed on `purchase.purchaseAgreedAt`.
  *
  * The API returns raw numbers only; the client formats (€, %, pp, "younger") and
  * colors the deltas.
@@ -66,6 +67,13 @@ export type SalesReportSalesperson = {
   yoyPct: number | null;
 };
 
+export type SalesReportBuyer = {
+  /** User id from `purchase.purchasedBy`; the client resolves name + avatar. */
+  id: string;
+  units: number;
+  yoyPct: number | null;
+};
+
 export type SalesReportMake = {
   /** Vehicle make name from `vehicle.external.general.make` (stored verbatim, e.g. "DAF"). */
   make: string;
@@ -127,6 +135,8 @@ export type SalesReportResponse = {
   makes: SalesReportMake[];
   /** All sales people with units in either window (capped; the client list scrolls). */
   salespeople: SalesReportSalesperson[];
+  /** All purchasers with vehicles bought in the current window (capped; the client list scrolls). */
+  buyers: SalesReportBuyer[];
   /** Returning-customer tenure shares (4 buckets). */
   returning: TenureBucket[];
   conglomerate: SalesReportConglomerate;

package/src/types/vehicles.ts

@@ -260,6 +260,7 @@ export type SearchVehicle = {
     dealStatus?: VehiclePurchaseDealStatus;
     logisticsStatus?: VehiclePurchaseLogisticsStatus;
     purchasedBy?: string;
+    purchaseAgreedAt?: string;
     parkingName?: string;
     organizationId: string;
     organizationExternalId?: number;

package/src/utils/accounting.test.ts

@@ -1,5 +1,10 @@
 import { Branch, Tenant } from '../types/tenants.js';
-import { branchHasAccounting, branchProvider, tenantHasAccounting } from './accounting.js';
+import {
+  branchHasAccounting,
+  branchHasAccountingInTenant,
+  branchProvider,
+  tenantHasAccounting,
+} from './accounting.js';
 
 const makeBranch = (overrides: Partial<Branch> = {}): Branch => ({
   id: 'b1',
@@ -87,3 +92,24 @@ describe('tenantHasAccounting', () => {
     expect(tenantHasAccounting(undefined)).toBe(false);
   });
 });
+
+describe('branchHasAccountingInTenant', () => {
+  it('resolves per branch in a mixed tenant', () => {
+    const tenant = makeTenant([
+      makeBranch({ id: 'odoo-branch', accounting: 'odoo' }),
+      makeBranch({ id: 'plain-branch' }),
+    ]);
+    expect(branchHasAccountingInTenant(tenant, 'odoo-branch')).toBe(true);
+    expect(branchHasAccountingInTenant(tenant, 'plain-branch')).toBe(false);
+  });
+
+  it('ignores the deprecated tenant-wide flag and resolves per branch', () => {
+    const tenant = makeTenant([makeBranch({ id: 'plain-branch' })], { exactAccounting: true });
+    expect(branchHasAccountingInTenant(tenant, 'plain-branch')).toBe(false);
+  });
+
+  it('is false for an unknown branch or missing tenant', () => {
+    expect(branchHasAccountingInTenant(makeTenant([makeBranch()]), 'nope')).toBe(false);
+    expect(branchHasAccountingInTenant(undefined, 'b1')).toBe(false);
+  });
+});

package/src/utils/accounting.ts

@@ -22,3 +22,19 @@ export const tenantHasAccounting = (tenant: Tenant | undefined): boolean => {
   }
   return tenant.branches.some((b) => branchHasAccounting(b));
 };
+
+/**
+ * Whether a specific branch books through an accounting integration. Resolves
+ * purely per branch — a tenant can mix accounting and non-accounting branches.
+ * Accounting is carried on the branch (`accounting`, or the deprecated
+ * `exactAccounting`), so the tenant-wide flag is not consulted.
+ */
+export const branchHasAccountingInTenant = (
+  tenant: Tenant | undefined,
+  branchId: string,
+): boolean => {
+  if (tenant == null) {
+    return false;
+  }
+  return branchHasAccounting(tenant.branches.find((b) => b.id === branchId));
+};