feature/IO-3357-Reynolds-and-Reynolds-DMS-API-Integration / RRScratch2 / Improve reconnect logic

# Conflicts:
#	package-lock.json
#	package.json

Fortellis Notes.md

@@ -0,0 +1,346 @@
+Fortellis Notes
+
+Subscription ID
+
+- Appears to give us a list of all dealerships we have access to, and `apiDmsInfo` contains the integrations that are enabled for that dealership.
+- Will likely need to filter based on the DMS ID or something?
+- Should store the whole subscription object. Contains department information needed in subsequent calls.
+
+Department ID
+
+- May have multiple departments. Appears that financial stuff goes to Accounting, History will go to Service.
+- TODO: How do we handle the multiple departments that may come up.
+
+###Internal Questions
+
+* Overview of the redis storing mechanism to cache this data. 
+* 
+
+# GL Wip Posting
+
+## Org Helper Return Data
+
+```json
+[
+  {
+    "acctgLgnID": "DEVWB-A",
+    "applCode": "V",
+    "coID": "77",
+    "companyName": "TEST SYS C187092 DEVWB",
+    "lgnDesc": "DEV WRITE BACK VMS",
+    "logon": "DEVWB-V"
+  },
+  {
+    "acctgLgnID": "DEVWB-A",
+    "applCode": "F",
+    "coID": "77",
+    "companyName": "TEST SYS C187092 DEVWB",
+    "lgnDesc": "DEV WRITE BACK F&I SALES",
+    "logon": "DEVWB-FI"
+  },
+  {
+    "acctgLgnID": "DEVWB-A",
+    "applCode": "CS",
+    "coID": "77",
+    "companyName": "TEST SYS C187092 DEVWB",
+    "lgnDesc": "DEV WRITE BACK SERVICE",
+    "logon": "DEVWB-S"
+  },
+  {
+    "acctgLgnID": "DEVWB-A",
+    "applCode": "A",
+    "coID": "77",
+    "companyName": "TEST SYS C187092 DEVWB",
+    "lgnDesc": "DEV WRITE BACK ACCTG",
+    "logon": "DEVWB-A"
+  },
+  {
+    "acctgLgnID": "DEVWB-A",
+    "applCode": "SL",
+    "coID": "77",
+    "companyName": "TEST SYS C187092 DEVWB",
+    "lgnDesc": "DEV WRTIE BACK SLS MGMT",
+    "logon": "DEVWB-SL"
+  },
+  {
+    "acctgLgnID": "DEVWB-A",
+    "applCode": "O",
+    "coID": "77",
+    "companyName": "TEST SYS C187092 DEVWB",
+    "lgnDesc": "DEV WRITE BACK PARTS",
+    "logon": "DEVWB-I"
+  }
+]
+```
+
+## Journal Helper Return Data
+
+```json
+[
+  {
+    "companyNo": "77",
+    "jrnlID": "32",
+    "jrnlName": "PARTS SALES",
+    "jrnlType": "S",
+    "intercoFlag": "0",
+    "defaultDocType": "4",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "92",
+    "jrnlName": "YTD ADJUSTMENTS",
+    "jrnlType": "Y",
+    "intercoFlag": "0",
+    "defaultDocType": "3",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "12",
+    "jrnlName": "FLEET SALES",
+    "jrnlType": "S",
+    "intercoFlag": "0",
+    "defaultDocType": "9",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "57",
+    "jrnlName": "CASH RECEIPTS (OPEN-ITEM)",
+    "jrnlType": "R",
+    "intercoFlag": "0",
+    "defaultDocType": "1",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "93",
+    "jrnlName": "SET UP HISTORY",
+    "jrnlType": "H",
+    "intercoFlag": "0",
+    "defaultDocType": "10",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "88",
+    "jrnlName": "F/S STATISCAL DATA",
+    "jrnlType": "F",
+    "intercoFlag": "0",
+    "defaultDocType": "10",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "58",
+    "jrnlName": "WARRANTY CREDITS",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "3",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "FC",
+    "jrnlName": "FINANCE CHARGE",
+    "jrnlType": "A",
+    "intercoFlag": "0",
+    "defaultDocType": "12",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "94",
+    "jrnlName": "SET UP SCHEDULES",
+    "jrnlType": "C",
+    "intercoFlag": "0",
+    "defaultDocType": "3",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "95",
+    "jrnlName": "SET UP GENERAL LEDGER",
+    "jrnlType": "B",
+    "intercoFlag": "0",
+    "defaultDocType": "3",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "20",
+    "jrnlName": "USED VEHICLE SALES",
+    "jrnlType": "S",
+    "intercoFlag": "0",
+    "defaultDocType": "9",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "60",
+    "jrnlName": "CASH DISBURSEMENTS",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "2",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "30",
+    "jrnlName": "SERVICE SALES",
+    "jrnlType": "S",
+    "intercoFlag": "0",
+    "defaultDocType": "7",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "40",
+    "jrnlName": "PAYROLL",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "11",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "15",
+    "jrnlName": "DEALER TRADES",
+    "jrnlType": "S",
+    "intercoFlag": "0",
+    "defaultDocType": "9",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "70",
+    "jrnlName": "NEW VEHICLE PURCHASES",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "8",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "25",
+    "jrnlName": "USED WHOLESALE",
+    "jrnlType": "S",
+    "intercoFlag": "0",
+    "defaultDocType": "9",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "75",
+    "jrnlName": "GENERAL PURCHASES",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "5",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "10",
+    "jrnlName": "NEW VEHICLE SALES",
+    "jrnlType": "S",
+    "intercoFlag": "0",
+    "defaultDocType": "9",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "80",
+    "jrnlName": "GENERAL JOURNAL",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "3",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "11",
+    "jrnlName": "WORK IN PROGRESS",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "10",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "56",
+    "jrnlName": "CASH RECEIPTS (BALANCE FWD)",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "1",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "81",
+    "jrnlName": "STANDARD ENTRIES",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "6",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "51",
+    "jrnlName": "CASH RECEIPTS JOURNAL - EFT",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "10",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "61",
+    "jrnlName": "CASH DISBURSMENTS -EFT",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "10",
+    "errCode": "",
+    "errMsg": ""
+  },
+  {
+    "companyNo": "77",
+    "jrnlID": "71",
+    "jrnlName": "USED VEHICLE PURCHASES",
+    "jrnlType": "G",
+    "intercoFlag": "0",
+    "defaultDocType": "8",
+    "errCode": "",
+    "errMsg": ""
+  }
+]
+```
+
+# Feedback
+
+- Receiving bad request errors, with no details. API errors page doesn't indicate what's wrong for certain types of error codes.
+- API Error page works on a several minute delay.

client/package.json

@@ -8,41 +8,41 @@
   "private": true,
   "proxy": "http://localhost:4000",
   "dependencies": {
-    "@amplitude/analytics-browser": "^2.25.2",
+    "@amplitude/analytics-browser": "^2.30.1",
     "@ant-design/pro-layout": "^7.22.6",
     "@apollo/client": "^3.13.9",
     "@emotion/is-prop-valid": "^1.4.0",
     "@fingerprintjs/fingerprintjs": "^4.6.1",
-    "@firebase/analytics": "^0.10.17",
+    "@firebase/analytics": "^0.10.19",
-    "@firebase/app": "^0.14.3",
+    "@firebase/app": "^0.14.6",
-    "@firebase/auth": "^1.10.8",
+    "@firebase/auth": "^1.11.1",
     "@firebase/firestore": "^4.9.2",
     "@firebase/messaging": "^0.12.22",
     "@jsreport/browser-client": "^3.1.0",
-    "@reduxjs/toolkit": "^2.9.0",
+    "@reduxjs/toolkit": "^2.10.1",
-    "@sentry/cli": "^2.56.0",
+    "@sentry/cli": "^2.58.2",
     "@sentry/react": "^9.43.0",
-    "@sentry/vite-plugin": "^4.3.0",
+    "@sentry/vite-plugin": "^4.6.0",
-    "@splitsoftware/splitio-react": "^2.5.0",
+    "@splitsoftware/splitio-react": "^2.6.0",
-    "@tanem/react-nprogress": "^5.0.53",
+    "@tanem/react-nprogress": "^5.0.56",
-    "antd": "^5.27.4",
+    "antd": "^5.28.1",
     "apollo-link-logger": "^2.0.1",
     "apollo-link-sentry": "^4.4.0",
     "autosize": "^6.0.1",
-    "axios": "^1.12.2",
+    "axios": "^1.13.2",
     "classnames": "^2.5.1",
     "css-box-model": "^1.2.1",
-    "dayjs": "^1.11.18",
+    "dayjs": "^1.11.19",
-    "dayjs-business-days2": "^1.3.0",
+    "dayjs-business-days2": "^1.3.1",
     "dinero.js": "^1.9.1",
     "dotenv": "^17.2.3",
     "env-cmd": "^10.1.0",
     "exifr": "^7.1.3",
-    "graphql": "^16.11.0",
+    "graphql": "^16.12.0",
-    "i18next": "^25.5.3",
+    "i18next": "^25.6.2",
     "i18next-browser-languagedetector": "^8.2.0",
     "immutability-helper": "^3.1.1",
-    "libphonenumber-js": "^1.12.23",
+    "libphonenumber-js": "^1.12.26",
     "lightningcss": "^1.30.2",
     "logrocket": "^9.0.2",
     "markerjs2": "^2.32.7",
@@ -50,7 +50,7 @@
     "normalize-url": "^8.1.0",
     "object-hash": "^3.0.0",
     "phone": "^3.1.67",
-    "posthog-js": "^1.271.0",
+    "posthog-js": "^1.294.0",
     "prop-types": "^15.8.1",
     "query-string": "^9.3.1",
     "raf-schd": "^4.0.3",
@@ -68,7 +68,7 @@
     "react-markdown": "^10.1.0",
     "react-number-format": "^5.4.3",
     "react-popopo": "^2.1.9",
-    "react-product-fruits": "^2.2.61",
+    "react-product-fruits": "^2.2.62",
     "react-redux": "^9.2.0",
     "react-resizable": "^3.0.5",
     "react-router-dom": "^6.30.0",
@@ -78,10 +78,10 @@
     "redux": "^5.0.1",
     "redux-actions": "^3.0.3",
     "redux-persist": "^6.0.0",
-    "redux-saga": "^1.3.0",
+    "redux-saga": "^1.4.2",
     "redux-state-sync": "^3.1.4",
     "reselect": "^5.1.1",
-    "sass": "^1.93.2",
+    "sass": "^1.94.0",
     "socket.io-client": "^4.8.1",
     "styled-components": "^6.1.19",
     "subscriptions-transport-ws": "^0.11.0",
@@ -135,35 +135,35 @@
   "devDependencies": {
     "@ant-design/icons": "^6.1.0",
     "@babel/plugin-proposal-private-property-in-object": "^7.21.11",
-    "@babel/preset-react": "^7.27.1",
+    "@babel/preset-react": "^7.28.5",
-    "@dotenvx/dotenvx": "^1.51.0",
+    "@dotenvx/dotenvx": "^1.51.1",
     "@emotion/babel-plugin": "^11.13.5",
     "@emotion/react": "^11.14.0",
-    "@eslint/js": "^9.37.0",
+    "@eslint/js": "^9.39.1",
-    "@playwright/test": "^1.56.0",
+    "@playwright/test": "^1.56.1",
-    "@sentry/webpack-plugin": "^4.3.0",
+    "@sentry/webpack-plugin": "^4.6.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
     "@vitejs/plugin-react": "^4.6.0",
-    "browserslist": "^4.26.3",
+    "browserslist": "^4.28.0",
     "browserslist-to-esbuild": "^2.1.1",
     "chalk": "^5.6.2",
-    "eslint": "^9.37.0",
+    "eslint": "^9.39.1",
     "eslint-plugin-react": "^7.37.5",
     "globals": "^15.15.0",
     "jsdom": "^26.0.0",
-    "memfs": "^4.48.1",
+    "memfs": "^4.51.0",
     "os-browserify": "^0.3.0",
-    "playwright": "^1.56.0",
+    "playwright": "^1.56.1",
     "react-error-overlay": "^6.1.0",
     "redux-logger": "^3.0.6",
     "source-map-explorer": "^2.5.3",
-    "vite": "^7.1.9",
+    "vite": "^7.2.2",
     "vite-plugin-babel": "^1.3.2",
     "vite-plugin-eslint": "^1.8.1",
     "vite-plugin-node-polyfills": "^0.24.0",
-    "vite-plugin-pwa": "^1.0.3",
+    "vite-plugin-pwa": "^1.1.0",
     "vite-plugin-style-import": "^2.0.0",
     "vitest": "^3.2.4",
     "workbox-window": "^7.3.0"

client/src/App/App.styles.scss

@@ -1,3 +1,5 @@
+@use "react-big-calendar/lib/sass/styles" as rbc;
+
 :root {
   --table-stripe-bg: #f4f4f4; /* Light mode table stripe */
   --menu-divider-color: #74695c; /* Light mode menu divider */
@@ -211,9 +213,6 @@
   --svg-background: #FFF; /* Dark mode SVG background */
 }
 
-// Global Styles
-@import "react-big-calendar/lib/sass/styles";
-
 .ant-menu-item-divider {
   border-bottom: 1px solid var(--menu-divider-color) !important;
 }
@@ -426,6 +425,24 @@
   }
 }
 
+.dms-equal-height-col {
+  display: flex; // make the Col a flex container
+}
+
+/* If the direct child is an AntD Card, make it fill the column */
+.dms-equal-height-col > .ant-card {
+  flex: 1 1 auto;
+  display: flex;
+  flex-direction: column;
+}
+
+/* Optional: if you want the card body to fill vertically too */
+.dms-equal-height-col > .ant-card .ant-card-body {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+}
+
 //.rbc-time-header-gutter {
 //  padding: 0;
-//} 
+//}

client/src/components/accounting-receivables-table/accounting-receivables-table.component.jsx

@@ -180,7 +180,7 @@ export function AccountingReceivablesTableComponent({ bodyshop, loading, jobs, r
     <Card
       extra={
         <Space wrap>
-          {!bodyshop.cdk_dealerid && !bodyshop.pbs_serialnumber && (
+          {!bodyshop.cdk_dealerid && !bodyshop.pbs_serialnumber && !bodyshop.rr_dealerid && (
             <>
               <JobMarkSelectedExported
                 jobIds={selectedJobs}
@@ -198,7 +198,7 @@ export function AccountingReceivablesTableComponent({ bodyshop, loading, jobs, r
               />
             </>
           )}
-          {bodyshop.accountingconfig && bodyshop.accountingconfig.qbo && <QboAuthorizeComponent />}
+          {bodyshop.accountingconfig?.qbo && <QboAuthorizeComponent />}
           <Input.Search
             value={state.search}
             onChange={handleSearch}

client/src/components/bill-form-lines-extended/bill-form-lines.extended.formitem.component.jsx

@@ -7,6 +7,7 @@ import { createStructuredSelector } from "reselect";
 import { selectBodyshop } from "../../redux/user/user.selectors";
 import CurrencyInput from "../form-items-formatted/currency-form-item.component";
 import CiecaSelect from "../../utils/Ciecaselect";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop
@@ -44,7 +45,7 @@ export function BillFormItemsExtendedFormItem({
                 quantity: record.part_qty || 1,
                 actual_price: record.act_price,
                 cost_center: record.part_type
-                  ? bodyshop.pbs_serialnumber || bodyshop.cdk_dealerid
+                  ? bodyshopHasDmsKey(bodyshop)
                     ? record.part_type
                     : responsibilityCenters.defaults && (responsibilityCenters.defaults.costs[record.part_type] || null)
                   : null
@@ -100,7 +101,7 @@ export function BillFormItemsExtendedFormItem({
       </Form.Item>
       <Form.Item label={t("billlines.fields.cost_center")} name={["billlineskeys", record.id, "cost_center"]}>
         <Select showSearch style={{ minWidth: "3rem" }} disabled={disabled}>
-          {bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber
+          {bodyshopHasDmsKey(bodyshop)
             ? CiecaSelect(true, false)
             : responsibilityCenters.costs.map((item) => <Select.Option key={item.name}>{item.name}</Select.Option>)}
         </Select>

client/src/components/bill-form/bill-form.component.jsx

@@ -22,6 +22,7 @@ import VendorSearchSelect from "../vendor-search-select/vendor-search-select.com
 import BillFormLines from "./bill-form.lines.component";
 import { CalculateBillTotal } from "./bill-form.totals.utility";
 import DateTimePicker from "../form-date-time-picker/form-date-time-picker.component.jsx";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop
@@ -354,7 +355,7 @@ export function BillFormComponent({
               <Form.Item span={3} label={t("bills.fields.local_tax_rate")} name="local_tax_rate">
                 <CurrencyInput min={0} />
               </Form.Item>
-              {bodyshop.pbs_serialnumber || bodyshop.cdk_dealerid ? (
+              {bodyshopHasDmsKey(bodyshop) ? (
                 <Form.Item span={2} label={t("bills.labels.federal_tax_exempt")} name="federal_tax_exempt">
                   <Switch onChange={handleFederalTaxExemptSwitchToggle} />
                 </Form.Item>

client/src/components/bill-form/bill-form.lines.component.jsx

@@ -10,6 +10,7 @@ import InstanceRenderManager from "../../utils/instanceRenderMgr";
 import BillLineSearchSelect from "../bill-line-search-select/bill-line-search-select.component";
 import BilllineAddInventory from "../billline-add-inventory/billline-add-inventory.component";
 import CurrencyInput from "../form-items-formatted/currency-form-item.component";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   //currentUser: selectCurrentUser
@@ -90,7 +91,7 @@ export function BillEnterModalLinesComponent({
                       actual_price: opt.cost,
                       original_actual_price: opt.cost,
                       cost_center: opt.part_type
-                        ? bodyshop.pbs_serialnumber || bodyshop.cdk_dealerid
+                        ? bodyshopHasDmsKey(bodyshop)
                           ? opt.part_type !== "PAE"
                             ? opt.part_type
                             : null
@@ -322,7 +323,7 @@ export function BillEnterModalLinesComponent({
         },
         formInput: () => (
           <Select showSearch style={{ minWidth: "3rem" }} disabled={disabled}>
-            {bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber
+            {bodyshopHasDmsKey(bodyshop)
               ? CiecaSelect(true, false)
               : responsibilityCenters.costs.map((item) => <Select.Option key={item.name}>{item.name}</Select.Option>)}
           </Select>

client/src/components/dms-allocations-summary-ap/dms-allocations-summary-ap.component.jsx

@@ -55,7 +55,7 @@ export function DmsAllocationsSummaryAp({ socket, bodyshop, billids, title }) {
       });
     }
   }, [socket, socket.connected, billids]);
-  console.log(allocationsSummary);
+
   const columns = [
     {
       title: t("general.labels.status"),
@@ -122,7 +122,7 @@ export function DmsAllocationsSummaryAp({ socket, bodyshop, billids, title }) {
         <Form.Item
           name="journal"
           label={t("jobs.fields.dms.journal")}
-          initialValue={bodyshop.cdk_configuration && bodyshop.cdk_configuration.default_journal}
+          initialValue={bodyshop.cdk_configuration?.default_journal}
           rules={[
             {
               required: true

client/src/components/dms-allocations-summary/dms-allocations-summary.component.jsx

@@ -1,72 +1,97 @@
 import { Alert, Button, Card, Table, Typography } from "antd";
-import { useEffect, useState } from "react";
+import { SyncOutlined } from "@ant-design/icons";
+import { useCallback, useEffect, useState } from "react";
 import { useTranslation } from "react-i18next";
 import { connect } from "react-redux";
 import { createStructuredSelector } from "reselect";
-import { selectBodyshop } from "../../redux/user/user.selectors";
 import Dinero from "dinero.js";
-import { SyncOutlined } from "@ant-design/icons";
+import { DMS_MAP } from "../../utils/dmsUtils";
+
+import { selectBodyshop } from "../../redux/user/user.selectors";
 import { pageLimit } from "../../utils/config";
 
 const mapStateToProps = createStructuredSelector({
-  //currentUser: selectCurrentUser
   bodyshop: selectBodyshop
 });
-
+const mapDispatchToProps = () => ({});
-const mapDispatchToProps = () => ({
-  //setUserLanguage: language => dispatch(setUserLanguage(language))
-});
 
 export default connect(mapStateToProps, mapDispatchToProps)(DmsAllocationsSummary);
 
-export function DmsAllocationsSummary({ socket, bodyshop, jobId, title }) {
+/**
+ * DMS Allocations Summary component
+ * @param mode
+ * @param socket
+ * @param bodyshop
+ * @param jobId
+ * @param title
+ * @returns {JSX.Element}
+ * @constructor
+ */
+export function DmsAllocationsSummary({ mode, socket, bodyshop, jobId, title }) {
   const { t } = useTranslation();
   const [allocationsSummary, setAllocationsSummary] = useState([]);
 
-  useEffect(() => {
+  // Resolve event name by mode (PBS reuses the CDK event per existing behavior)
-    if (socket.connected) {
+  const allocationsEvent =
-      socket.emit("cdk-calculate-allocations", jobId, (ack) => {
+    mode === DMS_MAP.reynolds
-        setAllocationsSummary(ack);
+      ? "rr-calculate-allocations"
-        socket.allocationsSummary = ack;
+      : mode === DMS_MAP.fortellis
+        ? "fortellis-calculate-allocations"
+        : /* "cdk" | "pbs" (legacy) */ "cdk-calculate-allocations";
+
+  const fetchAllocations = useCallback(() => {
+    if (!socket || !jobId || !mode) return;
+
+    try {
+      socket.emit(allocationsEvent, jobId, (ack) => {
+        const list = Array.isArray(ack) ? ack : [];
+        setAllocationsSummary(list);
+        // Preserve side-channel used by the post form for discrepancy checks
+        socket.allocationsSummary = list;
       });
+    } catch {
+      // Best-effort; leave table empty on error
+      setAllocationsSummary([]);
+      socket && (socket.allocationsSummary = []);
     }
-  }, [socket, socket.connected, jobId]);
+  }, [socket, jobId, mode, allocationsEvent]);
+
+  // Initial + whenever mode/socket/jobId changes
+  useEffect(() => {
+    fetchAllocations();
+  }, [fetchAllocations]);
 
   const columns = [
-    {
+    { title: t("jobs.fields.dms.center"), dataIndex: "center", key: "center" },
-      title: t("jobs.fields.dms.center"),
-      dataIndex: "center",
-      key: "center"
-    },
     {
       title: t("jobs.fields.dms.sale"),
       dataIndex: "sale",
       key: "sale",
-      render: (text, record) => Dinero(record.sale).toFormat()
+      render: (_text, record) => Dinero(record.sale).toFormat()
     },
     {
       title: t("jobs.fields.dms.cost"),
       dataIndex: "cost",
       key: "cost",
-      render: (text, record) => Dinero(record.cost).toFormat()
+      render: (_text, record) => Dinero(record.cost).toFormat()
     },
     {
       title: t("jobs.fields.dms.sale_dms_acctnumber"),
       dataIndex: "sale_dms_acctnumber",
       key: "sale_dms_acctnumber",
-      render: (text, record) => record.profitCenter?.dms_acctnumber
+      render: (_text, record) => record.profitCenter?.dms_acctnumber
     },
     {
       title: t("jobs.fields.dms.cost_dms_acctnumber"),
       dataIndex: "cost_dms_acctnumber",
       key: "cost_dms_acctnumber",
-      render: (text, record) => record.costCenter?.dms_acctnumber
+      render: (_text, record) => record.costCenter?.dms_acctnumber
     },
     {
       title: t("jobs.fields.dms.dms_wip_acctnumber"),
       dataIndex: "dms_wip_acctnumber",
       key: "dms_wip_acctnumber",
-      render: (text, record) => record.costCenter?.dms_wip_acctnumber
+      render: (_text, record) => record.costCenter?.dms_wip_acctnumber
     }
   ];
 
@@ -74,11 +99,7 @@ export function DmsAllocationsSummary({ socket, bodyshop, jobId, title }) {
     <Card
       title={title}
       extra={
-        <Button
+        <Button onClick={fetchAllocations} aria-label={t("general.actions.refresh")}>
-          onClick={() => {
-            socket.emit("cdk-calculate-allocations", jobId, (ack) => setAllocationsSummary(ack));
-          }}
-        >
           <SyncOutlined />
         </Button>
       }
@@ -86,6 +107,7 @@ export function DmsAllocationsSummary({ socket, bodyshop, jobId, title }) {
       {bodyshop.pbs_configuration?.disablebillwip && (
         <Alert type="warning" message={t("jobs.labels.dms.disablebillwip")} />
       )}
+
       <Table
         pagination={{ position: "top", defaultPageSize: pageLimit }}
         columns={columns}
@@ -94,34 +116,25 @@ export function DmsAllocationsSummary({ socket, bodyshop, jobId, title }) {
         locale={{ emptyText: t("dms.labels.refreshallocations") }}
         scroll={{ x: true }}
         summary={() => {
-          const totals =
+          const totals = allocationsSummary?.reduce(
-            allocationsSummary &&
+            (acc, val) => ({
-            allocationsSummary.reduce(
+              totalSale: acc.totalSale.add(Dinero(val.sale)),
-              (acc, val) => {
+              totalCost: acc.totalCost.add(Dinero(val.cost))
-                return {
+            }),
-                  totalSale: acc.totalSale.add(Dinero(val.sale)),
+            { totalSale: Dinero(), totalCost: Dinero() }
-                  totalCost: acc.totalCost.add(Dinero(val.cost))
+          ) || { totalSale: Dinero(), totalCost: Dinero() };
-                };
+
-              },
+          const hasNonZeroSaleTotal = totals.totalSale.getAmount() !== 0;
-              {
-                totalSale: Dinero(),
-                totalCost: Dinero()
-              }
-            );
 
           return (
             <Table.Summary.Row>
               <Table.Summary.Cell>
                 <Typography.Title level={4}>{t("general.labels.totals")}</Typography.Title>
               </Table.Summary.Cell>
-              <Table.Summary.Cell>{totals && totals.totalSale.toFormat()}</Table.Summary.Cell>
+              <Table.Summary.Cell>{hasNonZeroSaleTotal ? totals.totalSale.toFormat() : null}</Table.Summary.Cell>
-              <Table.Summary.Cell>
+              <Table.Summary.Cell />
-                {
+              <Table.Summary.Cell />
-                  //  totals.totalCost.toFormat()
+              <Table.Summary.Cell />
-                }
-              </Table.Summary.Cell>
-              <Table.Summary.Cell></Table.Summary.Cell>
-              <Table.Summary.Cell></Table.Summary.Cell>
             </Table.Summary.Row>
           );
         }}

client/src/components/dms-allocations-summary/rr-dms-allocations-summary.component.jsx

@@ -0,0 +1,300 @@
+import { Alert, Button, Card, Table, Tabs, Typography } from "antd";
+import { SyncOutlined } from "@ant-design/icons";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useTranslation } from "react-i18next";
+import { connect } from "react-redux";
+import { createStructuredSelector } from "reselect";
+
+import { selectBodyshop } from "../../redux/user/user.selectors";
+
+const mapStateToProps = createStructuredSelector({
+  bodyshop: selectBodyshop
+});
+const mapDispatchToProps = () => ({});
+
+export default connect(mapStateToProps, mapDispatchToProps)(RrAllocationsSummary);
+
+/**
+ * Normalize job allocations into a flat list for display / preview building.
+ * @param ack
+ * @returns {{center: *, sale, partsSale, laborTaxableSale, laborNonTaxableSale, extrasSale, cost, profitCenter, costCenter}[]|*[]}
+ */
+function normalizeJobAllocations(ack) {
+  if (!ack || !Array.isArray(ack.jobAllocations)) return [];
+
+  return ack.jobAllocations.map((row) => ({
+    center: row.center,
+
+    // legacy "sale" (total) if we ever want to show it again
+    sale: row.sale || row.totalSale || null,
+
+    // bucketed sales used to build split ROGOG/ROLABOR
+    partsSale: row.partsSale || null,
+    laborTaxableSale: row.laborTaxableSale || null,
+    laborNonTaxableSale: row.laborNonTaxableSale || null,
+    extrasSale: row.extrasSale || null,
+
+    cost: row.cost || null,
+    profitCenter: row.profitCenter || null,
+    costCenter: row.costCenter || null
+  }));
+}
+
+/**
+ * RR-specific DMS Allocations Summary
+ * Focused on what we actually send to RR:
+ *  - ROGOG (split by taxable / non-taxable segments)
+ *  - ROLABOR shell
+ *
+ * The heavy lifting (ROGOG/ROLABOR split, cost allocation, tax flags)
+ * is now done on the backend via buildRogogFromAllocations/buildRolaborFromRogog.
+ * This component just renders the preview from `ack.rogg` / `ack.rolabor`.
+ */
+export function RrAllocationsSummary({ socket, bodyshop, jobId, title }) {
+  const { t } = useTranslation();
+  const [roggPreview, setRoggPreview] = useState(null);
+  const [rolaborPreview, setRolaborPreview] = useState(null);
+  const [error, setError] = useState(null);
+
+  const fetchAllocations = useCallback(() => {
+    if (!socket || !jobId) return;
+
+    try {
+      socket.emit("rr-calculate-allocations", jobId, (ack) => {
+        if (ack && ack.ok === false) {
+          setRoggPreview(null);
+          setRolaborPreview(null);
+          setError(ack.error || t("dms.labels.allocations_error"));
+          if (socket) {
+            socket.allocationsSummary = [];
+            socket.rrAllocationsRaw = ack;
+          }
+          return;
+        }
+
+        const jobAllocRows = normalizeJobAllocations(ack);
+
+        setRoggPreview(ack?.rogg || null);
+        setRolaborPreview(ack?.rolabor || null);
+        setError(null);
+
+        if (socket) {
+          socket.allocationsSummary = jobAllocRows;
+          socket.rrAllocationsRaw = ack;
+        }
+      });
+    } catch {
+      setRoggPreview(null);
+      setRolaborPreview(null);
+      setError(t("dms.labels.allocations_error"));
+      if (socket) {
+        socket.allocationsSummary = [];
+      }
+    }
+  }, [socket, jobId, t]);
+
+  useEffect(() => {
+    fetchAllocations();
+  }, [fetchAllocations]);
+
+  const opCode = bodyshop?.rr_configuration?.baseOpCode || "28TOZ";
+
+  const segmentLabelMap = {
+    partsExtras: "Parts/Extras",
+    laborTaxable: "Taxable Labor",
+    laborNonTaxable: "Non-Taxable Labor"
+  };
+
+  const roggRows = useMemo(() => {
+    if (!roggPreview || !Array.isArray(roggPreview.ops)) return [];
+    const rows = [];
+    roggPreview.ops.forEach((op) => {
+      (op.lines || []).forEach((line, idx) => {
+        const baseDesc = line.itemDesc;
+        const segmentKind = op.segmentKind;
+        const segmentCount = op.segmentCount || 0;
+        const segmentLabel = segmentLabelMap[segmentKind] || segmentKind;
+        const displayDesc = segmentCount > 1 && segmentLabel ? `${baseDesc} (${segmentLabel})` : baseDesc;
+
+        rows.push({
+          key: `${op.jobNo}-${idx}`,
+          opCode: op.opCode,
+          jobNo: op.jobNo,
+          breakOut: line.breakOut,
+          itemType: line.itemType,
+          itemDesc: displayDesc,
+          custQty: line.custQty,
+          custPayTypeFlag: line.custPayTypeFlag,
+          custTxblNtxblFlag: line.custTxblNtxblFlag,
+          custPrice: line.amount?.custPrice,
+          dlrCost: line.amount?.dlrCost,
+          // segment metadata for visual styling
+          segmentKind,
+          segmentCount
+        });
+      });
+    });
+    return rows;
+  }, [roggPreview]);
+
+  const rolaborRows = useMemo(() => {
+    if (!rolaborPreview || !Array.isArray(rolaborPreview.ops)) return [];
+    return rolaborPreview.ops.map((op, idx) => ({
+      key: `${op.jobNo}-${idx}`,
+      opCode: op.opCode,
+      jobNo: op.jobNo,
+      custPayTypeFlag: op.custPayTypeFlag,
+      custTxblNtxblFlag: op.custTxblNtxblFlag,
+      payType: op.bill?.payType,
+      amtType: op.amount?.amtType,
+      custPrice: op.amount?.custPrice,
+      totalAmt: op.amount?.totalAmt
+    }));
+  }, [rolaborPreview]);
+
+  // Totals for ROGOG (sum custPrice + dlrCost over all lines)
+  const roggTotals = useMemo(() => {
+    if (!roggPreview || !Array.isArray(roggPreview.ops)) {
+      return { totalCustPrice: "0.00", totalDlrCost: "0.00" };
+    }
+
+    let totalCustCents = 0;
+    let totalCostCents = 0;
+
+    roggPreview.ops.forEach((op) => {
+      (op.lines || []).forEach((line) => {
+        const cp = parseFloat(line.amount?.custPrice || "0");
+        if (!Number.isNaN(cp)) {
+          totalCustCents += Math.round(cp * 100);
+        }
+
+        const dc = parseFloat(line.amount?.dlrCost || "0");
+        if (!Number.isNaN(dc)) {
+          totalCostCents += Math.round(dc * 100);
+        }
+      });
+    });
+
+    return {
+      totalCustPrice: (totalCustCents / 100).toFixed(2),
+      totalDlrCost: (totalCostCents / 100).toFixed(2)
+    };
+  }, [roggPreview]);
+
+  const roggColumns = [
+    { title: "JobNo", dataIndex: "jobNo", key: "jobNo" },
+    { title: "OpCode", dataIndex: "opCode", key: "opCode" },
+    { title: "BreakOut", dataIndex: "breakOut", key: "breakOut" },
+    { title: "ItemType", dataIndex: "itemType", key: "itemType" },
+    { title: "ItemDesc", dataIndex: "itemDesc", key: "itemDesc" },
+    { title: "CustQty", dataIndex: "custQty", key: "custQty" },
+    { title: "CustTxblFlag", dataIndex: "custTxblNtxblFlag", key: "custTxblNtxblFlag" },
+    { title: "CustPrice", dataIndex: "custPrice", key: "custPrice" },
+    { title: "DlrCost", dataIndex: "dlrCost", key: "dlrCost" }
+  ];
+
+  const rolaborColumns = [
+    { title: "JobNo", dataIndex: "jobNo", key: "jobNo" },
+    { title: "OpCode", dataIndex: "opCode", key: "opCode" },
+    { title: "CustPayType", dataIndex: "custPayTypeFlag", key: "custPayTypeFlag" },
+    { title: "CustTxblFlag", dataIndex: "custTxblNtxblFlag", key: "custTxblNtxblFlag" },
+    { title: "PayType", dataIndex: "payType", key: "payType" },
+    { title: "AmtType", dataIndex: "amtType", key: "amtType" },
+    { title: "CustPrice", dataIndex: "custPrice", key: "custPrice" },
+    { title: "TotalAmt", dataIndex: "totalAmt", key: "totalAmt" }
+  ];
+
+  const tabItems = [
+    {
+      key: "rogog",
+      label: "ROGOG Preview",
+      children: (
+        <>
+          <Typography.Paragraph type="secondary" style={{ marginBottom: 8 }}>
+            OpCode: <strong>{opCode}</strong>. Only centers with RR GOG mapping (rr_gogcode &amp; rr_item_type) are
+            included. Totals below reflect exactly what will be sent in ROGOG.
+          </Typography.Paragraph>
+          <Table
+            pagination={false}
+            columns={roggColumns}
+            rowKey="key"
+            dataSource={roggRows}
+            locale={{ emptyText: "No ROGOG lines would be generated." }}
+            scroll={{ x: true }}
+            // 👇 visually highlight splits; especially taxable/non-taxable labor segments
+            rowClassName={(record) => {
+              if (
+                record.segmentCount > 1 &&
+                (record.segmentKind === "laborTaxable" || record.segmentKind === "laborNonTaxable")
+              ) {
+                return "rr-allocations-tax-split-row";
+              }
+              if (record.segmentCount > 1) {
+                return "rr-allocations-split-row";
+              }
+              return "";
+            }}
+            summary={() => {
+              const hasCustTotal = Number(roggTotals.totalCustPrice) !== 0;
+              const hasCostTotal = Number(roggTotals.totalDlrCost) !== 0;
+
+              return (
+                <Table.Summary.Row>
+                  <Table.Summary.Cell index={0}>
+                    <Typography.Title level={5}>{t("general.labels.totals")}</Typography.Title>
+                  </Table.Summary.Cell>
+                  <Table.Summary.Cell index={1} />
+                  <Table.Summary.Cell index={2} />
+                  <Table.Summary.Cell index={3} />
+                  <Table.Summary.Cell index={4} />
+                  <Table.Summary.Cell index={5} />
+                  <Table.Summary.Cell index={6} />
+                  <Table.Summary.Cell index={7}>{hasCustTotal ? roggTotals.totalCustPrice : null}</Table.Summary.Cell>
+                  <Table.Summary.Cell index={8}>{hasCostTotal ? roggTotals.totalDlrCost : null}</Table.Summary.Cell>
+                </Table.Summary.Row>
+              );
+            }}
+          />
+        </>
+      )
+    },
+    {
+      key: "rolabor",
+      label: "ROLABOR Preview",
+      children: (
+        <>
+          <Typography.Paragraph type="secondary" style={{ marginBottom: 8 }}>
+            This mirrors the shell that would be sent for ROLABOR when all financials are carried in GOG.
+          </Typography.Paragraph>
+          <Table
+            pagination={false}
+            columns={rolaborColumns}
+            rowKey="key"
+            dataSource={rolaborRows}
+            locale={{ emptyText: "No ROLABOR lines would be generated." }}
+            scroll={{ x: true }}
+          />
+        </>
+      )
+    }
+  ];
+
+  return (
+    <Card
+      title={title}
+      extra={
+        <Button onClick={fetchAllocations} aria-label={t("general.actions.refresh")}>
+          <SyncOutlined />
+        </Button>
+      }
+    >
+      {bodyshop.pbs_configuration?.disablebillwip && (
+        <Alert type="warning" message={t("jobs.labels.dms.disablebillwip")} />
+      )}
+
+      {error && <Alert type="error" style={{ marginTop: 8, marginBottom: 8 }} message={error} />}
+
+      <Tabs defaultActiveKey="rogog" items={tabItems} />
+    </Card>
+  );
+}

client/src/components/dms-cdk-makes/dms-cdk-makes.refetch.component.jsx

@@ -5,6 +5,7 @@ import { useTranslation } from "react-i18next";
 import { connect } from "react-redux";
 import { createStructuredSelector } from "reselect";
 import { selectBodyshop, selectCurrentUser } from "../../redux/user/user.selectors";
+import { useSplitTreatments } from "@splitsoftware/splitio-react";
 
 const mapStateToProps = createStructuredSelector({
   currentUser: selectCurrentUser,
@@ -18,15 +19,26 @@ export default connect(mapStateToProps, mapDispatchToProps)(DmsCdkMakesRefetch);
 export function DmsCdkMakesRefetch({ currentUser, bodyshop }) {
   const [loading, setLoading] = useState(false);
   const { t } = useTranslation();
+  const {
+    treatments: { Fortellis }
+  } = useSplitTreatments({
+    attributes: {},
+    names: ["Fortellis"],
+    splitKey: bodyshop.imexshopid
+  });
 
   if (!currentUser.email.includes("@imex.")) return null;
 
   const handleRefetch = async () => {
-    setLoading(true);
+    try {
-    await axios.post("/cdk/getvehicles", {
+      setLoading(true);
-      cdk_dealerid: bodyshop.cdk_dealerid,
+      await axios.post(`cdk${Fortellis.treatment === "on" ? "/fortellis" : ""}/getvehicles`, {
-      bodyshopid: bodyshop.id
+        cdk_dealerid: bodyshop.cdk_dealerid,
-    });
+        bodyshopid: bodyshop.id
+      });
+    } catch (error) {
+      console.error(error);
+    }
 
     setLoading(false);
   };

client/src/components/dms-customer-selector/cdk-customer-selector.jsx

@@ -0,0 +1,102 @@
+import { Button, Checkbox, Col, Table } from "antd";
+import { useEffect, useState } from "react";
+import { useTranslation } from "react-i18next";
+import { alphaSort } from "../../utils/sorters";
+
+export default function CDKCustomerSelector({ bodyshop, socket }) {
+  const { t } = useTranslation();
+  const [open, setOpen] = useState(false);
+  const [customerList, setCustomerList] = useState([]);
+  const [selectedCustomer, setSelectedCustomer] = useState(null);
+
+  useEffect(() => {
+    if (!socket) return;
+    const handleCdkSelectCustomer = (list) => {
+      setOpen(true);
+      setCustomerList(Array.isArray(list) ? list : []);
+      setSelectedCustomer(null);
+    };
+    socket.on("cdk-select-customer", handleCdkSelectCustomer);
+    return () => {
+      socket.off("cdk-select-customer", handleCdkSelectCustomer);
+    };
+  }, [socket]);
+
+  const onUseSelected = () => {
+    if (!selectedCustomer) return;
+    setOpen(false);
+    socket.emit("cdk-selected-customer", selectedCustomer);
+    setSelectedCustomer(null);
+  };
+
+  const onUseGeneric = () => {
+    const generic = bodyshop.cdk_configuration?.generic_customer_number || null;
+    setOpen(false);
+    socket.emit("cdk-selected-customer", generic);
+    setSelectedCustomer(null);
+  };
+
+  const onCreateNew = () => {
+    setOpen(false);
+    socket.emit("cdk-selected-customer", null);
+    setSelectedCustomer(null);
+  };
+
+  if (!open) return null;
+
+  const columns = [
+    { title: t("jobs.fields.dms.id"), dataIndex: ["id", "value"], key: "id" },
+    {
+      title: t("jobs.fields.dms.vinowner"),
+      dataIndex: "vinOwner",
+      key: "vinOwner",
+      render: (_t, r) => <Checkbox disabled checked={r.vinOwner} />
+    },
+    {
+      title: t("jobs.fields.dms.name1"),
+      dataIndex: ["name1", "fullName"],
+      key: "name1",
+      sorter: (a, b) => alphaSort(a.name1?.fullName, b.name1?.fullName)
+    },
+    {
+      title: t("jobs.fields.dms.address"),
+      key: "address",
+      render: (record) =>
+        `${record.address?.addressLine && record.address.addressLine[0]}, ${record.address?.city} ${
+          record.address?.stateOrProvince
+        } ${record.address?.postalCode}`
+    }
+  ];
+
+  const rowKey = (r) => r.id?.value || r.customerId;
+
+  return (
+    <Col span={24}>
+      <Table
+        title={() => (
+          <div style={{ display: "flex", gap: 8, flexWrap: "wrap" }}>
+            <Button onClick={onUseSelected} disabled={!selectedCustomer}>
+              {t("jobs.actions.dms.useselected")}
+            </Button>
+            <Button onClick={onUseGeneric} disabled={!bodyshop.cdk_configuration?.generic_customer_number}>
+              {t("jobs.actions.dms.usegeneric")}
+            </Button>
+            <Button onClick={onCreateNew}>{t("jobs.actions.dms.createnewcustomer")}</Button>
+          </div>
+        )}
+        pagination={{ position: "top" }}
+        columns={columns}
+        rowKey={rowKey}
+        dataSource={customerList}
+        rowSelection={{
+          onSelect: (r) => {
+            const key = r.id?.value || r.customerId;
+            setSelectedCustomer(key ? String(key) : null);
+          },
+          type: "radio",
+          selectedRowKeys: selectedCustomer ? [selectedCustomer] : []
+        }}
+      />
+    </Col>
+  );
+}

client/src/components/dms-customer-selector/dms-customer-selector.component.jsx

@@ -1,134 +1,54 @@
-import { Button, Checkbox, Col, Table } from "antd";
+import { useMemo } from "react";
-import { useState } from "react";
-import { useTranslation } from "react-i18next";
 import { connect } from "react-redux";
 import { createStructuredSelector } from "reselect";
-import { socket } from "../../pages/dms/dms.container";
+
 import { selectBodyshop } from "../../redux/user/user.selectors";
-import { alphaSort } from "../../utils/sorters";
+
+import RRCustomerSelector from "./rr-customer-selector";
+import FortellisCustomerSelector from "./fortellis-customer-selector";
+import CDKCustomerSelector from "./cdk-customer-selector";
+import PBSCustomerSelector from "./pbs-customer-selector";
+import { DMS_MAP } from "../../utils/dmsUtils";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop
 });
-const mapDispatchToProps = () => ({
+const mapDispatchToProps = () => ({});
-  //setUserLanguage: language => dispatch(setUserLanguage(language))
-});
 export default connect(mapStateToProps, mapDispatchToProps)(DmsCustomerSelector);
 
-export function DmsCustomerSelector({ bodyshop }) {
+/**
-  const { t } = useTranslation();
+ * DMS Customer Selector component that renders the appropriate customer selector
-  const [customerList, setcustomerList] = useState([]);
+ * @param props
-  const [open, setOpen] = useState(false);
+ * @returns {JSX.Element|null}
-  const [selectedCustomer, setSelectedCustomer] = useState(null);
+ * @constructor
-  const [dmsType, setDmsType] = useState("cdk");
+ */
+export function DmsCustomerSelector(props) {
+  const { bodyshop, jobid, socket, rrOptions = {} } = props;
 
-  socket.on("cdk-select-customer", (customerList) => {
+  // Centralized "mode" (provider + transport)
-    setOpen(true);
+  const mode = props.mode;
-    setDmsType("cdk");
-    setcustomerList(customerList);
-  });
-  socket.on("pbs-select-customer", (customerList) => {
-    setOpen(true);
-    setDmsType("pbs");
-    setcustomerList(customerList);
-  });
 
-  const onUseSelected = () => {
+  // Stable base props for children
-    setOpen(false);
+  const base = useMemo(() => ({ bodyshop, jobid, socket }), [bodyshop, jobid, socket]);
-    socket.emit(`${dmsType}-selected-customer`, selectedCustomer);
-    setSelectedCustomer(null);
-  };
 
-  const onUseGeneric = () => {
+  switch (mode) {
-    setOpen(false);
+    case DMS_MAP.reynolds: {
-    socket.emit(`${dmsType}-selected-customer`, bodyshop.cdk_configuration.generic_customer_number);
+      // Map rrOptions to current RR prop shape (you can also just pass rrOptions through and unpack in RR)
-    setSelectedCustomer(null);
+      const rrProps = {
-  };
+        rrOpenRoLimit: rrOptions.openRoLimit,
-
+        onRrOpenRoFinished: rrOptions.onOpenRoFinished,
-  const onCreateNew = () => {
+        rrValidationPending: rrOptions.validationPending,
-    setOpen(false);
+        onValidationFinished: rrOptions.onValidationFinished
-    socket.emit(`${dmsType}-selected-customer`, null);
+      };
-    setSelectedCustomer(null);
+      return <RRCustomerSelector {...base} {...rrProps} />;
-  };
-
-  const cdkColumns = [
-    {
-      title: t("jobs.fields.dms.id"),
-      dataIndex: ["id", "value"],
-      key: "id"
-    },
-    {
-      title: t("jobs.fields.dms.vinowner"),
-      dataIndex: "vinOwner",
-      key: "vinOwner",
-      render: (text, record) => <Checkbox disabled checked={record.vinOwner} />
-    },
-    {
-      title: t("jobs.fields.dms.name1"),
-      dataIndex: ["name1", "fullName"],
-      key: "name1",
-      sorter: (a, b) => alphaSort(a.name1?.fullName, b.name1?.fullName)
-    },
-
-    {
-      title: t("jobs.fields.dms.address"),
-      //dataIndex: ["name2", "fullName"],
-      key: "address",
-      render: (record) =>
-        `${record.address?.addressLine && record.address.addressLine[0]}, ${record.address?.city} ${
-          record.address?.stateOrProvince
-        } ${record.address?.postalCode}`
     }
-  ];
+    case DMS_MAP.fortellis:
-
+      return <FortellisCustomerSelector {...base} />;
-  const pbsColumns = [
+    case DMS_MAP.cdk:
-    {
+      return <CDKCustomerSelector {...base} />;
-      title: t("jobs.fields.dms.id"),
+    case DMS_MAP.pbs:
-      dataIndex: "ContactId",
+      return <PBSCustomerSelector {...base} />;
-      key: "ContactId"
+    default:
-    },
+      return null;
-    {
+  }
-      title: t("jobs.fields.dms.name1"),
-      key: "name1",
-      sorter: (a, b) => alphaSort(a.LastName, b.LastName),
-      render: (text, record) => `${record.FirstName || ""} ${record.LastName || ""}`
-    },
-
-    {
-      title: t("jobs.fields.dms.address"),
-      key: "address",
-      render: (record) => `${record.Address}, ${record.City} ${record.State} ${record.ZipCode}`
-    }
-  ];
-
-  if (!open) return null;
-  return (
-    <Col span={24}>
-      <Table
-        title={() => (
-          <div>
-            <Button onClick={onUseSelected} disabled={!selectedCustomer}>
-              {t("jobs.actions.dms.useselected")}
-            </Button>
-            <Button onClick={onUseGeneric} disabled={!bodyshop.cdk_configuration?.generic_customer_number}>
-              {t("jobs.actions.dms.usegeneric")}
-            </Button>
-            <Button onClick={onCreateNew}>{t("jobs.actions.dms.createnewcustomer")}</Button>
-          </div>
-        )}
-        pagination={{ position: "top" }}
-        columns={dmsType === "cdk" ? cdkColumns : pbsColumns}
-        rowKey={(record) => (dmsType === "cdk" ? record.id.value : record.ContactId)}
-        dataSource={customerList}
-        //onChange={handleTableChange}
-        rowSelection={{
-          onSelect: (record) => {
-            setSelectedCustomer(dmsType === "cdk" ? record.id.value : record.ContactId);
-          },
-          type: "radio",
-          selectedRowKeys: [selectedCustomer]
-        }}
-      />
-    </Col>
-  );
 }

client/src/components/dms-customer-selector/fortellis-customer-selector.jsx

@@ -0,0 +1,105 @@
+import { Button, Checkbox, Col, Table } from "antd";
+import { useEffect, useState } from "react";
+import { useTranslation } from "react-i18next";
+import { alphaSort } from "../../utils/sorters";
+
+export default function FortellisCustomerSelector({ bodyshop, jobid, socket }) {
+  const { t } = useTranslation();
+  const [open, setOpen] = useState(false);
+  const [customerList, setCustomerList] = useState([]);
+  const [selectedCustomer, setSelectedCustomer] = useState(null);
+
+  useEffect(() => {
+    if (!socket) return;
+    const handleFortellisSelectCustomer = (list) => {
+      setOpen(true);
+      setCustomerList(Array.isArray(list) ? list : []);
+      setSelectedCustomer(null);
+    };
+    socket.on("fortellis-select-customer", handleFortellisSelectCustomer);
+    return () => {
+      socket.off("fortellis-select-customer", handleFortellisSelectCustomer);
+    };
+  }, [socket]);
+
+  const onUseSelected = () => {
+    if (!selectedCustomer) return;
+    setOpen(false);
+    socket.emit("fortellis-selected-customer", { selectedCustomerId: selectedCustomer, jobid });
+    setSelectedCustomer(null);
+  };
+
+  const onUseGeneric = () => {
+    const generic = bodyshop.cdk_configuration?.generic_customer_number || null;
+    setOpen(false);
+    socket.emit("fortellis-selected-customer", { selectedCustomerId: generic, jobid });
+    setSelectedCustomer(null);
+  };
+
+  const onCreateNew = () => {
+    setOpen(false);
+    socket.emit("fortellis-selected-customer", { selectedCustomerId: null, jobid });
+    setSelectedCustomer(null);
+  };
+
+  if (!open) return null;
+
+  const columns = [
+    { title: t("jobs.fields.dms.id"), dataIndex: "customerId", key: "id" },
+    {
+      title: t("jobs.fields.dms.vinowner"),
+      dataIndex: "vinOwner",
+      key: "vinOwner",
+      render: (_t, r) => <Checkbox disabled checked={r.vinOwner} />
+    },
+    {
+      title: t("jobs.fields.dms.name1"),
+      dataIndex: ["customerName", "firstName"],
+      key: "firstName",
+      sorter: (a, b) => alphaSort(a.customerName?.firstName, b.customerName?.firstName)
+    },
+    {
+      title: t("jobs.fields.dms.name1"),
+      dataIndex: ["customerName", "lastName"],
+      key: "lastName",
+      sorter: (a, b) => alphaSort(a.customerName?.lastName, b.customerName?.lastName)
+    },
+    {
+      title: t("jobs.fields.dms.address"),
+      key: "address",
+      render: (record) =>
+        `${record.postalAddress?.addressLine1 || ""}${
+          record.postalAddress?.addressLine2 ? `, ${record.postalAddress.addressLine2}` : ""
+        }, ${record.postalAddress?.city || ""} ${record.postalAddress?.state || ""} ${
+          record.postalAddress?.postalCode || ""
+        } ${record.postalAddress?.country || ""}`
+    }
+  ];
+
+  return (
+    <Col span={24}>
+      <Table
+        title={() => (
+          <div style={{ display: "flex", gap: 8, flexWrap: "wrap" }}>
+            <Button onClick={onUseSelected} disabled={!selectedCustomer}>
+              {t("jobs.actions.dms.useselected")}
+            </Button>
+            <Button onClick={onUseGeneric} disabled={!bodyshop.cdk_configuration?.generic_customer_number}>
+              {t("jobs.actions.dms.usegeneric")}
+            </Button>
+            <Button onClick={onCreateNew}>{t("jobs.actions.dms.createnewcustomer")}</Button>
+          </div>
+        )}
+        pagination={{ position: "top" }}
+        columns={columns}
+        rowKey={(r) => r.customerId}
+        dataSource={customerList}
+        rowSelection={{
+          onSelect: (r) => setSelectedCustomer(r?.customerId ? String(r.customerId) : null),
+          type: "radio",
+          selectedRowKeys: selectedCustomer ? [selectedCustomer] : []
+        }}
+      />
+    </Col>
+  );
+}

client/src/components/dms-customer-selector/pbs-customer-selector.jsx

@@ -0,0 +1,93 @@
+import { Button, Col, Table } from "antd";
+import { useEffect, useState } from "react";
+import { useTranslation } from "react-i18next";
+import { alphaSort } from "../../utils/sorters";
+
+export default function PBSCustomerSelector({ bodyshop, socket }) {
+  const { t } = useTranslation();
+  const [open, setOpen] = useState(false);
+  const [customerList, setCustomerList] = useState([]);
+  const [selectedCustomer, setSelectedCustomer] = useState(null);
+
+  useEffect(() => {
+    if (!socket) return;
+    const handlePbsSelectCustomer = (list) => {
+      setOpen(true);
+      setCustomerList(Array.isArray(list) ? list : []);
+      setSelectedCustomer(null);
+    };
+    socket.on("pbs-select-customer", handlePbsSelectCustomer);
+    return () => {
+      socket.off("pbs-select-customer", handlePbsSelectCustomer);
+    };
+  }, [socket]);
+
+  const onUseSelected = () => {
+    if (!selectedCustomer) return;
+    setOpen(false);
+    socket.emit("pbs-selected-customer", selectedCustomer);
+    setSelectedCustomer(null);
+  };
+
+  // Restores old behavior: reuse the CDK-named generic number for PBS too,
+  // matching the previous single-component implementation.
+  const onUseGeneric = () => {
+    const generic = bodyshop?.cdk_configuration?.generic_customer_number || null;
+    if (!generic) return;
+    setOpen(false);
+    socket.emit("pbs-selected-customer", generic);
+    setSelectedCustomer(null);
+  };
+
+  const onCreateNew = () => {
+    setOpen(false);
+    socket.emit("pbs-selected-customer", null);
+    setSelectedCustomer(null);
+  };
+
+  if (!open) return null;
+
+  const columns = [
+    { title: t("jobs.fields.dms.id"), dataIndex: "ContactId", key: "ContactId" },
+    {
+      title: t("jobs.fields.dms.name1"),
+      key: "name1",
+      sorter: (a, b) => alphaSort(a.LastName, b.LastName),
+      render: (_t, r) => `${r.FirstName || ""} ${r.LastName || ""}`
+    },
+    {
+      title: t("jobs.fields.dms.address"),
+      key: "address",
+      render: (r) => `${r.Address}, ${r.City} ${r.State} ${r.ZipCode}`
+    }
+  ];
+
+  const hasGeneric = !!bodyshop?.cdk_configuration?.generic_customer_number;
+
+  return (
+    <Col span={24}>
+      <Table
+        title={() => (
+          <div style={{ display: "flex", gap: 8, flexWrap: "wrap" }}>
+            <Button onClick={onUseSelected} disabled={!selectedCustomer}>
+              {t("jobs.actions.dms.useselected")}
+            </Button>
+            <Button onClick={onUseGeneric} disabled={!hasGeneric}>
+              {t("jobs.actions.dms.usegeneric")}
+            </Button>
+            <Button onClick={onCreateNew}>{t("jobs.actions.dms.createnewcustomer")}</Button>
+          </div>
+        )}
+        pagination={{ position: "top" }}
+        columns={columns}
+        rowKey={(r) => r.ContactId}
+        dataSource={customerList}
+        rowSelection={{
+          onSelect: (r) => setSelectedCustomer(r?.ContactId ? String(r.ContactId) : null),
+          type: "radio",
+          selectedRowKeys: selectedCustomer ? [selectedCustomer] : []
+        }}
+      />
+    </Col>
+  );
+}

client/src/components/dms-customer-selector/rr-customer-selector.jsx

@@ -0,0 +1,267 @@
+import { Alert, Button, Checkbox, Col, message, Space, Table } from "antd";
+import { useEffect, useMemo, useState } from "react";
+import { useTranslation } from "react-i18next";
+import { alphaSort } from "../../utils/sorters";
+
+const normalizeRrList = (list) => {
+  if (!Array.isArray(list)) return [];
+  return list
+    .map((row) => {
+      const custNo = row.custNo || row.CustomerId || row.customerId || null;
+      const name =
+        row.name ||
+        [row.CustomerName?.FirstName, row.CustomerName?.LastName].filter(Boolean).join(" ").trim() ||
+        (custNo ? String(custNo) : "");
+      if (!custNo) return null;
+      const vinOwner = !!(row.vinOwner ?? row.isVehicleOwner);
+
+      const address =
+        row.address && typeof row.address === "object"
+          ? {
+              line1: row.address.line1 ?? row.address.addr1 ?? row.address.Address1 ?? undefined,
+              line2: row.address.line2 ?? row.address.addr2 ?? row.address.Address2 ?? undefined,
+              city: row.address.city ?? undefined,
+              state: row.address.state ?? row.address.stateOrProvince ?? undefined,
+              postalCode: row.address.postalCode ?? row.address.zip ?? undefined,
+              country: row.address.country ?? row.address.countryCode ?? undefined
+            }
+          : undefined;
+
+      return { custNo: String(custNo), name, vinOwner, address };
+    })
+    .filter(Boolean);
+};
+
+const rrAddressToString = (addr) => {
+  if (!addr) return "";
+  const parts = [
+    addr.line1,
+    addr.line2,
+    [addr.city, addr.state].filter(Boolean).join(" "),
+    addr.postalCode,
+    addr.country
+  ].filter(Boolean);
+  return parts.join(", ");
+};
+
+export default function RRCustomerSelector({
+  jobid,
+  socket,
+  rrOpenRoLimit = false,
+  onRrOpenRoFinished,
+  rrValidationPending = false,
+  onValidationFinished
+}) {
+  const { t } = useTranslation();
+  const [open, setOpen] = useState(false);
+  const [customerList, setCustomerList] = useState([]);
+  const [selectedCustomer, setSelectedCustomer] = useState(null);
+  const [refreshing, setRefreshing] = useState(false);
+
+  // Show dialog automatically when validation is pending
+  useEffect(() => {
+    if (rrValidationPending) setOpen(true);
+  }, [rrValidationPending]);
+
+  // Listen for RR customer selection list
+  useEffect(() => {
+    if (!socket) return;
+    const handleRrSelectCustomer = (list) => {
+      const normalized = normalizeRrList(list);
+      setOpen(true);
+      setCustomerList(normalized);
+      const firstOwner = normalized.find((r) => r.vinOwner)?.custNo;
+      setSelectedCustomer(firstOwner ? String(firstOwner) : null);
+      setRefreshing(false);
+    };
+    socket.on("rr-select-customer", handleRrSelectCustomer);
+    return () => {
+      socket.off("rr-select-customer", handleRrSelectCustomer);
+    };
+  }, [socket]);
+
+  // VIN owner set
+  const rrOwnerSet = useMemo(() => {
+    return new Set(customerList.filter((c) => c?.vinOwner || c?.isVehicleOwner).map((c) => String(c.custNo)));
+  }, [customerList]);
+  const rrHasVinOwner = rrOwnerSet.size > 0;
+
+  // Enforce VIN owner stays selected if present
+  useEffect(() => {
+    if (!rrHasVinOwner) return;
+    const firstOwner = (customerList.find((c) => c.vinOwner) || {}).custNo;
+    if (firstOwner && String(selectedCustomer) !== String(firstOwner)) {
+      setSelectedCustomer(String(firstOwner));
+    }
+  }, [rrHasVinOwner, customerList, selectedCustomer]);
+
+  const onUseSelected = () => {
+    if (!selectedCustomer) {
+      message.warning(t("general.actions.select"));
+      return;
+    }
+    if (rrHasVinOwner && !rrOwnerSet.has(String(selectedCustomer))) {
+      message.warning(
+        "This VIN is already assigned in Reynolds. Only the VIN owner can be selected. To choose a different customer, change ownership in Reynolds first."
+      );
+      return;
+    }
+    socket.emit("rr-selected-customer", { jobId: jobid, custNo: String(selectedCustomer) }, (ack) => {
+      if (ack?.ok) {
+        message.success(t("dms.messages.customerSelected"));
+      } else if (ack?.error) {
+        message.error(ack.error);
+      }
+    });
+  };
+
+  const onCreateNew = () => {
+    if (rrHasVinOwner) return;
+    socket.emit("rr-selected-customer", { jobId: jobid, create: true }, (ack) => {
+      if (ack?.ok) {
+        if (ack.custNo) setSelectedCustomer(String(ack.custNo));
+        message.success(t("dms.messages.customerCreated"));
+      } else if (ack?.error) {
+        message.error(ack.error);
+      }
+    });
+  };
+
+  const refreshRrSearch = () => {
+    setRefreshing(true);
+    const to = setTimeout(() => setRefreshing(false), 12000);
+    const stop = () => {
+      clearTimeout(to);
+      setRefreshing(false);
+      socket.off("export-failed", stop);
+      socket.off("rr-select-customer", stop);
+    };
+    socket.once("rr-select-customer", stop);
+    socket.once("export-failed", stop);
+    socket.emit("rr-export-job", { jobId: jobid });
+  };
+
+  if (!open) return null;
+
+  const columns = [
+    { title: t("jobs.fields.dms.id"), dataIndex: "custNo", key: "custNo" },
+    {
+      title: t("jobs.fields.dms.vinowner"),
+      dataIndex: "vinOwner",
+      key: "vinOwner",
+      render: (_t, r) => <Checkbox disabled checked={!!(r.vinOwner ?? r.isVehicleOwner)} />
+    },
+    {
+      title: t("jobs.fields.dms.name1"),
+      dataIndex: "name",
+      key: "name",
+      sorter: (a, b) => alphaSort(a?.name, b?.name)
+    },
+    {
+      title: t("jobs.fields.dms.address"),
+      key: "address",
+      render: (record) => rrAddressToString(record.address)
+    }
+  ];
+
+  const rrDisableRow = (record) => {
+    if (!rrHasVinOwner) return false;
+    return !rrOwnerSet.has(String(record.custNo));
+  };
+
+  return (
+    <Col span={24}>
+      <Table
+        title={() => (
+          <div style={{ display: "flex", flexDirection: "column", gap: 8 }}>
+            {/* Open RO limit banner */}
+            {rrOpenRoLimit && (
+              <Alert
+                type="error"
+                showIcon
+                message="Open RO limit reached in Reynolds"
+                description={
+                  <div style={{ display: "flex", flexDirection: "column", gap: 8 }}>
+                    <div>
+                      Reynolds has reached the maximum number of open Repair Orders for this Customer. Close or finalize
+                      an RO in Reynolds, then click <strong>Finished</strong> to continue.
+                    </div>
+                    <div>
+                      <Button type="primary" danger onClick={onRrOpenRoFinished}>
+                        Finished
+                      </Button>
+                    </div>
+                  </div>
+                }
+              />
+            )}
+
+            {/* Validation step banner */}
+            {rrValidationPending && (
+              <Alert
+                type="info"
+                showIcon
+                message="Complete Validation in Reynolds"
+                description={
+                  <div style={{ display: "flex", flexDirection: "column", gap: 8 }}>
+                    <div>
+                      We created the Repair Order. Please validate the totals and taxes in the DMS system. When done,
+                      click <strong>Finished</strong> to finalize and mark this export as complete.
+                    </div>
+                    <div>
+                      <Space>
+                        <Button type="primary" onClick={onValidationFinished}>
+                          Finished
+                        </Button>
+                      </Space>
+                    </div>
+                  </div>
+                }
+              />
+            )}
+
+            <div style={{ display: "flex", gap: 8, flexWrap: "wrap" }}>
+              <Button onClick={onUseSelected} disabled={!selectedCustomer || rrOpenRoLimit}>
+                {t("jobs.actions.dms.useselected")}
+              </Button>
+              {/* No generic in RR */}
+              <Button onClick={onCreateNew} disabled={rrHasVinOwner}>
+                {t("jobs.actions.dms.createnewcustomer")}
+              </Button>
+            </div>
+
+            {rrHasVinOwner && (
+              <Alert
+                type="warning"
+                showIcon
+                message="VIN ownership enforced"
+                description={
+                  <div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", gap: 12 }}>
+                    <div>
+                      This VIN is already assigned in Reynolds. Only the VIN owner is selectable here. To use a
+                      different customer, please change the vehicle ownership in Reynolds first, then return to complete
+                      the export.
+                    </div>
+                    <Button onClick={refreshRrSearch} loading={refreshing}>
+                      Refresh
+                    </Button>
+                  </div>
+                }
+              />
+            )}
+          </div>
+        )}
+        pagination={{ position: "top" }}
+        columns={columns}
+        rowKey={(r) => r.custNo}
+        dataSource={customerList}
+        rowSelection={{
+          onSelect: (record) => setSelectedCustomer(record?.custNo ? String(record.custNo) : null),
+          type: "radio",
+          selectedRowKeys: selectedCustomer ? [selectedCustomer] : [],
+          getCheckboxProps: (record) => ({ disabled: rrDisableRow(record) })
+        }}
+      />
+    </Col>
+  );
+}

client/src/components/dms-log-events/dms-log-events.component.jsx

@@ -1,50 +1,234 @@
 import { Divider, Space, Tag, Timeline } from "antd";
+import { useEffect, useMemo, useState } from "react";
 import dayjs from "../../utils/day";
 import { connect } from "react-redux";
 import { createStructuredSelector } from "reselect";
-import { setBreadcrumbs, setSelectedHeader } from "../../redux/application/application.actions";
+import { selectDarkMode } from "../../redux/application/application.selectors.js";
 
-const mapStateToProps = createStructuredSelector({});
+const mapStateToProps = createStructuredSelector({
-
+  isDarkMode: selectDarkMode
-const mapDispatchToProps = (dispatch) => ({
-  setBreadcrumbs: (breadcrumbs) => dispatch(setBreadcrumbs(breadcrumbs)),
-  setSelectedHeader: (key) => dispatch(setSelectedHeader(key))
 });
 
+const mapDispatchToProps = () => ({});
+
 export default connect(mapStateToProps, mapDispatchToProps)(DmsLogEvents);
 
-export function DmsLogEvents({ logs }) {
+export function DmsLogEvents({
-  return (
+  logs,
-    <Timeline
+  detailsOpen,
-      pending
+  detailsNonce,
-      reverse={true}
+  isDarkMode,
-      items={logs.map((log, idx) => ({
+  colorizeJson = false,
-        key: idx,
+  showDetails = true
-        color: LogLevelHierarchy(log.level),
+}) {
-        children: (
+  const [openSet, setOpenSet] = useState(() => new Set());
-          <Space wrap align="start" style={{}}>
+
-            <Tag color={LogLevelHierarchy(log.level)}>{log.level}</Tag>
+  // Inject JSON highlight styles once (only when colorize is enabled)
-            <span>{dayjs(log.timestamp).format("MM/DD/YYYY HH:mm:ss")}</span>
+  useEffect(() => {
-            <Divider type="vertical" />
+    if (!colorizeJson) return;
-            <span>{log.message}</span>
+    if (typeof document === "undefined") return;
-          </Space>
+    if (document.getElementById("json-highlight-styles")) return;
-        )
+    const style = document.createElement("style");
-      }))}
+    style.id = "json-highlight-styles";
-    />
+    style.textContent = `
+      .json-key { color: #fa8c16; }
+      .json-string { color: #52c41a; }
+      .json-number { color: #722ed1; }
+      .json-boolean { color: #1890ff; }
+      .json-null { color: #faad14; }
+    `;
+    document.head.appendChild(style);
+  }, [colorizeJson]);
+
+  // Trim openSet if logs shrink
+  useEffect(() => {
+    const len = (logs || []).length;
+    setOpenSet((prev) => {
+      const next = new Set();
+      for (let i = 0; i < len; i++) if (prev.has(i)) next.add(i);
+      return next;
+    });
+  }, [logs?.length]);
+
+  // Respond to global toggle button
+  useEffect(() => {
+    if (detailsNonce == null) return;
+    const len = (logs || []).length;
+    setOpenSet(detailsOpen ? new Set(Array.from({ length: len }, (_, i) => i)) : new Set());
+  }, [detailsNonce, detailsOpen, logs?.length]);
+
+  const items = useMemo(
+    () =>
+      (logs || []).map((raw, idx) => {
+        const { level, message, timestamp, meta } = normalizeLog(raw);
+
+        // Only treat meta as "present" when we are allowed to show details
+        const hasMeta = !isEmpty(meta) && showDetails;
+        const isOpen = hasMeta && openSet.has(idx);
+
+        return {
+          key: idx,
+          color: logLevelColor(level),
+          children: (
+            <Space direction="vertical" size={4} style={{ display: "flex" }}>
+              {/* Row 1: summary + inline "Details" toggle */}
+              <Space wrap align="start">
+                <Tag color={logLevelColor(level)}>{level}</Tag>
+                <Divider type="vertical" />
+                <span>{dayjs(timestamp).format("MM/DD/YYYY HH:mm:ss")}</span>
+                <Divider type="vertical" />
+                <span>{message}</span>
+                {hasMeta && (
+                  <>
+                    <Divider type="vertical" />
+                    <a
+                      role="button"
+                      aria-expanded={isOpen}
+                      onClick={() =>
+                        setOpenSet((prev) => {
+                          const next = new Set(prev);
+                          if (isOpen) next.delete(idx);
+                          else next.add(idx);
+                          return next;
+                        })
+                      }
+                      style={{ cursor: "pointer", userSelect: "none" }}
+                    >
+                      {isOpen ? "Hide details" : "Details"}
+                    </a>
+                  </>
+                )}
+              </Space>
+
+              {/* Row 2: details body (only when open) */}
+              {hasMeta && isOpen && (
+                <div style={{ marginLeft: 6 }}>
+                  <JsonBlock isDarkMode={isDarkMode} data={meta} colorize={colorizeJson} />
+                </div>
+              )}
+            </Space>
+          )
+        };
+      }),
+    [logs, openSet, colorizeJson, isDarkMode, showDetails]
   );
+
+  return <Timeline pending reverse items={items} />;
 }
 
-function LogLevelHierarchy(level) {
+/**
-  switch (level) {
+ * Normalize various log input formats into a standard structure.
+ * @param input
+ * @returns {{level: string, message: *|string, timestamp: Date, meta: *}}
+ */
+const normalizeLog = (input) => {
+  const n = input?.normalized || input || {};
+  const level = (n.level || input?.level || "INFO").toString().toUpperCase();
+  const message = n.message ?? input?.message ?? "";
+  const meta = input?.meta != null ? input.meta : n.meta != null ? n.meta : undefined;
+  const tsRaw = input?.timestamp ?? n.timestamp ?? input?.ts ?? Date.now();
+  const timestamp = typeof tsRaw === "number" ? new Date(tsRaw) : new Date(tsRaw);
+  return { level, message, timestamp, meta };
+};
+
+/**
+ * Map log level to tag color.
+ * @param level
+ * @returns {string}
+ */
+const logLevelColor = (level) => {
+  switch ((level || "").toUpperCase()) {
+    case "SILLY":
+      return "purple";
     case "DEBUG":
       return "orange";
     case "INFO":
       return "blue";
     case "WARN":
+    case "WARNING":
       return "yellow";
     case "ERROR":
       return "red";
     default:
-      return 0;
+      return "default";
   }
-}
+};
+
+/**
+ * Check if a value is "empty" (null/undefined, empty array, or empty object).
+ * @param v
+ */
+const isEmpty = (v) => {
+  if (v == null) return true;
+  if (Array.isArray(v)) return v.length === 0;
+  if (typeof v === "object") return Object.keys(v).length === 0;
+  return false;
+};
+
+/**
+ * Safely stringify an object to JSON, falling back to String() on failure.
+ * @param obj
+ * @param spaces
+ * @returns {string}
+ */
+const safeStringify = (obj, spaces = 2) => {
+  try {
+    return JSON.stringify(obj, null, spaces);
+  } catch {
+    return String(obj);
+  }
+};
+
+/**
+ * JSON display block with optional syntax highlighting.
+ * @param data
+ * @param colorize
+ * @param isDarkMode
+ * @returns {JSX.Element}
+ * @constructor
+ */
+const JsonBlock = ({ data, colorize, isDarkMode }) => {
+  const jsonText = safeStringify(data, 2);
+  const preStyle = {
+    margin: "6px 0 0",
+    maxWidth: 720,
+    overflowX: "auto",
+    fontFamily: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace',
+    fontSize: 12,
+    lineHeight: 1.45,
+    padding: 8,
+    borderRadius: 6,
+    background: isDarkMode ? "rgba(255,255,255,0.1)" : "rgba(0,0,0,0.04)",
+    border: isDarkMode ? "1px solid rgba(255,255,255,0.12)" : "1px solid rgba(0,0,0,0.08)",
+    color: isDarkMode ? "var(--card-text-fallback)" : "#141414"
+  };
+
+  if (colorize) {
+    const html = syntaxHighlight(jsonText);
+    return <pre style={preStyle} dangerouslySetInnerHTML={{ __html: html }} />;
+  }
+  return <pre style={preStyle}>{jsonText}</pre>;
+};
+
+/**
+ * Syntax highlight JSON text for HTML display.
+ * @param jsonText
+ * @returns {*}
+ */
+const syntaxHighlight = (jsonText) => {
+  const esc = jsonText.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  return esc.replace(
+    /("(?:\\u[\da-fA-F]{4}|\\[^u]|[^\\"])*"(\s*:)?|\b(?:true|false|null)\b|-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?)/g,
+    (match) => {
+      let cls = "json-number";
+      if (match.startsWith('"')) {
+        cls = match.endsWith(":") ? "json-key" : "json-string";
+      } else if (match === "true" || match === "false") {
+        cls = "json-boolean";
+      } else if (match === "null") {
+        cls = "json-null";
+      }
+      return `<span class="${cls}">${match}</span>`;
+    }
+  );
+};

client/src/components/dms-post-form/cdklike-dms-post-form.jsx

@@ -0,0 +1,403 @@
+import { DeleteFilled, DownOutlined } from "@ant-design/icons";
+import {
+  Button,
+  Card,
+  Col,
+  Divider,
+  Dropdown,
+  Form,
+  Input,
+  InputNumber,
+  Row,
+  Select,
+  Space,
+  Statistic,
+  Switch,
+  Tooltip,
+  Typography
+} from "antd";
+import Dinero from "dinero.js";
+import { useTranslation } from "react-i18next";
+import { useMemo, useState } from "react";
+import i18n from "../../translations/i18n";
+import dayjs from "../../utils/day";
+import DmsCdkMakes from "../dms-cdk-makes/dms-cdk-makes.component";
+import DmsCdkMakesRefetch from "../dms-cdk-makes/dms-cdk-makes.refetch.component";
+import DateTimePicker from "../form-date-time-picker/form-date-time-picker.component.jsx";
+import CurrencyInput from "../form-items-formatted/currency-form-item.component";
+import { DMS_MAP } from "../../utils/dmsUtils";
+
+/**
+ * CDK-like DMS post form:
+ *  - CDK / Fortellis / PBS
+ *  - CDK vehicle details + make/model selection
+ *  - Payer list with discrepancy gating
+ *  - Submit: "{mode}-export-job"
+ * @param bodyshop
+ * @param socket
+ * @param job
+ * @param logsRef
+ * @param mode
+ * @returns {JSX.Element}
+ * @constructor
+ */
+export default function CdkLikePostForm({ bodyshop, socket, job, logsRef, mode }) {
+  const [form] = Form.useForm();
+  const { t } = useTranslation();
+  const [, /*unused*/ setTick] = useState(0); // handy if you need a forceUpdate later
+
+  const initialValues = useMemo(
+    () => ({
+      story: `${t("jobs.labels.dms.defaultstory", {
+        ro_number: job.ro_number,
+        ownr_nm: `${job.ownr_fn || ""} ${job.ownr_ln || ""} ${job.ownr_co_nm || ""}`.trim(),
+        ins_co_nm: job.ins_co_nm || "N/A",
+        clm_po: `${job.clm_no ? `${job.clm_no} ` : ""}${job.po_number || ""}`
+      }).trim()}.${
+        job.area_of_damage?.impact1
+          ? " " +
+            t("jobs.labels.dms.damageto", {
+              area_of_damage: (job.area_of_damage && job.area_of_damage.impact1.padStart(2, "0")) || "UNKNOWN"
+            })
+          : ""
+      }`.slice(0, 239),
+      inservicedate: dayjs(
+        `${
+          (job.v_model_yr &&
+            (job.v_model_yr < 100
+              ? job.v_model_yr >= (dayjs().year() + 1) % 100
+                ? 1900 + parseInt(job.v_model_yr, 10)
+                : 2000 + parseInt(job.v_model_yr, 10)
+              : job.v_model_yr)) ||
+          2019
+        }-01-01`
+      ),
+      journal: bodyshop.cdk_configuration?.default_journal
+    }),
+    [job, bodyshop, t]
+  );
+
+  // Payers helpers
+  const handlePayerSelect = (value, index) => {
+    form.setFieldsValue({
+      payers: (form.getFieldValue("payers") || []).map((payer, mapIndex) => {
+        if (index !== mapIndex) return payer;
+        const cdkPayer =
+          bodyshop.cdk_configuration.payers && bodyshop.cdk_configuration.payers.find((i) => i.name === value);
+        if (!cdkPayer) return payer;
+        return {
+          ...cdkPayer,
+          dms_acctnumber: cdkPayer.dms_acctnumber,
+          controlnumber: job?.[cdkPayer.control_type]
+        };
+      })
+    });
+    setTick((n) => n + 1);
+  };
+
+  const handleFinish = (values) => {
+    if (!socket) return;
+
+    if (mode === DMS_MAP.fortellis) {
+      socket.emit("fortellis-export-job", {
+        jobid: job.id,
+        txEnvelope: { ...values, SubscriptionID: bodyshop.cdk_dealerid }
+      });
+    } else {
+      socket.emit(`${mode}-export-job`, { jobid: job.id, txEnvelope: values });
+    }
+
+    logsRef?.current?.scrollIntoView({ behavior: "smooth" });
+  };
+
+  // Totals & discrepancy
+  const totals = socket?.allocationsSummary
+    ? socket.allocationsSummary.reduce(
+        (acc, val) => ({
+          totalSale: acc.totalSale.add(Dinero(val.sale)),
+          totalCost: acc.totalCost.add(Dinero(val.cost))
+        }),
+        { totalSale: Dinero(), totalCost: Dinero() }
+      )
+    : { totalSale: Dinero(), totalCost: Dinero() };
+
+  return (
+    <Card title={t("jobs.labels.dms.postingform")}>
+      <Form
+        form={form}
+        layout="vertical"
+        onFinish={handleFinish}
+        style={{ width: "100%" }}
+        initialValues={initialValues}
+      >
+        {/* TOP ROW */}
+        <Row gutter={[16, 12]} align="bottom">
+          <Col xs={24} sm={12} md={8} lg={6}>
+            <Form.Item name="journal" label={t("jobs.fields.dms.journal")} rules={[{ required: true }]}>
+              <Input />
+            </Form.Item>
+          </Col>
+
+          <Col xs={12} sm={8} md={6} lg={4}>
+            <Form.Item name="kmin" label={t("jobs.fields.kmin")} initialValue={job?.kmin} rules={[{ required: true }]}>
+              <InputNumber style={{ width: "100%" }} disabled />
+            </Form.Item>
+          </Col>
+
+          <Col xs={12} sm={8} md={6} lg={4}>
+            <Form.Item
+              name="kmout"
+              label={t("jobs.fields.kmout")}
+              initialValue={job?.kmout}
+              rules={[{ required: true }]}
+            >
+              <InputNumber style={{ width: "100%" }} disabled />
+            </Form.Item>
+          </Col>
+        </Row>
+
+        {/* CDK vehicle details (kept for CDK/Fortellis paths when dealer id exists) */}
+        {bodyshop.cdk_dealerid && (
+          <>
+            <Row gutter={[16, 12]}>
+              <Col xs={24} sm={12} md={8}>
+                <Form.Item name="dms_make" label={t("jobs.fields.dms.dms_make")} rules={[{ required: true }]}>
+                  <Input disabled />
+                </Form.Item>
+              </Col>
+              <Col xs={24} sm={12} md={8}>
+                <Form.Item name="dms_model" label={t("jobs.fields.dms.dms_model")} rules={[{ required: true }]}>
+                  <Input disabled />
+                </Form.Item>
+              </Col>
+              <Col xs={24} sm={12} md={8}>
+                <Form.Item name="inservicedate" label={t("jobs.fields.dms.inservicedate")}>
+                  <DateTimePicker isDateOnly />
+                </Form.Item>
+              </Col>
+            </Row>
+
+            <Row gutter={[16, 12]} align="middle">
+              <Col>
+                <DmsCdkMakes form={form} job={job} />
+              </Col>
+              <Col>
+                <DmsCdkMakesRefetch />
+              </Col>
+              <Col>
+                <Form.Item name="dms_unsold" label={t("jobs.fields.dms.dms_unsold")} initialValue={false}>
+                  <Switch />
+                </Form.Item>
+              </Col>
+              <Col>
+                <Form.Item
+                  name="dms_model_override"
+                  label={t("jobs.fields.dms.dms_model_override")}
+                  initialValue={false}
+                >
+                  <Switch />
+                </Form.Item>
+              </Col>
+            </Row>
+          </>
+        )}
+
+        <Row gutter={[16, 12]}>
+          <Col span={24}>
+            <Form.Item name="story" label={t("jobs.fields.dms.story")} rules={[{ required: true }]}>
+              <Input.TextArea maxLength={240} />
+            </Form.Item>
+          </Col>
+        </Row>
+
+        <Divider />
+
+        {/* Totals */}
+        <Space size="large" wrap align="center" style={{ marginBottom: 16 }}>
+          <Statistic
+            title={t("jobs.fields.ded_amt")}
+            value={Dinero(job.job_totals.totals.custPayable.deductible).toFormat()}
+          />
+          <Statistic
+            title={t("jobs.labels.total_cust_payable")}
+            value={Dinero(job.job_totals.totals.custPayable.total).toFormat()}
+          />
+          <Statistic
+            title={t("jobs.labels.net_repairs")}
+            value={Dinero(job.job_totals.totals.net_repairs).toFormat()}
+          />
+        </Space>
+
+        {/* Payers list */}
+        <Divider />
+        <Form.List name={["payers"]}>
+          {(fields, { add, remove }) => (
+            <div>
+              {fields.map((field, index) => (
+                <Card
+                  key={field.key}
+                  size="small"
+                  style={{ marginBottom: 12 }}
+                  title={`${t("jobs.fields.dms.payer.payer_type")} #${index + 1}`}
+                  extra={
+                    <Tooltip title={t("general.actions.remove", "Remove")}>
+                      <Button
+                        type="text"
+                        danger
+                        icon={<DeleteFilled />}
+                        aria-label={t("general.actions.remove", "Remove")}
+                        onClick={() => remove(field.name)}
+                      />
+                    </Tooltip>
+                  }
+                >
+                  <Row gutter={[16, 8]} align="middle">
+                    <Col xs={24} sm={12} md={8} lg={6}>
+                      <Form.Item
+                        label={t("jobs.fields.dms.payer.name")}
+                        name={[field.name, "name"]}
+                        rules={[{ required: true }]}
+                      >
+                        <Select style={{ minWidth: "15rem" }} onSelect={(value) => handlePayerSelect(value, index)}>
+                          {bodyshop.cdk_configuration?.payers?.map((payer) => (
+                            <Select.Option key={payer.name}>{payer.name}</Select.Option>
+                          ))}
+                        </Select>
+                      </Form.Item>
+                    </Col>
+
+                    <Col xs={24} sm={12} md={8} lg={6}>
+                      <Form.Item
+                        label={t("jobs.fields.dms.payer.dms_acctnumber")}
+                        name={[field.name, "dms_acctnumber"]}
+                        rules={[{ required: true }]}
+                      >
+                        <Input disabled />
+                      </Form.Item>
+                    </Col>
+
+                    <Col xs={24} sm={12} md={8} lg={5}>
+                      <Form.Item
+                        label={t("jobs.fields.dms.payer.amount")}
+                        name={[field.name, "amount"]}
+                        rules={[{ required: true }]}
+                      >
+                        <CurrencyInput min={0} />
+                      </Form.Item>
+                    </Col>
+
+                    <Col xs={24} sm={12} md={10} lg={7}>
+                      <Form.Item
+                        label={
+                          <div>
+                            {t("jobs.fields.dms.payer.controlnumber")}{" "}
+                            <Dropdown
+                              trigger={["click"]}
+                              menu={{
+                                items:
+                                  bodyshop.cdk_configuration.controllist?.map((key, idx) => ({
+                                    key: idx,
+                                    label: key.name,
+                                    onClick: () => {
+                                      form.setFieldsValue({
+                                        payers: (form.getFieldValue("payers") || []).map((row, mapIndex) => {
+                                          if (index !== mapIndex) return row;
+                                          return { ...row, controlnumber: key.controlnumber };
+                                        })
+                                      });
+                                    }
+                                  })) ?? []
+                              }}
+                            >
+                              <a href="#" onClick={(e) => e.preventDefault()}>
+                                <DownOutlined />
+                              </a>
+                            </Dropdown>
+                          </div>
+                        }
+                        name={[field.name, "controlnumber"]}
+                        rules={[{ required: true }]}
+                      >
+                        <Input />
+                      </Form.Item>
+                    </Col>
+
+                    <Col xs={24}>
+                      <Form.Item shouldUpdate noStyle>
+                        {() => {
+                          const payers = form.getFieldValue("payers");
+                          const row = payers?.[index];
+                          const cdkPayer =
+                            bodyshop.cdk_configuration.payers &&
+                            bodyshop.cdk_configuration.payers.find((i) => i && row && i.name === row.name);
+                          if (i18n.exists(`jobs.fields.${cdkPayer?.control_type}`))
+                            return <div>{cdkPayer && t(`jobs.fields.${cdkPayer?.control_type}`)}</div>;
+                          else if (i18n.exists(`jobs.fields.dms.control_type.${cdkPayer?.control_type}`)) {
+                            return <div>{cdkPayer && t(`jobs.fields.dms.control_type.${cdkPayer?.control_type}`)}</div>;
+                          } else {
+                            return null;
+                          }
+                        }}
+                      </Form.Item>
+                    </Col>
+                  </Row>
+                </Card>
+              ))}
+              <Form.Item>
+                <Button
+                  disabled={!(fields.length < 3)}
+                  onClick={() => {
+                    if (fields.length < 3) add();
+                  }}
+                  style={{ width: "100%" }}
+                >
+                  {t("jobs.actions.dms.addpayer")}
+                </Button>
+              </Form.Item>
+            </div>
+          )}
+        </Form.List>
+
+        {/* Validation gates & summary */}
+        <Form.Item shouldUpdate>
+          {() => {
+            let totalAllocated = Dinero();
+            const payers = form.getFieldValue("payers") || [];
+            payers.forEach((payer) => {
+              totalAllocated = totalAllocated.add(Dinero({ amount: Math.round((payer?.amount || 0) * 100) }));
+            });
+
+            const discrep = totals ? totals.totalSale.subtract(totalAllocated) : Dinero();
+
+            // gate: must have payers filled + zero discrepancy when we have a summary
+            const payersOk =
+              payers.length > 0 &&
+              payers.every((p) => p?.name && p.dms_acctnumber && (p.amount ?? "") !== "" && p.controlnumber);
+            const nonRrDiscrepancyGate = socket?.allocationsSummary ? discrep.getAmount() !== 0 : true;
+            const disablePost = !payersOk || nonRrDiscrepancyGate;
+
+            return (
+              <Space size="large" wrap align="center">
+                <Statistic
+                  title={t("jobs.labels.subtotal")}
+                  value={(totals ? totals.totalSale : Dinero()).toFormat()}
+                />
+                <Typography.Title>-</Typography.Title>
+                <Statistic title={t("jobs.labels.dms.totalallocated")} value={totalAllocated.toFormat()} />
+                <Typography.Title>=</Typography.Title>
+                <Statistic
+                  title={t("jobs.labels.dms.notallocated")}
+                  valueStyle={{ color: discrep.getAmount() === 0 ? "green" : "red" }}
+                  value={discrep.toFormat()}
+                />
+                <Button disabled={disablePost} htmlType="submit">
+                  {t("jobs.actions.dms.post")}
+                </Button>
+              </Space>
+            );
+          }}
+        </Form.Item>
+      </Form>
+    </Card>
+  );
+}

client/src/components/dms-post-form/dms-post-form.component.jsx

@@ -1,396 +1,40 @@
-import { DeleteFilled, DownOutlined } from "@ant-design/icons";
-import {
-  Button,
-  Card,
-  Divider,
-  Dropdown,
-  Form,
-  Input,
-  InputNumber,
-  Select,
-  Space,
-  Statistic,
-  Switch,
-  Typography
-} from "antd";
-import Dinero from "dinero.js";
-import { useTranslation } from "react-i18next";
 import { connect } from "react-redux";
 import { createStructuredSelector } from "reselect";
-import { determineDmsType } from "../../pages/dms/dms.container";
 import { selectBodyshop } from "../../redux/user/user.selectors";
-import i18n from "../../translations/i18n";
+import { DMS_MAP } from "../../utils/dmsUtils";
-import dayjs from "../../utils/day";
+import RRPostForm from "./rr-dms-post-form";
-import DmsCdkMakes from "../dms-cdk-makes/dms-cdk-makes.component";
+import CdkLikePostForm from "./cdklike-dms-post-form";
-import DmsCdkMakesRefetch from "../dms-cdk-makes/dms-cdk-makes.refetch.component";
-import DateTimePicker from "../form-date-time-picker/form-date-time-picker.component.jsx";
-import CurrencyInput from "../form-items-formatted/currency-form-item.component";
-import LayoutFormRow from "../layout-form-row/layout-form-row.component";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop
 });
-const mapDispatchToProps = () => ({
+const mapDispatchToProps = () => ({});
-  //setUserLanguage: language => dispatch(setUserLanguage(language))
+
-});
 export default connect(mapStateToProps, mapDispatchToProps)(DmsPostForm);
 
-export function DmsPostForm({ bodyshop, socket, job, logsRef }) {
+/**
-  const [form] = Form.useForm();
+ * DMS Post Form component that renders the appropriate post form
-  const { t } = useTranslation();
+ * @param mode
+ * @param bodyshop
+ * @param socket
+ * @param job
+ * @param logsRef
+ * @returns {JSX.Element|null}
+ * @constructor
+ */
+export function DmsPostForm({ mode, bodyshop, socket, job, logsRef }) {
+  switch (mode) {
+    case DMS_MAP.reynolds:
+      return <RRPostForm bodyshop={bodyshop} socket={socket} job={job} logsRef={logsRef} />;
 
-  const handlePayerSelect = (value, index) => {
+    // CDK (legacy /ws), Fortellis (CDK-over-WSS), and PBS share the same UI;
-    form.setFieldsValue({
+    // we pass mode down so the child can choose the correct event name.
-      payers: form.getFieldValue("payers").map((payer, mapIndex) => {
+    case DMS_MAP.fortellis:
-        if (index !== mapIndex) return payer;
+    case DMS_MAP.cdk:
-        const cdkPayer =
+    case DMS_MAP.pbs:
-          bodyshop.cdk_configuration.payers && bodyshop.cdk_configuration.payers.find((i) => i.name === value);
+      return <CdkLikePostForm mode={mode} bodyshop={bodyshop} socket={socket} job={job} logsRef={logsRef} />;
 
-        if (!cdkPayer) return payer;
+    default:
-
+      return null;
-        return {
+  }
-          ...cdkPayer,
-          dms_acctnumber: cdkPayer.dms_acctnumber,
-          controlnumber: job && job[cdkPayer.control_type]
-        };
-      })
-    });
-  };
-
-  const handleFinish = (values) => {
-    socket.emit(`${determineDmsType(bodyshop)}-export-job`, {
-      jobid: job.id,
-      txEnvelope: values
-    });
-    console.log(logsRef);
-    if (logsRef) {
-      console.log("executing", logsRef);
-      logsRef.curent &&
-        logsRef.current.scrollIntoView({
-          behavior: "smooth"
-        });
-    }
-  };
-
-  return (
-    <Card title={t("jobs.labels.dms.postingform")}>
-      <Form
-        form={form}
-        layout="vertical"
-        onFinish={handleFinish}
-        initialValues={{
-          story: `${t("jobs.labels.dms.defaultstory", {
-            ro_number: job.ro_number,
-            ownr_nm: `${job.ownr_fn || ""} ${job.ownr_ln || ""} ${job.ownr_co_nm || ""}`.trim(),
-            ins_co_nm: job.ins_co_nm || "N/A",
-            clm_po: `${job.clm_no ? `${job.clm_no} ` : ""}${job.po_number || ""}`
-          }).trim()}.${
-            job.area_of_damage && job.area_of_damage.impact1
-              ? " " +
-                t("jobs.labels.dms.damageto", {
-                  area_of_damage: (job.area_of_damage && job.area_of_damage.impact1.padStart(2, "0")) || "UNKNOWN"
-                })
-              : ""
-          }`.slice(0, 239),
-          inservicedate: dayjs(
-            `${(job.v_model_yr && (job.v_model_yr < 100 ? (job.v_model_yr >= (dayjs().year() + 1) % 100 ? 1900 + parseInt(job.v_model_yr) : 2000 + parseInt(job.v_model_yr)) : job.v_model_yr)) || 2019}-01-01`
-          )
-        }}
-      >
-        <LayoutFormRow grow>
-          <Form.Item
-            name="journal"
-            label={t("jobs.fields.dms.journal")}
-            initialValue={bodyshop.cdk_configuration && bodyshop.cdk_configuration.default_journal}
-            rules={[
-              {
-                required: true
-                //message: t("general.validation.required"),
-              }
-            ]}
-          >
-            <Input />
-          </Form.Item>
-          <Form.Item
-            name="kmin"
-            label={t("jobs.fields.kmin")}
-            initialValue={job && job.kmin}
-            rules={[
-              {
-                required: true
-                //message: t("general.validation.required"),
-              }
-            ]}
-          >
-            <InputNumber disabled />
-          </Form.Item>
-          <Form.Item
-            name="kmout"
-            label={t("jobs.fields.kmout")}
-            initialValue={job && job.kmout}
-            rules={[
-              {
-                required: true
-                //message: t("general.validation.required"),
-              }
-            ]}
-          >
-            <InputNumber disabled />
-          </Form.Item>
-        </LayoutFormRow>
-
-        {bodyshop.cdk_dealerid && (
-          <div>
-            <LayoutFormRow style={{ justifyContent: "center" }} grow>
-              <Form.Item
-                name="dms_make"
-                label={t("jobs.fields.dms.dms_make")}
-                rules={[
-                  {
-                    required: true
-                  }
-                ]}
-              >
-                <Input disabled />
-              </Form.Item>
-              <Form.Item
-                name="dms_model"
-                label={t("jobs.fields.dms.dms_model")}
-                rules={[
-                  {
-                    required: true
-                  }
-                ]}
-              >
-                <Input disabled />
-              </Form.Item>
-              <Form.Item name="inservicedate" label={t("jobs.fields.dms.inservicedate")}>
-                <DateTimePicker isDateOnly />
-              </Form.Item>
-            </LayoutFormRow>
-            <Space>
-              <DmsCdkMakes form={form} socket={socket} job={job} />
-              <DmsCdkMakesRefetch />
-              <Form.Item name="dms_unsold" label={t("jobs.fields.dms.dms_unsold")} initialValue={false}>
-                <Switch />
-              </Form.Item>
-              <Form.Item name="dms_model_override" label={t("jobs.fields.dms.dms_model_override")} initialValue={false}>
-                <Switch />
-              </Form.Item>
-            </Space>
-          </div>
-        )}
-        <Form.Item
-          name="story"
-          label={t("jobs.fields.dms.story")}
-          rules={[
-            {
-              required: true
-            }
-          ]}
-        >
-          <Input.TextArea maxLength={240} />
-        </Form.Item>
-
-        <Divider />
-        <Space size="large" wrap align="center">
-          <Statistic
-            title={t("jobs.fields.ded_amt")}
-            value={Dinero(job.job_totals.totals.custPayable.deductible).toFormat()}
-          />
-          <Statistic
-            title={t("jobs.labels.total_cust_payable")}
-            value={Dinero(job.job_totals.totals.custPayable.total).toFormat()}
-          />
-          <Statistic
-            title={t("jobs.labels.net_repairs")}
-            value={Dinero(job.job_totals.totals.net_repairs).toFormat()}
-          />
-        </Space>
-        <Form.List name={["payers"]}>
-          {(fields, { add, remove }) => {
-            return (
-              <div>
-                {fields.map((field, index) => (
-                  <Form.Item key={field.key}>
-                    <Space wrap>
-                      <Form.Item
-                        label={t("jobs.fields.dms.payer.name")}
-                        key={`${index}name`}
-                        name={[field.name, "name"]}
-                        rules={[
-                          {
-                            required: true
-                          }
-                        ]}
-                      >
-                        <Select style={{ minWidth: "15rem" }} onSelect={(value) => handlePayerSelect(value, index)}>
-                          {bodyshop.cdk_configuration &&
-                            bodyshop.cdk_configuration.payers &&
-                            bodyshop.cdk_configuration.payers.map((payer) => (
-                              <Select.Option key={payer.name}>{payer.name}</Select.Option>
-                            ))}
-                        </Select>
-                      </Form.Item>
-
-                      <Form.Item
-                        label={t("jobs.fields.dms.payer.dms_acctnumber")}
-                        key={`${index}dms_acctnumber`}
-                        name={[field.name, "dms_acctnumber"]}
-                        rules={[
-                          {
-                            required: true
-                          }
-                        ]}
-                      >
-                        <Input disabled />
-                      </Form.Item>
-
-                      <Form.Item
-                        label={t("jobs.fields.dms.payer.amount")}
-                        key={`${index}amount`}
-                        name={[field.name, "amount"]}
-                        rules={[
-                          {
-                            required: true
-                          }
-                        ]}
-                      >
-                        <CurrencyInput min={0} />
-                      </Form.Item>
-
-                      <Form.Item
-                        label={
-                          <div>
-                            {t("jobs.fields.dms.payer.controlnumber")}{" "}
-                            <Dropdown
-                              menu={{
-                                items: bodyshop.cdk_configuration.controllist?.map((key, idx) => ({
-                                  key: idx,
-                                  label: key.name,
-                                  onClick: () => {
-                                    form.setFieldsValue({
-                                      payers: form.getFieldValue("payers").map((row, mapIndex) => {
-                                        if (index !== mapIndex) return row;
-                                        return {
-                                          ...row,
-                                          controlnumber: key.controlnumber
-                                        };
-                                      })
-                                    });
-                                  }
-                                }))
-                              }}
-                            >
-                              <a href=" #" onClick={(e) => e.preventDefault()}>
-                                <DownOutlined />
-                              </a>
-                            </Dropdown>
-                          </div>
-                        }
-                        key={`${index}controlnumber`}
-                        name={[field.name, "controlnumber"]}
-                        rules={[
-                          {
-                            required: true
-                          }
-                        ]}
-                      >
-                        <Input />
-                      </Form.Item>
-
-                      <Form.Item shouldUpdate>
-                        {() => {
-                          const payers = form.getFieldValue("payers");
-
-                          const row = payers && payers[index];
-
-                          const cdkPayer =
-                            bodyshop.cdk_configuration.payers &&
-                            bodyshop.cdk_configuration.payers.find((i) => i && row && i.name === row.name);
-                          if (i18n.exists(`jobs.fields.${cdkPayer?.control_type}`))
-                            return <div>{cdkPayer && t(`jobs.fields.${cdkPayer?.control_type}`)}</div>;
-                          else if (i18n.exists(`jobs.fields.dms.control_type.${cdkPayer?.control_type}`)) {
-                            return <div>{cdkPayer && t(`jobs.fields.dms.control_type.${cdkPayer?.control_type}`)}</div>;
-                          } else {
-                            return null;
-                          }
-                        }}
-                      </Form.Item>
-
-                      <DeleteFilled
-                        onClick={() => {
-                          remove(field.name);
-                        }}
-                      />
-                    </Space>
-                  </Form.Item>
-                ))}
-                <Form.Item>
-                  <Button
-                    disabled={!(fields.length < 3)}
-                    onClick={() => {
-                      if (fields.length < 3) add();
-                    }}
-                    style={{ width: "100%" }}
-                  >
-                    {t("jobs.actions.dms.addpayer")}
-                  </Button>
-                </Form.Item>
-              </div>
-            );
-          }}
-        </Form.List>
-        <Form.Item shouldUpdate>
-          {() => {
-            //Perform Calculation to determine discrepancy.
-            let totalAllocated = Dinero();
-
-            const payers = form.getFieldValue("payers");
-            payers &&
-              payers.forEach((payer) => {
-                totalAllocated = totalAllocated.add(Dinero({ amount: Math.round((payer?.amount || 0) * 100) }));
-              });
-
-            const totals =
-              socket.allocationsSummary &&
-              socket.allocationsSummary.reduce(
-                (acc, val) => {
-                  return {
-                    totalSale: acc.totalSale.add(Dinero(val.sale)),
-                    totalCost: acc.totalCost.add(Dinero(val.cost))
-                  };
-                },
-                {
-                  totalSale: Dinero(),
-                  totalCost: Dinero()
-                }
-              );
-            const discrep = totals ? totals.totalSale.subtract(totalAllocated) : Dinero();
-            return (
-              <Space size="large" wrap align="center">
-                <Statistic
-                  title={t("jobs.labels.subtotal")}
-                  value={(totals ? totals.totalSale : Dinero()).toFormat()}
-                />
-                <Typography.Title>-</Typography.Title>
-                <Statistic title={t("jobs.labels.dms.totalallocated")} value={totalAllocated.toFormat()} />
-                <Typography.Title>=</Typography.Title>
-                <Statistic
-                  title={t("jobs.labels.dms.notallocated")}
-                  valueStyle={{
-                    color: discrep.getAmount() === 0 ? "green" : "red"
-                  }}
-                  value={discrep.toFormat()}
-                />
-                <Button disabled={!socket.allocationsSummary || discrep.getAmount() !== 0} htmlType="submit">
-                  {t("jobs.actions.dms.post")}
-                </Button>
-              </Space>
-            );
-          }}
-        </Form.Item>
-      </Form>
-    </Card>
-  );
 }

client/src/components/dms-post-form/rr-dms-post-form.jsx

@@ -0,0 +1,242 @@
+import { ReloadOutlined } from "@ant-design/icons";
+import {
+  Button,
+  Card,
+  Col,
+  Divider,
+  Form,
+  Input,
+  InputNumber,
+  Row,
+  Select,
+  Space,
+  Statistic,
+  Tooltip,
+  Typography
+} from "antd";
+import Dinero from "dinero.js";
+import { useTranslation } from "react-i18next";
+import { useEffect, useMemo, useState } from "react";
+import dayjs from "../../utils/day";
+
+/**
+ * RR DMS Post Form component
+ * Submit: "rr-export-job"
+ * @param bodyshop
+ * @param socket
+ * @param job
+ * @param logsRef
+ * @returns {JSX.Element}
+ * @constructor
+ */
+export default function RRPostForm({ bodyshop, socket, job, logsRef }) {
+  const [form] = Form.useForm();
+  const { t } = useTranslation();
+
+  // Advisors
+  const [advisors, setAdvisors] = useState([]);
+  const [advLoading, setAdvLoading] = useState(false);
+
+  const getAdvisorNumber = (a) => a?.advisorId;
+
+  const getAdvisorLabel = (a) => `${a?.firstName || ""} ${a?.lastName || ""}`.trim();
+
+  const fetchRrAdvisors = (refresh = false) => {
+    if (!socket) return;
+    setAdvLoading(true);
+
+    const onResult = (payload) => {
+      try {
+        const list = payload?.result ?? payload ?? [];
+        setAdvisors(Array.isArray(list) ? list : []);
+      } finally {
+        setAdvLoading(false);
+        socket.off("rr-get-advisors:result", onResult);
+      }
+    };
+
+    socket.once("rr-get-advisors:result", onResult);
+    socket.emit("rr-get-advisors", { departmentType: "B", refresh }, (ack) => {
+      if (ack?.ok) {
+        const list = ack.result ?? [];
+        setAdvisors(Array.isArray(list) ? list : []);
+      } else if (ack) {
+        console.error("Something went wrong fetching DMS Advisors");
+      }
+      setAdvLoading(false);
+      socket.off("rr-get-advisors:result", onResult);
+    });
+  };
+
+  useEffect(() => {
+    fetchRrAdvisors(false);
+  }, [bodyshop?.id, socket]);
+
+  const initialValues = useMemo(
+    () => ({
+      story: `${t("jobs.labels.dms.defaultstory", {
+        ro_number: job.ro_number,
+        ownr_nm: `${job.ownr_fn || ""} ${job.ownr_ln || ""} ${job.ownr_co_nm || ""}`.trim(),
+        ins_co_nm: job.ins_co_nm || "N/A",
+        clm_po: `${job.clm_no ? `${job.clm_no} ` : ""}${job.po_number || ""}`
+      }).trim()}.${
+        job.area_of_damage?.impact1
+          ? " " +
+            t("jobs.labels.dms.damageto", {
+              area_of_damage: (job.area_of_damage && job.area_of_damage.impact1.padStart(2, "0")) || "UNKNOWN"
+            })
+          : ""
+      }`.slice(0, 239),
+      inservicedate: dayjs(
+        `${
+          (job.v_model_yr &&
+            (job.v_model_yr < 100
+              ? job.v_model_yr >= (dayjs().year() + 1) % 100
+                ? 1900 + parseInt(job.v_model_yr, 10)
+                : 2000 + parseInt(job.v_model_yr, 10)
+              : job.v_model_yr)) ||
+          2019
+        }-01-01`
+      )
+    }),
+    [job, t]
+  );
+
+  const handleFinish = (values) => {
+    if (!socket) return;
+    socket.emit("rr-export-job", {
+      bodyshopId: bodyshop?.id,
+      jobId: job.id,
+      job,
+      txEnvelope: values
+    });
+    logsRef?.current?.scrollIntoView({ behavior: "smooth" });
+  };
+
+  // Discrepancy is ignored for RR; we still show totals for operator context
+  const totals = socket?.allocationsSummary
+    ? socket.allocationsSummary.reduce(
+        (acc, val) => ({
+          totalSale: acc.totalSale.add(Dinero(val.sale)),
+          totalCost: acc.totalCost.add(Dinero(val.cost))
+        }),
+        { totalSale: Dinero(), totalCost: Dinero() }
+      )
+    : { totalSale: Dinero(), totalCost: Dinero() };
+
+  return (
+    <Card title={t("jobs.labels.dms.postingform")}>
+      <Form
+        form={form}
+        layout="vertical"
+        onFinish={handleFinish}
+        style={{ width: "100%" }}
+        initialValues={initialValues}
+      >
+        <Row gutter={[16, 12]} align="bottom">
+          {/* Advisor + inline Refresh */}
+          <Col xs={24} sm={24} md={12} lg={8}>
+            <Form.Item label={t("jobs.fields.dms.advisor")} required>
+              <Space.Compact block>
+                <Form.Item
+                  name="advisorNo"
+                  noStyle
+                  rules={[{ required: true, message: t("general.validation.required") }]}
+                >
+                  <Select
+                    style={{ flex: 1 }}
+                    loading={advLoading}
+                    allowClear
+                    placeholder={t("general.actions.select", "Select...")}
+                    popupMatchSelectWidth
+                    options={advisors
+                      .map((a) => {
+                        const value = getAdvisorNumber(a);
+                        if (value == null) return null;
+                        return { value: String(value), label: getAdvisorLabel(a) || String(value) };
+                      })
+                      .filter(Boolean)}
+                    notFoundContent={advLoading ? t("general.labels.loading") : t("general.labels.none")}
+                  />
+                </Form.Item>
+                <Tooltip title={t("general.actions.refresh")}>
+                  <Button
+                    aria-label={t("general.actions.refresh")}
+                    icon={<ReloadOutlined />}
+                    onClick={() => fetchRrAdvisors(true)}
+                    loading={advLoading}
+                  />
+                </Tooltip>
+              </Space.Compact>
+            </Form.Item>
+          </Col>
+
+          {/* Make Override */}
+          <Col xs={24} sm={12} md={12} lg={8}>
+            <Form.Item name="makeOverride" label={t("jobs.fields.dms.make_override")}>
+              <Input allowClear placeholder={t("general.actions.optional")} />
+            </Form.Item>
+          </Col>
+
+          <Col xs={12} sm={8} md={6} lg={4}>
+            <Form.Item name="kmin" label={t("jobs.fields.kmin")} initialValue={job?.kmin} rules={[{ required: true }]}>
+              <InputNumber style={{ width: "100%" }} disabled />
+            </Form.Item>
+          </Col>
+
+          <Col xs={12} sm={8} md={6} lg={4}>
+            <Form.Item
+              name="kmout"
+              label={t("jobs.fields.kmout")}
+              initialValue={job?.kmout}
+              rules={[{ required: true }]}
+            >
+              <InputNumber style={{ width: "100%" }} disabled />
+            </Form.Item>
+          </Col>
+        </Row>
+
+        <Row gutter={[16, 12]}>
+          <Col span={24}>
+            <Form.Item name="story" label={t("jobs.fields.dms.story")} rules={[{ required: true }]}>
+              <Input.TextArea maxLength={240} />
+            </Form.Item>
+          </Col>
+        </Row>
+
+        <Divider />
+
+        <Space size="large" wrap align="center" style={{ marginBottom: 16 }}>
+          <Statistic
+            title={t("jobs.fields.ded_amt")}
+            value={Dinero(job.job_totals.totals.custPayable.deductible).toFormat()}
+          />
+          <Statistic
+            title={t("jobs.labels.total_cust_payable")}
+            value={Dinero(job.job_totals.totals.custPayable.total).toFormat()}
+          />
+          <Statistic
+            title={t("jobs.labels.net_repairs")}
+            value={Dinero(job.job_totals.totals.net_repairs).toFormat()}
+          />
+        </Space>
+
+        {/* Validation  */}
+        <Form.Item shouldUpdate>
+          {() => {
+            const advisorOk = !!form.getFieldValue("advisorNo");
+            return (
+              <Space size="large" wrap align="center">
+                <Statistic title={t("jobs.labels.subtotal")} value={totals.totalSale.toFormat()} />
+                <Typography.Title>=</Typography.Title>
+                <Button disabled={!advisorOk} htmlType="submit">
+                  {t("jobs.actions.dms.post")}
+                </Button>
+              </Space>
+            );
+          }}
+        </Form.Item>
+      </Form>
+    </Card>
+  );
+}

client/src/components/header/buildAccountingChildren.jsx

@@ -141,7 +141,7 @@ const buildAccountingChildren = ({
           </Link>
         )
       },
-      ...(!((bodyshop && bodyshop.cdk_dealerid) || (bodyshop && bodyshop.pbs_serialnumber)) || DmsAp.treatment === "on"
+      ...(!(bodyshop?.cdk_dealerid || bodyshop?.pbs_serialnumber || bodyshop?.rr_dealerid) || DmsAp.treatment === "on"
         ? [
             {
               key: "payables",
@@ -156,7 +156,7 @@ const buildAccountingChildren = ({
             }
           ]
         : []),
-      ...(!((bodyshop && bodyshop.cdk_dealerid) || (bodyshop && bodyshop.pbs_serialnumber))
+      ...(!(bodyshop?.cdk_dealerid || bodyshop?.pbs_serialnumber || bodyshop?.rr_dealerid) || DmsAp.treatment === "on"
         ? [
             {
               key: "payments",

client/src/components/jobs-close-auto-allocate/jobs-close-auto-allocate.component.jsx

@@ -6,6 +6,7 @@ import { createStructuredSelector } from "reselect";
 import { logImEXEvent } from "../../firebase/firebase.utils";
 import { selectBodyshop } from "../../redux/user/user.selectors";
 import InstanceRenderManager from "../../utils/instanceRenderMgr";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop
@@ -14,6 +15,8 @@ const mapStateToProps = createStructuredSelector({
 export function JobsCloseAutoAllocate({ bodyshop, joblines, form, disabled }) {
   const { t } = useTranslation();
 
+  const hasDmsKey = bodyshopHasDmsKey(bodyshop);
+
   const handleAllocate = (defaults) => {
     form.setFieldsValue({
       joblines: joblines.map((jl) => {
@@ -64,21 +67,20 @@ export function JobsCloseAutoAllocate({ bodyshop, joblines, form, disabled }) {
     handleAllocate(bodyshop.md_responsibility_centers.dms_defaults.find((x) => x.name === key));
   };
 
-  const menu =
+  const menu = hasDmsKey
-    bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber
+    ? {
-      ? {
+        items: bodyshop.md_responsibility_centers.dms_defaults.map((mapping) => ({
-          items: bodyshop.md_responsibility_centers.dms_defaults.map((mapping) => ({
+          key: mapping.name,
-            key: mapping.name,
+          label: mapping.name,
-            label: mapping.name,
+          disabled: disabled
-            disabled: disabled
+        })),
-          })),
+        onClick: handleMenuClick
-          onClick: handleMenuClick
+      }
-        }
+    : {
-      : {
+        items: []
-          items: []
+      };
-        };
 
-  return bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber ? (
+  return hasDmsKey ? (
     <Dropdown menu={menu}>
       <Button disabled={disabled}>{t("jobs.actions.dmsautoallocate")}</Button>
     </Dropdown>

client/src/components/jobs-close-export-button/jobs-close-export-button.component.jsx

@@ -10,6 +10,7 @@ import { auth, logImEXEvent } from "../../firebase/firebase.utils";
 import { INSERT_EXPORT_LOG } from "../../graphql/accounting.queries";
 import { UPDATE_JOB } from "../../graphql/jobs.queries";
 import { insertAuditTrail } from "../../redux/application/application.actions";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 import { selectBodyshop, selectCurrentUser } from "../../redux/user/user.selectors";
 import AuditTrailMapping from "../../utils/AuditTrailMappings";
 import client from "../../utils/GraphQLClient";
@@ -45,7 +46,7 @@ export function JobsCloseExportButton({ bodyshop, currentUser, jobId, disabled,
 
   const handleQbxml = async () => {
     //Check if it's a CDK setup.
-    if (bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber) {
+    if (bodyshopHasDmsKey(bodyshop)) {
       history(`/manage/dms?jobId=${jobId}`);
       return;
     }

client/src/components/jobs-detail-header/jobs-detail-header.component.jsx

@@ -29,6 +29,7 @@ import ProductionListColumnProductionNote from "../production-list-columns/produ
 import VehicleVinDisplay from "../vehicle-vin-display/vehicle-vin-display.component";
 import "./jobs-detail-header.styles.scss";
 import getPartsBasePath from "../../utils/getPartsBasePath.js";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   jobRO: selectJobReadOnly,
@@ -309,7 +310,7 @@ export function JobsDetailHeader({ job, bodyshop, disabled, insertAuditTrail, is
               </DataLabel>
               <DataLabel key="4" label={t("vehicles.fields.v_vin")}>
                 <VehicleVinDisplay>{`${job.v_vin || t("general.labels.na")}`}</VehicleVinDisplay>
-                {bodyshop.pbs_serialnumber || bodyshop.cdk_dealerid ? (
+                {bodyshopHasDmsKey(bodyshop) ? (
                   job.v_vin?.length !== 17 ? (
                     <WarningFilled style={{ color: "tomato", marginLeft: ".3rem" }} />
                   ) : null

client/src/components/labor-allocations-table/labor-allocations-table.utility.js

@@ -1,4 +1,5 @@
 import i18next from "i18next";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 export const CalculateAllocationsTotals = (bodyshop, joblines, timetickets, adjustments = []) => {
   const responsibilitycenters = bodyshop.md_responsibility_centers;
@@ -14,10 +15,9 @@ export const CalculateAllocationsTotals = (bodyshop, joblines, timetickets, adju
   const r = allCodes.reduce((acc, value) => {
     const r = {
       opcode: value,
-      cost_center:
+      cost_center: bodyshopHasDmsKey(bodyshop)
-        bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber
+        ? i18next.t(`joblines.fields.lbr_types.${value && value.toUpperCase()}`)
-          ? i18next.t(`joblines.fields.lbr_types.${value && value.toUpperCase()}`)
+        : responsibilitycenters.defaults.costs[value],
-          : responsibilitycenters.defaults.costs[value],
       mod_lbr_ty: value,
       total: joblines.reduce((acc2, val2) => {
         return val2.mod_lbr_ty === value ? acc2 + val2.mod_lb_hrs : acc2;

client/src/components/partner-ping/partner-ping.component.jsx

@@ -44,6 +44,7 @@ export async function checkPartnerStatus(bodyshop) {
     //     bodyshop &&
     //     (bodyshop.cdk_dealerid ||
     //       bodyshop.pbs_serialnumber ||
+    //       bodyshop.rr_dealerid ||
     //       bodyshop.accountingconfig.qbo)
     //   )
     // ) {

client/src/components/parts-order-list-table/parts-order-list-table-drawer.component.jsx

@@ -28,6 +28,7 @@ import PartsOrderDeleteLine from "../parts-order-delete-line/parts-order-delete-
 import PartsOrderLineBackorderButton from "../parts-order-line-backorder-button/parts-order-line-backorder-button.component";
 import PartsReceiveModalContainer from "../parts-receive-modal/parts-receive-modal.container";
 import PrintWrapper from "../print-wrapper/print-wrapper.component";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   jobRO: selectJobReadOnly,
@@ -196,7 +197,7 @@ export function PartsOrderListTableDrawerComponent({
                     quantity: pol.quantity,
                     actual_price: pol.act_price,
                     cost_center: pol.jobline?.part_type
-                      ? bodyshop.pbs_serialnumber || bodyshop.cdk_dealerid
+                      ? bodyshopHasDmsKey(bodyshop)
                         ? pol.jobline.part_type !== "PAE"
                           ? pol.jobline.part_type
                           : null

client/src/components/parts-order-list-table/parts-order-list-table.component.jsx

@@ -20,6 +20,7 @@ import PartsReceiveModalContainer from "../parts-receive-modal/parts-receive-mod
 import PrintWrapper from "../print-wrapper/print-wrapper.component";
 import PartsOrderDrawer from "./parts-order-list-table-drawer.component";
 import ShareToTeamsButton from "../share-to-teams/share-to-teams.component.jsx";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   jobRO: selectJobReadOnly,
@@ -69,6 +70,7 @@ export function PartsOrderListTableComponent({
 
   const parts_orders = billsQuery.data ? billsQuery.data.parts_orders : [];
   const { refetch } = billsQuery;
+
   const recordActions = (record, showView = false) => (
     <Space direction="horizontal" wrap>
       <ShareToTeamsButton
@@ -172,7 +174,7 @@ export function PartsOrderListTableComponent({
                       actual_price: pol.act_price,
 
                       cost_center: pol.jobline?.part_type
-                        ? bodyshop.pbs_serialnumber || bodyshop.cdk_dealerid
+                        ? bodyshopHasDmsKey(bodyshop)
                           ? pol.jobline.part_type !== "PAE"
                             ? pol.jobline.part_type
                             : null

client/src/components/shop-employees/shop-employees-form.component.jsx

@@ -331,7 +331,10 @@ export function ShopEmployeesFormComponent({ bodyshop }) {
                             {t("timetickets.labels.shift")}
                           </Select.Option>
 
-                          {bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber || Enhanced_Payroll.treatment === "on"
+                          {bodyshop.cdk_dealerid ||
+                          bodyshop.pbs_serialnumber ||
+                          bodyshop.rr_dealerid ||
+                          Enhanced_Payroll.treatment === "on"
                             ? CiecaSelect(false, true)
                             : bodyshop.md_responsibility_centers.costs.map((c) => (
                                 <Select.Option key={c.name} value={c.name}>

client/src/components/shop-info/shop-info.responsibilitycenters.taxes.component.jsx

@@ -5,6 +5,7 @@ import { createStructuredSelector } from "reselect";
 import { selectBodyshop } from "../../redux/user/user.selectors";
 import InstanceRenderManager from "../../utils/instanceRenderMgr";
 import LayoutFormRow from "../layout-form-row/layout-form-row.component";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   //currentUser: selectCurrentUser
@@ -2126,7 +2127,7 @@ function TaxFormItems({ typeNum, typeNumIterator, rootElements, bodyshop }) {
         >
           <Input />
         </Form.Item>
-        {(bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber) && (
+        {bodyshopHasDmsKey(bodyshop) && (
           <Form.Item
             label={t("bodyshop.fields.dms.dms_acctnumber")}
             rules={[

client/src/components/tech-job-clock-in-form/tech-job-clock-in-form.component.jsx

@@ -63,7 +63,10 @@ export function TechClockInComponent({ form, bodyshop, technician }) {
                 <Select.Option key={item.cost_center} value={item.cost_center}>
                   {item.cost_center === "timetickets.labels.shift"
                     ? t(item.cost_center)
-                    : bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber || Enhanced_Payroll.treatment === "on"
+                    : bodyshop.cdk_dealerid ||
+                        bodyshop.pbs_serialnumber ||
+                        bodyshop.rr_dealerid ||
+                        Enhanced_Payroll.treatment === "on"
                       ? t(`joblines.fields.lbr_types.${item.cost_center.toUpperCase()}`)
                       : item.cost_center}
                 </Select.Option>

client/src/components/tech-job-clock-in-form/tech-job-clock-in-form.container.jsx

@@ -75,7 +75,10 @@ export function TechClockInContainer({ setTimeTicketContext, technician, bodysho
             jobid: values.jobid,
             cost_center: values.cost_center,
             ciecacode:
-              bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber || Enhanced_Payroll.treatment === "on"
+              bodyshop.cdk_dealerid ||
+              bodyshop.pbs_serialnumber ||
+              bodyshop.rr_dealerid ||
+              Enhanced_Payroll.treatment === "on"
                 ? values.cost_center
                 : Object.keys(bodyshop.md_responsibility_centers.defaults.costs).find((key) => {
                     return bodyshop.md_responsibility_centers.defaults.costs[key] === values.cost_center;

client/src/components/tech-job-clock-out-button/tech-job-clock-out-button.component.jsx

@@ -16,6 +16,7 @@ import TechJobClockoutDelete from "../tech-job-clock-out-delete/tech-job-clock-o
 import { LaborAllocationContainer } from "../time-ticket-modal/time-ticket-modal.component";
 import { useSplitTreatments } from "@splitsoftware/splitio-react";
 import { useNotification } from "../../contexts/Notifications/notificationContext.jsx";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop,
@@ -53,7 +54,9 @@ export function TechClockOffButton({
     nextFetchPolicy: "network-only"
   });
   const { t } = useTranslation();
-  const emps = bodyshop.employees.filter((e) => e.id === (technician && technician.id))[0];
+
+  const emps = bodyshop.employees.filter((e) => e.id === technician?.id)[0];
+  const hasDmsKey = bodyshopHasDmsKey(bodyshop);
 
   const handleFinish = async (values) => {
     logImEXEvent("tech_clock_out_job");
@@ -69,7 +72,10 @@ export function TechClockOffButton({
           rate: emps && emps.rates.filter((r) => r.cost_center === values.cost_center)[0]?.rate,
           flat_rate: emps && emps.flat_rate,
           ciecacode:
-            bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber || Enhanced_Payroll.treatment === "on"
+            bodyshop.cdk_dealerid ||
+            bodyshop.pbs_serialnumber ||
+            bodyshop.rr_dealerid ||
+            Enhanced_Payroll.treatment === "on"
               ? values.cost_center
               : Object.keys(bodyshop.md_responsibility_centers.defaults.costs).find((key) => {
                   return bodyshop.md_responsibility_centers.defaults.costs[key] === values.cost_center;
@@ -164,8 +170,7 @@ export function TechClockOffButton({
                             lineTicketData.jobs_by_pk.lbr_adjustments
                           );
 
-                          const fieldTypeToCheck =
+                          const fieldTypeToCheck = hasDmsKey ? "mod_lbr_ty" : "cost_center";
-                            bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber ? "mod_lbr_ty" : "cost_center";
 
                           const costCenterDiff =
                             Math.round(
@@ -205,7 +210,7 @@ export function TechClockOffButton({
                       <Select.Option key={item.cost_center}>
                         {item.cost_center === "timetickets.labels.shift"
                           ? t(item.cost_center)
-                          : bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber
+                          : hasDmsKey
                             ? t(`joblines.fields.lbr_types.${item.cost_center.toUpperCase()}`)
                             : item.cost_center}
                       </Select.Option>

client/src/components/time-ticket-modal/time-ticket-modal.component.jsx

@@ -14,6 +14,7 @@ import {
 import JobSearchSelect from "../job-search-select/job-search-select.component";
 import LaborAllocationsTable from "../labor-allocations-table/labor-allocations-table.component";
 import { CalculateAllocationsTotals } from "../labor-allocations-table/labor-allocations-table.utility";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 import LayoutFormRow from "../layout-form-row/layout-form-row.component";
 import LoadingSkeleton from "../loading-skeleton/loading-skeleton.component";
 import { HasRbacAccess } from "../rbac-wrapper/rbac-wrapper.component";
@@ -60,7 +61,10 @@ export function TimeTicketModalComponent({
             <Select.Option key={item.cost_center} value={item.cost_center}>
               {item.cost_center === "timetickets.labels.shift"
                 ? t(item.cost_center)
-                : bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber || Enhanced_Payroll.treatment === "on"
+                : bodyshop.cdk_dealerid ||
+                    bodyshop.pbs_serialnumber ||
+                    bodyshop.rr_dealerid ||
+                    Enhanced_Payroll.treatment === "on"
                   ? t(`joblines.fields.lbr_types.${item.cost_center.toUpperCase()}`)
                   : item.cost_center}
             </Select.Option>
@@ -124,7 +128,7 @@ export function TimeTicketModalComponent({
             onSelect={(value) => {
               const emps = employeeAutoCompleteOptions && employeeAutoCompleteOptions.filter((e) => e.id === value)[0];
 
-              form.setFieldsValue({ flat_rate: emps && emps.flat_rate });
+              form.setFieldsValue({ flat_rate: emps?.flat_rate });
             }}
           />
         </Form.Item>
@@ -186,8 +190,7 @@ export function TimeTicketModalComponent({
                         lineTicketData.jobs_by_pk.lbr_adjustments
                       );
 
-                      const fieldTypeToCheck =
+                      const fieldTypeToCheck = bodyshopHasDmsKey(bodyshop) ? "mod_lbr_ty" : "cost_center";
-                        bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber ? "mod_lbr_ty" : "cost_center";
 
                       const costCenterDiff =
                         Math.round(
@@ -261,7 +264,7 @@ export function TimeTicketModalComponent({
                     if (!value) return Promise.resolve();
                     if (!clockon && value) return Promise.reject(t("timetickets.validation.clockoffwithoutclockon"));
                     // TODO - Verify this exists
-                    if (value && value.isSameOrAfter && !value.isSameOrAfter(clockon))
+                    if (value?.isSameOrAfter && !value.isSameOrAfter(clockon))
                       return Promise.reject(t("timetickets.validation.clockoffmustbeafterclockon"));
 
                     return Promise.resolve();

client/src/components/time-ticket-modal/time-ticket-modal.container.jsx

@@ -137,7 +137,10 @@ export function TimeTicketModalContainer({ timeTicketModal, toggleModalVisible,
     if (!!changedFields.cost_center && !!EmployeeAutoCompleteData) {
       form.setFieldsValue({
         ciecacode:
-          bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber || Enhanced_Payroll.treatment === "on"
+          bodyshop.cdk_dealerid ||
+          bodyshop.pbs_serialnumber ||
+          bodyshop.rr_dealerid ||
+          Enhanced_Payroll.treatment === "on"
             ? changedFields.cost_center
             : Object.keys(bodyshop.md_responsibility_centers.defaults.costs).find(
                 (key) => bodyshop.md_responsibility_centers.defaults.costs[key] === changedFields.cost_center

client/src/contexts/SocketIO/socketProvider.jsx

@@ -149,7 +149,7 @@ const SocketProvider = ({ children, bodyshop, navigate, currentUser }) => {
 
   useEffect(() => {
     const initializeSocket = async (token) => {
-      if (!bodyshop || !bodyshop.id || socketRef.current) return;
+      if (!bodyshop?.id || socketRef.current) return;
 
       const endpoint = import.meta.env.PROD ? import.meta.env.VITE_APP_AXIOS_BASE_API_URL : "";
       const socketInstance = SocketIO(endpoint, {

client/src/graphql/bodyshop.queries.js

@@ -111,6 +111,7 @@ export const QUERY_BODYSHOP = gql`
       jc_hourly_rates
       md_jobline_presets
       cdk_dealerid
+      rr_dealerid
       features
       attach_pdf_to_email
       tt_allow_post_to_invoiced
@@ -123,6 +124,7 @@ export const QUERY_BODYSHOP = gql`
       md_email_cc
       timezone
       ss_configuration
+      rr_configuration
       md_from_emails
       last_name_first
       md_parts_order_comment
@@ -245,6 +247,7 @@ export const UPDATE_SHOP = gql`
         jc_hourly_rates
         md_jobline_presets
         cdk_dealerid
+        rr_dealerid
         attach_pdf_to_email
         tt_allow_post_to_invoiced
         cdk_configuration
@@ -256,6 +259,7 @@ export const UPDATE_SHOP = gql`
         md_email_cc
         timezone
         ss_configuration
+        rr_configuration
         md_from_emails
         last_name_first
         md_parts_order_comment

client/src/graphql/jobs.queries.js

@@ -714,7 +714,7 @@ export const GET_JOB_BY_PK = gql`
       v_model_yr
       v_model_desc
       v_vin
-      notes(where:{pinned: {_eq: true}}, order_by: {updated_at: desc}) {
+      notes(where: { pinned: { _eq: true } }, order_by: { updated_at: desc }) {
         created_at
         created_by
         critical
@@ -1000,7 +1000,6 @@ export const QUERY_JOB_CARD_DETAILS = gql`
         key
         type
       }
-
     }
   }
 `;
@@ -2172,6 +2171,8 @@ export const QUERY_JOB_EXPORT_DMS = gql`
       ownr_fn
       ownr_ln
       ownr_co_nm
+      ownr_ph1
+      ownr_ph2
       ins_co_nm
       kmin
       kmout
@@ -2180,6 +2181,10 @@ export const QUERY_JOB_EXPORT_DMS = gql`
       v_model_desc
       area_of_damage
       date_exported
+      v_vin
+      plate_no
+      plate_st
+      ownr_co_nm
     }
   }
 `;
@@ -2415,7 +2420,7 @@ export const QUERY_PARTS_QUEUE_CARD_DETAILS = gql`
         start
         status
       }
-      notes(where:{pinned: {_eq: true}}, order_by: {updated_at: desc}) {
+      notes(where: { pinned: { _eq: true } }, order_by: { updated_at: desc }) {
         created_at
         created_by
         critical

client/src/pages/accounting-payables/accounting-payables.container.jsx

@@ -15,6 +15,7 @@ import FeatureWrapperComponent from "../../components/feature-wrapper/feature-wr
 import InstanceRenderManager from "../../utils/instanceRenderMgr";
 import UpsellComponent, { upsellEnum } from "../../components/upsell/upsell.component";
 import { Card } from "antd";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop,
@@ -54,8 +55,7 @@ export function AccountingPayablesContainer({ bodyshop, setBreadcrumbs, setSelec
   if (error) return <AlertComponent message={error.message} type="error" />;
 
   const noPath =
-    !partnerVersion?.qbpath &&
+    !partnerVersion?.qbpath && !(bodyshop && (bodyshopHasDmsKey(bodyshop) || bodyshop?.accountingconfig?.qbo));
-    !(bodyshop && (bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber || bodyshop.accountingconfig.qbo));
 
   return (
     <div>

client/src/pages/accounting-payments/accounting-payments.container.jsx

@@ -15,6 +15,7 @@ import FeatureWrapperComponent from "../../components/feature-wrapper/feature-wr
 import InstanceRenderManager from "../../utils/instanceRenderMgr";
 import UpsellComponent, { upsellEnum } from "../../components/upsell/upsell.component";
 import { Card } from "antd";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop,
@@ -52,9 +53,10 @@ export function AccountingPaymentsContainer({ bodyshop, setBreadcrumbs, setSelec
   });
 
   if (error) return <AlertComponent message={error.message} type="error" />;
+
   const noPath =
-    !partnerVersion?.qbpath &&
+    !partnerVersion?.qbpath && !(bodyshop && (bodyshopHasDmsKey(bodyshop) || bodyshop?.accountingconfig?.qbo));
-    !(bodyshop && (bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber || bodyshop.accountingconfig.qbo));
+
   return (
     <div>
       <FeatureWrapperComponent

client/src/pages/accounting-receivables/accounting-receivables.container.jsx

@@ -15,6 +15,7 @@ import FeatureWrapperComponent from "../../components/feature-wrapper/feature-wr
 import InstanceRenderManager from "../../utils/instanceRenderMgr";
 import { Card } from "antd";
 import UpsellComponent, { upsellEnum } from "../../components/upsell/upsell.component";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop,
@@ -57,8 +58,7 @@ export function AccountingReceivablesContainer({ bodyshop, setBreadcrumbs, setSe
   if (error) return <AlertComponent message={error.message} type="error" />;
 
   const noPath =
-    !partnerVersion?.qbpath &&
+    !partnerVersion?.qbpath && !(bodyshop && (bodyshopHasDmsKey(bodyshop) || bodyshop?.accountingconfig?.qbo));
-    !(bodyshop && (bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber || bodyshop.accountingconfig.qbo));
 
   return (
     <div>

client/src/pages/dms-payables/dms-payables.container.jsx

@@ -90,6 +90,7 @@ export function DmsContainer({ setBreadcrumbs, setSelectedHeader }) {
     });
 
     if (socket.disconnected) socket.connect();
+
     return () => {
       socket.removeAllListeners();
       socket.disconnect();
@@ -139,17 +140,10 @@ export function DmsContainer({ setBreadcrumbs, setSelectedHeader }) {
               </Space>
             }
           >
-            <DmsLogEvents socket={socket} logs={logs} />
+            <DmsLogEvents logs={logs} />
           </Card>
         </div>
       </Col>
     </Row>
   );
 }
-
-export const determineDmsType = (bodyshop) => {
-  if (bodyshop.cdk_dealerid) return "cdk";
-  else {
-    return "pbs";
-  }
-};

client/src/pages/dms/dms.container.jsx

@@ -1,26 +1,32 @@
-import { useQuery } from "@apollo/client";
+import { useEffect, useMemo, useRef, useState } from "react";
-import { Button, Card, Col, Result, Row, Select, Space } from "antd";
-import queryString from "query-string";
-import { useEffect, useRef, useState } from "react";
-import { useTranslation } from "react-i18next";
-import { connect } from "react-redux";
 import { Link, useLocation, useNavigate } from "react-router-dom";
+import { connect } from "react-redux";
+import { useTranslation } from "react-i18next";
 import { createStructuredSelector } from "reselect";
-import SocketIO from "socket.io-client";
+import queryString from "query-string";
-import AlertComponent from "../../components/alert/alert.component";
+import { useQuery } from "@apollo/client";
-import DmsAllocationsSummary from "../../components/dms-allocations-summary/dms-allocations-summary.component";
+import { Button, Card, Col, Result, Row, Select, Space, Switch } from "antd";
-import DmsCustomerSelector from "../../components/dms-customer-selector/dms-customer-selector.component";
+import { useSplitTreatments } from "@splitsoftware/splitio-react";
-import DmsLogEvents from "../../components/dms-log-events/dms-log-events.component";
+import { useSocket } from "../../contexts/SocketIO/useSocket.js";
-import DmsPostForm from "../../components/dms-post-form/dms-post-form.component";
+import { useNotification } from "../../contexts/Notifications/notificationContext.jsx";
-import LoadingSpinner from "../../components/loading-spinner/loading-spinner.component";
+
-import { OwnerNameDisplayFunction } from "../../components/owner-name-display/owner-name-display.component";
-import { auth } from "../../firebase/firebase.utils";
 import { QUERY_JOB_EXPORT_DMS } from "../../graphql/jobs.queries";
-import { insertAuditTrail, setBreadcrumbs, setSelectedHeader } from "../../redux/application/application.actions";
 import { selectBodyshop } from "../../redux/user/user.selectors";
+import { insertAuditTrail, setBreadcrumbs, setSelectedHeader } from "../../redux/application/application.actions";
+
 import InstanceRenderManager from "../../utils/instanceRenderMgr";
 import AuditTrailMapping from "../../utils/AuditTrailMappings";
-import { useNotification } from "../../contexts/Notifications/notificationContext.jsx";
+import { bodyshopHasDmsKey, DMS_MAP, getDmsMode, isWssMode } from "../../utils/dmsUtils.js";
+import legacySocket from "../../utils/legacySocket";
+
+import { OwnerNameDisplayFunction } from "../../components/owner-name-display/owner-name-display.component";
+import AlertComponent from "../../components/alert/alert.component";
+import LoadingSpinner from "../../components/loading-spinner/loading-spinner.component";
+import DmsPostForm from "../../components/dms-post-form/dms-post-form.component";
+import DmsLogEvents from "../../components/dms-log-events/dms-log-events.component";
+import DmsCustomerSelector from "../../components/dms-customer-selector/dms-customer-selector.component";
+import DmsAllocationsSummary from "../../components/dms-allocations-summary/dms-allocations-summary.component";
+import RrAllocationsSummary from "../../components/dms-allocations-summary/rr-dms-allocations-summary.component";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop
@@ -34,130 +40,413 @@ const mapDispatchToProps = (dispatch) => ({
 
 export default connect(mapStateToProps, mapDispatchToProps)(DmsContainer);
 
-export const socket = SocketIO(
+const DMS_SOCKET_EVENTS = {
-  import.meta.env.PROD ? import.meta.env.VITE_APP_AXIOS_BASE_API_URL : "", // for dev testing,
+  [DMS_MAP.reynolds]: {
-  {
+    log: "rr-log-event",
-    path: "/ws",
+    partialResult: "rr-export-job:result",
-    withCredentials: true,
+    validationNeeded: "rr-validation-required",
-    auth: async (callback) => {
+    exportSuccess: "export-success",
-      const token = auth.currentUser && (await auth.currentUser.getIdToken());
+    exportFailed: "export-failed"
-      callback({ token });
+  },
-    }
+  [DMS_MAP.fortellis]: {
+    log: "fortellis-log-event",
+    exportSuccess: "export-success",
+    exportFailed: "export-failed"
+  },
+  [DMS_MAP.cdk]: {
+    log: "log-event",
+    exportSuccess: "export-success",
+    exportFailed: "export-failed"
+  },
+  [DMS_MAP.pbs]: {
+    log: "log-event",
+    exportSuccess: "export-success",
+    exportFailed: "export-failed"
   }
-);
+};
 
 export function DmsContainer({ bodyshop, setBreadcrumbs, setSelectedHeader, insertAuditTrail }) {
   const { t } = useTranslation();
-  const [logLevel, setLogLevel] = useState(determineDmsType(bodyshop) === "pbs" ? "INFO" : "DEBUG");
+  const [resetAfterReconnect, setResetAfterReconnect] = useState(false);
+
   const history = useNavigate();
-  const [logs, setLogs] = useState([]);
   const search = queryString.parse(useLocation().search);
   const { jobId } = search;
+
   const notification = useNotification();
 
+  const {
+    treatments: { Fortellis }
+  } = useSplitTreatments({
+    attributes: {},
+    names: ["Fortellis"],
+    splitKey: bodyshop.imexshopid
+  });
+
+  // Compute a single normalized mode and pick the proper socket
+  const mode = getDmsMode(bodyshop, Fortellis.treatment); // "rr" | "fortellis" | "cdk" | "pbs" | "none"
+  const isRrMode = mode === DMS_MAP.reynolds;
+
+  const { socket: wsssocket } = useSocket();
+  const activeSocket = useMemo(() => (isWssMode(mode) ? wsssocket : legacySocket), [mode, wsssocket]);
+
+  const [isConnected, setIsConnected] = useState(!!activeSocket?.connected);
+
+  // One place to set log level
+  const [logLevel, setLogLevel] = useState(mode === DMS_MAP.pbs ? "INFO" : "DEBUG");
+
+  const setActiveLogLevel = (level) => {
+    if (!activeSocket) return;
+    activeSocket.emit("set-log-level", level);
+  };
+
+  const [logs, setLogs] = useState([]);
+  const [detailsOpen, setDetailsOpen] = useState(false);
+  const [detailsNonce, setDetailsNonce] = useState(0);
+  const [colorizeJson, setColorizeJson] = useState(false);
+
+  const [rrOpenRoLimit, setRrOpenRoLimit] = useState(false);
+  const clearRrOpenRoLimit = () => setRrOpenRoLimit(false);
+
+  const [rrValidationPending, setrrValidationPending] = useState(false);
+
   const { loading, error, data } = useQuery(QUERY_JOB_EXPORT_DMS, {
     variables: { id: jobId },
     skip: !jobId,
     fetchPolicy: "network-only",
     nextFetchPolicy: "network-only"
   });
+
   const logsRef = useRef(null);
 
+  const toggleDetailsAll = () => {
+    setDetailsOpen((v) => !v);
+    setDetailsNonce((n) => n + 1);
+  };
+
+  // Channel names per mode to avoid branching everywhere
+  const channels = useMemo(() => DMS_SOCKET_EVENTS[mode] || {}, [mode]);
+
+  const providerLabel = useMemo(
+    () =>
+      ({
+        [DMS_MAP.reynolds]: "Reynolds",
+        [DMS_MAP.fortellis]: "Fortellis",
+        [DMS_MAP.cdk]: "CDK",
+        [DMS_MAP.pbs]: "PBS"
+      })[mode] || "DMS",
+    [mode]
+  );
+
+  const transportLabel = isWssMode(mode) ? "(WSS)" : "(WS)";
+
+  const bannerMessage = `Posting to ${providerLabel} | ${transportLabel} | ${
+    isConnected ? "Connected" : "Disconnected"
+  }`;
+
+  const resetKey = useMemo(() => `${mode || "none"}-${jobId || "none"}`, [mode, jobId]);
+
+  // 🔄 Hard reset of local + server-side DMS context when the page/job loads
+  useEffect(() => {
+    // Clear any local ephemeral state that might be stale
+    setLogs([]);
+    setRrOpenRoLimit(false);
+    setrrValidationPending(false);
+
+    if (!activeSocket) return;
+
+    const emitReset = () => {
+      // Generic reset; server can branch on `mode` if needed
+      activeSocket.emit("dms-reset-context", { jobId, mode });
+    };
+
+    if (activeSocket.connected) {
+      // WSS usually lands here
+      emitReset();
+      return;
+    }
+
+    // Legacy WS: wait for the connect before emitting reset
+    const handleConnectOnce = () => {
+      emitReset();
+      activeSocket.off("connect", handleConnectOnce);
+    };
+
+    activeSocket.on("connect", handleConnectOnce);
+
+    return () => {
+      activeSocket.off("connect", handleConnectOnce);
+    };
+  }, [jobId, mode, activeSocket]);
+
+  const handleExportFailed = (payload = {}) => {
+    const { title, friendlyMessage, error: errText, severity, errorCode, vendorStatusCode } = payload;
+
+    const msg =
+      friendlyMessage ||
+      errText ||
+      t("dms.errors.exportfailedgeneric", "We couldn't complete the export. Please try again.");
+
+    const vendorTitle = title || (isRrMode ? "Reynolds" : "DMS");
+
+    const isRrOpenRoLimit =
+      isRrMode &&
+      (vendorStatusCode === 507 ||
+        /MAX_OPEN_ROS/i.test(String(errorCode || "")) ||
+        /maximum number of open repair orders/i.test(String(msg || "").toLowerCase()));
+
+    const sev = severity || (isRrOpenRoLimit ? "warning" : "error");
+
+    if (!isRrOpenRoLimit) {
+      const notifyKind = sev === "warning" && typeof notification.warning === "function" ? "warning" : "error";
+      notification[notifyKind]({ message: vendorTitle, description: msg, duration: 10 });
+    } else {
+      setRrOpenRoLimit(true);
+    }
+
+    setLogs((prev) => [
+      ...prev,
+      {
+        timestamp: new Date(),
+        level: (sev || "error").toUpperCase(),
+        message: `${vendorTitle}: ${msg}`,
+        meta: { errorCode, vendorStatusCode, raw: payload, blockedByOpenRoLimit: !!isRrOpenRoLimit }
+      }
+    ]);
+  };
+
+  // keep this in sync if mode/socket flips
+  useEffect(() => {
+    setIsConnected(!!activeSocket?.connected);
+  }, [activeSocket]);
+
   useEffect(() => {
     document.title = t("titles.dms", {
-      app: InstanceRenderManager({
+      app: InstanceRenderManager({ imex: "$t(titles.imexonline)", rome: "$t(titles.romeonline)" })
-        imex: "$t(titles.imexonline)",
-        rome: "$t(titles.romeonline)"
-      })
     });
     setSelectedHeader("dms");
     setBreadcrumbs([
-      {
+      { link: "/manage/accounting/receivables", label: t("titles.bc.accounting-receivables") }
-        link: "/manage/accounting/receivables",
+      // { link: "/manage/dms", label: t("titles.bc.dms") }
-        label: t("titles.bc.accounting-receivables")
-      },
-      {
-        link: "/manage/dms",
-        label: t("titles.bc.dms")
-      }
     ]);
   }, [t, setBreadcrumbs, setSelectedHeader]);
 
+  // Socket wiring (mode-aware)
   useEffect(() => {
-    socket.on("connect", () => socket.emit("set-log-level", logLevel));
+    if (!activeSocket) return;
-    socket.on("reconnect", () => {
+
-      setLogs((logs) => {
+    // Connect legacy socket if needed
-        return [
+    if (!isWssMode(mode)) {
-          ...logs,
+      if (activeSocket.disconnected) activeSocket.connect();
-          {
+    }
-            timestamp: new Date(),
+
-            level: "warn",
+    // Set log level now and on connect/reconnect
-            message: "Reconnected to CDK Export Service"
+    setActiveLogLevel(logLevel);
-          }
+
-        ];
+    const onConnect = () => {
-      });
+      setIsConnected(true);
-    });
+      setActiveLogLevel(logLevel);
-    socket.on("connect_error", (err) => {
+
+      if (resetAfterReconnect) {
+        activeSocket.emit("dms-reset-context", { jobId, mode });
+        setResetAfterReconnect(false);
+      }
+    };
+
+    const onDisconnect = () => setIsConnected(false);
+
+    const onReconnect = () => {
+      setIsConnected(true);
+      setLogs((prev) => [
+        ...prev,
+        {
+          timestamp: new Date(),
+          level: "warn",
+          message: `Reconnected to ${isRrMode ? "RR" : mode === DMS_MAP.fortellis ? "Fortellis" : "DMS"} Export Service`
+        }
+      ]);
+    };
+
+    const onConnectError = (err) => {
+      // Legacy and WSS both emit this
       console.log(`connect_error due to ${err}`, err);
       notification.error({ message: err.message });
-    });
+    };
-    socket.on("log-event", (payload) => {
+
-      setLogs((logs) => {
+    activeSocket.on("disconnect", onDisconnect);
-        return [...logs, payload];
+    activeSocket.on("connect", onConnect);
-      });
+    activeSocket.on("reconnect", onReconnect);
-    });
+    activeSocket.on("connect_error", onConnectError);
-    socket.on("export-success", (payload) => {
+
-      notification.success({
+    // Logs
-        message: t("jobs.successes.exported")
+    const onLog = isRrMode
-      });
+      ? (payload = {}) => {
+          const normalized = {
+            timestamp: payload.timestamp ? new Date(payload.timestamp) : payload.ts ? new Date(payload.ts) : new Date(),
+            level: (payload.level || "INFO").toUpperCase(),
+            message: payload.message || payload.msg || "",
+            meta: payload.meta ?? payload.ctx ?? payload.details ?? null
+          };
+          setLogs((prev) => [...prev, normalized]);
+        }
+      : (payload) => setLogs((prev) => [...prev, payload]);
+
+    if (channels.log) activeSocket.on(channels.log, onLog);
+
+    // Success / Failed
+    const onExportSuccess = (payload) => {
+      const jobIdResolved = payload?.jobId ?? payload;
+      notification.success({ message: t("jobs.successes.exported") });
+
+      // Clear RR Validation flag if any
+      setrrValidationPending(false);
+
       insertAuditTrail({
-        jobid: payload,
+        jobid: jobIdResolved,
         operation: AuditTrailMapping.jobexported(),
         type: "jobexported"
       });
       history("/manage/accounting/receivables");
-    });
-
-    if (socket.disconnected) socket.connect();
-    return () => {
-      socket.removeAllListeners();
-      socket.disconnect();
     };
-  }, []);
+
+    if (channels.exportSuccess) activeSocket.on(channels.exportSuccess, onExportSuccess);
+    if (channels.exportFailed) activeSocket.on(channels.exportFailed, handleExportFailed);
+
+    // RR-only extras
+
+    const onPartialResult = () => {
+      setrrValidationPending(true);
+      setLogs((prev) => [
+        ...prev,
+        {
+          timestamp: new Date(),
+          level: "INFO",
+          message:
+            "Repair Order created in Reynolds. Complete validation in Reynolds, then click Finished/Close to finalize."
+        }
+      ]);
+      notification.info({
+        message: "Reynolds RO created",
+        description:
+          "Complete validation in Reynolds, then click Finished/Close to finalize and mark this export complete.",
+        duration: 8
+      });
+    };
+
+    const onValidationRequired = (payload) => {
+      setrrValidationPending(true);
+      setLogs((prev) => [
+        ...prev,
+        {
+          timestamp: new Date(),
+          level: "INFO",
+          message:
+            "Repair Order created in Reynolds. Complete validation in Reynolds, then click Finished/Close to finalize.",
+          meta: { payload }
+        }
+      ]);
+    };
+
+    if (isRrMode && channels.partialResult) activeSocket.on(channels.partialResult, onPartialResult);
+    if (isRrMode && channels.validationNeeded) activeSocket.on(channels.validationNeeded, onValidationRequired);
+
+    return () => {
+      activeSocket.off("connect", onConnect);
+      activeSocket.off("reconnect", onReconnect);
+      activeSocket.off("connect_error", onConnectError);
+      activeSocket.off("disconnect", onDisconnect);
+
+      if (channels.log) activeSocket.off(channels.log, onLog);
+      if (channels.exportSuccess) activeSocket.off(channels.exportSuccess, onExportSuccess);
+      if (channels.exportFailed) activeSocket.off(channels.exportFailed, handleExportFailed);
+
+      if (isRrMode && channels.partialResult) activeSocket.off(channels.partialResult, onPartialResult);
+      if (isRrMode && channels.validationNeeded) activeSocket.off(channels.validationNeeded, onValidationRequired);
+
+      // Only tear down legacy socket listeners; don't disconnect WSS from here
+      if (!isWssMode(mode)) {
+        activeSocket.removeAllListeners();
+        activeSocket.disconnect();
+      }
+    };
+  }, [mode, activeSocket, channels, logLevel, notification, t, insertAuditTrail, history]);
+
+  // RR finalize callback (unchanged public behavior)
+  const handleRrValidationFinished = () => {
+    if (!jobId) return;
+    if (!isWssMode(mode)) return; // RR is WSS-only
+    activeSocket.emit("rr-finalize-repair-order", { jobId }, (ack) => {
+      if (ack?.ok) return;
+      if (ack?.error) notification.error({ message: ack.error });
+    });
+  };
 
   if (loading) return <LoadingSpinner />;
   if (error) return <AlertComponent message={error.message} type="error" />;
 
-  if (!jobId || !(bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber) || !(data && data.jobs_by_pk))
+  if (!jobId || !bodyshopHasDmsKey(bodyshop) || !data?.jobs_by_pk)
     return <Result status="404" title={t("general.errors.notfound")} />;
 
-  if (data.jobs_by_pk && data.jobs_by_pk.date_exported)
+  if (data.jobs_by_pk?.date_exported) return <Result status="warning" title={t("dms.errors.alreadyexported")} />;
-    return <Result status="warning" title={t("dms.errors.alreadyexported")} />;
 
   return (
     <div>
+      <AlertComponent style={{ marginBottom: 10 }} message={bannerMessage} type="warning" showIcon closable />
+
       <Row gutter={[16, 16]}>
-        <Col md={24} lg={10}>
+        <Col md={24} lg={10} className="dms-equal-height-col">
-          <DmsAllocationsSummary
+          {!isRrMode ? (
-            title={
+            <DmsAllocationsSummary
-              <span>
+              key={resetKey}
-                <Link to={`/manage/jobs/${data && data.jobs_by_pk.id}`}>{`${
+              title={
-                  data && data.jobs_by_pk && data.jobs_by_pk.ro_number
+                <span>
-                }`}</Link>
+                  <Link
-                {` | ${OwnerNameDisplayFunction(data.jobs_by_pk)} | ${
+                    to={`/manage/jobs/${data && data.jobs_by_pk.id}`}
-                  data.jobs_by_pk.v_model_yr || ""
+                  >{`${data?.jobs_by_pk && data.jobs_by_pk.ro_number}`}</Link>
-                } ${data.jobs_by_pk.v_make_desc || ""} ${data.jobs_by_pk.v_model_desc || ""}`}
+                  {` | ${OwnerNameDisplayFunction(data.jobs_by_pk)} | ${data.jobs_by_pk.v_model_yr || ""} ${
-              </span>
+                    data.jobs_by_pk.v_make_desc || ""
-            }
+                  } ${data.jobs_by_pk.v_model_desc || ""}`}
-            socket={socket}
+                </span>
-            jobId={jobId}
+              }
-          />
+              socket={activeSocket}
-        </Col>
+              jobId={jobId}
-        <Col md={24} lg={14}>
+              mode={mode}
-          <DmsPostForm socket={socket} jobId={jobId} job={data && data.jobs_by_pk} logsRef={logsRef} />
+            />
+          ) : (
+            <RrAllocationsSummary
+              key={resetKey}
+              title={
+                <span>
+                  <Link to={`/manage/jobs/${data && data.jobs_by_pk.id}`}>
+                    {data?.jobs_by_pk && data.jobs_by_pk.ro_number}
+                  </Link>
+                  {` | ${OwnerNameDisplayFunction(data.jobs_by_pk)} | ${
+                    data.jobs_by_pk.v_model_yr || ""
+                  } ${data.jobs_by_pk.v_make_desc || ""} ${data.jobs_by_pk.v_model_desc || ""}`}
+                </span>
+              }
+              socket={activeSocket}
+              jobId={jobId}
+            />
+          )}
         </Col>
 
-        <DmsCustomerSelector />
+        <Col md={24} lg={14} className="dms-equal-height-col">
+          <DmsPostForm key={resetKey} socket={activeSocket} job={data?.jobs_by_pk} logsRef={logsRef} mode={mode} />
+        </Col>
+
+        <DmsCustomerSelector
+          jobid={jobId}
+          bodyshop={bodyshop}
+          socket={activeSocket}
+          mode={mode}
+          rrOptions={{
+            openRoLimit: rrOpenRoLimit,
+            onOpenRoFinished: clearRrOpenRoLimit,
+            validationPending: rrValidationPending,
+            onValidationFinished: handleRrValidationFinished
+          }}
+        />
 
         <Col span={24}>
           <div ref={logsRef}>
@@ -165,14 +454,27 @@ export function DmsContainer({ bodyshop, setBreadcrumbs, setSelectedHeader, inse
               title={t("jobs.labels.dms.logs")}
               extra={
                 <Space wrap>
+                  {isRrMode && (
+                    <>
+                      <Switch
+                        checked={colorizeJson}
+                        onChange={setColorizeJson}
+                        checkedChildren="Color JSON"
+                        unCheckedChildren="Plain JSON"
+                      />
+                      <Button onClick={toggleDetailsAll}>{detailsOpen ? "Collapse All" : "Expand All"}</Button>
+                    </>
+                  )}
+
                   <Select
                     placeholder="Log Level"
                     value={logLevel}
                     onChange={(value) => {
                       setLogLevel(value);
-                      socket.emit("set-log-level", value);
+                      setActiveLogLevel(value);
                     }}
                   >
+                    <Select.Option key="SILLY">SILLY</Select.Option>
                     <Select.Option key="DEBUG">DEBUG</Select.Option>
                     <Select.Option key="INFO">INFO</Select.Option>
                     <Select.Option key="WARN">WARN</Select.Option>
@@ -182,8 +484,14 @@ export function DmsContainer({ bodyshop, setBreadcrumbs, setSelectedHeader, inse
                   <Button
                     onClick={() => {
                       setLogs([]);
-                      socket.disconnect();
+                      setResetAfterReconnect(true);
-                      socket.connect();
+                      if (isWssMode(mode)) {
+                        setActiveLogLevel(logLevel);
+                      }
+                      if (activeSocket) {
+                        activeSocket.disconnect();
+                        setTimeout(() => activeSocket.connect(), 100);
+                      }
                     }}
                   >
                     Reconnect
@@ -191,7 +499,15 @@ export function DmsContainer({ bodyshop, setBreadcrumbs, setSelectedHeader, inse
                 </Space>
               }
             >
-              <DmsLogEvents socket={socket} logs={logs} />
+              <DmsLogEvents
+                logs={logs}
+                // Only honour details/colorized JSON in RR mode;
+                // in other modes DmsLogEvents can render a simple, flat list.
+                detailsOpen={isRrMode ? detailsOpen : false}
+                detailsNonce={detailsNonce}
+                colorizeJson={isRrMode ? colorizeJson : false}
+                showDetails={isRrMode}
+              />
             </Card>
           </div>
         </Col>
@@ -199,10 +515,3 @@ export function DmsContainer({ bodyshop, setBreadcrumbs, setSelectedHeader, inse
     </div>
   );
 }
-
-export const determineDmsType = (bodyshop) => {
-  if (bodyshop.cdk_dealerid) return "cdk";
-  else {
-    return "pbs";
-  }
-};

client/src/pages/jobs-close/jobs-close.component.jsx

@@ -42,6 +42,7 @@ import { setModalContext } from "../../redux/modals/modals.actions.js";
 import { selectBodyshop, selectCurrentUser } from "../../redux/user/user.selectors";
 import AuditTrailMapping from "../../utils/AuditTrailMappings";
 import dayjs from "../../utils/day";
+import { bodyshopHasDmsKey } from "../../utils/dmsUtils.js";
 
 const mapStateToProps = createStructuredSelector({
   bodyshop: selectBodyshop,
@@ -69,6 +70,8 @@ export function JobsCloseComponent({ job, bodyshop, jobRO, insertAuditTrail, set
   const [loading, setLoading] = useState(false);
   const notification = useNotification();
 
+  const hasDMSKey = bodyshopHasDmsKey(bodyshop);
+
   const {
     treatments: { Qb_Multi_Ar, ClosingPeriod }
   } = useSplitTreatments({
@@ -191,7 +194,7 @@ export function JobsCloseComponent({ job, bodyshop, jobRO, insertAuditTrail, set
                   {t("general.actions.close")}
                 </Button>
               </Popconfirm>
-              {(bodyshop.pbs_serialnumber || bodyshop.cdk_dealerid) && (
+              {bodyshopHasDmsKey(bodyshop) && (
                 <Link to={`/manage/dms?jobId=${job.id}`}>
                   <Button disabled={job.date_exported || !jobRO}>{t("jobs.actions.sendtodms")}</Button>
                 </Link>
@@ -311,7 +314,7 @@ export function JobsCloseComponent({ job, bodyshop, jobRO, insertAuditTrail, set
               <Switch />
             </Form.Item>
           )}
-          {(bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber) && (
+          {hasDMSKey && (
             <Form.Item
               label={t("jobs.fields.kmin")}
               name="kmin"
@@ -324,7 +327,7 @@ export function JobsCloseComponent({ job, bodyshop, jobRO, insertAuditTrail, set
               <InputNumber precision={0} disabled={jobRO} />
             </Form.Item>
           )}
-          {(bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber) && (
+          {hasDMSKey && (
             <Form.Item
               label={t("jobs.fields.kmout")}
               name="kmout"
@@ -348,7 +351,7 @@ export function JobsCloseComponent({ job, bodyshop, jobRO, insertAuditTrail, set
               <InputNumber precision={0} disabled={jobRO} />
             </Form.Item>
           )}
-          {(bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber) && (
+          {hasDMSKey && (
             <Form.Item
               label={t("jobs.fields.dms_allocation")}
               name="dms_allocation"

client/src/translations/en_us/common.json

@@ -558,6 +558,14 @@
         "responsibilitycenter_tax_tier": "Tax {{typeNum}} Tier {{typeNumIterator}}",
         "responsibilitycenter_tax_type": "Tax {{typeNum}} Type",
         "responsibilitycenters": {
+          "gogcode": "GOG Code (BreakOut)",
+          "item_type": "Item Type",
+          "item_type_gog": "GOG",
+          "item_type_paint": "Paint Materials",
+          "item_type_freight": "Freight",
+          "taxable_flag": "Taxable?",
+          "taxable": "Taxable",
+          "nontaxable": "Non-taxable",
           "ap": "Accounts Payable",
           "ar": "Accounts Receivable",
           "ats": "ATS",
@@ -688,6 +696,7 @@
             "payers": "Payers"
           },
           "cdk_dealerid": "CDK Dealer ID",
+          "rr_dealerid": "Reynolds Store Number",
           "costsmapping": "Costs Mapping",
           "dms_allocations": "DMS Allocations",
           "pbs_serialnumber": "PBS Serial Number",
@@ -1035,7 +1044,7 @@
         "alreadyexported": "This job has already been sent to the DMS. If you need to resend it, please use admin permissions to mark the job for re-export."
       },
       "labels": {
-        "refreshallocations": "Refresh to see DMS Allocataions."
+        "refreshallocations": "Refresh to see DMS Allocations."
       }
     },
     "documents": {
@@ -1212,6 +1221,8 @@
     },
     "general": {
       "actions": {
+        "select": "Select",
+        "optional": "Optional",
         "add": "Add",
         "autoupdate": "{{app}} will automatically update in {{time}} seconds. Please save all changes.",
         "calculate": "Calculate",
@@ -1777,6 +1788,8 @@
           "id": "DMS ID",
           "inservicedate": "In Service Date",
           "journal": "Journal #",
+          "make_override": "Make Override",
+          "advisor": "Advisor #",
           "lines": "Posting Lines",
           "name1": "Customer Name",
           "payer": {
@@ -1784,7 +1797,8 @@
             "control_type": "Control Type",
             "controlnumber": "Control Number",
             "dms_acctnumber": "DMS Account #",
-            "name": "Payer Name"
+            "name": "Payer Name",
+            "payer_type": "Payer"
           },
           "sale": "Sale",
           "sale_dms_acctnumber": "Sale DMS Acct #",
@@ -1851,7 +1865,7 @@
         "loss_of_use": "Loss of Use",
         "lost_sale_reason": "Lost Sale Reason",
         "ma2s": "2 Stage Paint",
-        "ma3s": "3 Stage Pain",
+        "ma3s": "3 Stage Paint",
         "mabl": "MABL?",
         "macs": "MACS?",
         "mahw": "Hazardous Waste",

client/src/translations/es/common.json

@@ -558,6 +558,14 @@
         "responsibilitycenter_tax_tier": "",
         "responsibilitycenter_tax_type": "",
         "responsibilitycenters": {
+          "gogcode": "",
+          "item_type": "Item Type",
+          "item_type_gog": "",
+          "item_type_paint": "",
+          "item_type_freight": "",
+          "taxable_flag": "",
+          "taxable": "",
+          "nontaxable": "",
           "ap": "",
           "ar": "",
           "ats": "",
@@ -688,6 +696,7 @@
             "payers": ""
           },
           "cdk_dealerid": "",
+          "rr_dealerid": "",
           "costsmapping": "",
           "dms_allocations": "",
           "pbs_serialnumber": "",
@@ -1772,6 +1781,8 @@
           "dms_make": "",
           "dms_model": "",
           "dms_model_override": "",
+          "make_override": "",
+          "advisor": "",
           "dms_unsold": "",
           "dms_wip_acctnumber": "",
           "id": "",

client/src/translations/fr/common.json

@@ -558,6 +558,14 @@
         "responsibilitycenter_tax_tier": "",
         "responsibilitycenter_tax_type": "",
         "responsibilitycenters": {
+          "gogcode": "",
+          "item_type": "Item Type",
+          "item_type_gog": "",
+          "item_type_paint": "",
+          "item_type_freight": "",
+          "taxable_flag": "",
+          "taxable": "",
+          "nontaxable": "",
           "ap": "",
           "ar": "",
           "ats": "",
@@ -688,6 +696,7 @@
             "payers": ""
           },
           "cdk_dealerid": "",
+          "rr_dealerid": "",
           "costsmapping": "",
           "dms_allocations": "",
           "pbs_serialnumber": "",
@@ -1772,6 +1781,8 @@
           "dms_make": "",
           "dms_model": "",
           "dms_model_override": "",
+          "make_override": "",
+          "advisor": "",
           "dms_unsold": "",
           "dms_wip_acctnumber": "",
           "id": "",

client/src/utils/dmsUtils.js

@@ -0,0 +1,72 @@
+/**
+ * DMS type mapping constants.
+ * CAREFUL: the values here are used as canonical "mode" strings elsewhere in the app.
+ * @type {{reynolds: string, cdk: string, pbs: string, fortellis: string}}
+ */
+export const DMS_MAP = {
+  reynolds: "rr",
+  cdk: "cdk",
+  pbs: "pbs",
+  fortellis: "fortellis"
+};
+
+/**
+ * Determines the DMS type for a given bodyshop object.
+ * @param bodyshop
+ * @returns {*|string}
+ */
+export const determineDMSTypeByBodyshop = (bodyshop) => {
+  const dmsMapping = {
+    cdk_dealerid: DMS_MAP.cdk,
+    pbs_serialnumber: DMS_MAP.pbs,
+    rr_dealerid: DMS_MAP.reynolds
+  };
+
+  return Object.keys(dmsMapping).find((key) => bodyshop[key])
+    ? dmsMapping[Object.keys(dmsMapping).find((key) => bodyshop[key])]
+    : DMS_MAP.pbs;
+};
+
+/**
+ * Determines the translation key for a given DMS type.
+ * @param dmsType
+ * @returns {*|string}
+ */
+export const determineDmsTypeTranslationKey = (dmsType) => {
+  const dmsTypeMapping = {
+    [DMS_MAP.cdk]: "bodyshop.labels.dms.cdk",
+    [DMS_MAP.pbs]: "bodyshop.labels.dms.pbs",
+    [DMS_MAP.reynolds]: "bodyshop.labels.dms.rr"
+  };
+
+  return dmsTypeMapping[dmsType] || dmsTypeMapping[DMS_MAP.pbs];
+};
+
+/**
+ * Returns a normalized "mode" we can switch on:
+ * @param bodyshop
+ * @param fortellisTreatment
+ * @returns {*|string|string}
+ */
+export const getDmsMode = (bodyshop, fortellisTreatment) => {
+  const base = determineDMSTypeByBodyshop(bodyshop); // "rr" | "cdk" | "pbs" | undefined
+  if (base === DMS_MAP.cdk && fortellisTreatment === "on") return DMS_MAP.fortellis;
+  return base ?? "none";
+};
+
+/**
+ * Checks if the DMS mode uses WSS.
+ * @param mode
+ * @returns {boolean}
+ */
+export const isWssMode = (mode) => {
+  return mode === DMS_MAP.reynolds || mode === DMS_MAP.fortellis;
+};
+
+/**
+ * Checks if the bodyshop has any DMS key configured.
+ * @param bodyshop
+ * @returns {*|string}
+ */
+export const bodyshopHasDmsKey = (bodyshop) =>
+  bodyshop.cdk_dealerid || bodyshop.pbs_serialnumber || bodyshop.rr_dealerid;

client/src/utils/legacySocket.js

@@ -0,0 +1,16 @@
+// client/src/utils/legacySocket.js
+import SocketIO from "socket.io-client";
+import { auth } from "../firebase/firebase.utils";
+
+// Create once, reuse everywhere.
+const legacySocket = SocketIO(import.meta.env.PROD ? import.meta.env.VITE_APP_AXIOS_BASE_API_URL : "", {
+  path: "/ws",
+  withCredentials: true,
+  autoConnect: false,
+  auth: async (callback) => {
+    const token = auth.currentUser && (await auth.currentUser.getIdToken());
+    callback({ token });
+  }
+});
+
+export default legacySocket;

package.json

@@ -18,24 +18,25 @@
     "job-totals-fixtures:local": "docker exec node-app /usr/bin/node /app/download-job-totals-fixtures.js"
   },
   "dependencies": {
-    "@aws-sdk/client-cloudwatch-logs": "^3.901.0",
+    "@aws-sdk/client-cloudwatch-logs": "^3.932.0",
-    "@aws-sdk/client-elasticache": "^3.901.0",
+    "@aws-sdk/client-elasticache": "^3.932.0",
-    "@aws-sdk/client-s3": "^3.901.0",
+    "@aws-sdk/client-s3": "^3.932.0",
-    "@aws-sdk/client-secrets-manager": "^3.901.0",
+    "@aws-sdk/client-secrets-manager": "^3.932.0",
-    "@aws-sdk/client-ses": "^3.901.0",
+    "@aws-sdk/client-ses": "^3.932.0",
-    "@aws-sdk/credential-provider-node": "^3.901.0",
+    "@aws-sdk/credential-provider-node": "^3.932.0",
-    "@aws-sdk/lib-storage": "^3.903.0",
+    "@aws-sdk/lib-storage": "^3.932.0",
-    "@aws-sdk/s3-request-presigner": "^3.901.0",
+    "@aws-sdk/s3-request-presigner": "^3.932.0",
     "@opensearch-project/opensearch": "^2.13.0",
     "@socket.io/admin-ui": "^0.5.1",
     "@socket.io/redis-adapter": "^8.3.0",
     "archiver": "^7.0.1",
     "aws4": "^1.13.2",
-    "axios": "^1.12.2",
+    "axios": "^1.13.2",
+    "axios-curlirize": "^2.0.0",
     "better-queue": "^3.8.12",
-    "bullmq": "^5.61.0",
+    "bullmq": "^5.63.2",
-    "chart.js": "^4.5.0",
+    "chart.js": "^4.5.1",
-    "cloudinary": "^2.7.0",
+    "cloudinary": "^2.8.0",
     "compression": "^1.8.1",
     "cookie-parser": "^1.4.7",
     "cors": "^2.8.5",
@@ -43,40 +44,43 @@
     "dinero.js": "^1.9.1",
     "dotenv": "^17.2.3",
     "express": "^4.21.1",
-    "firebase-admin": "^13.5.0",
+    "fast-xml-parser": "^5.3.2",
-    "graphql": "^16.11.0",
+    "firebase-admin": "^13.6.0",
+    "graphql": "^16.12.0",
     "graphql-request": "^6.1.0",
-    "intuit-oauth": "^4.2.0",
+    "intuit-oauth": "^4.2.2",
-    "ioredis": "^5.8.1",
+    "ioredis": "^5.8.2",
-    "json-2-csv": "^5.5.9",
+    "json-2-csv": "^5.5.10",
     "jsonwebtoken": "^9.0.2",
     "juice": "^11.0.3",
     "lodash": "^4.17.21",
     "moment": "^2.30.1",
     "moment-timezone": "^0.6.0",
-    "multer": "^1.4.5-lts.1",
+    "multer": "^2.0.2",
+    "mustache": "^4.2.0",
     "node-persist": "^4.0.4",
     "nodemailer": "^6.10.0",
     "phone": "^3.1.67",
     "query-string": "7.1.3",
     "recursive-diff": "^1.0.9",
-    "rimraf": "^6.0.1",
+    "rimraf": "^6.1.0",
     "skia-canvas": "^3.0.8",
-    "soap": "^1.5.0",
+    "soap": "^1.6.0",
     "socket.io": "^4.8.1",
     "socket.io-adapter": "^2.5.5",
     "ssh2-sftp-client": "^11.0.0",
-    "twilio": "^5.10.2",
+    "twilio": "^5.10.5",
     "uuid": "^11.1.0",
     "winston": "^3.18.3",
     "winston-cloudwatch": "^6.3.0",
+    "xml-formatter": "^3.6.7",
     "xml2js": "^0.6.2",
-    "xmlbuilder2": "^3.1.1",
+    "xmlbuilder2": "^4.0.0",
     "yazl": "^3.3.1"
   },
   "devDependencies": {
-    "@eslint/js": "^9.37.0",
+    "@eslint/js": "^9.39.1",
-    "eslint": "^9.37.0",
+    "eslint": "^9.39.1",
     "eslint-plugin-react": "^7.37.5",
     "globals": "^15.15.0",
     "mock-require": "^3.0.3",

server.js

@@ -38,7 +38,7 @@ const { registerCleanupTask, initializeCleanupManager } = require("./server/util
 
 const { loadEmailQueue } = require("./server/notifications/queues/emailQueue");
 const { loadAppQueue } = require("./server/notifications/queues/appQueue");
-
+const { SetLegacyWebsocketHandlers } = require("./server/web-sockets/web-socket");
 const CLUSTER_RETRY_BASE_DELAY = 100;
 const CLUSTER_RETRY_MAX_DELAY = 5000;
 const CLUSTER_RETRY_JITTER = 100;
@@ -247,6 +247,29 @@ const connectToRedisCluster = async () => {
       });
       reject(err);
     });
+
+    redisCluster.on("+node", (node) => {
+      logger.log(`Redis cluster node added`, "INFO", "redis", "api", {
+        host: node.options.host,
+        port: node.options.port
+      });
+    });
+
+    redisCluster.on("-node", (node) => {
+      logger.log(`Redis cluster node removed`, "WARN", "redis", "api", {
+        host: node.options.host,
+        port: node.options.port
+      });
+    });
+
+    redisCluster.on("node error", (error, node) => {
+      console.dir(error);
+      logger.log(`Redis node error`, "ERROR", "redis", "api", {
+        host: node.options.host,
+        port: node.options.port,
+        message: error.message
+      });
+    });
   });
 };
 
@@ -324,6 +347,9 @@ const applySocketIO = async ({ server, app }) => {
     }
   });
 
+  // Legacy Socket Events
+  SetLegacyWebsocketHandlers(io);
+
   const api = {
     pubClient,
     io,
@@ -387,9 +413,6 @@ const main = async () => {
   const redisHelpers = applyRedisHelpers({ pubClient, app, logger });
   const ioHelpers = applyIOHelpers({ app, redisHelpers, ioRedis, logger });
 
-  // Legacy Socket Events
-  require("./server/web-sockets/web-socket");
-
   // Initialize Queues
   await loadQueues({ pubClient: pubClient, logger, redisHelpers, ioRedis });
 

server/accounting/pbs/pbs-ap-allocations.js

@@ -1,7 +1,7 @@
 const GraphQLClient = require("graphql-request").GraphQLClient;
 
 const queries = require("../../graphql-client/queries");
-const CdkBase = require("../../web-sockets/web-socket");
+const WsLogger = require("../../web-sockets/createLogEvent");
 const moment = require("moment");
 const Dinero = require("dinero.js");
 const AxiosLib = require("axios").default;
@@ -23,7 +23,7 @@ axios.interceptors.request.use((x) => {
   } | ${JSON.stringify(x.data)} | ${JSON.stringify(headers)}`;
   //console.log(printable);
 
-  CdkBase.createJsonEvent(socket, "SILLY", `Raw Request: ${printable}`, x.data);
+  WsLogger.createJsonEvent(socket, "SILLY", `Raw Request: ${printable}`, x.data);
 
   return x;
 });
@@ -33,14 +33,14 @@ axios.interceptors.response.use((x) => {
 
   const printable = `${new Date()} | Response: ${x.status} | ${JSON.stringify(x.data)}`;
   //console.log(printable);
-  CdkBase.createJsonEvent(socket, "SILLY", `Raw Response: ${printable}`, x.data);
+  WsLogger.createJsonEvent(socket, "SILLY", `Raw Response: ${printable}`, x.data);
 
   return x;
 });
 
 async function PbsCalculateAllocationsAp(socket, billids) {
   try {
-    CdkBase.createLogEvent(socket, "DEBUG", `Received request to calculate allocations for ${billids}`);
+    WsLogger.createLogEvent(socket, "DEBUG", `Received request to calculate allocations for ${billids}`);
     const { bills, bodyshops } = await QueryBillData(socket, billids);
     const bodyshop = bodyshops[0];
     socket.bodyshop = bodyshop;
@@ -50,7 +50,7 @@ async function PbsCalculateAllocationsAp(socket, billids) {
 
     const transactionlist = [];
     if (bills.length === 0) {
-      CdkBase.createLogEvent(
+      WsLogger.createLogEvent(
         socket,
         "ERROR",
         `No bills found for export. Ensure they have not already been exported and try again.`
@@ -147,7 +147,9 @@ async function PbsCalculateAllocationsAp(socket, billids) {
             ...billHash[key],
             Amount: billHash[key].Amount.toFormat("0.00")
           });
-          APAmount = APAmount.add(billHash[key].Amount); //Calculate the total expense for the bill iteratively to create the corresponding credit to AP.
+          //Calculate the total expense for the bill iteratively to
+          // create the corresponding credit to AP.
+          APAmount = APAmount.add(billHash[key].Amount);
         }
       });
 
@@ -166,19 +168,21 @@ async function PbsCalculateAllocationsAp(socket, billids) {
 
     return transactionlist;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error encountered in PbsCalculateAllocationsAp. ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error encountered in PbsCalculateAllocationsAp. ${error}`);
   }
 }
 
 exports.PbsCalculateAllocationsAp = PbsCalculateAllocationsAp;
 
 async function QueryBillData(socket, billids) {
-  CdkBase.createLogEvent(socket, "DEBUG", `Querying bill data for id(s) ${billids}`);
+  WsLogger.createLogEvent(socket, "DEBUG", `Querying bill data for id(s) ${billids}`);
   const client = new GraphQLClient(process.env.GRAPHQL_ENDPOINT, {});
+
   const result = await client
     .setHeaders({ Authorization: `Bearer ${socket.handshake.auth.token}` })
     .request(queries.GET_PBS_AP_ALLOCATIONS, { billids: billids });
-  CdkBase.createLogEvent(socket, "SILLY", `Bill data query result ${JSON.stringify(result, null, 2)}`);
+
+  WsLogger.createLogEvent(socket, "SILLY", `Bill data query result ${JSON.stringify(result, null, 2)}`);
 
   return result;
 }
@@ -192,40 +196,10 @@ function getCostAccount(billline, respcenters) {
   return respcenters.costs.find((c) => c.name === acctName);
 }
 
-exports.PbsExportAp = async function (socket, { billids, txEnvelope }) {
-  CdkBase.createLogEvent(socket, "DEBUG", `Exporting selected AP.`);
-
-  //apAllocations has the same shap as the lines key for the accounting posting to PBS.
-  socket.apAllocations = await PbsCalculateAllocationsAp(socket, billids);
-  socket.txEnvelope = txEnvelope;
-  for (const allocation of socket.apAllocations) {
-    const { billid, ...restAllocation } = allocation;
-    const { data: AccountPostingChange } = await axios.post(PBS_ENDPOINTS.AccountingPostingChange, restAllocation, {
-      auth: PBS_CREDENTIALS,
-      socket
-    });
-
-    CheckForErrors(socket, AccountPostingChange);
-
-    if (AccountPostingChange.WasSuccessful) {
-      CdkBase.createLogEvent(socket, "DEBUG", `Marking bill as exported.`);
-      await MarkApExported(socket, [billid]);
-
-      socket.emit("ap-export-success", billid);
-    } else {
-      CdkBase.createLogEvent(socket, "ERROR", `Export was not successful.`);
-      socket.emit("ap-export-failure", {
-        billid,
-        error: AccountPostingChange.Message
-      });
-    }
-  }
-  socket.emit("ap-export-complete");
-};
-
 async function MarkApExported(socket, billids) {
-  CdkBase.createLogEvent(socket, "DEBUG", `Marking bills as exported for id ${billids}`);
+  WsLogger.createLogEvent(socket, "DEBUG", `Marking bills as exported for id ${billids}`);
   const client = new GraphQLClient(process.env.GRAPHQL_ENDPOINT, {});
+
   const result = await client
     .setHeaders({ Authorization: `Bearer ${socket.handshake.auth.token}` })
     .request(queries.MARK_BILLS_EXPORTED, {
@@ -244,3 +218,36 @@ async function MarkApExported(socket, billids) {
 
   return result;
 }
+
+const defaultHandler = async (socket, { billids, txEnvelope }) => {
+  WsLogger.createLogEvent(socket, "DEBUG", `Exporting selected AP.`);
+
+  //apAllocations has the same shap as the lines key for the accounting posting to PBS.
+  socket.apAllocations = await PbsCalculateAllocationsAp(socket, billids);
+  socket.txEnvelope = txEnvelope;
+  for (const allocation of socket.apAllocations) {
+    const { billid, ...restAllocation } = allocation;
+    const { data: AccountPostingChange } = await axios.post(PBS_ENDPOINTS.AccountingPostingChange, restAllocation, {
+      auth: PBS_CREDENTIALS,
+      socket
+    });
+
+    CheckForErrors(socket, AccountPostingChange);
+
+    if (AccountPostingChange.WasSuccessful) {
+      WsLogger.createLogEvent(socket, "DEBUG", `Marking bill as exported.`);
+      await MarkApExported(socket, [billid]);
+
+      socket.emit("ap-export-success", billid);
+    } else {
+      WsLogger.createLogEvent(socket, "ERROR", `Export was not successful.`);
+      socket.emit("ap-export-failure", {
+        billid,
+        error: AccountPostingChange.Message
+      });
+    }
+  }
+  socket.emit("ap-export-complete");
+};
+
+exports.PbsExportAp = defaultHandler;

server/accounting/pbs/pbs-job-export.js

@@ -2,10 +2,12 @@ const GraphQLClient = require("graphql-request").GraphQLClient;
 const AxiosLib = require("axios").default;
 const queries = require("../../graphql-client/queries");
 const { PBS_ENDPOINTS, PBS_CREDENTIALS } = require("./pbs-constants");
+const WsLogger = require("../../web-sockets/createLogEvent");
+const fs = require("fs");
+const path = require("path");
 
 //const { CDK_CREDENTIALS, CheckCdkResponseForError } = require("./cdk-wsdl");
 const CalculateAllocations = require("../../cdk/cdk-calculate-allocations").default;
-const CdkBase = require("../../web-sockets/web-socket");
 const moment = require("moment-timezone");
 const Dinero = require("dinero.js");
 const InstanceManager = require("../../utils/instanceMgr").default;
@@ -19,11 +21,12 @@ axios.interceptors.request.use((x) => {
     ...x.headers[x.method],
     ...x.headers
   };
-  const printable = `${new Date()} | Request: ${x.method.toUpperCase()} | ${x.url
+  const printable = `${new Date()} | Request: ${x.method.toUpperCase()} | ${
-    } | ${JSON.stringify(x.data)} | ${JSON.stringify(headers)}`;
+    x.url
+  } | ${JSON.stringify(x.data)} | ${JSON.stringify(headers)}`;
   //logRequestToFile(printable);
 
-  CdkBase.createJsonEvent(socket, "DEBUG", `Raw Request: ${printable}`, x.data);
+  WsLogger.createJsonEvent(socket, "DEBUG", `Raw Request: ${printable}`, x.data);
 
   return x;
 });
@@ -33,13 +36,11 @@ axios.interceptors.response.use((x) => {
 
   const printable = `${new Date()} | Response: ${x.status} ${x.statusText} |${JSON.stringify(x.data)}`;
   //logRequestToFile(printable);
-  CdkBase.createJsonEvent(socket, "DEBUG", `Raw Response: ${printable}`, x.data);
+  WsLogger.createJsonEvent(socket, "DEBUG", `Raw Response: ${printable}`, x.data);
 
   return x;
 });
 
-const fs = require('fs');
-const path = require("path");
 function logRequestToFile(printable) {
   try {
     const logDir = path.join(process.cwd(), "logs");
@@ -53,21 +54,20 @@ function logRequestToFile(printable) {
   }
 }
 
-
+const defaultHandler = async (socket, { txEnvelope, jobid }) => {
-exports.default = async function (socket, { txEnvelope, jobid }) {
   socket.logEvents = [];
   socket.recordid = jobid;
   socket.txEnvelope = txEnvelope;
   try {
-    CdkBase.createLogEvent(socket, "INFO", `Received Job export request for id ${jobid}`);
+    WsLogger.createLogEvent(socket, "INFO", `Received Job export request for id ${jobid}`);
 
     const JobData = await QueryJobData(socket, jobid);
     socket.JobData = JobData;
-    CdkBase.createLogEvent(socket, "INFO", `Querying the DMS for the Vehicle Record.`);
+    WsLogger.createLogEvent(socket, "INFO", `Querying the DMS for the Vehicle Record.`);
     //Query for the Vehicle record to get the associated customer.
     socket.DmsVeh = await QueryVehicleFromDms(socket);
     //Todo: Need to validate the lines and methods below.
-    if (socket.DmsVeh && socket.DmsVeh.CustomerRef) {
+    if (socket.DmsVeh?.CustomerRef) {
       //Get the associated customer from the Vehicle Record.
       socket.DMSVehCustomer = await QueryCustomerBycodeFromDms(socket, socket.DmsVeh.CustomerRef);
     }
@@ -78,35 +78,39 @@ exports.default = async function (socket, { txEnvelope, jobid }) {
       ...socket.DMSCustList
     ]);
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error encountered in PbsJobExport. ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error encountered in PbsJobExport. ${error}`);
   }
 };
 
+exports.default = defaultHandler;
+
 exports.PbsSelectedCustomer = async function PbsSelectedCustomer(socket, selectedCustomerId) {
   try {
     socket.selectedCustomerId = selectedCustomerId;
     if (socket.JobData.bodyshop.pbs_configuration.disablecontactvehicle !== true) {
-      CdkBase.createLogEvent(socket, "INFO", `User selected customer ${selectedCustomerId || "NEW"}`);
+      WsLogger.createLogEvent(socket, "INFO", `User selected customer ${selectedCustomerId || "NEW"}`);
 
       //Upsert the contact information as per Wafaa's Email.
-      CdkBase.createLogEvent(
+      WsLogger.createLogEvent(
         socket,
         "INFO",
-        `Upserting contact information to DMS for ${socket.JobData.ownr_fn || ""
+        `Upserting contact information to DMS for ${
+          socket.JobData.ownr_fn || ""
         } ${socket.JobData.ownr_ln || ""} ${socket.JobData.ownr_co_nm || ""}`
       );
       const ownerRef = await UpsertContactData(socket, selectedCustomerId);
       socket.ownerRef = ownerRef;
-      CdkBase.createLogEvent(socket, "INFO", `Upserting vehicle information to DMS for ${socket.JobData.v_vin}`);
+
+      WsLogger.createLogEvent(socket, "INFO", `Upserting vehicle information to DMS for ${socket.JobData.v_vin}`);
       const vehicleRef = await UpsertVehicleData(socket, ownerRef.ReferenceId);
       socket.vehicleRef = vehicleRef;
     } else {
-      CdkBase.createLogEvent(
+      WsLogger.createLogEvent(
         socket,
         "INFO",
         `Contact and Vehicle updates disabled. Querying data and skipping to accounting data insert.`
       );
-      //Must query for records to insert $0 RO. 
+      //Must query for records to insert $0 RO.
       if (!socket.ownerRef) {
         const ownerRef = (await QueryCustomerBycodeFromDms(socket, selectedCustomerId))?.[0];
         socket.ownerRef = ownerRef;
@@ -114,22 +118,21 @@ exports.PbsSelectedCustomer = async function PbsSelectedCustomer(socket, selecte
       const vehicleRef = await GetVehicleData(socket, socket.ownerRef?.ReferenceId || socket.selectedCustomerId);
       socket.vehicleRef = vehicleRef;
     }
-    CdkBase.createLogEvent(socket, "INFO", `Inserting accounting posting data..`);
+    WsLogger.createLogEvent(socket, "INFO", `Inserting account posting data...`);
     const insertResponse = await InsertAccountPostingData(socket);
 
     if (insertResponse.WasSuccessful) {
       if (socket.JobData.bodyshop.pbs_configuration.ro_posting) {
-
+        await CreateRepairOrderInPBS(socket, socket.ownerRef, socket.vehicleRef);
-        await CreateRepairOrderInPBS(socket, socket.ownerRef, socket.vehicleRef)
       }
-      CdkBase.createLogEvent(socket, "INFO", `Marking job as exported.`);
+      WsLogger.createLogEvent(socket, "INFO", `Marking job as exported.`);
       await MarkJobExported(socket, socket.JobData.id);
       socket.emit("export-success", socket.JobData.id);
     } else {
-      CdkBase.createLogEvent(socket, "ERROR", `Export was not successful.`);
+      WsLogger.createLogEvent(socket, "ERROR", `Export was not successful.`);
     }
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error encountered in PbsSelectedCustomer. ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error encountered in PbsSelectedCustomer. ${error}`);
     await InsertFailedExportLog(socket, error);
   }
 };
@@ -137,22 +140,24 @@ exports.PbsSelectedCustomer = async function PbsSelectedCustomer(socket, selecte
 // Was Successful
 async function CheckForErrors(socket, response) {
   if (response.WasSuccessful === undefined || response.WasSuccessful === true) {
-    CdkBase.createLogEvent(socket, "INFO", `Successful response from DMS. ${response.Message || ""}`);
+    WsLogger.createLogEvent(socket, "INFO", `Successful response from DMS. ${response.Message || ""}`);
   } else {
-    CdkBase.createLogEvent(socket, "ERROR", `Error received from DMS: ${response.Message}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error received from DMS: ${response.Message}`);
-    CdkBase.createLogEvent(socket, "DEBUG", `Error received from DMS: ${JSON.stringify(response)}`);
+    WsLogger.createLogEvent(socket, "DEBUG", `Error received from DMS: ${JSON.stringify(response)}`);
   }
 }
 
 exports.CheckForErrors = CheckForErrors;
 
 async function QueryJobData(socket, jobid) {
-  CdkBase.createLogEvent(socket, "INFO", `Querying job data for id ${jobid}`);
+  WsLogger.createLogEvent(socket, "INFO", `Querying job data for id ${jobid}`);
   const client = new GraphQLClient(process.env.GRAPHQL_ENDPOINT, {});
+
   const result = await client
     .setHeaders({ Authorization: `Bearer ${socket.handshake.auth.token}` })
     .request(queries.QUERY_JOBS_FOR_PBS_EXPORT, { id: jobid });
-  CdkBase.createLogEvent(socket, "DEBUG", `Job data query result ${JSON.stringify(result, null, 2)}`);
+
+  //WsLogger.createLogEvent(socket, "DEBUG", `Job data query result ${JSON.stringify(result, null, 2)}`);
   return result.jobs_by_pk;
 }
 
@@ -191,7 +196,7 @@ async function QueryVehicleFromDms(socket) {
     CheckForErrors(socket, VehicleGetResponse);
     return VehicleGetResponse;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in QueryVehicleFromDms - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in QueryVehicleFromDms - ${error}`);
     throw new Error(error);
   }
 }
@@ -220,9 +225,9 @@ async function QueryCustomersFromDms(socket) {
       { auth: PBS_CREDENTIALS, socket }
     );
     CheckForErrors(socket, CustomerGetResponse);
-    return CustomerGetResponse && CustomerGetResponse.Contacts;
+    return CustomerGetResponse?.Contacts;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in QueryCustomersFromDms - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in QueryCustomersFromDms - ${error}`);
     throw new Error(error);
   }
 }
@@ -253,9 +258,9 @@ async function QueryCustomerBycodeFromDms(socket, CustomerRef) {
       { auth: PBS_CREDENTIALS, socket }
     );
     CheckForErrors(socket, CustomerGetResponse);
-    return CustomerGetResponse && CustomerGetResponse.Contacts;
+    return CustomerGetResponse?.Contacts;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in QueryCustomersFromDms - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in QueryCustomersFromDms - ${error}`);
     throw new Error(error);
   }
 }
@@ -272,15 +277,15 @@ async function UpsertContactData(socket, selectedCustomerId) {
           Code: socket.JobData.owner.accountingid,
           ...(socket.JobData.ownr_co_nm
             ? {
-              //LastName: socket.JobData.ownr_ln,
+                //LastName: socket.JobData.ownr_ln,
-              FirstName: socket.JobData.ownr_co_nm,
+                FirstName: socket.JobData.ownr_co_nm,
-              IsBusiness: true
+                IsBusiness: true
-            }
+              }
             : {
-              LastName: socket.JobData.ownr_ln,
+                LastName: socket.JobData.ownr_ln,
-              FirstName: socket.JobData.ownr_fn,
+                FirstName: socket.JobData.ownr_fn,
-              IsBusiness: false
+                IsBusiness: false
-            }),
+              }),
 
           //Salutation: "String",
           //MiddleName: "String",
@@ -337,7 +342,7 @@ async function UpsertContactData(socket, selectedCustomerId) {
     CheckForErrors(socket, ContactChangeResponse);
     return ContactChangeResponse;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in UpsertContactData - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in UpsertContactData - ${error}`);
     throw new Error(error);
   }
 }
@@ -357,10 +362,10 @@ async function UpsertVehicleData(socket, ownerRef) {
           //FleetNumber: "String",
           //Status: "String",
           OwnerRef: ownerRef, // "00000000000000000000000000000000",
-          // ModelNumber: socket.JobData.vehicle && socket.JobData.vehicle.v_makecode,
+          // ModelNumber: socket.JobData.vehicle?.v_makecode,
           Make: socket.JobData.v_make_desc,
           Model: socket.JobData.v_model_desc,
-          Trim: socket.JobData.vehicle && socket.JobData.vehicle.v_trimcode,
+          Trim: socket.JobData.vehicle?.v_trimcode,
           //VehicleType: "String",
           Year: socket.JobData.v_model_yr,
           Odometer: socket.JobData.kmout,
@@ -490,14 +495,16 @@ async function UpsertVehicleData(socket, ownerRef) {
     CheckForErrors(socket, VehicleChangeResponse);
     return VehicleChangeResponse;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in UpsertVehicleData - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in UpsertVehicleData - ${error}`);
     throw new Error(error);
   }
 }
 
 async function GetVehicleData(socket, ownerRef) {
   try {
-    const { data: { Vehicles } } = await axios.post(
+    const {
+      data: { Vehicles }
+    } = await axios.post(
       PBS_ENDPOINTS.VehicleGet,
       {
         SerialNumber: socket.JobData.bodyshop.pbs_serialnumber,
@@ -510,7 +517,7 @@ async function GetVehicleData(socket, ownerRef) {
         // "Trim": "String",
         // "ModelNumber": "String",
         // "StockNumber": "String",
-        VIN: socket.JobData.v_vin,
+        VIN: socket.JobData.v_vin
         // "LicenseNumber": "String",
         // "Lot": "String",
         // "Status": "String",
@@ -528,24 +535,21 @@ async function GetVehicleData(socket, ownerRef) {
         // "LotAccessDivisions": [0],
         // "OdometerTo": 0,
         // "OdometerFrom": 0
-      }
+      },
-      ,
       { auth: PBS_CREDENTIALS, socket }
     );
     CheckForErrors(socket, Vehicles);
     if (Vehicles.length === 1) {
       return Vehicles[0];
-
     } else {
-      CdkBase.createLogEvent(socket, "ERROR", `Error in Getting Vehicle Data - ${Vehicles.length} vehicle(s) found`);
+      WsLogger.createLogEvent(socket, "ERROR", `Error in Getting Vehicle Data - ${Vehicles.length} vehicle(s) found`);
     }
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in UpsertVehicleData - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in UpsertVehicleData - ${error}`);
     throw new Error(error);
   }
 }
 
-
 async function InsertAccountPostingData(socket) {
   try {
     const allocations = await CalculateAllocations(socket, socket.JobData.id);
@@ -629,7 +633,8 @@ async function InsertAccountPostingData(socket) {
         Posting: {
           Reference: socket.JobData.ro_number,
           JournalCode: socket.txEnvelope.journal,
-          TransactionDate: moment(socket.JobData.date_invoiced).tz(socket.JobData.bodyshop.timezone).toISOString(), //"0001-01-01T00:00:00.0000000Z",
+          //Sample TransactionDate: "0001-01-01T00:00:00.0000000Z",
+          TransactionDate: moment(socket.JobData.date_invoiced).tz(socket.JobData.bodyshop.timezone).toISOString(),
           Description: socket.txEnvelope.story,
           //AdditionalInfo: "String",
           Source: InstanceManager({ imex: "ImEX Online", rome: "Rome Online" }),
@@ -642,14 +647,15 @@ async function InsertAccountPostingData(socket) {
     CheckForErrors(socket, AccountPostingChange);
     return AccountPostingChange;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in InsertAccountPostingData - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in InsertAccountPostingData - ${error}`);
     throw new Error(error);
   }
 }
 
 async function MarkJobExported(socket, jobid) {
-  CdkBase.createLogEvent(socket, "INFO", `Marking job as exported for id ${jobid}`);
+  WsLogger.createLogEvent(socket, "INFO", `Marking job as exported for id ${jobid}`);
   const client = new GraphQLClient(process.env.GRAPHQL_ENDPOINT, {});
+
   const result = await client
     .setHeaders({ Authorization: `Bearer ${socket.handshake.auth.token}` })
     .request(queries.MARK_JOB_EXPORTED, {
@@ -677,47 +683,52 @@ async function MarkJobExported(socket, jobid) {
 async function InsertFailedExportLog(socket, error) {
   try {
     const client = new GraphQLClient(process.env.GRAPHQL_ENDPOINT, {});
+
     const result = await client
       .setHeaders({ Authorization: `Bearer ${socket.handshake.auth.token}` })
       .request(queries.INSERT_EXPORT_LOG, {
-        log: {
+        logs: [{
           bodyshopid: socket.JobData.bodyshop.id,
           jobid: socket.JobData.id,
           successful: false,
           message: JSON.stringify(error),
           useremail: socket.user.email
-        }
+        }]
       });
 
     return result;
   } catch (error2) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in InsertFailedExportLog - ${error} - ${JSON.stringify(error2)}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in InsertFailedExportLog - ${error} - ${JSON.stringify(error2)}`);
   }
 }
 
-
 async function CreateRepairOrderInPBS(socket) {
   try {
     const { RepairOrders } = await RepairOrderGet(socket);
     if (RepairOrders.length === 0) {
-      const InsertedRepairOrder = await RepairOrderChange(socket)
+      const InsertedRepairOrder = await RepairOrderChange(socket);
       socket.InsertedRepairOrder = InsertedRepairOrder;
-      CdkBase.createLogEvent(socket, "INFO", `No repair orders found for vehicle. Inserting record.`);
+      WsLogger.createLogEvent(socket, "INFO", `No repair orders found for vehicle. Inserting record.`);
-
     } else if (RepairOrders.length > 0) {
-      //Find out if it's a matching RO. 
+      //Find out if it's a matching RO.
-      //This logic is used because the integration will simply add another line to an open RO if it exists. 
+      //This logic is used because the integration will simply add another line to an open RO if it exists.
-      const matchingRo = RepairOrders.find(ro => ro.Memo?.toLowerCase()?.includes(socket.JobData.ro_number.toLowerCase()))
+      const matchingRo = RepairOrders.find((ro) =>
+        ro.Memo?.toLowerCase()?.includes(socket.JobData.ro_number.toLowerCase())
+      );
       if (!matchingRo) {
-        CdkBase.createLogEvent(socket, "INFO", `ROs found for vehicle, but none match. Inserting record.`);
+        WsLogger.createLogEvent(socket, "INFO", `ROs found for vehicle, but none match. Inserting record.`);
-        const InsertedRepairOrder = await RepairOrderChange(socket)
+        const InsertedRepairOrder = await RepairOrderChange(socket);
         socket.InsertedRepairOrder = InsertedRepairOrder;
       } else {
-        CdkBase.createLogEvent(socket, "WARN", `Repair order appears to already exist in PBS. ${matchingRo.RepairOrderNumber}`);
+        WsLogger.createLogEvent(
+          socket,
+          "WARN",
+          `Repair order appears to already exist in PBS. ${matchingRo.RepairOrderNumber}`
+        );
       }
     }
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in CreateRepairOrderInPBS - ${error} - ${JSON.stringify(error)}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in CreateRepairOrderInPBS - ${error} - ${JSON.stringify(error)}`);
   }
 }
 
@@ -733,7 +744,7 @@ async function RepairOrderGet(socket) {
         // "Tag": "String",
         //"ContactRef": socket.contactRef,
         // "ContactRefList": ["00000000000000000000000000000000"],
-        "VehicleRef": socket.vehicleRef?.ReferenceId || socket.vehicleRef?.VehicleId,
+        VehicleRef: socket.vehicleRef?.ReferenceId || socket.vehicleRef?.VehicleId
         // "VehicleRefList": ["00000000000000000000000000000000"],
         // "Status": "String",
         // "CashieredSince": "0001-01-01T00:00:00.0000000Z",
@@ -749,7 +760,7 @@ async function RepairOrderGet(socket) {
     CheckForErrors(socket, RepairOrderGet);
     return RepairOrderGet;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in RepairOrderChange - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in RepairOrderChange - ${error}`);
     throw new Error(error);
   }
 }
@@ -758,31 +769,32 @@ async function RepairOrderChange(socket) {
   try {
     const { data: RepairOrderChangeResponse } = await axios.post(
       PBS_ENDPOINTS.RepairOrderChange,
-      { //Additional details at https://partnerhub.pbsdealers.com/json/metadata?op=RepairOrderChange
+      {
-        "RepairOrderInfo": {
+        //Additional details at https://partnerhub.pbsdealers.com/json/metadata?op=RepairOrderChange
+        RepairOrderInfo: {
           //"Id": "string/00000000-0000-0000-0000-000000000000",
           //"RepairOrderId": "00000000000000000000000000000000",
           SerialNumber: socket.JobData.bodyshop.pbs_serialnumber,
-          "RepairOrderNumber": "00000000000000000000000000000000", //This helps force a new RO. 
+          RepairOrderNumber: "00000000000000000000000000000000", //This helps force a new RO.
-          "RawRepairOrderNumber": "00000000000000000000000000000000",
+          RawRepairOrderNumber: "00000000000000000000000000000000",
           // "RepairOrderNumber": socket.JobData.ro_number, //These 2 values are ignored as confirmed by PBS.
           // "RawRepairOrderNumber": socket.JobData.ro_number,
-          "DateOpened": moment(),
+          DateOpened: moment(),
           // "DateOpenedUTC": "0001-01-01T00:00:00.0000000Z",
           // "DateCashiered": "0001-01-01T00:00:00.0000000Z",
           // "DateCashieredUTC": "0001-01-01T00:00:00.0000000Z",
-          "DatePromised": socket.JobData.scheduled_completion,
+          DatePromised: socket.JobData.scheduled_completion,
           // "DatePromisedUTC": "0001-01-01T00:00:00.0000000Z",
-          "DateVehicleCompleted": socket.JobData.actual_completion,
+          DateVehicleCompleted: socket.JobData.actual_completion,
           // "DateCustomerNotified": "0001-01-01T00:00:00.0000000Z",
           // "CSR": "String",
           // "CSRRef": "00000000000000000000000000000000",
           // "BookingUser": "String",
           // "BookingUserRef": "00000000000000000000000000000000",
-          "ContactRef": socket.ownerRef?.ReferenceId || socket.ownerRef?.ContactId,
+          ContactRef: socket.ownerRef?.ReferenceId || socket.ownerRef?.ContactId,
-          "VehicleRef": socket.vehicleRef?.ReferenceId || socket.vehicleRef?.VehicleId,
+          VehicleRef: socket.vehicleRef?.ReferenceId || socket.vehicleRef?.VehicleId,
-          "MileageIn": socket.JobData.km_in,
+          MileageIn: socket.JobData.km_in,
-          "Tag": "BODYSHOP",
+          Tag: "BODYSHOP",
           //"Status": "CLOSED", //Values here do not impact the status. Confirmed by PBS support.
           Requests: [
             {
@@ -791,61 +803,59 @@ async function RepairOrderChange(socket) {
               // "CSR": "PBS",
               // "CSRRef": "1ce12ac692564e94bda955d529ee911a",
               // "Skill": "GEN",
-              "RequestCode": "MISC",
+              RequestCode: "MISC",
-              "RequestDescription": `VEHICLE REPAIRED AT BODYSHOP. PLEASE REFERENCE IMEX SHOP MANAGEMENT SYSTEM. ${socket.txEnvelope.story}`,
+              RequestDescription: `VEHICLE REPAIRED AT BODYSHOP. PLEASE REFERENCE IMEX SHOP MANAGEMENT SYSTEM. ${socket.txEnvelope.story}`,
-              "Status": "Completed",
+              Status: "Completed",
               // "TechRef": "00000000000000000000000000000000",
-              "AllowedHours": 0,
+              AllowedHours: 0,
-              "EstimateLabour": 0,
+              EstimateLabour: 0,
-              "EstimateParts": 0,
+              EstimateParts: 0,
-              "ComeBack": false,
+              ComeBack: false,
-              "AddedOperation": true,
+              AddedOperation: true,
-              "PartLines": [],
+              PartLines: [],
-              "PartRequestLines": [],
+              PartRequestLines: [],
-              "LabourLines": [],
+              LabourLines: [],
-              "SubletLines": [],
+              SubletLines: [],
-              "TimePunches": [],
+              TimePunches: [],
-              "Summary": {
+              Summary: {
-                "Labour": 0,
+                Labour: 0,
-                "Parts": 0,
+                Parts: 0,
-                "OilGas": 0,
+                OilGas: 0,
-                "SubletTow": 0,
+                SubletTow: 0,
-                "Misc": 0,
+                Misc: 0,
-                "Environment": 0,
+                Environment: 0,
-                "ShopSupplies": 0,
+                ShopSupplies: 0,
-                "Freight": 0,
+                Freight: 0,
-                "WarrantyDeductible": 0,
+                WarrantyDeductible: 0,
-                "Discount": 0,
+                Discount: 0,
-                "SubTotal": 0,
+                SubTotal: 0,
-                "Tax1": 0,
+                Tax1: 0,
-                "Tax2": 0,
+                Tax2: 0,
-                "InvoiceTotal": 0,
+                InvoiceTotal: 0,
-                "CustomerDeductible": 0,
+                CustomerDeductible: 0,
-                "GrandTotal": 0,
+                GrandTotal: 0,
-                "LabourDiscount": 0,
+                LabourDiscount: 0,
-                "PartDiscount": 0,
+                PartDiscount: 0,
-                "ServiceFeeTotal": 0,
+                ServiceFeeTotal: 0,
-                "OEMDiscount": 0
+                OEMDiscount: 0
               },
-              "LineType": "RequestLine",
+              LineType: "RequestLine"
-            },
+            }
           ],
 
-          "Memo": socket.txEnvelope.story,
+          Memo: socket.txEnvelope.story
-
         },
-        "IsAsynchronous": false,
+        IsAsynchronous: false
         // "UserRequest": "String",
         // "UserRef": "00000000000000000000000000000000"
-      }
+      },
 
-      ,
       { auth: PBS_CREDENTIALS, socket }
     );
     CheckForErrors(socket, RepairOrderChangeResponse);
     return RepairOrderChangeResponse;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in RepairOrderChange - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in RepairOrderChange - ${error}`);
     throw new Error(error);
   }
-}
+}

server/cdk/cdk-calculate-allocations.js

@@ -1,10 +1,11 @@
 const GraphQLClient = require("graphql-request").GraphQLClient;
 
 const queries = require("../graphql-client/queries");
-const CdkBase = require("../web-sockets/web-socket");
+const CreateFortellisLogEvent = require("../fortellis/fortellis-logger");
-
 const Dinero = require("dinero.js");
 const _ = require("lodash");
+const WsLogger = require("../web-sockets/createLogEvent");
+
 const InstanceManager = require("../utils/instanceMgr").default;
 const { DiscountNotAlreadyCounted } = InstanceManager({
   imex: require("../job/job-totals"),
@@ -13,37 +14,40 @@ const { DiscountNotAlreadyCounted } = InstanceManager({
 
 exports.defaultRoute = async function (req, res) {
   try {
-    CdkBase.createLogEvent(req, "DEBUG", `Received request to calculate allocations for ${req.body.jobid}`);
+    WsLogger.createLogEvent(req, "DEBUG", `Received request to calculate allocations for ${req.body.jobid}`);
     const jobData = await QueryJobData(req, req.BearerToken, req.body.jobid);
     return res.status(200).json({ data: calculateAllocations(req, jobData) });
   } catch (error) {
-    ////console.log(error);
+    WsLogger.createLogEvent(req, "ERROR", `Error encountered in CdkCalculateAllocations. ${error}`);
-    CdkBase.createLogEvent(req, "ERROR", `Error encountered in CdkCalculateAllocations. ${error}`);
+    WsLogger.createLogEvent(req, "ERROR", `Error encountered in CdkCalculateAllocations. ${error.stack}`);
     res.status(500).json({ error: `Error encountered in CdkCalculateAllocations. ${error}` });
   }
 };
 
-exports.default = async function (socket, jobid) {
+exports.default = async function (socket, jobid, isFortellis = false) {
   try {
-    const jobData = await QueryJobData(socket, "Bearer " + socket.handshake.auth.token, jobid);
+    const jobData = await QueryJobData(socket, "Bearer " + socket.handshake.auth.token, jobid, isFortellis);
-    return calculateAllocations(socket, jobData);
+    return calculateAllocations(socket, jobData, isFortellis);
   } catch (error) {
-    ////console.log(error);
+    const loggingFunction = isFortellis ? CreateFortellisLogEvent : WsLogger.createLogEvent;
-    CdkBase.createLogEvent(socket, "ERROR", `Error encountered in CdkCalculateAllocations. ${error}`);
+    loggingFunction(socket, "ERROR", `Error encountered in CdkCalculateAllocations. ${error}`);
+    loggingFunction(socket, "ERROR", `Error encountered in CdkCalculateAllocations. ${error.stack}`);
   }
 };
 
-async function QueryJobData(connectionData, token, jobid) {
+async function QueryJobData(connectionData, token, jobid, isFortellis) {
-  CdkBase.createLogEvent(connectionData, "DEBUG", `Querying job data for id ${jobid}`);
+  const loggingFunction = isFortellis ? CreateFortellisLogEvent : WsLogger.createLogEvent;
+
+  loggingFunction(connectionData, "DEBUG", `Querying job data for id ${jobid}`);
   const client = new GraphQLClient(process.env.GRAPHQL_ENDPOINT, {});
   const result = await client.setHeaders({ Authorization: token }).request(queries.GET_CDK_ALLOCATIONS, { id: jobid });
-  CdkBase.createLogEvent(connectionData, "SILLY", `Job data query result ${JSON.stringify(result, null, 2)}`);
+  //loggingFunction(connectionData, "DEBUG", `Job data query result ${JSON.stringify(result, null, 2)}`);
   return result.jobs_by_pk;
 }
 
-function calculateAllocations(connectionData, job) {
+function calculateAllocations(connectionData, job, isFortellis) {
   const { bodyshop } = job;
-
+  const loggingFunction = isFortellis ? CreateFortellisLogEvent : WsLogger.createLogEvent;
   const taxAllocations = InstanceManager({
     executeFunction: true,
     deubg: true,
@@ -159,7 +163,7 @@ function calculateAllocations(connectionData, job) {
   const selectedDmsAllocationConfig = bodyshop.md_responsibility_centers.dms_defaults.find(
     (d) => d.name === job.dms_allocation
   );
-  CdkBase.createLogEvent(
+  loggingFunction(
     connectionData,
     "DEBUG",
     `Using DMS Allocation ${selectedDmsAllocationConfig && selectedDmsAllocationConfig.name} for cost export.`
@@ -360,10 +364,10 @@ function calculateAllocations(connectionData, job) {
           Dinero(job.job_totals.parts.adjustments[key])
         );
       } else {
-        CdkBase.createLogEvent(
+        loggingFunction(
           connectionData,
           "ERROR",
-          `Error encountered in CdkCalculateAllocations. Unable to find adjustment account. ${error}`
+          `Error encountered in CdkCalculateAllocations. Unable to find adjustment account: ${accountName}`
         );
       }
     });
@@ -383,10 +387,10 @@ function calculateAllocations(connectionData, job) {
             Dinero(job.job_totals.rates[key].adjustments)
           );
         } else {
-          CdkBase.createLogEvent(
+          loggingFunction(
             connectionData,
             "ERROR",
-            `Error encountered in CdkCalculateAllocations. Unable to find adjustment account. ${error}`
+            `Error encountered in CdkCalculateAllocations. Unable to find adjustment account: ${accountName}`
           );
         }
       }

server/cdk/cdk-get-makes.js

@@ -5,6 +5,12 @@ const CdkWsdl = require("./cdk-wsdl").default;
 const logger = require("../utils/logger");
 
 const { CDK_CREDENTIALS, CheckCdkResponseForError } = require("./cdk-wsdl");
+const {
+  MakeFortellisCall,
+  FortellisActions,
+  GetAuthToken,
+  GetDepartmentId
+} = require("../fortellis/fortellis-helpers");
 
 // exports.default = async function (socket, cdk_dealerid) {
 //   try {
@@ -105,3 +111,85 @@ async function GetCdkMakes(req, cdk_dealerid) {
     throw new Error(error);
   }
 }
+
+async function GetFortellisMakes(req, cdk_dealerid) {
+  logger.log("fortellis-replace-makes-models", "DEBUG", req.user.email, null, {
+    cdk_dealerid
+  });
+  try {
+    const result = await MakeFortellisCall({
+      ...FortellisActions.GetMakeModel,
+      headers: {},
+      redisHelpers: {
+        setSessionTransactionData: () => {
+          return null;
+        },
+        getSessionTransactionData: () => {
+          return null;
+        }
+      },
+      socket: { emit: () => null },
+      jobid: null,
+      body: {},
+      SubscriptionObject: {
+        SubscriptionID: cdk_dealerid
+      }
+    });
+
+    logger.log("fortellis-replace-makes-models-response", "ERROR", req.user.email, null, {
+      cdk_dealerid,
+      xml: result
+    });
+    return result.data;
+  } catch (error) {
+    logger.log("fortellis-replace-makes-models-error", "ERROR", req.user.email, null, {
+      cdk_dealerid,
+      error
+    });
+
+    throw new Error(error);
+  }
+}
+
+exports.fortellis = async function ReloadFortellisMakes(req, res) {
+  const { bodyshopid, cdk_dealerid } = req.body;
+  try {
+    //Query all CDK Models
+    const newList = await GetFortellisMakes(req, cdk_dealerid);
+
+    const BearerToken = req.BearerToken;
+    const client = req.userGraphQLClient;
+
+    const deleteResult = await client
+      .setHeaders({ Authorization: BearerToken })
+      .request(queries.DELETE_ALL_DMS_VEHICLES, {});
+
+    //Insert the new ones.
+
+    const insertResult = await client.setHeaders({ Authorization: BearerToken }).request(queries.INSERT_DMS_VEHICLES, {
+      vehicles: newList.map((i) => {
+        return {
+          bodyshopid,
+          makecode: i.makeCode,
+          modelcode: i.modelCode,
+          make: i.makeFullName,
+          model: i.modelFullName
+        };
+      })
+    });
+
+    logger.log("fortellis-replace-makes-models-success", "DEBUG", req.user.email, null, {
+      cdk_dealerid,
+      count: newList.length
+    });
+
+    res.sendStatus(200);
+  } catch (error) {
+    logger.log("fortellis-replace-makes-models-error", "ERROR", req.user.email, null, {
+      cdk_dealerid,
+      error: error.message,
+      stack: error.stack
+    });
+    res.status(500).json(error);
+  }
+};

server/cdk/cdk-job-export.js

@@ -1,33 +1,36 @@
 const GraphQLClient = require("graphql-request").GraphQLClient;
 const soap = require("soap");
 const queries = require("../graphql-client/queries");
-const CdkBase = require("../web-sockets/web-socket");
 const CdkWsdl = require("./cdk-wsdl").default;
 const { CDK_CREDENTIALS, CheckCdkResponseForError } = require("./cdk-wsdl");
 const CalcualteAllocations = require("./cdk-calculate-allocations").default;
 const InstanceMgr = require("../utils/instanceMgr").default;
+const WsLogger = require("../web-sockets/createLogEvent");
 
 const moment = require("moment-timezone");
 
 const replaceSpecialRegex = /[^a-zA-Z0-9 .,\n #]+/g;
 
-exports.default = async function (socket, { txEnvelope, jobid }) {
+const defaultHandler = async (socket, { txEnvelope, jobid }) => {
+  ////Store the following information into the redis store for this transaction.
   socket.logEvents = [];
   socket.recordid = jobid;
   socket.txEnvelope = txEnvelope;
+  ////
+
   try {
-    CdkBase.createLogEvent(socket, "DEBUG", `Received Job export request for id ${jobid}`);
+    WsLogger.createLogEvent(socket, "DEBUG", `Received Job export request for id ${jobid}`);
 
     const JobData = await QueryJobData(socket, jobid);
     socket.JobData = JobData;
     const DealerId = JobData.bodyshop.cdk_dealerid;
-    CdkBase.createLogEvent(socket, "DEBUG", `Dealer ID detected: ${JSON.stringify(DealerId)}`);
+    WsLogger.createLogEvent(socket, "DEBUG", `Dealer ID detected: ${JSON.stringify(DealerId)}`);
 
-    CdkBase.createLogEvent(socket, "DEBUG", `{1} Begin Calculate DMS Vehicle ID using VIN: ${JobData.v_vin}`);
+    WsLogger.createLogEvent(socket, "DEBUG", `{1} Begin Calculate DMS Vehicle ID using VIN: ${JobData.v_vin}`);
     socket.DMSVid = await CalculateDmsVid(socket, JobData);
 
     if (socket.DMSVid.newId === "N") {
-      CdkBase.createLogEvent(
+      WsLogger.createLogEvent(
         socket,
         "DEBUG",
         `{2.1} Querying the Vehicle using the DMSVid: ${socket.DMSVid.vehiclesVehId}`
@@ -35,10 +38,10 @@ exports.default = async function (socket, { txEnvelope, jobid }) {
       socket.DMSVeh = await QueryDmsVehicleById(socket, JobData, socket.DMSVid);
 
       const DMSVehCustomer =
-        socket.DMSVeh && socket.DMSVeh.owners && socket.DMSVeh.owners.find((o) => o.id.assigningPartyId === "CURRENT");
+        socket.DMSVeh?.owners && socket.DMSVeh.owners.find((o) => o.id.assigningPartyId === "CURRENT");
 
-      if (DMSVehCustomer && DMSVehCustomer.id && DMSVehCustomer.id.value) {
+      if (DMSVehCustomer?.id && DMSVehCustomer.id.value) {
-        CdkBase.createLogEvent(
+        WsLogger.createLogEvent(
           socket,
           "DEBUG",
           `{2.2} Querying the Customer using the ID from DMSVeh: ${DMSVehCustomer.id.value}`
@@ -47,7 +50,7 @@ exports.default = async function (socket, { txEnvelope, jobid }) {
       }
     }
 
-    CdkBase.createLogEvent(socket, "DEBUG", `{2.3} Querying the Customer using the name.`);
+    WsLogger.createLogEvent(socket, "DEBUG", `{2.3} Querying the Customer using the name.`);
 
     socket.DMSCustList = await QueryDmsCustomerByName(socket, JobData);
 
@@ -56,43 +59,48 @@ exports.default = async function (socket, { txEnvelope, jobid }) {
       ...socket.DMSCustList
     ]);
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error encountered in CdkJobExport. ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error encountered in CdkJobExport. ${error}`);
   }
 };
+exports.default = defaultHandler;
 
 async function CdkSelectedCustomer(socket, selectedCustomerId) {
   try {
     socket.selectedCustomerId = selectedCustomerId;
     if (selectedCustomerId) {
-      CdkBase.createLogEvent(socket, "DEBUG", `{3.1} Querying the Customer using Customer ID: ${selectedCustomerId}`);
+      WsLogger.createLogEvent(socket, "DEBUG", `{3.1} Querying the Customer using Customer ID: ${selectedCustomerId}`);
       socket.DMSCust = await QueryDmsCustomerById(socket, socket.JobData, selectedCustomerId);
     } else {
-      CdkBase.createLogEvent(socket, "DEBUG", `{3.2} Generating a new customer ID.`);
+      WsLogger.createLogEvent(socket, "DEBUG", `{3.2} Generating a new customer ID.`);
       const newCustomerId = await GenerateDmsCustomerNumber(socket);
-      CdkBase.createLogEvent(socket, "DEBUG", `{3.3} Inserting new customer with ID: ${newCustomerId}`);
+      WsLogger.createLogEvent(socket, "DEBUG", `{3.3} Inserting new customer with ID: ${newCustomerId}`);
       socket.DMSCust = await InsertDmsCustomer(socket, newCustomerId);
     }
 
     if (socket.DMSVid.newId === "Y") {
-      CdkBase.createLogEvent(socket, "DEBUG", `{4.1} Inserting new vehicle with ID: ID ${socket.DMSVid.vehiclesVehId}`);
+      WsLogger.createLogEvent(
+        socket,
+        "DEBUG",
+        `{4.1} Inserting new vehicle with ID: ID ${socket.DMSVid.vehiclesVehId}`
+      );
       socket.DMSVeh = await InsertDmsVehicle(socket);
     } else {
-      CdkBase.createLogEvent(
+      WsLogger.createLogEvent(
         socket,
         "DEBUG",
         `{4.2} Querying Existing Vehicle using ID ${socket.DMSVid.vehiclesVehId}`
       );
       socket.DMSVeh = await QueryDmsVehicleById(socket, socket.JobData, socket.DMSVid);
-      CdkBase.createLogEvent(socket, "DEBUG", `{4.3} Updating Existing Vehicle to associate to owner.`);
+      WsLogger.createLogEvent(socket, "DEBUG", `{4.3} Updating Existing Vehicle to associate to owner.`);
       socket.DMSVeh = await UpdateDmsVehicle(socket);
     }
 
-    CdkBase.createLogEvent(socket, "DEBUG", `{5} Creating Transaction header with Dms Start WIP`);
+    WsLogger.createLogEvent(socket, "DEBUG", `{5} Creating Transaction header with Dms Start WIP`);
     socket.DMSTransHeader = await InsertDmsStartWip(socket);
-    CdkBase.createLogEvent(socket, "DEBUG", `{5.1} Creating Transaction with ID ${socket.DMSTransHeader.transID}`);
+    WsLogger.createLogEvent(socket, "DEBUG", `{5.1} Creating Transaction with ID ${socket.DMSTransHeader.transID}`);
 
     socket.DMSBatchTxn = await InsertDmsBatchWip(socket);
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "DEBUG",
       `{6} Attempting to post Transaction with ID ${socket.DMSTransHeader.transID}`
@@ -100,23 +108,23 @@ async function CdkSelectedCustomer(socket, selectedCustomerId) {
     socket.DmsBatchTxnPost = await PostDmsBatchWip(socket);
     if (socket.DmsBatchTxnPost.code === "success") {
       //something
-      CdkBase.createLogEvent(socket, "DEBUG", `{6} Successfully posted sransaction to DMS.`);
+      WsLogger.createLogEvent(socket, "DEBUG", `{6} Successfully posted sransaction to DMS.`);
 
       await MarkJobExported(socket, socket.JobData.id);
 
-      CdkBase.createLogEvent(socket, "DEBUG", `{5} Updating Service Vehicle History.`);
+      WsLogger.createLogEvent(socket, "DEBUG", `{5} Updating Service Vehicle History.`);
       socket.DMSVehHistory = await InsertServiceVehicleHistory(socket);
       socket.emit("export-success", socket.JobData.id);
     } else {
       //Get the error code
-      CdkBase.createLogEvent(
+      WsLogger.createLogEvent(
         socket,
         "DEBUG",
         `{6.1} Getting errors for Transaction ID ${socket.DMSTransHeader.transID}`
       );
       socket.DmsError = await QueryDmsErrWip(socket);
       //Delete the transaction
-      CdkBase.createLogEvent(socket, "DEBUG", `{6.2} Deleting Transaction ID ${socket.DMSTransHeader.transID}`);
+      WsLogger.createLogEvent(socket, "DEBUG", `{6.2} Deleting Transaction ID ${socket.DMSTransHeader.transID}`);
       socket.DmsBatchTxnPost = await DeleteDmsWip(socket);
 
       socket.DmsError.errMsg
@@ -125,29 +133,33 @@ async function CdkSelectedCustomer(socket, selectedCustomerId) {
           (e) =>
             e !== null &&
             e !== "" &&
-            CdkBase.createLogEvent(socket, "ERROR", `Error(s) encountered in posting transaction. ${e}`)
+            WsLogger.createLogEvent(socket, "ERROR", `Error(s) encountered in posting transaction. ${e}`)
         );
     }
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error encountered in CdkSelectedCustomer. ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error encountered in CdkSelectedCustomer. ${error}`);
     await InsertFailedExportLog(socket, error);
   } finally {
     //Ensure we always insert logEvents
     //GQL to insert logevents.
 
-    CdkBase.createLogEvent(socket, "DEBUG", `Capturing log events to database.`);
+    WsLogger.createLogEvent(socket, "DEBUG", `Capturing log events to database.`);
   }
 }
 
 exports.CdkSelectedCustomer = CdkSelectedCustomer;
 
 async function QueryJobData(socket, jobid) {
-  CdkBase.createLogEvent(socket, "DEBUG", `Querying job data for id ${jobid}`);
+  WsLogger.createLogEvent(socket, "DEBUG", `Querying job data for id ${jobid}`);
   const client = new GraphQLClient(process.env.GRAPHQL_ENDPOINT, {});
+  const currentToken =
+    (socket?.data && socket.data.authToken) || (socket?.handshake?.auth && socket.handshake.auth.token);
+
   const result = await client
-    .setHeaders({ Authorization: `Bearer ${socket.handshake.auth.token}` })
+    .setHeaders({ Authorization: `Bearer ${currentToken}` })
     .request(queries.QUERY_JOBS_FOR_CDK_EXPORT, { id: jobid });
-  CdkBase.createLogEvent(socket, "SILLY", `Job data query result ${JSON.stringify(result, null, 2)}`);
+
+  //WsLogger.createLogEvent(socket, "SILLY", `Job data query result ${JSON.stringify(result, null, 2)}`);
   return result.jobs_by_pk;
 }
 
@@ -161,11 +173,11 @@ async function CalculateDmsVid(socket, JobData) {
     });
 
     const [result, rawResponse, , rawRequest] = soapResponseVehicleInsertUpdate;
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientVehicleInsertUpdate.getVehIdsAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientVehicleInsertUpdate.getVehIdsAsync request.`);
 
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientVehicleInsertUpdate.getVehIdsAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientVehicleInsertUpdate.getVehIdsAsync response.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientVehicleInsertUpdate.getVehIdsAsync Result ${JSON.stringify(result, null, 2)}`
@@ -178,15 +190,15 @@ async function CalculateDmsVid(socket, JobData) {
 
     //return result && result.return && result.return[0];
   } catch (error) {
-    CdkBase.createXmlEvent(socket, error.request, `soapClientVehicleInsertUpdate.getVehIdsAsync request.`, true);
+    WsLogger.createXmlEvent(socket, error.request, `soapClientVehicleInsertUpdate.getVehIdsAsync request.`, true);
 
-    CdkBase.createXmlEvent(
+    WsLogger.createXmlEvent(
       socket,
-      error.response && error.response.data,
+      error.response?.data,
       `soapClientVehicleInsertUpdate.getVehIdsAsync response.`,
       true
     );
-    CdkBase.createLogEvent(socket, "ERROR", `{1} Error in CalculateDmsVid - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `{1} Error in CalculateDmsVid - ${error}`);
     throw new Error(error);
   }
 }
@@ -206,19 +218,19 @@ async function QueryDmsVehicleById(socket, JobData, DMSVid) {
 
     const [result, rawResponse, , rawRequest] = soapResponseVehicleInsertUpdate;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientVehicleInsertUpdate.readAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientVehicleInsertUpdate.readAsync request.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientVehicleInsertUpdate.readAsync Result ${JSON.stringify(result, null, 2)}`
     );
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientVehicleInsertUpdate.readAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientVehicleInsertUpdate.readAsync response.`);
     CheckCdkResponseForError(socket, soapResponseVehicleInsertUpdate);
-    const VehicleFromDMS = result && result.return && result.return.vehicle;
+    const VehicleFromDMS = result?.return && result.return.vehicle;
     return VehicleFromDMS;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in QueryDmsVehicleById - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in QueryDmsVehicleById - ${error}`);
     throw new Error(error);
   }
 }
@@ -237,28 +249,23 @@ async function QueryDmsCustomerById(socket, JobData, CustomerId) {
 
     const [result, rawResponse, , rawRequest] = soapResponseCustomerInsertUpdate;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientCustomerInsertUpdate.readAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientCustomerInsertUpdate.readAsync request.`);
 
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientCustomerInsertUpdate.readAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientCustomerInsertUpdate.readAsync response.`);
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientCustomerInsertUpdate.readAsync Result ${JSON.stringify(result, null, 2)}`
     );
     CheckCdkResponseForError(socket, soapResponseCustomerInsertUpdate);
-    const CustomersFromDms = result && result.return && result.return.customerParty;
+    const CustomersFromDms = result?.return && result.return.customerParty;
     return CustomersFromDms;
   } catch (error) {
-    CdkBase.createXmlEvent(socket, error.request, `soapClientCustomerInsertUpdate.readAsync request.`, true);
+    WsLogger.createXmlEvent(socket, error.request, `soapClientCustomerInsertUpdate.readAsync request.`, true);
 
-    CdkBase.createXmlEvent(
+    WsLogger.createXmlEvent(socket, error.response?.data, `soapClientCustomerInsertUpdate.readAsync response.`, true);
-      socket,
-      error.response && error.response.data,
-      `soapClientCustomerInsertUpdate.readAsync response.`,
-      true
-    );
 
-    CdkBase.createLogEvent(socket, "ERROR", `Error in QueryDmsCustomerById - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in QueryDmsCustomerById - ${error}`);
     throw new Error(error);
   }
 }
@@ -270,7 +277,7 @@ async function QueryDmsCustomerByName(socket, JobData) {
       : `${JobData.ownr_ln},${JobData.ownr_fn}`
   ).replace(replaceSpecialRegex, "");
 
-  CdkBase.createLogEvent(socket, "DEBUG", `Begin Query DMS Customer by Name using: ${ownerName}`);
+  WsLogger.createLogEvent(socket, "DEBUG", `Begin Query DMS Customer by Name using: ${ownerName}`);
 
   try {
     const soapClientCustomerSearch = await soap.createClientAsync(CdkWsdl.CustomerSearch);
@@ -285,29 +292,29 @@ async function QueryDmsCustomerByName(socket, JobData) {
 
     const [result, rawResponse, , rawRequest] = soapResponseCustomerSearch;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientCustomerSearch.executeSearchBulkAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientCustomerSearch.executeSearchBulkAsync request.`);
 
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientCustomerSearch.executeSearchBulkAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientCustomerSearch.executeSearchBulkAsync response.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientCustomerSearch.executeSearchBulkAsync Result ${JSON.stringify(result, null, 2)}`
     );
     CheckCdkResponseForError(socket, soapResponseCustomerSearch);
-    const CustomersFromDms = (result && result.return) || [];
+    const CustomersFromDms = result?.return || [];
     return CustomersFromDms;
   } catch (error) {
-    CdkBase.createXmlEvent(socket, error.request, `soapClientCustomerSearch.executeSearchBulkAsync request.`, true);
+    WsLogger.createXmlEvent(socket, error.request, `soapClientCustomerSearch.executeSearchBulkAsync request.`, true);
 
-    CdkBase.createXmlEvent(
+    WsLogger.createXmlEvent(
       socket,
-      error.response && error.response.data,
+      error.response?.data,
       `soapClientCustomerSearch.executeSearchBulkAsync response.`,
       true
     );
 
-    CdkBase.createLogEvent(socket, "ERROR", `Error in QueryDmsCustomerByName - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in QueryDmsCustomerByName - ${error}`);
     throw new Error(error);
   }
 }
@@ -318,7 +325,8 @@ async function GenerateDmsCustomerNumber(socket) {
     const soapResponseCustomerInsertUpdate = await soapClientCustomerInsertUpdate.getCustomerNumberAsync(
       {
         arg0: CDK_CREDENTIALS,
-        arg1: { dealerId: socket.JobData.bodyshop.cdk_dealerid }, //TODO: Verify why this does not follow the other standards.
+        //TODO: Verify why this does not follow the other standards.
+        arg1: { dealerId: socket.JobData.bodyshop.cdk_dealerid },
         arg2: { userId: null }
       },
 
@@ -327,33 +335,33 @@ async function GenerateDmsCustomerNumber(socket) {
 
     const [result, rawResponse, , rawRequest] = soapResponseCustomerInsertUpdate;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientCustomerInsertUpdate.getCustomerNumberAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientCustomerInsertUpdate.getCustomerNumberAsync request.`);
 
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientCustomerInsertUpdate.getCustomerNumberAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientCustomerInsertUpdate.getCustomerNumberAsync response.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientCustomerInsertUpdate.getCustomerNumberAsync Result ${JSON.stringify(result, null, 2)}`
     );
     CheckCdkResponseForError(socket, soapResponseCustomerInsertUpdate);
-    const customerNumber = result && result.return && result.return.customerNumber;
+    const customerNumber = result?.return && result.return.customerNumber;
     return customerNumber;
   } catch (error) {
-    CdkBase.createXmlEvent(
+    WsLogger.createXmlEvent(
       socket,
       error.request,
       `soapClientCustomerInsertUpdate.getCustomerNumberAsync request.`,
       true
     );
 
-    CdkBase.createXmlEvent(
+    WsLogger.createXmlEvent(
       socket,
-      error.response && error.response.data,
+      error.response?.data,
       `soapClientCustomerInsertUpdate.getCustomerNumberAsync response.`,
       true
     );
-    CdkBase.createLogEvent(socket, "ERROR", `Error in GenerateDmsCustomerNumber - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in GenerateDmsCustomerNumber - ${error}`);
     throw new Error(error);
   }
 }
@@ -416,27 +424,22 @@ async function InsertDmsCustomer(socket, newCustomerNumber) {
     );
 
     const [result, rawResponse, , rawRequest] = soapResponseCustomerInsertUpdate;
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientCustomerInsertUpdate.insertAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientCustomerInsertUpdate.insertAsync request.`);
 
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientCustomerInsertUpdate.insertAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientCustomerInsertUpdate.insertAsync response.`);
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientCustomerInsertUpdate.insertAsync Result ${JSON.stringify(result, null, 2)}`
     );
     CheckCdkResponseForError(socket, soapResponseCustomerInsertUpdate);
-    const customer = result && result.return && result.return.customerParty;
+    const customer = result?.return && result.return.customerParty;
     return customer;
   } catch (error) {
-    CdkBase.createXmlEvent(socket, error.request, `soapClientCustomerInsertUpdate.insertAsync request.`, true);
+    WsLogger.createXmlEvent(socket, error.request, `soapClientCustomerInsertUpdate.insertAsync request.`, true);
 
-    CdkBase.createXmlEvent(
+    WsLogger.createXmlEvent(socket, error.response?.data, `soapClientCustomerInsertUpdate.insertAsync response.`, true);
-      socket,
+    WsLogger.createLogEvent(socket, "ERROR", `Error in InsertDmsCustomer - ${error}`);
-      error.response && error.response.data,
-      `soapClientCustomerInsertUpdate.insertAsync response.`,
-      true
-    );
-    CdkBase.createLogEvent(socket, "ERROR", `Error in InsertDmsCustomer - ${error}`);
     throw new Error(error);
   }
 }
@@ -497,19 +500,19 @@ async function InsertDmsVehicle(socket) {
 
     const [result, rawResponse, , rawRequest] = soapResponseVehicleInsertUpdate;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientVehicleInsertUpdate.insertAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientVehicleInsertUpdate.insertAsync request.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientVehicleInsertUpdate.insertAsync Result ${JSON.stringify(result, null, 2)}`
     );
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientVehicleInsertUpdate.insertAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientVehicleInsertUpdate.insertAsync response.`);
     CheckCdkResponseForError(socket, soapResponseVehicleInsertUpdate);
-    const VehicleFromDMS = result && result.return && result.return.vehicle;
+    const VehicleFromDMS = result?.return && result.return.vehicle;
     return VehicleFromDMS;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in InsertDmsVehicle - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in InsertDmsVehicle - ${error}`);
     throw new Error(error);
   }
 }
@@ -523,12 +526,10 @@ async function UpdateDmsVehicle(socket) {
     //if it's a generic customer, don't update the vehicle owners.
 
     if (socket.selectedCustomerId === socket.JobData.bodyshop.cdk_configuration.generic_customer_number) {
-      ids = socket.DMSVeh && socket.DMSVeh.owners && socket.DMSVeh.owners;
+      ids = socket.DMSVeh?.owners && socket.DMSVeh.owners;
     } else {
       const existingOwnerinVeh =
-        socket.DMSVeh &&
+        socket.DMSVeh?.owners && socket.DMSVeh.owners.find((o) => o.id.value === socket.DMSCust.id.value);
-        socket.DMSVeh.owners &&
-        socket.DMSVeh.owners.find((o) => o.id.value === socket.DMSCust.id.value);
 
       if (existingOwnerinVeh) {
         ids = socket.DMSVeh.owners.map((o) => {
@@ -540,10 +541,7 @@ async function UpdateDmsVehicle(socket) {
           };
         });
       } else {
-        const oldOwner =
+        const oldOwner = socket.DMSVeh?.owners && socket.DMSVeh.owners.find((o) => o.id.assigningPartyId === "CURRENT");
-          socket.DMSVeh &&
-          socket.DMSVeh.owners &&
-          socket.DMSVeh.owners.find((o) => o.id.assigningPartyId === "CURRENT");
 
         ids = [
           {
@@ -603,19 +601,19 @@ async function UpdateDmsVehicle(socket) {
     });
     const [result, rawResponse, , rawRequest] = soapResponseVehicleInsertUpdate;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientVehicleInsertUpdate.updateAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientVehicleInsertUpdate.updateAsync request.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "DEBUG",
       `soapClientVehicleInsertUpdate.updateAsync Result ${JSON.stringify(result, null, 2)}`
     );
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientVehicleInsertUpdate.updateAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientVehicleInsertUpdate.updateAsync response.`);
     CheckCdkResponseForError(socket, soapResponseVehicleInsertUpdate);
-    const VehicleFromDMS = result && result.return && result.return.vehicle;
+    const VehicleFromDMS = result?.return && result.return.vehicle;
     return VehicleFromDMS;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in UpdateDmsVehicle - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in UpdateDmsVehicle - ${error}`);
     throw new Error(error);
   }
 }
@@ -642,18 +640,18 @@ async function InsertServiceVehicleHistory(socket) {
 
     const [result, rawResponse, , rawRequest] = soapResponseServiceHistoryInsert;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientServiceHistoryInsert.serviceHistoryHeaderInsert request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientServiceHistoryInsert.serviceHistoryHeaderInsert request.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientServiceHistoryInsert.serviceHistoryHeaderInsert Result ${JSON.stringify(result, null, 2)}`
     );
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientServiceHistoryInsert.serviceHistoryHeaderInsert response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientServiceHistoryInsert.serviceHistoryHeaderInsert response.`);
     CheckCdkResponseForError(socket, soapResponseServiceHistoryInsert);
-    return result && result.return;
+    return result?.return;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in InsertServiceVehicleHistory - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in InsertServiceVehicleHistory - ${error}`);
     throw new Error(error);
   }
 }
@@ -669,8 +667,10 @@ async function InsertDmsStartWip(socket) {
         acctgDate: moment().tz(socket.JobData.bodyshop.timezone).format("YYYY-MM-DD"),
         //socket.JobData.invoice_date
         desc: socket.txEnvelope.story && socket.txEnvelope.story.replace(replaceSpecialRegex, ""),
-        docType: 10 || 7, //Need to check what this usually would be? Apparently it is almost always 10 or 7.
+        docType: 10, // Need to check what this usually would be? Apparently it is almost always 10 or 7.
-        //1 Cash Receipt , 2 Check, 3 Journal Voucher, 4 Parts invoice, 5 Payable Invoice, 6 Recurring Entry, 7 Repair Order Invoice, 8 Vehicle Purchase Invoice, 9 Vehicle Sale Invoice, 10 Other, 11 Payroll, 12 Finance Charge, 13 FMLR Invoice, 14 Parts Credit Memo, 15 Manufacturer Document, 16 FMLR Credit Memo
+        //1 Cash Receipt , 2 Check, 3 Journal Voucher, 4 Parts invoice, 5 Payable Invoice, 6 Recurring Entry, 7 Repair
+        // Order Invoice, 8 Vehicle Purchase Invoice, 9 Vehicle Sale Invoice, 10 Other, 11 Payroll, 12 Finance Charge,
+        // 13 FMLR Invoice, 14 Parts Credit Memo, 15 Manufacturer Document, 16 FMLR Credit Memo
         m13Flag: 0,
         refer: socket.JobData.ro_number,
         srcCo: socket.JobData.bodyshop.cdk_configuration.srcco,
@@ -682,19 +682,19 @@ async function InsertDmsStartWip(socket) {
 
     const [result, rawResponse, , rawRequest] = soapResponseAccountingGLInsertUpdate;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientAccountingGLInsertUpdate.doStartWIPAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientAccountingGLInsertUpdate.doStartWIPAsync request.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientAccountingGLInsertUpdate.doStartWIPAsync Result ${JSON.stringify(result, null, 2)}`
     );
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientAccountingGLInsertUpdate.doStartWIPAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientAccountingGLInsertUpdate.doStartWIPAsync response.`);
     CheckCdkResponseForError(socket, soapResponseAccountingGLInsertUpdate);
-    const TransactionHeader = result && result.return;
+    const TransactionHeader = result?.return;
     return TransactionHeader;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in InsertDmsStartWip - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in InsertDmsStartWip - ${error}`);
     throw new Error(error);
   }
 }
@@ -713,19 +713,19 @@ async function InsertDmsBatchWip(socket) {
 
     const [result, rawResponse, , rawRequest] = soapResponseAccountingGLInsertUpdate;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientAccountingGLInsertUpdate.doTransBatchWIPAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientAccountingGLInsertUpdate.doTransBatchWIPAsync request.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientAccountingGLInsertUpdate.doTransBatchWIPAsync Result ${JSON.stringify(result, null, 2)}`
     );
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientAccountingGLInsertUpdate.doTransBatchWIPAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientAccountingGLInsertUpdate.doTransBatchWIPAsync response.`);
     CheckCdkResponseForError(socket, soapResponseAccountingGLInsertUpdate);
-    const BatchWipResult = result && result.return;
+    const BatchWipResult = result?.return;
     return BatchWipResult;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in InsertDmsBatchWip - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in InsertDmsBatchWip - ${error}`);
     throw new Error(error);
   }
 }
@@ -877,19 +877,19 @@ async function PostDmsBatchWip(socket) {
 
     const [result, rawResponse, , rawRequest] = soapResponseAccountingGLInsertUpdate;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientAccountingGLInsertUpdate.doPostBatchWIPAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientAccountingGLInsertUpdate.doPostBatchWIPAsync request.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientAccountingGLInsertUpdate.doPostBatchWIPAsync Result ${JSON.stringify(result, null, 2)}`
     );
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientAccountingGLInsertUpdate.doPostBatchWIPAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientAccountingGLInsertUpdate.doPostBatchWIPAsync response.`);
     // CheckCdkResponseForError(socket, soapResponseAccountingGLInsertUpdate);
-    const PostResult = result && result.return;
+    const PostResult = result?.return;
     return PostResult;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in PostDmsBatchWip - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in PostDmsBatchWip - ${error}`);
     throw new Error(error);
   }
 }
@@ -906,19 +906,19 @@ async function QueryDmsErrWip(socket) {
 
     const [result, rawResponse, , rawRequest] = soapResponseAccountingGLInsertUpdate;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientAccountingGLInsertUpdate.doErrWIPAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientAccountingGLInsertUpdate.doErrWIPAsync request.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "DEBUG",
       `soapClientAccountingGLInsertUpdate.doErrWIPAsync Result ${JSON.stringify(result, null, 2)}`
     );
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientAccountingGLInsertUpdate.doErrWIPAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientAccountingGLInsertUpdate.doErrWIPAsync response.`);
     CheckCdkResponseForError(socket, soapResponseAccountingGLInsertUpdate);
-    const PostResult = result && result.return;
+    const PostResult = result?.return;
     return PostResult;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in QueryDmsErrWip - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in QueryDmsErrWip - ${error}`);
     throw new Error(error);
   }
 }
@@ -937,28 +937,31 @@ async function DeleteDmsWip(socket) {
 
     const [result, rawResponse, , rawRequest] = soapResponseAccountingGLInsertUpdate;
 
-    CdkBase.createXmlEvent(socket, rawRequest, `soapClientAccountingGLInsertUpdate.doPostBatchWIPAsync request.`);
+    WsLogger.createXmlEvent(socket, rawRequest, `soapClientAccountingGLInsertUpdate.doPostBatchWIPAsync request.`);
 
-    CdkBase.createLogEvent(
+    WsLogger.createLogEvent(
       socket,
       "SILLY",
       `soapClientAccountingGLInsertUpdate.doPostBatchWIPAsync Result ${JSON.stringify(result, null, 2)}`
     );
-    CdkBase.createXmlEvent(socket, rawResponse, `soapClientAccountingGLInsertUpdate.doPostBatchWIPAsync response.`);
+    WsLogger.createXmlEvent(socket, rawResponse, `soapClientAccountingGLInsertUpdate.doPostBatchWIPAsync response.`);
     CheckCdkResponseForError(socket, soapResponseAccountingGLInsertUpdate);
-    const PostResult = result && result.return;
+    const PostResult = result?.return;
     return PostResult;
   } catch (error) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in PostDmsBatchWip - ${error}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in PostDmsBatchWip - ${error}`);
     throw new Error(error);
   }
 }
 
 async function MarkJobExported(socket, jobid) {
-  CdkBase.createLogEvent(socket, "DEBUG", `Marking job as exported for id ${jobid}`);
+  WsLogger.createLogEvent(socket, "DEBUG", `Marking job as exported for id ${jobid}`);
   const client = new GraphQLClient(process.env.GRAPHQL_ENDPOINT, {});
+  const currentToken =
+    (socket?.data && socket.data.authToken) || (socket?.handshake?.auth && socket.handshake.auth.token);
+
   const result = await client
-    .setHeaders({ Authorization: `Bearer ${socket.handshake.auth.token}` })
+    .setHeaders({ Authorization: `Bearer ${currentToken}` })
     .request(queries.MARK_JOB_EXPORTED, {
       jobId: jobid,
       job: {
@@ -984,20 +987,23 @@ async function MarkJobExported(socket, jobid) {
 async function InsertFailedExportLog(socket, error) {
   try {
     const client = new GraphQLClient(process.env.GRAPHQL_ENDPOINT, {});
+    const currentToken =
+      (socket?.data && socket.data.authToken) || (socket?.handshake?.auth && socket.handshake.auth.token);
+
     const result = await client
-      .setHeaders({ Authorization: `Bearer ${socket.handshake.auth.token}` })
+      .setHeaders({ Authorization: `Bearer ${currentToken}` })
       .request(queries.INSERT_EXPORT_LOG, {
-        log: {
+        logs: [{
           bodyshopid: socket.JobData.bodyshop.id,
           jobid: socket.JobData.id,
           successful: false,
           message: JSON.stringify(error),
           useremail: socket.user.email
-        }
+        }]
       });
 
     return result;
   } catch (error2) {
-    CdkBase.createLogEvent(socket, "ERROR", `Error in InsertFailedExportLog - ${error} - ${JSON.stringify(error2)}`);
+    WsLogger.createLogEvent(socket, "ERROR", `Error in InsertFailedExportLog - ${error} - ${JSON.stringify(error2)}`);
   }
 }

server/data/autohouse.js

@@ -736,7 +736,7 @@ const CreateCosts = (job) => {
     PASL: "PASL"
   };
   const defaultCosts =
-    job.bodyshop.cdk_dealerid || job.bodyshop.pbs_serialnumber
+    job.bodyshop.cdk_dealerid || job.bodyshop.pbs_serialnumber || job.bodyshop.rr_dealerid
       ? ciecaObj
       : job.bodyshop.md_responsibility_centers.defaults.costs;
 

server/data/claimscorp.js

@@ -591,7 +591,7 @@ const CreateCosts = (job) => {
     PASL: "PASL"
   };
   const defaultCosts =
-    job.bodyshop.cdk_dealerid || job.bodyshop.pbs_serialnumber
+    job.bodyshop.cdk_dealerid || job.bodyshop.pbs_serialnumber || job.bodyshop.rr_dealerid
       ? ciecaObj
       : job.bodyshop.md_responsibility_centers.defaults.costs;
 

server/data/kaizen.js

@@ -647,7 +647,7 @@ const CreateCosts = (job) => {
     PASL: "PASL"
   };
   const defaultCosts =
-    job.bodyshop.cdk_dealerid || job.bodyshop.pbs_serialnumber
+    job.bodyshop.cdk_dealerid || job.bodyshop.pbs_serialnumber || job.bodyshop.rr_dealerid
       ? ciecaObj
       : job.bodyshop.md_responsibility_centers.defaults.costs;
 

server/fortellis/fortellis-helpers.js

@@ -0,0 +1,460 @@
+const path = require("path");
+require("dotenv").config({
+  path: path.resolve(process.cwd(), `.env.${process.env.NODE_ENV || "development"}`)
+});
+
+// const CalcualteAllocations = require("../cdk/cdk-calculate-allocations").default;
+const CreateFortellisLogEvent = require("./fortellis-logger");
+const logger = require("../utils/logger");
+const uuid = require("uuid").v4;
+const AxiosLib = require("axios").default;
+const axios = AxiosLib.create();
+const axiosCurlirize = require("axios-curlirize").default;
+
+// Custom error class for Fortellis API errors
+class FortellisApiError extends Error {
+  constructor(message, details) {
+    super(message);
+    this.name = "FortellisApiError";
+    this.reqId = details.reqId;
+    this.url = details.url;
+    this.apiName = details.apiName;
+    this.errorData = details.errorData;
+    this.errorStatus = details.errorStatus;
+    this.errorStatusText = details.errorStatusText;
+    this.originalError = details.originalError;
+  }
+}
+
+axiosCurlirize(axios, (_result, _err) => {
+  //Left intentionally blank. We don't want to console.log. We handle logging the cURL in MakeFortellisCall once completed. 
+});
+
+const getTransactionType = (jobid) => `fortellis:${jobid}`;
+const defaultFortellisTTL = 60 * 60;
+
+async function GetAuthToken() {
+  //Done with Authorization Code Flow
+  //https://docs.fortellis.io/docs/tutorials/solution-integration/authorization-code-flow/
+
+  //TODO: This should get stored in the redis cache and only be refreshed when it expires.
+  const {
+    data: { access_token, expires_in, token_type }
+  } = await axios.post(
+    process.env.FORTELLIS_AUTH_URL,
+    {},
+    {
+      auth: {
+        username: process.env.FORTELLIS_KEY,
+        password: process.env.FORTELLIS_SECRET
+      },
+      params: {
+        grant_type: "client_credentials",
+        scope: "anonymous"
+      }
+    }
+  );
+  return access_token;
+}
+
+async function FetchSubscriptions({ redisHelpers, socket, jobid, SubscriptionObject }) {
+  try {
+    const { setSessionTransactionData, getSessionTransactionData } = redisHelpers;
+
+    //Get Subscription ID from Transaction Envelope
+    const { SubscriptionID } = SubscriptionObject
+      ? SubscriptionObject
+      : await getSessionTransactionData(socket.id, getTransactionType(jobid), `txEnvelope`);
+    if (!SubscriptionID) {
+      throw new Error("Subscription ID not found in transaction envelope.");
+    }
+
+    //Check to See if the subscription meta is in the Redis Cache.
+    const SubscriptionMetaFromCache = await getSessionTransactionData(
+      socket.id,
+      getTransactionType(jobid),
+      FortellisCacheEnums.SubscriptionMeta
+    );
+
+    // If it is, return it.
+    if (SubscriptionMetaFromCache) {
+      return SubscriptionMetaFromCache;
+    } else {
+      const access_token = await GetAuthToken();
+      const subscriptions = await axios.get(FortellisActions.GetSubscription.url, {
+        headers: { Authorization: `Bearer ${access_token}` },
+        logRequest: false
+      });
+      const SubscriptionMeta = subscriptions.data.subscriptions.find((s) => s.subscriptionId === SubscriptionID);
+      if (setSessionTransactionData) {
+        await setSessionTransactionData(
+          socket.id,
+          getTransactionType(jobid),
+          FortellisCacheEnums.SubscriptionMeta,
+          SubscriptionMeta,
+          defaultFortellisTTL
+        );
+      }
+      return SubscriptionMeta;
+    }
+  } catch (error) {
+    CreateFortellisLogEvent(socket, "ERROR", `Error fetching subscription metadata.`, {
+      error: error.message,
+      stack: error.stack
+    });
+  }
+}
+
+async function GetDepartmentId({ apiName, debug = false, SubscriptionMeta, overrideDepartmentId }) {
+  if (!apiName) throw new Error("apiName not provided. Unable to get department without apiName.");
+  if (debug) {
+    console.log("API Names & Departments ");
+    console.log("===========");
+    console.log(JSON.stringify(SubscriptionMeta.apiDmsInfo, null, 4));
+    console.log("===========");
+  }
+
+  const departmentIds = SubscriptionMeta.apiDmsInfo //Get the subscription object.
+    .find((info) => info.name === apiName)?.departments; //Departments are categorized by API name and have an array of departments.
+
+  if (overrideDepartmentId) {
+    return departmentIds && departmentIds.find(d => d.id === overrideDepartmentId)?.id
+  } else {
+
+    return departmentIds && departmentIds[0] && departmentIds[0].id; //TODO: This makes the assumption that there is only 1 department.
+  }
+}
+
+//Highest level function call to make a call to fortellis. This should be the only call required, and it will handle all the logic for making the call.
+async function MakeFortellisCall({
+  apiName,
+  url,
+  headers = {},
+  body = {},
+  type = "post",
+  debug = false,
+  requestPathParams,
+  requestSearchParams = [], //Array of key/value strings like [["key", "value"]]
+  jobid,
+  redisHelpers,
+  socket,
+  SubscriptionObject, //This is used because of the get make models to bypass all of the redis calls.
+  overrideDepartmentId
+}) {
+  //const { setSessionTransactionData, getSessionTransactionData } = redisHelpers;
+
+  const fullUrl = constructFullUrl({ url, pathParams: requestPathParams, requestSearchParams });
+  if (debug) console.log(`Executing ${type} to ${fullUrl}`);
+  const ReqId = uuid();
+  const access_token = await GetAuthToken();
+  const SubscriptionMeta = await FetchSubscriptions({ redisHelpers, socket, jobid, SubscriptionObject });
+  const DepartmentId = await GetDepartmentId({ apiName, debug, SubscriptionMeta, overrideDepartmentId });
+
+  if (debug) {
+    console.log(
+      `ReqID: ${ReqId}  |  SubscriptionID: ${SubscriptionMeta.subscriptionId}  |  DepartmentId: ${DepartmentId}`
+    );
+    console.log(`Body Contents: ${JSON.stringify(body, null, 4)}`);
+  }
+
+  try {
+    let result;
+    switch (type) {
+      case "post":
+      default:
+        result = await axios.post(fullUrl, body, {
+          headers: {
+            Authorization: `Bearer ${access_token}`,
+            "Subscription-Id": SubscriptionMeta.subscriptionId,
+            "Request-Id": ReqId,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            ...(DepartmentId && { "Department-Id": DepartmentId }),
+            ...headers
+          }
+        });
+        break;
+      case "get":
+        result = await axios.get(fullUrl, {
+          headers: {
+            Authorization: `Bearer ${access_token}`,
+            "Subscription-Id": SubscriptionMeta.subscriptionId,
+            "Request-Id": ReqId,
+            Accept: "application/json",
+            "Department-Id": DepartmentId,
+            ...headers
+          }
+        });
+        break;
+      case "put":
+        result = await axios.put(fullUrl, body, {
+          headers: {
+            Authorization: `Bearer ${access_token}`,
+            "Subscription-Id": SubscriptionMeta.subscriptionId,
+            "Request-Id": ReqId,
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            "Department-Id": DepartmentId,
+            ...headers
+          }
+        });
+        break;
+    }
+
+    if (debug) {
+      console.log(`ReqID: ${ReqId} Data`);
+      console.log(JSON.stringify(result.data, null, 4));
+    }
+
+    if (result.data.checkStatusAfterSeconds) {
+      return DelayedCallback({
+        delayMeta: result.data,
+        access_token,
+        SubscriptionID: SubscriptionMeta.subscriptionId,
+        ReqId,
+        departmentIds: DepartmentId
+      });
+    }
+
+    logger.log(
+      "fortellis-log-event-json",
+      "DEBUG",
+      socket?.user?.email,
+      jobid,
+      {
+        requestcurl: result.config.curlCommand,
+        reqid: result.config.headers["Request-Id"] || null,
+        subscriptionId: result.config.headers["Subscription-Id"] || null,
+        resultdata: result.data,
+        resultStatus: result.status
+      },
+    );
+
+    return result.data;
+  } catch (error) {
+    const errorDetails = {
+      reqId: ReqId,
+      url: fullUrl,
+      apiName,
+      errorData: error.response?.data,
+      errorStatus: error.response?.status,
+      errorStatusText: error.response?.statusText,
+      originalError: error
+    };
+
+    logger.log(
+      "fortellis-log-event-error",
+      "ERROR",
+      socket?.user?.email,
+      socket?.recordid,
+      {
+        wsmessage: "",//message,
+        curl: error.config.curl.curlCommand,
+        reqid: error.request.headers["Request-Id"] || null,
+        subscriptionId: error.request.headers["Subscription-Id"] || null,
+      },
+      true
+    );
+
+    throw new FortellisApiError(`Fortellis API call failed for ${apiName}: ${error.message}`, errorDetails);
+  }
+}
+
+//Some Fortellis calls return a batch result that isn't ready immediately.
+//This function will check the status of the call and wait until it is ready.
+//It will try 5 times before giving up.
+async function DelayedCallback({ delayMeta, access_token, SubscriptionID, ReqId, departmentIds }) {
+  for (let index = 0; index < 5; index++) {
+    await sleep(delayMeta.checkStatusAfterSeconds * 1000);
+    //Check to see if the call is ready.
+    const statusResult = await axios.get(delayMeta._links.status.href, {
+      headers: {
+        Authorization: `Bearer ${access_token}`,
+        "Subscription-Id": SubscriptionID,
+        "Request-Id": ReqId,
+        "Department-Id": departmentIds[0].id
+      }
+    });
+
+    //TODO:  Add a check if the status result is not ready, to try again.
+    if (statusResult.data.status === "complete") {
+      //This may have to check again if it isn't ready.
+      const batchResult = await axios.get(statusResult.data._links.result.href, {
+        headers: {
+          Authorization: `Bearer ${access_token}`,
+          "Subscription-Id": SubscriptionID,
+          "Request-Id": ReqId
+          //"Department-Id": departmentIds[0].id
+        }
+      });
+      return batchResult;
+    } else {
+      return "Error!!! Still need to implement batch waiting.";
+    }
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+const isProduction = process.env.NODE_ENV === "production";
+
+//Get requests should have the trailing slash as they are used that way in the calls. 
+const FortellisActions = {
+  GetSubscription: {
+    url: isProduction
+      ? "https://subscriptions.fortellis.io/v1/solution/subscriptions"
+      : "https://subscriptions.fortellis.io/v1/solution/subscriptions",
+    type: "get",
+    apiName: "Fortellis Get Subscriptions"
+  },
+  QueryVehicles: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdkdrive/service/v1/vehicles/"
+      : "https://api.fortellis.io/cdk-test/cdkdrive/service/v1/vehicles/",
+    type: "get",
+    apiName: "Service Vehicle - Query Vehicles"
+  },
+  GetMakeModel: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/makemodel/v2/bulk"
+      : "https://api.fortellis.io/cdk-test/drive/makemodel/v2",
+    type: "get",
+    apiName: "CDK Drive Get Make Model Lite"
+  },
+  GetVehicleId: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/service-vehicle-mgmt/v2/vehicle-ids/" //Request path params of vins
+      : "https://api.fortellis.io/cdk-test/drive/service-vehicle-mgmt/v2/vehicle-ids/",
+    type: "get",
+    apiName: "CDK Drive Post Service Vehicle"
+  },
+  GetVehicleById: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/service-vehicle-mgmt/v2/" //Request path params of vehicleId
+      : "https://api.fortellis.io/cdk-test/drive/service-vehicle-mgmt/v2/",
+    type: "get",
+    apiName: "CDK Drive Post Service Vehicle"
+  },
+  QueryCustomerByName: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/customerpost/v1/search"
+      : "https://api.fortellis.io/cdk-test/drive/customerpost/v1/search",
+    type: "get",
+    apiName: "CDK Drive Post Customer"
+  },
+  ReadCustomer: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/customerpost/v1/" //Customer ID is request param.
+      : "https://api.fortellis.io/cdk-test/drive/customerpost/v1/",
+    type: "get",
+    apiName: "CDK Drive Post Customer"
+  },
+  CreateCustomer: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/customerpost/v1/"
+      : "https://api.fortellis.io/cdk-test/drive/customerpost/v1/",
+    type: "post",
+    apiName: "CDK Drive Post Customer"
+  },
+  InsertVehicle: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/service-vehicle-mgmt/v2/"
+      : "https://api.fortellis.io/cdk-test/drive/service-vehicle-mgmt/v2/",
+    type: "post",
+    apiName: "CDK Drive Post Service Vehicle"
+  },
+  UpdateVehicle: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/service-vehicle-mgmt/v2/"
+      : "https://api.fortellis.io/cdk-test/drive/service-vehicle-mgmt/v2/",
+    type: "put",
+    apiName: "CDK Drive Post Service Vehicle"
+  },
+  GetCOA: {
+    type: "get",
+    apiName: "CDK Drive Post Accounts GL WIP",
+    url: `https://api.fortellis.io/cdk-test/drive/chartofaccounts/v2/bulk/`,
+    waitForResult: true
+  },
+  StartWip: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/glpost/startWIP"
+      : "https://api.fortellis.io/cdk-test/drive/glpost/startWIP",
+    type: "post",
+    apiName: "CDK Drive Post Accounts GL"
+  },
+  TranBatchWip: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/glpost/transBatchWIP"
+      : "https://api.fortellis.io/cdk-test/drive/glpost/transBatchWIP",
+    type: "post",
+    apiName: "CDK Drive Post Accounts GL"
+  },
+  PostBatchWip: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/glpost/postBatchWIP"
+      : "https://api.fortellis.io/cdk-test/drive/glpost/postBatchWIP",
+    type: "post",
+    apiName: "CDK Drive Post Accounts GL"
+  },
+  DeleteTranWip: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/glpost/postWIP"
+      : "https://api.fortellis.io/cdk-test/drive/glpost/postWIP",
+    type: "post",
+    apiName: "CDK Drive Post Accounts GL"
+  },
+  QueryErrorWip: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/glpost/errWIP/"
+      : "https://api.fortellis.io/cdk-test/drive/glpost/errWIP/",
+    type: "get",
+    apiName: "CDK Drive Post Accounts GL"
+  },
+  ServiceHistoryInsert: {
+    url: isProduction
+      ? "https://api.fortellis.io/cdk/drive/post/service-vehicle-history-mgmt/v2/"
+      : "https://api.fortellis.io/cdk-test/drive/post/service-vehicle-history-mgmt/v2/",
+    type: "post",
+    apiName: "CDK Drive Post Service Vehicle History"
+  }
+};
+
+const FortellisCacheEnums = {
+  txEnvelope: "txEnvelope",
+  DMSBatchTxn: "DMSBatchTxn",
+  SubscriptionMeta: "SubscriptionMeta",
+  DepartmentId: "DepartmentId",
+  JobData: "JobData",
+  DMSVid: "DMSVid",
+  DMSVeh: "DMSVeh",
+  DMSVehCustomer: "DMSVehCustomer",
+  DMSCustList: "DMSCustList",
+  DMSCust: "DMSCust",
+  selectedCustomerId: "selectedCustomerId",
+  DMSTransHeader: "DMSTransHeader",
+  transWips: "transWips",
+  DmsBatchTxnPost: "DmsBatchTxnPost",
+  DMSVehHistory: "DMSVehHistory"
+};
+
+function constructFullUrl({ url, pathParams = "", requestSearchParams = [] }) {
+  // Ensure the base URL ends with a single "/"
+  url = url.replace(/\/+$/, "/");
+  const fullPath = pathParams ? `${url}${pathParams}` : url;
+  const searchParams = new URLSearchParams(requestSearchParams).toString();
+  const fullUrl = searchParams ? `${fullPath}?${searchParams}` : fullPath;
+  return fullUrl;
+}
+
+module.exports = {
+  GetAuthToken,
+  FortellisCacheEnums,
+  MakeFortellisCall,
+  FortellisActions,
+  getTransactionType,
+  defaultFortellisTTL,
+  FortellisApiError,
+  GetDepartmentId
+};

server/fortellis/fortellis-logger.js

@@ -0,0 +1,8 @@
+const logger = require("../utils/logger");
+
+const CreateFortellisLogEvent = (socket, level, message, txnDetails) => {
+  logger.log("fortellis-log-event", level, socket?.user?.email, null, { wsmessage: message, txnDetails });
+  socket.emit("fortellis-log-event", { level, message, txnDetails });
+};
+
+module.exports = CreateFortellisLogEvent;

server/graphql-client/queries.js

@@ -697,6 +697,7 @@ exports.AUTOHOUSE_QUERY = `query AUTOHOUSE_EXPORT($start: timestamptz, $bodyshop
       jc_hourly_rates
       cdk_dealerid
       pbs_serialnumber
+      rr_dealerid
       use_paint_scale_data
     timezone
   }
@@ -974,6 +975,7 @@ exports.CLAIMSCORP_QUERY = `query CLAIMSCORP_EXPORT($start: timestamptz, $bodysh
     jc_hourly_rates
     cdk_dealerid
     pbs_serialnumber
+    rr_dealerid
     use_paint_scale_data
     timezone
   }
@@ -1235,6 +1237,7 @@ exports.KAIZEN_QUERY = `query KAIZEN_EXPORT($start: timestamptz, $bodyshopid: uu
     jc_hourly_rates
     cdk_dealerid
     pbs_serialnumber
+    rr_dealerid
     use_paint_scale_data
     timezone
   }
@@ -1754,6 +1757,7 @@ query QUERY_JOB_COSTING_DETAILS($id: uuid!) {
         jc_hourly_rates
         cdk_dealerid
         pbs_serialnumber
+        rr_dealerid
         use_paint_scale_data
       }
     }
@@ -1870,6 +1874,7 @@ exports.QUERY_JOB_COSTING_DETAILS_MULTI = ` query QUERY_JOB_COSTING_DETAILS_MULT
       jc_hourly_rates
       cdk_dealerid
       pbs_serialnumber
+      rr_dealerid
       use_paint_scale_data
     }
   }
@@ -2190,19 +2195,7 @@ mutation UPDATE_BILLS($billids: [uuid!]!, $bill: bills_set_input!, $logs: [expor
   }
 }`;
 
-exports.INSERT_EXPORT_LOG = `
-mutation INSERT_EXPORT_LOG($log: exportlog_insert_input!) {
-  insert_exportlog_one(object: $log) {
-    id
-  }
-}`;
 
-exports.QUERY_EXISTING_TRANSITION = `
-mutation INSERT_EXPORT_LOG($log: exportlog_insert_input!) {
-  insert_exportlog_one(object: $log) {
-    id
-  }
-}`;
 
 exports.UPDATE_OLD_TRANSITION = `mutation UPDATE_OLD_TRANSITION($jobid: uuid!, $existingTransition: transitions_set_input!){
   update_transitions(where:{jobid:{_eq:$jobid}, end:{_is_null:true
@@ -2922,6 +2915,8 @@ exports.GET_BODYSHOP_BY_ID = `
       state
       notification_followers
       timezone
+      rr_dealerid
+      rr_configuration
     }
   }
 `;

server/integrations/partsManagement/defaultNewShop.json

@@ -1224,6 +1224,7 @@
     }
   ],
   "cdk_dealerid": null,
+  "rr_dealerid": null,
   "features": {
     "allAccess": true,
     "singleDeviceOnly": false

server/job/job-costing.js

@@ -601,7 +601,7 @@ function GenerateCostingData(job) {
       //At the bill level.
       bill_val.billlines.map((line_val) => {
         //At the bill line level.
-        if (job.bodyshop.pbs_serialnumber || job.bodyshop.cdk_dealerid) {
+        if (job.bodyshop.pbs_serialnumber || job.bodyshop.cdk_dealerid || job.bodyshop.rr_dealerid) {
           if (!bill_acc[selectedDmsAllocationConfig.costs[line_val.cost_center]])
             bill_acc[selectedDmsAllocationConfig.costs[line_val.cost_center]] = Dinero();
 
@@ -716,7 +716,7 @@ function GenerateCostingData(job) {
   const ticketTotalsByCostCenter = job.timetickets.reduce((ticket_acc, ticket_val) => {
     //At the invoice level.
 
-    if (job.bodyshop.pbs_serialnumber || job.bodyshop.cdk_dealerid) {
+    if (job.bodyshop.pbs_serialnumber || job.bodyshop.cdk_dealerid || job.bodyshop.rr_dealerid) {
       if (!ticket_acc[selectedDmsAllocationConfig.costs[ticket_val.ciecacode]])
         ticket_acc[selectedDmsAllocationConfig.costs[ticket_val.ciecacode]] = Dinero();
 

server/routes/cdkRoutes.js

@@ -8,6 +8,7 @@ const withUserGraphQLClientMiddleware = require("../middleware/withUserGraphQLCl
 router.use(validateFirebaseIdTokenMiddleware);
 
 router.post("/getvehicles", withUserGraphQLClientMiddleware, cdkGetMake.default);
+router.post("/fortellis/getvehicles", withUserGraphQLClientMiddleware, cdkGetMake.fortellis);
 router.post("/calculate-allocations", withUserGraphQLClientMiddleware, cdkCalculateAllocations.defaultRoute);
 
 module.exports = router;

server/rr/lib/README.md

@@ -0,0 +1,658 @@
+# rr-rome-client
+
+A minimal Node.js wrapper for Reynolds & Reynolds (Rome/RIH) STAR `ProcessMessage` over SOAP, with WS-Security UsernameToken.
+
+## Contents
+- Overview
+- Install
+- Supported Node Version
+- Peer / External Dependencies
+- Quick Start
+- Configuration & Environment Variables
+- Client API Methods
+- RRResult Structure
+- Types & IntelliSense
+- Errors & Validation
+- Retry Strategy
+- Debug / Dump Flags
+- Live Test Runner (`scripts/run-live.mjs`)
+- Bundling & Upload Helper (`scripts/bundle-for-upload.mjs`)
+- XML Templates & XSDs
+- Logging
+- Build & Development
+- Design Notes / Non-goals
+- License
+
+## Overview
+`rr-rome-client` builds and sends STAR XML payloads (Customer, Service Vehicle, Combined Search, Advisors, Parts, BSM Repair Orders) inside a SOAP envelope using the STAR Transport `ProcessMessage` operation. It applies a WS-Security UsernameToken header and provides:
+- High-level `RRClient` methods for each supported Rome operation.
+- JSDoc typedefs for all payloads and response shapes (usable in JS and TS).
+- Structured parsing of response status blocks and operation-specific data.
+- Automatic BODId & CreationDateTime generation, with ability to override.
+- Basic input validation and error classification.
+- Exponential backoff + jitter for retryable transport/vendor lock scenarios.
+
+## Install
+```bash
+npm i rr-rome-client
+```
+(You may also need peer dependencies; see below.)
+
+## Supported Node Version
+`package.json` declares `"engines": { "node": ">=22.0.0" }`. The build targets modern Node 22 features (native ESM, improved performance). Earlier Node versions are not officially supported/tested.
+
+## Peer / External Dependencies
+Rollup externalizes runtime libraries (they are listed in `dependencies` but not bundled). Ensure these are available in your environment:
+Required:
+- axios – HTTP transport
+- fast-xml-parser – STAR XML parsing
+- mustache – XML templating
+- uuid – BODId generation
+Optional (only if you use env loader helpers or live scripts):
+- dotenv
+- dotenv-expand
+
+Install (versions per `package.json`):
+```bash
+npm install axios@^1.7.7 fast-xml-parser@^4.5.0 mustache@^4.2.0 uuid@^9.0.1
+# Optional env loader
+npm install dotenv@^17.2.3 dotenv-expand@^12.0.3
+```
+TypeScript users (optional):
+```bash
+npm install -D @types/node
+```
+Browser bundling is not officially supported; you would need polyfills for core modules if attempting.
+
+## Quick Start
+```js
+import { RRClient } from 'rr-rome-client';
+import { loadEnv } from 'rr-rome-client/src/util/config.js'; // optional helper
+
+// Load routing & credentials from environment variables (see below)
+const { baseUrl, username, password, routing } = loadEnv();
+
+const client = new RRClient({ baseUrl, username, password });
+
+// Minimal createRepairOrder example
+const result = await client.createRepairOrder({
+  customerNo: '12345',
+  departmentType: 'S', // DeptType
+  vin: '1ABCDEF2GHIJ34567',
+  outsdRoNo: 'EXT-RO-99'
+}, { routing });
+
+if (result.success) {
+  console.log('RO status:', result.data); // {status, date, time, outsdRoNo, dmsRoNo, errorMessage}
+} else {
+  console.error('Failure:', result.statusBlocks?.transaction);
+}
+```
+
+## Configuration & Environment Variables
+You can manually provide configuration or use the helper `loadEnv(env)` in `src/util/config.js`.
+
+Recognized environment variables:
+- RR_BASE_URL – SOAP endpoint URL (required)
+- RR_USERNAME – WS-Security UsernameToken username (required)
+- RR_PASSWORD – WS-Security UsernameToken password (required)
+- RR_DEALER_NUMBER – DealerNumber for Destination (required per call)
+- RR_STORE_NUMBER – StoreNumber (optional)
+- RR_AREANUMBER – AreaNumber (optional)
+
+Example `.env`:
+```
+RR_BASE_URL=https://rome.example.com/soap
+RR_USERNAME=integratorUser
+RR_PASSWORD=superSecret
+RR_DEALER_NUMBER=1234
+RR_STORE_NUMBER=01
+RR_AREANUMBER=1
+```
+`loadEnv()` returns `{ baseUrl, username, password, routing: { dealerNumber, storeNumber, areaNumber } }`.
+
+Per-call options object shape (`CallOptions`):
+```js
+{
+  routing: { dealerNumber: '1234', storeNumber?: '01', areaNumber?: '1' },
+  envelope?: { bodId?, creationDateTime?, sender?: { component?, task?, referenceId? } }
+}
+```
+If omitted, `RRClient` auto-generates `bodId` (UUID) and `creationDateTime` when sending.
+
+## Client API Methods
+Each method returns a `Promise<RRResult<T>>` where `T` is operation-specific data (or array). `success` is true for vendor SUCCESS and NO_MATCH results; FAIL triggers an `RRVendorStatusError` exception before a `RRResult` is returned.
+
+All methods require `opts.routing.dealerNumber`.
+
+### combinedSearch(payload: CombinedSearchQuery, opts)
+Search customer + service vehicle combinations by exactly one criterion: `phone | license | vin | name | nameRecId | stkNo` plus optional `make`, `model`, `year`, `maxResults` (capped at 50).
+Minimal:
+```js
+const res = await client.combinedSearch({ kind: 'vin', vin: '12345' }, { routing });
+res.data; // Array<CombinedSearchBlock>
+```
+Errors: Throws `RRValidationError` if missing or multiple criteria.
+
+### insertCustomer(payload: InsertCustomerPayload, opts)
+Insert a customer record. Required: `lastName` (or `customerName`). If individual (`ibFlag='I'` or inferred by presence of `firstName`), then `firstName` required.
+```js
+const res = await client.insertCustomer({ firstName: 'Jane', lastName: 'Doe', phones:[{number:'5551234567'}] }, { routing });
+res.data; // { dmsRecKey, status, statusCode }
+```
+
+### updateCustomer(payload: UpdateCustomerPayload, opts)
+Update existing customer by `nameRecId` plus required `ibFlag`. Other fields optional.
+```js
+const res = await client.updateCustomer({ nameRecId:'998877', ibFlag:'I', lastName:'Doe' }, { routing });
+```
+
+### insertServiceVehicle(payload: InsertServiceVehiclePayload, opts)
+Insert a service vehicle linked to a customer. Required: `vin`, `vehicleServInfo.customerNo`.
+```js
+const res = await client.insertServiceVehicle({
+  vin:'1HGCM82633A004352',
+  vehicleServInfo:{ customerNo:'12345' }
+}, { routing });
+res.data; // { status, statusCode }
+```
+
+### getAdvisors(payload: GetAdvisorsParams, opts)
+Fetch advisors for a department. Department values normalized: S/P/B or long names.
+```js
+const res = await client.getAdvisors({ department:'SERVICE' }, { routing });
+res.data; // AdvisorRow[]
+```
+
+### createRepairOrder(payload: CreateRepairOrderPayload, opts)
+Required: `customerNo`, `departmentType`, `vin`, `outsdRoNo`. Advisor optional. Complex nested labor/parts/misc blocks supported via payload.
+```js
+const res = await client.createRepairOrder({
+  customerNo:'12345', departmentType:'S', vin:'1ABCDEF2GHIJ34567', outsdRoNo:'EXT-RO-99'
+}, { routing });
+res.data; // { status, date, time, outsdRoNo, dmsRoNo, errorMessage }
+```
+
+### updateRepairOrder(payload: UpdateRepairOrderPayload, opts)
+Required: `finalUpdate ('Y'|'N')`, `outsdRoNo`. May include `roNo` and nested sections.
+```js
+const res = await client.updateRepairOrder({ finalUpdate:'N', outsdRoNo:'EXT-RO-99' }, { routing });
+```
+
+### getParts(payload: GetPartsParams, opts)
+Required: `roNumber` (internal ERA RO number).
+```js
+const res = await client.getParts({ roNumber:'938275' }, { routing });
+res.data; // PartRow[]
+```
+
+## Payload Schema Reference
+Comprehensive field-level summary sourced from `src/types.js`, operation builders, and validation logic. Types reflect accepted JS types (string|number where applicable). Constraints list enumerations, inference rules, and validation notes. Required = must be supplied by caller (or inferred automatically). Optional fields omitted become absent in generated XML.
+
+### CombinedSearchQuery
+Only one criterion permitted; `maxResults` capped at 50.
+
+| Field | Type | Required | Constraints / Notes |
+|-------|------|----------|----------------------|
+| kind | 'phone'|'license'|'vin'|'name'|'nameRecId'|'stkNo' | Yes | Determines which single criterion block is emitted |
+| phone | string\|number\|{phone:string} | Conditionally (if kind==='phone') | Value mapped to `<Phone Num="..."/>` |
+| license | string\|number\|{license:string} | Conditionally (kind==='license') | Value mapped to `<LicenseNum LicNo="..."/>` |
+| vin | string\|number\|{vin:string} | Conditionally (kind==='vin') | Value mapped to `<PartVIN Vin="..."/>` (partial VIN allowed) |
+| name | {fname,lname,mname} or {name} | Conditionally (kind==='name') | Either FullName triple or LName only; must supply all three for FullName |
+| nameRecId | string\|number\|{custId:string}|{nameRecId:string} | Conditionally (kind==='nameRecId') | Emits `<NameRecId CustIdStart="..."/>` |
+| stkNo | string\|number\|{stkNo:string} | Conditionally (kind==='stkNo') | Emits `<StkNo VehId="..."/>` |
+| maxResults | number | No | Capped at 50 (default 50) -> `MaxRecs` attribute |
+| make | string | No | Defaults 'ANY' -> `VehData MakePfx` |
+| model | string\|number | No | Defaults 'ANY' -> `VehData Model` |
+| year | string\|number | No | Defaults 'ANY' -> `VehData Year` |
+
+### InsertCustomerPayload
+`ibFlag` inferred as 'I' if `firstName` present, else 'B'. Business requires `lastName` / `customerName`; individual requires `firstName` + last name.
+
+| Field | Type | Required | Constraints / Notes |
+|-------|------|----------|----------------------|
+| ibFlag | 'I'|'B' | Auto / For update must supply | Inferred if omitted (firstName present => 'I') |
+| customerType | 'R'|'W'|'I'|'Retail'|'Wholesale'|'Internal' | No | Normalized to 'R','W','I'; must be one of listed |
+| createdBy | string | No | Optional CreatedBy attribute |
+| customerName | string | Conditional | Alias for `lastName` when business |
+| lastName | string | Yes (unless `customerName` provided) | Required base name; sanitized to A-Z0-9 space |
+| firstName | string | Required when ibFlag='I' | Sanitized; required for individuals |
+| midName | string | No | Sanitized |
+| salut | string | No | Sanitized |
+| suffix | string | No | Sanitized |
+| addresses | CustomerAddress[] | No | Each entry requires `line1`; Type defaults 'P' |
+| phones | CustomerPhone[] | No | Each entry requires `number`; Type defaults 'H' |
+| emails | CustomerEmail[] | No | First entry used -> `<Email MailTo="..."/>` |
+| personal.gender | 'M'|'F'|'U' | No | Optional |
+| personal.otherName | string | No | Sanitized alnum/space |
+| personal.anniversaryDate | string | No | Included if non-empty |
+| personal.employerName | string | No | Sanitized |
+| personal.employerPhone | string | No | Raw string |
+| personal.occupation | string | No | Sanitized |
+| personal.optOut | string | No | Pass-through |
+| personal.optOutUse | string | No | Pass-through |
+| personal.birthDates[].type | 'P'|'S' | No | Defaults 'P'; entry must have `date` |
+| personal.birthDates[].date | string | Conditional | Included only if non-empty |
+| personal.ssns[].type | 'P'|'S' | No | Defaults 'P'; entry must have `ssn` |
+| personal.ssns[].ssn | string | Conditional | Included only if non-empty |
+| personal.driver.type | 'P'|'S' | No | Defaults 'P' |
+| personal.driver.licenseNumber | string | Conditional | Required to emit DriverInfo |
+| personal.driver.licenseState | string | No | Optional |
+| personal.driver.licenseExpDate | string | No | Optional |
+| personal.children[].name | string | No | Sanitized; optional list |
+| dms.taxExemptNum | string | No | Optional |
+| dms.salesTerritory | string | No | Optional |
+| dms.deliveryRoute | string | No | Optional |
+| dms.salesmanNum | string | No | Optional |
+| dms.lastContactMethod | string | No | Optional |
+| dms.followups[].type | string | Conditional | Must have both type & value |
+| dms.followups[].value | string | Conditional | Must have both type & value |
+
+### UpdateCustomerPayload
+Extends InsertCustomerPayload plus:
+
+| Field | Type | Required | Constraints |
+|-------|------|----------|-------------|
+| nameRecId | string\|number | Yes | Required identifier |
+| ibFlag | 'I'|'B' | Yes | Must be explicitly provided on update |
+
+### InsertServiceVehiclePayload
+
+| Field | Type | Required | Constraints / Notes |
+|-------|------|----------|----------------------|
+| vin | string | Yes | Must be provided |
+| modelDesc | string | No | Optional attribute |
+| carline | string | No | Optional attribute |
+| extClrDesc | string | No | Optional attribute |
+| intClrDesc | string | No | Optional attribute |
+| trimDesc | string | No | Optional attribute |
+| bodyStyle | string | No | Optional attribute |
+| engineDesc | string | No | Optional attribute |
+| transDesc | string | No | Optional attribute |
+| year | string\|number | No | Emits `<Year>` element if present |
+| odometer | string\|number | No | Emits `<Odometer>` |
+| odometerUnits | string | No | Emits `<OdometerUnits>` |
+| vehicleDetail.licNo | string | No | Emits `<VehicleDetail LicNo="..."/>` |
+| vehicleServInfo.customerNo | string\|number | Yes | Required; becomes `CustomerNo` attribute |
+| vehicleServInfo.salesmanNo | string\|number | No | Optional element |
+| vehicleServInfo.inServiceDate | string\|number | No | Optional element |
+| vehicleServInfo.mileage | string\|number | No | Optional element |
+| vehicleServInfo.teamCode | string | No | Optional element |
+| vehicleServInfo.vehExtWarranty.contractNumber | string | Conditional | Included if any warranty field present |
+| vehicleServInfo.vehExtWarranty.expirationDate | string | Conditional | "" excluded |
+| vehicleServInfo.vehExtWarranty.expirationMileage | string\|number | Conditional | "" excluded |
+| vehicleServInfo.advisor.contactInfo.nameRecId | string\|number | No | Advisor block included only if provided |
+
+### CreateRepairOrderPayload
+
+| Field | Type | Required | Constraints / Notes |
+|-------|------|----------|----------------------|
+| customerNo | string\|number | Yes | CustNo |
+| departmentType | string\|number | Yes | DeptType |
+| vin | string | Yes | Vin |
+| outsdRoNo | string\|number | Yes | External RO identifier |
+| advisorNo | string\|number | No | AdvNo |
+| tagNo | string\|number | No | TagNo |
+| mileageIn | string\|number | No | MileageIn |
+| roComment | string | No | `<RoCommentInfo RoComment="..."/>` |
+| estimate.parts | string\|number | No | EstPartsAmt |
+| estimate.labor | string\|number | No | EstLaborAmt |
+| estimate.total | string\|number | No | EstTotalAmt |
+| tax.payType | 'All'|'Cust'|'Intr'|'Warr' | No | Enumeration validated |
+| tax.taxCode | string | No | TaxCode |
+| tax.txblGrossAmt | string\|number | No | TxblGrossAmt |
+| tax.grossTaxAmt | string\|number | No | GrossTaxAmt |
+| rolabor.ops[].opCode | string | No | Optional |
+| rolabor.ops[].jobNo | string\|number | No | Optional |
+| rolabor.ops[].custPayTypeFlag | string | No | Freeform (not validated) |
+| rolabor.ops[].warrPayTypeFlag | string | No | Freeform |
+| rolabor.ops[].intrPayTypeFlag | string | No | Freeform |
+| rolabor.ops[].custTxblNtxblFlag | 'T'|'N' | No | Enumerated & validated |
+| rolabor.ops[].warrTxblNtxblFlag | 'T'|'N' | No | Enumerated & validated |
+| rolabor.ops[].intrTxblNtxblFlag | 'T'|'N' | No | Enumerated & validated |
+| rolabor.ops[].vlrCode | string | No | Optional |
+| rolabor.ops[].bill.payType | 'All'|'Cust'|'Intr'|'Warr' | No | Enumeration |
+| rolabor.ops[].bill.jobTotalHrs | string\|number | No | Optional |
+| rolabor.ops[].bill.billTime | string\|number | No | Optional |
+| rolabor.ops[].bill.billRate | string\|number | No | Optional |
+| rolabor.ops[].ccc.cause | string | No | Optional |
+| rolabor.ops[].ccc.complaint | string | No | Optional |
+| rolabor.ops[].ccc.correction | string | No | Optional |
+| rolabor.ops[].amount.payType | 'All'|'Cust'|'Intr'|'Warr' | No | Enumeration |
+| rolabor.ops[].amount.amtType | string | No | Optional |
+| rolabor.ops[].amount.custPrice | string\|number | No | Optional |
+| rolabor.ops[].amount.totalAmt | string\|number | No | Optional |
+| ropart.jobs[].opCode | string | No | Optional |
+| ropart.jobs[].jobNo | string\|number | No | Optional |
+| ropart.jobs[].lines[].partNo | string | No | Optional |
+| ropart.jobs[].lines[].partNoDesc | string | No | Optional |
+| ropart.jobs[].lines[].partQty | string\|number | No | Emits QtyOrd |
+| ropart.jobs[].lines[].sale | string\|number | No | Sale |
+| ropart.jobs[].lines[].cost | string\|number | No | Cost |
+| ropart.jobs[].lines[].addDeleteFlag | string | No | AddDeleteFlag |
+| rogg.ops[].lines[].breakOut | string | No | Optional |
+| rogg.ops[].lines[].itemType | 'G'|'P'|'S'|'F' | No | Enumerated & validated |
+| rogg.ops[].lines[].itemDesc | string | No | Optional |
+| rogg.ops[].lines[].custQty | string\|number | No | Optional |
+| rogg.ops[].lines[].warrQty | string\|number | No | Optional |
+| rogg.ops[].lines[].intrQty | string\|number | No | Optional |
+| rogg.ops[].lines[].custPayTypeFlag | string | No | Optional |
+| rogg.ops[].lines[].warrPayTypeFlag | string | No | Optional |
+| rogg.ops[].lines[].intrPayTypeFlag | string | No | Optional |
+| rogg.ops[].lines[].custTxblNtxblFlag | 'T'|'N' | No | Enumerated |
+| rogg.ops[].lines[].warrTxblNtxblFlag | 'T'|'N' | No | Enumerated |
+| rogg.ops[].lines[].intrTxblNtxblFlag | 'T'|'N' | No | Enumerated |
+| rogg.ops[].lines[].amount.payType | 'All'|'Cust'|'Intr'|'Warr' | No | Enumeration |
+| rogg.ops[].lines[].amount.amtType | string | No | Optional |
+| rogg.ops[].lines[].amount.custPrice | string\|number | No | Optional |
+| rogg.ops[].lines[].amount.dlrCost | string\|number | No | Optional |
+| romisc.ops[].lines[].miscCode | string | No | Optional |
+| romisc.ops[].lines[].custPayTypeFlag | string | No | Optional |
+| romisc.ops[].lines[].warrPayTypeFlag | string | No | Optional |
+| romisc.ops[].lines[].intrPayTypeFlag | string | No | Optional |
+| romisc.ops[].lines[].custTxblNtxblFlag | 'T'|'N' | No | Enumerated |
+| romisc.ops[].lines[].warrTxblNtxblFlag | 'T'|'N' | No | Enumerated |
+| romisc.ops[].lines[].intrTxblNtxblFlag | 'T'|'N' | No | Enumerated |
+| romisc.ops[].lines[].codeAmt | string\|number | No | Optional |
+
+### UpdateRepairOrderPayload
+Adds required `finalUpdate` and supports most Create fields + mileageOut.
+
+| Field | Type | Required | Constraints / Notes |
+|-------|------|----------|----------------------|
+| finalUpdate | 'Y'|'N' | Yes | Must be 'Y' or 'N' (validated) |
+| outsdRoNo | string\|number | Yes | External RO identifier (validation requires present) |
+| roNo | string\|number | No | Optional internal RoNo |
+| mileageOut | string\|number | No | MileageOut |
+| (other fields) | see CreateRepairOrderPayload | Conditional | Same validations apply |
+
+### GetAdvisorsParams
+
+| Field | Type | Required | Constraints / Notes |
+|-------|------|----------|----------------------|
+| department | 'S'|'P'|'B'|'SERVICE'|'PARTS'|'BODY'|'BODYSHOP'|'BODY SHOP' | Yes | Normalized to S/P/B |
+| advisorNumber | string\|number | No | Optional filter |
+| maxResults | number | Ignored | Not in XSD (builder ignores) |
+
+### GetPartsParams
+
+| Field | Type | Required | Constraints / Notes |
+|-------|------|----------|----------------------|
+| roNumber | string\|number | Yes | Required; becomes `<RoInfo RoNumber="..."/>` |
+
+### Common Routing & Envelope Fields
+
+| Field | Type | Required | Constraints / Notes |
+|-------|------|----------|----------------------|
+| routing.dealerNumber | string | Yes | Required for all requests (Destination) |
+| routing.storeNumber | string | No | Optional Destination StoreNumber |
+| routing.areaNumber | string | No | Optional Destination AreaNumber |
+| envelope.bodId | string | Auto | UUID generated if omitted |
+| envelope.creationDateTime | Date\|string | Auto | Uses current time; formatted without milliseconds |
+| envelope.sender.component | string | No | Defaults 'Rome' if omitted |
+| envelope.sender.task | string | No | Op-specific defaults (e.g. 'CU','SV','BSMRO','CVC','RCT') |
+| envelope.sender.referenceId | string | No | Op-specific defaults ('Insert','Update','Query') |
+
+### AdvisorRow (response convenience)
+
+| Field | Type | Notes |
+|-------|------|-------|
+| advisorId | string\|number\|undefined | AdvisorNumber attribute |
+| firstName | string\|undefined | FirstName attribute |
+| lastName | string\|undefined | LastName attribute |
+| department | 'S'|'P'|'B'|undefined | Normalized department passed through |
+
+### PartRow (response convenience)
+
+| Field | Type | Notes |
+|-------|------|-------|
+| partNumber | string\|undefined | PartNumber |
+| partDescription | string\|undefined | PartDescription |
+| quantityOrdered | string\|number\|undefined | QuantityOrdered |
+| quantityShipped | string\|number\|undefined | QuantityShipped |
+| price | string\|number\|undefined | Price |
+| cost | string\|number\|undefined | Cost |
+| processedFlag | string\|undefined | ProcessedFlag |
+| addOrDelete | string\|undefined | AddOrDelete |
+
+### CombinedSearch Response Shapes
+Hierarchical breakdown of the parsed array returned under `RRResult.data` for `combinedSearch` (each entry is a `CombinedSearchBlock`). Attribute-centric; absent fields are simply omitted.
+
+#### CombinedSearchBlock
+| Field | Type | Notes |
+|-------|------|-------|
+| NameContactId | CombinedSearchNameContactId | Customer name/contact composite |
+| ServVehicle | CombinedSearchServVehicle[] | Zero or more service vehicle blocks |
+| Message | CombinedSearchMessage[] | Optional informational messages |
+
+#### NameContactId
+| Field | Type | Notes |
+|-------|------|-------|
+| NameId | CombinedSearchNameId | Includes identifiers & individual/business name choice |
+| Address | Object[] | Each has address-related attributes (lines, city, state, zip, etc.) |
+| ContactOptions | Object[] | Arbitrary contact option attributes as present |
+| Phone | Object[] | Each phone entry carries attributes like Type, Num, Ext |
+| Email | Object[] | Each email entry carries attributes (MailTo, etc.) |
+
+#### NameId
+| Field | Type | Notes |
+|-------|------|-------|
+| NameRecId | string\|number | Identifier used for subsequent operations |
+| IBFlag | 'I'|'B' | Individual or Business flag |
+| IndName | Object | Present for individual: attributes like FName, LName, MName |
+| BusName | Object | Present for business: attributes like Name (business name) |
+
+#### ServVehicle (CombinedSearchServVehicle)
+| Field | Type | Notes |
+|-------|------|-------|
+| Vehicle | CombinedSearchVehicle | VIN + descriptive attributes |
+| VehicleServInfo | CombinedSearchVehicleServInfo | Service info attributes & nested warranty/advisor/comments |
+
+#### Vehicle (CombinedSearchVehicle)
+| Attribute | Type | Notes |
+|-----------|------|-------|
+| Vin | string | Vehicle identification number (may be partial in search results) |
+| VehicleMake | string | Make code / description |
+| VehicleYr | string\|number | Year |
+| MdlNo | string | Model code |
+| ModelDesc | string | Model description |
+| Carline | string | Carline description |
+| ExtClrDesc | string | Exterior color |
+| IntClrDesc | string | Interior color |
+| MakeName | string | Full make name |
+| VehicleDetail.LicNo | string | License plate (if present) |
+
+#### VehicleServInfo (CombinedSearchVehicleServInfo)
+| Attribute | Type | Notes |
+|-----------|------|-------|
+| CustomerNo | string\|number | Linked customer number |
+| SalesmanNo | string\|number | Optional salesman number |
+| InServiceDate | string\|number | Date vehicle placed in service |
+| Mileage | string\|number | Current mileage |
+| TeamCode | string | Team/department code |
+| VehExtWarranty.ContractNumber | string | Extended warranty contract number |
+| VehExtWarranty.ExpirationDate | string | Warranty expiration date |
+| VehExtWarranty.ExpirationMileage | string\|number | Warranty mileage limit |
+| Advisor.ContactInfo.NameRecId | string\|number | Advisor reference (if present) |
+| VehServComments[] | string[] | Freeform service comments (array of raw text) |
+
+#### Message (CombinedSearchMessage)
+| Field | Type | Notes |
+|-------|------|-------|
+| MessageNo | string\|number | Optional message number (if provided) |
+| Text | string | Message text content |
+
+### CustomerResponseData
+Returned as `result.data` for `insertCustomer` / `updateCustomer`.
+| Field | Type | Notes |
+|-------|------|-------|
+| dmsRecKey | string\|undefined | DMS record key identifier (if provided in TransStatus) |
+| status | string\|undefined | Vendor status string |
+| statusCode | string\|undefined | Vendor status code |
+
+### ServiceVehicleResponseData
+Returned as `result.data` for `insertServiceVehicle`.
+| Field | Type | Notes |
+|-------|------|-------|
+| status | string\|undefined | GenTransStatus Status |
+| statusCode | string\|undefined | GenTransStatus StatusCode |
+
+### RepairOrderData
+Returned as `result.data` for `createRepairOrder` / `updateRepairOrder` (parsed from RoRecordStatus).
+| Field | Type | Notes |
+|-------|------|-------|
+| status | string\|undefined | RoRecordStatus Status |
+| date | string\|undefined | Date attribute/text |
+| time | string\|undefined | Time attribute/text |
+| outsdRoNo | string\|undefined | External RO number (OutsdRoNo) |
+| dmsRoNo | string\|undefined | Internal DMS RO number (DMSRoNo) |
+| errorMessage | string\|undefined | ErrorMessage if provided |
+
+## RRResult Structure
+Each successful call resolves to:
+```ts
+interface RRResult<T> {
+  success: boolean; // SUCCESS or NO_MATCH
+  data?: T;         // op-specific parsed convenience data
+  parsed: any;      // entire parsed STAR payload root
+  xml: { request: string; response: string }; // raw SOAP envelopes
+  statusBlocks?: { transaction?: {status,statusCode,message}; roRecord?: {status,date,time,outsdRoNo,dmsRoNo,errorMessage} };
+  applicationArea?: any; // raw ApplicationArea node
+}
+```
+Use `statusBlocks.transaction` for generic status; `data` for normalized op output.
+
+`Convenience data` refers to the distilled, operation-specific subset placed on `RRResult.data` by a dedicated `postParse` function (e.g., extracting only RoRecordStatus identifiers or customer DMS keys). It is intentionally smaller and flatter than `RRResult.parsed`, which contains the entire parsed STAR payload tree. Use `data` for common identifiers/status checks; fall back to `parsed` when you need full raw XML-derived detail.
+
+## Types & IntelliSense
+Rich JSDoc typedefs ship with the package.
+- ESM: `import { RRClient } from 'rr-rome-client';` optionally import `'rr-rome-client/types'` to prompt editor indexing.
+- CJS: `const { RRClient } = require('rr-rome-client'); require('rr-rome-client/types');`
+
+Selected typedef categories (see `src/types.js`):
+- Routing / Envelope / CallOptions
+- Customer / Service Vehicle / Repair Order payload blocks
+- Combined Search structures
+- Advisor and Parts row shapes
+- `RRResult<T>` generic helper
+
+The build also emits a TypeScript declaration bundle (`dist/types/index.d.ts`) generated via `tsconfig.types.json` (processing only `src/types.js`).
+
+## Errors & Validation
+Three custom error classes (`src/errors.js`):
+- `RRTransportError` – Non-2xx HTTP status or network failure; `meta.status` / `meta.body` may be attached.
+- `RRVendorStatusError` – Vendor FAIL status (non-success & not NO_MATCH). Includes `meta.status` (raw status object) and full response XML. `retryable` may be set (currently determined by vendor message lock wording or explicit flag).
+- `RRValidationError` – Input validation failures (missing required fields, invalid enumeration values, etc.).
+
+Enumerated validations (examples):
+- Customer: `ibFlag`, required `firstName` if individual, allowed `customerType` values.
+- Service Vehicle: mandatory `vin` and `vehicleServInfo.customerNo`.
+- Repair Orders: required header fields; enumerations for tax pay type (`All|Cust|Intr|Warr`), taxable flags (`T|N`), item types (`G|P|S|F`).
+
+Error Handling Example:
+```js
+try {
+  await client.createRepairOrder(/* ... */);
+} catch (e) {
+  if (e instanceof RRVendorStatusError) {
+    console.error('Vendor fail', e.meta.status);
+  } else if (e instanceof RRValidationError) {
+    console.error('Bad input', e.message);
+  } else if (e instanceof RRTransportError) {
+    console.error('HTTP/Network', e.message, e.meta.status);
+  } else {
+    console.error('Unexpected', e);
+  }
+}
+```
+
+## Retry Strategy
+`withBackoff(fn, {max, logger})` (used internally) retries on:
+- Transport/network errors (`RRTransportError`).
+- Vendor status errors indicating record lock/in use (message matching `/lock|in use|record.*busy/i`) or explicit `retryable` flag.
+Backoff: exponential starting at 400ms, capped at 10s, plus up to 250ms jitter.
+Configure via `new RRClient({ retries: { max: 5 }, ... })`.
+
+## Debug / Dump Flags
+Set these environment variables to inspect request/response internals:
+- `RR_DEBUG` – Enables debug logging (`defaultLogger.debug`).
+- `RR_DUMP_ENVELOPE=1` – Prints outgoing SOAP envelope.
+- `RR_DUMP_XML=1` – Prints full response XML.
+- `RR_DUMP_STATUS=1` – Logs parsed status blocks.
+- `RR_DUMP_APPLICATION=1` – Logs raw ApplicationArea block.
+- `RR_DUMP_DATA=1` – Logs `result.data` (postParse convenience output).
+
+## Live Test Runner (`scripts/run-live.mjs`)
+Provides curated integration tests against a live Rome system using Vitest. Loads `.env` then `.env.local` (override). Usage:
+```
+node scripts/run-live.mjs <test> [flags] [-- ...vitestArgs]
+```
+Available tests (see script for full list & flags):
+- `combinedSearch` – VIN or phone search.
+- `insertCustomer`, `updateCustomer` – Customer record operations (use `--write` to enable live writes).
+- `insertServiceVehicle` – Add vehicle (requires or discovers customer).
+- `getAdvisors` – Advisor listing by department.
+- `createRepairOrder`, `updateRepairOrder` – BSM RO operations.
+- `getParts` – Retrieve RO parts lines.
+- `all` – Run all sequentially.
+
+Common flags:
+- `--dump` → `RR_DUMP_ENVELOPE`
+- `--write` → `RR_LIVE_WRITES` (enables writes)
+- Operation-specific flags map to `RR_TEST_*` env variables (see script comments for details).
+- Arbitrary env: `--set=KEY=VALUE`.
+
+Example:
+```
+node scripts/run-live.mjs createRepairOrder --write --dump --customerNo=1134485 --vin=1ABCDEF2GHIJ34567 --ro=BSM123
+```
+
+## Bundling & Upload Helper (`scripts/bundle-for-upload.mjs`)
+Creates text bundles of project files for transport/support purposes.
+- Includes key directories (`src/`, `test/`, `schemas/`) and specific root files.
+- Excludes large/irrelevant directories (`node_modules`, `dist`, etc.).
+- Options: `--max-bytes`, `--pattern=globish`, `--with-env` (include `.env` – caution), `--list-only`.
+Generates `bundles/bundle-<uuid>-N.txt` with file boundary markers.
+
+## XML Templates & XSDs
+Templates reside in `src/templates/templateMap.js` using Mustache. Each operation builder renders a STAR root element plus `ApplicationArea`. XSD files (under `schemas/`) accompany operations:
+- Customer Insert/Update: `rey_RomeCustomerInsertReq.xsd`, `rey_RomeCustomerUpdateReq.xsd`
+- Service Vehicle Insert: `rey_RomeServVehicleInsertReq.xsd`
+- Combined Search: `rey_RomeCustServVehCombReq.xsd`
+- Advisors: `rey_RomeGetAdvisorsReq.xsd`
+- Parts: `rey_RomeGetPartsReq.xsd`
+- Repair Orders Create/Update: `rey_RomeCreateBSMRepairOrderReq.xsd`, `rey_RomeUpdateBSMRepairOrderReq.xsd`
+Response XSDs also present for repair orders and others.
+
+Builders attach an `xsdFilename` hint and `elementName`; no runtime XSD validation is performed (the project does not contain a validation module beyond these references).
+
+## Logging
+Default logger (`src/logger.js`): logs to console via `info`, `warn`, `error`; `debug` gated by `RR_DEBUG`.
+Provide a custom logger with matching method names in `RRClientConfig`:
+```js
+const logger = { info:()=>{}, warn:()=>{}, error:console.error, debug:()=>{} };
+const client = new RRClient({ baseUrl, username, password, logger });
+```
+
+## Build & Development
+Scripts:
+- `npm run build` – Rollup builds `dist/index.cjs` & `dist/index.mjs`, copies JSDoc types (`scripts/postbuild-copy-types.mjs`), emits `.d.ts` (via `tsc -p tsconfig.types.json`).
+- `npm test` – Runs unit tests (`vitest` with `vitest.config.unit.mjs`).
+- `npm run bundle` – Invoke bundle creation (see above).
+- `npm run live:<op>` – Convenience commands mapping to `scripts/run-live.mjs` (e.g. `npm run live:getParts`).
+
+Rollup configuration (`rollup.config.mjs`):
+- Externalizes Node core modules and listed dependencies.
+- Applies terser minification (2 passes, hoisting) for compact output.
+- Generates both CJS and ESM entrypoints.
+
+Tree-shaking is enabled (`treeshake.moduleSideEffects = false`). `sideEffects: false` in `package.json` allows downstream bundlers to drop unused exports.
+
+## Design Notes / Non-goals
+- WS-Security: Implements only UsernameToken with password type Text or Digest (configurable via `wssePasswordType`). No nonce or timestamp included.
+- Idempotency: `bodId` generated per request unless provided; `ensureBodAndDates` centralizes creation.
+- Parsing: Focused on extracting status and op-specific identifiers; raw parsed STAR tree still accessible via `result.parsed`.
+- Status Handling: Treats `NO_MATCH` (codes like 2 or 213) as non-error with `success=true` so callers can differentiate empty results from failures.
+- Validation: Enforces only practical minimum & enumerations; does not attempt full schema compliance.
+- No automatic `fetch` transport fallback yet (axios chosen for reliability). You can replace `postSoap` if providing a compatible function returning raw response text and error semantics.
+- No built-in XSD validator; XSDs present for reference only.

server/rr/lib/types.cjs

@@ -0,0 +1,3 @@
+'use strict';
+// CJS access point for JSDoc typedefs
+module.exports = require('./types.js');

server/rr/lib/types.js

@@ -0,0 +1,144 @@
+/**
+ * @typedef {Object} RRClientConfig
+ * @property {string} baseUrl Base URL of the Rome endpoint
+ * @property {string} username WS-Security username
+ * @property {string} password WS-Security password
+ * @property {'Text'|'Digest'} [wssePasswordType] Password type (defaults to Text)
+ * @property {number} [timeoutMs] Request timeout in milliseconds
+ * @property {{max?: number}} [retries] Retry configuration
+ * @property {{ info:Function, warn:Function, error:Function, debug:Function }} [logger] Custom logger implementation
+ */
+
+/** Dealer/store routing (required each call). */
+export const _routingDoc = null;
+/**
+ * @typedef {Object} Routing
+ * @property {string} dealerNumber
+ * @property {string} [storeNumber]
+ * @property {string} [areaNumber]
+ */
+
+/** Optional envelope overrides; BODId/CreationDateTime auto-generated if omitted. */
+export const _envelopeDoc = null;
+/**
+ * @typedef {Object} EnvelopeOptions
+ * @property {string} [bodId]
+ * @property {string|Date} [creationDateTime]
+ * @property {{ component?: string, task?: string, referenceId?: string }} [sender]
+ */
+
+/** Per-call options */
+export const _callOptionsDoc = null;
+/**
+ * @typedef {Object} CallOptions
+ * @property {Routing} routing
+ * @property {EnvelopeOptions} [envelope]
+ */
+
+/** @template T @typedef {Object} RRResult { @property {boolean} success @property {T} [data] @property {any} parsed @property {{request:string,response:string}} xml @property {{transaction?:any,roRecord?:any}} [statusBlocks] @property {any} [applicationArea] } */
+
+/** @typedef {Object} CombinedSearchName { @property {string} [fname] @property {string} [lname] @property {string} [mname] @property {string} [name] } */
+/** @typedef {Object} CombinedSearchQuery
+ * @property {'phone'|'license'|'vin'|'name'|'nameRecId'|'stkNo'} kind Search kind (only one criterion allowed)
+ * @property {string|number|{phone:string}} [phone] Phone number criterion
+ * @property {string|number|{license:string}} [license] License plate criterion
+ * @property {string|number|{vin:string}} [vin] VIN criterion
+ * @property {CombinedSearchName} [name] Customer name criterion
+ * @property {string|number|{custId:string}|{nameRecId:string}} [nameRecId] Name record ID criterion
+ * @property {string|number|{stkNo:string}} [stkNo] Stock number criterion
+ * @property {number} [maxResults] Max results (capped at 50)
+ * @property {string} [make] Vehicle make filter
+ * @property {string|number} [model] Vehicle model filter
+ * @property {string|number} [year] Vehicle year filter
+} */
+/** @typedef {Object} CombinedSearchVehicleDetail { @property {string} [LicNo] } */
+/** @typedef {Object} CombinedSearchVehicle { @property {string} [Vin] @property {string} [VehicleMake] @property {string|number} [VehicleYr] @property {string} [MdlNo] @property {string} [ModelDesc] @property {string} [Carline] @property {string} [ExtClrDesc] @property {string} [IntClrDesc] @property {string} [MakeName] @property {CombinedSearchVehicleDetail} [VehicleDetail] } */
+/** @typedef {Object} CombinedSearchVehicleWarranty { @property {string} [ContractNumber] @property {string} [ExpirationDate] @property {string|number} [ExpirationMileage] } */
+/** @typedef {Object} CombinedSearchAdvisorContactInfo { @property {string|number} [NameRecId] } */
+/** @typedef {Object} CombinedSearchAdvisor { @property {CombinedSearchAdvisorContactInfo} [ContactInfo] } */
+/** @typedef {Object} CombinedSearchVehicleServInfo { @property {string|number} [CustomerNo] @property {string|number} [SalesmanNo] @property {string|number} [InServiceDate] @property {string|number} [Mileage] @property {string} [TeamCode] @property {CombinedSearchVehicleWarranty} [VehExtWarranty] @property {CombinedSearchAdvisor} [Advisor] @property {string[]} [VehServComments] } */
+/** @typedef {Object} CombinedSearchServVehicle { @property {CombinedSearchVehicle} [Vehicle] @property {CombinedSearchVehicleServInfo} [VehicleServInfo] } */
+/** @typedef {Object} CombinedSearchNameId { @property {string|number} [NameRecId] @property {'I'|'B'} [IBFlag] @property {Object} [IndName] @property {Object} [BusName] } */
+/** @typedef {Object} CombinedSearchNameContactId { @property {CombinedSearchNameId} [NameId] @property {Object[]} [Address] @property {Object[]} [ContactOptions] @property {Object[]} [Phone] @property {Object[]} [Email] } */
+/** @typedef {Object} CombinedSearchMessage { @property {string|number} [MessageNo] @property {string} [Text] } */
+/** @typedef {Object} CombinedSearchBlock { @property {CombinedSearchNameContactId} [NameContactId] @property {CombinedSearchServVehicle[]} [ServVehicle] @property {CombinedSearchMessage[]} [Message] } */
+
+/** @typedef {Object} CustomerAddress { @property {'P'|'B'|'M'|'S'|'D'} [type] @property {string} line1 @property {string} [line2] @property {string} [city] @property {string} [state] @property {string} [postalCode] @property {string} [county] @property {string} [country] } */
+/** @typedef {Object} CustomerPhone { @property {'H'|'W'|'M'|'C'|'F'} [type] @property {string|number} number @property {string|number} [extension] } */
+/** @typedef {Object} CustomerEmail { @property {string} address } */
+/** @typedef {Object} CustomerBirthDate { @property {'P'|'S'} [type] @property {string} date } */
+/** @typedef {Object} CustomerSSN { @property {'P'|'S'} [type] @property {string} ssn } */
+/** @typedef {Object} CustomerDriver { @property {'P'|'S'} [type] @property {string} licenseNumber @property {string} [licenseState] @property {string} [licenseExpDate] } */
+/** @typedef {Object} CustomerChild { @property {string} name } */
+/** @typedef {Object} CustomerPersonal { @property {'M'|'F'|'U'} [gender] @property {string} [otherName] @property {string} [anniversaryDate] @property {string} [employerName] @property {string} [employerPhone] @property {string} [occupation] @property {string} [optOut] @property {string} [optOutUse] @property {CustomerBirthDate[]} [birthDates] @property {CustomerSSN[]} [ssns] @property {CustomerDriver} [driver] @property {CustomerChild[]} [children] } */
+/** @typedef {Object} CustomerDmsFollowup { @property {string} type @property {string} value } */
+/** @typedef {Object} CustomerDmsInfo { @property {string} [taxExemptNum] @property {string} [salesTerritory] @property {string} [deliveryRoute] @property {string} [salesmanNum] @property {string} [lastContactMethod] @property {CustomerDmsFollowup[]} [followups] } */
+/** @typedef {Object} InsertCustomerPayload
+ * @property {'I'|'B'} [ibFlag] Individual/Business flag (auto-inferred if omitted)
+ * @property {'R'|'W'|'I'|'Retail'|'Wholesale'|'Internal'} [customerType] Customer type
+ * @property {string} [createdBy] Username or identifier creating the record
+ * @property {string} [customerName] Business name (alias for lastName when business)
+ * @property {string} [lastName] Last name or business name
+ * @property {string} [firstName] First name (required for individuals)
+ * @property {string} [midName] Middle name
+ * @property {string} [salut] Salutation
+ * @property {string} [suffix] Suffix
+ * @property {CustomerAddress[]} [addresses] Addresses list (line1 required per address)
+ * @property {CustomerPhone[]} [phones] Phone numbers list (number required per phone)
+ * @property {CustomerEmail[]} [emails] Email list (first entry used)
+ * @property {CustomerPersonal} [personal] Personal details
+ * @property {CustomerDmsInfo} [dms] DMS-specific supplemental info
+ */
+/** @typedef {InsertCustomerPayload & { nameRecId: string|number }} UpdateCustomerPayload */
+/** @typedef {Object} CustomerResponseData { @property {string|undefined} dmsRecKey @property {string|undefined} status @property {string|undefined} statusCode } */
+
+/** @typedef {Object} ServiceVehicleDetail { @property {string} [licNo] } */
+/** @typedef {Object} ServiceVehicleWarranty { @property {string} [contractNumber] @property {string} [expirationDate] @property {string|number} [expirationMileage] } */
+/** @typedef {Object} ServiceVehicleAdvisorContactInfo { @property {string|number} nameRecId } */
+/** @typedef {Object} ServiceVehicleServInfo { @property {string|number} customerNo @property {string|number} [salesmanNo] @property {string|number} [inServiceDate] @property {string|number} [mileage] @property {string} [teamCode] @property {ServiceVehicleWarranty} [vehExtWarranty] @property {{contactInfo?: ServiceVehicleAdvisorContactInfo}} [advisor] } */
+/** @typedef {Object} InsertServiceVehiclePayload { @property {string} vin @property {string} [modelDesc] @property {string} [carline] @property {string} [extClrDesc] @property {string} [intClrDesc] @property {string} [trimDesc] @property {string} [bodyStyle] @property {string} [engineDesc] @property {string} [transDesc] @property {string|number} [year] @property {string|number} [odometer] @property {string} [odometerUnits] @property {ServiceVehicleDetail} [vehicleDetail] @property {ServiceVehicleServInfo} vehicleServInfo } */
+/** @typedef {Object} ServiceVehicleResponseData { @property {string|undefined} status @property {string|undefined} statusCode } */
+
+/** @typedef {Object} RepairOrderEstimate { @property {string|number} [parts] @property {string|number} [labor] @property {string|number} [total] @property {string} [estimateType] } */
+/** @typedef {Object} RepairOrderTax { @property {'All'|'Cust'|'Intr'|'Warr'} [payType] @property {string} [taxCode] @property {string|number} [txblGrossAmt] @property {string|number} [grossTaxAmt] } */
+/** @typedef {Object} RepairOrderLaborBill { @property {'All'|'Cust'|'Intr'|'Warr'} [payType] @property {string|number} [jobTotalHrs] @property {string|number} [billTime] @property {string|number} [billRate] } */
+/** @typedef {Object} RepairOrderLaborCCC { @property {string} [cause] @property {string} [complaint] @property {string} [correction] } */
+/** @typedef {Object} RepairOrderLaborAmount { @property {'All'|'Cust'|'Intr'|'Warr'} [payType] @property {string} [amtType] @property {string|number} [custPrice] @property {string|number} [totalAmt] } */
+/** @typedef {Object} RepairOrderLaborOp { @property {string} [opCode] @property {string|number} [jobNo] @property {'T'|'N'} [custTxblNtxblFlag] @property {'T'|'N'} [warrTxblNtxblFlag] @property {'T'|'N'} [intrTxblNtxblFlag] @property {string} [custPayTypeFlag] @property {string} [warrPayTypeFlag] @property {string} [intrPayTypeFlag] @property {string} [vlrCode] @property {RepairOrderLaborBill} [bill] @property {RepairOrderLaborCCC} [ccc] @property {RepairOrderLaborAmount} [amount] } */
+/** @typedef {Object} RepairOrderLabor { @property {RepairOrderLaborOp[]} [ops] } */
+/** @typedef {Object} RepairOrderPartLine { @property {string} [partNo] @property {string} [partNoDesc] @property {string|number} [partQty] @property {string|number} [sale] @property {string|number} [cost] @property {string} [addDeleteFlag] } */
+/** @typedef {Object} RepairOrderPartJob { @property {string} [opCode] @property {string|number} [jobNo] @property {RepairOrderPartLine[]} [lines] } */
+/** @typedef {Object} RepairOrderPart { @property {RepairOrderPartJob[]} [jobs] } */
+/** @typedef {Object} RepairOrderGGLineAmount { @property {'All'|'Cust'|'Intr'|'Warr'} [payType] @property {string} [amtType] @property {string|number} [custPrice] @property {string|number} [dlrCost] } */
+/** @typedef {Object} RepairOrderGGLine { @property {string} [breakOut] @property {'G'|'P'|'S'|'F'} [itemType] @property {string} [itemDesc] @property {string|number} [custQty] @property {string|number} [warrQty] @property {string|number} [intrQty] @property {'T'|'N'} [custTxblNtxblFlag] @property {'T'|'N'} [warrTxblNtxblFlag] @property {'T'|'N'} [intrTxblNtxblFlag] @property {string} [custPayTypeFlag] @property {string} [warrPayTypeFlag] @property {string} [intrPayTypeFlag] @property {RepairOrderGGLineAmount} [amount] } */
+/** @typedef {Object} RepairOrderGGOp { @property {string} [opCode] @property {string|number} [jobNo] @property {RepairOrderGGLine[]} [lines] } */
+/** @typedef {Object} RepairOrderGG { @property {string|number} [roNo] @property {RepairOrderGGOp[]} [ops] } */
+/** @typedef {Object} RepairOrderMiscLine { @property {string} [miscCode] @property {'T'|'N'} [custTxblNtxblFlag] @property {'T'|'N'} [warrTxblNtxblFlag] @property {'T'|'N'} [intrTxblNtxblFlag] @property {string} [custPayTypeFlag] @property {string} [warrPayTypeFlag] @property {string} [intrPayTypeFlag] @property {string|number} [codeAmt] } */
+/** @typedef {Object} RepairOrderMiscOp { @property {string} [opCode] @property {string|number} [jobNo] @property {RepairOrderMiscLine[]} [lines] } */
+/** @typedef {Object} RepairOrderMisc { @property {string|number} [roNo] @property {RepairOrderMiscOp[]} [ops] } */
+/** @typedef {Object} CreateRepairOrderPayload
+ * @property {string|number} customerNo Customer number (CustNo)
+ * @property {string|number} departmentType Department type (DeptType)
+ * @property {string} vin Vehicle VIN (Vin)
+ * @property {string|number} outsdRoNo External RO identifier
+ * @property {string|number} [advisorNo] Advisor number
+ * @property {string|number} [tagNo] Tag number
+ * @property {string|number} [mileageIn] Mileage in value
+ * @property {string} [roComment] Repair order comment
+ * @property {RepairOrderEstimate} [estimate] Repair order estimate block
+ * @property {RepairOrderTax} [tax] Tax block
+ * @property {RepairOrderLabor} [rolabor] Labor operations
+ * @property {RepairOrderPart} [ropart] Parts jobs/lines
+ * @property {RepairOrderGG} [rogg] General goods lines
+ * @property {RepairOrderMisc} [romisc] Miscellaneous charges
+ */
+/** @typedef {Object} UpdateRepairOrderPayload { @property {'Y'|'N'} finalUpdate @property {string|number} outsdRoNo @property {string|number} [roNo] @property {string|number} [customerNo] @property {string|number} [tagNo] @property {string|number} [departmentType] @property {string} [vin] @property {string|number} [mileageIn] @property {string|number} [mileageOut] @property {string} [roComment] @property {RepairOrderEstimate} [estimate] @property {RepairOrderTax} [tax] @property {RepairOrderLabor} [rolabor] @property {RepairOrderPart} [ropart] @property {RepairOrderGG} [rogg] @property {RepairOrderMisc} [romisc] } */
+/** @typedef {Object} RepairOrderData { @property {string|undefined} status @property {string|undefined} date @property {string|undefined} time @property {string|undefined} outsdRoNo @property {string|undefined} dmsRoNo @property {string|undefined} errorMessage } */
+
+/** @typedef {Object} GetAdvisorsParams { @property {'S'|'P'|'B'|'SERVICE'|'PARTS'|'BODY'|'BODYSHOP'|'BODY SHOP'} department @property {string|number} [advisorNumber] @property {number} [maxResults] } */
+/** @typedef {Object} AdvisorRow { @property {string|number|undefined} advisorId @property {string|undefined} firstName @property {string|undefined} lastName @property {'S'|'P'|'B'|undefined} department } */
+/** @typedef {Object} GetPartsParams { @property {string|number} roNumber } */
+/** @typedef {Object} PartRow { @property {string|undefined} partNumber @property {string|undefined} partDescription @property {string|number|undefined} quantityOrdered @property {string|number|undefined} quantityShipped @property {string|number|undefined} price @property {string|number|undefined} cost @property {string|undefined} processedFlag @property {string|undefined} addOrDelete } */
+
+// Marker exports (no runtime impact)
+export const _extendedTypesDoc = null;

server/rr/rr-calculate-allocations.js

@@ -0,0 +1,923 @@
+/**
+ * THIS IS A COPY of CDKCalculateAllocations, modified to:
+ *  - Only calculate allocations needed for Reynolds & RR exports
+ *  - Keep sales broken down into buckets (parts, taxable labor, non-taxable labor, extras)
+ *  - Add extra logging for easier debugging
+ *
+ * Original comments follow.
+ */
+
+const { GraphQLClient } = require("graphql-request");
+const Dinero = require("dinero.js");
+const _ = require("lodash");
+
+const queries = require("../graphql-client/queries");
+const CreateRRLogEvent = require("./rr-logger-event");
+const InstanceManager = require("../utils/instanceMgr").default;
+
+const { DiscountNotAlreadyCounted } = InstanceManager({
+  imex: require("../job/job-totals"),
+  rome: require("../job/job-totals-USA")
+});
+
+/**
+ * ============================
+ *  Helpers / Summarizers
+ * ============================
+ */
+
+const summarizeMoney = (dinero) => {
+  if (!dinero || typeof dinero.getAmount !== "function") return { cents: null };
+  return { cents: dinero.getAmount() };
+};
+
+const summarizeTaxAllocations = (tax) =>
+  Object.entries(tax || {}).map(([key, entry]) => ({
+    key,
+    sale: summarizeMoney(entry?.sale),
+    cost: summarizeMoney(entry?.cost)
+  }));
+
+const summarizeAllocationsArray = (arr) =>
+  (arr || []).map((a) => ({
+    center: a.center || a.tax || null,
+    tax: a.tax || null,
+    sale: summarizeMoney(a.sale || a.totalSale || Dinero()),
+    cost: summarizeMoney(a.cost)
+  }));
+
+/**
+ * Internal per-center bucket shape for *sales*.
+ * We keep separate buckets for RR so we can split
+ * taxable vs non-taxable labor lines later.
+ */
+function emptyCenterBucket() {
+  const zero = Dinero();
+  return {
+    partsSale: zero, // parts sale
+    laborTaxableSale: zero, // labor that should be taxed in RR
+    laborNonTaxableSale: zero, // labor that should NOT be taxed in RR
+    extrasSale: zero // MAPA/MASH/towing/storage/PAO/etc
+  };
+}
+
+function ensureCenterBucket(hash, center) {
+  if (!hash[center]) hash[center] = emptyCenterBucket();
+  return hash[center];
+}
+
+/**
+ * Thin logger wrapper: always uses CreateRRLogEvent,
+ * with structured data passed via meta arg.
+ */
+function createDebugLogger(connectionData) {
+  return (msg, meta, level = "DEBUG") => {
+    const baseMsg = "rr-calculate-allocations " + msg;
+    CreateRRLogEvent(connectionData, level, baseMsg, meta !== undefined ? meta : undefined);
+  };
+}
+
+/**
+ * Query job data for allocations.
+ */
+async function QueryJobData(connectionData, token, jobid) {
+  CreateRRLogEvent(connectionData, "DEBUG", "Querying job data for allocations", { jobid });
+
+  const client = new GraphQLClient(process.env.GRAPHQL_ENDPOINT, {});
+  const result = await client.setHeaders({ Authorization: token }).request(queries.GET_CDK_ALLOCATIONS, { id: jobid });
+
+  return result.jobs_by_pk;
+}
+
+/**
+ * Build tax allocation object depending on environment (imex vs rome).
+ * This matches the original logic, just split into its own helper.
+ */
+function buildTaxAllocations(bodyshop, job) {
+  return InstanceManager({
+    executeFunction: true,
+    deubg: true,
+    args: [],
+    imex: () => ({
+      state: {
+        center: bodyshop.md_responsibility_centers.taxes.state.name,
+        sale: Dinero(job.job_totals.totals.state_tax),
+        cost: Dinero(),
+        profitCenter: bodyshop.md_responsibility_centers.taxes.state,
+        costCenter: bodyshop.md_responsibility_centers.taxes.state
+      },
+      federal: {
+        center: bodyshop.md_responsibility_centers.taxes.federal.name,
+        sale: Dinero(job.job_totals.totals.federal_tax),
+        cost: Dinero(),
+        profitCenter: bodyshop.md_responsibility_centers.taxes.federal,
+        costCenter: bodyshop.md_responsibility_centers.taxes.federal
+      }
+    }),
+    rome: () => ({
+      tax_ty1: {
+        center: bodyshop.md_responsibility_centers.taxes.tax_ty1.name,
+        sale: Dinero(job.job_totals.totals.us_sales_tax_breakdown.ty1Tax),
+        cost: Dinero(),
+        profitCenter: bodyshop.md_responsibility_centers.taxes.tax_ty1,
+        costCenter: bodyshop.md_responsibility_centers.taxes.tax_ty1
+      },
+      tax_ty2: {
+        center: bodyshop.md_responsibility_centers.taxes.tax_ty2.name,
+        sale: Dinero(job.job_totals.totals.us_sales_tax_breakdown.ty2Tax),
+        cost: Dinero(),
+        profitCenter: bodyshop.md_responsibility_centers.taxes.tax_ty2,
+        costCenter: bodyshop.md_responsibility_centers.taxes.tax_ty2
+      },
+      tax_ty3: {
+        center: bodyshop.md_responsibility_centers.taxes.tax_ty3.name,
+        sale: Dinero(job.job_totals.totals.us_sales_tax_breakdown.ty3Tax),
+        cost: Dinero(),
+        profitCenter: bodyshop.md_responsibility_centers.taxes.tax_ty3,
+        costCenter: bodyshop.md_responsibility_centers.taxes.tax_ty3
+      },
+      tax_ty4: {
+        center: bodyshop.md_responsibility_centers.taxes.tax_ty4.name,
+        sale: Dinero(job.job_totals.totals.us_sales_tax_breakdown.ty4Tax),
+        cost: Dinero(),
+        profitCenter: bodyshop.md_responsibility_centers.taxes.tax_ty4,
+        costCenter: bodyshop.md_responsibility_centers.taxes.tax_ty4
+      },
+      tax_ty5: {
+        center: bodyshop.md_responsibility_centers.taxes.tax_ty5.name,
+        sale: Dinero(job.job_totals.totals.us_sales_tax_breakdown.ty5Tax),
+        cost: Dinero(),
+        profitCenter: bodyshop.md_responsibility_centers.taxes.tax_ty5,
+        costCenter: bodyshop.md_responsibility_centers.taxes.tax_ty5
+      }
+    })
+  });
+}
+
+/**
+ * Decide if a labor line is taxable vs non-taxable for RR.
+ */
+function isLaborTaxable(line) {
+  return line.tax_part;
+}
+
+/**
+ * Build profitCenterHash from joblines (parts + labor) and detect MAPA/MASH presence.
+ * Now stores *buckets* instead of a single Dinero per center.
+ */
+function buildProfitCenterHash(job, debugLog) {
+  let hasMapaLine = false;
+  let hasMashLine = false;
+
+  const profitCenterHash = job.joblines.reduce((acc, val) => {
+    // MAPA line?
+    if (val.db_ref === "936008") {
+      if (!hasMapaLine) {
+        debugLog("Detected existing MAPA line in joblines", {
+          joblineId: val.id,
+          db_ref: val.db_ref
+        });
+      }
+      hasMapaLine = true;
+    }
+
+    // MASH line?
+    if (val.db_ref === "936007") {
+      if (!hasMashLine) {
+        debugLog("Detected existing MASH line in joblines", {
+          joblineId: val.id,
+          db_ref: val.db_ref
+        });
+      }
+      hasMashLine = true;
+    }
+
+    // Parts
+    if (val.profitcenter_part) {
+      const bucket = ensureCenterBucket(acc, val.profitcenter_part);
+
+      let amount = Dinero({
+        amount: Math.round(val.act_price * 100)
+      }).multiply(val.part_qty || 1);
+
+      const hasDiscount = (val.prt_dsmk_m && val.prt_dsmk_m !== 0) || (val.prt_dsmk_p && val.prt_dsmk_p !== 0);
+
+      if (hasDiscount && DiscountNotAlreadyCounted(val, job.joblines)) {
+        const discount = val.prt_dsmk_m
+          ? Dinero({ amount: Math.round(val.prt_dsmk_m * 100) })
+          : Dinero({
+              amount: Math.round(val.act_price * 100)
+            })
+              .multiply(val.part_qty || 0)
+              .percentage(Math.abs(val.prt_dsmk_p || 0))
+              .multiply(val.prt_dsmk_p > 0 ? 1 : -1);
+
+        amount = amount.add(discount);
+      }
+
+      bucket.partsSale = bucket.partsSale.add(amount);
+    }
+
+    // Labor
+    if (val.profitcenter_labor && val.mod_lbr_ty) {
+      const bucket = ensureCenterBucket(acc, val.profitcenter_labor);
+
+      const rateKey = `rate_${val.mod_lbr_ty.toLowerCase()}`;
+      const rate = job[rateKey];
+
+      const laborAmount = Dinero({
+        amount: Math.round(rate * 100)
+      }).multiply(val.mod_lb_hrs);
+
+      if (isLaborTaxable(val)) {
+        bucket.laborTaxableSale = bucket.laborTaxableSale.add(laborAmount);
+      } else {
+        bucket.laborNonTaxableSale = bucket.laborNonTaxableSale.add(laborAmount);
+      }
+    }
+
+    return acc;
+  }, {});
+
+  debugLog("profitCenterHash after joblines", {
+    hasMapaLine,
+    hasMashLine,
+    centers: Object.entries(profitCenterHash).map(([center, b]) => ({
+      center,
+      parts: summarizeMoney(b.partsSale),
+      laborTaxable: summarizeMoney(b.laborTaxableSale),
+      laborNonTaxable: summarizeMoney(b.laborNonTaxableSale),
+      extras: summarizeMoney(b.extrasSale)
+    }))
+  });
+
+  return { profitCenterHash, hasMapaLine, hasMashLine };
+}
+
+/**
+ * Build costCenterHash from bills and timetickets.
+ */
+function buildCostCenterHash(job, selectedDmsAllocationConfig, disablebillwip, debugLog) {
+  let costCenterHash = {};
+
+  // 1) Bills -> costs
+  debugLog("disablebillwip flag", { disablebillwip });
+
+  if (!disablebillwip) {
+    costCenterHash = job.bills.reduce((billAcc, bill) => {
+      bill.billlines.forEach((line) => {
+        const targetCenter = selectedDmsAllocationConfig.costs[line.cost_center];
+        if (!targetCenter) return;
+
+        if (!billAcc[targetCenter]) billAcc[targetCenter] = Dinero();
+
+        const lineDinero = Dinero({
+          amount: Math.round((line.actual_cost || 0) * 100)
+        })
+          .multiply(line.quantity)
+          .multiply(bill.is_credit_memo ? -1 : 1);
+
+        billAcc[targetCenter] = billAcc[targetCenter].add(lineDinero);
+      });
+      return billAcc;
+    }, {});
+  }
+
+  debugLog("costCenterHash after bills (pre-timetickets)", {
+    centers: Object.entries(costCenterHash || {}).map(([center, dinero]) => ({
+      center,
+      ...summarizeMoney(dinero)
+    }))
+  });
+
+  // 2) Timetickets -> costs
+  job.timetickets.forEach((ticket) => {
+    const effectiveHours =
+      ticket.employee && ticket.employee.flat_rate ? ticket.productivehrs || 0 : ticket.actualhrs || 0;
+
+    const ticketTotal = Dinero({
+      amount: Math.round(ticket.rate * effectiveHours * 100)
+    });
+
+    const targetCenter = selectedDmsAllocationConfig.costs[ticket.ciecacode];
+    if (!targetCenter) return;
+
+    if (!costCenterHash[targetCenter]) costCenterHash[targetCenter] = Dinero();
+    costCenterHash[targetCenter] = costCenterHash[targetCenter].add(ticketTotal);
+  });
+
+  debugLog("costCenterHash after timetickets", {
+    centers: Object.entries(costCenterHash || {}).map(([center, dinero]) => ({
+      center,
+      ...summarizeMoney(dinero)
+    }))
+  });
+
+  return costCenterHash;
+}
+
+/**
+ * Add manual MAPA / MASH sales where needed (into extrasSale bucket).
+ */
+function applyMapaMashManualLines({
+  job,
+  selectedDmsAllocationConfig,
+  bodyshop,
+  profitCenterHash,
+  hasMapaLine,
+  hasMashLine,
+  debugLog
+}) {
+  // MAPA
+  if (!hasMapaLine && job.job_totals.rates.mapa.total.amount > 0) {
+    const mapaAccountName = selectedDmsAllocationConfig.profits.MAPA;
+    const mapaAccount = bodyshop.md_responsibility_centers.profits.find((c) => c.name === mapaAccountName);
+
+    if (mapaAccount) {
+      debugLog("Adding MAPA Line Manually", {
+        mapaAccountName,
+        amount: summarizeMoney(Dinero(job.job_totals.rates.mapa.total))
+      });
+
+      const bucket = ensureCenterBucket(profitCenterHash, mapaAccountName);
+      bucket.extrasSale = bucket.extrasSale.add(Dinero(job.job_totals.rates.mapa.total));
+    } else {
+      debugLog("NO MAPA ACCOUNT FOUND!!", { mapaAccountName });
+    }
+  }
+
+  // MASH
+  if (!hasMashLine && job.job_totals.rates.mash.total.amount > 0) {
+    const mashAccountName = selectedDmsAllocationConfig.profits.MASH;
+    const mashAccount = bodyshop.md_responsibility_centers.profits.find((c) => c.name === mashAccountName);
+
+    if (mashAccount) {
+      debugLog("Adding MASH Line Manually", {
+        mashAccountName,
+        amount: summarizeMoney(Dinero(job.job_totals.rates.mash.total))
+      });
+
+      const bucket = ensureCenterBucket(profitCenterHash, mashAccountName);
+      bucket.extrasSale = bucket.extrasSale.add(Dinero(job.job_totals.rates.mash.total));
+    } else {
+      debugLog("NO MASH ACCOUNT FOUND!!", { mashAccountName });
+    }
+  }
+
+  return profitCenterHash;
+}
+
+/**
+ * Apply materials costing (MAPA/MASH cost side) when configured.
+ */
+function applyMaterialsCosting({ job, bodyshop, selectedDmsAllocationConfig, costCenterHash, debugLog }) {
+  const { cdk_configuration } = bodyshop || {};
+
+  if (!cdk_configuration?.sendmaterialscosting) return costCenterHash;
+
+  debugLog("sendmaterialscosting enabled", {
+    sendmaterialscosting: cdk_configuration.sendmaterialscosting,
+    use_paint_scale_data: job.bodyshop.use_paint_scale_data,
+    mixdataLength: job.mixdata?.length || 0
+  });
+
+  const percent = cdk_configuration.sendmaterialscosting;
+
+  // Paint Mat (MAPA)
+  const mapaAccountName = selectedDmsAllocationConfig.costs.MAPA;
+  const mapaAccount = bodyshop.md_responsibility_centers.costs.find((c) => c.name === mapaAccountName);
+
+  if (mapaAccount) {
+    if (!costCenterHash[mapaAccountName]) costCenterHash[mapaAccountName] = Dinero();
+
+    if (job.bodyshop.use_paint_scale_data === true) {
+      if (job.mixdata && job.mixdata.length > 0) {
+        debugLog("Using mixdata for MAPA cost", {
+          mapaAccountName,
+          totalliquidcost: job.mixdata[0] && job.mixdata[0].totalliquidcost
+        });
+
+        costCenterHash[mapaAccountName] = costCenterHash[mapaAccountName].add(
+          Dinero({
+            amount: Math.round(((job.mixdata[0] && job.mixdata[0].totalliquidcost) || 0) * 100)
+          })
+        );
+      } else {
+        debugLog("Using percentage of MAPA total (no mixdata)", { mapaAccountName });
+
+        costCenterHash[mapaAccountName] = costCenterHash[mapaAccountName].add(
+          Dinero(job.job_totals.rates.mapa.total).percentage(percent)
+        );
+      }
+    } else {
+      debugLog("Using percentage of MAPA total (no paint scale data)", { mapaAccountName });
+
+      costCenterHash[mapaAccountName] = costCenterHash[mapaAccountName].add(
+        Dinero(job.job_totals.rates.mapa.total).percentage(percent)
+      );
+    }
+  } else {
+    debugLog("NO MAPA ACCOUNT FOUND (costs)!!", { mapaAccountName });
+  }
+
+  // Shop Mat (MASH)
+  const mashAccountName = selectedDmsAllocationConfig.costs.MASH;
+  const mashAccount = bodyshop.md_responsibility_centers.costs.find((c) => c.name === mashAccountName);
+
+  if (mashAccount) {
+    debugLog("Adding MASH material costing", { mashAccountName });
+
+    if (!costCenterHash[mashAccountName]) costCenterHash[mashAccountName] = Dinero();
+    costCenterHash[mashAccountName] = costCenterHash[mashAccountName].add(
+      Dinero(job.job_totals.rates.mash.total).percentage(percent)
+    );
+  } else {
+    debugLog("NO MASH ACCOUNT FOUND (costs)!!", { mashAccountName });
+  }
+
+  return costCenterHash;
+}
+
+/**
+ * Apply non-tax extras (PVRT, towing, storage, PAO).
+ * Extras go into the extrasSale bucket.
+ */
+function applyExtras({ job, bodyshop, selectedDmsAllocationConfig, profitCenterHash, taxAllocations, debugLog }) {
+  const { ca_bc_pvrt } = job;
+
+  // BC PVRT -> state tax
+  if (ca_bc_pvrt) {
+    debugLog("Adding PVRT to state tax allocation", { ca_bc_pvrt });
+
+    taxAllocations.state.sale = taxAllocations.state.sale.add(Dinero({ amount: Math.round((ca_bc_pvrt || 0) * 100) }));
+  }
+
+  // Towing
+  if (job.towing_payable && job.towing_payable !== 0) {
+    const towAccountName = selectedDmsAllocationConfig.profits.TOW;
+    const towAccount = bodyshop.md_responsibility_centers.profits.find((c) => c.name === towAccountName);
+
+    if (towAccount) {
+      debugLog("Adding towing_payable to TOW account", {
+        towAccountName,
+        towing_payable: job.towing_payable
+      });
+
+      const bucket = ensureCenterBucket(profitCenterHash, towAccountName);
+      bucket.extrasSale = bucket.extrasSale.add(
+        Dinero({
+          amount: Math.round((job.towing_payable || 0) * 100)
+        })
+      );
+    } else {
+      debugLog("NO TOW ACCOUNT FOUND!!", { towAccountName });
+    }
+  }
+
+  // Storage (shares TOW account)
+  if (job.storage_payable && job.storage_payable !== 0) {
+    const storageAccountName = selectedDmsAllocationConfig.profits.TOW;
+    const towAccount = bodyshop.md_responsibility_centers.profits.find((c) => c.name === storageAccountName);
+
+    if (towAccount) {
+      debugLog("Adding storage_payable to TOW account", {
+        storageAccountName,
+        storage_payable: job.storage_payable
+      });
+
+      const bucket = ensureCenterBucket(profitCenterHash, storageAccountName);
+      bucket.extrasSale = bucket.extrasSale.add(
+        Dinero({
+          amount: Math.round((job.storage_payable || 0) * 100)
+        })
+      );
+    } else {
+      debugLog("NO STORAGE/TOW ACCOUNT FOUND!!", { storageAccountName });
+    }
+  }
+
+  // Bottom line adjustment -> PAO
+  if (job.adjustment_bottom_line && job.adjustment_bottom_line !== 0) {
+    const otherAccountName = selectedDmsAllocationConfig.profits.PAO;
+    const otherAccount = bodyshop.md_responsibility_centers.profits.find((c) => c.name === otherAccountName);
+
+    if (otherAccount) {
+      debugLog("Adding adjustment_bottom_line to PAO", {
+        otherAccountName,
+        adjustment_bottom_line: job.adjustment_bottom_line
+      });
+
+      const bucket = ensureCenterBucket(profitCenterHash, otherAccountName);
+      bucket.extrasSale = bucket.extrasSale.add(
+        Dinero({
+          amount: Math.round((job.adjustment_bottom_line || 0) * 100)
+        })
+      );
+    } else {
+      debugLog("NO PAO ACCOUNT FOUND!!", { otherAccountName });
+    }
+  }
+
+  return { profitCenterHash, taxAllocations };
+}
+
+/**
+ * Apply Rome-specific profile adjustments (parts + rates).
+ * These also feed into the *sales* buckets.
+ */
+/**
+ * Apply Rome-specific profile adjustments (parts + rates).
+ * These also feed into the *sales* buckets.
+ */
+/**
+ * Apply Rome-specific profile adjustments (parts + rates).
+ * These also feed into the *sales* buckets.
+ */
+function applyRomeProfileAdjustments({
+  job,
+  bodyshop,
+  selectedDmsAllocationConfig,
+  profitCenterHash,
+  debugLog,
+  connectionData
+}) {
+  // Only relevant for Rome instances
+  if (!InstanceManager({ rome: true })) return profitCenterHash;
+
+  if (!selectedDmsAllocationConfig || !selectedDmsAllocationConfig.profits) {
+    debugLog("ROME profile adjustments skipped (no selectedDmsAllocationConfig.profits)");
+    return profitCenterHash;
+  }
+
+  const partsAdjustments = job?.job_totals?.parts?.adjustments || {};
+  const rateMap = job?.job_totals?.rates || {};
+
+  debugLog("ROME profile adjustments block entered", {
+    partAdjustmentKeys: Object.keys(partsAdjustments),
+    rateKeys: Object.keys(rateMap)
+  });
+
+  // Parts adjustments
+  Object.keys(partsAdjustments).forEach((key) => {
+    const accountName = selectedDmsAllocationConfig.profits[key];
+    const otherAccount = bodyshop.md_responsibility_centers.profits.find((c) => c.name === accountName);
+
+    if (otherAccount) {
+      const bucket = ensureCenterBucket(profitCenterHash, accountName);
+
+      const adjMoney = Dinero(partsAdjustments[key]);
+      bucket.extrasSale = bucket.extrasSale.add(adjMoney);
+
+      debugLog("Added parts adjustment", {
+        key,
+        accountName,
+        adjustment: summarizeMoney(adjMoney)
+      });
+    } else {
+      CreateRRLogEvent(
+        connectionData,
+        "ERROR",
+        "Error encountered in rr-calculate-allocations. Unable to find parts adjustment account.",
+        { accountName, key }
+      );
+      debugLog("Missing parts adjustment account", { key, accountName });
+    }
+  });
+
+  // Labor / materials adjustments (match CDK semantics: check `adjustment`, add `adjustments`)
+  Object.keys(rateMap).forEach((key) => {
+    const rate = rateMap[key];
+    if (!rate || !rate.adjustment) return;
+
+    const checkMoney = Dinero(rate.adjustment);
+    if (checkMoney.isZero()) return;
+
+    const accountName = selectedDmsAllocationConfig.profits[key.toUpperCase()];
+    const otherAccount = bodyshop.md_responsibility_centers.profits.find((c) => c.name === accountName);
+
+    if (otherAccount) {
+      const bucket = ensureCenterBucket(profitCenterHash, accountName);
+
+      // Note: we intentionally use `rate.adjustments` here to mirror CDK behaviour
+      const adjMoney = Dinero(rate.adjustments);
+      bucket.extrasSale = bucket.extrasSale.add(adjMoney);
+
+      debugLog("Added rate adjustment", {
+        key,
+        accountName,
+        adjustment: summarizeMoney(adjMoney)
+      });
+    } else {
+      CreateRRLogEvent(
+        connectionData,
+        "ERROR",
+        "Error encountered in rr-calculate-allocations. Unable to find rate adjustment account.",
+        { accountName, key }
+      );
+      debugLog("Missing rate adjustment account", { key, accountName });
+    }
+  });
+
+  return profitCenterHash;
+}
+
+/**
+ * Build job-level profit/cost allocations for each center.
+ * PUBLIC SHAPE (for RR):
+ *   {
+ *     center,
+ *     partsSale,
+ *     laborTaxableSale,
+ *     laborNonTaxableSale,
+ *     extrasSale,
+ *     totalSale,
+ *     cost,
+ *     profitCenter,
+ *     costCenter
+ *   }
+ */
+function buildJobAllocations(bodyshop, profitCenterHash, costCenterHash, debugLog) {
+  const centers = _.union(Object.keys(profitCenterHash), Object.keys(costCenterHash));
+
+  const jobAllocations = centers.map((center) => {
+    const bucket = profitCenterHash[center] || emptyCenterBucket();
+
+    const totalSale = bucket.partsSale
+      .add(bucket.laborTaxableSale)
+      .add(bucket.laborNonTaxableSale)
+      .add(bucket.extrasSale);
+
+    const profitCenter = bodyshop.md_responsibility_centers.profits.find((c) => c.name === center);
+    const costCenter = bodyshop.md_responsibility_centers.costs.find((c) => c.name === center);
+
+    return {
+      center,
+
+      partsSale: bucket.partsSale,
+      laborTaxableSale: bucket.laborTaxableSale,
+      laborNonTaxableSale: bucket.laborNonTaxableSale,
+      extrasSale: bucket.extrasSale,
+      totalSale,
+
+      cost: costCenterHash[center] || Dinero(),
+
+      profitCenter,
+      costCenter
+    };
+  });
+
+  debugLog(
+    "jobAllocations built",
+    jobAllocations.map((row) => ({
+      center: row.center,
+      parts: summarizeMoney(row.partsSale),
+      laborTaxable: summarizeMoney(row.laborTaxableSale),
+      laborNonTaxable: summarizeMoney(row.laborNonTaxableSale),
+      extras: summarizeMoney(row.extrasSale),
+      totalSale: summarizeMoney(row.totalSale),
+      cost: summarizeMoney(row.cost)
+    }))
+  );
+
+  return jobAllocations;
+}
+
+/**
+ * Build tax allocations array from taxAllocations hash.
+ * Shape is unchanged from original (except extra logging).
+ */
+function buildTaxAllocArray(taxAllocations, selectedDmsAllocationConfig, debugLog) {
+  const taxAllocArray = Object.keys(taxAllocations)
+    .filter((key) => taxAllocations[key].sale.getAmount() > 0 || taxAllocations[key].cost.getAmount() > 0)
+    .map((key) => {
+      if (
+        key === "federal" &&
+        selectedDmsAllocationConfig.gst_override &&
+        selectedDmsAllocationConfig.gst_override !== ""
+      ) {
+        const ret = { ...taxAllocations[key], tax: key };
+        ret.costCenter.dms_acctnumber = selectedDmsAllocationConfig.gst_override;
+        ret.profitCenter.dms_acctnumber = selectedDmsAllocationConfig.gst_override;
+        return ret;
+      }
+      return { ...taxAllocations[key], tax: key };
+    });
+
+  debugLog("taxAllocArray built", summarizeAllocationsArray(taxAllocArray));
+  return taxAllocArray;
+}
+
+/**
+ * Build adjustment allocations (ttl_adjustment + ttl_tax_adjustment).
+ */
+function buildAdjustmentAllocations(job, bodyshop, debugLog) {
+  const ttlAdjArray = job.job_totals.totals.ttl_adjustment
+    ? [
+        {
+          center: "SUB ADJ",
+          sale: Dinero(job.job_totals.totals.ttl_adjustment),
+          cost: Dinero(),
+          profitCenter: {
+            name: "SUB ADJ",
+            accountdesc: "SUB ADJ",
+            accountitem: "SUB ADJ",
+            accountname: "SUB ADJ",
+            dms_acctnumber: bodyshop.md_responsibility_centers.ttl_adjustment.dms_acctnumber
+          },
+          costCenter: {}
+        }
+      ]
+    : [];
+
+  const ttlTaxAdjArray = job.job_totals.totals.ttl_tax_adjustment
+    ? [
+        {
+          center: "TAX ADJ",
+          sale: Dinero(job.job_totals.totals.ttl_tax_adjustment),
+          cost: Dinero(),
+          profitCenter: {
+            name: "TAX ADJ",
+            accountdesc: "TAX ADJ",
+            accountitem: "TAX ADJ",
+            accountname: "TAX ADJ",
+            dms_acctnumber: bodyshop.md_responsibility_centers.ttl_tax_adjustment.dms_acctnumber
+          },
+          costCenter: {}
+        }
+      ]
+    : [];
+
+  if (ttlAdjArray.length) {
+    debugLog("ttl_adjustment allocation added", summarizeAllocationsArray(ttlAdjArray));
+  }
+  if (ttlTaxAdjArray.length) {
+    debugLog("ttl_tax_adjustment allocation added", summarizeAllocationsArray(ttlTaxAdjArray));
+  }
+
+  return { ttlAdjArray, ttlTaxAdjArray };
+}
+
+/**
+ * Core allocation calculation – RR-only, with bucketed sales.
+ *
+ * RETURN SHAPE:
+ *   {
+ *     jobAllocations,   // per-center buckets (see buildJobAllocations)
+ *     taxAllocArray,    // tax allocations
+ *     ttlAdjArray,      // ttl_adjustment allocations
+ *     ttlTaxAdjArray    // ttl_tax_adjustment allocations
+ *   }
+ */
+function calculateAllocations(connectionData, job) {
+  const { bodyshop } = job;
+  const debugLog = createDebugLogger(connectionData);
+
+  debugLog("ENTER", {
+    bodyshopId: bodyshop?.id,
+    bodyshopName: bodyshop?.name,
+    dms_allocation: job.dms_allocation,
+    hasBills: Array.isArray(job.bills) ? job.bills.length : 0,
+    joblines: Array.isArray(job.joblines) ? job.joblines.length : 0,
+    timetickets: Array.isArray(job.timetickets) ? job.timetickets.length : 0
+  });
+
+  // 1) Tax allocations
+  let taxAllocations = buildTaxAllocations(bodyshop, job);
+  debugLog("Initial taxAllocations", summarizeTaxAllocations(taxAllocations));
+
+  // 2) Profit centers from job lines + MAPA/MASH detection
+  const { profitCenterHash: initialProfitHash, hasMapaLine, hasMashLine } = buildProfitCenterHash(job, debugLog);
+
+  // 3) DMS allocation config
+  const selectedDmsAllocationConfig =
+    bodyshop.md_responsibility_centers.dms_defaults.find((d) => d.name === job.dms_allocation) || null;
+
+  CreateRRLogEvent(connectionData, "DEBUG", "Using DMS Allocation for cost export", {
+    allocationName: selectedDmsAllocationConfig && selectedDmsAllocationConfig.name
+  });
+  debugLog("Selected DMS allocation config", {
+    name: selectedDmsAllocationConfig && selectedDmsAllocationConfig.name
+  });
+
+  // 4) Cost centers from bills and timetickets
+  const disablebillwip = !!bodyshop?.pbs_configuration?.disablebillwip;
+  let costCenterHash = buildCostCenterHash(job, selectedDmsAllocationConfig, disablebillwip, debugLog);
+
+  // 5) Manual MAPA/MASH sales (when needed)
+  let profitCenterHash = applyMapaMashManualLines({
+    job,
+    selectedDmsAllocationConfig,
+    bodyshop,
+    profitCenterHash: initialProfitHash,
+    hasMapaLine,
+    hasMashLine,
+    debugLog
+  });
+
+  // 6) Materials costing (MAPA/MASH cost side)
+  costCenterHash = applyMaterialsCosting({
+    job,
+    bodyshop,
+    selectedDmsAllocationConfig,
+    costCenterHash,
+    debugLog
+  });
+
+  // 7) PVRT / towing / storage / PAO extras
+  ({ profitCenterHash, taxAllocations } = applyExtras({
+    job,
+    bodyshop,
+    selectedDmsAllocationConfig,
+    profitCenterHash,
+    taxAllocations,
+    debugLog
+  }));
+
+  // 8) Rome-only profile-level adjustments
+  profitCenterHash = applyRomeProfileAdjustments({
+    job,
+    bodyshop,
+    selectedDmsAllocationConfig,
+    profitCenterHash,
+    debugLog,
+    connectionData
+  });
+
+  debugLog("profitCenterHash before jobAllocations build", {
+    centers: Object.entries(profitCenterHash || {}).map(([center, b]) => ({
+      center,
+      parts: summarizeMoney(b.partsSale),
+      laborTaxable: summarizeMoney(b.laborTaxableSale),
+      laborNonTaxable: summarizeMoney(b.laborNonTaxableSale),
+      extras: summarizeMoney(b.extrasSale)
+    }))
+  });
+  debugLog("costCenterHash before jobAllocations build", {
+    centers: Object.entries(costCenterHash || {}).map(([center, dinero]) => ({
+      center,
+      ...summarizeMoney(dinero)
+    }))
+  });
+
+  // 9) Build job-level allocations & tax allocations
+  const jobAllocations = buildJobAllocations(bodyshop, profitCenterHash, costCenterHash, debugLog);
+  const taxAllocArray = buildTaxAllocArray(taxAllocations, selectedDmsAllocationConfig, debugLog);
+  const { ttlAdjArray, ttlTaxAdjArray } = buildAdjustmentAllocations(job, bodyshop, debugLog);
+
+  const result = {
+    jobAllocations,
+    taxAllocArray,
+    ttlAdjArray,
+    ttlTaxAdjArray
+  };
+
+  debugLog("FINAL allocations summary", {
+    jobAllocationsCount: jobAllocations.length,
+    taxAllocCount: taxAllocArray.length,
+    ttlAdjCount: ttlAdjArray.length,
+    ttlTaxAdjCount: ttlTaxAdjArray.length
+  });
+  debugLog("EXIT");
+
+  return result;
+}
+
+/**
+ * HTTP route wrapper (kept for compatibility; still logs via RR logger).
+ * Responds with { data: { jobAllocations, taxAllocArray, ttlAdjArray, ttlTaxAdjArray } }
+ */
+exports.defaultRoute = async function (req, res) {
+  try {
+    CreateRRLogEvent(req, "DEBUG", "Received request to calculate allocations", { jobid: req.body.jobid });
+
+    const jobData = await QueryJobData(req, req.BearerToken, req.body.jobid);
+    const data = calculateAllocations(req, jobData);
+    return res.status(200).json({ data });
+  } catch (error) {
+    CreateRRLogEvent(req, "ERROR", "Error encountered in rr-calculate-allocations.", {
+      message: error?.message || String(error),
+      stack: error?.stack
+    });
+    res.status(500).json({ error: `Error encountered in rr-calculate-allocations. ${error}` });
+  }
+};
+
+/**
+ * Socket entry point (what rr-job-export & rr-register-socket-events call).
+ * Reynolds-only: WSS + RR logger.
+ *
+ * Returns the same object as calculateAllocations().
+ */
+exports.default = async function (socket, jobid) {
+  try {
+    const token = `Bearer ${socket.handshake.auth.token}`;
+    const jobData = await QueryJobData(socket, token, jobid);
+    return calculateAllocations(socket, jobData);
+  } catch (error) {
+    CreateRRLogEvent(socket, "ERROR", "Error encountered in rr-calculate-allocations.", {
+      message: error?.message || String(error),
+      stack: error?.stack
+    });
+    return null;
+  }
+};

server/rr/rr-config.js

@@ -0,0 +1,47 @@
+/**
+ * Ensure a value is a non-empty string, else throw
+ * @param v
+ * @param name
+ * @returns {string}
+ */
+const requireString = (v, name) => {
+  const s = (v ?? "").toString().trim();
+  if (!s || s.toLowerCase() === "undefined" || s.toLowerCase() === "null") {
+    throw new Error(`RR config missing: ${name}`);
+  }
+  return s;
+};
+
+/**
+ * Get RR config from bodyshop record, with env fallbacks
+ * @param bodyshop
+ * @returns {{baseUrl: string, username: string, password: string, routing: {dealerNumber: string, storeNumber: string, areaNumber: string}, timeoutMs: number, retries: {max: number}}}
+ */
+const getRRConfigFromBodyshop = (bodyshop) => {
+  const baseUrl = process.env.RR_BASE_URL;
+  const username = process.env.RR_USERNAME;
+  const password = process.env.RR_PASSWORD;
+
+  const dealerNumber = bodyshop?.rr_dealerid ?? process.env.RR_DEALER_NUMBER;
+
+  const bsCfg = bodyshop?.rr_configuration || {};
+
+  const storeNumber = bsCfg?.storeNumber;
+  const areaNumber = bsCfg?.branchNumber ?? bsCfg?.areaNumber;
+
+  return {
+    baseUrl: requireString(baseUrl, "baseUrl"),
+    username: requireString(username, "username"),
+    password: requireString(password, "password"),
+    routing: {
+      dealerNumber: requireString(String(dealerNumber), "routing.dealerNumber"),
+      storeNumber: requireString(String(storeNumber), "routing.storeNumber"),
+      areaNumber: requireString(String(areaNumber), "routing.areaNumber")
+    },
+    // timeouts / retries can be adjusted here
+    timeoutMs: Number(process.env.RR_TIMEOUT_MS || 30000),
+    retries: { max: Number(process.env.RR_RETRIES_MAX || 2) }
+  };
+};
+
+module.exports = { getRRConfigFromBodyshop };

server/rr/rr-customers.js

@@ -0,0 +1,262 @@
+const { RRClient } = require("./lib/index.cjs");
+const { getRRConfigFromBodyshop } = require("./rr-config");
+const CreateRRLogEvent = require("./rr-logger-event");
+const InstanceManager = require("../utils/instanceMgr").default;
+
+/**
+ * Country code map for normalization
+ * @type {{US: string, USA: string, "UNITED STATES": string, CA: string, CAN: string, CANADA: string}}
+ */
+const COUNTRY_MAP = {
+  US: "US",
+  USA: "US",
+  "UNITED STATES": "US",
+  CA: "CA",
+  CAN: "CA",
+  CANADA: "CA"
+};
+
+/**
+ * Normalize country input to 2-char code
+ * @param v
+ * @returns {*|string}
+ */
+const toCountry2 = (v) => {
+  const s = String(v || "")
+    .trim()
+    .toUpperCase();
+  if (!s) return "US"; // sane default
+  if (COUNTRY_MAP[s]) return COUNTRY_MAP[s];
+  // fallbacks: prefer 2-char; last resort: take first 2
+  return s.length === 2 ? s : s.slice(0, 2);
+};
+
+/**
+ * Normalize phone number to 10-digit string
+ * @param num
+ * @returns {string}
+ */
+const normalizePhone = (num) => {
+  const d = String(num || "").replace(/\D/g, "");
+  const n = d.length === 11 && d.startsWith("1") ? d.slice(1) : d;
+  return n.slice(0, 10);
+};
+
+/**
+ * Normalize postal code based on country
+ * @param pc
+ * @param country
+ * @returns {string}
+ */
+const normalizePostal = (pc, country) => {
+  const s = String(pc || "").trim();
+  if (country === "US") return s.replace(/[^0-9]/g, "").slice(0, 5);
+  if (country === "CA") return s.toUpperCase().replace(/\s+/g, "").slice(0, 6);
+  return s;
+};
+
+/**
+ * Sanitize RR customer payload (addresses, phones, names)
+ * @param payload
+ * @returns {{}}
+ */
+const sanitizeRRCustomerPayload = (payload = {}) => {
+  const out = { ...payload };
+
+  out.addresses = (payload.addresses || []).map((a) => {
+    const country = toCountry2(a.country);
+    return {
+      ...a,
+      country,
+      state: String(a.state || "")
+        .toUpperCase()
+        .slice(0, 2),
+      postalCode: normalizePostal(a.postalCode, country)
+    };
+  });
+
+  out.phones = (payload.phones || []).map((p) => ({
+    ...p,
+    number: normalizePhone(p.number)
+  }));
+
+  // trim names defensively (RR has various max lengths by site config)
+  if (out.firstName) out.firstName = String(out.firstName).trim().slice(0, 30);
+  if (out.lastName) out.lastName = String(out.lastName).trim().slice(0, 30);
+
+  return out;
+};
+
+/**
+ * Build an RR client + common opts from a bodyshop row
+ * @param bodyshop
+ * @returns {{client: *, opts: {routing: {dealerNumber: *, storeNumber: *, areaNumber: *}, envelope: {sender: {component: string, task: string, referenceId: string, creator: string, senderName: string}}}}}
+ */
+const buildClientAndOpts = (bodyshop) => {
+  const cfg = getRRConfigFromBodyshop(bodyshop);
+  const client = new RRClient({
+    baseUrl: cfg.baseUrl,
+    username: cfg.username,
+    password: cfg.password,
+    timeoutMs: cfg.timeoutMs,
+    retries: cfg.retries
+  });
+
+  const opts = {
+    routing: cfg.routing,
+    envelope: {
+      sender: {
+        component: "Rome",
+        task: "CU",
+        referenceId: "Insert",
+        creator: "RCI",
+        senderName: "RCI"
+      }
+    }
+  };
+  return { client, opts };
+};
+
+/**
+ * Strip all non-digit characters from a string
+ * @param s
+ * @returns {string}
+ */
+const digitsOnly = (s) => {
+  return String(s || "").replace(/\D/g, "");
+};
+
+/**
+ * Build RR customer payload from job.ownr_* fields, with optional overrides.
+ * @param job
+ * @param overrides
+ * @returns {{ibFlag: string, firstName, lastName, customerName, createdBy, customerType, addresses: [{type, line1: *, line2, city, state, postalCode, country}], phones: {number: *}[], emails: [{address: string}]}}
+ */
+const buildCustomerPayloadFromJob = (job, overrides = {}) => {
+  // Pull ONLY from job.ownr_* fields (no job.customer.*)
+  const firstName = overrides.firstName ?? job?.ownr_fn ?? undefined;
+  const lastName = overrides.lastName ?? job?.ownr_ln ?? undefined;
+  const companyName = overrides.companyName ?? overrides.company ?? job?.ownr_co_nm ?? undefined;
+
+  // Decide Individual vs Business (caller can force via overrides.ibFlag)
+  const ibFlag = (overrides.ibFlag || (firstName ? "I" : companyName ? "B" : "I")).toUpperCase();
+
+  // Email(s)
+  const email = overrides.email ?? job?.ownr_ea ?? undefined;
+  const emails = email ? [{ address: String(email) }] : undefined;
+
+  // Phones
+  const phone1 = digitsOnly(job?.ownr_ph1);
+  const phone2 = digitsOnly(job?.ownr_ph2);
+
+  let primaryPhone = phone1 || phone2;
+  if (primaryPhone) {
+    primaryPhone = primaryPhone.slice(-10); // enforce 10 digits
+  }
+
+  const phones = primaryPhone ? [{ number: primaryPhone, type: "H" }] : [];
+
+  // Address (include only if line1 exists; template requires Addr1 if address is present)
+  const line1 = overrides.addressLine1 ?? job?.ownr_addr1 ?? undefined;
+
+  const addresses = line1
+    ? [
+        {
+          type: overrides.addressType || "P",
+          line1,
+          line2: overrides.addressLine2 ?? job?.ownr_addr2 ?? undefined,
+          city: overrides.city ?? job?.ownr_city ?? undefined,
+          state: overrides.state ?? job?.ownr_st ?? undefined,
+          postalCode: overrides.postalCode ?? job?.ownr_zip ?? undefined,
+          country: (overrides.country ?? job?.ownr_ctry ?? "CA") || undefined
+        }
+      ]
+    : undefined;
+
+  // Enforce lib requirement: lastName OR customerName
+  if (!lastName && !companyName) {
+    throw new Error(
+      "Cannot build RR customer payload: lastName or companyName is required (no ownr_ln / ownr_co_nm on job)."
+    );
+  }
+
+  const payload = {
+    ibFlag, // 'I' or 'B'
+    firstName: firstName || undefined,
+    lastName: lastName || undefined,
+    customerName: companyName || undefined,
+    createdBy: overrides.createdBy || InstanceManager({ imex: "ImEX Online", rome: "Rome Online" }),
+    customerType: overrides.customerType || "R", // Retail default
+    addresses,
+    phones,
+    emails
+  };
+
+  Object.keys(payload).forEach((k) => payload[k] === undefined && delete payload[k]);
+  return payload;
+};
+
+/**
+ * Create a customer in RR and return { customerNo, raw }.
+ * Maps data.dmsRecKey -> customerNo for compatibility with existing callers.
+ */
+const createRRCustomer = async ({ bodyshop, job, overrides = {}, socket }) => {
+  const { client, opts } = buildClientAndOpts(bodyshop);
+  const payload = buildCustomerPayloadFromJob(job, overrides);
+  const safePayload = sanitizeRRCustomerPayload(payload);
+
+  // Story step: clearly show we are about to hit Reynolds insertCustomer
+  CreateRRLogEvent(socket, "DEBUG", "{CU} insertCustomer: begin", {
+    ibFlag: safePayload.ibFlag,
+    hasAddress: Array.isArray(safePayload.addresses) && safePayload.addresses.length > 0,
+    hasPhones: Array.isArray(safePayload.phones) && safePayload.phones.length > 0,
+    hasEmails: Array.isArray(safePayload.emails) && safePayload.emails.length > 0
+  });
+
+  let response;
+  try {
+    response = await client.insertCustomer(safePayload, opts);
+    // Very noisy; only show when log level is cranked to SILLY
+    CreateRRLogEvent(socket, "SILLY", "{CU} insertCustomer: raw response", { response });
+  } catch (e) {
+    CreateRRLogEvent(socket, "ERROR", "RR insertCustomer transport error", {
+      message: e?.message,
+      code: e?.code,
+      status: e?.meta?.status || e?.status,
+      payload: safePayload
+    });
+    throw e;
+  }
+
+  const data = response?.data ?? response;
+  const trx = response?.statusBlocks?.transaction;
+
+  let customerNo = data?.dmsRecKey;
+  if (!customerNo) {
+    CreateRRLogEvent(socket, "ERROR", "RR insertCustomer returned no dmsRecKey/custNo", {
+      status: trx?.status,
+      statusCode: trx?.statusCode,
+      message: trx?.message,
+      data
+    });
+
+    throw new Error(
+      `RR insertCustomer returned no dmsRecKey (status=${trx?.status ?? "?"} code=${trx?.statusCode ?? "?"}${
+        trx?.message ? ` msg=${trx.message}` : ""
+      })`
+    );
+  }
+
+  const out = { customerNo: String(customerNo), raw: data };
+
+  CreateRRLogEvent(socket, "INFO", "{CU} insertCustomer: success", {
+    customerNo: out.customerNo,
+    status: trx || null
+  });
+
+  return out;
+};
+
+module.exports = {
+  createRRCustomer
+};

server/rr/rr-errors.js

@@ -0,0 +1,51 @@
+/**
+ * Parse vendor status code from various possible locations in the error object.
+ * @param err
+ * @returns {number|null}
+ */
+const parseVendorStatusCode = (err) => {
+  // Prefer explicit numeric props when available
+  const codeProp = err?.code ?? err?.statusCode ?? err?.meta?.status?.StatusCode ?? err?.status?.StatusCode;
+  const num = Number(codeProp);
+  if (!Number.isNaN(num) && num > 0) return num;
+
+  // Fallback: parse from message text (e.g., "... 507 CANNOT EXCEED ...")
+  const m = String(err?.message || "").match(/\b(\d{3})\b/);
+  return m ? Number(m[1]) : null;
+};
+
+/**
+ * Classify RR vendor errors into a small set of stable codes/messages for the FE.
+ * @param {any} err
+ * @returns {{vendorStatusCode:number|null, errorCode:string, title:string, friendlyMessage:string, severity:'info'|'warning'|'error', canRetry:boolean}}
+ */
+const classifyRRVendorError = (err) => {
+  const code = parseVendorStatusCode(err);
+  const rawMsg = String(err?.meta?.status?.Message || err?.status?.Message || err?.message || "").toUpperCase();
+
+  // Open RO cap exceeded
+  if (code === 507 || /MAXIMUM NUMBER OF ROS/.test(rawMsg)) {
+    return {
+      vendorStatusCode: 507,
+      errorCode: "RR_MAX_OPEN_ROS",
+      title: "Customer Open RO limit reached",
+      friendlyMessage:
+        "Reynolds has reached the maximum number of open Repair Orders for this Customer. Close or finalize an RO in Reynolds, then try again.",
+      severity: "warning",
+      canRetry: true
+    };
+  }
+
+  // Default fallback
+  return {
+    vendorStatusCode: code ?? null,
+    errorCode: "RR_VENDOR_ERROR",
+    title: "Reynolds request failed",
+    friendlyMessage:
+      "We couldn’t complete the request with Reynolds. Please try again or contact support if this persists.",
+    severity: "error",
+    canRetry: true
+  };
+};
+
+module.exports = { classifyRRVendorError };

server/rr/rr-export-logs.js

@@ -0,0 +1,190 @@
+const { GraphQLClient } = require("graphql-request");
+const queries = require("../graphql-client/queries");
+const CreateRRLogEvent = require("./rr-logger-event");
+
+/** Get bearer token from the socket (same approach used elsewhere) */
+const getAuthToken = (socket) =>
+  (socket?.data && socket.data.authToken) || (socket?.handshake?.auth && socket.handshake.auth.token) || null;
+
+/** Compact metadata for RR */
+const buildRRExportMeta = ({ result, extra = {} }) => {
+  const tx = result?.statusBlocks?.transaction;
+  const rawRoStatus = result?.roStatus || result?.data?.roStatus || null;
+
+  const roStatus =
+    rawRoStatus ||
+    (tx
+      ? {
+          status: tx.status ?? tx.Status,
+          statusCode: tx.statusCode ?? tx.StatusCode,
+          message: tx.message ?? tx.Message
+        }
+      : null);
+
+  return {
+    provider: "rr",
+    success: Boolean(
+      result?.success || (roStatus && String(roStatus.status || roStatus.Status).toUpperCase() === "SUCCESS")
+    ),
+    customerNo: result?.customerNo,
+    svId: result?.svId,
+    roStatus: roStatus && {
+      status: roStatus.status ?? roStatus.Status,
+      statusCode: roStatus.statusCode ?? roStatus.StatusCode,
+      message: roStatus.message ?? roStatus.Message
+    },
+    statusBlocks: result?.statusBlocks || undefined,
+    xml: result?.xml,
+    parsed: result?.parsed,
+    ...extra
+  };
+};
+
+/** Build a stringified JSON array for the `message` text column */
+const buildMessageJSONString = ({ error, classification, result, fallback }) => {
+  const msgs = [];
+
+  const clean = (v) => {
+    if (v == null) return null;
+    try {
+      const s = String(v).replace(/\s+/g, " ").trim();
+      return s.length ? s : null;
+    } catch {
+      return null;
+    }
+  };
+
+  const push = (v) => {
+    const s = clean(v);
+    if (s && !msgs.includes(s)) msgs.push(s);
+  };
+
+  // Friendly first
+  push(classification?.friendlyMessage);
+  push(classification?.title);
+
+  // Error text
+  if (error instanceof Error) push(error.message);
+  else if (typeof error === "string") push(error);
+  else if (error?.message) push(error.message);
+
+  // RR status message
+  push(
+    result?.roStatus?.message ??
+      result?.roStatus?.Message ??
+      result?.statusBlocks?.transaction?.message ??
+      result?.statusBlocks?.transaction?.Message
+  );
+
+  // Fallback
+  push(fallback || "RR export failed");
+
+  const arr = msgs.length ? msgs : ["RR export failed"];
+  return JSON.stringify(arr);
+};
+
+/**
+ * Success: mark job exported + (optionally) insert a success log.
+ * Uses queries.MARK_JOB_EXPORTED (same shape as Fortellis/PBS).
+ */
+const markRRExportSuccess = async ({ socket, jobId, job, bodyshop, result, metaExtra = {} }) => {
+  const endpoint = process.env.GRAPHQL_ENDPOINT;
+  if (!endpoint) throw new Error("GRAPHQL_ENDPOINT not configured");
+  const token = getAuthToken(socket);
+  if (!token) throw new Error("Auth token missing on socket");
+
+  const client = new GraphQLClient(endpoint, {});
+  client.setHeaders({ Authorization: `Bearer ${token}` });
+
+  const exportedStatus =
+    job?.bodyshop?.md_ro_statuses?.default_exported || bodyshop?.md_ro_statuses?.default_exported || "Exported*";
+
+  const meta = buildRRExportMeta({ result, extra: metaExtra });
+
+  try {
+    await client.request(queries.MARK_JOB_EXPORTED, {
+      jobId,
+      job: {
+        status: exportedStatus,
+        date_exported: new Date()
+      },
+      log: {
+        bodyshopid: bodyshop?.id || job?.bodyshop?.id,
+        jobid: jobId,
+        successful: true,
+        useremail: socket?.user?.email || null,
+        metadata: meta,
+        message: buildMessageJSONString({ result, fallback: "RR export succeeded" })
+      },
+      bill: {
+        exported: true,
+        exported_at: new Date()
+      }
+    });
+
+    CreateRRLogEvent(socket, "INFO", "RR export: job marked exported + success log inserted", {
+      jobId,
+      exportedStatus
+    });
+  } catch (e) {
+    CreateRRLogEvent(socket, "ERROR", "RR export: failed to persist success markers/log", {
+      jobId,
+      error: e?.message
+    });
+  }
+};
+
+/**
+ * Failure: insert failure ExportsLog with `message` as JSON **string** (text column).
+ * Uses queries.INSERT_EXPORT_LOG($logs: [exportlog_insert_input!]!).
+ */
+const insertRRFailedExportLog = async ({ socket, jobId, job, bodyshop, error, classification, result }) => {
+  const endpoint = process.env.GRAPHQL_ENDPOINT;
+  if (!endpoint) throw new Error("GRAPHQL_ENDPOINT not configured");
+
+  const token = getAuthToken(socket);
+  if (!token) throw new Error("Auth token missing on socket");
+
+  const client = new GraphQLClient(endpoint, {});
+  client.setHeaders({ Authorization: `Bearer ${token}` });
+
+  const meta = buildRRExportMeta({
+    result,
+    extra: {
+      error: error?.message || String(error),
+      classification: classification || undefined
+    }
+  });
+
+  const message = buildMessageJSONString({
+    error,
+    classification,
+    result,
+    fallback: "RR export failed"
+  });
+
+  const entry = {
+    bodyshopid: bodyshop?.id || job?.bodyshop?.id,
+    jobid: jobId,
+    successful: false,
+    message, // stringified JSON array
+    useremail: socket?.user?.email || null,
+    metadata: meta
+  };
+
+  try {
+    // Your mutation expects $logs (array). Keep to that signature.
+    await client.request(queries.INSERT_EXPORT_LOG, { logs: [entry] });
+    CreateRRLogEvent(socket, "INFO", "RR export: failure log inserted", { jobId });
+  } catch (e) {
+    CreateRRLogEvent(socket, "ERROR", "RR export: failed to insert failure log", {
+      jobId,
+      error: e?.message
+    });
+  }
+};
+
+module.exports = {
+  markRRExportSuccess,
+  insertRRFailedExportLog
+};

server/rr/rr-job-export.js

@@ -0,0 +1,304 @@
+const { buildRRRepairOrderPayload } = require("./rr-job-helpers");
+const { buildClientAndOpts } = require("./rr-lookup");
+const CreateRRLogEvent = require("./rr-logger-event");
+const { extractRrResponsibilityCenters } = require("./rr-responsibility-centers");
+const CdkCalculateAllocations = require("./rr-calculate-allocations").default;
+
+/**
+ * Derive RR status information from response object.
+ * @param rrRes
+ * @returns {{status: *, statusCode: *|undefined, message}|null}
+ */
+const deriveRRStatus = (rrRes = {}) => {
+  const data = rrRes.data || {};
+  const tx = rrRes.statusBlocks && rrRes.statusBlocks.transaction;
+
+  const pick = (obj, ...keys) => {
+    if (!obj) return undefined;
+    for (const k of keys) {
+      if (obj[k] != null) return obj[k];
+    }
+    return undefined;
+  };
+
+  let status =
+    pick(data.roStatus, "status", "Status") || pick(data, "status", "Status") || pick(tx, "status", "Status");
+
+  let statusCode =
+    pick(data.roStatus, "statusCode", "StatusCode") ||
+    pick(data, "statusCode", "StatusCode") ||
+    pick(tx, "statusCode", "StatusCode");
+
+  let message = pick(data.roStatus, "message", "Message") || data.errorMessage || pick(tx, "message", "Message");
+
+  // Last resort: parse from XML if present
+  if ((!status || !message) && typeof rrRes.xml === "string") {
+    const m = rrRes.xml.match(/<(?:GenTransStatus|TransStatus)\b([^>]*)>([^<]*)<\/(?:GenTransStatus|TransStatus)>/i);
+    if (m) {
+      const attrs = m[1] || "";
+      const body = (m[2] || "").trim();
+      const statusMatch = attrs.match(/\bStatus="([^"]*)"/i);
+      const codeMatch = attrs.match(/\bStatusCode="([^"]*)"/i);
+      if (!status && statusMatch) status = statusMatch[1];
+      if (!statusCode && codeMatch) statusCode = codeMatch[1];
+      if (!message && body) message = body;
+    }
+  }
+
+  if (!status && !statusCode && !message) return null;
+
+  return {
+    status,
+    statusCode: statusCode != null && statusCode !== "" ? statusCode : undefined,
+    message: message || undefined
+  };
+};
+
+/**
+ * Step 1: Export a job to RR as a new Repair Order.
+ * @param args
+ * @returns {Promise<{success: boolean, data: *, roStatus: {status: *, statusCode: *|undefined, message}, statusBlocks: *|{}, customerNo: string, svId: *, roNo: *, xml: *}>}
+ */
+const exportJobToRR = async (args) => {
+  const { bodyshop, job, advisorNo, selectedCustomer, txEnvelope, socket, svId } = args || {};
+
+  if (!bodyshop) throw new Error("exportJobToRR: bodyshop is required");
+  if (!job) throw new Error("exportJobToRR: job is required");
+  if (advisorNo == null || String(advisorNo).trim() === "") {
+    throw new Error("exportJobToRR: advisorNo is required for RR");
+  }
+
+  // Resolve customer number (accept multiple shapes)
+  const selected = selectedCustomer?.customerNo || selectedCustomer?.custNo;
+  if (!selected) throw new Error("exportJobToRR: selectedCustomer.custNo/customerNo is required");
+
+  const { client, opts } = buildClientAndOpts(bodyshop);
+
+  // For step 1 we always "Insert" (create). Finalize handles the update.
+  const finalOpts = {
+    ...opts,
+    envelope: {
+      ...(opts?.envelope || {}),
+      sender: {
+        ...(opts?.envelope?.sender || {}),
+        task: "BSMRO",
+        referenceId: "Insert"
+      }
+    }
+  };
+
+  const story = txEnvelope?.story ? String(txEnvelope.story).trim() : null;
+  const makeOverride = txEnvelope?.makeOverride ? String(txEnvelope.makeOverride).trim() : null;
+
+  // RR-only extras
+  let rrCentersConfig = null;
+  let allocations = null;
+  let opCode = null;
+  // let taxCode = null;
+
+  // 1) Responsibility center config (for visibility / debugging)
+  try {
+    rrCentersConfig = extractRrResponsibilityCenters(bodyshop);
+
+    CreateRRLogEvent(socket, "SILLY", "RR responsibility centers resolved", {
+      hasCenters: !!bodyshop.md_responsibility_centers,
+      profitCenters: Object.keys(rrCentersConfig?.profitsByName || {}),
+      costCenters: Object.keys(rrCentersConfig?.costsByName || {}),
+      dmsCostDefaults: rrCentersConfig?.dmsCostDefaults || {},
+      dmsProfitDefaults: rrCentersConfig?.dmsProfitDefaults || {}
+    });
+  } catch (e) {
+    CreateRRLogEvent(socket, "ERROR", "Failed to resolve RR responsibility centers", {
+      message: e?.message,
+      stack: e?.stack
+    });
+  }
+
+  // 2) Allocations (sales + cost by center, with rr_* metadata already attached)
+  try {
+    const allocResult = await CdkCalculateAllocations(socket, job.id);
+
+    // We only need the per-center job allocations for RO.GOG / ROLABOR.
+    allocations = Array.isArray(allocResult?.jobAllocations) ? allocResult.jobAllocations : [];
+
+    CreateRRLogEvent(socket, "SILLY", "RR allocations resolved", {
+      hasAllocations: allocations.length > 0,
+      count: allocations.length,
+      taxAllocCount: Array.isArray(allocResult?.taxAllocArray) ? allocResult.taxAllocArray.length : 0,
+      ttlAdjCount: Array.isArray(allocResult?.ttlAdjArray) ? allocResult.ttlAdjArray.length : 0,
+      ttlTaxAdjCount: Array.isArray(allocResult?.ttlTaxAdjArray) ? allocResult.ttlTaxAdjArray.length : 0
+    });
+  } catch (e) {
+    CreateRRLogEvent(socket, "ERROR", "Failed to calculate RR allocations", {
+      message: e?.message,
+      stack: e?.stack
+    });
+    // Proceed with a header-only RO if allocations fail.
+    allocations = [];
+  }
+
+  // 3) OpCode (global, but overridable)
+  //    - baseOpCode can come from bodyshop or rrCentersConfig (you'll map it in onboarding)
+  //    - txEnvelope can carry an explicit override field (opCode/opcode/op_code)
+  const baseOpCode = bodyshop?.rr_configuration?.baseOpCode || "28TOZ"; // TODO Change / implement default handling policy
+
+  const opCodeOverride = txEnvelope?.opCode || txEnvelope?.opcode || txEnvelope?.op_code || null;
+
+  if (opCodeOverride || baseOpCode) {
+    opCode = String(opCodeOverride || baseOpCode).trim() || null;
+  }
+
+  CreateRRLogEvent(socket, "SILLY", "RR OP config resolved", {
+    opCode
+  });
+
+  // Build RO payload for create.
+  //
+  // NOTE:
+  //   - bodyshop + allocations + opCode + taxCode are used only to build the
+  //     value object expected by reynolds-rome-client (header + rogg + rolabor + tax).
+  const payload = buildRRRepairOrderPayload({
+    bodyshop,
+    job,
+    selectedCustomer: { customerNo: String(selected), custNo: String(selected) },
+    advisorNo: String(advisorNo),
+    story,
+    makeOverride,
+    allocations,
+    opCode
+  });
+
+  const response = await client.createRepairOrder(payload, finalOpts);
+
+  CreateRRLogEvent(socket, "INFO", "RR raw Repair Order created", {
+    payload,
+    response
+  });
+
+  const data = response?.data || null;
+  const statusBlocks = response?.statusBlocks || {};
+  const roStatus = deriveRRStatus(response);
+
+  const statusUpper = roStatus?.status ? String(roStatus.status).toUpperCase() : null;
+
+  let success = false;
+
+  if (statusUpper) {
+    // Treat explicit FAILURE / ERROR as hard failures
+    success = !["FAILURE", "ERROR"].includes(statusUpper);
+  } else if (typeof response?.success === "boolean") {
+    // Fallback to library boolean if no explicit status
+    success = response.success;
+  } else if (roStatus?.status) {
+    success = String(roStatus.status).toUpperCase() === "SUCCESS";
+  }
+
+  // Extract canonical roNo you'll need for finalize step
+  const roNo = data?.dmsRoNo ?? data?.outsdRoNo ?? roStatus?.dmsRoNo ?? null;
+
+  return {
+    success,
+    data,
+    roStatus,
+    statusBlocks,
+    customerNo: String(selected),
+    svId,
+    roNo,
+    xml: response?.xml // expose XML for logging/diagnostics
+  };
+};
+
+/**
+ * Step 2: Finalize an existing RR Repair Order (previously created).
+ * @param args
+ * @returns {Promise<{success: boolean, data: *, roStatus: {status: *, statusCode: *|undefined, message}, statusBlocks: *|{}, xml: *}>}
+ */
+const finalizeRRRepairOrder = async (args) => {
+  const { bodyshop, job, advisorNo, customerNo, roNo, vin, socket } = args || {};
+
+  if (!bodyshop) throw new Error("finalizeRRRepairOrder: bodyshop is required");
+  if (!job) throw new Error("finalizeRRRepairOrder: job is required");
+  if (!advisorNo) throw new Error("finalizeRRRepairOrder: advisorNo is required");
+  if (!customerNo) throw new Error("finalizeRRRepairOrder: customerNo is required");
+
+  // The external (Outsd) RO is our deterministic fallback and correlation id.
+  const externalRo = job?.ro_number ?? job?.id;
+  if (externalRo == null) {
+    throw new Error("finalizeRRRepairOrder: outsdRoNo (job.ro_number/id) is required");
+  }
+
+  // Prefer DMS RO for update; fall back to external when DMS RO isn't known
+  const roNoToSend = roNo ? String(roNo) : String(externalRo);
+
+  const { client, opts } = buildClientAndOpts(bodyshop);
+  const finalOpts = {
+    ...opts,
+    envelope: {
+      ...(opts?.envelope || {}),
+      sender: {
+        ...(opts?.envelope?.sender || {}),
+        task: "BSMRO",
+        referenceId: "Update"
+      }
+    }
+  };
+
+  const cleanVin =
+    (job?.v_vin || vin || "")
+      .toString()
+      .replace(/[^A-Za-z0-9]/g, "")
+      .toUpperCase()
+      .slice(0, 17) || undefined;
+
+  // IMPORTANT: include "roNo" on updates (RR requires it). Also send outsdRoNo for correlation.
+  const payload = {
+    roNo: roNoToSend, // ✅ REQUIRED BY RR on update
+    outsdRoNo: String(externalRo),
+    finalUpdate: "Y",
+    departmentType: "B",
+    customerNo: String(customerNo),
+    advisorNo: String(advisorNo),
+    vin: cleanVin,
+    mileageOut: job?.kmout,
+    estimate: { estimateType: "Final" }
+  };
+
+  CreateRRLogEvent(socket, "INFO", "Finalizing RR Repair Order", {
+    roNo: roNoToSend,
+    outsdRoNo: String(externalRo),
+    customerNo: String(customerNo),
+    advisorNo: String(advisorNo)
+  });
+
+  const rrRes = await client.updateRepairOrder(payload, finalOpts);
+
+  CreateRRLogEvent(socket, "SILLY", "RR Repair Order finalized", {
+    payload,
+    response: rrRes
+  });
+
+  const data = rrRes?.data || null;
+  const statusBlocks = rrRes?.statusBlocks || {};
+  const roStatus = deriveRRStatus(rrRes);
+
+  const statusUpper = roStatus?.status ? String(roStatus.status).toUpperCase() : null;
+
+  let success = false;
+  if (statusUpper) {
+    success = !["FAILURE", "ERROR"].includes(statusUpper);
+  } else if (typeof rrRes?.success === "boolean") {
+    success = rrRes.success;
+  } else if (roStatus?.status) {
+    success = String(roStatus.status).toUpperCase() === "SUCCESS";
+  }
+
+  return {
+    success,
+    data,
+    roStatus,
+    statusBlocks,
+    xml: rrRes?.xml
+  };
+};
+
+module.exports = { exportJobToRR, finalizeRRRepairOrder, deriveRRStatus };

server/rr/rr-job-helpers.js

@@ -0,0 +1,569 @@
+const client = require("../graphql-client/graphql-client").client;
+const { GET_JOB_BY_PK } = require("../graphql-client/queries");
+
+/**
+ * Remove all non-digit characters from a string.
+ * @param s
+ * @returns {string}
+ */
+const digitsOnly = (s) => String(s || "").replace(/\D/g, "");
+
+/**
+ * Pick job ID from various possible locations.
+ * @param ctx
+ * @param explicitId
+ * @returns {*|null}
+ */
+const pickJobId = (ctx, explicitId) =>
+  explicitId || ctx?.job?.id || ctx?.payload?.job?.id || ctx?.payload?.jobId || ctx?.jobId || null;
+
+/**
+ * Safely get VIN from job object.
+ * @param job
+ * @returns {*|string|null}
+ */
+const safeVin = (job) => (job?.v_vin && String(job.v_vin).trim()) || null;
+
+/**
+ * Extract blocks array from combined search result.
+ * @param res
+ * @returns {any[]|*[]}
+ */
+const blocksFromCombinedSearchResult = (res) => {
+  const data = Array.isArray(res?.data) ? res.data : Array.isArray(res) ? res : [];
+  return Array.isArray(data) ? data : [];
+};
+
+/**
+ * Convert a Dinero.js object or number into an "N2" string ("123.45").
+ * @param value
+ * @returns {string}
+ */
+const asN2 = (dineroLike) => {
+  if (!dineroLike) return "0.00";
+
+  // Handle Dinero v1/v2-ish or raw objects
+  if (typeof dineroLike.toUnit === "function") {
+    return dineroLike.toUnit().toFixed(2);
+  }
+
+  const precision = dineroLike.precision ?? 2;
+  const amount = (dineroLike.amount ?? 0) / Math.pow(10, precision);
+  return amount.toFixed(2);
+};
+
+/**
+ * Build RO.GOG structure for the reynolds-rome-client `createRepairOrder` payload
+ * from allocations.
+ *
+ * Supports the new allocation shape:
+ *   {
+ *     center,
+ *     partsSale,
+ *     laborTaxableSale,
+ *     laborNonTaxableSale,
+ *     extrasSale,
+ *     totalSale,
+ *     cost,
+ *     profitCenter,
+ *     costCenter
+ *   }
+ *
+ * For each center, we can emit up to 3 GOG *segments*:
+ *   - parts+extras (uses profitCenter.rr_cust_txbl_flag)
+ *   - taxable labor   (CustTxblNTxblFlag="T")
+ *   - non-tax labor   (CustTxblNTxblFlag="N")
+ *
+ * IMPORTANT CHANGE:
+ *   Each segment becomes its OWN JobNo / AllGogOpCodeInfo, with exactly one
+ *   AllGogLineItmInfo inside. This makes the count of:
+ *     - <AllGogOpCodeInfo> (ROGOG)
+ *     - <OpCodeLaborInfo>  (ROLABOR)
+ *   match 1:1, and ensures taxable/non-taxable flags line up by JobNo.
+ *
+ *   We now also attach segmentKind/segmentIndex/segmentCount metadata on each op
+ *   for UI/debug purposes. The XML templates can safely ignore these.
+ *
+ * @param {Array} allocations
+ * @param {Object} opts
+ * @param {string} opts.opCode - RR OpCode for the job (global, overridable)
+ * @param {string} [opts.payType="Cust"] - PayType (always "Cust" per Marc)
+ * @param {string} [opts.roNo] - Optional RoNo to echo on <Rogog RoNo="">
+ * @returns {null|{roNo?: string, ops: Array}}
+ */
+const buildRogogFromAllocations = (allocations, { opCode, payType = "Cust", roNo } = {}) => {
+  if (!Array.isArray(allocations) || !allocations.length || !opCode) return null;
+
+  const ops = [];
+
+  /**
+   * Normalize various "money-like" shapes to integer cents.
+   * Supports:
+   *  - Dinero instances (getAmount / toUnit)
+   *  - { cents }
+   *  - { amount, precision }
+   *  - plain numbers (treated as units, e.g. dollars)
+   */
+  const toCents = (value) => {
+    if (!value) return 0;
+
+    if (typeof value.getAmount === "function") {
+      return value.getAmount();
+    }
+
+    if (typeof value.toUnit === "function") {
+      const unit = value.toUnit();
+      return Number.isFinite(unit) ? Math.round(unit * 100) : 0;
+    }
+
+    if (typeof value.cents === "number") {
+      return value.cents;
+    }
+
+    if (typeof value.amount === "number") {
+      const precision = typeof value.precision === "number" ? value.precision : 2;
+      if (precision === 2) return value.amount;
+      const factor = Math.pow(10, 2 - precision);
+      return Math.round(value.amount * factor);
+    }
+
+    if (typeof value === "number") {
+      return Math.round(value * 100);
+    }
+
+    return 0;
+  };
+
+  const asMoneyLike = (amountCents) => ({
+    amount: amountCents || 0,
+    precision: 2
+  });
+
+  for (const alloc of allocations) {
+    const pc = alloc?.profitCenter || {};
+    const breakOut = pc.rr_gogcode;
+    const itemType = pc.rr_item_type;
+
+    // Only centers configured for RR GOG are included
+    if (!breakOut || !itemType) continue;
+
+    const partsCents = toCents(alloc.partsSale);
+    const extrasCents = toCents(alloc.extrasSale);
+    const laborTaxableCents = toCents(alloc.laborTaxableSale);
+    const laborNonTaxableCents = toCents(alloc.laborNonTaxableSale);
+    const costCents = toCents(alloc.cost);
+
+    // Parts + extras share a single segment
+    const partsExtrasCents = partsCents + extrasCents;
+
+    const segments = [];
+
+    // 1) Parts + extras segment (respect center's default tax flag)
+    if (partsExtrasCents !== 0) {
+      segments.push({
+        kind: "partsExtras",
+        saleCents: partsExtrasCents,
+        txFlag: pc.rr_cust_txbl_flag || "N"
+      });
+    }
+
+    // 2) Taxable labor segment -> "T"
+    if (laborTaxableCents !== 0) {
+      segments.push({
+        kind: "laborTaxable",
+        saleCents: laborTaxableCents,
+        txFlag: "T"
+      });
+    }
+
+    // 3) Non-taxable labor segment -> "N"
+    if (laborNonTaxableCents !== 0) {
+      segments.push({
+        kind: "laborNonTaxable",
+        saleCents: laborNonTaxableCents,
+        txFlag: "N"
+      });
+    }
+
+    if (!segments.length) continue;
+
+    // Proportionally split cost across segments based on their sale amounts
+    const totalCostCents = costCents;
+    const totalSaleCents = segments.reduce((sum, seg) => sum + seg.saleCents, 0);
+
+    let remainingCostCents = totalCostCents;
+
+    segments.forEach((seg, idx) => {
+      let segCost = 0;
+
+      if (totalCostCents > 0 && totalSaleCents > 0) {
+        if (idx === segments.length - 1) {
+          // Last segment gets the remainder to avoid rounding drift
+          segCost = remainingCostCents;
+        } else {
+          segCost = Math.round((seg.saleCents / totalSaleCents) * totalCostCents);
+          remainingCostCents -= segCost;
+        }
+      }
+
+      seg.costCents = segCost;
+    });
+
+    const itemDescBase = pc.accountdesc || pc.accountname || alloc.center || "";
+    const segmentCount = segments.length;
+
+    // Each segment becomes its own op / JobNo with a single line
+    segments.forEach((seg, idx) => {
+      const jobNo = String(ops.length + 1); // global, 1-based JobNo across all centers/segments
+
+      const line = {
+        breakOut,
+        itemType,
+        itemDesc: itemDescBase,
+        custQty: "1.0",
+        custPayTypeFlag: "C",
+        custTxblNtxblFlag: seg.txFlag || "N",
+        amount: {
+          payType,
+          amtType: "Unit",
+          custPrice: asN2(asMoneyLike(seg.saleCents)),
+          dlrCost: asN2(asMoneyLike(seg.costCents))
+        }
+      };
+
+      ops.push({
+        opCode,
+        jobNo,
+        lines: [line], // exactly one AllGogLineItmInfo per AllGogOpCodeInfo
+        // Extra metadata for UI / debugging
+        segmentKind: seg.kind,
+        segmentIndex: idx,
+        segmentCount
+      });
+    });
+  }
+
+  if (!ops.length) return null;
+
+  return {
+    roNo,
+    ops
+  };
+};
+
+/**
+ * Build RO.ROLABOR structure for the reynolds-rome-client `createRepairOrder` payload
+ * from an already-built RO.GOG structure.
+ * @param {Object} rogg - result of buildRogogFromAllocations
+ * @param {Object} opts
+ * @param {string} [opts.payType="Cust"]
+ * @returns {null|{ops: Array}}
+ */
+const buildRolaborFromRogog = (rogg, { payType = "Cust" } = {}) => {
+  if (!rogg || !Array.isArray(rogg.ops)) return null;
+
+  const ops = rogg.ops.map((op) => {
+    const firstLine = op.lines?.[0] || {};
+
+    // Pull tax flag from the GOG line.
+    // Prefer the property we set in buildRogogFromAllocations (custTxblNTxblFlag),
+    // but also accept custTxblNtxblFlag in case we ever change naming.
+    const txFlag = firstLine.custTxblNtxblFlag ?? "N";
+
+    const linePayType = firstLine.custPayTypeFlag || "C";
+
+    return {
+      opCode: op.opCode,
+      jobNo: op.jobNo,
+      custPayTypeFlag: linePayType,
+      custTxblNtxblFlag: txFlag,
+      bill: {
+        payType,
+        jobTotalHrs: "0",
+        billTime: "0",
+        billRate: "0"
+      },
+      amount: {
+        payType,
+        amtType: "Job",
+        custPrice: "0",
+        totalAmt: "0"
+      }
+    };
+  });
+
+  if (!ops.length) return null;
+
+  return { ops };
+};
+
+/**
+ * Query job data by ID from GraphQL API.
+ * @param ctx
+ * @param jobId
+ * @returns {Promise<*>}
+ * @constructor
+ */
+const QueryJobData = async (ctx = {}, jobId) => {
+  if (ctx?.job) return ctx.job;
+  if (ctx?.payload?.job) return ctx.payload.job;
+
+  const id = pickJobId(ctx, jobId);
+  if (!id) throw new Error("QueryJobData: jobId required (none found in ctx or args)");
+
+  try {
+    const res = await client.request(GET_JOB_BY_PK, { id });
+    const job = res?.jobs_by_pk;
+    if (!job) throw new Error(`Job ${id} not found`);
+    return job;
+  } catch (e) {
+    const msg = e?.response?.errors?.[0]?.message || e.message || "unknown";
+    throw new Error(`QueryJobData failed: ${msg}`);
+  }
+};
+
+/**
+ * Build Repair Order payload for RR from job and customer data.
+ * @param {Object} args
+ * @param job
+ * @param selectedCustomer
+ * @param advisorNo
+ * @param story
+ * @param makeOverride
+ * @param bodyshop
+ * @param allocations
+ * @param {string} [opCode]   - RR OpCode for this RO (global default / override)
+ * @param {string} [taxCode]  - RR tax code for header tax (e.g. state/prov code)
+ * @returns {Object}
+ */
+const buildRRRepairOrderPayload = ({
+  job,
+  selectedCustomer,
+  advisorNo,
+  story,
+  makeOverride,
+  allocations,
+  opCode
+  // taxCode
+} = {}) => {
+  const customerNo = selectedCustomer?.customerNo
+    ? String(selectedCustomer.customerNo).trim()
+    : selectedCustomer?.custNo
+      ? String(selectedCustomer.custNo).trim()
+      : null;
+
+  if (!customerNo) throw new Error("No RR customer selected (customerNo/custNo missing)");
+
+  const adv = advisorNo != null && String(advisorNo).trim() !== "" ? String(advisorNo).trim() : null;
+  if (!adv) throw new Error("advisorNo is required for RR export");
+
+  const vinRaw = job?.v_vin;
+  const vin =
+    typeof vinRaw === "string"
+      ? vinRaw
+          .replace(/[^A-Za-z0-9]/g, "")
+          .toUpperCase()
+          .slice(0, 17) || undefined
+      : undefined;
+
+  // Use ro_number when present; fallback to job.id
+  const ro = job?.ro_number != null ? job.ro_number : job?.id != null ? job.id : null;
+  if (ro == null) throw new Error("Missing repair order identifier (ro_number/id)");
+
+  const roStr = String(ro);
+
+  // Base payload shape expected by reynolds-rome-client (buildCreateRepairOrder)
+  const payload = {
+    outsdRoNo: roStr,
+    departmentType: "B",
+    vin,
+    customerNo: String(customerNo),
+    advisorNo: adv,
+    mileageIn: job.kmin
+  };
+
+  if (story) {
+    payload.roComment = String(story).trim();
+  }
+
+  if (makeOverride) {
+    // Passed through so the template can override DMS Make if needed
+    payload.makeOverride = String(makeOverride).trim();
+  }
+
+  const haveAllocations = Array.isArray(allocations) && allocations.length > 0;
+
+  if (haveAllocations) {
+    const effectiveOpCode = (opCode && String(opCode).trim()) || null;
+    // const effectiveTaxCode = (taxCode && String(taxCode).trim()) || null;
+
+    if (effectiveOpCode) {
+      // Build RO.GOG and RO.LABOR in the new normalized shape
+      const rogg = buildRogogFromAllocations(allocations, {
+        opCode: effectiveOpCode,
+        payType: "Cust"
+      });
+
+      if (rogg) {
+        payload.rogg = rogg;
+
+        const rolabor = buildRolaborFromRogog(rogg, { payType: "Cust" });
+        if (rolabor) {
+          payload.rolabor = rolabor;
+        }
+      }
+    }
+  }
+
+  return payload;
+};
+
+/**
+ * Make vehicle search payload from job data
+ * @param job
+ * @returns {{kind: string, license: string}|null|{kind: string, vin: *|string}}
+ */
+const makeVehicleSearchPayloadFromJob = (job) => {
+  const vin = safeVin(job);
+  if (vin) return { kind: "vin", vin };
+
+  const plate = job?.plate_no;
+  if (plate) return { kind: "license", license: String(plate).trim() };
+
+  return null;
+};
+
+/**
+ * Make customer search payload from job data
+ * @param job
+ * @returns {{kind: string, vin: *|string}|{kind: string, name: {name: string}}|{kind: string, phone: string}|null}
+ */
+const makeCustomerSearchPayloadFromJob = (job) => {
+  const phone = job?.ownr_ph1;
+  const d = digitsOnly(phone);
+  if (d.length >= 7) return { kind: "phone", phone: d };
+
+  const lastName = job?.ownr_ln;
+  const company = job?.ownr_co_nm;
+  const lnOrCompany = lastName || company;
+  if (lnOrCompany) return { kind: "name", name: { name: String(lnOrCompany).trim() } };
+
+  const vin = safeVin(job);
+  if (vin) return { kind: "vin", vin };
+
+  return null;
+};
+
+/**
+ * Normalize customer candidates from combined search result.
+ * @param res
+ * @returns {*[]}
+ */
+const normalizeCustomerCandidates = (res) => {
+  const blocks = blocksFromCombinedSearchResult(res);
+  const out = [];
+  for (const blk of blocks) {
+    const serv = Array.isArray(blk?.ServVehicle) ? blk.ServVehicle : [];
+    const custNos = serv.map((sv) => sv?.VehicleServInfo?.CustomerNo).filter(Boolean);
+
+    const nci = blk?.NameContactId;
+    const ind = nci?.NameId?.IndName;
+    const bus = nci?.NameId?.BusName;
+    const personal = [ind?.FName, ind?.LName].filter(Boolean).join(" ").trim();
+    const company = bus?.CompanyName;
+    const name = (personal || company || "").trim();
+
+    for (const custNo of custNos) {
+      out.push({ custNo, name: name || `Customer ${custNo}`, _blk: blk });
+    }
+  }
+  const seen = new Set();
+  return out.filter((c) => {
+    if (!c.custNo || seen.has(c.custNo)) return false;
+    seen.add(c.custNo);
+    return true;
+  });
+};
+
+/**
+ * Normalize vehicle candidates from combined search result.
+ * @param res
+ * @returns {*[]}
+ */
+const normalizeVehicleCandidates = (res) => {
+  const blocks = blocksFromCombinedSearchResult(res);
+  const out = [];
+  for (const blk of blocks) {
+    const serv = Array.isArray(blk?.ServVehicle) ? blk.ServVehicle : [];
+    for (const sv of serv) {
+      const v = sv?.Vehicle || {};
+      const vin = v?.Vin || v?.VIN || v?.vin;
+
+      if (!vin) continue;
+
+      const year = v?.VehicleYr || v?.ModelYear || v?.Year;
+      const make = v?.VehicleMake || v?.MakeName || v?.Make;
+      const model = v?.MdlNo || v?.ModelDesc || v?.Model;
+
+      const label = [year, make, model, vin].filter(Boolean).join(" ");
+      out.push({ vin, year, make, model, label, _blk: blk });
+    }
+  }
+  const seen = new Set();
+  return out.filter((v) => {
+    if (!v.vin || seen.has(v.vin)) return false;
+    seen.add(v.vin);
+    return true;
+  });
+};
+
+/**
+ * Build split labor lines from job allocations.
+ * @param jobAllocations
+ * @returns {*[]}
+ */
+const buildSplitLaborLinesFromAllocations = (jobAllocations) => {
+  const lines = [];
+
+  for (const alloc of jobAllocations || []) {
+    const { center, laborTaxableSale, laborNonTaxableSale, profitCenter, costCenter } = alloc;
+
+    // Taxable labor
+    if (laborTaxableSale && !laborTaxableSale.isZero()) {
+      lines.push({
+        centerName: center,
+        profitCenter,
+        costCenter,
+        amount: laborTaxableSale,
+        isTaxable: true,
+        source: "labor"
+      });
+    }
+
+    // Non-taxable labor
+    if (laborNonTaxableSale && !laborNonTaxableSale.isZero()) {
+      lines.push({
+        centerName: center,
+        profitCenter,
+        costCenter,
+        amount: laborNonTaxableSale,
+        isTaxable: false,
+        source: "labor"
+      });
+    }
+  }
+
+  return lines;
+};
+
+module.exports = {
+  QueryJobData,
+  buildRRRepairOrderPayload,
+  makeCustomerSearchPayloadFromJob,
+  buildSplitLaborLinesFromAllocations,
+  makeVehicleSearchPayloadFromJob,
+  normalizeCustomerCandidates,
+  normalizeVehicleCandidates,
+  buildRogogFromAllocations,
+  buildRolaborFromRogog
+};

server/rr/rr-logger-event.js

@@ -0,0 +1,77 @@
+const logger = require("../utils/logger");
+
+/**
+ * Convert an Error object to a plain object for serialization.
+ * @param err
+ * @returns {{[p: string]: unknown, name: *, message: *, stack: *}|null}
+ */
+const toPlainError = (err) => {
+  if (!err) return null;
+  return {
+    name: err.name,
+    message: err.message,
+    stack: err.stack,
+    ...Object.fromEntries(Object.entries(err).filter(([k]) => !["stack"].includes(k)))
+  };
+};
+
+/**
+ * Safely serialize meta information for logging.
+ * @param meta
+ * @returns {{note: string}|any|{[p: string]: *, name: *, message: *, stack: *}|null}
+ */
+const safeMeta = (meta) => {
+  try {
+    if (meta instanceof Error) return toPlainError(meta);
+    if (meta && typeof meta === "object") {
+      // JSON-safe clone w/ BigInt -> string
+      return JSON.parse(JSON.stringify(meta, (_k, v) => (typeof v === "bigint" ? v.toString() : v)));
+    }
+    return meta ?? null;
+  } catch {
+    return { note: "meta not serializable" };
+  }
+};
+
+/**
+ * Create and emit a Reynolds log event.
+ * @param socket
+ * @param level
+ * @param message
+ * @param meta
+ * @returns {{timestamp: number, level: string, message: string|string, meta: {note: string}|*|{[p: string]: *, name: *, message: *, stack: *}|null}}
+ * @constructor
+ */
+const CreateRRLogEvent = (socket, level = "INFO", message = "", meta = null) => {
+  const ts = Date.now();
+  const lvl = String(level || "INFO").toUpperCase();
+  const normLevel = lvl.toLowerCase();
+  const msg = typeof message === "string" ? message : (message?.toString?.() ?? JSON.stringify(message));
+
+  const payload = {
+    timestamp: ts,
+    level: lvl,
+    message: msg,
+    meta: safeMeta(meta)
+  };
+
+  // Central logger (Winston + CloudWatch + S3)
+  try {
+    // user = "RR", record = null, meta = payload.meta
+    logger.log(`[RR]  ${msg}`, normLevel, "RR", null, payload.meta);
+  } catch {
+    // Fallback console
+    console.log(`[RR] ${new Date(ts).toISOString()} | ${lvl} | ${msg}`, payload.meta);
+  }
+
+  // Socket
+  try {
+    socket?.emit?.("rr-log-event", payload);
+  } catch {
+    // ignore socket failures
+  }
+
+  return payload;
+};
+
+module.exports = CreateRRLogEvent;

server/rr/rr-lookup.js

@@ -0,0 +1,166 @@
+const { RRClient } = require("./lib/index.cjs");
+const { getRRConfigFromBodyshop } = require("./rr-config");
+
+/**
+ * Build an RR client + common opts from a bodyshop row
+ */
+const buildClientAndOpts = (bodyshop) => {
+  const cfg = getRRConfigFromBodyshop(bodyshop);
+
+  const client = new RRClient({
+    baseUrl: cfg.baseUrl,
+    username: cfg.username,
+    password: cfg.password,
+    timeoutMs: cfg.timeoutMs,
+    retries: cfg.retries
+  });
+
+  // Common CallOptions for all ops; routing is CRITICAL for Destination block
+  const opts = {
+    routing: cfg.routing,
+    envelope: {
+      sender: {
+        component: "Rome",
+        task: "CVC",
+        referenceId: "Query",
+        creator: "RCI",
+        senderName: "RCI"
+      }
+    }
+  };
+
+  return { client, opts };
+};
+
+/**
+ * Normalize the combined-search arguments into the RR shape.
+ * We infer `kind` if not provided, based on the first detectable field.
+ */
+const toCombinedSearchPayload = (args = {}) => {
+  const q = { ...args };
+
+  // Decide kind if not provided
+  let kind = (q.kind || "").toString().trim();
+  if (!kind) {
+    if (q.phone) kind = "phone";
+    else if (q.license) kind = "license";
+    else if (q.vin) kind = "vin";
+    else if (q.nameRecId || q.custId) kind = "nameRecId";
+    else if (typeof q.name === "string" || (q.name && (q.name.fname || q.name.lname || q.name.mname || q.name.name))) {
+      kind = "name";
+    } else if (q.stkNo || q.stock) kind = "stkNo";
+  }
+
+  const payload = {
+    // set both; the XML layer renders MaxRecs
+    maxRecs: q.maxResults ?? q.maxRecs ?? 50,
+    maxResults: q.maxResults ?? q.maxRecs ?? 50,
+    kind
+  };
+
+  switch ((kind || "").toLowerCase()) {
+    case "phone":
+      payload.kind = "phone";
+      payload.phone = String(q.phone ?? "").trim();
+      break;
+
+    case "license":
+      payload.kind = "license";
+      payload.license = String(q.license ?? "").trim();
+      break;
+
+    case "vin":
+      payload.kind = "vin";
+      payload.vin = String(q.vin ?? "").trim();
+      break;
+
+    case "namerecid":
+      payload.kind = "nameRecId";
+      payload.nameRecId = String(q.nameRecId ?? q.custId ?? "").trim();
+      break;
+
+    case "stkno":
+    case "stkNo":
+      payload.kind = "stkNo";
+      payload.stkNo = String(q.stkNo ?? q.stock ?? "").trim();
+      break;
+
+    case "name": {
+      payload.kind = "name";
+      const n = q.name;
+      if (typeof n === "string") {
+        const last = n.trim();
+        if (last) payload.name = { name: last }; // <LName Name="..."/>
+        break;
+      }
+      const fname = n?.fname && String(n.fname).trim();
+      const lname = n?.lname && String(n.lname).trim();
+      const mname = n?.mname && String(n.mname).trim();
+      const lastOnly = n?.name && String(n.name).trim();
+
+      if (fname || lname || mname) {
+        const full = {};
+        if (fname) full.fname = fname;
+        if (mname) full.mname = mname;
+        if (lname) full.lname = lname;
+        payload.name = full; // will render <FullName .../>
+      } else if (lastOnly) {
+        payload.name = { name: lastOnly }; // explicit last-only
+      }
+      break;
+    }
+
+    default:
+      payload.kind = kind;
+  }
+
+  if (q.make || q.model || q.year) {
+    payload.make = q.make || "ANY";
+    payload.model = q.model || "ANY";
+    payload.year = q.year || "ANY";
+  }
+
+  if (q.vin && payload.kind !== "vin") payload.vin = String(q.vin).trim();
+  if (q.phone && payload.kind !== "phone") payload.phone = String(q.phone).trim();
+  if (q.license && payload.kind !== "license") payload.license = String(q.license).trim();
+
+  return payload;
+};
+
+/**
+ * Combined customer/service/vehicle search
+ * @param bodyshop - bodyshop row (must include rr_dealerid & rr_configuration with store/branch)
+ * @param args - search inputs (phone | license | vin | nameRecId | name | stkNo)
+ */
+const rrCombinedSearch = async (bodyshop, args = {}) => {
+  const { client, opts } = buildClientAndOpts(bodyshop);
+  const payload = toCombinedSearchPayload(args);
+  const res = await client.combinedSearch(payload, opts);
+  return res;
+};
+
+/**
+ * Advisors lookup
+ * @param bodyshop
+ * @param args - { department: 'B'|'S'|'P'|string, advisorNumber?: string }
+ */
+const rrGetAdvisors = async (bodyshop, args = {}) => {
+  const { client, opts } = buildClientAndOpts(bodyshop);
+  // Accept either department or departmentType from FE
+  const dep = String(args.department ?? args.departmentType ?? "").toUpperCase();
+  const department =
+    dep === "BODY" || dep === "BODYSHOP" ? "B" : dep === "SERVICE" ? "S" : dep === "PARTS" ? "P" : dep || "B";
+
+  const payload = {
+    department,
+    advisorNumber: args.advisorNumber ? String(args.advisorNumber) : undefined
+  };
+
+  return client.getAdvisors(payload, opts);
+};
+
+module.exports = {
+  rrCombinedSearch,
+  rrGetAdvisors,
+  buildClientAndOpts
+};

server/rr/rr-register-socket-events.js

@@ -0,0 +1,975 @@
+const CreateRRLogEvent = require("./rr-logger-event");
+const { rrCombinedSearch, rrGetAdvisors, buildClientAndOpts } = require("./rr-lookup");
+const { QueryJobData, buildRogogFromAllocations, buildRolaborFromRogog } = require("./rr-job-helpers");
+const { exportJobToRR, finalizeRRRepairOrder } = require("./rr-job-export");
+const RRCalculateAllocations = require("./rr-calculate-allocations").default;
+const { createRRCustomer } = require("./rr-customers");
+const { ensureRRServiceVehicle } = require("./rr-service-vehicles");
+const { classifyRRVendorError } = require("./rr-errors");
+const { markRRExportSuccess, insertRRFailedExportLog } = require("./rr-export-logs");
+const {
+  makeVehicleSearchPayloadFromJob,
+  ownersFromVinBlocks,
+  readAdvisorNo,
+  getTransactionType,
+  normalizeCustomerCandidates,
+  defaultRRTTL,
+  RRCacheEnums
+} = require("./rr-utils");
+const { GraphQLClient } = require("graphql-request");
+const queries = require("../graphql-client/queries");
+
+/**
+ * Advisors cache TTL (7 days)
+ * @type {number}
+ */
+const ADVISORS_CACHE_TTL = 7 * 24 * 60 * 60; // seconds
+
+/**
+ * Resolve job ID from various shapes
+ * @param explicit
+ * @param payload
+ * @param job
+ * @returns {*|null}
+ */
+const resolveJobId = (explicit, payload, job) => explicit || payload?.jobId || job?.id || null;
+
+/**
+ * Resolve VIN from tx/job shapes
+ * @param tx
+ * @param job
+ * @returns {*|null}
+ */
+const resolveVin = ({ tx, job }) => tx?.jobData?.vin || job?.v_vin || null;
+
+/**
+ * Sort vehicle owners first in the list, preserving original order otherwise.
+ * @param list
+ * @returns {*}
+ */
+const sortVehicleOwnerFirst = (list) =>
+  list
+    .map((v, i) => ({ v, i }))
+    .sort((a, b) => {
+      const ao = a.v?.isVehicleOwner ? 1 : 0;
+      const bo = b.v?.isVehicleOwner ? 1 : 0;
+      if (ao !== bo) return bo - ao;
+      return a.i - b.i;
+    })
+    .map(({ v }) => v);
+
+/**
+ * Merge customer candidates by custNo, combining isVehicleOwner flags and filling missing fields.
+ * @param items
+ * @returns {any[]}
+ */
+const mergeByCustNo = (items = []) => {
+  const byId = new Map();
+  for (const c of items) {
+    const id = (c?.custNo || "").trim();
+    if (!id) continue;
+    const prev = byId.get(id);
+    if (!prev) {
+      byId.set(id, { ...c, isVehicleOwner: !!(c.vinOwner || c.isVehicleOwner) });
+    } else {
+      byId.set(id, {
+        ...prev,
+        name: prev.name || c.name,
+        isVehicleOwner: !!(prev.isVehicleOwner || prev.vinOwner || c.isVehicleOwner || c.vinOwner),
+        vinOwner: !!(prev.vinOwner || c.vinOwner || prev.isVehicleOwner || c.isVehicleOwner),
+        address: prev.address || c.address
+      });
+    }
+  }
+  return Array.from(byId.values());
+};
+
+/**
+ * Get session data or socket fallback
+ * @param redisHelpers
+ * @param socket
+ * @returns {Promise<{bodyshopId: *, email: *, sess: null}>}
+ */
+const getSessionOrSocket = async (redisHelpers, socket) => {
+  let sess = null;
+  try {
+    sess = await redisHelpers.getSessionData(socket.id);
+  } catch {
+    //
+  }
+  const bodyshopId = sess?.bodyshopId ?? socket.bodyshopId;
+  const email = sess?.email ?? socket.user?.email;
+  if (!bodyshopId) throw new Error("No bodyshopId (session/socket)");
+  return { bodyshopId, email, sess };
+};
+
+/**
+ * Fetch bodyshop data for socket
+ * @param bodyshopId
+ * @param socket
+ * @returns {Promise<{id: string, intellipay_config: {payment_map: {amex: string}}}|{id: string, intellipay_config: null}|*>}
+ */
+const getBodyshopForSocket = async ({ bodyshopId, socket }) => {
+  const endpoint = process.env.GRAPHQL_ENDPOINT;
+  if (!endpoint) throw new Error("GRAPHQL_ENDPOINT not configured");
+  const token = (socket?.data && socket.data.authToken) || (socket?.handshake?.auth && socket.handshake.auth.token);
+  const client = new GraphQLClient(endpoint, {});
+  const res = await client.setHeaders({ Authorization: `Bearer ${token}` }).request(queries.GET_BODYSHOP_BY_ID, {
+    id: bodyshopId
+  });
+  const bodyshop = res?.bodyshops_by_pk;
+  if (!bodyshop) throw new Error(`Bodyshop not found: ${bodyshopId}`);
+  return bodyshop;
+};
+
+/**
+ * Build advisors cache namespace and field
+ * @param bodyshopId
+ * @param routing
+ * @param departmentType
+ * @returns {{ns: string, field: string}}
+ */
+const buildAdvisorsCacheNS = ({ bodyshopId, routing, departmentType = "B" }) => {
+  const dealer = routing?.dealerNumber || "unknown";
+  const store = routing?.storeNumber || "none";
+  const area = routing?.areaNumber || "none";
+  const dept = (departmentType || "B").toUpperCase();
+  return {
+    ns: `rr:advisors:${bodyshopId}:${dealer}:${store}:${area}`,
+    field: `dept:${dept}`
+  };
+};
+
+/**
+ * Run multi-query customer search (Full Name + VIN) and merge results.
+ * @param bodyshop
+ * @param job
+ * @param socket
+ * @param redisHelpers
+ * @returns {Promise<*|*[]>}
+ */
+const rrMultiCustomerSearch = async ({ bodyshop, job, socket, redisHelpers }) => {
+  const queriesList = [];
+
+  // 1) Full Name (preferred)
+  const firstName = job?.ownr_fn && String(job.ownr_fn).trim();
+  const lastName = job?.ownr_ln && String(job.ownr_ln).trim();
+  const company = job?.ownr_co_nm && String(job.ownr_co_nm).trim();
+
+  if (firstName || lastName) {
+    queriesList.push({
+      q: { kind: "name", name: { fname: firstName || undefined, lname: lastName || undefined }, maxResults: 50 },
+      fromVin: false
+    });
+  } else if (company) {
+    queriesList.push({ q: { kind: "name", name: { name: company }, maxResults: 50 }, fromVin: false });
+  }
+
+  // 2) VIN (owner association)
+  const vehQ = makeVehicleSearchPayloadFromJob(job);
+  if (vehQ && vehQ.kind === "vin") queriesList.push({ q: vehQ, fromVin: true });
+
+  if (!queriesList.length) return [];
+
+  let ownersSet = null;
+  const merged = [];
+
+  for (const { q, fromVin } of queriesList) {
+    try {
+      CreateRRLogEvent(socket, "DEBUG", `{RR-SEARCH} Executing ${q.kind} query`, { q });
+
+      const multiResponse = await rrCombinedSearch(bodyshop, q);
+
+      CreateRRLogEvent(socket, "SILLY", "Multi Customer Search - raw combined search", { response: multiResponse });
+
+      if (fromVin) {
+        const multiBlocks = Array.isArray(multiResponse?.data) ? multiResponse.data : [];
+        ownersSet = ownersFromVinBlocks(multiBlocks, job?.v_vin);
+        try {
+          await redisHelpers.setSessionTransactionData(
+            socket.id,
+            getTransactionType(job.id),
+            RRCacheEnums.VINCandidates,
+            multiBlocks,
+            defaultRRTTL
+          );
+        } catch {
+          /* ignore cache write issues */
+        }
+      }
+
+      const norm = normalizeCustomerCandidates(multiResponse, { ownersSet });
+      merged.push(...norm);
+    } catch (e) {
+      CreateRRLogEvent(socket, "WARN", "Multi-search subquery failed", { kind: q.kind, error: e.message });
+    }
+  }
+
+  // NEW: dedupe across queries (name + vin)
+  const deduped = mergeByCustNo(merged);
+
+  return sortVehicleOwnerFirst(deduped);
+};
+
+/**
+ * Register RR socket events
+ * @param socket
+ * @param redisHelpers
+ */
+const registerRREvents = ({ socket, redisHelpers }) => {
+  socket.on("rr-lookup-combined", async ({ jobid, params } = {}, cb) => {
+    try {
+      const { bodyshopId } = await getSessionOrSocket(redisHelpers, socket);
+      const bodyshop = await getBodyshopForSocket({ bodyshopId, socket });
+
+      CreateRRLogEvent(socket, "DEBUG", "rr-lookup-combined: begin", { jobid, params });
+
+      const response = await rrCombinedSearch(bodyshop, params || {});
+
+      CreateRRLogEvent(socket, "SILLY", "rr-lookup-combined: received response", {
+        response
+      });
+
+      let ownersSet = null;
+
+      if ((params?.kind || "").toLowerCase() === "vin") {
+        const blocks = Array.isArray(response?.data) ? response.data : [];
+        ownersSet = ownersFromVinBlocks(blocks);
+      }
+
+      const normalized = sortVehicleOwnerFirst(normalizeCustomerCandidates(response, { ownersSet }));
+      const rid = resolveJobId(jobid, { jobid }, null);
+      const decorated = normalized.map((c) => (c.vinOwner != null ? c : { ...c, vinOwner: !!c.isVehicleOwner }));
+
+      cb?.({ jobid: rid, data: decorated });
+
+      socket.emit("rr-select-customer", decorated);
+
+      CreateRRLogEvent(socket, "DEBUG", "rr-lookup-combined: emitted rr-select-customer", {
+        count: decorated.length
+      });
+    } catch (e) {
+      CreateRRLogEvent(socket, "ERROR", "RR combined lookup error", { error: e.message, jobid });
+      cb?.({ jobid, error: e.message });
+    }
+  });
+
+  socket.on("rr-get-advisors", async (args = {}, ack) => {
+    const refresh = !!args?.refresh;
+    const requestedDept = (args?.departmentType || "B").toUpperCase();
+
+    try {
+      const { bodyshopId } = await getSessionOrSocket(redisHelpers, socket);
+      const bodyshop = await getBodyshopForSocket({ bodyshopId, socket });
+      CreateRRLogEvent(socket, "DEBUG", "rr-get-advisors: begin", { args });
+
+      // Build routing to bind cache key to bodyshop + dealer/store/area
+      const { client, opts } = await buildClientAndOpts(bodyshop);
+      const routing = opts?.routing || client?.opts?.routing || {};
+      if (!routing?.dealerNumber) {
+        throw new Error("rr-get-advisors: routing.dealerNumber required");
+      }
+
+      const { ns, field } = buildAdvisorsCacheNS({
+        bodyshopId,
+        routing,
+        departmentType: requestedDept
+      });
+
+      let result = null;
+      let fromCache = false;
+
+      // 1) Try cache (unless forced refresh)
+      if (!refresh) {
+        try {
+          const cached = await redisHelpers.getProviderCache(ns, field);
+          if (cached && Array.isArray(cached)) {
+            result = cached;
+            fromCache = true;
+            CreateRRLogEvent(socket, "DEBUG", "rr-get-advisors: cache hit", {
+              ns,
+              field,
+              count: cached.length,
+              ttl: ADVISORS_CACHE_TTL
+            });
+          }
+        } catch (e) {
+          CreateRRLogEvent(socket, "WARN", "rr-get-advisors: cache read failed", { ns, field, error: e?.message });
+        }
+      }
+
+      // 2) Fetch + cache when no cache or forced refresh
+      if (!result) {
+        const getAdvisorsCall = await rrGetAdvisors(bodyshop, { departmentType: requestedDept });
+        result = Array.isArray(getAdvisorsCall?.data) ? getAdvisorsCall.data : [];
+        try {
+          await redisHelpers.setProviderCache(ns, field, result, ADVISORS_CACHE_TTL);
+          CreateRRLogEvent(socket, "SILLY", "rr-get-advisors: fetched live data", {
+            getAdvisorsCall
+          });
+          CreateRRLogEvent(socket, "DEBUG", "rr-get-advisors: cache populated", {
+            ns,
+            field,
+            count: result.length,
+            ttl: ADVISORS_CACHE_TTL
+          });
+        } catch (e) {
+          CreateRRLogEvent(socket, "WARN", "rr-get-advisors: cache write failed", { ns, field, error: e?.message });
+        }
+      }
+
+      // 3) Respond
+      ack?.({ ok: true, result, fromCache });
+      socket.emit("rr-get-advisors:result", { result, fromCache });
+      CreateRRLogEvent(socket, "DEBUG", "rr-get-advisors: success", {
+        count: Array.isArray(result) ? result.length : undefined,
+        fromCache
+      });
+    } catch (err) {
+      CreateRRLogEvent(socket, "ERROR", "rr-get-advisors: failed", { error: err?.message });
+      ack?.({ ok: false, error: err?.message || "get advisors failed" });
+    }
+  });
+
+  socket.on("rr-export-job", async ({ jobid, jobId, txEnvelope } = {}) => {
+    const rid = resolveJobId(jobid || jobId, { jobId, jobid }, null);
+
+    try {
+      if (!rid) throw new Error("RR export: jobid required");
+
+      CreateRRLogEvent(socket, "DEBUG", `{1} Received RR export request`, { jobid: rid });
+
+      await redisHelpers.setSessionTransactionData(
+        socket.id,
+        getTransactionType(rid),
+        RRCacheEnums.txEnvelope,
+        txEnvelope || {},
+        defaultRRTTL
+      );
+
+      CreateRRLogEvent(socket, "DEBUG", `{1.1} Cached txEnvelope`, { hasTxEnvelope: !!txEnvelope });
+
+      const job = await QueryJobData({ redisHelpers }, rid);
+      await redisHelpers.setSessionTransactionData(
+        socket.id,
+        getTransactionType(rid),
+        RRCacheEnums.JobData,
+        job,
+        defaultRRTTL
+      );
+
+      CreateRRLogEvent(socket, "DEBUG", `{1.2} Cached JobData`, { vin: job?.v_vin, ro: job?.ro_number });
+
+      const adv = readAdvisorNo(
+        { txEnvelope },
+        await redisHelpers.getSessionTransactionData(socket.id, getTransactionType(rid), RRCacheEnums.AdvisorNo)
+      );
+
+      if (adv) {
+        await redisHelpers.setSessionTransactionData(
+          socket.id,
+          getTransactionType(rid),
+          RRCacheEnums.AdvisorNo,
+          String(adv),
+          defaultRRTTL
+        );
+
+        CreateRRLogEvent(socket, "DEBUG", `{1.3} Cached advisorNo`, { advisorNo: String(adv) });
+      }
+
+      const { bodyshopId } = await getSessionOrSocket(redisHelpers, socket);
+      const bodyshop = await getBodyshopForSocket({ bodyshopId, socket });
+
+      CreateRRLogEvent(socket, "DEBUG", `{2} Running multi-search (Full Name + VIN)`);
+
+      const candidates = await rrMultiCustomerSearch({ bodyshop, job, socket, redisHelpers });
+      const decorated = candidates.map((c) => (c.vinOwner != null ? c : { ...c, vinOwner: !!c.isVehicleOwner }));
+
+      socket.emit("rr-select-customer", decorated);
+      CreateRRLogEvent(socket, "DEBUG", `{2.1} Emitted rr-select-customer`, {
+        count: decorated.length,
+        anyOwner: decorated.some((c) => c.vinOwner || c.isVehicleOwner)
+      });
+    } catch (error) {
+      CreateRRLogEvent(socket, "ERROR", `Error during RR export (prepare)`, {
+        error: error.message,
+        stack: error.stack,
+        jobid: rid
+      });
+
+      try {
+        socket.emit("export-failed", { vendor: "rr", jobId: rid, error: error.message });
+      } catch {
+        //
+      }
+    }
+  });
+
+  socket.on("rr-selected-customer", async ({ jobid, jobId, selectedCustomerId, custNo, create } = {}, ack) => {
+    const rid = resolveJobId(jobid || jobId, { jobid, jobId }, null);
+    let bodyshop = null;
+    let job = null;
+    let createdCustomer = false;
+
+    try {
+      if (!rid) throw new Error("jobid required");
+      CreateRRLogEvent(socket, "DEBUG", `{3} rr-selected-customer`, {
+        jobid: rid,
+        custNo,
+        selectedCustomerId,
+        create: !!create
+      });
+
+      const ns = getTransactionType(rid);
+
+      let selectedCustNo =
+        (custNo && String(custNo)) ||
+        (selectedCustomerId && String(selectedCustomerId)) ||
+        (await redisHelpers.getSessionTransactionData(socket.id, ns, RRCacheEnums.SelectedCustomer));
+
+      job = await redisHelpers.getSessionTransactionData(socket.id, ns, RRCacheEnums.JobData);
+
+      const txEnvelope = (await redisHelpers.getSessionTransactionData(socket.id, ns, RRCacheEnums.txEnvelope)) || {};
+
+      if (!job) throw new Error("Staged JobData not found (run rr-export-job first).");
+
+      const { bodyshopId } = await getSessionOrSocket(redisHelpers, socket);
+
+      bodyshop = await getBodyshopForSocket({ bodyshopId, socket });
+
+      // Create customer (if requested or none chosen)
+      if (create === true || !selectedCustNo) {
+        CreateRRLogEvent(socket, "DEBUG", `{3.1} Creating RR customer`);
+
+        const created = await createRRCustomer({ bodyshop, job, socket });
+        selectedCustNo = String(created?.customerNo);
+
+        if (!selectedCustNo) throw new Error("RR create customer returned no custNo");
+
+        createdCustomer = true;
+
+        CreateRRLogEvent(socket, "DEBUG", `{3.2} Created customer`, { custNo: selectedCustNo });
+      }
+
+      // VIN owner pre-check
+      try {
+        const vehQ = makeVehicleSearchPayloadFromJob(job);
+        if (vehQ && vehQ.kind === "vin" && job?.v_vin) {
+          const vinResponse = await rrCombinedSearch(bodyshop, vehQ);
+
+          CreateRRLogEvent(socket, "SILLY", `VIN owner pre-check response`, { response: vinResponse });
+
+          const vinBlocks = Array.isArray(vinResponse?.data) ? vinResponse.data : [];
+
+          try {
+            await redisHelpers.setSessionTransactionData(
+              socket.id,
+              ns,
+              RRCacheEnums.VINCandidates,
+              vinBlocks,
+              defaultRRTTL
+            );
+          } catch {
+            //
+          }
+
+          const ownersSet = ownersFromVinBlocks(vinBlocks, job.v_vin);
+
+          if (ownersSet?.size) {
+            const sel = String(selectedCustNo);
+
+            if (!ownersSet.has(sel)) {
+              const [existingOwner] = Array.from(ownersSet).map(String);
+              CreateRRLogEvent(socket, "DEBUG", `{3.2a} VIN exists; switching to VIN owner`, {
+                vin: job.v_vin,
+                selected: sel,
+                existingOwner
+              });
+              selectedCustNo = existingOwner;
+            }
+          }
+        }
+      } catch (e) {
+        CreateRRLogEvent(socket, "WARN", `VIN owner pre-check failed; continuing with selected customer`, {
+          error: e?.message
+        });
+      }
+
+      // Cache final/effective customer selection
+      const effectiveCustNo = String(selectedCustNo);
+
+      await redisHelpers.setSessionTransactionData(
+        socket.id,
+        ns,
+        RRCacheEnums.SelectedCustomer,
+        effectiveCustNo,
+        defaultRRTTL
+      );
+
+      CreateRRLogEvent(socket, "DEBUG", `{3.3} Cached selected customer`, { custNo: effectiveCustNo });
+
+      // Build client & routing
+      const { client, opts } = await buildClientAndOpts(bodyshop);
+      const routing = opts?.routing || client?.opts?.routing || null;
+      if (!routing?.dealerNumber) throw new Error("ensureRRServiceVehicle: routing.dealerNumber required");
+
+      // Reconstruct a lightweight tx object (so resolveVin can use the same shape we logged at {1.2})
+      const tx = {
+        jobData: {
+          ...job,
+          vin: job?.v_vin
+        },
+        txEnvelope
+      };
+
+      const vin = resolveVin({ tx, job });
+
+      if (!vin) {
+        CreateRRLogEvent(socket, "ERROR", "{3.x} No VIN found for ensureRRServiceVehicle", { jobid: rid });
+        throw new Error("ensureRRServiceVehicle: vin required");
+      }
+
+      CreateRRLogEvent(socket, "DEBUG", "{3.2} ensureRRServiceVehicle: starting", {
+        jobid: rid,
+        selectedCustomerNo: effectiveCustNo,
+        vin,
+        dealerNumber: routing.dealerNumber,
+        storeNumber: routing.storeNumber,
+        areaNumber: routing.areaNumber
+      });
+
+      const ensured = await ensureRRServiceVehicle({
+        client,
+        routing,
+        bodyshop,
+        selectedCustomerNo: effectiveCustNo,
+        custNo: effectiveCustNo,
+        customerNo: effectiveCustNo,
+        vin,
+        job,
+        socket,
+        redisHelpers
+      });
+
+      CreateRRLogEvent(socket, "DEBUG", "{3.4} ensureRRServiceVehicle: done", ensured);
+
+      const cachedAdvisor = await redisHelpers.getSessionTransactionData(socket.id, ns, RRCacheEnums.AdvisorNo);
+      const advisorNo = readAdvisorNo({ txEnvelope }, cachedAdvisor);
+
+      if (!advisorNo) {
+        CreateRRLogEvent(socket, "ERROR", `Advisor is required (advisorNo)`);
+        await insertRRFailedExportLog({
+          socket,
+          jobId: rid,
+          job,
+          bodyshop,
+          error: new Error("Advisor is required (advisorNo)."),
+          classification: { errorCode: "RR_MISSING_ADVISOR", friendlyMessage: "Advisor is required." }
+        });
+        socket.emit("export-failed", { vendor: "rr", jobId: rid, error: "Advisor is required (advisorNo)." });
+        return ack?.({ ok: false, error: "Advisor is required (advisorNo)." });
+      }
+
+      await redisHelpers.setSessionTransactionData(
+        socket.id,
+        ns,
+        RRCacheEnums.AdvisorNo,
+        String(advisorNo),
+        defaultRRTTL
+      );
+
+      // CREATE/UPDATE (first step only)
+      CreateRRLogEvent(socket, "DEBUG", `{4} Performing RR create/update (step 1)`);
+      const result = await exportJobToRR({
+        bodyshop,
+        job,
+        selectedCustomer: { customerNo: effectiveCustNo, custNo: effectiveCustNo },
+        advisorNo: String(advisorNo),
+        txEnvelope,
+        socket,
+        svId: ensured?.svId || null
+      });
+
+      // Cache raw export result + pending RO number for finalize
+      await redisHelpers.setSessionTransactionData(
+        socket.id,
+        ns,
+        RRCacheEnums.ExportResult,
+        result || {},
+        defaultRRTTL
+      );
+
+      if (result?.success) {
+        const data = result?.data || {};
+
+        // Prefer explicit return from export function; then fall back to fields
+        const dmsRoNo = result?.roNo ?? data?.dmsRoNo ?? null;
+
+        const outsdRoNo = data?.outsdRoNo ?? job?.ro_number ?? job?.id ?? null;
+
+        await redisHelpers.setSessionTransactionData(
+          socket.id,
+          ns,
+          RRCacheEnums.PendingRO,
+          {
+            outsdRoNo,
+            dmsRoNo,
+            customerNo: String(effectiveCustNo),
+            advisorNo: String(advisorNo),
+            vin: job?.v_vin || null
+          },
+          defaultRRTTL
+        );
+
+        CreateRRLogEvent(socket, "INFO", `{5} RO created. Waiting for validation.`, {
+          dmsRoNo: dmsRoNo || null,
+          outsdRoNo: outsdRoNo || null
+        });
+
+        // Tell FE to prompt for "Finished/Close"
+        socket.emit("rr-validation-required", { jobId: rid, dmsRoNo, outsdRoNo });
+
+        // Still emit info result if you want
+        socket.emit("rr-export-job:result", { jobId: rid, bodyshopId: bodyshop?.id, result });
+
+        // ACK but indicate it's pending finalize + include customer number + created flag
+        ack?.({
+          ok: true,
+          pendingFinalize: true,
+          dmsRoNo,
+          outsdRoNo,
+          result,
+          custNo: String(effectiveCustNo),
+          createdCustomer
+        });
+      } else {
+        // classify & fail (no finalize)
+        const tx = result?.statusBlocks?.transaction;
+
+        const vendorStatusCode = Number(
+          result?.roStatus?.statusCode ?? result?.roStatus?.StatusCode ?? tx?.statusCode ?? tx?.StatusCode
+        );
+
+        const vendorMessage =
+          result?.roStatus?.message ??
+          result?.roStatus?.Message ??
+          tx?.message ??
+          tx?.Message ??
+          result?.error ??
+          "RR export failed";
+
+        const cls = classifyRRVendorError({
+          code: vendorStatusCode,
+          message: vendorMessage
+        });
+
+        CreateRRLogEvent(socket, "ERROR", `Export failed (step 1)`, {
+          roStatus: result?.roStatus,
+          statusBlocks: result?.statusBlocks,
+          classification: cls
+        });
+
+        await insertRRFailedExportLog({
+          socket,
+          jobId: rid,
+          job,
+          bodyshop,
+          error: new Error(cls.friendlyMessage || result?.error || "RR export failed"),
+          classification: cls,
+          result
+        });
+
+        socket.emit("export-failed", {
+          vendor: "rr",
+          jobId: rid,
+          error: cls?.friendlyMessage || result?.error || "RR export failed",
+          ...cls
+        });
+
+        ack?.({
+          ok: false,
+          error: cls.friendlyMessage || result?.error || "RR export failed",
+          result,
+          classification: cls
+        });
+      }
+    } catch (error) {
+      const cls = classifyRRVendorError(error);
+
+      CreateRRLogEvent(socket, "ERROR", `Error during RR export (selected-customer)`, {
+        error: error.message,
+        vendorStatusCode: cls.vendorStatusCode,
+        code: cls.errorCode,
+        friendly: cls.friendlyMessage,
+        stack: error.stack,
+        jobid: rid
+      });
+
+      try {
+        if (!bodyshop || !job) {
+          const { bodyshopId } = await getSessionOrSocket(redisHelpers, socket);
+          bodyshop = bodyshop || (await getBodyshopForSocket({ bodyshopId, socket }));
+          job =
+            job ||
+            (await redisHelpers.getSessionTransactionData(socket.id, getTransactionType(rid), RRCacheEnums.JobData));
+        }
+      } catch {
+        //
+      }
+
+      await insertRRFailedExportLog({
+        socket,
+        jobId: rid,
+        job,
+        bodyshop,
+        error,
+        classification: cls
+      });
+
+      try {
+        socket.emit("export-failed", {
+          vendor: "rr",
+          jobId: rid,
+          error: error.message,
+          ...cls
+        });
+        socket.emit("rr-user-notice", { jobId: rid, ...cls });
+      } catch {
+        //
+      }
+
+      ack?.({ ok: false, error: cls.friendlyMessage || error.message, classification: cls });
+    }
+  });
+
+  socket.on("rr-finalize-repair-order", async ({ jobid, jobId } = {}, ack) => {
+    const rid = resolveJobId(jobid || jobId, { jobid, jobId }, null);
+    let bodyshop = null;
+    let job = null;
+
+    try {
+      if (!rid) throw new Error("jobid required for finalize");
+
+      const ns = getTransactionType(rid);
+      const { bodyshopId } = await getSessionOrSocket(redisHelpers, socket);
+      bodyshop = await getBodyshopForSocket({ bodyshopId, socket });
+
+      job = await redisHelpers.getSessionTransactionData(socket.id, ns, RRCacheEnums.JobData);
+      if (!job) job = await QueryJobData({ redisHelpers }, rid);
+
+      const pending = await redisHelpers.getSessionTransactionData(socket.id, ns, RRCacheEnums.PendingRO);
+      const advisorNo = await redisHelpers.getSessionTransactionData(socket.id, ns, RRCacheEnums.AdvisorNo);
+      const selectedCustomerNo = await redisHelpers.getSessionTransactionData(
+        socket.id,
+        ns,
+        RRCacheEnums.SelectedCustomer
+      );
+
+      if (!advisorNo) throw new Error("Advisor missing in session");
+      if (!selectedCustomerNo) throw new Error("Customer number missing in session");
+
+      // Prefer cached outsdRoNo; fall back to our deterministic external number
+      const outsdRoNo = pending?.outsdRoNo ?? job?.ro_number ?? job?.id ?? null;
+      // Prefer DMS RO for update, but finalize() will safely fall back to Outsd if missing
+      const dmsRoNo = pending?.dmsRoNo ?? pending?.roNo ?? null;
+
+      CreateRRLogEvent(socket, "DEBUG", `{6} Finalizing RR RO`, {
+        jobId: rid,
+        outsdRoNo,
+        dmsRoNo,
+        advisorNo,
+        customerNo: selectedCustomerNo
+      });
+
+      const finalizeResult = await finalizeRRRepairOrder({
+        bodyshop,
+        job,
+        advisorNo: String(advisorNo),
+        customerNo: String(selectedCustomerNo),
+        roNo: dmsRoNo, // ✅ RR requires roNo; finalize() will fall back to outsdRoNo if this is absent
+        vin: pending?.vin,
+        socket
+      });
+
+      if (finalizeResult?.success) {
+        CreateRRLogEvent(socket, "INFO", `{7} Finalize success; marking exported`, { dmsRoNo, outsdRoNo });
+
+        // ✅ Mark exported + success log
+        await markRRExportSuccess({
+          socket,
+          jobId: rid,
+          job,
+          bodyshop,
+          result: finalizeResult
+        });
+
+        // Clean pending key
+        try {
+          await redisHelpers.setSessionTransactionData(socket.id, ns, RRCacheEnums.PendingRO, null, 1);
+        } catch {
+          //
+        }
+
+        socket.emit("export-success", { vendor: "rr", jobId: rid, roStatus: finalizeResult?.roStatus });
+        ack?.({ ok: true, result: finalizeResult });
+      } else {
+        const tx = finalizeResult?.statusBlocks?.transaction;
+
+        const vendorStatusCode = Number(
+          finalizeResult?.roStatus?.statusCode ??
+            finalizeResult?.roStatus?.StatusCode ??
+            tx?.statusCode ??
+            tx?.StatusCode
+        );
+
+        const vendorMessage =
+          finalizeResult?.roStatus?.message ??
+          finalizeResult?.roStatus?.Message ??
+          tx?.message ??
+          tx?.Message ??
+          finalizeResult?.error ??
+          "RR finalize failed";
+
+        const cls = classifyRRVendorError({
+          code: vendorStatusCode,
+          message: vendorMessage
+        });
+
+        await insertRRFailedExportLog({
+          socket,
+          jobId: rid,
+          job,
+          bodyshop,
+          error: new Error(cls.friendlyMessage || finalizeResult?.error || "RR finalize failed"),
+          classification: cls,
+          result: finalizeResult
+        });
+
+        socket.emit("export-failed", {
+          vendor: "rr",
+          jobId: rid,
+          error: cls?.friendlyMessage || finalizeResult?.error || "RR finalize failed",
+          ...cls
+        });
+        ack?.({ ok: false, error: cls.friendlyMessage || "RR finalize failed", classification: cls });
+      }
+    } catch (error) {
+      const cls = classifyRRVendorError(error);
+      CreateRRLogEvent(socket, "ERROR", `Error during RR finalize`, {
+        error: error.message,
+        vendorStatusCode: cls.vendorStatusCode,
+        code: cls.errorCode,
+        friendly: cls.friendlyMessage,
+        stack: error.stack,
+        jobid: rid
+      });
+
+      try {
+        if (!bodyshop || !job) {
+          const { bodyshopId } = await getSessionOrSocket(redisHelpers, socket);
+          bodyshop = bodyshop || (await getBodyshopForSocket({ bodyshopId, socket }));
+          job =
+            job ||
+            (await redisHelpers.getSessionTransactionData(socket.id, getTransactionType(rid), RRCacheEnums.JobData));
+        }
+      } catch {
+        //
+      }
+
+      await insertRRFailedExportLog({
+        socket,
+        jobId: rid,
+        job,
+        bodyshop,
+        error,
+        classification: cls
+      });
+
+      try {
+        socket.emit("export-failed", { vendor: "rr", jobId: rid, error: error.message, ...cls });
+      } catch {
+        //
+      }
+
+      ack?.({ ok: false, error: cls.friendlyMessage || error.message, classification: cls });
+    }
+  });
+
+  socket.on("rr-calculate-allocations", async (jobid, cb) => {
+    try {
+      CreateRRLogEvent(socket, "DEBUG", "rr-calculate-allocations: begin", { jobid });
+
+      const raw = await RRCalculateAllocations(socket, jobid);
+
+      // If the helper returns an explicit error shape, just pass it through.
+      if (raw && raw.ok === false) {
+        cb?.(raw);
+        socket.emit("rr-calculate-allocations:result", raw);
+        CreateRRLogEvent(socket, "DEBUG", "rr-calculate-allocations: helper returned error", {
+          jobid,
+          error: raw.error
+        });
+        return;
+      }
+
+      let ack;
+      let jobAllocations;
+
+      if (Array.isArray(raw)) {
+        // Legacy shape: plain allocations array
+        jobAllocations = raw;
+        ack = { jobAllocations: raw };
+      } else {
+        ack = raw || {};
+        jobAllocations = Array.isArray(ack.jobAllocations) ? ack.jobAllocations : [];
+      }
+
+      // Try to derive OpCode from bodyshop; fall back to default
+      let opCode = "28TOZ";
+
+      try {
+        const { bodyshopId } = await getSessionOrSocket(redisHelpers, socket);
+        const bodyshop = await getBodyshopForSocket({ bodyshopId, socket });
+        opCode = bodyshop?.rr_configuration?.baseOpCode || opCode;
+      } catch (e) {
+        CreateRRLogEvent(socket, "WARN", "rr-calculate-allocations: bodyshop lookup failed, using default OpCode", {
+          error: e.message
+        });
+      }
+
+      let rogg = null;
+      let rolabor = null;
+
+      try {
+        rogg = buildRogogFromAllocations(jobAllocations, { opCode, payType: "Cust" });
+        if (rogg) {
+          rolabor = buildRolaborFromRogog(rogg, { payType: "Cust" });
+        }
+      } catch (e) {
+        CreateRRLogEvent(socket, "WARN", "rr-calculate-allocations: failed to build ROGOG/ROLABOR preview", {
+          error: e.message
+        });
+      }
+
+      const enriched = {
+        ...ack,
+        rogg,
+        rolabor
+      };
+
+      cb?.(enriched);
+      socket.emit("rr-calculate-allocations:result", enriched);
+      CreateRRLogEvent(socket, "DEBUG", "rr-calculate-allocations: success", {
+        jobid,
+        jobAllocations: jobAllocations.length,
+        hasRogg: !!rogg,
+        hasRolabor: !!rolabor
+      });
+    } catch (e) {
+      CreateRRLogEvent(socket, "ERROR", "rr-calculate-allocations: failed", { error: e.message, jobid });
+      cb?.({ ok: false, error: e.message });
+    }
+  });
+};
+
+module.exports = registerRREvents;

server/rr/rr-responsibility-centers.js

@@ -0,0 +1,131 @@
+// Helpers to use md_responsibility_centers (including RR GOG metadata)
+// to build the data needed for ROLABOR + ROGOG lines.
+
+/**
+ * Extracts responsibility center configuration into a convenient structure.
+ *
+ * Expects bodyshop.md_responsibility_centers to look like:
+ *
+ * {
+ *   costs:   [{ name, ... }],
+ *   profits: [{ name, rr_gogcode, rr_item_type, rr_cust_txbl_flag, ... }],
+ *   dms_defaults: {
+ *     costs:   { LAB: "Body Labor Cost", ... },
+ *     profits: { LAB: "Body Labor Sales", ... }
+ *   },
+ *   defaults: {
+ *     costs:   { LAB: "Some Cost Center", ... },
+ *     profits: { LAB: "Some Profit Center", ... }
+ *   }
+ * }
+ */
+function extractRrResponsibilityCenters(bodyshop = {}) {
+  const centers = bodyshop.md_responsibility_centers || {};
+  const { costs = [], profits = [], dms_defaults = {}, defaults = {} } = centers;
+
+  const indexByName = (arr = []) =>
+    (arr || []).reduce((acc, center) => {
+      if (center && center.name) {
+        acc[center.name] = center;
+      }
+      return acc;
+    }, {});
+
+  return {
+    costsByName: indexByName(costs),
+    profitsByName: indexByName(profits),
+    dmsCostDefaults: (dms_defaults && dms_defaults.costs) || {},
+    dmsProfitDefaults: (dms_defaults && dms_defaults.profits) || {},
+    defaultCosts: defaults.costs || {},
+    defaultProfits: defaults.profits || {}
+  };
+}
+
+/**
+ * Resolve cost + profit centers for a given internal code (ATS/LAB/etc.).
+ * Prioritizes dms_defaults, then defaults.
+ *
+ * @param {string} code
+ * @param {ReturnType<typeof extractRrResponsibilityCenters>} cfg
+ * @returns {{ costCenter: object|null, profitCenter: object|null }}
+ */
+function resolveCentersForCode(code, cfg) {
+  if (!code || !cfg) return { costCenter: null, profitCenter: null };
+
+  const costCenterName = cfg.dmsCostDefaults[code] || cfg.defaultCosts[code] || null;
+  const profitCenterName = cfg.dmsProfitDefaults[code] || cfg.defaultProfits[code] || null;
+
+  const costCenter = costCenterName && cfg.costsByName[costCenterName] ? cfg.costsByName[costCenterName] : null;
+  const profitCenter =
+    profitCenterName && cfg.profitsByName[profitCenterName] ? cfg.profitsByName[profitCenterName] : null;
+
+  return { costCenter, profitCenter };
+}
+
+/**
+ * Build a single RR GOG line payload from a jobline + code.
+ *
+ * NOTE: This returns a neutral JS object. You still need to map it into
+ * the exact Mustache / XML shape used for AllGogLineItmInfo.
+ *
+ * @param {Object} params
+ * @param {Object} params.jobline        // jobline record from Hasura
+ * @param {string} params.code           // e.g. "LAB", "ATS", ...
+ * @param {object} params.centersConfig  // result of extractRrResponsibilityCenters()
+ * @param {number} params.sale           // CustPrice
+ * @param {number} params.cost           // DollarCost
+ */
+function buildRrGogLine({ jobline, code, centersConfig, sale, cost }) {
+  const { profitCenter } = resolveCentersForCode(code, centersConfig);
+
+  if (!profitCenter || !profitCenter.rr_gogcode) {
+    throw new Error('RR: missing rr_gogcode for profit center mapping of code "' + code + '"');
+  }
+
+  return {
+    // For your own reference:
+    code,
+    joblineId: jobline && jobline.id,
+
+    // Fields you ultimately care about for ROGOG:
+    BreakOut: profitCenter.rr_gogcode, // GOG code / BreakOut
+    ItemType: profitCenter.rr_item_type || "G", // P / G / F / ...
+    CustTxblNTxblFlag: profitCenter.rr_cust_txbl_flag || "T", // T/N
+    CustPrice: Number(sale || 0),
+    DollarCost: Number(cost || 0),
+
+    // Surface full profit center in case templates / logs need it:
+    profitCenter
+  };
+}
+
+/**
+ * Build a minimal RR labor (ROLABOR) line "shell".
+ * Amounts are zero if all financials are in GOG.
+ *
+ * @param {Object} params
+ * @param {Object} params.job            // job record (for RO header context)
+ * @param {string} params.opCode         // global opcode (already resolved)
+ * @param {Object} [params.profitCenter] // optional profit center for context
+ */
+function buildRrLaborLine({ job, opCode, profitCenter }) {
+  if (!opCode) {
+    throw new Error("RR: opCode is required to build ROLABOR line");
+  }
+
+  return {
+    jobId: job && job.id,
+    OpCode: opCode,
+    PayType: "Cust", // always Cust per your notes
+    CustPrice: 0,
+    DollarCost: 0,
+    profitCenter
+  };
+}
+
+module.exports = {
+  extractRrResponsibilityCenters,
+  resolveCentersForCode,
+  buildRrGogLine,
+  buildRrLaborLine
+};

server/rr/rr-service-vehicles.js

@@ -0,0 +1,324 @@
+const { buildClientAndOpts, rrCombinedSearch } = require("./rr-lookup");
+const CreateRRLogEvent = require("./rr-logger-event");
+/**
+ * Pick and normalize VIN from inputs
+ * @param vin
+ * @param job
+ * @returns {string}
+ */
+const pickVin = ({ vin, job }) => {
+  const v = vin || job?.v_vin || job?.vehicle?.vin || job?.vin || job?.vehicleVin || null;
+
+  if (!v) return "";
+  return String(v)
+    .replace(/[^A-Za-z0-9]/g, "")
+    .toUpperCase()
+    .slice(0, 17);
+};
+
+/**
+ * Pick and normalize customer number from inputs
+ * @param selectedCustomerNo
+ * @param custNo
+ * @param customerNo
+ * @returns {string|string}
+ */
+const pickCustNo = ({ selectedCustomerNo, custNo, customerNo }) => {
+  const c = selectedCustomerNo ?? custNo ?? customerNo ?? null;
+  return c != null ? String(c).trim() : "";
+};
+
+/**
+ * Simple length sanitizer for outbound strings
+ * Returns undefined if value is null/undefined/empty after trim.
+ */
+const sanitizeLength = (value, maxLen) => {
+  if (value == null) return undefined;
+  let s = String(value).trim();
+  if (!s) return undefined;
+  if (maxLen && s.length > maxLen) {
+    s = s.slice(0, maxLen);
+  }
+  return s;
+};
+
+/**
+ * Extract owner customer numbers from combined search results
+ * @param res
+ * @param wantedVin
+ * @returns {Set<any>}
+ */
+const ownersFromCombined = (res, wantedVin) => {
+  const blocks = Array.isArray(res?.data) ? res.data : [];
+  const owners = new Set();
+  for (const blk of blocks) {
+    const serv = Array.isArray(blk?.ServVehicle) ? blk.ServVehicle : [];
+    for (const sv of serv) {
+      const v = sv?.Vehicle || {};
+      const vin = (v?.Vin || v?.VIN || v?.vin || "").toString().toUpperCase();
+      const cust = sv?.VehicleServInfo?.CustomerNo;
+      if (vin && cust && (!wantedVin || vin === wantedVin)) {
+        owners.add(String(cust));
+      }
+    }
+  }
+  return owners;
+};
+
+/**
+ * Determine if error indicates "already exists"
+ * @param e
+ * @returns {boolean}
+ */
+const isAlreadyExistsError = (e) => {
+  if (!e) return false;
+  if (e.code === 300) return true;
+  const msg = (e.message || "").toUpperCase();
+  return msg.includes("ALREADY EXISTS") || msg.includes("VEHICLE ALREADY EXISTS");
+};
+
+function deriveMakeCode(makeDesc) {
+  if (!makeDesc) return "FR"; // safe default
+
+  const map = {
+    Ford: "FO",
+    FORD: "FO",
+    Lincoln: "LN",
+    Mercury: "MY",
+    Chevrolet: "CH",
+    GMC: "GM",
+    Cadillac: "CA",
+    Buick: "BU",
+    Pontiac: "PO",
+    Oldsmobile: "OL",
+    Saturn: "SA",
+    Dodge: "DO",
+    Chrysler: "CH",
+    Jeep: "JE",
+    Plymouth: "PL",
+    Toyota: "TY",
+    Lexus: "LX",
+    Honda: "HO",
+    Acura: "AC",
+    Nissan: "NI",
+    Infiniti: "IN",
+    Hyundai: "HY",
+    Kia: "KI",
+    Subaru: "SU",
+    Mazda: "MZ",
+    Volkswagen: "VW",
+    Audi: "AU",
+    BMW: "BM",
+    Mercedes: "MB",
+    "Mercedes-Benz": "MB",
+    Volvo: "VO",
+    Ram: "RA" // post-2010
+  };
+
+  return map[makeDesc.trim().toUpperCase()] || "FR"; // TODO Default set
+}
+
+/**
+ * Ensure/create a Service Vehicle in RR for the given VIN + customer.
+ * Args may contain:
+ *  - client, routing  (prebuilt)  OR  bodyshop (we'll build a client)
+ *  - vin OR job (we'll derive vin from job)
+ *  - selectedCustomerNo / custNo / customerNo
+ *  - license (optional)
+ *  - socket (for logging)
+ *
+ * Returns: { created:boolean, exists:boolean, vin, customerNo, svId?, status? }
+ */
+const ensureRRServiceVehicle = async (args = {}) => {
+  const {
+    client: inClient,
+    routing: inRouting,
+    bodyshop,
+    job,
+    vin,
+    selectedCustomerNo,
+    custNo,
+    customerNo,
+    license,
+    socket
+  } = args;
+
+  // Build/derive essentials
+  let client = inClient;
+  let routing = inRouting;
+
+  if (!client || !routing) {
+    if (!bodyshop) {
+      throw new Error("ensureRRServiceVehicle: either (client & routing) or bodyshop is required");
+    }
+    const built = buildClientAndOpts(bodyshop);
+    client = built.client;
+    routing = built.opts?.routing;
+  }
+
+  const vinStr = pickVin({ vin, job });
+  const custNoStr = pickCustNo({ selectedCustomerNo, custNo, customerNo });
+
+  if (!vinStr) throw new Error("ensureRRServiceVehicle: vin required");
+  if (!custNoStr) throw new Error("ensureRRServiceVehicle: customerNo required");
+
+  // --- Preflight: does VIN already exist (and under whom)? ---
+  try {
+    let owners = new Set();
+    if (bodyshop) {
+      const combinedSearchResponse = await rrCombinedSearch(bodyshop, { kind: "vin", vin: vinStr, maxResults: 50 });
+
+      CreateRRLogEvent(socket, "silly", "{SV} Preflight combined search by VIN: raw response", {
+        response: combinedSearchResponse
+      });
+
+      owners = ownersFromCombined(combinedSearchResponse, vinStr);
+    }
+    // Short-circuit: VIN exists anywhere -> don't try to insert
+    if (owners.size > 0) {
+      const ownedBySame = owners.has(custNoStr);
+
+      CreateRRLogEvent(socket, ownedBySame ? "info" : "warn", "{SV} VIN already present in RR; skipping insert", {
+        vin: vinStr,
+        selectedCustomerNo: custNoStr,
+        owners: Array.from(owners)
+      });
+
+      return {
+        created: false,
+        exists: true,
+        vin: vinStr,
+        customerNo: custNoStr,
+        ownedBySame
+      };
+    }
+  } catch (e) {
+    // Preflight shouldn't be fatal; log and continue to insert (idempotency will still be handled)
+    CreateRRLogEvent(socket, "warn", "{SV} VIN preflight lookup failed; continuing to insert", {
+      vin: vinStr,
+      error: e?.message
+    });
+  }
+
+  // Vendor says: MODEL DESCRIPTION HAS MAXIMUM LENGTH OF 20
+  const rawModelDesc = job?.v_model_desc;
+  const safeModelDesc = sanitizeLength(rawModelDesc, 20);
+  if (rawModelDesc && safeModelDesc && rawModelDesc.trim() !== safeModelDesc) {
+    CreateRRLogEvent(socket, "warn", "{SV} Truncated model description to 20 chars", {
+      original: rawModelDesc,
+      truncated: safeModelDesc
+    });
+  }
+
+  const insertPayload = {
+    vin: vinStr.toUpperCase(), // "1FDWX34Y28EB01395"
+
+    // 2-character make code (from v_make_desc → known mapping)
+    vehicleMake: deriveMakeCode(job?.v_make_desc), // → "FR" for Ford
+    year: job?.v_model_yr || undefined,
+
+    // Model description (RR: max length 20)
+    modelDesc: safeModelDesc,
+
+    // Model number / carline / other optional fields
+    mdlNo: undefined,
+    carline: undefined,
+    extClrDesc: sanitizeLength(job?.v_color, 30), // safe, configurable if vendor complains
+    accentClr: undefined,
+    aircond: undefined,
+    pwrstr: undefined,
+    transm: undefined,
+    turbo: undefined,
+    engineConfig: undefined,
+    trim: undefined,
+
+    // License plate
+    licNo: sanitizeLength(license ? String(license) : undefined, 20),
+
+    customerNo: custNoStr,
+    stockId: sanitizeLength(job?.ro_number, 20), // RO as stock#, truncated for safety
+    vehicleServInfo: {
+      customerNo: custNoStr, // REQUIRED — this is what toServiceVehicleView() validates
+      salesmanNo: undefined,
+      inServiceDate: undefined,
+      productionDate: undefined,
+      modelMaintCode: undefined,
+      teamCode: undefined,
+      vehExtWarranty: undefined,
+      advisor: undefined
+    }
+  };
+
+  const insertOpts = {
+    routing,
+    envelope: {
+      sender: {
+        component: "Rome",
+        task: "SV",
+        referenceId: "Insert",
+        creator: "RCI",
+        senderName: "RCI"
+      }
+    }
+  };
+
+  CreateRRLogEvent(socket, "info", "{SV} Inserting service vehicle", {
+    vin: vinStr,
+    selectedCustomerNo: custNoStr,
+    payloadShape: Object.keys(insertPayload).filter((k) => insertPayload[k] != null)
+  });
+
+  try {
+    const res = await client.insertServiceVehicle(insertPayload, insertOpts);
+
+    CreateRRLogEvent(socket, "silly", "{SV} insertServiceVehicle: raw response", { res });
+
+    const data = res?.data ?? {};
+    const svId = data?.dmsRecKey || data?.svId || undefined;
+
+    CreateRRLogEvent(socket, "info", "{SV} insertServiceVehicle: success", {
+      vin: vinStr,
+      customerNo: custNoStr,
+      svId
+    });
+
+    return {
+      created: true,
+      exists: false,
+      vin: vinStr,
+      customerNo: custNoStr,
+      svId,
+      status: res?.statusBlocks?.transaction
+    };
+  } catch (e) {
+    if (isAlreadyExistsError(e)) {
+      // Treat as idempotent success
+      CreateRRLogEvent(socket, "warn", "{SV} insertServiceVehicle: already exists; treating as success", {
+        vin: vinStr,
+        customerNo: custNoStr,
+        code: e?.code,
+        status: e?.meta?.status || e?.status
+      });
+
+      return {
+        created: false,
+        exists: true,
+        vin: vinStr,
+        customerNo: custNoStr,
+        status: e?.meta?.status || e?.status
+      };
+    }
+
+    CreateRRLogEvent(socket, "error", "{SV} insertServiceVehicle: failure", {
+      message: e?.message,
+      code: e?.code,
+      status: e?.meta?.status || e?.status
+    });
+
+    throw e;
+  }
+};
+
+module.exports = {
+  ensureRRServiceVehicle
+};

server/rr/rr-utils.js

@@ -0,0 +1,193 @@
+/**
+ * Get last 8 chars of a string, uppercased
+ * @param v
+ * @returns {string}
+ */
+const last8 = (v) => {
+  return (String(v || "") || "").slice(-8).toUpperCase();
+};
+
+/**
+ * Extract owner customer numbers from VIN-based blocks
+ * @param blocks
+ * @param jobVin
+ * @returns {Set<any>}
+ */
+const ownersFromVinBlocks = (blocks = [], jobVin = null) => {
+  const out = new Set();
+  const want8 = jobVin ? last8(jobVin) : null;
+
+  for (const blk of Array.isArray(blocks) ? blocks : []) {
+    const serv = Array.isArray(blk?.ServVehicle) ? blk.ServVehicle : [];
+    for (const sv of serv) {
+      const svVin = String(sv?.Vehicle?.Vin || "");
+      if (want8 && last8(svVin) !== want8) continue;
+      const custNo = sv?.VehicleServInfo?.CustomerNo;
+      if (custNo != null && String(custNo).trim() !== "") {
+        out.add(String(custNo).trim());
+      }
+    }
+  }
+  return out;
+};
+
+/**
+ * Make vehicle search payload from job data
+ * @param job
+ * @returns {null|{kind: string, license: string, maxResults: number}|{kind: string, vin: string, maxResults: number}}
+ */
+const makeVehicleSearchPayloadFromJob = (job) => {
+  const vin = job?.v_vin;
+  if (vin) return { kind: "vin", vin: String(vin).trim(), maxResults: 50 };
+  const plate = job?.plate_no;
+  if (plate) return { kind: "license", license: String(plate).trim(), maxResults: 50 };
+  return null;
+};
+
+/**
+ * Normalize customer candidates from VIN/name blocks, including address + owner flag
+ * IMPORTANT: If no ServVehicle/CustomerNo exists (e.g. name-only hits), fall back to NameRecId.
+ * @param res
+ * @param ownersSet
+ * @returns {any[]}
+ */
+const normalizeCustomerCandidates = (res, { ownersSet = null } = {}) => {
+  const blocks = Array.isArray(res?.data) ? res.data : [];
+  const out = [];
+
+  const pickAddr = (addrArr) => {
+    const arr = Array.isArray(addrArr) ? addrArr : addrArr ? [addrArr] : [];
+    if (!arr.length) return null;
+
+    const chosen = arr.find((a) => (a?.Type || a?.type || "").toString().toUpperCase() === "P") || arr[0];
+
+    const line1 = chosen?.Addr1 ?? chosen?.AddressLine1 ?? chosen?.Line1 ?? chosen?.Street1 ?? undefined;
+    const line2 = chosen?.Addr2 ?? chosen?.AddressLine2 ?? chosen?.Line2 ?? chosen?.Street2 ?? undefined;
+    const city = chosen?.City ?? chosen?.city ?? undefined;
+    const state = chosen?.State ?? chosen?.StateOrProvince ?? chosen?.state ?? undefined;
+    const postalCode = chosen?.Zip ?? chosen?.PostalCode ?? chosen?.zip ?? undefined;
+    const country = chosen?.Country ?? chosen?.CountryCode ?? chosen?.country ?? undefined;
+    const county = chosen?.County ?? chosen?.county ?? undefined; // << added
+
+    if (!line1 && !city && !state && !postalCode && !country && !county) return null;
+    return { line1, line2, city, state, postalCode, country, county };
+  };
+
+  for (const blk of blocks) {
+    const serv = Array.isArray(blk?.ServVehicle) ? blk.ServVehicle : [];
+    const custNos = serv.map((sv) => sv?.VehicleServInfo?.CustomerNo).filter(Boolean);
+
+    const nci = blk?.NameContactId;
+    const ind = nci?.NameId?.IndName;
+    const bus = nci?.NameId?.BusName;
+
+    const personal = [ind?.FirstName ?? ind?.FName, ind?.LastName ?? ind?.LName].filter(Boolean).join(" ").trim();
+    const company = bus?.CompanyName ?? bus?.BName;
+    const name = (personal || company || "").trim();
+
+    const address = pickAddr(nci?.Address);
+
+    // fallback to NameRecId when no ServVehicle/CustomerNo exists (e.g., pure name search)
+    const nameRecIdRaw = nci?.NameId?.NameRecId;
+    const nameRecId = nameRecIdRaw != null ? String(nameRecIdRaw).trim() : "";
+
+    if (Array.isArray(custNos) && custNos.length > 0) {
+      for (const custNo of custNos) {
+        const cno = String(custNo).trim();
+        if (!cno) continue;
+
+        const item = {
+          custNo: cno,
+          name: name || `Customer ${cno}`,
+          address: address || undefined
+        };
+
+        if (ownersSet && ownersSet.has(cno)) {
+          item.isVehicleOwner = true;
+          item.vinOwner = true;
+        }
+
+        out.push(item);
+      }
+    } else if (nameRecId) {
+      // Use NameRecId as the identifier
+      const cno = nameRecId;
+      const item = {
+        custNo: cno,
+        name: name || `Customer ${cno}`,
+        address: address || undefined
+      };
+      out.push(item);
+    }
+  }
+
+  // Deduplicate by custNo, merge owner/address flags
+  const byId = new Map();
+  for (const c of out) {
+    const key = (c.custNo || "").trim();
+    if (!key) continue;
+    const prev = byId.get(key);
+    if (!prev) byId.set(key, c);
+    else {
+      byId.set(key, {
+        ...prev,
+        isVehicleOwner: prev.isVehicleOwner || c.isVehicleOwner,
+        vinOwner: prev.vinOwner || c.vinOwner,
+        address: prev.address || c.address
+      });
+    }
+  }
+
+  return Array.from(byId.values());
+};
+
+/**
+ * Read advisor number from payload or cached value
+ * @param payload
+ * @param cached
+ * @returns {string|null}
+ */
+const readAdvisorNo = (payload, cached) => {
+  const tx = payload?.txEnvelope || payload?.envelope || {};
+
+  const get = (v) => (v != null && String(v).trim() !== "" ? String(v).trim() : null);
+  return get(tx?.advisorNo) || get(payload?.advisorNo) || get(cached) || null;
+};
+
+/**
+ * Cache enum keys for RR session transaction data
+ * @type {{txEnvelope: string, JobData: string, SelectedCustomer: string, AdvisorNo: string, VINCandidates: string, SelectedVin: string, ExportResult: string, PendingRO: string}}
+ */
+const RRCacheEnums = {
+  txEnvelope: "RR.txEnvelope",
+  JobData: "RR.JobData",
+  SelectedCustomer: "RR.SelectedCustomer",
+  AdvisorNo: "RR.AdvisorNo",
+  VINCandidates: "RR.VINCandidates",
+  SelectedVin: "RR.SelectedVin",
+  ExportResult: "RR.ExportResult",
+  PendingRO: "RR.PendingRO"
+};
+
+/**
+ * Get transaction type string for job ID
+ * @param jobid
+ * @returns {`rr:${string}`}
+ */
+const getTransactionType = (jobid) => `rr:${jobid}`;
+
+/**
+ * Default RR TTL (1 hour)
+ * @type {number}
+ */
+const defaultRRTTL = 60 * 60;
+
+module.exports = {
+  RRCacheEnums,
+  defaultRRTTL,
+  getTransactionType,
+  ownersFromVinBlocks,
+  makeVehicleSearchPayloadFromJob,
+  normalizeCustomerCandidates,
+  readAdvisorNo
+};

server/utils/redisHelpers.js

@@ -2,6 +2,10 @@ const { GET_BODYSHOP_BY_ID } = require("../graphql-client/queries");
 const devDebugLogger = require("./devDebugLogger");
 const client = require("../graphql-client/graphql-client").client;
 
+/**
+ * Bodyshop cache TTL in seconds
+ * @type {number}
+ */
 const BODYSHOP_CACHE_TTL = 3600; // 1 hour
 
 /**
@@ -19,6 +23,7 @@ const getBodyshopCacheKey = (bodyshopId) => `bodyshop-cache:${bodyshopId}`;
 const getUserSocketMappingKey = (email) =>
   `user:${process.env?.NODE_ENV === "production" ? "prod" : "dev"}:${email}:socketMapping`;
 
+const getSocketTransactionkey = ({ socketId, transactionType }) => `socket:${socketId}:${transactionType}`;
 /**
  * Fetch bodyshop data from the database
  * @param bodyshopId
@@ -51,15 +56,23 @@ const fetchBodyshopFromDB = async (bodyshopId, logger) => {
  */
 const applyRedisHelpers = ({ pubClient, app, logger }) => {
   // Store session data in Redis
-  const setSessionData = async (socketId, key, value) => {
+  const setSessionData = async (socketId, key, value, ttl) => {
     try {
       await pubClient.hset(`socket:${socketId}`, key, JSON.stringify(value)); // Use Redis pubClient
+      if (ttl && typeof ttl === "number") {
+        await pubClient.expire(`socket:${socketId}`, ttl);
+      }
     } catch (error) {
       logger.log(`Error Setting Session Data for socket ${socketId}: ${error}`, "ERROR", "redis");
     }
   };
 
-  // Retrieve session data from Redis
+  /**
+   * Retrieve session data from Redis
+   * @param socketId
+   * @param key
+   * @returns {Promise<any|null>}
+   */
   const getSessionData = async (socketId, key) => {
     try {
       const data = await pubClient.hget(`socket:${socketId}`, key);
@@ -69,7 +82,55 @@ const applyRedisHelpers = ({ pubClient, app, logger }) => {
     }
   };
 
-  // Clear session data from Redis
+  /**
+   * Store session transaction data in Redis
+   * @param socketId
+   * @param transactionType
+   * @param key
+   * @param value
+   * @param ttl
+   * @returns {Promise<void>}
+   */
+  const setSessionTransactionData = async (socketId, transactionType, key, value, ttl) => {
+    try {
+      await pubClient.hset(getSocketTransactionkey({ socketId, transactionType }), key, JSON.stringify(value)); // Use Redis pubClient
+      if (ttl && typeof ttl === "number") {
+        await pubClient.expire(getSocketTransactionkey({ socketId, transactionType }), ttl);
+      }
+    } catch (error) {
+      logger.log(
+        `Error Setting Session Data for socket transaction ${socketId}:${transactionType}: ${error}`,
+        "ERROR",
+        "redis"
+      );
+    }
+  };
+
+  /**
+   * Retrieve session transaction data from Redis
+   * @param socketId
+   * @param transactionType
+   * @param key
+   * @returns {Promise<any|null>}
+   */
+  const getSessionTransactionData = async (socketId, transactionType, key) => {
+    try {
+      const data = await pubClient.hget(getSocketTransactionkey({ socketId, transactionType }), key);
+      return data ? JSON.parse(data) : null;
+    } catch (error) {
+      logger.log(
+        `Error Getting Session Data for socket transaction ${socketId}:${transactionType}: ${error}`,
+        "ERROR",
+        "redis"
+      );
+    }
+  };
+
+  /**
+   * Clear session data from Redis
+   * @param socketId
+   * @returns {Promise<void>}
+   */
   const clearSessionData = async (socketId) => {
     try {
       await pubClient.del(`socket:${socketId}`);
@@ -78,6 +139,24 @@ const applyRedisHelpers = ({ pubClient, app, logger }) => {
     }
   };
 
+  /**
+   * Clear session transaction data from Redis
+   * @param socketId
+   * @param transactionType
+   * @returns {Promise<void>}
+   */
+  const clearSessionTransactionData = async (socketId, transactionType) => {
+    try {
+      await pubClient.del(getSocketTransactionkey({ socketId, transactionType }));
+    } catch (error) {
+      logger.log(
+        `Error Clearing Session Transaction Data for socket ${socketId}:${transactionType}: ${error}`,
+        "ERROR",
+        "redis"
+      );
+    }
+  };
+
   /**
    * Add a socket mapping for a user
    * @param email
@@ -276,111 +355,23 @@ const applyRedisHelpers = ({ pubClient, app, logger }) => {
     }
   };
 
-  // NOTE: The following code was written for an abandoned branch and things have changes since the,
+  /**
-  // Leaving it here for demonstration purposes, commenting it out so it does not get used
+   * Set provider cache data
+   * @param ns
+   * @param field
+   * @param value
+   * @param ttl
+   * @returns {Promise<void>}
+   */
+  const setProviderCache = (ns, field, value, ttl) => setSessionData(`${ns}:provider`, field, value, ttl);
 
-  // Store multiple session data in Redis
+  /**
-  // const setMultipleSessionData = async (socketId, keyValues) => {
+   * Get provider cache data
-  //   try {
+   * @param ns
-  //     // keyValues is expected to be an object { key1: value1, key2: value2, ... }
+   * @param field
-  //     const entries = Object.entries(keyValues).map(([key, value]) => [key, JSON.stringify(value)]);
+   * @returns {Promise<any|null|undefined>}
-  //     await pubClient.hset(`socket:${socketId}`, ...entries.flat());
+   */
-  //   } catch (error) {
+  const getProviderCache = (ns, field) => getSessionData(`${ns}:provider`, field);
-  //     logger.log(`Error Setting Multiple Session Data for socket ${socketId}: ${error}`, "ERROR", "redis");
-  //   }
-  // };
-
-  // Retrieve multiple session data from Redis
-  // const getMultipleSessionData = async (socketId, keys) => {
-  //   try {
-  //     const data = await pubClient.hmget(`socket:${socketId}`, keys);
-  //     // Redis returns an object with null values for missing keys, so we parse the non-null ones
-  //     return Object.fromEntries(keys.map((key, index) => [key, data[index] ? JSON.parse(data[index]) : null]));
-  //   } catch (error) {
-  //     logger.log(`Error Getting Multiple Session Data for socket ${socketId}: ${error}`, "ERROR", "redis");
-  //   }
-  // };
-
-  // const setMultipleFromArraySessionData = async (socketId, keyValueArray) => {
-  //   try {
-  //     // Use Redis multi/pipeline to batch the commands
-  //     const multi = pubClient.multi();
-  //     keyValueArray.forEach(([key, value]) => {
-  //       multi.hset(`socket:${socketId}`, key, JSON.stringify(value));
-  //     });
-  //     await multi.exec(); // Execute all queued commands
-  //   } catch (error) {
-  //     logger.log(`Error Setting Multiple Session Data for socket ${socketId}: ${error}`, "ERROR", "redis");
-  //   }
-  // };
-
-  // Helper function to add an item to the end of the Redis list
-  // const addItemToEndOfList = async (socketId, key, newItem) => {
-  //   try {
-  //     await pubClient.rpush(`socket:${socketId}:${key}`, JSON.stringify(newItem));
-  //   } catch (error) {
-  //     let userEmail = "unknown";
-  //     let socketMappings = {};
-  //     try {
-  //       const userData = await getSessionData(socketId, "user");
-  //       if (userData && userData.email) {
-  //         userEmail = userData.email;
-  //         socketMappings = await getUserSocketMapping(userEmail);
-  //       }
-  //     } catch (sessionError) {
-  //       logger.log(`Failed to fetch session data for socket ${socketId}: ${sessionError}`, "ERROR", "redis");
-  //     }
-  //     const mappingString = JSON.stringify(socketMappings, null, 2);
-  //     const errorMessage = `Error adding item to the end of the list for socket ${socketId}: ${error}. User: ${userEmail}, Socket Mappings: ${mappingString}`;
-  //     logger.log(errorMessage, "ERROR", "redis");
-  //   }
-  // };
-
-  // Helper function to add an item to the beginning of the Redis list
-  // const addItemToBeginningOfList = async (socketId, key, newItem) => {
-  //   try {
-  //     await pubClient.lpush(`socket:${socketId}:${key}`, JSON.stringify(newItem));
-  //   } catch (error) {
-  //     logger.log(`Error adding item to the beginning of the list for socket ${socketId}: ${error}`, "ERROR", "redis");
-  //   }
-  // };
-
-  // Helper function to clear a list in Redis
-  // const clearList = async (socketId, key) => {
-  //   try {
-  //     await pubClient.del(`socket:${socketId}:${key}`);
-  //   } catch (error) {
-  //     logger.log(`Error clearing list for socket ${socketId}: ${error}`, "ERROR", "redis");
-  //   }
-  // };
-
-  // Add methods to manage room users
-  // const addUserToRoom = async (room, user) => {
-  //   try {
-  //     await pubClient.sadd(room, JSON.stringify(user));
-  //   } catch (error) {
-  //     logger.log(`Error adding user to room ${room}: ${error}`, "ERROR", "redis");
-  //   }
-  // };
-
-  // Remove users from room
-  // const removeUserFromRoom = async (room, user) => {
-  //   try {
-  //     await pubClient.srem(room, JSON.stringify(user));
-  //   } catch (error) {
-  //     logger.log(`Error removing user to room ${room}: ${error}`, "ERROR", "redis");
-  //   }
-  // };
-
-  // Get Users in room
-  // const getUsersInRoom = async (room) => {
-  //   try {
-  //     const users = await pubClient.smembers(room);
-  //     return users.map((user) => JSON.parse(user));
-  //   } catch (error) {
-  //     logger.log(`Error getting users in room ${room}: ${error}`, "ERROR", "redis");
-  //   }
-  // };
 
   const api = {
     getUserSocketMappingKey,
@@ -394,16 +385,12 @@ const applyRedisHelpers = ({ pubClient, app, logger }) => {
     getUserSocketMapping,
     refreshUserSocketTTL,
     getBodyshopFromRedis,
-    updateOrInvalidateBodyshopFromRedis
+    updateOrInvalidateBodyshopFromRedis,
-    // setMultipleSessionData,
+    setSessionTransactionData,
-    // getMultipleSessionData,
+    getSessionTransactionData,
-    // setMultipleFromArraySessionData,
+    clearSessionTransactionData,
-    // addItemToEndOfList,
+    setProviderCache,
-    // addItemToBeginningOfList,
+    getProviderCache
-    // clearList,
-    // addUserToRoom,
-    // removeUserFromRoom,
-    // getUsersInRoom,
   };
 
   Object.assign(module.exports, api);

server/web-sockets/createLogEvent.js

@@ -0,0 +1,116 @@
+const { isArray } = require("lodash");
+const logger = require("../utils/logger");
+
+
+function createLogEvent(socket, level, message) {
+    if (LogLevelHierarchy(socket.log_level) >= LogLevelHierarchy(level)) {
+        // console.log(`[WS LOG EVENT] ${level} - ${new Date()} - ${socket.user.email} - ${socket.id} - ${message}`);
+        socket.emit("log-event", {
+            timestamp: new Date(),
+            level,
+            message
+        });
+
+        logger.log("ws-log-event", level, socket.user.email, socket.recordid, {
+            wsmessage: message
+        });
+
+        if (socket.logEvents && isArray(socket.logEvents)) {
+            socket.logEvents.push({
+                timestamp: new Date(),
+                level,
+                message
+            });
+        }
+        // if (level === "ERROR") {
+        //   throw new Error(message);
+        // }
+    }
+}
+
+function createJsonEvent(socket, level, message, json) {
+    if (LogLevelHierarchy(socket.log_level) >= LogLevelHierarchy(level)) {
+        //console.log(`[WS LOG EVENT] ${level} - ${new Date()} - ${socket.user.email} - ${socket.id} - ${message}`);
+        socket.emit("log-event", {
+            timestamp: new Date(),
+            level,
+            message
+        }); 
+    }
+    logger.log(
+        "ws-log-event-json",
+        level,
+        socket.user.email,
+        socket.recordid,
+        {
+            wsmessage: message,
+            json
+        },
+        true
+    );
+
+    if (socket.logEvents && isArray(socket.logEvents)) {
+        socket.logEvents.push({
+            timestamp: new Date(),
+            level,
+            message
+        });
+    }
+    // if (level === "ERROR") {
+    //   throw new Error(message);
+    // }
+}
+
+function createXmlEvent(socket, xml, message, isError = false) {
+    if (LogLevelHierarchy(socket.log_level) >= LogLevelHierarchy("SILLY")) {
+        socket.emit("log-event", {
+            timestamp: new Date(),
+            level: isError ? "ERROR" : "SILLY",
+            message: `${message}: ${xml}`
+        });
+    }
+
+    logger.log(
+        isError ? "ws-log-event-xml-error" : "ws-log-event-xml",
+        isError ? "ERROR" : "SILLY",
+        socket.user.email,
+        socket.recordid,
+        {
+            wsmessage: message,
+            xml
+        },
+        true
+    );
+
+    if (socket.logEvents && isArray(socket.logEvents)) {
+        socket.logEvents.push({
+            timestamp: new Date(),
+            level: isError ? "ERROR" : "SILLY",
+            message,
+            xml
+        });
+    }
+}
+
+function LogLevelHierarchy(level) {
+    switch (level) {
+        case "XML":
+            return 5;
+        case "SILLY":
+            return 5;
+        case "DEBUG":
+            return 4;
+        case "INFO":
+            return 3;
+        case "WARN":
+            return 2;
+        case "ERROR":
+            return 1;
+        default:
+            return 3;
+    }
+}
+
+exports.createLogEvent = createLogEvent;
+exports.createXmlEvent = createXmlEvent;
+exports.createJsonEvent = createJsonEvent;

server/web-sockets/redisSocketEvents.js

@@ -1,11 +1,25 @@
 const { admin } = require("../firebase/firebase-handler");
+const FortellisLogger = require("../fortellis/fortellis-logger");
+const { FortellisJobExport, FortellisSelectedCustomer } = require("../fortellis/fortellis");
+const CdkCalculateAllocations = require("../cdk/cdk-calculate-allocations").default;
+const registerRREvents = require("../rr/rr-register-socket-events");
+
+const redisSocketEvents = ({ io, redisHelpers, ioHelpers, logger }) => {
+  // Destructure helpers locally, but keep full objects available for downstream modules
+  const {
+    setSessionData,
+    getSessionData,
+    addUserSocketMapping,
+    removeUserSocketMapping,
+    refreshUserSocketTTL,
+    getUserSocketMappingByBodyshop,
+    setSessionTransactionData,
+    getSessionTransactionData,
+    clearSessionTransactionData
+  } = redisHelpers;
+
+  const { getBodyshopRoom, getBodyshopConversationRoom } = ioHelpers;
 
-const redisSocketEvents = ({
-  io,
-  redisHelpers: { addUserSocketMapping, removeUserSocketMapping, refreshUserSocketTTL, getUserSocketMappingByBodyshop },
-  ioHelpers: { getBodyshopRoom, getBodyshopConversationRoom },
-  logger
-}) => {
   // Logging helper functions
   const createLogEvent = (socket, level, message) => {
     logger.log("ioredis-log-event", level, socket?.user?.email, null, { wsmessage: message });
@@ -27,6 +41,23 @@ const redisSocketEvents = ({
       const user = await admin.auth().verifyIdToken(token);
       socket.user = user;
       socket.bodyshopId = bodyshopId;
+      socket.data = socket.data || {};
+      socket.data.authToken = token;
+
+      // Used to update legacy sockets
+      if (socket.handshake?.auth) {
+        socket.handshake.auth.token = token;
+        socket.handshake.auth.bodyshopId = bodyshopId;
+      }
+
+      // NEW: seed a base session for this socket so downstream handlers can read it
+      await setSessionData(socket.id, {
+        bodyshopId,
+        email: user.email,
+        uid: user.user_id || user.uid,
+        seededAt: Date.now()
+      });
+
       await addUserSocketMapping(user.email, socket.id, bodyshopId);
       next();
     } catch (error) {
@@ -36,6 +67,34 @@ const redisSocketEvents = ({
 
   // Register Socket Events
   const registerSocketEvents = (socket) => {
+    // DMS reset events (clear per-socket DMS transactional cache)
+    const registerDmsResetEvents = (socket) => {
+      socket.on("dms-reset-context", async ({ jobId, mode } = {}, ack) => {
+        try {
+          // This clears all transactional session data for this socket
+          // (RR txEnvelope/JobData/SelectedCustomer/PendingRO/etc, Fortellis, etc.)
+          await clearSessionTransactionData(socket.id);
+
+          createLogEvent(
+            socket,
+            "debug",
+            `DMS reset-context: cleared transactional session data` +
+              (jobId ? ` (jobId=${jobId})` : "") +
+              (mode ? ` (mode=${mode})` : "")
+          );
+
+          if (typeof ack === "function") {
+            ack({ ok: true });
+          }
+        } catch (error) {
+          createLogEvent(socket, "error", `DMS reset-context failed: ${error.message}`);
+          if (typeof ack === "function") {
+            ack({ ok: false, error: error.message });
+          }
+        }
+      });
+    };
+
     // Token Update Events
     const registerUpdateEvents = (socket) => {
       let latestTokenTimestamp = 0;
@@ -50,13 +109,30 @@ const redisSocketEvents = ({
         }
 
         try {
-          const user = await admin.auth().verifyIdToken(token, true);
+          const user = await admin.auth().verifyIdToken(token);
           if (currentTimestamp < latestTokenTimestamp) {
             createLogEvent(socket, "warn", "Outdated token validation skipped.");
             return;
           }
           socket.user = user;
           socket.bodyshopId = bodyshopId;
+          // 🔑 keep the live token in a mutable place used by downstream code
+          socket.data = socket.data || {};
+          socket.data.authToken = token;
+          //  also keep handshake in sync for any legacy reads
+          if (socket.handshake?.auth) {
+            socket.handshake.auth.token = token;
+            socket.handshake.auth.bodyshopId = bodyshopId;
+          }
+
+          // NEW: refresh (or create) the base session with the latest info
+          await setSessionData(socket.id, {
+            bodyshopId,
+            email: user.email,
+            uid: user.user_id || user.uid,
+            refreshedAt: Date.now()
+          });
+
           await refreshUserSocketTTL(user.email, bodyshopId);
           socket.emit("token-updated", { success: true });
         } catch (error) {
@@ -113,6 +189,12 @@ const redisSocketEvents = ({
         if (socket.user?.email) {
           await removeUserSocketMapping(socket.user.email, socket.id);
         }
+        // Optional: clear transactional session
+        try {
+          await clearSessionTransactionData(socket.id);
+        } catch {
+          //
+        }
         // Leave all rooms except the default room (socket.id)
         const rooms = Array.from(socket.rooms).filter((room) => room !== socket.id);
         for (const room of rooms) {
@@ -217,6 +299,78 @@ const redisSocketEvents = ({
       });
     };
 
+    // Fortellis/CDK Handlers
+    const registerFortellisEvents = (socket) => {
+      socket.on("fortellis-export-job", async ({ jobid, txEnvelope }) => {
+        try {
+          await FortellisJobExport({
+            socket,
+            redisHelpers: {
+              setSessionData,
+              getSessionData,
+              addUserSocketMapping,
+              removeUserSocketMapping,
+              refreshUserSocketTTL,
+              getUserSocketMappingByBodyshop,
+              setSessionTransactionData,
+              getSessionTransactionData,
+              clearSessionTransactionData
+            },
+            ioHelpers: { getBodyshopRoom, getBodyshopConversationRoom },
+            jobid,
+            txEnvelope
+          });
+        } catch (error) {
+          FortellisLogger(socket, "error", `Error during Fortellis export : ${error.message}`);
+          logger.log("fortellis-job-export-error", "error", socket.user?.email, jobid, {
+            message: error.message,
+            stack: error.stack
+          });
+        }
+      });
+
+      socket.on("fortellis-selected-customer", async ({ jobid, selectedCustomerId }) => {
+        try {
+          await FortellisSelectedCustomer({
+            socket,
+            redisHelpers: {
+              setSessionData,
+              getSessionData,
+              addUserSocketMapping,
+              removeUserSocketMapping,
+              refreshUserSocketTTL,
+              getUserSocketMappingByBodyshop,
+              setSessionTransactionData,
+              getSessionTransactionData,
+              clearSessionTransactionData
+            },
+            ioHelpers: { getBodyshopRoom, getBodyshopConversationRoom },
+            jobid,
+            selectedCustomerId
+          });
+        } catch (error) {
+          FortellisLogger(socket, "error", `Error during Fortellis export : ${error.message}`);
+          logger.log("fortellis-selectd-customer-error", "error", socket.user?.email, jobid, {
+            message: error.message,
+            stack: error.stack
+          });
+        }
+      });
+
+      socket.on("fortellis-calculate-allocations", async (jobid, callback) => {
+        try {
+          const allocations = await CdkCalculateAllocations(socket, jobid);
+          callback(allocations);
+        } catch (error) {
+          FortellisLogger(socket, "error", `Error during Fortellis export : ${error.message}`);
+          logger.log("fortellis-selectd-customer-error", "error", socket.user?.email, jobid, {
+            message: error.message,
+            stack: error.stack
+          });
+        }
+      });
+    };
+
     // Task Events
     const registerTaskEvents = (socket) => {
       socket.on("task-created", (payload) => {
@@ -232,19 +386,27 @@ const redisSocketEvents = ({
       });
 
       socket.on("task-deleted", (payload) => {
-        if (!payload || !payload.id) return;
+        if (!payload?.id) return;
         const room = getBodyshopRoom(socket.bodyshopId);
         io.to(room).emit("bodyshop-message", { type: "task-deleted", payload });
       });
     };
 
     // Call Handlers
+    registerDmsResetEvents(socket);
     registerRoomAndBroadcastEvents(socket);
     registerUpdateEvents(socket);
     registerMessagingEvents(socket);
     registerDisconnectEvents(socket);
     registerSyncEvents(socket);
     registerTaskEvents(socket);
+    registerFortellisEvents(socket);
+
+    // Reynolds & Reynolds socket handlers
+    registerRREvents({
+      socket,
+      redisHelpers
+    });
   };
 
   // Associate Middleware and Handlers

server/web-sockets/web-socket.js

@@ -1,231 +1,148 @@
-const path = require("path");
-
-const { io } = require("../../server");
 const { admin } = require("../firebase/firebase-handler");
 const { default: CdkJobExport, CdkSelectedCustomer } = require("../cdk/cdk-job-export");
 const CdkGetMakes = require("../cdk/cdk-get-makes").default;
 const CdkCalculateAllocations = require("../cdk/cdk-calculate-allocations").default;
-const { isArray } = require("lodash");
 const logger = require("../utils/logger");
 const { default: PbsExportJob, PbsSelectedCustomer } = require("../accounting/pbs/pbs-job-export");
 
 const { PbsCalculateAllocationsAp, PbsExportAp } = require("../accounting/pbs/pbs-ap-allocations");
+const { createLogEvent } = require("./createLogEvent");
 
-io.use(function (socket, next) {
+function SetLegacyWebsocketHandlers(io) {
-  try {
+  io.use(function (socket, next) {
-    if (socket.handshake.auth.token) {
-      admin
-        .auth()
-        .verifyIdToken(socket.handshake.auth.token)
-        .then((user) => {
-          socket.user = user;
-          next();
-        })
-        .catch((error) => {
-          next(new Error("Authentication error", JSON.stringify(error)));
-        });
-    } else {
-      next(new Error("Authentication error - no authorization token."));
-    }
-  } catch (error) {
-    //console.log("Uncaught connection error:::", error);
-    logger.log("websocket-connection-error", "error", null, null, {
-      token: socket.handshake.auth.token,
-      ...error
-    });
-    next(new Error(`Authentication error ${error}`));
-  }
-});
-
-io.on("connection", (socket) => {
-  socket.log_level = "DEBUG";
-  createLogEvent(socket, "DEBUG", `Connected and Authenticated.`);
-
-  socket.on("set-log-level", (level) => {
-    socket.log_level = level;
-    socket.emit("log-event", {
-      timestamp: new Date(),
-      level: "INFO",
-      message: `Updated log level to ${level}`
-    });
-  });
-
-  ///CDK
-  socket.on("cdk-export-job", (jobid) => {
-    CdkJobExport(socket, jobid);
-  });
-  socket.on("cdk-selected-customer", (selectedCustomerId) => {
-    createLogEvent(socket, "DEBUG", `User selected customer ID  ${selectedCustomerId}`);
-    socket.selectedCustomerId = selectedCustomerId;
-    CdkSelectedCustomer(socket, selectedCustomerId);
-  });
-
-  socket.on("cdk-get-makes", async (cdk_dealerid, callback) => {
     try {
-      const makes = await CdkGetMakes(socket, cdk_dealerid);
+      if (socket.handshake.auth.token) {
-      callback(makes);
+        admin
+          .auth()
+          .verifyIdToken(socket.handshake.auth.token)
+          .then((user) => {
+            socket.user = user;
+            next();
+          })
+          .catch((error) => {
+            next(new Error("Authentication error", JSON.stringify(error)));
+          });
+      } else {
+        next(new Error("Authentication error - no authorization token."));
+      }
     } catch (error) {
-      createLogEvent(socket, "ERROR", `Error in cdk-get-makes WS call. ${JSON.stringify(error, null, 2)}`);
+      //console.log("Uncaught connection error:::", error);
-    }
+      logger.log("websocket-connection-error", "error", null, null, {
-  });
+        token: socket.handshake.auth.token,
-
+        ...error
-  socket.on("cdk-calculate-allocations", async (jobid, callback) => {
-    const allocations = await CdkCalculateAllocations(socket, jobid);
-    createLogEvent(socket, "DEBUG", `Allocations calculated.`);
-    createLogEvent(socket, "SILLY", `Allocations calculated. ${JSON.stringify(allocations, null, 2)}`);
-
-    callback(allocations);
-  });
-  //END CDK
-
-  //PBS AR
-  socket.on("pbs-calculate-allocations", async (jobid, callback) => {
-    const allocations = await CdkCalculateAllocations(socket, jobid);
-    createLogEvent(socket, "DEBUG", `Allocations calculated.`);
-    createLogEvent(socket, "SILLY", `Allocations calculated. ${JSON.stringify(allocations, null, 2)}`);
-
-    callback(allocations);
-  });
-  socket.on("pbs-export-job", (jobid) => {
-    PbsExportJob(socket, jobid);
-  });
-  socket.on("pbs-selected-customer", (selectedCustomerId) => {
-    createLogEvent(socket, "DEBUG", `User selected customer ID  ${selectedCustomerId}`);
-    socket.selectedCustomerId = selectedCustomerId;
-    PbsSelectedCustomer(socket, selectedCustomerId);
-  });
-  //End PBS AR
-
-  //PBS AP
-  socket.on("pbs-calculate-allocations-ap", async (billids, callback) => {
-    const allocations = await PbsCalculateAllocationsAp(socket, billids);
-    createLogEvent(socket, "DEBUG", `AP Allocations calculated.`);
-    createLogEvent(socket, "DEBUG", `Allocations calculated. ${JSON.stringify(allocations, null, 2)}`);
-    socket.apAllocations = allocations;
-    callback(allocations);
-  });
-
-  socket.on("pbs-export-ap", ({ billids, txEnvelope }) => {
-    socket.txEnvelope = txEnvelope;
-    PbsExportAp(socket, { billids, txEnvelope });
-  });
-
-  //END PBS AP
-
-  socket.on("disconnect", () => {
-    createLogEvent(socket, "DEBUG", `User disconnected.`);
-  });
-});
-
-function createLogEvent(socket, level, message) {
-  if (LogLevelHierarchy(socket.log_level) >= LogLevelHierarchy(level)) {
-    // console.log(`[WS LOG EVENT] ${level} - ${new Date()} - ${socket.user.email} - ${socket.id} - ${message}`);
-    socket.emit("log-event", {
-      timestamp: new Date(),
-      level,
-      message
-    });
-
-    logger.log("ws-log-event", level, socket.user.email, socket.recordid, {
-      wsmessage: message
-    });
-
-    if (socket.logEvents && isArray(socket.logEvents)) {
-      socket.logEvents.push({
-        timestamp: new Date(),
-        level,
-        message
       });
+      next(new Error(`Authentication error ${error}`));
     }
-    // if (level === "ERROR") {
+  });
-    //   throw new Error(message);
+
-    // }
+  io.on("connection", (socket) => {
-  }
+    socket.log_level = "DEBUG";
+    createLogEvent(socket, "DEBUG", `Connected and Authenticated.`);
+
+    socket.on("set-log-level", (level) => {
+      socket.log_level = level;
+      socket.emit("log-event", {
+        timestamp: new Date(),
+        level: "INFO",
+        message: `Updated log level to ${level}`
+      });
+    });
+
+    ///CDK
+    socket.on("cdk-export-job", (jobid) => {
+      CdkJobExport(socket, jobid);
+    });
+
+    socket.on("cdk-selected-customer", (selectedCustomerId) => {
+      createLogEvent(socket, "DEBUG", `User selected customer ID  ${selectedCustomerId}`);
+      socket.selectedCustomerId = selectedCustomerId;
+      CdkSelectedCustomer(socket, selectedCustomerId);
+    });
+
+    socket.on("cdk-get-makes", async (cdk_dealerid, callback) => {
+      try {
+        const makes = await CdkGetMakes(socket, cdk_dealerid);
+        callback(makes);
+      } catch (error) {
+        createLogEvent(socket, "ERROR", `Error in cdk-get-makes WS call. ${JSON.stringify(error, null, 2)}`);
+      }
+    });
+
+    socket.on("cdk-calculate-allocations", async (jobid, callback) => {
+      console.log("cdk-calculate-allocations called", typeof CdkCalculateAllocations);
+      const allocations = await CdkCalculateAllocations(socket, jobid);
+      createLogEvent(socket, "DEBUG", `Allocations calculated.`);
+      createLogEvent(socket, "SILLY", `Allocations calculated. ${JSON.stringify(allocations, null, 2)}`);
+
+      callback(allocations);
+    });
+    //END CDK
+
+    //PBS AR
+    socket.on("pbs-calculate-allocations", async (jobid, callback) => {
+      const allocations = await CdkCalculateAllocations(socket, jobid);
+      createLogEvent(socket, "DEBUG", `Allocations calculated.`);
+      createLogEvent(socket, "SILLY", `Allocations calculated. ${JSON.stringify(allocations, null, 2)}`);
+
+      callback(allocations);
+    });
+    socket.on("pbs-export-job", (jobid) => {
+      PbsExportJob(socket, jobid);
+    });
+    socket.on("pbs-selected-customer", (selectedCustomerId) => {
+      createLogEvent(socket, "DEBUG", `User selected customer ID  ${selectedCustomerId}`);
+      socket.selectedCustomerId = selectedCustomerId;
+      PbsSelectedCustomer(socket, selectedCustomerId);
+    });
+    //End PBS AR
+
+    //PBS AP
+    socket.on("pbs-calculate-allocations-ap", async (billids, callback) => {
+      const allocations = await PbsCalculateAllocationsAp(socket, billids);
+      createLogEvent(socket, "DEBUG", `AP Allocations calculated.`);
+      createLogEvent(socket, "DEBUG", `Allocations calculated. ${JSON.stringify(allocations, null, 2)}`);
+      socket.apAllocations = allocations;
+      callback(allocations);
+    });
+
+    socket.on("pbs-export-ap", ({ billids, txEnvelope }) => {
+      socket.txEnvelope = txEnvelope;
+      PbsExportAp(socket, { billids, txEnvelope });
+    });
+
+    //END PBS AP
+
+    socket.on("disconnect", () => {
+      createLogEvent(socket, "DEBUG", `User disconnected.`);
+    });
+
+    // DMS reset for legacy WS (CDK / PBS)
+    socket.on("dms-reset-context", ({ jobId, mode } = {}, ack) => {
+      try {
+        // Clear any per-socket DMS state that can leak across jobs
+        socket.selectedCustomerId = null; // CDK / PBS AR
+        socket.txEnvelope = null; // PBS AP export
+        socket.apAllocations = null; // PBS AP allocations
+
+        createLogEvent(
+          socket,
+          "DEBUG",
+          `DMS reset-context (legacy WS): cleared per-socket state` +
+            (jobId ? ` (jobId=${jobId})` : "") +
+            (mode ? ` (mode=${mode})` : "")
+        );
+
+        if (typeof ack === "function") {
+          ack({ ok: true });
+        }
+      } catch (error) {
+        createLogEvent(socket, "ERROR", `DMS reset-context (legacy WS) failed: ${error.message}`);
+        if (typeof ack === "function") {
+          ack({ ok: false, error: error.message });
+        }
+      }
+    });
+  });
 }
 
-function createJsonEvent(socket, level, message, json) {
+exports.SetLegacyWebsocketHandlers = SetLegacyWebsocketHandlers;
-  if (LogLevelHierarchy(socket.log_level) >= LogLevelHierarchy(level)) {
-    //console.log(`[WS LOG EVENT] ${level} - ${new Date()} - ${socket.user.email} - ${socket.id} - ${message}`);
-    socket.emit("log-event", {
-      timestamp: new Date(),
-      level,
-      message
-    });
-  }
-  logger.log(
-    "ws-log-event-json",
-    level,
-    socket.user.email,
-    socket.recordid,
-    {
-      wsmessage: message,
-      json
-    },
-    true
-  );
-
-  if (socket.logEvents && isArray(socket.logEvents)) {
-    socket.logEvents.push({
-      timestamp: new Date(),
-      level,
-      message
-    });
-  }
-  // if (level === "ERROR") {
-  //   throw new Error(message);
-  // }
-}
-
-function createXmlEvent(socket, xml, message, isError = false) {
-  if (LogLevelHierarchy(socket.log_level) >= LogLevelHierarchy("SILLY")) {
-    socket.emit("log-event", {
-      timestamp: new Date(),
-      level: isError ? "ERROR" : "SILLY",
-      message: `${message}: ${xml}`
-    });
-  }
-
-  logger.log(
-    isError ? "ws-log-event-xml-error" : "ws-log-event-xml",
-    isError ? "ERROR" : "SILLY",
-    socket.user.email,
-    socket.recordid,
-    {
-      wsmessage: message,
-      xml
-    },
-    true
-  );
-
-  if (socket.logEvents && isArray(socket.logEvents)) {
-    socket.logEvents.push({
-      timestamp: new Date(),
-      level: isError ? "ERROR" : "SILLY",
-      message,
-      xml
-    });
-  }
-}
-
-function LogLevelHierarchy(level) {
-  switch (level) {
-    case "XML":
-      return 5;
-    case "SILLY":
-      return 5;
-    case "DEBUG":
-      return 4;
-    case "INFO":
-      return 3;
-    case "WARN":
-      return 2;
-    case "ERROR":
-      return 1;
-    default:
-      return 3;
-  }
-}
-
-exports.createLogEvent = createLogEvent;
-exports.createXmlEvent = createXmlEvent;
-exports.createJsonEvent = createJsonEvent;