@bisondesk/core-sdk 1.0.599 → 1.0.601

package/src/types/activities.ts

@@ -14,6 +14,12 @@ export enum ActivityActions {
   EDIT = 'edit',
 }
 
+export type ActivityContact = {
+  id?: string;
+  phoneNumber?: string;
+  email?: string;
+};
+
 export interface BaseActivity<Meta = ActivityV2Meta> {
   type: ActivityType;
   businessEntityId: BusinessEntityIds;
@@ -21,6 +27,8 @@ export interface BaseActivity<Meta = ActivityV2Meta> {
   description?: string;
   readonly?: boolean;
   meta?: Meta;
+  // The people called/emailed/etc in this activity.
+  contacts?: ActivityContact[];
 }
 
 export type NewActivity<Meta = ActivityV2Meta> = BaseActivity<Meta> & {
@@ -45,6 +53,7 @@ export type ActivityUpdate = {
   description?: string;
   type?: ActivityType;
   activityAt?: string;
+  contacts?: ActivityContact[];
 };
 
 export type ActivityEvent = BaseEvent &

package/src/types/analysis-purchases.ts

@@ -0,0 +1,128 @@
+import { ReferenceData } from '@bisondesk/commons-sdk/utils';
+
+export type AnalysisPurchasesMeta = {
+  referenceData: ReferenceData;
+};
+
+// ──────────────────────────────────────────────────────────────────────────
+// Segment insights ("what segment should we buy").
+//
+// A "segment" is a MINED combination of vehicle attributes (category + 1..N of
+// make+model, body style, euro norm, axle config, HP/age/mileage band, features)
+// discovered by frequent-itemset mining over the stock and sold
+// populations — as shallow as `Tipper · 6x4` or as deep as a near-full spec,
+// wherever the sales evidence sits. Segments overlap: one vehicle can belong
+// to several. Hot/cold rank the two ends of days-of-supply.
+// ──────────────────────────────────────────────────────────────────────────
+
+export type AnalysisPurchasesRequest = {
+  /** ISO date, inclusive */
+  from: string;
+  /** ISO date, exclusive */
+  to: string;
+};
+
+/** One component of a composite segment key (e.g. `{ dimension: 'make', label: 'DAF' }`). */
+export type SegmentPart = { dimension: string; key: string; label: string };
+
+export type SegmentExampleVehicle = {
+  vehicleId: string;
+  stockNumber: string;
+  imageUrl?: string;
+};
+
+export type SegmentVehicle = {
+  vehicleId: string;
+  stockNumber: string;
+  /** Precomputed vehicle display title (`vehicle.internal.description.title`). */
+  title?: string;
+  imageUrl?: string;
+  make: string;
+  modelName?: string;
+  advertisingYear?: number;
+  axleConfiguration?: string;
+  horsepower?: number;
+  currentPrice?: number;
+  /** Odometer reading in km (`vehicle.external.condition.odometer.km`). */
+  mileage?: number;
+  /** Registration country code, e.g. "BE" (`…history.currentRegistration.country`). */
+  countryCode?: string;
+  /** Sold units: the winning opportunity (`sale.opportunityId`) — for price + future deal details. */
+  opportunityId?: string;
+  /** Sold units: realized sale price (the won opportunity's amount). */
+  soldPrice?: number;
+  /** Hot (sold) examples: days from virtual-inventory entry to sale. */
+  daysToSell?: number;
+  /** Cold (stock) examples: days the unit has sat in inventory. */
+  daysOnLot?: number;
+};
+
+export type SegmentSummary = {
+  /** Stable composite key (join of each key-dimension's bucket key). */
+  key: string;
+  /** Human label, e.g. "DAF XF · Euro 6 · 4x2 · 450–499 HP · Lowdeck + Retarder". */
+  label: string;
+  parts: SegmentPart[];
+  customers: number;
+  /** Vehicles in this segment sold within the window (vehicle `custom.sold` + `sale.soldAt`). */
+  sold: number;
+  /**
+   * Days of supply: how long current unsold stock lasts at the window's sales rate
+   * (`stock × windowDays / sold`). Lower = runs out sooner = buy more. Undefined
+   * when nothing sold. This is the Hot ranking signal.
+   */
+  supplyDays?: number;
+  /** Days since the most recent purchase (check-in) of a unit in this segment. */
+  daysSinceLastPurchase?: number;
+  /** Days since the most recent sale of a unit in this segment. */
+  daysSinceLastSale?: number;
+  daysAvailableMedian?: number;
+  stock: number;
+  /**
+   * Median price for the segment: realized SALE price on the hot list (the won
+   * opportunities' amounts), current LIST price on the cold list. Undefined when
+   * the underlying units carry no price.
+   */
+  priceMedian?: number;
+  /** Populated only on the hot / cold lists. */
+  examples?: SegmentExampleVehicle[];
+};
+
+export type AnalysisPurchasesResponse = {
+  totals: {
+    stock: number;
+    /** Vehicles sold in the window (core categories) — the hot coverage denominator. */
+    sold: number;
+    /** Of those, how many fall in at least one hot (fast-moving) segment. */
+    hotSold: number;
+    /** Stock units falling in at least one cold (overstocked) segment. */
+    coldStock: number;
+  };
+  /** Under-supplied segments (buy more), each with in-demand example vehicles. */
+  hot: SegmentSummary[];
+  /** Over-supplied segments (slow down), each with stock-on-lot example vehicles. */
+  cold: SegmentSummary[];
+  meta: AnalysisPurchasesMeta;
+};
+
+/** Expand one segment into its individual units (the detail drawer). */
+export type SegmentUnitsRequest = AnalysisPurchasesRequest & {
+  /** Composite key of the segment to expand (a `SegmentSummary.key`). */
+  segmentKey: string;
+  /** Which list the segment came from — selects in-stock (cold) vs sold (hot) units. */
+  variant: 'hot' | 'cold';
+};
+
+export type SegmentUnitsResponse = {
+  key: string;
+  label: string;
+  parts: SegmentPart[];
+  variant: 'hot' | 'cold';
+  /** Segment-level counts (mirror SegmentSummary) so the drawer header needs no re-derivation. */
+  stock: number;
+  sold: number;
+  supplyDays?: number;
+  /** All units in the segment — in-stock with `daysOnLot` (cold) or sold with `daysToSell` (hot). */
+  units: SegmentVehicle[];
+  meta: AnalysisPurchasesMeta;
+};

package/src/types/import-markup.ts

@@ -0,0 +1,34 @@
+/**
+ * Per-tenant rule that marks up the **advertised** price of cross-tenant vehicle
+ * copies, without touching the cost recorded on the receiving tenant's purchase
+ * deal. Exactly one rule per tenant (singleton). Applied during cross-tenant sync
+ * while BisonDesk still owns the price (deal status `Marketing`); once an operator
+ * takes over pricing the rule no longer re-applies, so the markup never compounds.
+ *
+ * See `cross-tenant-sync/vehicles/markup.ts` for the application logic.
+ */
+export type ImportMarkupRule = {
+  /**
+   * Percentage added on top of the converted cost, e.g. `15` for +15%. `0` (or an
+   * absent rule) is a no-op — behaviour is identical to having no markup at all.
+   */
+  markupPercent: number;
+  /**
+   * Optional absolute floor on the margin amount, expressed in the tenant's
+   * `defaultCurrency`. Converted to the target branch currency at apply-time. When
+   * the percentage markup yields a smaller margin than this, the floor wins:
+   * `price = max(cost × (1 + markupPercent/100), cost + minMargin)`. Only applied
+   * to the primary branch-currency `price`/`previousPrice`, never to the
+   * multi-currency `localizedPricing` entries (where an absolute floor is undefined
+   * without per-currency configuration).
+   */
+  minMargin?: number;
+  /**
+   * Optional rounding granularity for the primary branch-currency
+   * `price`/`previousPrice`. The marked-up amount is rounded **up** to the nearest
+   * multiple of `roundingStep`, so rounding never undercuts the intended margin.
+   * Example: `1000` turns 47 320 into 48 000. `localizedPricing` entries are rounded
+   * to whole units only.
+   */
+  roundingStep?: number;
+};

package/src/types/leasing-debtors.ts

@@ -18,6 +18,7 @@ export type MonthData = {
 
 export type DebtorInfo = {
   clientId: string;
+  branchIds: string[];
   months: MonthData[];
 
   // properties related to the current month
@@ -247,6 +248,7 @@ export type LegalDossier = {
   id: string;
   debtorDossierId: string;
   caseNumber?: string;
+  courtDate?: string; // ISO date string (YYYY-MM-DD)
   notes?: string;
   createdAt: string;
   createdBy: string;
@@ -260,7 +262,9 @@ export type NewLegalDossier = Omit<
   'id' | 'createdAt' | 'updatedAt' | 'createdBy' | 'updatedBy'
 >;
 
-export type UpdateLegalDossier = Partial<Pick<LegalDossier, 'caseNumber' | 'status' | 'notes'>>;
+export type UpdateLegalDossier = Partial<
+  Pick<LegalDossier, 'caseNumber' | 'courtDate' | 'status' | 'notes'>
+>;
 
 /******
  * Debtor Dossier Events
@@ -307,6 +311,7 @@ export type SearchDebtorsDossier = {
   legalDossier?: LegalDossier;
   paymentPlan?: DebtorsPaymentPlan;
   hasPaymentPlan?: boolean;
+  branchIds?: string[];
   tasks: {
     totalTasks: number;
     openTasks: number;

package/src/types/leasing-search.ts

@@ -25,6 +25,8 @@ export type SearchLeasingContract = {
     lastIssuedInvoiceDate?: string;
     dealRating?: number;
     supplierName?: string;
+    hasActiveRecurrence?: boolean;
+    lastRecurrenceRunAt?: string;
   };
 };
 

package/src/types/offers.ts

@@ -274,6 +274,7 @@ export type SearchOffer = {
     totalBids: number;
     bidders: string[];
     missingSupplier: boolean;
+    accountManagers: string[];
   };
 };
 

package/src/types/opportunities.ts

@@ -140,13 +140,16 @@ type BaseOpportunity = {
   branchCountry: string;
 };
 
-export type NewOpportunity = BaseOpportunity & {
-  id?: undefined;
-  createdAt?: undefined;
-  createdBy?: undefined;
-  modifiedAt?: undefined;
-  modifiedBy?: undefined;
-};
+// type, branch and branchCountry are optional: when omitted, the server defaults them
+// from the requester's preferred branches/opportunity types, then the tenant defaults.
+export type NewOpportunity = Omit<BaseOpportunity, 'type' | 'branch' | 'branchCountry'> &
+  Partial<Pick<BaseOpportunity, 'type' | 'branch' | 'branchCountry'>> & {
+    id?: undefined;
+    createdAt?: undefined;
+    createdBy?: undefined;
+    modifiedAt?: undefined;
+    modifiedBy?: undefined;
+  };
 
 export enum VehicleSaleDealStatus {
   SaleAgreed = 'SALE_AGREED',

package/src/types/vehicles.ts

@@ -251,6 +251,8 @@ export type SearchVehicle = {
     priceChangedAt?: string;
     checkedInAt?: string;
     saleAgreementAt?: string;
+    /** Date the vehicle entered virtual inventory (marketing ?? evaluation ?? purchase-agreed). */
+    virtualInventoryStartedAt?: string;
   };
   purchase?: {
     supplierStockNumber?: string;