conductor-node 14.9.0 → 14.11.0

package/src/resources/qbd/employees.ts

@@ -77,9 +77,10 @@ export class Employees extends APIResource {
   }
 
   /**
-   * Returns a list of employees. NOTE: QuickBooks Desktop does not support
-   * pagination for employees; hence, there is no `cursor` parameter. Users typically
-   * have few employees.
+   * Returns a list of employees.
+   *
+   * **NOTE:** QuickBooks Desktop does not support pagination for employees; hence,
+   * there is no `cursor` parameter. Users typically have few employees.
    *
    * @example
    * ```ts

package/src/resources/qbd/estimates.ts

@@ -57,6 +57,10 @@ export class Estimates extends APIResource {
   /**
    * Updates an existing estimate.
    *
+   * **NOTE:** If you include `lines` or `lineGroups`, QuickBooks Desktop replaces
+   * each included line list with the array you send, so include unchanged lines you
+   * want to keep and use `id: "-1"` for new lines.
+   *
    * @example
    * ```ts
    * const estimate = await conductor.qbd.estimates.update(

package/src/resources/qbd/index.ts

@@ -19,32 +19,38 @@ export {
   BillCheckPayments,
   type BillCheckPayment,
   type BillCheckPaymentDeleteResponse,
+  type BillCheckPaymentVoidResponse,
   type BillCheckPaymentCreateParams,
   type BillCheckPaymentRetrieveParams,
   type BillCheckPaymentUpdateParams,
   type BillCheckPaymentListParams,
   type BillCheckPaymentDeleteParams,
+  type BillCheckPaymentVoidParams,
   type BillCheckPaymentsCursorPage,
 } from './bill-check-payments';
 export {
   BillCreditCardPayments,
   type BillCreditCardPayment,
   type BillCreditCardPaymentDeleteResponse,
+  type BillCreditCardPaymentVoidResponse,
   type BillCreditCardPaymentCreateParams,
   type BillCreditCardPaymentRetrieveParams,
   type BillCreditCardPaymentListParams,
   type BillCreditCardPaymentDeleteParams,
+  type BillCreditCardPaymentVoidParams,
   type BillCreditCardPaymentsCursorPage,
 } from './bill-credit-card-payments';
 export {
   Bills,
   type Bill,
   type BillDeleteResponse,
+  type BillVoidResponse,
   type BillCreateParams,
   type BillRetrieveParams,
   type BillUpdateParams,
   type BillListParams,
   type BillDeleteParams,
+  type BillVoidParams,
   type BillsCursorPage,
 } from './bills';
 export {
@@ -62,11 +68,13 @@ export {
   Checks,
   type Check,
   type CheckDeleteResponse,
+  type CheckVoidResponse,
   type CheckCreateParams,
   type CheckRetrieveParams,
   type CheckUpdateParams,
   type CheckListParams,
   type CheckDeleteParams,
+  type CheckVoidParams,
   type ChecksCursorPage,
 } from './checks';
 export {
@@ -83,43 +91,51 @@ export {
   CreditCardCharges,
   type CreditCardCharge,
   type CreditCardChargeDeleteResponse,
+  type CreditCardChargeVoidResponse,
   type CreditCardChargeCreateParams,
   type CreditCardChargeRetrieveParams,
   type CreditCardChargeUpdateParams,
   type CreditCardChargeListParams,
   type CreditCardChargeDeleteParams,
+  type CreditCardChargeVoidParams,
   type CreditCardChargesCursorPage,
 } from './credit-card-charges';
 export {
   CreditCardCredits,
   type CreditCardCredit,
   type CreditCardCreditDeleteResponse,
+  type CreditCardCreditVoidResponse,
   type CreditCardCreditCreateParams,
   type CreditCardCreditRetrieveParams,
   type CreditCardCreditUpdateParams,
   type CreditCardCreditListParams,
   type CreditCardCreditDeleteParams,
+  type CreditCardCreditVoidParams,
   type CreditCardCreditsCursorPage,
 } from './credit-card-credits';
 export {
   CreditCardRefunds,
   type CreditCardRefund,
   type CreditCardRefundDeleteResponse,
+  type CreditCardRefundVoidResponse,
   type CreditCardRefundCreateParams,
   type CreditCardRefundRetrieveParams,
   type CreditCardRefundListParams,
   type CreditCardRefundDeleteParams,
+  type CreditCardRefundVoidParams,
   type CreditCardRefundsCursorPage,
 } from './credit-card-refunds';
 export {
   CreditMemos,
   type CreditMemo,
   type CreditMemoDeleteResponse,
+  type CreditMemoVoidResponse,
   type CreditMemoCreateParams,
   type CreditMemoRetrieveParams,
   type CreditMemoUpdateParams,
   type CreditMemoListParams,
   type CreditMemoDeleteParams,
+  type CreditMemoVoidParams,
   type CreditMemosCursorPage,
 } from './credit-memos';
 export {
@@ -168,6 +184,19 @@ export {
   type DeletedTransactionListResponse,
   type DeletedTransactionListParams,
 } from './deleted-transactions';
+export {
+  Deposits,
+  type Deposit,
+  type DepositDeleteResponse,
+  type DepositVoidResponse,
+  type DepositCreateParams,
+  type DepositRetrieveParams,
+  type DepositUpdateParams,
+  type DepositListParams,
+  type DepositDeleteParams,
+  type DepositVoidParams,
+  type DepositsCursorPage,
+} from './deposits';
 export {
   DiscountItems,
   type DiscountItem,
@@ -202,11 +231,13 @@ export {
   type InventoryAdjustment,
   type InventoryAdjustmentListResponse,
   type InventoryAdjustmentDeleteResponse,
+  type InventoryAdjustmentVoidResponse,
   type InventoryAdjustmentCreateParams,
   type InventoryAdjustmentRetrieveParams,
   type InventoryAdjustmentUpdateParams,
   type InventoryAdjustmentListParams,
   type InventoryAdjustmentDeleteParams,
+  type InventoryAdjustmentVoidParams,
 } from './inventory-adjustments';
 export {
   InventoryAssemblyItems,
@@ -239,11 +270,13 @@ export {
   Invoices,
   type Invoice,
   type InvoiceDeleteResponse,
+  type InvoiceVoidResponse,
   type InvoiceCreateParams,
   type InvoiceRetrieveParams,
   type InvoiceUpdateParams,
   type InvoiceListParams,
   type InvoiceDeleteParams,
+  type InvoiceVoidParams,
   type InvoicesCursorPage,
 } from './invoices';
 export {
@@ -259,11 +292,13 @@ export {
   ItemReceipts,
   type ItemReceipt,
   type ItemReceiptDeleteResponse,
+  type ItemReceiptVoidResponse,
   type ItemReceiptCreateParams,
   type ItemReceiptRetrieveParams,
   type ItemReceiptUpdateParams,
   type ItemReceiptListParams,
   type ItemReceiptDeleteParams,
+  type ItemReceiptVoidParams,
   type ItemReceiptsCursorPage,
 } from './item-receipts';
 export {
@@ -277,11 +312,13 @@ export {
   JournalEntries,
   type JournalEntry,
   type JournalEntryDeleteResponse,
+  type JournalEntryVoidResponse,
   type JournalEntryCreateParams,
   type JournalEntryRetrieveParams,
   type JournalEntryUpdateParams,
   type JournalEntryListParams,
   type JournalEntryDeleteParams,
+  type JournalEntryVoidParams,
   type JournalEntriesCursorPage,
 } from './journal-entries';
 export {
@@ -319,6 +356,12 @@ export {
   type PaymentMethodRetrieveParams,
   type PaymentMethodListParams,
 } from './payment-methods';
+export {
+  PaymentsToDeposit,
+  type PaymentToDeposit,
+  type PaymentsToDepositListResponse,
+  type PaymentsToDepositListParams,
+} from './payments-to-deposit';
 export {
   PayrollWageItems,
   type PayrollWageItem,
@@ -375,11 +418,13 @@ export {
   SalesReceipts,
   type SalesReceipt,
   type SalesReceiptDeleteResponse,
+  type SalesReceiptVoidResponse,
   type SalesReceiptCreateParams,
   type SalesReceiptRetrieveParams,
   type SalesReceiptUpdateParams,
   type SalesReceiptListParams,
   type SalesReceiptDeleteParams,
+  type SalesReceiptVoidParams,
   type SalesReceiptsCursorPage,
 } from './sales-receipts';
 export {
@@ -483,11 +528,13 @@ export {
   VendorCredits,
   type VendorCredit,
   type VendorCreditDeleteResponse,
+  type VendorCreditVoidResponse,
   type VendorCreditCreateParams,
   type VendorCreditRetrieveParams,
   type VendorCreditUpdateParams,
   type VendorCreditListParams,
   type VendorCreditDeleteParams,
+  type VendorCreditVoidParams,
   type VendorCreditsCursorPage,
 } from './vendor-credits';
 export {

package/src/resources/qbd/inventory-adjustments.ts

@@ -63,6 +63,10 @@ export class InventoryAdjustments extends APIResource {
   /**
    * Updates an existing inventory adjustment.
    *
+   * **NOTE:** If you include `lines`, QuickBooks Desktop replaces that line list
+   * with the array you send, so include unchanged lines you want to keep and use
+   * `id: "-1"` for new lines.
+   *
    * @example
    * ```ts
    * const inventoryAdjustment =
@@ -89,9 +93,11 @@ export class InventoryAdjustments extends APIResource {
   }
 
   /**
-   * Returns a list of inventory adjustments. NOTE: QuickBooks Desktop does not
-   * support pagination for inventory adjustments; hence, there is no `cursor`
-   * parameter. Users typically have few inventory adjustments.
+   * Returns a list of inventory adjustments.
+   *
+   * **NOTE:** QuickBooks Desktop does not support pagination for inventory
+   * adjustments; hence, there is no `cursor` parameter. Users typically have few
+   * inventory adjustments.
    *
    * @example
    * ```ts
@@ -138,6 +144,32 @@ export class InventoryAdjustments extends APIResource {
       headers: buildHeaders([{ 'Conductor-End-User-Id': conductorEndUserId }, options?.headers]),
     });
   }
+
+  /**
+   * Voids an inventory adjustment by setting its amount to zero while keeping a
+   * record of it in QuickBooks. The void will fail if the inventory adjustment is
+   * currently in use or has any linked transactions that are in use.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await conductor.qbd.inventoryAdjustments.void(
+   *     '123ABC-1234567890',
+   *     { conductorEndUserId: 'end_usr_1234567abcdefg' },
+   *   );
+   * ```
+   */
+  void(
+    id: string,
+    params: InventoryAdjustmentVoidParams,
+    options?: RequestOptions,
+  ): APIPromise<InventoryAdjustmentVoidResponse> {
+    const { conductorEndUserId } = params;
+    return this._client.post(path`/quickbooks-desktop/inventory-adjustments/${id}/void`, {
+      ...options,
+      headers: buildHeaders([{ 'Conductor-End-User-Id': conductorEndUserId }, options?.headers]),
+    });
+  }
 }
 
 export interface InventoryAdjustment {
@@ -506,6 +538,43 @@ export interface InventoryAdjustmentDeleteResponse {
   refNumber: string | null;
 }
 
+export interface InventoryAdjustmentVoidResponse {
+  /**
+   * The QuickBooks-assigned unique identifier of the voided inventory adjustment.
+   */
+  id: string;
+
+  /**
+   * The date and time when this inventory adjustment was created, in ISO 8601 format
+   * (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the local
+   * timezone of the end-user's computer.
+   */
+  createdAt: string | null;
+
+  /**
+   * The type of object. This value is always `"qbd_inventory_adjustment"`.
+   */
+  objectType: 'qbd_inventory_adjustment';
+
+  /**
+   * The case-sensitive user-defined reference number of the voided inventory
+   * adjustment.
+   */
+  refNumber: string | null;
+
+  /**
+   * The date and time when this inventory adjustment was last updated, in ISO 8601
+   * format (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the
+   * local timezone of the end-user's computer.
+   */
+  updatedAt: string | null;
+
+  /**
+   * Indicates whether the inventory adjustment was voided.
+   */
+  voided: boolean;
+}
+
 export interface InventoryAdjustmentCreateParams {
   /**
    * Body param: The account to which this inventory adjustment is posted for
@@ -1072,15 +1141,24 @@ export interface InventoryAdjustmentDeleteParams {
   conductorEndUserId: string;
 }
 
+export interface InventoryAdjustmentVoidParams {
+  /**
+   * The ID of the End-User to receive this request.
+   */
+  conductorEndUserId: string;
+}
+
 export declare namespace InventoryAdjustments {
   export {
     type InventoryAdjustment as InventoryAdjustment,
     type InventoryAdjustmentListResponse as InventoryAdjustmentListResponse,
     type InventoryAdjustmentDeleteResponse as InventoryAdjustmentDeleteResponse,
+    type InventoryAdjustmentVoidResponse as InventoryAdjustmentVoidResponse,
     type InventoryAdjustmentCreateParams as InventoryAdjustmentCreateParams,
     type InventoryAdjustmentRetrieveParams as InventoryAdjustmentRetrieveParams,
     type InventoryAdjustmentUpdateParams as InventoryAdjustmentUpdateParams,
     type InventoryAdjustmentListParams as InventoryAdjustmentListParams,
     type InventoryAdjustmentDeleteParams as InventoryAdjustmentDeleteParams,
+    type InventoryAdjustmentVoidParams as InventoryAdjustmentVoidParams,
   };
 }

package/src/resources/qbd/inventory-sites.ts

@@ -82,9 +82,10 @@ export class InventorySites extends APIResource {
   }
 
   /**
-   * Returns a list of inventory sites. NOTE: QuickBooks Desktop does not support
-   * pagination for inventory sites; hence, there is no `cursor` parameter. Users
-   * typically have few inventory sites.
+   * Returns a list of inventory sites.
+   *
+   * **NOTE:** QuickBooks Desktop does not support pagination for inventory sites;
+   * hence, there is no `cursor` parameter. Users typically have few inventory sites.
    *
    * @example
    * ```ts

package/src/resources/qbd/invoices.ts

@@ -58,6 +58,10 @@ export class Invoices extends APIResource {
   /**
    * Updates an existing invoice.
    *
+   * **NOTE:** If you include `lines` or `lineGroups`, QuickBooks Desktop replaces
+   * each included line list with the array you send, so include unchanged lines you
+   * want to keep and use `id: "-1"` for new lines.
+   *
    * @example
    * ```ts
    * const invoice = await conductor.qbd.invoices.update(
@@ -124,6 +128,27 @@ export class Invoices extends APIResource {
       headers: buildHeaders([{ 'Conductor-End-User-Id': conductorEndUserId }, options?.headers]),
     });
   }
+
+  /**
+   * Voids an invoice by setting its amount to zero while keeping a record of it in
+   * QuickBooks. The void will fail if the invoice is currently in use or has any
+   * linked transactions that are in use.
+   *
+   * @example
+   * ```ts
+   * const response = await conductor.qbd.invoices.void(
+   *   '123ABC-1234567890',
+   *   { conductorEndUserId: 'end_usr_1234567abcdefg' },
+   * );
+   * ```
+   */
+  void(id: string, params: InvoiceVoidParams, options?: RequestOptions): APIPromise<InvoiceVoidResponse> {
+    const { conductorEndUserId } = params;
+    return this._client.post(path`/quickbooks-desktop/invoices/${id}/void`, {
+      ...options,
+      headers: buildHeaders([{ 'Conductor-End-User-Id': conductorEndUserId }, options?.headers]),
+    });
+  }
 }
 
 export type InvoicesCursorPage = CursorPage<Invoice>;
@@ -1760,6 +1785,42 @@ export interface InvoiceDeleteResponse {
   refNumber: string | null;
 }
 
+export interface InvoiceVoidResponse {
+  /**
+   * The QuickBooks-assigned unique identifier of the voided invoice.
+   */
+  id: string;
+
+  /**
+   * The date and time when this invoice was created, in ISO 8601 format
+   * (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the local
+   * timezone of the end-user's computer.
+   */
+  createdAt: string | null;
+
+  /**
+   * The type of object. This value is always `"qbd_invoice"`.
+   */
+  objectType: 'qbd_invoice';
+
+  /**
+   * The case-sensitive user-defined reference number of the voided invoice.
+   */
+  refNumber: string | null;
+
+  /**
+   * The date and time when this invoice was last updated, in ISO 8601 format
+   * (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the local
+   * timezone of the end-user's computer.
+   */
+  updatedAt: string | null;
+
+  /**
+   * Indicates whether the invoice was voided.
+   */
+  voided: boolean;
+}
+
 export interface InvoiceCreateParams {
   /**
    * Body param: The customer or customer-job associated with this invoice.
@@ -3464,15 +3525,24 @@ export interface InvoiceDeleteParams {
   conductorEndUserId: string;
 }
 
+export interface InvoiceVoidParams {
+  /**
+   * The ID of the End-User to receive this request.
+   */
+  conductorEndUserId: string;
+}
+
 export declare namespace Invoices {
   export {
     type Invoice as Invoice,
     type InvoiceDeleteResponse as InvoiceDeleteResponse,
+    type InvoiceVoidResponse as InvoiceVoidResponse,
     type InvoicesCursorPage as InvoicesCursorPage,
     type InvoiceCreateParams as InvoiceCreateParams,
     type InvoiceRetrieveParams as InvoiceRetrieveParams,
     type InvoiceUpdateParams as InvoiceUpdateParams,
     type InvoiceListParams as InvoiceListParams,
     type InvoiceDeleteParams as InvoiceDeleteParams,
+    type InvoiceVoidParams as InvoiceVoidParams,
   };
 }

package/src/resources/qbd/item-receipts.ts

@@ -63,6 +63,10 @@ export class ItemReceipts extends APIResource {
   /**
    * Updates an existing item receipt.
    *
+   * **NOTE:** If you include `expenseLines`, `itemLines`, or `itemGroupLines`,
+   * QuickBooks Desktop replaces each included line list with the array you send, so
+   * include unchanged lines you want to keep and use `id: "-1"` for new lines.
+   *
    * @example
    * ```ts
    * const itemReceipt = await conductor.qbd.itemReceipts.update(
@@ -132,6 +136,31 @@ export class ItemReceipts extends APIResource {
       headers: buildHeaders([{ 'Conductor-End-User-Id': conductorEndUserId }, options?.headers]),
     });
   }
+
+  /**
+   * Voids an item receipt by setting its amount to zero while keeping a record of it
+   * in QuickBooks. The void will fail if the item receipt is currently in use or has
+   * any linked transactions that are in use.
+   *
+   * @example
+   * ```ts
+   * const response = await conductor.qbd.itemReceipts.void(
+   *   '123ABC-1234567890',
+   *   { conductorEndUserId: 'end_usr_1234567abcdefg' },
+   * );
+   * ```
+   */
+  void(
+    id: string,
+    params: ItemReceiptVoidParams,
+    options?: RequestOptions,
+  ): APIPromise<ItemReceiptVoidResponse> {
+    const { conductorEndUserId } = params;
+    return this._client.post(path`/quickbooks-desktop/item-receipts/${id}/void`, {
+      ...options,
+      headers: buildHeaders([{ 'Conductor-End-User-Id': conductorEndUserId }, options?.headers]),
+    });
+  }
 }
 
 export type ItemReceiptsCursorPage = CursorPage<ItemReceipt>;
@@ -1625,6 +1654,42 @@ export interface ItemReceiptDeleteResponse {
   refNumber: string | null;
 }
 
+export interface ItemReceiptVoidResponse {
+  /**
+   * The QuickBooks-assigned unique identifier of the voided item receipt.
+   */
+  id: string;
+
+  /**
+   * The date and time when this item receipt was created, in ISO 8601 format
+   * (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the local
+   * timezone of the end-user's computer.
+   */
+  createdAt: string | null;
+
+  /**
+   * The type of object. This value is always `"qbd_item_receipt"`.
+   */
+  objectType: 'qbd_item_receipt';
+
+  /**
+   * The case-sensitive user-defined reference number of the voided item receipt.
+   */
+  refNumber: string | null;
+
+  /**
+   * The date and time when this item receipt was last updated, in ISO 8601 format
+   * (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the local
+   * timezone of the end-user's computer.
+   */
+  updatedAt: string | null;
+
+  /**
+   * Indicates whether the item receipt was voided.
+   */
+  voided: boolean;
+}
+
 export interface ItemReceiptCreateParams {
   /**
    * Body param: The date of this item receipt, in ISO 8601 format (YYYY-MM-DD).
@@ -2843,15 +2908,24 @@ export interface ItemReceiptDeleteParams {
   conductorEndUserId: string;
 }
 
+export interface ItemReceiptVoidParams {
+  /**
+   * The ID of the End-User to receive this request.
+   */
+  conductorEndUserId: string;
+}
+
 export declare namespace ItemReceipts {
   export {
     type ItemReceipt as ItemReceipt,
     type ItemReceiptDeleteResponse as ItemReceiptDeleteResponse,
+    type ItemReceiptVoidResponse as ItemReceiptVoidResponse,
     type ItemReceiptsCursorPage as ItemReceiptsCursorPage,
     type ItemReceiptCreateParams as ItemReceiptCreateParams,
     type ItemReceiptRetrieveParams as ItemReceiptRetrieveParams,
     type ItemReceiptUpdateParams as ItemReceiptUpdateParams,
     type ItemReceiptListParams as ItemReceiptListParams,
     type ItemReceiptDeleteParams as ItemReceiptDeleteParams,
+    type ItemReceiptVoidParams as ItemReceiptVoidParams,
   };
 }