@rinse-dental/open-dental 1.2.0 → 1.4.0

package/dist/types/claimProcTypes.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Represents a ClaimProc in the Open Dental system.
+ * @see https://www.opendental.com/site/apiclaimprocs.html
+ */
+export interface ClaimProc {
+    ClaimProcNum?: number;
+    ProcNum?: number;
+    ClaimNum?: number;
+    PatNum?: number;
+    ProvNum?: number;
+    FeeBilled?: number;
+    InsPayEst?: number;
+    DedApplied?: number;
+    Status?: "NotReceived" | "Received" | "Preauth" | "Adjustment" | "Supplemental" | "CapClaim" | "Estimate" | "CapComplete" | "CapEstimate" | "InsHist";
+    InsPayAmt?: number;
+    Remarks?: string;
+    ClaimPaymentNum?: number;
+    PlanNum?: number;
+    DateCP?: string;
+    WriteOff?: number;
+    CodeSent?: string;
+    AllowedOverride?: number;
+    Percentage?: number;
+    PercentOverride?: number;
+    CopayAmt?: number;
+    NoBillIns?: true | false;
+    PaidOtherIns?: number;
+    BaseEst?: number;
+    CopayOverride?: number;
+    ProcDate?: string;
+    DateEntry?: string;
+    DedEst?: number;
+    DedEstOverride?: number;
+    InsEstTotal?: number;
+    InsEstTotalOverride?: number;
+    PaidOtherInsOverride?: number;
+    EstimateNote?: string;
+    WriteOffEst?: number;
+    WriteOffEstOverride?: number;
+    ClinicNum?: number;
+    InsSubNum?: number;
+    PaymentRow?: number;
+    PayPlanNum?: number;
+    ClaimPaymentTracking?: number;
+    claimPaymentTracking?: string;
+    SecUserNumEntry?: number;
+    SecDateEntry?: string;
+    SecDateTEdit?: string;
+    DateSuppReceived?: string;
+    DateInsFinalized?: string;
+    IsTransfer?: "true" | "false";
+    ClaimAdjReasonCodes?: string;
+}
+/**
+ * Gets all ClaimProcs based on provided parameters. If no parameter is given, it will get all ClaimProcs ordered by ClaimProcNum.
+ * @see https://www.opendental.com/site/apiclaimprocs.html
+ */
+export interface GetClaimProcsParams {
+    ProcNum?: number;
+    ClaimNum?: number;
+    PatNum?: number;
+    Status?: "NotReceived" | "Received" | "Preauth" | "Adjustment" | "Supplemental" | "CapClaim" | "Estimate" | "CapComplete" | "CapEstimate" | "InsHist";
+    ClaimPaymentNum?: number;
+    Offset?: number;
+}
+//# sourceMappingURL=claimProcTypes.d.ts.map

package/dist/types/claimProcTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimProcTypes.d.ts","sourceRoot":"","sources":["../../src/types/claimProcTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,CAAC;IACtJ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,CAAC;IACtJ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/claimProcTypes.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/insPlanTypes.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @see https://www.opendental.com/site/apiinsplans.html
+ */
+export interface InsPlan {
+    PlanNum?: number;
+    GroupName?: string;
+    GroupNum?: string;
+    PlanNote?: string;
+    FeeSched?: number;
+    PlanType?: "" | "p" | "f" | "c";
+    ClaimFormNum?: number;
+    CopayFeeSched?: number;
+    EmployerNum?: number;
+    CarrierNum?: number;
+    CodeSubstNone?: "true" | "false";
+    IsHidden?: "true" | "false";
+    MonthRenew?: number;
+    SecUserNumEntry?: number;
+    SecDateEntry?: string;
+    SecDateTEdit?: string;
+    IsBlueBookEnabled?: "true" | "false";
+}
+/**
+ * Gets a list of PatPlans that meet a set of search criteria.
+ * @see https://www.opendental.com/site/apiinsplans.html
+ */
+export interface GetInsPlansParams {
+    PlanType?: "percentage" | "p" | "f" | "c";
+    CarrierNum?: number;
+    Offset?: number;
+}
+/**
+ * Parameters for creating a new insplan.
+ * @see https://www.opendental.com/site/apiinsplans.html
+ */
+export interface CreateInsPlanParams {
+    CarrierNum: number;
+    GroupName?: string;
+    GroupNum?: string;
+    PlanNote?: string;
+    FeeSched?: number;
+    PlanType?: "" | "p" | "f" | "c";
+    CopayFeeSched?: number;
+    EmployerNum?: number;
+    CodeSubstNone?: "true" | "false";
+    IsHidden?: "true" | "false";
+    MonthRenew?: number;
+    IsBlueBookEnabled?: "true" | "false";
+}
+/**
+ * Parameters to update an insplan.
+ * @see https://www.opendental.com/site/apiinsplans.html
+ */
+export interface UpdateInsPlanParams {
+    PlanNum: number;
+    GroupName?: string;
+    GroupNum?: string;
+    PlanNote?: string;
+    FeeSched?: number;
+    PlanType?: "" | "p" | "f" | "c";
+    CopayFeeSched?: number;
+    EmployerNum?: number;
+    CarrierNum: number;
+    CodeSubstNone?: "true" | "false";
+    IsHidden?: "true" | "false";
+    MonthRenew?: number;
+    IsBlueBookEnabled?: "true" | "false";
+}
+//# sourceMappingURL=insPlanTypes.d.ts.map

package/dist/types/insPlanTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insPlanTypes.d.ts","sourceRoot":"","sources":["../../src/types/insPlanTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,YAAY,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC"}

package/dist/types/insPlanTypes.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rinse-dental/open-dental",
-    "version": "1.2.0",
+    "version": "1.4.0",
     "description": "A TypeScript library for easily accessing Open Dental APIs.",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/release.sh

@@ -41,5 +41,5 @@ gh release create "$NEW_TAG" --title "Release $NEW_TAG" --notes "$COMMIT_MSG"
 
 
 #example ./release.sh "Some commit message" patch 
-#example ./release.sh "Some commit message" minor
+#example ./release.sh "Added insplans and benefits" minor
 #example ./release.sh "Some commit message" major 

package/src/api/benefits.ts

@@ -0,0 +1,155 @@
+import HttpClient from "../utils/httpClient";
+import {
+  Benefit,
+  GetBenefitsParams,
+  CreateBenefitParams,
+  UpdateBenefitParams,
+} from "../types/benefitTypes";
+
+export default class Benefits {
+  private httpClient: HttpClient;
+
+  constructor(httpClient: HttpClient) {
+    this.httpClient = httpClient;
+  }
+
+  /**
+    * Fetch multiple benefits with optional filtering and pagination.
+    * @param {Object} params - The parameters for filtering and pagination.
+    * @param {number} [params.PlanNum] - FK to InsPlan.PlanNum.
+    * @param {number} [params.PatPlanNum] - FK to PatPlan.PatPlanNum.
+    * @param {number} [params.Offset] - Pagination offset for results.
+    * @returns {Promise<Benefit[]>} - A list of benefits.
+    */
+  public async getBenefits({
+    PlanNum,
+    PatPlanNum,
+    Offset,
+  }: GetBenefitsParams = {}): Promise<Benefit[]> {
+    const params = {
+      PlanNum,
+      PatPlanNum,
+      Offset,
+    };
+  
+    return this.httpClient.get<Benefit[]>("/benefits", params);
+  }
+
+  /**
+   * This adds a Benefit row to the database.
+   * @param {Object} data - The details of the Benefit to create.
+   * @param {number} data.PlanNum - This or PatPlanNum is required. FK to InsPlan.PlanNum.
+   * @param {number} data.PatPlanNum - This or PlanNum is required. FK to PatPlan.PlanNum.
+   * @param {"ActiveCoverage" | "CoInsurance" | "Deductible" | "CoPayment" | "Exclusions" | "Limitations" | "WaitingPeriod"} data.BenefitType - Required. Either "ActiveCoverage", "CoInsurance", "Deductible", "CoPayment", "Exclusions", "Limitations", or "WaitingPeriod".
+   * @param {"None" | "Individual" | "Family"} data.CoverageLevel - Required. Either "None", "Individual", or "Family".
+   * @param {number} [data.CovCatNum] - Optional. FK to covcat.CovCatNum.
+   * @param {number} [data.Percent] - Optional. Only allowed if BenefitType is "CoInsurance". Must be a value between 0 and 100. Default -1 (Indicating empty).
+   * @param {number} [data.MonetaryAmt] - Optional. Only used if BenefitType is "CoPayment", "Limitations", or "Deductible". Default -1.0 (Indicating empty).
+   * @param {"None" | "ServiceYear" | "CalendarYear" | "Lifetime" | "Years" | "NumberInLast12Months"} [data.TimePeriod] - Optional. Either "None", "ServiceYear", "CalendarYear", "Lifetime", "Years", or "NumberInLast12Months". Default "CalendarYear".
+   * @param {"None" | "NumberOfServices" | "AgeLimit" | "Visits" | "Years" | "Months"} [data.QuantityQualifier] - Optional. Either "None", "NumberOfServices", "AgeLimit", "Visits", "Years", or "Months". Default "None". Must be "Months" or "Years" if BenefitType is "WaitingPeriod".
+   * @param {number} [data.Quantity] - Optional. Must be a value between 0 and 100. Default 0. Must be a value greater than 0 if QuantityQualifier is "AgeLimit".
+   * @param {number} [data.CodeNum] - Optional. FK to procedurecode.CodeNum. Only allowed if CovCatNum is 0. Will be used over procCode if both are specified. Default 0.
+   * @param {string} [data.procCode] - Optional. FK to procedurecode.ProcCode. Only allowed if CovCatNum is 0. Default empty string.
+   * @param {number} [data.CodeGroupNum] - Optional. (Added in version 23.2.62) FK to codegroup.CodeGroupNum. The group of procedure codes that apply to this Frequency Limitation benefit.
+  * @returns {Promise<Benefit>} - The created a benefit.
+   * @throws {Error} - If required fields are missing or the API returns an error.
+   */
+  public async createBenefit({
+    PlanNum,
+    PatPlanNum,
+    BenefitType,
+    CoverageLevel,
+    CovCatNum,
+    Percent,
+    MonetaryAmt,
+    TimePeriod,
+    QuantityQualifier,
+    Quantity,
+    CodeNum,
+    procCode,
+    CodeGroupNum,
+  } : CreateBenefitParams): Promise<Benefit> {
+    if (!BenefitType || !CoverageLevel) {
+      throw new Error("Invalid data: Either PlanNum or PatPlanNum and BenefitType and CoverageLevel are required.");
+    }
+
+    return this.httpClient.post<Benefit>("/benefits", {
+      PlanNum,
+      PatPlanNum,
+      BenefitType,
+      CoverageLevel,
+      CovCatNum,
+      Percent,
+      MonetaryAmt,
+      TimePeriod,
+      QuantityQualifier,
+      Quantity,
+      CodeNum,
+      procCode,
+      CodeGroupNum,
+    });
+  }
+
+  /**
+   * Update a Benefit.
+   * @param {Object} data - The details of Benefit to update.
+   * @param {number} data.BenefitNum - Required. PK
+   * @param {number} [data.CovCatNum] - Optional. FK to covcat.CovCatNum.
+  * @param {"ActiveCoverage" | "CoInsurance" | "Deductible" | "CoPayment" | "Exclusions" | "Limitations" | "WaitingPeriod"} [data.BenefitType] - Optional. Either "ActiveCoverage", "CoInsurance", "Deductible", "CoPayment", "Exclusions", "Limitations", or "WaitingPeriod".
+   * @param {number} [data.Percent] - Optional. Only allowed if BenefitType is "CoInsurance". Must be a value between 0 and 100. Default -1 (Indicating empty).
+   * @param {number} [data.MonetaryAmt] - Optional. Only used if BenefitType is "CoPayment", "Limitations", or "Deductible". Default -1.0 (Indicating empty).
+   * @param {"None" | "ServiceYear" | "CalendarYear" | "Lifetime" | "Years" | "NumberInLast12Months"} [data.TimePeriod] - Optional. Either "None", "ServiceYear", "CalendarYear", "Lifetime", "Years", or "NumberInLast12Months". Default "CalendarYear".
+   * @param {"None" | "NumberOfServices" | "AgeLimit" | "Visits" | "Years" | "Months"} [data.QuantityQualifier] - Optional. Either "None", "NumberOfServices", "AgeLimit", "Visits", "Years", or "Months". Default "None". Must be "Months" or "Years" if BenefitType is "WaitingPeriod".
+   * @param {number} [data.Quantity] - Optional. Must be a value between 0 and 100. Default 0. Must be a value greater than 0 if QuantityQualifier is "AgeLimit".
+   * @param {number} [data.CodeNum] - Optional. FK to procedurecode.CodeNum. Only allowed if CovCatNum is 0. Will be used over procCode if both are specified.
+   * @param {string} [data.procCode] - Optional. FK to procedurecode.ProcCode. Only allowed if CovCatNum is 0.
+   * @param {"None" | "Individual" | "Family"} [data.CoverageLevel] - Optional. Either "None", "Individual", or "Family".
+  * @returns {Promise<Benefit>} - The updated Benefit.
+   * @throws {Error} - If required fields are missing or the API returns an error.
+   */
+  public async updateBenefit({
+    BenefitNum,
+    CovCatNum,
+    BenefitType,
+    Percent,
+    MonetaryAmt,
+    TimePeriod,
+    QuantityQualifier,
+    Quantity,
+    CodeNum,
+    procCode,
+    CoverageLevel,
+  } : UpdateBenefitParams): Promise<Benefit> {
+    if (!BenefitNum || typeof BenefitNum !== "number") {
+      throw new Error("Invalid data: A Valid BenefitNum is required.");
+    }
+
+    return this.httpClient.put<Benefit>(`/benefits/${BenefitNum}`, {
+      CovCatNum,
+      BenefitType,
+      Percent,
+      MonetaryAmt,
+      TimePeriod,
+      QuantityQualifier,
+      Quantity,
+      CodeNum,
+      procCode,
+      CoverageLevel,
+    });
+  }
+
+  /**
+   * Delete a Benefit entry. 
+   * This removes a Benefit row from the database.
+   * @param {number} BenefitNum - Required: The unique identifier of the Benefit to delete.
+   * @returns {Promise<void>} - Resolves when the Benefit is deleted.
+   * @throws {Error} - If `BenefitNum` is not valid or the API returns an error.
+   */
+  public async deletePatPlan(BenefitNum: number): Promise<void> {
+    if (!BenefitNum || typeof BenefitNum !== "number") {
+      throw new Error("Invalid parameter: BenefitNum must be a valid number.");
+    }
+
+    return this.httpClient.delete<void>(`/benefits/${BenefitNum}`);
+  }
+}

package/src/api/claimProcs.ts

@@ -0,0 +1,44 @@
+import HttpClient from "../utils/httpClient";
+import {
+  ClaimProc,
+  GetClaimProcsParams,
+} from "../types/claimProcTypes";
+
+export default class ClaimProcs {
+  private httpClient: HttpClient;
+
+  constructor(httpClient: HttpClient) {
+    this.httpClient = httpClient;
+  }
+
+  /**
+    * Fetch multiple ClaimProcs with optional filtering and pagination.
+    * @param {Object} params - The parameters for filtering and pagination.
+    * @param {number} [params.ProcNum] - FK to procedurelog.ProcNum.
+    * @param {number} [params.ClaimNum] - FK to claim.ClaimNum.
+    * @param {number} [params.PatNum] - FK to patient.PatNum.
+    * @param {"NotReceived" | "Received" | "Preauth" | "Adjustment" | "Supplemental" | "CapClaim" | "Estimate" | "CapComplete" | "CapEstimate" | "InsHist"} [params.Status] - Either "NotReceived", "Received", "Preauth", "Adjustment", "Supplemental", "CapClaim", "Estimate",
+    * @param {number} [params.ClaimPaymentNum] - FK to claimpayment.ClaimPaymentNum.
+    * @param {number} [params.Offset] - Pagination offset for results.
+    * @returns {Promise<ClaimProc[]>} - A list of ClaimProcs.
+    */
+  public async getClaimProcs({
+    ProcNum,
+    ClaimNum,
+    PatNum,
+    Status,
+    ClaimPaymentNum,
+    Offset,
+  }: GetClaimProcsParams = {}): Promise<ClaimProc[]> {
+    const params = {
+      ProcNum,
+      ClaimNum,
+      PatNum,
+      Status,
+      ClaimPaymentNum,
+      Offset,
+    };
+  
+    return this.httpClient.get<ClaimProc[]>("/claimprocs", params);
+  }
+}

package/src/api/insPlans.ts

@@ -0,0 +1,158 @@
+import HttpClient from "../utils/httpClient";
+import {
+  InsPlan,
+  GetInsPlansParams,
+  CreateInsPlanParams,
+  UpdateInsPlanParams,
+} from "../types/insPlanTypes";
+
+export default class InsPlans {
+  private httpClient: HttpClient;
+
+  constructor(httpClient: HttpClient) {
+    this.httpClient = httpClient;
+  }
+
+  /**
+   * Fetch a single insplan by its ID.
+   * @param {number} PlanNum - The ID of the insplan.
+   * @returns {Promise<InsPlan>} - The insplan data.
+   * @throws {Error} - If `InsPlan` is not valid or the API returns an error.
+   */
+  public async getInsPlan(PlanNum: number): Promise<InsPlan> {
+    if (!PlanNum || typeof PlanNum !== "number") {
+      throw new Error("Invalid parameter: PlanNum must be a valid number.");
+    }
+
+    return await this.httpClient.get<InsPlan>(`/insplans/${PlanNum}`);
+  }
+  
+
+  /**
+    * Fetch multiple insplans with optional filtering and pagination.
+    * @param {Object} params - The parameters for filtering and pagination.
+    * @param {"percentage" | "p" | "f" | "c" } [params.PlanType] - Must be one of the following: "percentage" (Percentage), "p" (PPO Percentage), "f" (Flat Copay), or "c" (Capitation). Percentage PlanTypes are stored as blank in the database.
+    * @param {number} [params.CarrierNum] - FK to carrier.CarrierNum.
+    * @param {number} [params.Offset] - Pagination offset for results.
+    * @returns {Promise<InsPlan[]>} - A list of InsPlans.
+    */
+  public async getInsPlans({
+    PlanType,
+    CarrierNum,
+    Offset,
+  }: GetInsPlansParams = {}): Promise<InsPlan[]> {
+    const params = {
+      PlanType,
+      CarrierNum,
+      Offset,
+    };
+  
+    return this.httpClient.get<InsPlan[]>("/insplans", params);
+  }
+
+  /**
+   * This adds an InsPlan row to the database.
+   * @param {Object} data - The details of the insplan to create.
+   * @param {number} data.CarrierNum - Required. FK to carrier.CarrierNum.
+   * @param {string} [data.GroupName] - Optional. Typically the same as the employer. Used to identify difference in plans.
+   * @param {string} [data.GroupNum] - Optional. The carrier assigned identifier, unique for each plan.
+   * @param {string} [data.PlanNote] - Optional. Note for this plan. Same for all subscribers.
+   * @param {number} [data.FeeSched] - Optional. FK to feesched.FeeSchedNum. Default 0.
+   * @param {"" | "p" | "f" | "c"} [data.PlanType] - Optional. Either "" (Percentage), "p" (PPO Percentage), "f" (Flat Copay), or "c". Default is "" (Percentage).
+   * @param {number} [data.CopayFeeSched] - Optional. FK to feesched.FeeSchedNum when FeeSchedType is CoPay. Typically only used for capitation or copay plans. Default 0.
+   * @param {number} [data.EmployerNum] - Optional. FK to employer.EmployerNum. Default 0.
+   * @param {"true" | "false"} [data.CodeSubstNone] - Optional. Either "true" or "false". Set "true" if this Insurance Plan should ignore any Substitution Codes. Default "false".
+   * @param {"true" | "false"} [data.IsHidden] - ?: "true" | "false"; // Optional. Either "true" or "false". Default "false".
+   * @param {number} [data.MonthRenew] - Optional. The month, 1-12, when the insurance plan renews. It will renew on the first of the month. Default 0 to indicate calendar year.
+   * @param {"true" | "false"} [data.IsBlueBookEnabled] - Optional. Determines if the plan utilizes BlueBook or not. Cannot be set to true if PlanType is set to anything other than "" (Percentage). Defaults to true if AllowedFeeSchedsAutomate is set to BlueBook, otherwise defaults to false.
+   * @returns {Promise<InsPlan>} - The created insplan.
+   * @throws {Error} - If required fields are missing or the API returns an error.
+   */
+  public async createInsPlan({
+    CarrierNum,
+    GroupName,
+    GroupNum,
+    PlanNote,
+    FeeSched,
+    PlanType,
+    CopayFeeSched,
+    EmployerNum,
+    CodeSubstNone,
+    IsHidden,
+    MonthRenew,
+    IsBlueBookEnabled,
+  } : CreateInsPlanParams): Promise<InsPlan> {
+    if (!CarrierNum) {
+      throw new Error("Invalid data: CarrierNum is required.");
+    }
+
+    return this.httpClient.post<InsPlan>("/insplans", {
+      CarrierNum,
+      GroupName,
+      GroupNum,
+      PlanNote,
+      FeeSched,
+      PlanType,
+      CopayFeeSched,
+      EmployerNum,
+      CodeSubstNone,
+      IsHidden,
+      MonthRenew,
+      IsBlueBookEnabled,
+    });
+  }
+
+  /**
+   * Update a InsPlan.
+   * @param {Object} data - The details of InsPlan to update.
+   * @param {number} data.PlanNum - Required. Primary key. 
+   * @param {string} [data.GroupName] - Optional. Typically the same as the employer. Used to identify difference in plans.
+   * @param {string} [data.GroupNum] - Optional. The carrier assigned identifier, unique for each plan.
+   * @param {string} [data.PlanNote] - Optional. Note for this plan. Same for all subscribers.
+   * @param {number} [data.FeeSched] - Optional. FK to feesched.FeeSchedNum. Default 0.
+   * @param {"" | "p" | "f" | "c"} [data.PlanType] - Optional. Either "" (Percentage), "p" (PPO Percentage), "f" (Flat Copay), or "c". Default is "" (Percentage).
+   * @param {number} [data.CopayFeeSched] - Optional. FK to feesched.FeeSchedNum when FeeSchedType is CoPay. Typically only used for capitation or copay plans. Default 0.
+   * @param {number} [data.EmployerNum] - Optional. FK to employer.EmployerNum. Default 0.
+   * @param {number} [data.CarrierNum] - Optional. FK to carrier.CarrierNum.
+   * @param {"true" | "false"} [data.CodeSubstNone] - Optional. Either "true" or "false". Set "true" if this Insurance Plan should ignore any Substitution Codes. Default "false".
+   * @param {"true" | "false"} [data.IsHidden] - ?: "true" | "false"; // Optional. Either "true" or "false". Default "false".
+   * @param {number} [data.MonthRenew] - Optional. The month, 1-12, when the insurance plan renews. It will renew on the first of the month. Default 0 to indicate calendar year.
+   * @param {"true" | "false"} [data.IsBlueBookEnabled] - Optional. Determines if the plan utilizes BlueBook or not. Cannot be set to true if PlanType is set to anything other than "" (Percentage). Defaults to true if AllowedFeeSchedsAutomate is set to BlueBook, otherwise defaults to false.
+  * @returns {Promise<InsPlan>} - The updated InsPlan.
+   * @throws {Error} - If required fields are missing or the API returns an error.
+   */
+  public async updateInsPlan({
+    PlanNum,
+    GroupName,
+    GroupNum,
+    PlanNote,
+    FeeSched,
+    PlanType,
+    CopayFeeSched,
+    EmployerNum,
+    CarrierNum,
+    CodeSubstNone,
+    IsHidden,
+    MonthRenew,
+    IsBlueBookEnabled,
+  } : UpdateInsPlanParams): Promise<InsPlan> {
+    if (!PlanNum || typeof PlanNum !== "number") {
+      throw new Error("Invalid data: A Valid PlanNum is required.");
+    }
+
+    return this.httpClient.put<InsPlan>(`/insplans/${PlanNum}`, {
+      GroupName,
+      GroupNum,
+      PlanNote,
+      FeeSched,
+      PlanType,
+      CopayFeeSched,
+      EmployerNum,
+      CarrierNum,
+      CodeSubstNone,
+      IsHidden,
+      MonthRenew,
+      IsBlueBookEnabled,
+    });
+  }
+}

package/src/api/patPlans.ts

@@ -97,10 +97,10 @@ export default class PatPlans {
   }
 
   /**
-   * Delete an PatPlan entry. 
+   * Delete a PatPlan entry. 
    * This is called "Drop" in the Open Dental UI. This removes a PatPlan row from the database, indicating no coverage, but does not affect the InsPlan itself.
    * @param {number} PatPlanNum - Required: The unique identifier of the inssub to delete.
-   * @returns {Promise<void>} - Resolves when the discount plan sub is deleted.
+   * @returns {Promise<void>} - Resolves when the PatPlan is deleted.
    * @throws {Error} - If `PatPlanNum` is not valid or the API returns an error.
    */
   public async deletePatPlan(PatPlanNum: number): Promise<void> {

package/src/openDental.ts

@@ -19,6 +19,9 @@ import PatPlans from "./api/patPlans";
 import LabCases from "./api/labCases";
 import Referrals from "./api/referrals";
 import RefAttaches from "./api/refAttaches";
+import InsPlans from "./api/insPlans";
+import Benefits from "./api/benefits";
+import ClaimProcs from "./api/claimProcs";
 
 class OpenDental {
   private static httpClient: HttpClient;
@@ -229,7 +232,7 @@ class OpenDental {
   }
 
   /**
-   * Create a new instance of the LabCases API.
+   * Create a new instance of the RefAttaches API.
    */
   public static RefAttaches() {
     if (!this.httpClient) {
@@ -237,6 +240,36 @@ class OpenDental {
     }
     return new RefAttaches(this.httpClient);
   }
+
+  /**
+   * Create a new instance of the InsPlans API.
+   */
+  public static InsPlans() {
+    if (!this.httpClient) {
+      throw new Error("OpenDental not initialized. Call OpenDental.initialize() first.");
+    }
+    return new InsPlans(this.httpClient);
+  }
+
+  /**
+   * Create a new instance of the Benefits API.
+   */
+  public static Benefits() {
+    if (!this.httpClient) {
+      throw new Error("OpenDental not initialized. Call OpenDental.initialize() first.");
+    }
+    return new Benefits(this.httpClient);
+  }
+
+  /**
+   * Create a new instance of the ClaimProcs API.
+   */
+  public static ClaimProcs() {
+    if (!this.httpClient) {
+      throw new Error("OpenDental not initialized. Call OpenDental.initialize() first.");
+    }
+    return new ClaimProcs(this.httpClient);
+  }
 }
 
 export { OpenDental };