@bisondesk/core-sdk 1.0.598 → 1.0.600

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/leasing.ts

@@ -1,5 +1,6 @@
 import { AttachmentValue, Document, LinkValue } from '@bisondesk/commons-sdk/types';
 import { BaseEvent } from './internal-events.js';
+import { VehiclePurchaseLogisticsStatus } from './vehicles.js';
 
 export enum LeasingContractActions {
   CREATE_FINANCE_DOCUMENT = 'create_finance_document',
@@ -453,9 +454,18 @@ export type VehicleRetakeRequest = {
   totalLoss?: boolean;
   cloneVehicle?: boolean;
   stopBilling?: boolean;
+  /** Initial logistics status of the cloned vehicle's purchase. Only honored when cloneVehicle is true. */
+  cloneLogisticsStatus?:
+    | VehiclePurchaseLogisticsStatus.AtOrigin
+    | VehiclePurchaseLogisticsStatus.Arrived;
 };
 
 export type LeasingContractEndRequest = {
   contractId: string;
   endDate?: string;
 };
+
+export type CloneRetakeVehicleRequest = {
+  /** Initial logistics status of the cloned vehicle's purchase. */
+  logisticsStatus: VehiclePurchaseLogisticsStatus.AtOrigin | VehiclePurchaseLogisticsStatus.Arrived;
+};

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',
@@ -343,6 +346,7 @@ export const QUOTE_NEEDS_VALIDATION_NOTIFICATION_ORIGIN = 'quote-validation';
 export const QUOTE_NOT_CREATED_BY_ACCOUNT_MANAGER = 'quote-not-created-by-account-manager';
 export const QUOTE_VALIDATOR_FEEDBACK_NOTIFICATION_ORIGIN = 'quote-validation-feedback';
 
+export const OPPORTUNITY_ASSIGNED_NOTIFICATION_ORIGIN = 'opportunity-assigned';
 export const OPPORTUNITY_VEHICLE_AVAILABLE_NOTIFICATION_ORIGIN = 'opportunity-vehicle-available';
 export const OPPORTUNITY_VEHICLE_DELIVERY_NOTIFICATION_ORIGIN = 'opportunity-vehicle-delivery';
 export const OPPORTUNITY_VEHICLE_RESERVATION_ABOUT_TO_EXPIRE_NOTIFICATION_ORIGIN =

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;

package/src/utils/contacts.ts

@@ -0,0 +1,16 @@
+export const JOB_CATEGORY_OTHER_ID = 'job_category_other';
+
+/**
+ * Resolves a contact's job to the value that downstream systems should see.
+ * When the picklist selection is "Other", the custom `jobOther` text takes precedence;
+ * otherwise the picklist id in `job` is returned as-is.
+ */
+export const resolveContactJob = (contact: {
+  job?: string;
+  jobOther?: string;
+}): string | undefined => {
+  if (contact.job === JOB_CATEGORY_OTHER_ID && contact.jobOther) {
+    return contact.jobOther;
+  }
+  return contact.job;
+};