repzo 1.0.289 → 1.0.291

package/src/oas/settings.yaml

@@ -93,6 +93,57 @@ components:
           type: string
         description:
           type: string
+        calculate_target_for_non_working_days:
+          type: boolean
+          default: false
+          description: "When true, system-created absent days that fall on a scheduled day off of the rep's assigned shift still trigger target calculation."
+        end_of_day:
+          type: string
+          description: "Per-namespace day-cutover time as HH:mm. Propagated to company-namespaces.end_of_day."
+        time_zone:
+          type: string
+          description: "Per-namespace IANA time zone. Propagated to company-namespaces.time_zone."
+        end_of_day_mode:
+          type: string
+          enum: [fixed_time, shift_based]
+          default: fixed_time
+          description: "How the namespace determines the end-of-day cutover: fixed_time uses the company end_of_day setting; shift_based derives it from assigned day shifts."
+        automatic_end_day_minutes_after_shift_end:
+          type: integer
+          minimum: 0
+          maximum: 240
+          default: 0
+          description: "Shift-based mode only: minutes after a shift-based day's shift end before the system auto-closes it."
+        start_day_outside_active_zone_action:
+          type: string
+          enum: [monitor, warning, block]
+          default: warning
+          description: "Action when a rep starts their day outside their active geo zone: `monitor` (allow and record silently), `warning` (allow but warn), or `block` (prevent)."
+        start_visit_outside_active_zone_action:
+          type: string
+          enum: [monitor, warning, block]
+          default: warning
+          description: "Action when a rep starts a visit outside their active geo zone (same `monitor`/`warning`/`block` semantics as `start_day_outside_active_zone_action`)."
+        work_outside_active_zone_action:
+          type: string
+          enum: [monitor, warning, block]
+          default: warning
+          description: "Action when a rep performs work outside their active geo zone (same `monitor`/`warning`/`block` semantics as `start_day_outside_active_zone_action`)."
+        no_active_zone_action:
+          type: string
+          enum: [allow, block]
+          default: allow
+          description: "Behavior when a rep has no active geo zone: `allow` (work unrestricted) or `block` (prevent working)."
+        use_accuracy_radius_near_zone_boundary:
+          type: boolean
+          default: true
+          description: "When true, the device GPS accuracy radius is considered near a zone boundary — a position whose accuracy circle overlaps the zone counts as inside it."
+        zone_boundary_grace_minutes:
+          type: integer
+          minimum: 0
+          maximum: 60
+          default: 5
+          description: "Grace period in minutes around zone-boundary transitions before the configured outside-zone action is enforced (integer 0-60)."
     SettingsUpdateResult:
       type: object
       properties:
@@ -115,6 +166,51 @@ components:
           type: string
         description:
           type: string
+        calculate_target_for_non_working_days:
+          type: boolean
+          default: false
+          description: "When true, system-created absent days that fall on a scheduled day off of the rep's assigned shift still trigger target calculation."
+        end_of_day_mode:
+          type: string
+          enum: [fixed_time, shift_based]
+          default: fixed_time
+          description: "How the namespace determines the end-of-day cutover: fixed_time uses the company end_of_day setting; shift_based derives it from assigned day shifts."
+        automatic_end_day_minutes_after_shift_end:
+          type: integer
+          minimum: 0
+          maximum: 240
+          default: 0
+          description: "Shift-based mode only: minutes after a shift-based day's shift end before the system auto-closes it."
+        start_day_outside_active_zone_action:
+          type: string
+          enum: [monitor, warning, block]
+          default: warning
+          description: "Action when a rep starts their day outside their active geo zone: `monitor` (allow and record silently), `warning` (allow but warn), or `block` (prevent)."
+        start_visit_outside_active_zone_action:
+          type: string
+          enum: [monitor, warning, block]
+          default: warning
+          description: "Action when a rep starts a visit outside their active geo zone (same `monitor`/`warning`/`block` semantics as `start_day_outside_active_zone_action`)."
+        work_outside_active_zone_action:
+          type: string
+          enum: [monitor, warning, block]
+          default: warning
+          description: "Action when a rep performs work outside their active geo zone (same `monitor`/`warning`/`block` semantics as `start_day_outside_active_zone_action`)."
+        no_active_zone_action:
+          type: string
+          enum: [allow, block]
+          default: allow
+          description: "Behavior when a rep has no active geo zone: `allow` (work unrestricted) or `block` (prevent working)."
+        use_accuracy_radius_near_zone_boundary:
+          type: boolean
+          default: true
+          description: "When true, the device GPS accuracy radius is considered near a zone boundary — a position whose accuracy circle overlaps the zone counts as inside it."
+        zone_boundary_grace_minutes:
+          type: integer
+          minimum: 0
+          maximum: 60
+          default: 5
+          description: "Grace period in minutes around zone-boundary transitions before the configured outside-zone action is enforced (integer 0-60)."
         createdAt:
           type: string
           format: date-time

package/src/types/index.ts

@@ -410,6 +410,7 @@ export interface CalendarWeeklyGroup {
 export type Model =
   | "quickConvertToPdf"
   | "warehouses"
+  | "dayShift"
   | "transfers"
   | "transactions"
   | "taxes"
@@ -2882,6 +2883,88 @@ export namespace Service {
     }
   }
 
+  export namespace GeoZone {
+    export interface Polygon {
+      type: "Polygon";
+      coordinates: [number, number][][];
+    }
+
+    export interface AssignedRep {
+      _id: StringId;
+      name: string;
+    }
+
+    export interface Data {
+      _id: StringId;
+      name: string;
+      description?: string;
+      polygon: Polygon;
+      disabled: boolean;
+      editor: AdminOrRepOrTenantOrClient;
+      assigned_reps?: AssignedRep[];
+      company_namespace: string[];
+      createdAt: string;
+      updatedAt: string;
+      __v: number;
+    }
+
+    export interface CreateBody {
+      name: string;
+      description?: string;
+      polygon: Polygon;
+      company_namespace?: string[];
+    }
+
+    export interface UpdateBody {
+      name?: string;
+      description?: string;
+      polygon?: Polygon;
+      disabled?: boolean;
+      editor?: AdminOrRepOrTenantOrClient;
+    }
+
+    export namespace Find {
+      export type Params = DefaultPaginationQueryParams & {
+        _id?: StringId | StringId[];
+        name?: string | string[];
+        search?: string;
+        disabled?: boolean;
+        inject_assigned_reps?: boolean;
+        from_updatedAt?: number;
+        to_updatedAt?: number;
+        from_createdAt?: number;
+        to_createdAt?: number;
+      };
+      export interface Result extends DefaultPaginationResult {
+        data: Data[];
+      }
+    }
+
+    export namespace Get {
+      export type ID = StringId;
+      export type Params = {
+        inject_assigned_reps?: boolean;
+      };
+      export type Result = Data;
+    }
+
+    export namespace Create {
+      export type Body = CreateBody;
+      export type Result = Data;
+    }
+
+    export namespace Update {
+      export type ID = StringId;
+      export type Body = UpdateBody;
+      export type Result = Data;
+    }
+
+    export namespace Remove {
+      export type ID = StringId;
+      export type Result = Data;
+    }
+  }
+
   export namespace Rep {
     interface RepPermissions {
       rep_can_print_payment_after_allowance_period?: boolean;
@@ -2974,6 +3057,11 @@ export namespace Service {
       rep_can_create_client_line_approval_request?: boolean;
       rep_can_enter_client_code_at_create_client?: boolean;
       rep_can_edit_client_location_at_create_client?: boolean;
+      rep_can_start_visit_out_of_geofence?: boolean;
+      rep_can_create_approval_request_to_start_visit_out_of_geofence?: boolean;
+      rep_must_start_day_within_shift_window: boolean;
+      rep_must_end_day_within_shift_window: boolean;
+      rep_can_start_day_on_non_working_day?: boolean;
     }
     interface TargetResults {
       totalPoints: number;
@@ -3002,6 +3090,9 @@ export namespace Service {
       disable_auto_time_date_enforcement?: boolean;
       start_day_specific_time_frame_start: `${number}:${number}`;
       start_day_specific_time_frame_end: `${number}:${number}`;
+      start_day_minutes_before_shift_start?: number;
+      start_day_minutes_after_shift_start?: number;
+      end_day_minutes_before_shift_end?: number;
     }
     type JobOption = 0 | 1 | 2;
     export interface RepSchema {
@@ -3032,9 +3123,12 @@ export namespace Service {
       assigned_warehouse?: string;
       assigned_main_warehouse?: string;
       assigned_plan?: string;
+      assigned_shift?:
+        string | Pick<DayShift.Data, "_id" | "name" | "designation">;
       integration_meta?: { [key: string]: any };
       force_online_connectivity?: boolean;
       assigned_targets?: string[];
+      assigned_geo_zones?: (string | GeoZone.Data)[];
       lines?: string[];
       targetResults?: TargetResults;
       previously_assigned_clients?: string[];
@@ -3089,9 +3183,11 @@ export namespace Service {
       assigned_warehouse?: string;
       assigned_main_warehouse?: string;
       assigned_plan?: string;
+      assigned_shift?: string | null;
       integration_meta?: { [key: string]: any };
       force_online_connectivity?: boolean;
       assigned_targets?: string[];
+      assigned_geo_zones?: string[] | null;
       lines?: string[];
       targetResults?: TargetResults;
       previously_assigned_clients?: string[];
@@ -3127,6 +3223,8 @@ export namespace Service {
       | "assigned_plan"
       | "assigned_retail_execution_templates"
       | "assigned_clm_presentations"
+      | "assigned_geo_zones"
+      | "assigned_shift"
       | "warehouse";
 
     export type RepWithPopulatedKeysSchema = RepSchema & {
@@ -3145,6 +3243,9 @@ export namespace Service {
             Warehouse.WarehouseSchema,
             "_id" | "name" | "code" | "type" | "integration_meta"
           >;
+      assigned_shift?:
+        string | Pick<DayShift.Data, "_id" | "name" | "designation">;
+      assigned_geo_zones?: (string | GeoZone.Data)[];
     };
 
     export namespace Find {
@@ -3165,8 +3266,10 @@ export namespace Service {
         assigned_warehouse?: string | string[];
         assigned_main_warehouse?: string | string[];
         assigned_plan?: string | string[];
+        assigned_shift?: string | string[];
         force_online_connectivity?: boolean;
         assigned_targets?: string | string[];
+        assigned_geo_zones?: string | string[];
         lines?: string | string[];
         job_option?: JobOption | JobOption[];
         "permissions.rep_can_add_client"?: boolean;
@@ -3242,11 +3345,14 @@ export namespace Service {
         "permissions.rep_can_print_offline_sales_order"?: boolean;
         "permissions.rep_can_skip_exp_date_in_audit_stock"?: boolean;
         "permissions.rep_must_start_day_within_specific_time_frame"?: boolean;
+        "permissions.rep_must_start_day_within_shift_window"?: boolean;
         "permissions.rep_can_skip_assigned_client_filter_on_workorder_assigned_to"?: boolean;
         "permissions.rep_can_assign_client_to_other_reps"?: boolean;
         "permissions.rep_must_enter_sales_order_external_serial_number"?: boolean;
         "permissions.rep_must_enter_invoice_external_serial_number"?: boolean;
         "permissions.rep_must_end_day_after_specific_time"?: boolean;
+        "permissions.rep_must_end_day_within_shift_window"?: boolean;
+        "permissions.rep_can_start_day_on_non_working_day"?: boolean;
         "permissions.rep_can_create_negative_invoices"?: boolean;
         "permissions.rep_can_upload_media_on_payment"?: boolean;
         "permissions.rep_can_access_sales_reports"?: boolean;
@@ -3255,6 +3361,8 @@ export namespace Service {
         "permissions.rep_can_create_client_line_approval_request"?: boolean;
         "permissions.rep_can_enter_client_code_at_create_client"?: boolean;
         "permissions.rep_can_edit_client_location_at_create_client"?: boolean;
+        "permissions.rep_can_start_visit_out_of_geofence"?: boolean;
+        "permissions.rep_can_create_approval_request_to_start_visit_out_of_geofence"?: boolean;
         "permissions.rep_can_view_stock_on_transfers"?: boolean;
         "permissions.rep_must_invoice_items_from_cross_inventory_and_msl"?: boolean;
         "settings.rep_must_end_day_after"?: `${number}:${number}`;
@@ -3276,6 +3384,9 @@ export namespace Service {
         "settings.disable_auto_time_date_enforcement"?: boolean;
         "settings.start_day_specific_time_frame_start"?: string;
         "settings.start_day_specific_time_frame_end"?: string;
+        "settings.start_day_minutes_before_shift_start"?: number;
+        "settings.start_day_minutes_after_shift_start"?: number;
+        "settings.end_day_minutes_before_shift_end"?: number;
         "settings.treating_invoice_as_proforma_for_etax"?: boolean;
         is_test?: boolean;
         form_v2_option?: "all" | "none" | "assigned" | "client_assigned";
@@ -8561,6 +8672,107 @@ export namespace Service {
     }
   }
 
+  export namespace DayShift {
+    export type Weekday =
+      | "sunday"
+      | "monday"
+      | "tuesday"
+      | "wednesday"
+      | "thursday"
+      | "friday"
+      | "saturday";
+
+    export interface ShiftRange {
+      from: `${number}:${number}`;
+      to: `${number}:${number}`;
+    }
+
+    export interface ShiftEntry {
+      day: Weekday;
+      work_time: ShiftRange[];
+    }
+
+    export type ShiftSchedule = ShiftEntry[] | null | undefined;
+
+    export interface Data {
+      _id: StringId;
+      name: string;
+      designation?: string;
+      disabled: boolean;
+      schedule: ShiftEntry[];
+      total_working_hours: number;
+      total_working_days: number;
+      assigned_reps?: Pick<Rep.Data, "_id" | "name">[];
+      company_namespace: string[];
+      createdAt: Date;
+      updatedAt: Date;
+    }
+
+    export interface CreateBody {
+      name: string;
+      designation?: string;
+      schedule: ShiftEntry[];
+      company_namespace?: string[];
+    }
+
+    export type UpdateBody = Partial<Data>;
+
+    type SortingKeys = "_id";
+
+    export namespace Find {
+      export type Params = DefaultPaginationQueryParams & {
+        _id?: StringId | StringId[];
+        name?: string | string[];
+        designation?: string | string[];
+        disabled?: boolean;
+        from_updatedAt?: number;
+        to_updatedAt?: number;
+        from_createdAt?: number;
+        to_createdAt?: number;
+        from__id?: string;
+        to__id?: string;
+        from_total_working_hours?: number;
+        to_total_working_hours?: number;
+        total_working_hours?: number;
+        from_total_working_days?: number;
+        to_total_working_days?: number;
+        total_working_days?: number;
+        inject_assigned_reps?: boolean;
+        sortBy?: {
+          field: SortingKeys;
+          type: "asc" | "desc";
+        }[];
+      };
+      export interface Result extends DefaultPaginationResult {
+        data: Data[];
+      }
+    }
+
+    export namespace Get {
+      export type ID = StringId;
+      export interface Params {
+        inject_assigned_reps?: boolean;
+      }
+      export type Result = Data;
+    }
+
+    export namespace Create {
+      export type Body = CreateBody;
+      export type Result = Data;
+    }
+
+    export namespace Update {
+      export type ID = StringId;
+      export type Body = UpdateBody;
+      export type Result = Data;
+    }
+
+    export namespace Remove {
+      export type ID = StringId;
+      export type Result = Data;
+    }
+  }
+
   export namespace Day {
     export interface DaySchema {
       _id: string;
@@ -8576,8 +8788,10 @@ export namespace Service {
       timeFrame: { startOfDay?: number; endOfDay?: number };
       timeZone?: string;
       EOD?: string;
+      shift?: DayShift.Data | null;
       closed_by_system?: boolean;
       open: boolean;
+      not_working_day?: boolean;
       paymentSnapShot_start?: any[];
       paymentSnapShot_end?: any[];
       inventorySnapShot?: any[];
@@ -8595,6 +8809,7 @@ export namespace Service {
       teams: string[];
       created_by_system?: boolean;
       previously_closed?: boolean;
+      geoPoint?: GeoPoint;
       start_geoPoint?: {
         type: string;
         coordinates: number[];
@@ -8624,8 +8839,10 @@ export namespace Service {
       timeFrame: { startOfDay?: number; endOfDay?: number };
       timeZone?: string;
       EOD?: string;
+      shift?: DayShift.Data | null;
       closed_by_system?: boolean;
       open: boolean;
+      not_working_day?: boolean;
       paymentSnapShot_start?: any[];
       paymentSnapShot_end?: any[];
       inventorySnapShot?: any[];
@@ -8639,6 +8856,7 @@ export namespace Service {
       teams: string[];
       created_by_system?: boolean;
       previously_closed?: boolean;
+      geoPoint?: GeoPoint;
       start_geoPoint?: {
         type: string;
         coordinates: number[];
@@ -8666,8 +8884,10 @@ export namespace Service {
       timeFrame?: { startOfDay?: number; endOfDay?: number };
       timeZone?: string;
       EOD?: string;
+      shift?: DayShift.Data | null;
       closed_by_system?: boolean;
       open?: boolean;
+      not_working_day?: boolean;
       paymentSnapShot_start?: any[];
       paymentSnapShot_end?: any[];
       inventorySnapShot?: any[];
@@ -8685,6 +8905,7 @@ export namespace Service {
       teams?: string[];
       created_by_system?: boolean;
       previously_closed?: boolean;
+      geoPoint?: GeoPoint;
       start_geoPoint?: {
         type: string;
         coordinates: number[];
@@ -8706,7 +8927,9 @@ export namespace Service {
       export type Params = DefaultPaginationQueryParams & {
         _id?: string[] | string;
         "creator._id"?: string[] | string;
+        reps?: string[] | string;
         open?: boolean;
+        not_working_day?: boolean;
         day?: string;
         from_day?: string;
         to_day?: string;
@@ -13502,6 +13725,7 @@ export namespace Service {
         | "Saturday";
       signUpMethod: "email" | "phone";
       calculate_target_for_absent_days: boolean;
+      calculate_target_for_non_working_days?: boolean;
       disable_module_custom_validator: boolean;
       activate_ubl_integration: boolean;
       last_activate_ubl_integration_time?: number;
@@ -13563,6 +13787,14 @@ export namespace Service {
       enable_whatsapp_mfa: boolean;
       enable_authenticator_mfa: boolean;
       minimum_accepted_mfa: number;
+      end_of_day_mode: "fixed_time" | "shift_based";
+      automatic_end_day_minutes_after_shift_end: number;
+      start_day_outside_active_zone_action: "monitor" | "warning" | "block";
+      start_visit_outside_active_zone_action: "monitor" | "warning" | "block";
+      work_outside_active_zone_action: "monitor" | "warning" | "block";
+      no_active_zone_action: "allow" | "block";
+      use_accuracy_radius_near_zone_boundary: boolean;
+      zone_boundary_grace_minutes: number;
       createdAt: Date;
       updatedAt: Date;
     }
@@ -13662,6 +13894,7 @@ export namespace Service {
         | "Saturday";
       signUpMethod?: "email" | "phone";
       calculate_target_for_absent_days?: boolean;
+      calculate_target_for_non_working_days?: boolean;
       disable_module_custom_validator?: boolean;
       activate_ubl_integration?: boolean;
       last_activate_ubl_integration_time?: number;
@@ -13725,6 +13958,16 @@ export namespace Service {
       enable_whatsapp_mfa: boolean;
       enable_authenticator_mfa: boolean;
       minimum_accepted_mfa: number;
+      end_of_day?: string;
+      time_zone?: string;
+      end_of_day_mode?: "fixed_time" | "shift_based";
+      automatic_end_day_minutes_after_shift_end?: number;
+      start_day_outside_active_zone_action?: "monitor" | "warning" | "block";
+      start_visit_outside_active_zone_action?: "monitor" | "warning" | "block";
+      work_outside_active_zone_action?: "monitor" | "warning" | "block";
+      no_active_zone_action?: "allow" | "block";
+      use_accuracy_radius_near_zone_boundary?: boolean;
+      zone_boundary_grace_minutes?: number;
     }
 
     export namespace Update {
@@ -18084,6 +18327,7 @@ export namespace Service {
       | "update-rep"
       | "update-salesmsl"
       | "update-settings"
+      | "update-geo-zone"
       | "update-tags"
       | "update-taxes"
       | "update-transfer"
@@ -22454,6 +22698,112 @@ export namespace Service {
     }
   }
 
+  export namespace BulkExport {
+    export type BulkExportType =
+      | "clients"
+      | "products"
+      | "variants"
+      | "categories"
+      | "subCategories"
+      | "availabilityMsl"
+      | "availabilityMslWithProducts"
+      | "reps"
+      | "mslWithVariants"
+      | "jobCategories"
+      | "jobs"
+      | "tags"
+      | "routes"
+      | "routesWithClients"
+      | "plans"
+      | "planWithRules"
+      | "targetRulesWithClients"
+      | "rulesWithRoutes"
+      | "targetRulesWithReps"
+      | "adjustAccount"
+      | "rules"
+      | "warehouses"
+      | "productGroups"
+      | "priceListItems"
+      | "measureunit"
+      | "measureunitFamily"
+      | "lineTarget"
+      | "clientLineClassification"
+      | "retailExecutionPresets"
+      | "promotions"
+      | "customListItems"
+      | "assets"
+      | "assetUnits"
+      | "speciality"
+      | "clientLocation"
+      | "reminders"
+      | "admins"
+      | "companyGroup"
+      | "company"
+      | "variantBatch"
+      | "banksList"
+      | "clientUblInfo"
+      | "supplier"
+      | "contractInstallment"
+      | "targetRule"
+      | "contracts"
+      | "assetPartTypes"
+      | "assetParts"
+      | "clientUblInfo_JO"
+      | "clientUblInfo_SA"
+      | "nameSpaceFreshnessWindowCodes";
+
+    export interface Data {
+      _id: StringId;
+      creator: AdminOrRepOrTenantOrClient;
+      type: BulkExportType;
+      status: "processing" | "success" | "fail";
+      messages: any[];
+      _errors: any[];
+      start_time: number;
+      end_time?: number;
+      bucket_name?: string;
+      region?: string;
+      key?: string;
+      link?: string;
+      media?: StringId[];
+      teams: string[];
+      export_type: "excel" | "parquet";
+      row_count?: number;
+      company_namespace: string[];
+      createdAt: Date;
+      updatedAt: Date;
+    }
+
+    export interface CreateBody {
+      export_type?: "excel" | "parquet";
+      columns?: { [key: string]: any };
+      name?: string;
+      creator?: AdminOrRepOrTenantOrClient;
+      company_namespace?: string[];
+    }
+
+    export namespace Find {
+      export type Params = DefaultPaginationQueryParams & {
+        _id?: StringId | StringId[];
+        type?: BulkExportType;
+        status?: Data["status"] | Data["status"][];
+        export?: boolean;
+        export_type?: "excel" | "parquet";
+        from_updatedAt?: number;
+        to_updatedAt?: number;
+      };
+      export interface Result extends DefaultPaginationResult {
+        data: Data[];
+      }
+    }
+
+    export namespace Create {
+      export type Params = { type: BulkExportType; [key: string]: any };
+      export type Body = CreateBody;
+      export type Result = Data;
+    }
+  }
+
   export namespace DeliveryNote {
     interface User {
       _id: string;
@@ -22978,6 +23328,7 @@ type RepzoModel =
   | "ublConnectionAttempts"
   | "quickConvertToPdf"
   | "warehouses"
+  | "dayShift"
   | "transfers"
   | "transactions"
   | "taxes"