conductor-node 12.32.0 → 12.34.0

package/src/resources/qbd/credit-memos.ts

@@ -294,9 +294,7 @@ export interface CreditMemo {
    * default A/R account.
    *
    * **IMPORTANT**: If this credit memo is linked to other transactions, this A/R
-   * account must match the `receivablesAccount` used in all linked transactions. For
-   * example, when refunding a credit card payment, the A/R account must match the
-   * one used in the original credit transactions being refunded.
+   * account must match the `receivablesAccount` used in all linked transactions.
    */
   receivablesAccount: CreditMemo.ReceivablesAccount | null;
 
@@ -1476,11 +1474,37 @@ export namespace CreditMemo {
     transactionDate: string;
 
     /**
-     * The type of transaction for this linked transaction. The output for this field
-     * is a raw string, not an enum, because in rare cases QuickBooks Desktop may
-     * return a value outside its own schema, which we pass through unchanged.
-     */
-    transactionType: string;
+     * The type of transaction for this linked transaction.
+     */
+    transactionType:
+      | 'ar_refund_credit_card'
+      | 'bill'
+      | 'bill_payment_check'
+      | 'bill_payment_credit_card'
+      | 'build_assembly'
+      | 'charge'
+      | 'check'
+      | 'credit_card_charge'
+      | 'credit_card_credit'
+      | 'credit_memo'
+      | 'deposit'
+      | 'estimate'
+      | 'inventory_adjustment'
+      | 'invoice'
+      | 'item_receipt'
+      | 'journal_entry'
+      | 'liability_adjustment'
+      | 'paycheck'
+      | 'payroll_liability_check'
+      | 'purchase_order'
+      | 'receive_payment'
+      | 'sales_order'
+      | 'sales_receipt'
+      | 'sales_tax_payment_check'
+      | 'transfer'
+      | 'vendor_credit'
+      | 'ytd_adjustment'
+      | 'unknown';
   }
 
   /**
@@ -1489,9 +1513,7 @@ export namespace CreditMemo {
    * default A/R account.
    *
    * **IMPORTANT**: If this credit memo is linked to other transactions, this A/R
-   * account must match the `receivablesAccount` used in all linked transactions. For
-   * example, when refunding a credit card payment, the A/R account must match the
-   * one used in the original credit transactions being refunded.
+   * account must match the `receivablesAccount` used in all linked transactions.
    */
   export interface ReceivablesAccount {
     /**
@@ -1826,9 +1848,7 @@ export interface CreditMemoCreateParams {
    * will use its default A/R account.
    *
    * **IMPORTANT**: If this credit memo is linked to other transactions, this A/R
-   * account must match the `receivablesAccount` used in all linked transactions. For
-   * example, when refunding a credit card payment, the A/R account must match the
-   * one used in the original credit transactions being refunded.
+   * account must match the `receivablesAccount` used in all linked transactions.
    */
   receivablesAccountId?: string;
 
@@ -2435,9 +2455,7 @@ export interface CreditMemoUpdateParams {
    * will use its default A/R account.
    *
    * **IMPORTANT**: If this credit memo is linked to other transactions, this A/R
-   * account must match the `receivablesAccount` used in all linked transactions. For
-   * example, when refunding a credit card payment, the A/R account must match the
-   * one used in the original credit transactions being refunded.
+   * account must match the `receivablesAccount` used in all linked transactions.
    */
   receivablesAccountId?: string;
 

package/src/resources/qbd/date-driven-terms.ts

@@ -5,7 +5,10 @@ import * as Core from "../../core.js";
 
 export class DateDrivenTerms extends APIResource {
   /**
-   * Creates a new date-driven term.
+   * Creates a date-driven term that sets the payment due on a specific day of the
+   * month and can optionally grant an early-payment discount before
+   * `discountDayOfMonth`. Use it when you need due dates tied to calendar days
+   * instead of a fixed number of days after the transaction.
    *
    * @example
    * ```ts

package/src/resources/qbd/discount-items.ts

@@ -6,7 +6,10 @@ import { CursorPage, type CursorPageParams } from "../../pagination.js";
 
 export class DiscountItems extends APIResource {
   /**
-   * Creates a new discount item.
+   * Creates a discount item that subtracts either a percentage or fixed amount from
+   * transaction totals. Percentage discounts only affect the preceding line, while
+   * fixed-amount discounts reduce the accumulated amount above them unless you bound
+   * the target lines with a subtotal item.
    *
    * @example
    * ```ts
@@ -52,7 +55,9 @@ export class DiscountItems extends APIResource {
   }
 
   /**
-   * Updates an existing discount item.
+   * Updates a discount item, including its linked account or discount rate. When
+   * changing the account, use `updateExistingTransactionsAccount` to control whether
+   * existing transactions that reference the item should also be updated.
    *
    * @example
    * ```ts

package/src/resources/qbd/employees.ts

@@ -5,7 +5,9 @@ import * as Core from "../../core.js";
 
 export class Employees extends APIResource {
   /**
-   * Creates a new employee.
+   * Creates an employee record that captures personal details, contact information,
+   * employment dates, and payroll settings in a single request so the employee is
+   * ready for scheduling, time tracking, and payroll processing.
    *
    * @example
    * ```ts
@@ -47,7 +49,9 @@ export class Employees extends APIResource {
   }
 
   /**
-   * Updates an existing employee.
+   * Updates an employee record, allowing you to revise contact details, employment
+   * status dates, supervisory assignments, payroll configuration, and additional
+   * notes to keep workforce data current.
    *
    * @example
    * ```ts

package/src/resources/qbd/estimates.ts

@@ -1409,11 +1409,37 @@ export namespace Estimate {
     transactionDate: string;
 
     /**
-     * The type of transaction for this linked transaction. The output for this field
-     * is a raw string, not an enum, because in rare cases QuickBooks Desktop may
-     * return a value outside its own schema, which we pass through unchanged.
-     */
-    transactionType: string;
+     * The type of transaction for this linked transaction.
+     */
+    transactionType:
+      | 'ar_refund_credit_card'
+      | 'bill'
+      | 'bill_payment_check'
+      | 'bill_payment_credit_card'
+      | 'build_assembly'
+      | 'charge'
+      | 'check'
+      | 'credit_card_charge'
+      | 'credit_card_credit'
+      | 'credit_memo'
+      | 'deposit'
+      | 'estimate'
+      | 'inventory_adjustment'
+      | 'invoice'
+      | 'item_receipt'
+      | 'journal_entry'
+      | 'liability_adjustment'
+      | 'paycheck'
+      | 'payroll_liability_check'
+      | 'purchase_order'
+      | 'receive_payment'
+      | 'sales_order'
+      | 'sales_receipt'
+      | 'sales_tax_payment_check'
+      | 'transfer'
+      | 'vendor_credit'
+      | 'ytd_adjustment'
+      | 'unknown';
   }
 
   /**

package/src/resources/qbd/index.ts

@@ -101,6 +101,16 @@ export {
   type CreditCardCreditListParams,
   type CreditCardCreditDeleteParams,
 } from "./credit-card-credits.js";
+export {
+  CreditCardRefundsCursorPage,
+  CreditCardRefunds,
+  type CreditCardRefund,
+  type CreditCardRefundDeleteResponse,
+  type CreditCardRefundCreateParams,
+  type CreditCardRefundRetrieveParams,
+  type CreditCardRefundListParams,
+  type CreditCardRefundDeleteParams,
+} from "./credit-card-refunds.js";
 export {
   CreditMemosCursorPage,
   CreditMemos,

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

@@ -5,7 +5,9 @@ import * as Core from "../../core.js";
 
 export class InventoryAdjustments extends APIResource {
   /**
-   * Creates a new inventory adjustment.
+   * Creates an inventory adjustment to correct on-hand quantities or values.
+   * QuickBooks requires single-user mode unless you're on Enterprise with Advanced
+   * Inventory enabled.
    *
    * @example
    * ```ts

package/src/resources/qbd/inventory-assembly-items.ts

@@ -6,7 +6,7 @@ import { CursorPage, type CursorPageParams } from "../../pagination.js";
 
 export class InventoryAssemblyItems extends APIResource {
   /**
-   * Creates a new inventory assembly item.
+   * Creates an inventory assembly item that bundles existing inventory items.
    *
    * @example
    * ```ts
@@ -57,7 +57,9 @@ export class InventoryAssemblyItems extends APIResource {
   }
 
   /**
-   * Updates an existing inventory assembly item.
+   * Updates an inventory assembly item. If you change the income account, set
+   * `updateExistingTransactionsIncomeAccount` to true so QuickBooks applies the new
+   * account to existing transactions that use the assembly.
    *
    * @example
    * ```ts

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

@@ -54,7 +54,9 @@ export class InventoryItems extends APIResource {
   }
 
   /**
-   * Updates an existing inventory item.
+   * Updates an inventory item. If you switch the income account, set
+   * `updateExistingTransactionsIncomeAccount` to true so QuickBooks applies the new
+   * account to existing transactions that reference the item.
    *
    * @example
    * ```ts

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

@@ -5,7 +5,8 @@ import * as Core from "../../core.js";
 
 export class InventorySites extends APIResource {
   /**
-   * Creates a new inventory site.
+   * Creates an inventory site for companies using QuickBooks Enterprise with
+   * Advanced Inventory.
    *
    * @example
    * ```ts

package/src/resources/qbd/invoices.ts

@@ -6,7 +6,8 @@ import { CursorPage, type CursorPageParams } from "../../pagination.js";
 
 export class Invoices extends APIResource {
   /**
-   * Creates a new invoice.
+   * Creates an invoice to bill a customer when goods or services were delivered
+   * before payment. Use a sales receipt instead if the sale was paid in full.
    *
    * @example
    * ```ts
@@ -305,9 +306,7 @@ export interface Invoice {
    * A/R account.
    *
    * **IMPORTANT**: If this invoice is linked to other transactions, this A/R account
-   * must match the `receivablesAccount` used in all linked transactions. For
-   * example, when refunding a credit card payment, the A/R account must match the
-   * one used in the original credit transactions being refunded.
+   * must match the `receivablesAccount` used in all linked transactions.
    */
   receivablesAccount: Invoice.ReceivablesAccount | null;
 
@@ -1498,11 +1497,37 @@ export namespace Invoice {
     transactionDate: string;
 
     /**
-     * The type of transaction for this linked transaction. The output for this field
-     * is a raw string, not an enum, because in rare cases QuickBooks Desktop may
-     * return a value outside its own schema, which we pass through unchanged.
-     */
-    transactionType: string;
+     * The type of transaction for this linked transaction.
+     */
+    transactionType:
+      | 'ar_refund_credit_card'
+      | 'bill'
+      | 'bill_payment_check'
+      | 'bill_payment_credit_card'
+      | 'build_assembly'
+      | 'charge'
+      | 'check'
+      | 'credit_card_charge'
+      | 'credit_card_credit'
+      | 'credit_memo'
+      | 'deposit'
+      | 'estimate'
+      | 'inventory_adjustment'
+      | 'invoice'
+      | 'item_receipt'
+      | 'journal_entry'
+      | 'liability_adjustment'
+      | 'paycheck'
+      | 'payroll_liability_check'
+      | 'purchase_order'
+      | 'receive_payment'
+      | 'sales_order'
+      | 'sales_receipt'
+      | 'sales_tax_payment_check'
+      | 'transfer'
+      | 'vendor_credit'
+      | 'ytd_adjustment'
+      | 'unknown';
   }
 
   /**
@@ -1511,9 +1536,7 @@ export namespace Invoice {
    * A/R account.
    *
    * **IMPORTANT**: If this invoice is linked to other transactions, this A/R account
-   * must match the `receivablesAccount` used in all linked transactions. For
-   * example, when refunding a credit card payment, the A/R account must match the
-   * one used in the original credit transactions being refunded.
+   * must match the `receivablesAccount` used in all linked transactions.
    */
   export interface ReceivablesAccount {
     /**
@@ -1900,9 +1923,7 @@ export interface InvoiceCreateParams {
    * will use its default A/R account.
    *
    * **IMPORTANT**: If this invoice is linked to other transactions, this A/R account
-   * must match the `receivablesAccount` used in all linked transactions. For
-   * example, when refunding a credit card payment, the A/R account must match the
-   * one used in the original credit transactions being refunded.
+   * must match the `receivablesAccount` used in all linked transactions.
    */
   receivablesAccountId?: string;
 
@@ -2633,9 +2654,7 @@ export interface InvoiceUpdateParams {
    * will use its default A/R account.
    *
    * **IMPORTANT**: If this invoice is linked to other transactions, this A/R account
-   * must match the `receivablesAccount` used in all linked transactions. For
-   * example, when refunding a credit card payment, the A/R account must match the
-   * one used in the original credit transactions being refunded.
+   * must match the `receivablesAccount` used in all linked transactions.
    */
   receivablesAccountId?: string;
 

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

@@ -6,7 +6,10 @@ import { CursorPage, type CursorPageParams } from "../../pagination.js";
 
 export class ItemReceipts extends APIResource {
   /**
-   * Creates a new item receipt.
+   * Creates an item receipt to record inventory received from a vendor. You can link
+   * it to a purchase order during creation to pull in the order's lines
+   * automatically and update quantities, but that link can't be added later with an
+   * update.
    *
    * @example
    * ```ts
@@ -1498,11 +1501,37 @@ export namespace ItemReceipt {
     transactionDate: string;
 
     /**
-     * The type of transaction for this linked transaction. The output for this field
-     * is a raw string, not an enum, because in rare cases QuickBooks Desktop may
-     * return a value outside its own schema, which we pass through unchanged.
-     */
-    transactionType: string;
+     * The type of transaction for this linked transaction.
+     */
+    transactionType:
+      | 'ar_refund_credit_card'
+      | 'bill'
+      | 'bill_payment_check'
+      | 'bill_payment_credit_card'
+      | 'build_assembly'
+      | 'charge'
+      | 'check'
+      | 'credit_card_charge'
+      | 'credit_card_credit'
+      | 'credit_memo'
+      | 'deposit'
+      | 'estimate'
+      | 'inventory_adjustment'
+      | 'invoice'
+      | 'item_receipt'
+      | 'journal_entry'
+      | 'liability_adjustment'
+      | 'paycheck'
+      | 'payroll_liability_check'
+      | 'purchase_order'
+      | 'receive_payment'
+      | 'sales_order'
+      | 'sales_receipt'
+      | 'sales_tax_payment_check'
+      | 'transfer'
+      | 'vendor_credit'
+      | 'ytd_adjustment'
+      | 'unknown';
   }
 
   /**

package/src/resources/qbd/journal-entries.ts

@@ -6,7 +6,10 @@ import { CursorPage, type CursorPageParams } from "../../pagination.js";
 
 export class JournalEntries extends APIResource {
   /**
-   * Creates a new journal entry.
+   * Creates a journal entry with balanced debit and credit lines. QuickBooks Desktop
+   * requires total debits to equal total credits, and any line that posts to
+   * Accounts Receivable or Accounts Payable must include the related customer or
+   * vendor reference.
    *
    * @example
    * ```ts
@@ -51,7 +54,9 @@ export class JournalEntries extends APIResource {
   }
 
   /**
-   * Updates an existing journal entry.
+   * Updates an existing journal entry. Keep the debits and credits in balance, and
+   * include the related customer or vendor on any A/R or A/P line you submit in the
+   * update body.
    *
    * @example
    * ```ts

package/src/resources/qbd/non-inventory-items.ts

@@ -54,7 +54,12 @@ export class NonInventoryItems extends APIResource {
   }
 
   /**
-   * Updates an existing non-inventory item.
+   * Updates a non-inventory item. You can modify either `salesOrPurchaseDetails` or
+   * `salesAndPurchaseDetails`, but the item must keep the same configuration it was
+   * created with. When you change `postingAccount`, `incomeAccount`, or
+   * `expenseAccount`, include the matching `updateExistingTransactions...` flag so
+   * QuickBooks applies the new account to existing transactions and doesn’t reject
+   * the update when historical activity is present.
    *
    * @example
    * ```ts

package/src/resources/qbd/purchase-orders.ts

@@ -1392,11 +1392,37 @@ export namespace PurchaseOrder {
     transactionDate: string;
 
     /**
-     * The type of transaction for this linked transaction. The output for this field
-     * is a raw string, not an enum, because in rare cases QuickBooks Desktop may
-     * return a value outside its own schema, which we pass through unchanged.
-     */
-    transactionType: string;
+     * The type of transaction for this linked transaction.
+     */
+    transactionType:
+      | 'ar_refund_credit_card'
+      | 'bill'
+      | 'bill_payment_check'
+      | 'bill_payment_credit_card'
+      | 'build_assembly'
+      | 'charge'
+      | 'check'
+      | 'credit_card_charge'
+      | 'credit_card_credit'
+      | 'credit_memo'
+      | 'deposit'
+      | 'estimate'
+      | 'inventory_adjustment'
+      | 'invoice'
+      | 'item_receipt'
+      | 'journal_entry'
+      | 'liability_adjustment'
+      | 'paycheck'
+      | 'payroll_liability_check'
+      | 'purchase_order'
+      | 'receive_payment'
+      | 'sales_order'
+      | 'sales_receipt'
+      | 'sales_tax_payment_check'
+      | 'transfer'
+      | 'vendor_credit'
+      | 'ytd_adjustment'
+      | 'unknown';
   }
 
   /**

package/src/resources/qbd/qbd.ts

@@ -114,6 +114,17 @@ import {
   CreditCardCredits,
   CreditCardCreditsCursorPage,
 } from "./credit-card-credits.js";
+import * as CreditCardRefundsAPI from "./credit-card-refunds.js";
+import {
+  CreditCardRefund,
+  CreditCardRefundCreateParams,
+  CreditCardRefundDeleteParams,
+  CreditCardRefundDeleteResponse,
+  CreditCardRefundListParams,
+  CreditCardRefundRetrieveParams,
+  CreditCardRefunds,
+  CreditCardRefundsCursorPage,
+} from "./credit-card-refunds.js";
 import * as CreditMemosAPI from "./credit-memos.js";
 import {
   CreditMemo,
@@ -547,6 +558,9 @@ export class Qbd extends APIResource {
   creditCardCredits: CreditCardCreditsAPI.CreditCardCredits = new CreditCardCreditsAPI.CreditCardCredits(
     this._client,
   );
+  creditCardRefunds: CreditCardRefundsAPI.CreditCardRefunds = new CreditCardRefundsAPI.CreditCardRefunds(
+    this._client,
+  );
   creditMemos: CreditMemosAPI.CreditMemos = new CreditMemosAPI.CreditMemos(this._client);
   currencies: CurrenciesAPI.Currencies = new CurrenciesAPI.Currencies(this._client);
   customers: CustomersAPI.Customers = new CustomersAPI.Customers(this._client);
@@ -670,6 +684,8 @@ Qbd.CreditCardCharges = CreditCardCharges;
 Qbd.CreditCardChargesCursorPage = CreditCardChargesCursorPage;
 Qbd.CreditCardCredits = CreditCardCredits;
 Qbd.CreditCardCreditsCursorPage = CreditCardCreditsCursorPage;
+Qbd.CreditCardRefunds = CreditCardRefunds;
+Qbd.CreditCardRefundsCursorPage = CreditCardRefundsCursorPage;
 Qbd.CreditMemos = CreditMemos;
 Qbd.CreditMemosCursorPage = CreditMemosCursorPage;
 Qbd.Currencies = Currencies;
@@ -860,6 +876,17 @@ export declare namespace Qbd {
     type CreditCardCreditDeleteParams as CreditCardCreditDeleteParams,
   };
 
+  export {
+    CreditCardRefunds as CreditCardRefunds,
+    type CreditCardRefund as CreditCardRefund,
+    type CreditCardRefundDeleteResponse as CreditCardRefundDeleteResponse,
+    CreditCardRefundsCursorPage as CreditCardRefundsCursorPage,
+    type CreditCardRefundCreateParams as CreditCardRefundCreateParams,
+    type CreditCardRefundRetrieveParams as CreditCardRefundRetrieveParams,
+    type CreditCardRefundListParams as CreditCardRefundListParams,
+    type CreditCardRefundDeleteParams as CreditCardRefundDeleteParams,
+  };
+
   export {
     CreditMemos as CreditMemos,
     type CreditMemo as CreditMemo,