feature/IO-3255-simplified-parts-management - Refactor / Working Change Request

server/integrations/partsManagement/endpoints/partsManagementProvisioning.js

@@ -0,0 +1,188 @@
+const admin = require("firebase-admin");
+const client = require("../../../graphql-client/graphql-client").client;
+const DefaultNewShop = require("../defaultNewShop.json");
+
+const {
+  CHECK_EXTERNAL_SHOP_ID,
+  CREATE_SHOP,
+  DELETE_VENDORS_BY_SHOP,
+  DELETE_SHOP,
+  CREATE_USER
+} = require("../partsManagement.queries");
+
+const requireFields = (payload, fields) => {
+  for (const field of fields) {
+    if (!payload[field]) {
+      throw { status: 400, message: `${field} is required.` };
+    }
+  }
+};
+
+const ensureEmailNotRegistered = async (email) => {
+  try {
+    await admin.auth().getUserByEmail(email);
+    throw { status: 400, message: "userEmail is already registered in Firebase." };
+  } catch (err) {
+    if (err.code !== "auth/user-not-found") {
+      throw { status: 500, message: "Error validating userEmail uniqueness", detail: err };
+    }
+  }
+};
+
+const createFirebaseUser = async (email, password = null) => {
+  const userData = { email };
+  if (password) userData.password = password;
+  return admin.auth().createUser(userData);
+};
+
+const deleteFirebaseUser = async (uid) => {
+  return admin.auth().deleteUser(uid);
+};
+
+const generateResetLink = async (email) => {
+  return admin.auth().generatePasswordResetLink(email);
+};
+
+const ensureExternalIdUnique = async (externalId) => {
+  const resp = await client.request(CHECK_EXTERNAL_SHOP_ID, { key: externalId });
+  if (resp.bodyshops.length) {
+    throw { status: 400, message: `external_shop_id '${externalId}' is already in use.` };
+  }
+};
+
+const insertBodyshop = async (input) => {
+  const resp = await client.request(CREATE_SHOP, { bs: input });
+  return resp.insert_bodyshops_one.id;
+};
+
+const deleteVendorsByShop = async (shopId) => {
+  await client.request(DELETE_VENDORS_BY_SHOP, { shopId });
+};
+
+const deleteBodyshop = async (shopId) => {
+  await client.request(DELETE_SHOP, { id: shopId });
+};
+
+const insertUserAssociation = async (uid, email, shopId) => {
+  const vars = {
+    u: {
+      email,
+      authid: uid,
+      validemail: true,
+      associations: {
+        data: [{ shopid: shopId, authlevel: 80, active: true }]
+      }
+    }
+  };
+  const resp = await client.request(CREATE_USER, vars);
+  return resp.insert_users_one;
+};
+
+const partsManagementProvisioning = async (req, res) => {
+  const { logger } = req;
+  const p = { ...req.body, userEmail: req.body.userEmail?.toLowerCase() };
+
+  try {
+    await ensureEmailNotRegistered(p.userEmail);
+    requireFields(p, [
+      "external_shop_id",
+      "shopname",
+      "address1",
+      "city",
+      "state",
+      "zip_post",
+      "country",
+      "email",
+      "phone",
+      "userEmail"
+    ]);
+    await ensureExternalIdUnique(p.external_shop_id);
+
+    logger.log("admin-create-shop-user", "debug", p.userEmail, null, {
+      request: req.body,
+      ioadmin: true
+    });
+
+    const shopInput = {
+      shopname: p.shopname,
+      address1: p.address1,
+      address2: p.address2 || null,
+      city: p.city,
+      state: p.state,
+      zip_post: p.zip_post,
+      country: p.country,
+      email: p.email,
+      external_shop_id: p.external_shop_id,
+      timezone: p.timezone,
+      phone: p.phone,
+      logo_img_path: {
+        src: p.logoUrl,
+        width: "",
+        height: "",
+        headerMargin: DefaultNewShop.logo_img_path.headerMargin
+      },
+      features: {
+        partsManagementOnly: true
+      },
+      md_ro_statuses: DefaultNewShop.md_ro_statuses,
+      vendors: {
+        data: p.vendors.map((v) => ({
+          name: v.name,
+          street1: v.street1 || null,
+          street2: v.street2 || null,
+          city: v.city || null,
+          state: v.state || null,
+          zip: v.zip || null,
+          country: v.country || null,
+          email: v.email || null,
+          discount: v.discount ?? 0,
+          due_date: v.due_date ?? null,
+          cost_center: v.cost_center || null,
+          favorite: v.favorite ?? [],
+          phone: v.phone || null,
+          active: v.active ?? true,
+          dmsid: v.dmsid || null
+        }))
+      }
+    };
+
+    const newShopId = await insertBodyshop(shopInput);
+    const userRecord = await createFirebaseUser(p.userEmail, p.userPassword);
+    let resetLink = null;
+    if (!p.userPassword) resetLink = await generateResetLink(p.userEmail);
+
+    const createdUser = await insertUserAssociation(userRecord.uid, p.userEmail, newShopId);
+
+    return res.status(200).json({
+      shop: { id: newShopId, shopname: p.shopname },
+      user: {
+        id: createdUser.id,
+        email: createdUser.email,
+        resetLink: resetLink || undefined
+      }
+    });
+  } catch (err) {
+    logger.log("admin-create-shop-user-error", "error", p.userEmail, null, {
+      message: err.message,
+      detail: err.detail || err
+    });
+
+    if (err.userRecord) {
+      await deleteFirebaseUser(err.userRecord.uid).catch(() => {
+        /* empty */
+      });
+    }
+    if (err.newShopId) {
+      await deleteVendorsByShop(err.newShopId).catch(() => {
+        /* empty */
+      });
+      await deleteBodyshop(err.newShopId).catch(() => {
+        /* empty */
+      });
+    }
+
+    return res.status(err.status || 500).json({ error: err.message || "Internal server error" });
+  }
+};
+
+module.exports = partsManagementProvisioning;

server/integrations/partsManagement/endpoints/vehicleDamageEstimateAddRq.js

@@ -0,0 +1,571 @@
+// no-dd-sa:javascript-code-style/assignment-name
+// CamelCase is used for GraphQL and database fields.
+
+const client = require("../../../graphql-client/graphql-client").client;
+const { parseXml, normalizeXmlObject } = require("../partsManagementUtils");
+
+// GraphQL Queries and Mutations
+const {
+  GET_BODYSHOP_STATUS,
+  GET_VEHICLE_BY_SHOP_VIN,
+  INSERT_OWNER,
+  INSERT_JOB_WITH_LINES
+} = require("../partsManagement.queries");
+
+// Defaults
+const FALLBACK_DEFAULT_ORDER_STATUS = "OPEN";
+
+// Known part rate types for tax rates
+const KNOWN_PART_RATE_TYPES = [
+  "PAA",
+  "PAC",
+  "PAG",
+  "PAL",
+  "PAM",
+  "PAN",
+  "PAO",
+  "PAP",
+  "PAR",
+  "PAS",
+  "PASL",
+  "CCC",
+  "CCD",
+  "CCF",
+  "CCM",
+  "CCDR"
+];
+/**
+ * Fetches the default order status for a bodyshop.
+ * @param {string} shopId - The bodyshop UUID.
+ * @param {object} logger - The logger instance.
+ * @returns {Promise<string>} The default status or fallback.
+ */
+const getDefaultOrderStatus = async (shopId, logger) => {
+  try {
+    const { bodyshop_by_pk } = await client.request(GET_BODYSHOP_STATUS, { id: shopId });
+    return bodyshop_by_pk?.md_order_statuses?.default_open || FALLBACK_DEFAULT_ORDER_STATUS;
+  } catch (err) {
+    logger.log("parts-bodyshop-fetch-failed", "warn", shopId, null, { error: err });
+    return FALLBACK_DEFAULT_ORDER_STATUS;
+  }
+};
+
+/**
+ * Extracts and processes parts tax rates from profile info.
+ * @param {object} profile - The ProfileInfo object from XML.
+ * @returns {object} The parts tax rates object.
+ */
+const extractPartsTaxRates = (profile = {}) => {
+  const rateInfos = Array.isArray(profile.RateInfo) ? profile.RateInfo : [profile.RateInfo || {}];
+  const partsTaxRates = {};
+
+  for (const code of KNOWN_PART_RATE_TYPES) {
+    const rateInfo = rateInfos.find((r) => {
+      const rateType =
+        typeof r?.RateType === "string"
+          ? r.RateType
+          : typeof r?.RateType === "object" && r?.RateType._ // xml2js sometimes uses _ for text content
+            ? r.RateType._
+            : "";
+
+      return rateType.toUpperCase() === code;
+    });
+
+    if (!rateInfo) {
+      partsTaxRates[code] = {};
+      continue;
+    }
+
+    const taxInfo = rateInfo.TaxInfo;
+    const taxTier = taxInfo?.TaxTierInfo;
+    let percentage = parseFloat(taxTier?.Percentage ?? "NaN");
+
+    if (isNaN(percentage)) {
+      const tierRate = Array.isArray(rateInfo.RateTierInfo)
+        ? rateInfo.RateTierInfo[0]?.Rate
+        : rateInfo.RateTierInfo?.Rate;
+      percentage = parseFloat(tierRate ?? "NaN");
+    }
+
+    partsTaxRates[code] = isNaN(percentage)
+      ? {}
+      : {
+          prt_discp: 0,
+          prt_mktyp: false,
+          prt_mkupp: 0,
+          prt_tax_in: true,
+          prt_tax_rt: percentage / 100
+        };
+  }
+
+  return partsTaxRates;
+};
+/**
+ * Extracts job-related data from the XML request.
+ * @param {object} rq - The VehicleDamageEstimateAddRq object.
+ * @returns {object} Extracted job data.
+ */
+const extractJobData = (rq) => {
+  const doc = rq.DocumentInfo || {};
+  const ev = rq.EventInfo || {};
+  const asgn = ev.AssignmentEvent || {};
+  const ci = rq.ClaimInfo || {};
+
+  return {
+    shopId: rq.ShopID || rq.shopId,
+    refClaimNum: rq.RefClaimNum,
+    ciecaid: rq.RqUID || null,
+    cieca_ttl: parseFloat(rq.Cieca_ttl || 0),
+    cat_no: doc.VendorCode || null,
+    category: doc.DocumentType || null,
+    classType: doc.DocumentStatus || null,
+    comment: doc.Comment || null,
+    date_exported: doc.TransmitDateTime || null,
+    asgn_no: asgn.AssignmentNumber || null,
+    asgn_type: asgn.AssignmentType || null,
+    asgn_date: asgn.AssignmentDate || null,
+    // asgn_created: asgn.CreateDateTime || null,
+    scheduled_in: ev.RepairEvent?.RequestedPickUpDateTime || null,
+    scheduled_completion: ev.RepairEvent?.TargetCompletionDateTime || null,
+    clm_no: ci.ClaimNum || null,
+    status: ci.ClaimStatus || null,
+    policy_no: ci.PolicyInfo?.PolicyNum || null,
+    ded_amt: parseFloat(ci.PolicyInfo?.CoverageInfo?.Coverage?.DeductibleInfo?.DeductibleAmt || 0)
+    // document_id: doc.DocumentID || null,
+    // bms_version: doc.BMSVer || null,
+    // reference_info:
+    //   doc.ReferenceInfo?.OtherReferenceInfo?.map((ref) => ({
+    //     name: ref.OtherReferenceName,
+    //     number: ref.OtherRefNum
+    //   })) || [],
+    // currency_info: doc.CurrencyInfo
+    //   ? {
+    //       code: doc.CurrencyInfo.CurCode,
+    //       base_code: doc.CurrencyInfo.BaseCurCode,
+    //       rate: parseFloat(doc.CurrencyInfo.CurRate || 0),
+    //       rule: doc.CurrencyInfo.CurConvertRule
+    //     }
+    //   : null
+  };
+};
+
+/**
+ * Extracts owner data from the XML request.
+ * @param {object} rq - The VehicleDamageEstimateAddRq object.
+ * @param {string} shopId - The bodyshop UUID.
+ * @returns {object} Owner data for insertion and inline use.
+ */
+/**
+ * Extracts owner data from the XML request.
+ * Falls back to Claimant if Owner is missing.
+ * @param {object} rq - The VehicleDamageEstimateAddRq object.
+ * @param {string} shopId - The bodyshop UUID.
+ * @returns {object} Owner data for insertion and inline use.
+ */
+const extractOwnerData = (rq, shopId) => {
+  const ownerOrClaimant = rq.AdminInfo?.Owner?.Party || rq.AdminInfo?.Claimant?.Party || {};
+  const personInfo = ownerOrClaimant.PersonInfo || {};
+  const personName = personInfo.PersonName || {};
+  const address = personInfo.Communications?.Address || {};
+
+  let ownr_ph1, ownr_ph2, ownr_ea, ownr_alt_ph;
+
+  const comms = Array.isArray(ownerOrClaimant.ContactInfo?.Communications)
+    ? ownerOrClaimant.ContactInfo.Communications
+    : [ownerOrClaimant.ContactInfo?.Communications || {}];
+
+  for (const c of comms) {
+    if (c.CommQualifier === "CP") ownr_ph1 = c.CommPhone;
+    if (c.CommQualifier === "WP") ownr_ph2 = c.CommPhone;
+    if (c.CommQualifier === "EM") ownr_ea = c.CommEmail;
+    if (c.CommQualifier === "AL") ownr_alt_ph = c.CommPhone;
+  }
+
+  return {
+    shopid: shopId,
+    ownr_fn: personName.FirstName || null,
+    ownr_ln: personName.LastName || null,
+    ownr_co_nm: ownerOrClaimant.OrgInfo?.CompanyName || null,
+    ownr_addr1: address.Address1 || null,
+    ownr_addr2: address.Address2 || null,
+    ownr_city: address.City || null,
+    ownr_st: address.StateProvince || null,
+    ownr_zip: address.PostalCode || null,
+    ownr_ctry: address.Country || null,
+    ownr_ph1,
+    ownr_ph2,
+    ownr_ea,
+    ownr_alt_ph
+    // ownr_id_qualifier: ownerOrClaimant.IDInfo?.IDQualifierCode || null // New
+    // ownr_id_num: ownerOrClaimant.IDInfo?.IDNum || null, // New
+    // ownr_preferred_contact: ownerOrClaimant.PreferredContactMethod || null // New
+  };
+};
+
+/**
+ * Extracts estimator data from the XML request.
+ * @param {object} rq - The VehicleDamageEstimateAddRq object.
+ * @returns {object} Estimator data.
+ */
+const extractEstimatorData = (rq) => {
+  const estParty = rq.AdminInfo?.Estimator?.Party || {};
+  const estComms = Array.isArray(estParty.ContactInfo?.Communications)
+    ? estParty.ContactInfo.Communications
+    : [estParty.ContactInfo?.Communications || {}];
+
+  return {
+    est_co_nm: rq.AdminInfo?.Estimator?.Affiliation || null,
+    est_ct_fn: estParty.PersonInfo?.PersonName?.FirstName || null,
+    est_ct_ln: estParty.PersonInfo?.PersonName?.LastName || null,
+    est_ea: estComms.find((c) => c.CommQualifier === "EM")?.CommEmail || null
+  };
+};
+
+/**
+ * Extracts adjuster data from the XML request.
+ * @param {object} rq - The VehicleDamageEstimateAddRq object.
+ * @returns {object} Adjuster data.
+ */
+const extractAdjusterData = (rq) => {
+  const adjParty = rq.AdminInfo?.Adjuster?.Party || {};
+  const adjComms = Array.isArray(adjParty.ContactInfo?.Communications)
+    ? adjParty.ContactInfo.Communications
+    : [adjParty.ContactInfo?.Communications || {}];
+
+  return {
+    agt_ct_fn: adjParty.PersonInfo?.PersonName?.FirstName || null,
+    agt_ct_ln: adjParty.PersonInfo?.PersonName?.LastName || null,
+    agt_ct_ph: adjComms.find((c) => c.CommQualifier === "CP")?.CommPhone || null,
+    agt_ea: adjComms.find((c) => c.CommQualifier === "EM")?.CommEmail || null
+  };
+};
+
+/**
+ * Extracts repair facility data from the XML request.
+ * @param {object} rq - The VehicleDamageEstimateAddRq object.
+ * @returns {object} Repair facility data.
+ */
+const extractRepairFacilityData = (rq) => {
+  const rfParty = rq.AdminInfo?.RepairFacility?.Party || {};
+  const rfComms = Array.isArray(rfParty.ContactInfo?.Communications)
+    ? rfParty.ContactInfo.Communications
+    : [rfParty.ContactInfo?.Communications || {}];
+
+  return {
+    servicing_dealer: rfParty.OrgInfo?.CompanyName || null,
+    servicing_dealer_contact:
+      rfComms.find((c) => c.CommQualifier === "WP" || c.CommQualifier === "FX")?.CommPhone || null
+  };
+};
+
+/**
+ * Extracts loss information from the XML request.
+ * @param rq
+ * @returns {{loss_dt: (*|null), reported_dt: (*|null), loss_type_code: (*|null), loss_type_desc: (*|null)}}
+ */
+const extractLossInfo = (rq) => {
+  const loss = rq.ClaimInfo?.LossInfo?.Facts || {};
+  const custom = rq.ClaimInfo?.CustomElement || {};
+  return {
+    loss_date: loss.LossDateTime || null,
+    loss_type: custom.LossTypeCode || null,
+    loss_desc: custom.LossTypeDesc || null
+    // primary_poi: loss.PrimaryPOI?.POICode || null,
+    // secondary_poi: loss.SecondaryPOI?.POICode || null,
+    // damage_memo: loss.DamageMemo || null, //(maybe ins_memo)
+    // total_loss_ind: rq.ClaimInfo?.LossInfo?.TotalLossInd || null // New
+  };
+};
+
+/**
+ * Extracts insurance data from the XML request.
+ * @param rq
+ * @returns {{insd_ln: (*|null), insd_fn: (string|null), insd_title: (*|null), insd_co_nm: (*|string|null), insd_addr1:
+ * (*|null), insd_addr2: (*|null), insd_city: (*|null), insd_st: (*|null), insd_zip: (*|null), insd_ctry: (*|null),
+ * insd_ph1, insd_ph1x, insd_ph2, insd_ph2x, insd_fax, insd_faxx, insd_ea}}
+ */
+const extractInsuranceData = (rq) => {
+  const insuredParty = rq.AdminInfo?.Insured?.Party || {};
+  const insuredPerson = insuredParty.PersonInfo || {};
+  const insuredComms = Array.isArray(insuredParty.ContactInfo?.Communications)
+    ? insuredParty.ContactInfo.Communications
+    : [insuredParty.ContactInfo?.Communications || {}];
+  const insuredAddress = insuredPerson.Communications?.Address || {};
+
+  const insurerParty = rq.AdminInfo?.InsuranceCompany?.Party || {};
+
+  let insd_ph1, insd_ph1x, insd_ph2, insd_ph2x, insd_fax, insd_faxx, insd_ea;
+
+  for (const c of insuredComms) {
+    if (c.CommQualifier === "CP") {
+      insd_ph1 = c.CommPhone;
+      insd_ph1x = c.CommPhoneExt;
+    }
+    if (c.CommQualifier === "WP") {
+      insd_ph2 = c.CommPhone;
+      insd_ph2x = c.CommPhoneExt;
+    }
+    if (c.CommQualifier === "FX") {
+      insd_fax = c.CommPhone;
+      insd_faxx = c.CommPhoneExt;
+    }
+    if (c.CommQualifier === "EM") insd_ea = c.CommEmail;
+  }
+
+  return {
+    insd_ln: insuredPerson.PersonName?.LastName || null,
+    insd_fn: insuredPerson.PersonName?.FirstName || null,
+    insd_title: insuredPerson.PersonName?.Title || null,
+    insd_co_nm: insurerParty.OrgInfo?.CompanyName || insuredParty.OrgInfo?.CompanyName || null,
+    insd_addr1: insuredAddress.Address1 || null,
+    insd_addr2: insuredAddress.Address2 || null,
+    insd_city: insuredAddress.City || null,
+    insd_st: insuredAddress.StateProvince || null,
+    insd_zip: insuredAddress.PostalCode || null,
+    insd_ctry: insuredAddress.Country || null,
+    insd_ph1,
+    insd_ph1x,
+    insd_ph2,
+    insd_ph2x,
+    insd_fax,
+    insd_faxx,
+    insd_ea
+  };
+};
+
+/**
+ * Extracts vehicle data from the XML request.
+ * @param {object} rq - The VehicleDamageEstimateAddRq object.
+ * @param {string} shopId - The bodyshop UUID.
+ * @returns {object} Vehicle data for insertion and inline use.
+ */
+const extractVehicleData = (rq, shopId) => {
+  const desc = rq.VehicleInfo?.VehicleDesc || {};
+  const exterior = rq.VehicleInfo?.Paint?.Exterior || {};
+  const interior = rq.VehicleInfo?.Paint?.Interior || {};
+  return {
+    shopid: shopId,
+    v_vin: rq.VehicleInfo?.VINInfo?.VIN?.VINNum || null,
+    plate_no: rq.VehicleInfo?.License?.LicensePlateNum || null,
+    plate_st: rq.VehicleInfo?.License?.LicensePlateStateProvince || null,
+    v_model_yr: desc.ModelYear || null,
+    v_make_desc: desc.MakeDesc || null,
+    v_model_desc: desc.ModelName || null,
+    v_color: exterior.Color?.ColorName || null,
+    v_bstyle: desc.BodyStyle || null,
+    v_engine: desc.EngineDesc || null,
+    v_options: desc.SubModelDesc || null,
+    v_type: desc.FuelType || null,
+    v_cond: rq.VehicleInfo?.Condition?.DrivableInd,
+    v_trimcode: desc.TrimCode || null,
+    v_tone: exterior.Tone || null,
+    v_stage: exterior.RefinishStage || rq.VehicleInfo?.Paint?.RefinishStage || null,
+    v_prod_dt: desc.ProductionDate || null,
+    v_paint_codes: Array.isArray(exterior.PaintCodeInfo)
+      ? exterior.PaintCodeInfo.map((p) => p.PaintCode).join(",")
+      : exterior.PaintCode || null,
+    v_mldgcode: desc.MldgCode || null,
+    v_makecode: desc.MakeCode || null,
+    trim_color: interior.ColorName || desc.TrimColor || null,
+    db_v_code: desc.DatabaseCode || null
+    // v_model_num: desc.ModelNum || null
+    // v_odo: desc.OdometerInfo?.OdometerReading || null
+  };
+};
+
+/**
+ * Extracts job lines from the XML request.
+ * @param {object} rq - The VehicleDamageEstimateAddRq object.
+ * @returns {object[]} Array of job line objects.
+ */
+const extractJobLines = (rq) => {
+  const damageLines = Array.isArray(rq.DamageLineInfo) ? rq.DamageLineInfo : [rq.DamageLineInfo];
+
+  return damageLines.map((line) => {
+    const jobLine = {
+      line_no: parseInt(line.LineNum, 10),
+      unq_seq: parseInt(line.UniqueSequenceNum, 10),
+      status: line.LineStatusCode || null,
+      line_desc: line.LineDesc || null,
+      part_type: line.PartInfo?.PartType || null,
+      part_qty: parseFloat(line.PartInfo?.Quantity || 0),
+      oem_partno: line.PartInfo?.OEMPartNum || null,
+      db_price: parseFloat(line.PartInfo?.PartPrice || 0),
+      act_price: parseFloat(line.PartInfo?.PartPrice || 0),
+      mod_lbr_ty: line.LaborInfo?.LaborType || null,
+      mod_lb_hrs: parseFloat(line.LaborInfo?.LaborHours || 0),
+      lbr_op: line.LaborInfo?.LaborOperation || null,
+      lbr_amt: parseFloat(line.LaborInfo?.LaborAmt || 0),
+      notes: line.LineMemo || null,
+      manual_line: line.ManualLineInd || null
+      // taxable_ind: line.PartInfo?.TaxableInd || null,
+      // automated_entry: line.AutomatedEntry || null
+    };
+
+    // TODO: Commented out as not clear if needed for version 1, this only applies to Imex and not rome on the front
+    // end
+    // if ((jobLine.part_type === "PASL" || jobLine.part_type === "PAS") && jobLine.lbr_op !== "OP11") {
+    //   jobLine.tax_part = true;
+    // }
+    // if (line.db_ref === "900510") {
+    //   jobLine.tax_part = true;
+    // }
+
+    return jobLine;
+  });
+};
+
+/**
+ * Finds an existing vehicle by shopId and VIN.
+ * @param {string} shopId - The bodyshop UUID.
+ * @param {string} v_vin - The vehicle VIN.
+ * @param {object} logger - The logger instance.
+ * @returns {Promise<string|null>} The vehicle ID or null if not found.
+ */
+const findExistingVehicle = async (shopId, v_vin, logger) => {
+  if (!v_vin) return null;
+
+  try {
+    const { vehicles } = await client.request(GET_VEHICLE_BY_SHOP_VIN, { shopid: shopId, v_vin });
+    if (vehicles?.length > 0) {
+      logger.log("parts-vehicle-found", "info", vehicles[0].id, null, { shopid: shopId, v_vin });
+      return vehicles[0].id;
+    }
+  } catch (err) {
+    logger.log("parts-vehicle-fetch-failed", "warn", null, null, { error: err });
+  }
+  return null;
+};
+
+/**
+ * Inserts an owner and returns the owner ID.
+ * @param {object} ownerInput - The owner data to insert.
+ * @param {object} logger - The logger instance.
+ * @returns {Promise<string|null>} The owner ID or null if insertion fails.
+ */
+const insertOwner = async (ownerInput, logger) => {
+  try {
+    const { insert_owners_one } = await client.request(INSERT_OWNER, { owner: ownerInput });
+    return insert_owners_one?.id;
+  } catch (err) {
+    logger.log("parts-owner-insert-failed", "warn", null, null, { error: err });
+    return null;
+  }
+};
+
+/**
+ * Handles the VehicleDamageEstimateAddRq XML request from parts management.
+ * @param {object} req - The HTTP request object.
+ * @param {object} res - The HTTP response object.
+ * @returns {Promise<void>}
+ */
+const vehicleDamageEstimateAddRq = async (req, res) => {
+  const { logger } = req;
+
+  try {
+    // Parse XML
+    const payload = await parseXml(req.body, logger);
+    const rq = normalizeXmlObject(payload.VehicleDamageEstimateAddRq);
+    if (!rq) {
+      logger.log("parts-missing-root", "error");
+      return res.status(400).send("Missing <VehicleDamageEstimateAddRq>");
+    }
+
+    // Extract job data
+    const {
+      shopId,
+      refClaimNum,
+      ciecaid,
+      cieca_ttl,
+      cat_no,
+      category,
+      classType,
+      comment,
+      date_exported,
+      asgn_no,
+      asgn_type,
+      asgn_date,
+      scheduled_in,
+      scheduled_completion,
+      clm_no,
+      status,
+      policy_no,
+      ded_amt
+    } = extractJobData(rq);
+
+    if (!shopId) {
+      throw { status: 400, message: "Missing <ShopID> in XML" };
+    }
+
+    // Get default status
+    const defaultStatus = await getDefaultOrderStatus(shopId, logger);
+
+    // Extract additional data
+    const parts_tax_rates = extractPartsTaxRates(rq.ProfileInfo);
+    const ownerData = extractOwnerData(rq, shopId);
+    const estimatorData = extractEstimatorData(rq);
+    const adjusterData = extractAdjusterData(rq);
+    const repairFacilityData = extractRepairFacilityData(rq);
+    const vehicleData = extractVehicleData(rq, shopId);
+    const lossInfo = extractLossInfo(rq);
+    const joblinesData = extractJobLines(rq);
+    const insuranceData = extractInsuranceData(rq);
+
+    // Find or create relationships
+    const ownerid = await insertOwner(ownerData, logger);
+    const vehicleid = await findExistingVehicle(shopId, vehicleData.v_vin, logger);
+
+    // Build job input
+    const jobInput = {
+      shopid: shopId,
+      ownerid,
+      ro_number: refClaimNum,
+      ciecaid,
+      cieca_ttl,
+      cat_no,
+      category,
+      class: classType,
+      parts_tax_rates,
+      clm_no,
+      status: status || defaultStatus,
+      clm_total: cieca_ttl,
+      policy_no,
+      ded_amt,
+      comment,
+      date_exported,
+      asgn_no,
+      asgn_type,
+      asgn_date,
+      scheduled_in,
+      scheduled_completion,
+      ...insuranceData, // Inline insurance data
+      ...lossInfo, // Inline loss information
+      ...ownerData, // Inline owner data
+      ...estimatorData, // Inline estimator data
+      ...adjusterData, // Inline adjuster data
+      ...repairFacilityData, // Inline repair facility data
+      // Inline vehicle data
+      v_vin: vehicleData.v_vin,
+      v_model_yr: vehicleData.v_model_yr,
+      v_model_desc: vehicleData.v_model_desc,
+      v_make_desc: vehicleData.v_make_desc,
+      v_color: vehicleData.v_color,
+      plate_no: vehicleData.plate_no,
+      plate_st: vehicleData.plate_st,
+      ...(vehicleid ? { vehicleid } : { vehicle: { data: vehicleData } }),
+      joblines: { data: joblinesData }
+    };
+
+    // Insert job
+    const { insert_jobs_one: newJob } = await client.request(INSERT_JOB_WITH_LINES, { job: jobInput });
+    logger.log("parts-job-created", "info", newJob.id, null);
+
+    return res.status(200).json({ success: true, jobId: newJob.id });
+  } catch (err) {
+    logger.log("parts-route-error", "error", null, null, { error: err });
+    console.dir({ err });
+    return res.status(err.status || 500).json({ error: err.message || "Internal error" });
+  }
+};
+
+module.exports = vehicleDamageEstimateAddRq;

server/integrations/partsManagement/endpoints/vehicleDamageEstimateChgRq.js

@@ -0,0 +1,105 @@
+// no-dd-sa:javascript-code-style/assignment-name
+// Handler for VehicleDamageEstimateChgRq
+
+const client = require("../../../graphql-client/graphql-client").client;
+const { parseXml, normalizeXmlObject } = require("../partsManagementUtils");
+
+const {
+  GET_JOB_BY_CLAIM,
+  UPDATE_JOB_BY_ID,
+  UPSERT_JOBLINES,
+  DELETE_JOBLINES_BY_IDS
+} = require("../partsManagement.queries");
+
+const findJob = async (shopId, claimNum, logger) => {
+  try {
+    const { jobs } = await client.request(GET_JOB_BY_CLAIM, { shopid: shopId, clm_no: claimNum });
+    return jobs?.[0] || null;
+  } catch (err) {
+    logger.log("parts-job-lookup-failed", "error", null, null, { error: err });
+    return null;
+  }
+};
+
+const extractUpdatedJobData = (rq) => {
+  const doc = rq.DocumentInfo || {};
+  const claim = rq.ClaimInfo || {};
+
+  return {
+    comment: doc.Comment || null,
+    clm_no: claim.ClaimNum || null,
+    status: claim.ClaimStatus || null,
+    policy_no: claim.PolicyInfo?.PolicyNum || null
+  };
+};
+
+const extractUpdatedJobLines = (addsChgs = {}, jobId) => {
+  const lines = Array.isArray(addsChgs.DamageLineInfo) ? addsChgs.DamageLineInfo : [addsChgs.DamageLineInfo || []];
+
+  return lines.map((line) => ({
+    jobid: jobId,
+    line_no: parseInt(line.LineNum, 10),
+    unq_seq: parseInt(line.UniqueSequenceNum, 10),
+    status: line.LineStatusCode || null,
+    line_desc: line.LineDesc || null,
+    part_type: line.PartInfo?.PartType || null,
+    part_qty: parseFloat(line.PartInfo?.Quantity || 0),
+    oem_partno: line.PartInfo?.OEMPartNum || null,
+    db_price: parseFloat(line.PartInfo?.PartPrice || 0),
+    act_price: parseFloat(line.PartInfo?.PartPrice || 0),
+    mod_lbr_ty: line.LaborInfo?.LaborType || null,
+    mod_lb_hrs: parseFloat(line.LaborInfo?.LaborHours || 0),
+    lbr_op: line.LaborInfo?.LaborOperation || null,
+    lbr_amt: parseFloat(line.LaborInfo?.LaborAmt || 0),
+    notes: line.LineMemo || null,
+    manual_line: line.ManualLineInd === "1"
+  }));
+};
+
+const extractDeletions = (deletions = {}) => {
+  const lines = Array.isArray(deletions.DamageLineInfo) ? deletions.DamageLineInfo : [deletions.DamageLineInfo || []];
+
+  return lines.map((line) => parseInt(line.UniqueSequenceNum, 10)).filter((id) => !isNaN(id));
+};
+
+const partsManagementVehicleDamageEstimateChgRq = async (req, res) => {
+  const { logger } = req;
+
+  try {
+    const payload = await parseXml(req.body, logger);
+    const rq = normalizeXmlObject(payload.VehicleDamageEstimateChgRq);
+    if (!rq) return res.status(400).send("Missing <VehicleDamageEstimateChgRq>");
+
+    const shopId = rq.ShopID;
+    const claimNum = rq.ClaimInfo?.ClaimNum;
+
+    if (!shopId || !claimNum) return res.status(400).send("Missing ShopID or ClaimNum");
+
+    const job = await findJob(shopId, claimNum, logger);
+    if (!job) return res.status(404).send("Job not found");
+
+    const updatedJobData = extractUpdatedJobData(rq);
+    const updatedLines = extractUpdatedJobLines(rq.AddsChgs, job.id);
+    const deletedLineIds = extractDeletions(rq.Deletions);
+
+    await client.request(UPDATE_JOB_BY_ID, { id: job.id, job: updatedJobData });
+
+    if (updatedLines.length > 0) {
+      await client.request(UPSERT_JOBLINES, {
+        joblines: updatedLines
+      });
+    }
+
+    if (deletedLineIds.length > 0) {
+      await client.request(DELETE_JOBLINES_BY_IDS, { jobid: job.id, unqSeqs: deletedLineIds });
+    }
+
+    logger.log("parts-job-changed", "info", job.id, null);
+    return res.status(200).json({ success: true, jobId: job.id });
+  } catch (err) {
+    logger.log("parts-chgrq-error", "error", null, null, { error: err });
+    return res.status(err.status || 500).json({ error: err.message || "Internal error" });
+  }
+};
+
+module.exports = partsManagementVehicleDamageEstimateChgRq;