@bisondesk/core-sdk 1.0.643 → 1.0.645

package/src/types/transports.ts

@@ -1,9 +1,15 @@
-import { LocationValue, NextList, PaginatedList } from '@bisondesk/commons-sdk/types';
+import { GPSCoord, NextList, PaginatedList } from '@bisondesk/commons-sdk/types';
 import { Organization } from './crm.js';
-import { Opportunity } from './opportunities.js';
-import { DeliveryTypes } from './quotes.js';
+import { BaseEvent } from './internal-events.js';
+import { Opportunity, OpportunityPaymentStatus } from './opportunities.js';
+import {
+  AddressDeliveryType,
+  DeliveryTypes,
+  PickUpDeliveryType,
+  PortDeliverytype,
+} from './quotes.js';
 import { BaseSearchRequest, SortOrder } from './search.js';
-import { ReferenceData } from './utils.js';
+import { DataRecord, ReferenceData } from './utils.js';
 import { Vehicle, VehiclePurchase } from './vehicles.js';
 
 export enum TransportType {
@@ -42,49 +48,66 @@ export enum TransportPriority {
   Urgent = 'URGENT',
 }
 
-export const TransportDeliveryType = {
+export const TransportSalesDeliveryType = {
   Address: DeliveryTypes.ADDRESS,
   Port: DeliveryTypes.PORT,
   PortAndShip: DeliveryTypes.PORT_AND_SHIP,
+  PickUp: DeliveryTypes.PICK_UP,
 } as const;
 
-export type TransportDeliveryType =
-  (typeof TransportDeliveryType)[keyof typeof TransportDeliveryType];
+/**
+ * The customer collects the vehicle. Nothing is driven anywhere, but the papers still have to be
+ * arranged and paid for — transit plates, technical control, insurance — which is why it is a
+ * delivery type administration reviews rather than the absence of one.
+ *
+ * `dateOfPickUpByCustomer` is dropped from the quote's shape: the transport's own `date` is the
+ * collection day, and two fields for one date only ever disagree.
+ */
+export type TransportPickUpDeliveryType = Omit<PickUpDeliveryType, 'dateOfPickUpByCustomer'>;
+
+export type TransportSalesDeliveryType = (
+  | PortDeliverytype
+  | AddressDeliveryType
+  | TransportPickUpDeliveryType
+) & {
+  cleaningNeeded?: boolean;
+  driver?: string;
+  transportCompany?: string;
+  date?: string; // Pick-up (purchase) | Delivery (OPP) (leaves parking)
+  adminCost?: string; // user-entered administrative cost summed into totalCostExclVat
+  stackingVehicleCostPrice?: string; // overrides the stacking rate from the delivery settings
+};
+
+export type TransportPurchaseDeliveryType = AddressDeliveryType & {
+  cleaningNeeded?: boolean;
+  driver?: string;
+  transportCompany?: string;
+  date?: string; // Pick-up (purchase) | Delivery (OPP) (leaves parking)
+  adminCost?: string; // user-entered administrative cost summed into totalCostExclVat
+  stackingVehicleCostPrice?: string; // overrides the stacking rate from the delivery settings
+};
 
 export type Transport = {
   id: string;
   vehicleId: string;
   opportunityId?: string;
 
-  type: TransportType;
-  deliveryType: TransportDeliveryType;
   status: TransportStatus;
-
   priority: TransportPriority;
 
   // administrative fields
   adminApproved: boolean;
-
+  adminApprovedAt?: string;
+  adminApprovedBy?: string;
+  transportWithoutPayment?: boolean;
   notes?: string;
 
-  // semi-trailer specific fields
-  cleaningNeeded?: boolean;
-  stacking?: boolean;
-  stackingDetails?: string;
-
-  port?: {
-    sourcePort?: string;
-    destinationPort?: string;
-
-    deliveryLocation?: string;
-    bookingRef?: string;
-    shippingCompany?: string;
-    ets?: string;
-    eta?: string;
+  totals: {
+    totalRetailAmountExclVat: string;
+    totalCostExclVat: string;
+    estimatedTotalCostExclVat?: string;
   };
 
-  address?: LocationValue;
-
   log: Array<{
     status: TransportStatus;
     completedAt: string;
@@ -100,7 +123,16 @@ export type Transport = {
   createdBy: string;
   updatedAt: string;
   updatedBy: string;
-};
+} & (
+  | {
+      type: TransportType.PurchasePickUp;
+      delivery: TransportPurchaseDeliveryType;
+    }
+  | {
+      type: TransportType.SaleDelivery;
+      delivery: TransportSalesDeliveryType;
+    }
+);
 
 export enum TransportWarningCode {
   PurchaseLogisticsNotReady = 'purchase_logistics_not_ready',
@@ -111,15 +143,108 @@ export type TransportWarning = {
   details?: Record<string, string | number | boolean>;
 };
 
+export type TransportCost = Pick<Transport, 'totals'>;
+
+export type TransportRecord = DataRecord<Transport>;
+
+/**
+ * What a requester may change on a transport, field group by field group. The server filters an
+ * update through these and returns the ones granted on the record, so the drawer disables what the
+ * user cannot touch instead of deciding for itself from the user's roles.
+ */
+export enum TransportActions {
+  /** The route: addresses, ports, dates, costs. */
+  SetDelivery = 'set_delivery',
+  SetNotes = 'set_notes',
+  /** The administrative sign-off, and the clearance to move before the payment. */
+  SetApproval = 'set_approval',
+  /** The board column. */
+  SetStatus = 'set_status',
+  SetPriority = 'set_priority',
+  SetBookingRef = 'set_booking_ref',
+}
+
+/**
+ * Every field a write may set, in one shape. `delivery` is replaced whole when it is sent — there is
+ * no partial merge into the stored one — which is why `bookingRef` rides alongside as a scalar the
+ * server writes into the delivery it ends up with.
+ */
+export type TransportUpdate = {
+  delivery?: TransportSalesDeliveryType | TransportPurchaseDeliveryType;
+  notes?: string | null;
+  adminApproved?: boolean;
+  transportWithoutPayment?: boolean;
+  status?: TransportStatus;
+  priority?: TransportPriority;
+  bookingRef?: string | null;
+};
+
+type BaseTransportEvent = {
+  actionAt: string;
+  userId: string;
+  tenantId: string;
+  transportId: string;
+};
+
+export type TransportCreateEvent = BaseTransportEvent & {
+  action: 'create';
+  data: Transport;
+  previousData?: undefined;
+};
+
+export type TransportUpdateEvent = BaseTransportEvent & {
+  action: 'update';
+  data: Transport;
+  previousData: Transport;
+};
+
+/** Published whenever a transport is written. Carries both sides so subscribers judge relevance. */
+export type TransportEvent = BaseEvent & (TransportCreateEvent | TransportUpdateEvent);
+
+/**
+ * Where the money stands on the record the transport serves: the customer's payments on the
+ * opportunity for a sale delivery, ours to the supplier for a purchase pick-up. Denormalised at
+ * indexing time so the board can show it without joining.
+ */
+export type TransportPayment = {
+  status: OpportunityPaymentStatus;
+  /** Only a sale delivery knows the ratio — a pick-up has milestones, not a running total. */
+  percentagePaid?: string;
+};
+
+/** Which address the map pin came from, so the UI can tell an exact pin from an approximate one. */
+export enum TransportLocationSource {
+  DeliveryAddress = 'delivery_address',
+  OriginPort = 'origin_port',
+  OrgAddress = 'org_address',
+}
+
 export type SearchTransport = {
   transport: Transport;
   vehicle: Vehicle;
   org: Organization;
   opportunity?: Opportunity;
   purchase: VehiclePurchase;
+  tasks: {
+    totalTasks: number;
+    openTasks: number;
+    nextDueAt?: string;
+  };
   custom: {
     commercialUserIds: string[];
     warnings: TransportWarning[];
+    priorityOrdinal: number;
+    payment: TransportPayment;
+    /**
+     * Where the transport happens: the delivery address, or the origin port for a shipped delivery.
+     * Denormalised into one field because the map clusters over a single geo_point, and a port
+     * delivery carries no address of its own.
+     *
+     * Deliberately narrower than `GPSCoord`: a geo_point field rejects any key beyond lat/lon, so
+     * the map zoom the coordinates picker stores must not reach the index.
+     */
+    location?: Pick<GPSCoord, 'lat' | 'lon'>;
+    locationSource?: TransportLocationSource;
   };
 };
 

package/src/types/utils.js

@@ -0,0 +1,2 @@
+export * from '@bisondesk/commons-sdk/utils';
+//# sourceMappingURL=utils.js.map

package/src/types/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["utils.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/src/types/vehicles.js

@@ -0,0 +1,94 @@
+export var VehicleRoles;
+(function (VehicleRoles) {
+    VehicleRoles["SALE"] = "SALE";
+    VehicleRoles["OWN_USE"] = "OWN_USE";
+    VehicleRoles["RENTAL"] = "RENTAL";
+    VehicleRoles["BUILD"] = "BUILD";
+    VehicleRoles["UNKNOWN"] = "UNKNOWN";
+    VehicleRoles["BANK_FINANCE"] = "BANK_FINANCE";
+})(VehicleRoles || (VehicleRoles = {}));
+export var VehicleFuelType;
+(function (VehicleFuelType) {
+    VehicleFuelType["Petrol"] = "PETROL";
+    VehicleFuelType["Diesel"] = "DIESEL";
+    VehicleFuelType["LPG"] = "LPG";
+    VehicleFuelType["LPG_G3"] = "LPG_G3";
+    VehicleFuelType["Electric"] = "ELECTRIC";
+    VehicleFuelType["CNG"] = "CNG";
+    VehicleFuelType["Hydrogen"] = "HYDROGEN";
+    VehicleFuelType["BioEthanol"] = "BIO_ETHANOL";
+    VehicleFuelType["BioDiesel"] = "BIO_DIESEL";
+    VehicleFuelType["E85"] = "E85";
+    VehicleFuelType["HCNG"] = "HCNG";
+    VehicleFuelType["LPG_Petrol"] = "LPG_PETROL";
+    VehicleFuelType["LPG_Diesel"] = "LPG_DIESEL";
+    VehicleFuelType["LPG_G3_Petrol"] = "LPG_G3_PETROL";
+    VehicleFuelType["LPG_G3_Diesel"] = "LPG_G3_DIESEL";
+    VehicleFuelType["Electric_Diesel"] = "ELECTRIC_DIESEL";
+    VehicleFuelType["Electric_Petrol"] = "ELECTRIC_PETROL";
+    VehicleFuelType["Hybrid"] = "HYBRID";
+    VehicleFuelType["Other"] = "OTHER";
+})(VehicleFuelType || (VehicleFuelType = {}));
+export var VehicleTachoTypes;
+(function (VehicleTachoTypes) {
+    VehicleTachoTypes["Analog"] = "ANALOG";
+    VehicleTachoTypes["Digital"] = "DIGITAL";
+    VehicleTachoTypes["SmartTacho1"] = "SMART_TACHO_1";
+    VehicleTachoTypes["SmartTacho2"] = "SMART_TACHO_2";
+})(VehicleTachoTypes || (VehicleTachoTypes = {}));
+export var SearchVehicleSaleDealStatus;
+(function (SearchVehicleSaleDealStatus) {
+    SearchVehicleSaleDealStatus["NotSold"] = "NOT_SOLD";
+    SearchVehicleSaleDealStatus["Reserved"] = "RESERVED";
+    SearchVehicleSaleDealStatus["Sold"] = "SOLD";
+})(SearchVehicleSaleDealStatus || (SearchVehicleSaleDealStatus = {}));
+export var VehiclePurchaseDealStatus;
+(function (VehiclePurchaseDealStatus) {
+    VehiclePurchaseDealStatus["Marketing"] = "MARKETING";
+    VehiclePurchaseDealStatus["PurchaseEvaluation"] = "PURCHASE_EVALUATION";
+    VehiclePurchaseDealStatus["PurchaseAgreed"] = "PURCHASE_AGREED";
+    VehiclePurchaseDealStatus["FirstPaymentAllowed"] = "FIRST_PAYMENT_ALLOWED";
+    VehiclePurchaseDealStatus["FirstPaymentSent"] = "FIRST_PAYMENT_SENT";
+    VehiclePurchaseDealStatus["FullPaymentAllowed"] = "FULL_PAYMENT_ALLOWED";
+    VehiclePurchaseDealStatus["FullPaymentSent"] = "FULL_PAYMENT_SENT";
+})(VehiclePurchaseDealStatus || (VehiclePurchaseDealStatus = {}));
+export var VehiclePurchaseLogisticsStatus;
+(function (VehiclePurchaseLogisticsStatus) {
+    VehiclePurchaseLogisticsStatus["AtOrigin"] = "AT_ORIGIN";
+    VehiclePurchaseLogisticsStatus["Arrived"] = "ARRIVED";
+    VehiclePurchaseLogisticsStatus["CheckedIn"] = "CHECKED_IN";
+})(VehiclePurchaseLogisticsStatus || (VehiclePurchaseLogisticsStatus = {}));
+export var VehiclePurchaseDeliveryType;
+(function (VehiclePurchaseDeliveryType) {
+    VehiclePurchaseDeliveryType["PickUp"] = "PICK_UP";
+    VehiclePurchaseDeliveryType["DropOff"] = "DROP_OFF";
+})(VehiclePurchaseDeliveryType || (VehiclePurchaseDeliveryType = {}));
+export var VehicleActions;
+(function (VehicleActions) {
+    VehicleActions["EditAdminDocs"] = "edit_admin_docs";
+    VehicleActions["EditEngineeringDocs"] = "edit_engineering_docs";
+    VehicleActions["EditMarketing"] = "edit_marketing";
+    VehicleActions["EditMedia"] = "edit_media";
+    VehicleActions["EditPictures"] = "edit_pictures";
+    VehicleActions["EditPrices"] = "edit_prices";
+    VehicleActions["EditPurchaseDeal"] = "edit_purchase_deal";
+    VehicleActions["EditPurchaseLogistics"] = "edit_purchase_logistics";
+    VehicleActions["EditSpecs"] = "edit_specs";
+    VehicleActions["EditVideos"] = "edit_videos";
+    VehicleActions["ViewLeads"] = "view_leads";
+    VehicleActions["ViewSimilarOnline"] = "view_similar_online";
+    VehicleActions["ViewPurchase"] = "view_purchase";
+    VehicleActions["ViewPriceHistory"] = "view_price_history";
+    VehicleActions["DeleteVehicle"] = "delete_vehicle";
+})(VehicleActions || (VehicleActions = {}));
+export var PurchaseActions;
+(function (PurchaseActions) {
+    PurchaseActions["ViewDeal"] = "view_deal";
+    PurchaseActions["ViewSupplierOrganization"] = "view_supplier_organization";
+    PurchaseActions["ViewContact"] = "view_contact";
+    PurchaseActions["ViewLegalAddress"] = "view_legal_address";
+    PurchaseActions["ViewPickupAddress"] = "view_pickup_address";
+    PurchaseActions["ViewEstimatedCosts"] = "view_estimated_costs";
+    PurchaseActions["ViewFinanceDocuments"] = "view_finance_documents";
+})(PurchaseActions || (PurchaseActions = {}));
+//# sourceMappingURL=vehicles.js.map

package/src/types/vehicles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vehicles.js","sourceRoot":"","sources":["vehicles.ts"],"names":[],"mappings":"AAeA,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;IACjB,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,6CAA6B,CAAA;AAC/B,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAED,MAAM,CAAN,IAAY,eAoBX;AApBD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;IACjB,8BAAW,CAAA;IACX,oCAAiB,CAAA;IACjB,wCAAqB,CAAA;IACrB,8BAAW,CAAA;IACX,wCAAqB,CAAA;IACrB,6CAA0B,CAAA;IAC1B,2CAAwB,CAAA;IACxB,8BAAW,CAAA;IACX,gCAAa,CAAA;IACb,4CAAyB,CAAA;IACzB,4CAAyB,CAAA;IACzB,kDAA+B,CAAA;IAC/B,kDAA+B,CAAA;IAC/B,sDAAmC,CAAA;IACnC,sDAAmC,CAAA;IACnC,oCAAiB,CAAA;IACjB,kCAAe,CAAA;AACjB,CAAC,EApBW,eAAe,KAAf,eAAe,QAoB1B;AAED,MAAM,CAAN,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,sCAAiB,CAAA;IACjB,wCAAmB,CAAA;IACnB,kDAA6B,CAAA;IAC7B,kDAA6B,CAAA;AAC/B,CAAC,EALW,iBAAiB,KAAjB,iBAAiB,QAK5B;AAkLD,MAAM,CAAN,IAAY,2BAIX;AAJD,WAAY,2BAA2B;IACrC,mDAAoB,CAAA;IACpB,oDAAqB,CAAA;IACrB,4CAAa,CAAA;AACf,CAAC,EAJW,2BAA2B,KAA3B,2BAA2B,QAItC;AAuWD,MAAM,CAAN,IAAY,yBAQX;AARD,WAAY,yBAAyB;IACnC,oDAAuB,CAAA;IACvB,uEAA0C,CAAA;IAC1C,+DAAkC,CAAA;IAClC,0EAA6C,CAAA;IAC7C,oEAAuC,CAAA;IACvC,wEAA2C,CAAA;IAC3C,kEAAqC,CAAA;AACvC,CAAC,EARW,yBAAyB,KAAzB,yBAAyB,QAQpC;AAED,MAAM,CAAN,IAAY,8BAIX;AAJD,WAAY,8BAA8B;IACxC,wDAAsB,CAAA;IACtB,qDAAmB,CAAA;IACnB,0DAAwB,CAAA;AAC1B,CAAC,EAJW,8BAA8B,KAA9B,8BAA8B,QAIzC;AAED,MAAM,CAAN,IAAY,2BAGX;AAHD,WAAY,2BAA2B;IACrC,iDAAkB,CAAA;IAClB,mDAAoB,CAAA;AACtB,CAAC,EAHW,2BAA2B,KAA3B,2BAA2B,QAGtC;AAwGD,MAAM,CAAN,IAAY,cAgBX;AAhBD,WAAY,cAAc;IACxB,mDAAiC,CAAA;IACjC,+DAA6C,CAAA;IAC7C,kDAAgC,CAAA;IAChC,0CAAwB,CAAA;IACxB,gDAA8B,CAAA;IAC9B,4CAA0B,CAAA;IAC1B,yDAAuC,CAAA;IACvC,mEAAiD,CAAA;IACjD,0CAAwB,CAAA;IACxB,4CAA0B,CAAA;IAC1B,0CAAwB,CAAA;IACxB,2DAAyC,CAAA;IACzC,gDAA8B,CAAA;IAC9B,yDAAuC,CAAA;IACvC,kDAAgC,CAAA;AAClC,CAAC,EAhBW,cAAc,KAAd,cAAc,QAgBzB;AAED,MAAM,CAAN,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,yCAAsB,CAAA;IACtB,0EAAuD,CAAA;IACvD,+CAA4B,CAAA;IAC5B,0DAAuC,CAAA;IACvC,4DAAyC,CAAA;IACzC,8DAA2C,CAAA;IAC3C,kEAA+C,CAAA;AACjD,CAAC,EARW,eAAe,KAAf,eAAe,QAQ1B"}

package/src/types/vehicles.ts

@@ -142,6 +142,7 @@ export type NewVehicleRequest = {
     deliveryType?: VehiclePurchaseDeliveryType;
     pickupAddress?: LocationValue;
     status: VehiclePurchaseLogisticsStatus;
+    transportWithoutPayment?: boolean;
   };
   prices: {
     minimum?: string;
@@ -593,7 +594,10 @@ export type VehicleExternalInfo = {
      *     declared a location for this country.
      *
      * Only the original owner recomputes on save; cross-tenant copies preserve
-     * the array.
+     * the array. One exception: the target operator may edit the branch-country
+     * entry's `deliveryPrice`. The first such edit is a price takeover
+     * (`internal.sourcePriceOverride`), after which the snapshot collapses to the
+     * branch-country row and the sync stops rebuilding sales conditions.
      */
     localizedPricing?: Array<{
       countryCode: string;
@@ -852,6 +856,7 @@ export type VehiclePurchase = {
     deliveryType?: VehiclePurchaseDeliveryType;
     pickupAddress?: LocationValue;
     availableWeek?: string; // ISOWEEK, e.g. 2016-W02
+    transportWithoutPayment?: boolean;
   };
 };
 

package/src/utils/opportunities.js

@@ -0,0 +1,48 @@
+import { OpportunityStatus, OpportunityStatusOrder } from '../types/opportunities.js';
+const compareOpportunityStatus = (input) => {
+    const { currentStatus, referenceStatus } = input;
+    const currentStatusIdx = OpportunityStatusOrder.indexOf(currentStatus);
+    const referenceStatusIdx = OpportunityStatusOrder.indexOf(referenceStatus);
+    return {
+        currentStatusIdx,
+        referenceStatusIdx,
+    };
+};
+export const getPreviousStatus = (currentStatus) => {
+    const currentIndex = OpportunityStatusOrder.indexOf(currentStatus);
+    if (currentIndex === 0) {
+        return;
+    }
+    return OpportunityStatusOrder[currentIndex - 1];
+};
+export const getNextStatus = (status) => {
+    const statusIndex = OpportunityStatusOrder.indexOf(status);
+    if (statusIndex >= OpportunityStatusOrder.length - 1) {
+        return;
+    }
+    return OpportunityStatusOrder[statusIndex + 1];
+};
+export const isSameOrAfterReferenceOpportunityStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOpportunityStatus(input);
+    return currentStatusIdx >= referenceStatusIdx;
+};
+export const isAfterReferenceOpportunityStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOpportunityStatus(input);
+    return currentStatusIdx > referenceStatusIdx;
+};
+export const isSameOrBeforeReferenceOpportunityStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOpportunityStatus(input);
+    return currentStatusIdx <= referenceStatusIdx;
+};
+export const isBeforeReferenceOpportunityStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOpportunityStatus(input);
+    return currentStatusIdx < referenceStatusIdx;
+};
+export const isOpportunityLost = (input) => input.lostAt != null;
+export const getOpportunityReservedStatus = () => [
+    OpportunityStatus.REVIEW,
+    OpportunityStatus.PREPARATION,
+    OpportunityStatus.DELIVERY,
+];
+export const isOpportunityReserved = (input) => getOpportunityReservedStatus().includes(input.status);
+//# sourceMappingURL=opportunities.js.map

package/src/utils/opportunities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunities.js","sourceRoot":"","sources":["opportunities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAOnG,MAAM,wBAAwB,GAAG,CAAC,KAAmB,EAAE,EAAE;IACvD,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC;IAEjD,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACvE,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAE3E,OAAO;QACL,gBAAgB;QAChB,kBAAkB;KACnB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,aAAgC,EACD,EAAE;IACjC,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,OAAO,sBAAsB,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAyB,EAAiC,EAAE;IACxF,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,WAAW,IAAI,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO;IACT,CAAC;IACD,OAAO,sBAAsB,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,KAAmB,EAAW,EAAE;IACtF,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEjF,OAAO,gBAAgB,IAAI,kBAAkB,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,KAAmB,EAAW,EAAE;IAChF,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEjF,OAAO,gBAAgB,GAAG,kBAAkB,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,KAAmB,EAAW,EAAE;IACvF,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEjF,OAAO,gBAAgB,IAAI,kBAAkB,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,KAAmB,EAAW,EAAE;IACjF,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEjF,OAAO,gBAAgB,GAAG,kBAAkB,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAkB,EAAW,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC;AAEvF,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAwB,EAAE,CAAC;IACrE,iBAAiB,CAAC,MAAM;IACxB,iBAAiB,CAAC,WAAW;IAC7B,iBAAiB,CAAC,QAAQ;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAkB,EAAW,EAAE,CACnE,4BAA4B,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC"}

package/src/utils/search.ts

@@ -5,6 +5,7 @@ import { LeasingContract } from '../types/leasing.js';
 import { DebtorsDossier, SearchDebtorsDossier } from '../types/leasing-debtors.js';
 import { SearchLeasingContract } from '../types/leasing-search.js';
 import { Opportunity, SearchOpportunity } from '../types/opportunities.js';
+import { SearchTransport, Transport } from '../types/transports.js';
 import { SearchVehicle, Vehicle } from '../types/vehicles.js';
 
 export type GlobalBusinessEntity =
@@ -12,13 +13,15 @@ export type GlobalBusinessEntity =
   | Vehicle
   | Organization
   | LeasingContract
-  | DebtorsDossier;
+  | DebtorsDossier
+  | Transport;
 export type GlobalSearchEntity =
   | SearchOpportunity
   | SearchVehicle
   | SearchOrganization
   | SearchLeasingContract
-  | SearchDebtorsDossier;
+  | SearchDebtorsDossier
+  | SearchTransport;
 
 export const getCustomerInformation = (org?: Organization, contact?: Contact) => {
   if (org != null) {
@@ -41,6 +44,7 @@ export const mappings: {
   [key in BusinessEntityIds]?: {
     getMainEntity: (entity: any) => GlobalBusinessEntity;
     getTitle: (entity: any) => string;
+    getTitleForSearchEntity?: (entity: any) => string;
     getTags: (entity: any) => string[];
     getTagsForSearchEntity?: (entity: any) => string[];
     getDescription?: (entity: any) => string;
@@ -123,6 +127,30 @@ export const mappings: {
     getTitle: (dossier: DebtorsDossier) => dossier.id,
     getTags: (dossier: DebtorsDossier) => [dossier.id].filter(Boolean) as string[],
   },
+  // A transport on its own knows only ids, so the readable title and description come from the
+  // search entity (vehicle + customer). The bare-record variants stay on the id as a fallback.
+  [BusinessEntityIds.Transports]: {
+    getMainEntity: (entity: SearchTransport) => entity.transport,
+    getTitle: (transport: Transport) => transport.id,
+    getTitleForSearchEntity: (entity: SearchTransport) =>
+      entity.vehicle?.external.identification?.stockNumber ?? entity.transport.id,
+    getDescription: (entity: SearchTransport) => {
+      const customer = getCustomerInformation(entity.org);
+      const parts = [customer?.code, customer?.title].filter(Boolean) as string[];
+      // The API rejects an empty association description, so never return one.
+      return parts.length > 0 ? joinWithSeparator(parts) : entity.transport.id;
+    },
+    getTags: (transport: Transport) => [transport.id],
+    getTagsForSearchEntity: (entity: SearchTransport) => {
+      const vehicleTags =
+        entity.vehicle != null
+          ? getTagsForBusinessEntity(BusinessEntityIds.Vehicles, entity.vehicle)
+          : [];
+      return [...vehicleTags, entity.transport.id, entity.transport.opportunityId].filter(
+        Boolean,
+      ) as string[];
+    },
+  },
 };
 
 const getMapping = (businessEntityId: BusinessEntityIds) => {
@@ -186,6 +214,7 @@ export const getTitleForSearchBusinessEntity = (
   businessEntityId: BusinessEntityIds,
   searchEntity: GlobalSearchEntity,
 ) =>
+  getMapping(businessEntityId).getTitleForSearchEntity?.(searchEntity) ??
   getTitleForBusinessEntity(
     businessEntityId,
     getMainEntityFromSearchEntity(businessEntityId, searchEntity),

package/src/utils/transports.ts

@@ -0,0 +1,37 @@
+import { Opportunity } from '../types/opportunities.js';
+import { SearchTransport, Transport, TransportType } from '../types/transports.js';
+import { VehiclePurchase, VehiclePurchaseLogisticsStatus } from '../types/vehicles.js';
+
+/**
+ * A transport is finished when the journey it describes has demonstrably happened: the customer has
+ * the vehicle for a sale delivery, the vehicle is on our park for a purchase pick-up. From then on
+ * the record is history and the server refuses edits to it.
+ *
+ * Not the same thing as the transport's own `doneAt`. Delivery can be declared on the opportunity
+ * (a CMR, a delivery confirmation) and arrival on the purchase, without the transport ever being
+ * moved — and reversing either of those is what unlocks the transport again, which a status stamped
+ * on the transport itself could not express.
+ *
+ * Shared so the board, the drawer and the server all answer the question the same way.
+ */
+export const isTransportCompleted = (
+  transport: Transport,
+  context: { opportunity?: Opportunity; purchase?: VehiclePurchase },
+): boolean => {
+  if (transport.type === TransportType.SaleDelivery) {
+    return context.opportunity?.deliveredAt != null;
+  }
+
+  const status = context.purchase?.logistics.status;
+  return (
+    status === VehiclePurchaseLogisticsStatus.Arrived ||
+    status === VehiclePurchaseLogisticsStatus.CheckedIn
+  );
+};
+
+/** The same question asked of a search document, which already carries both sides. */
+export const isSearchTransportCompleted = (record: SearchTransport): boolean =>
+  isTransportCompleted(record.transport, {
+    opportunity: record.opportunity,
+    purchase: record.purchase,
+  });

package/src/utils/vehicles.ts

@@ -190,7 +190,15 @@ export const getNextRelatedStockNumber = (stockNumber: string): string => {
   return `${baseStockNumber}${nextCounterLetters}`;
 };
 
-export const VIN_PATTERN = /^[A-HJ-NPR-Z0-9]{17}$/;
+/**
+ * Canonical VIN shape: exactly 17 characters from the VIN alphabet — letters A–Z and
+ * digits 0–9, excluding I, O and Q. Unanchored so callers can wrap their own
+ * boundary/anchor policy when scanning free text (mirror of {@link buildStockNumberPattern}).
+ * Use {@link VIN_PATTERN} / {@link isValidVin} to validate a whole string.
+ */
+export const VIN_BODY_PATTERN = '[A-HJ-NPR-Z0-9]{17}';
+
+export const VIN_PATTERN = new RegExp(`^${VIN_BODY_PATTERN}$`);
 
 export const isValidVin = (vin: string): boolean => VIN_PATTERN.test(vin);