nxus-qbd 0.3.0 → 0.3.2

package/dist/generated/types.gen.d.ts

@@ -18,13 +18,22 @@ export type Account = {
      * The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive. Parent:Child:SubChild
      */
     fullName?: string | null;
-    parent?: QbdRef;
+    /**
+     * The short name of the account as it appears in the QuickBooks UI.
+     */
+    parent?: QbdRef | null;
     /**
      * Depth level of the account in the hierarchy (0 for top level).
      */
     sublevel?: number;
-    accountType?: NullableAccountType;
-    specialAccountType?: NullableSpecialAccountType;
+    /**
+     * The specific type of the account.
+     */
+    accountType?: NullableAccountType | null;
+    /**
+     * Special sub-classification for the account.
+     */
+    specialAccountType?: NullableSpecialAccountType | null;
     /**
      * Whether the account is a tax account (optional, default: false)
      * Only set to true for accounts that track tax liabilities/expenses
@@ -44,10 +53,21 @@ export type Account = {
     description?: string | null;
     balance?: number | null;
     totalBalance?: number | null;
-    salesTaxCode?: QbdRef;
-    taxLineDetails?: TaxLineInfo;
-    cashFlowClassification?: NullableCashFlowClassification;
-    currency?: QbdRef;
+    /**
+     * Reference to the associated Sales Tax Code.
+     * Derived from SalesTaxCodeRef.
+     */
+    salesTaxCode?: QbdRef | null;
+    taxLineDetails?: TaxLineInfo | null;
+    /**
+     * Cash flow classification for the account.
+     */
+    cashFlowClassification?: NullableCashFlowClassification | null;
+    /**
+     * Reference to the currency associated with the account.
+     * Derived from CurrencyRef.
+     */
+    currency?: QbdRef | null;
     /**
      * Whether the account is active (default: true)
      */
@@ -194,7 +214,7 @@ export type AddressRequest = {
 export type ApiResponseReport = {
     success?: boolean;
     message?: string | null;
-    data?: Report;
+    data?: Report | null;
     timestamp?: string;
     requestId?: string | null;
 };
@@ -208,17 +228,17 @@ export type ApplicableCredit = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     exchangeRate?: number | null;
     refNumber?: string | null;
     memo?: string | null;
     transactionType?: string | null;
-    payablesAccount?: QbdRef;
+    payablesAccount?: QbdRef | null;
     creditRemaining?: number | null;
     creditRemainingInHomeCurrency?: number | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
     linkedTransactions?: Array<LinkedTransaction> | null;
@@ -293,8 +313,14 @@ export type AppliedToTxn = {
      * The discount amount given on the applied-to transaction.
      */
     discountAmount?: number | null;
-    discountAccount?: QbdRef;
-    discountClass?: QbdRef;
+    /**
+     * Reference to the discount account used.
+     */
+    discountAccount?: QbdRef | null;
+    /**
+     * Reference to the class used for the discount.
+     */
+    discountClass?: QbdRef | null;
     linkedTransactions?: Array<LinkedTransaction> | null;
     /**
      * Credits applied to this transaction.
@@ -364,7 +390,7 @@ export type ArRefundCreditCard = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * (Optional) The exchange rate for the transaction.
      */
@@ -378,18 +404,21 @@ export type ArRefundCreditCard = {
      */
     memo?: string | null;
     transactionNumber?: number | null;
-    receivablesAccount?: QbdRef;
-    address?: Address;
-    addressBlock?: AddressBlock;
-    paymentMethod?: QbdRef;
-    creditCardTransaction?: CreditCardTransactionInfo;
+    receivablesAccount?: QbdRef | null;
+    /**
+     * (Optional) Address details for the refund.
+     */
+    address?: Address | null;
+    addressBlock?: AddressBlock | null;
+    paymentMethod?: QbdRef | null;
+    creditCardTransaction?: CreditCardTransactionInfo | null;
     /**
      * (Required) List of credit transactions (e.g., Credit Memos) to apply this refund to.
      */
     refundAppliedToTxns?: Array<RefundAppliedToTransaction> | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -1783,9 +1812,16 @@ export type Bill = {
     updatedAt: string;
     revisionNumber: string;
     transactionNumber?: number | null;
-    vendor?: QbdRef;
-    vendorAddress?: Address;
-    payablesAccount?: QbdRef;
+    /**
+     * The vendor who issued the bill. When linking to a Purchase Order, this vendor
+     * must match the vendor on the Purchase Order.
+     */
+    vendor?: QbdRef | null;
+    /**
+     * The billing address of the vendor.
+     */
+    vendorAddress?: Address | null;
+    payablesAccount?: QbdRef | null;
     transactionDate?: string | null;
     /**
      * The date by which the bill must be paid.
@@ -1795,7 +1831,7 @@ export type Bill = {
      * The total monetary amount of the bill.
      */
     amountDue?: number;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * Exchange rate for multi-currency transactions (v8.0).
      */
@@ -1813,13 +1849,23 @@ export type Bill = {
      * Indicates whether the bill is currently marked as pending.
      */
     isPending?: boolean | null;
-    terms?: QbdRef;
-    class?: QbdRef;
+    /**
+     * The payment terms associated with the bill (e.g., Net 30), which calculate the DueDate.
+     */
+    terms?: QbdRef | null;
+    /**
+     * The class associated with the bill, used for categorizing expenses and reporting
+     * (requires class tracking to be enabled in QuickBooks).
+     */
+    class?: QbdRef | null;
     /**
      * Memo/description for the bill.
      */
     memo?: string | null;
-    salesTaxCode?: QbdRef;
+    /**
+     * The sales tax code indicating the general taxability of the bill (e.g., Tax, Non).
+     */
+    salesTaxCode?: QbdRef | null;
     /**
      * Indicates whether the bill has been paid in full and closed.
      */
@@ -1829,7 +1875,7 @@ export type Bill = {
      * Indicates whether the amounts in the bill already include sales tax.
      */
     isTaxIncluded?: boolean | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
     linkedTransactions?: Array<LinkedTransaction> | null;
@@ -1906,7 +1952,10 @@ export type BillingRateItemRequest = {
  * Represents a custom rate or percentage adjustment applied to a specific service item within a billing rate [2, 4].
  */
 export type BillingRatePerItem = {
-    item?: QbdRef;
+    /**
+     * A reference to the specific service item this custom rate applies to [4, 5].
+     */
+    item?: QbdRef | null;
     /**
      * A fixed hourly rate for this specific service item that overrides the item's standard rate [6].
      */
@@ -1926,8 +1975,8 @@ export type BillPaymentOrCredit = {
     createdAt: string;
     updatedAt: string;
     revisionNumber: string;
-    bill?: PayableBill;
-    credit?: ApplicableCredit;
+    bill?: PayableBill | null;
+    credit?: ApplicableCredit | null;
     customFields?: Array<QbdDataExt> | null;
 };
 /**
@@ -1940,7 +1989,7 @@ export type BuildAssembly = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     exchangeRate?: number | null;
     /**
      * (Optional) The reference number for the build.
@@ -1954,9 +2003,12 @@ export type BuildAssembly = {
      * The internal transaction number.
      */
     txnNumber?: number | null;
-    itemInventoryAssembly?: QbdRef;
-    inventorySite?: QbdRef;
-    inventorySiteLocation?: QbdRef;
+    /**
+     * Reference to the Inventory Assembly Item being built.
+     */
+    itemInventoryAssembly?: QbdRef | null;
+    inventorySite?: QbdRef | null;
+    inventorySiteLocation?: QbdRef | null;
     /**
      * (Optional) Serial number for the built assembly.
      */
@@ -1982,8 +2034,8 @@ export type BuildAssembly = {
     quantityOnSalesOrder?: number | null;
     lines?: Array<ComponentItemLine> | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -1999,7 +2051,7 @@ export type BuildAssembly = {
  */
 export type CashBackInfo = {
     transactionLineId?: string | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     /**
      * (Optional) Memo about the cash back line. (Max 4095 characters)
      */
@@ -2039,7 +2091,7 @@ export type Charge = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     exchangeRate?: number | null;
     /**
      * (Optional) The reference number.
@@ -2047,10 +2099,10 @@ export type Charge = {
     refNumber?: string | null;
     memo?: string | null;
     txnNumber?: number | null;
-    customer?: QbdRef;
-    item?: QbdRef;
-    inventorySite?: QbdRef;
-    inventorySiteLocation?: QbdRef;
+    customer?: QbdRef | null;
+    item?: QbdRef | null;
+    inventorySite?: QbdRef | null;
+    inventorySiteLocation?: QbdRef | null;
     /**
      * (Optional) Quantity of the item.
      */
@@ -2059,8 +2111,8 @@ export type Charge = {
      * (Optional) Unit of measure.
      */
     unitOfMeasure?: string | null;
-    overrideUnitOfMeasureSet?: QbdRef;
-    overrideItemAccount?: QbdRef;
+    overrideUnitOfMeasureSet?: QbdRef | null;
+    overrideItemAccount?: QbdRef | null;
     /**
      * (Optional) The rate or price per unit.
      */
@@ -2070,8 +2122,8 @@ export type Charge = {
      * (Optional) Description of the charge.
      */
     description?: string | null;
-    receivablesAccount?: QbdRef;
-    class?: QbdRef;
+    receivablesAccount?: QbdRef | null;
+    class?: QbdRef | null;
     /**
      * (Optional) The date the charge was billed.
      */
@@ -2085,8 +2137,8 @@ export type Charge = {
      * (Optional) The total amount of the charge.
      */
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -2107,7 +2159,7 @@ export type Check = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * Exchange rate (for multi-currency)
      */
@@ -2120,19 +2172,22 @@ export type Check = {
      * Memo/description for the check
      */
     memo?: string | null;
-    address?: Address;
+    /**
+     * Payee address (optional)
+     */
+    address?: Address | null;
     isPending?: boolean | null;
     isQueuedForPrint?: boolean;
     /**
      * If true, the amount includes sales tax.
      */
     isTaxIncluded?: boolean | null;
-    salesTaxCode?: QbdRef;
+    salesTaxCode?: QbdRef | null;
     isVoid?: boolean;
     transactionNumber?: number | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -2176,7 +2231,7 @@ export type CheckBill = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * (Optional) The currency exchange rate.
      */
@@ -2193,9 +2248,15 @@ export type CheckBill = {
      */
     memo?: string | null;
     transactionNumber?: number | null;
-    payablesAccount?: QbdRef;
-    address?: Address;
-    addressBlock?: AddressBlock;
+    payablesAccount?: QbdRef | null;
+    /**
+     * The payee's full address.
+     */
+    address?: Address | null;
+    /**
+     * The address block formatted for printing on the check.
+     */
+    addressBlock?: AddressBlock | null;
     isQueuedForPrint?: boolean | null;
     /**
      * (Required) List of transactions (bills) to apply this check to.
@@ -2206,8 +2267,8 @@ export type CheckBill = {
      * (Optional) The total amount of the check.
      */
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     /**
      * (Optional) The amount in the home currency.
      */
@@ -2240,7 +2301,7 @@ export type Class = {
      * The FullName is the name prefixed by the names of each ancestor, for example Parent:Child:SubClass. FullName values are not case-sensitive.
      */
     fullName?: string | null;
-    parent?: QbdRef;
+    parent?: QbdRef | null;
     /**
      * A number indicating the number of ancestors. For example, The customer job with Name = carpets and FullName = Jones:Building2:carpets would have a sublevel of 2.
      */
@@ -2257,9 +2318,12 @@ export type Class = {
  */
 export type ComponentItemLine = {
     objectType?: string;
-    item?: QbdRef;
-    inventorySite?: QbdRef;
-    inventorySiteLocation?: QbdRef;
+    /**
+     * The Inventory Assembly item being created.
+     */
+    item?: QbdRef | null;
+    inventorySite?: QbdRef | null;
+    inventorySiteLocation?: QbdRef | null;
     serialNumber?: string | null;
     lotNumber?: string | null;
     expirationDateForSerialLotNumber?: string | null;
@@ -2488,7 +2552,10 @@ export type CreateArRefundCreditCardRequest = {
      * (Optional) The reference number for the refund.
      */
     refNumber?: string | null;
-    address?: AddressRequest;
+    /**
+     * (Optional) Address details for the refund.
+     */
+    address?: AddressRequest | null;
     /**
      * (Optional) The ListID or FullName of the payment method.
      */
@@ -2497,7 +2564,7 @@ export type CreateArRefundCreditCardRequest = {
      * (Optional) A memo for the transaction.
      */
     memo?: string | null;
-    creditCardTransaction?: CreditCardTransactionInfo;
+    creditCardTransaction?: CreditCardTransactionInfo | null;
     /**
      * (Optional) The exchange rate for the transaction.
      */
@@ -2562,7 +2629,10 @@ export type CreateBillRequest = {
      * Filter by Vendor ID.
      */
     vendorId: string;
-    vendorAddress?: AddressRequest;
+    /**
+     * Optional vendor address override.
+     */
+    vendorAddress?: AddressRequest | null;
     payablesAccountId?: string | null;
     transactionDate: string;
     /**
@@ -2823,7 +2893,10 @@ export type CreateCheckRequest = {
      * The ListID or FullName of the sales tax code.
      */
     salesTaxCodeId?: string | null;
-    address?: Address;
+    /**
+     * Payee address (optional)
+     */
+    address?: Address | null;
     /**
      * Exchange rate (for multi-currency)
      */
@@ -3068,8 +3141,8 @@ export type CreateCreditCardTransactionInputInfoRequest = {
     creditCardAddress?: string | null;
     creditCardPostalCode?: string | null;
     commercialCardCode?: string | null;
-    transactionMode?: NullableTransactionMode;
-    creditCardTxnType?: NullableCreditCardTransactionType;
+    transactionMode?: NullableTransactionMode | null;
+    creditCardTxnType?: NullableCreditCardTransactionType | null;
 };
 /**
  * Results from the payment gateway for a Credit Card transaction.
@@ -3082,9 +3155,9 @@ export type CreateCreditCardTransactionResultInfoRequest = {
     paymentStatus: PaymentStatus;
     txnAuthorizationTime: string;
     authorizationCode?: string | null;
-    avsStreet?: NullableAvsStreet;
-    avsZip?: NullableAvsZip;
-    cardSecurityCodeMatch?: NullableCardSecurityCodeMatch;
+    avsStreet?: NullableAvsStreet | null;
+    avsZip?: NullableAvsZip | null;
+    cardSecurityCodeMatch?: NullableCardSecurityCodeMatch | null;
     reconBatchId?: string | null;
     paymentGroupingCode?: number | null;
     txnAuthorizationStamp?: number | null;
@@ -3188,7 +3261,7 @@ export type CreateCreditMemoLineRequest = {
     overrideItemAccountId?: string | null;
     otherCustomField1?: string | null;
     otherCustomField2?: string | null;
-    creditCardTransactionInfo?: CreateCreditCardTransactionInfoRequest;
+    creditCardTransactionInfo?: CreateCreditCardTransactionInfoRequest | null;
     customFields?: Array<DataExtRequest> | null;
 };
 /**
@@ -3216,8 +3289,8 @@ export type CreateCreditMemoRequest = {
      * (Optional) The reference number (e.g., Credit Memo #).
      */
     refNumber?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     /**
      * (Optional) Indicates if the credit memo is pending.
      */
@@ -3295,7 +3368,10 @@ export type CreateCurrencyRequest = {
      * (Required) The three-letter currency code (e.g., USD, EUR). Values are normalized to trimmed uppercase. (Max 3 characters)
      */
     currencyCode: string;
-    currencyFormat?: CurrencyFormatRequest;
+    /**
+     * (Optional) Specifies the formatting rules for the currency.
+     */
+    currencyFormat?: CurrencyFormatRequest | null;
     externalId?: string | null;
 };
 /**
@@ -3312,8 +3388,8 @@ export type CreateCustomerRequest = {
     middleName?: string | null;
     lastName?: string | null;
     jobTitle?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     shippingAddresses?: Array<ShipToAddressRequest> | null;
     phone?: string | null;
     altPhone?: string | null;
@@ -3336,8 +3412,11 @@ export type CreateCustomerRequest = {
     accountNumber?: string | null;
     creditLimit?: number | null;
     preferredPaymentMethodId?: string | null;
-    creditCardInfo?: CreditCardInfo;
-    jobStatus?: NullableJobStatus;
+    creditCardInfo?: CreditCardInfo | null;
+    /**
+     * JobStatus may have one of the following values: Awarded, Closed, InProgress, None [DEFAULT], NotAwarded, Pending
+     */
+    jobStatus?: NullableJobStatus | null;
     jobStartDate?: string | null;
     jobProjectedEndDate?: string | null;
     jobEndDate?: string | null;
@@ -3394,8 +3473,16 @@ export type CreateDateDrivenTermRequest = {
  * Defines a single Deposit Line item to be added to the Deposit (uses discriminator pattern).
  */
 export type CreateDepositLineRequest = {
-    paymentLine?: DepositPaymentLineRequest;
-    manualLine?: DepositManualLineRequest;
+    /**
+     * (Optional) Details for depositing a previously recorded payment (ReceivePayment, SalesReceipt).
+     * Mutually exclusive with ManualLine.
+     */
+    paymentLine?: DepositPaymentLineRequest | null;
+    /**
+     * (Optional) Details for manually depositing a fund from another source.
+     * Mutually exclusive with PaymentLine.
+     */
+    manualLine?: DepositManualLineRequest | null;
 };
 /**
  * After you receive payments from customers (see ReceivePayment), you can use
@@ -3415,7 +3502,10 @@ export type CreateDepositRequest = {
      * (Optional) General memo about the Deposit. (Max 4095 characters)
      */
     memo?: string | null;
-    cashBackInfo?: CashBackInfoRequest;
+    /**
+     * (Optional) Information about cash back requested from the deposit total.
+     */
+    cashBackInfo?: CashBackInfoRequest | null;
     /**
      * (Optional) The ListID or FullName of the currency for the transaction.
      * Follows the Flattened-ID Pattern for CurrencyRef.
@@ -3450,7 +3540,7 @@ export type CreateEmployeeRequest = {
     supervisorId?: string | null;
     department?: string | null;
     description?: string | null;
-    employeeAddress?: EmployeeAddress;
+    employeeAddress?: EmployeeAddress | null;
     printAs?: string | null;
     phone?: string | null;
     mobile?: string | null;
@@ -3464,7 +3554,10 @@ export type CreateEmployeeRequest = {
      * Additional contact references (may repeat, v12.0+).
      */
     additionalContacts?: Array<AdditionalContact> | null;
-    emergencyContacts?: EmergencyContact;
+    /**
+     * Emergency contacts for the employee (QBD only, v13.0+).
+     */
+    emergencyContacts?: EmergencyContact | null;
     /**
      * Additional notes (may repeat, v12.0+). For Add, only Note is needed.
      */
@@ -3494,7 +3587,7 @@ export type CreateEmployeeRequest = {
     workAuthExpireDate?: string | null;
     usVeteran?: string | null;
     militaryStatus?: string | null;
-    employeePayrollInfo?: EmployeePayrollInfo;
+    employeePayrollInfo?: EmployeePayrollInfo | null;
     externalId?: string | null;
     suffix?: string | null;
 };
@@ -3575,8 +3668,8 @@ export type CreateEstimateRequest = {
      * (Optional) The sequential reference number for the Estimate (e.g., Estimate Number). (STRTYPE)
      */
     refNumber?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     /**
      * (Optional) Whether the Estimate is active. (BOOLTYPE)
      */
@@ -3685,10 +3778,10 @@ export type CreateExpenseLineRequest = {
 export type CreateInventoryAdjustmentLineRequest = {
     itemId: string;
     memo?: string | null;
-    quantityAdjustment?: QuantityAdjustmentRequest;
-    valueAdjustment?: ValueAdjustmentRequest;
-    serialNumberAdjustment?: SerialNumberAdjustmentRequest;
-    lotNumberAdjustment?: LotNumberAdjustmentRequest;
+    quantityAdjustment?: QuantityAdjustmentRequest | null;
+    valueAdjustment?: ValueAdjustmentRequest | null;
+    serialNumberAdjustment?: SerialNumberAdjustmentRequest | null;
+    lotNumberAdjustment?: LotNumberAdjustmentRequest | null;
 };
 /**
  * A request model for adding a new Inventory Adjustment transaction.
@@ -3736,7 +3829,7 @@ export type CreateInventoryAdjustmentRequest = {
  */
 export type CreateInventoryItemRequest = {
     name: string;
-    barcode?: BarCodeRequest;
+    barcode?: BarCodeRequest | null;
     classId?: string | null;
     parentId?: string | null;
     sku?: string | null;
@@ -3769,7 +3862,7 @@ export type CreateInventorySiteRequest = {
     phone?: string | null;
     fax?: string | null;
     email?: string | null;
-    address?: AddressRequest;
+    address?: AddressRequest | null;
     externalId?: string | null;
 };
 /**
@@ -3795,8 +3888,8 @@ export type CreateInvoiceRequest = {
      * Reference number for the invoice.
      */
     refNumber?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     isPending?: boolean | null;
     isFinanceCharge?: boolean | null;
     purchaseOrderNumber?: string | null;
@@ -3912,7 +4005,7 @@ export type CreateItemGroupLineRequest = {
  */
 export type CreateItemGroupRequest = {
     name: string;
-    barCode?: BarCodeRequest;
+    barCode?: BarCodeRequest | null;
     description?: string | null;
     isActive?: boolean | null;
     unitOfMeasureSetId?: string | null;
@@ -3932,7 +4025,7 @@ export type CreateItemInventoryAssemblyRequest = {
     incomeAccountId?: string | null;
     assetAccountId: string | null;
     cogsAccountId?: string | null;
-    barCode?: BarCodeRequest;
+    barCode?: BarCodeRequest | null;
     isActive?: boolean | null;
     classId?: string | null;
     parentId?: string | null;
@@ -4027,7 +4120,7 @@ export type CreateItemLineRequest = {
      * (Optional) Overrides the default income/expense account associated with the item.
      */
     overrideItemAccountId?: string | null;
-    linkToTransaction?: LinkToTransactionLineRequest;
+    linkToTransaction?: LinkToTransactionLineRequest | null;
     salesRepresentativeId?: string | null;
     customFields?: Array<DataExtRequest> | null;
 };
@@ -4036,7 +4129,7 @@ export type CreateItemLineRequest = {
  */
 export type CreateItemNonInventoryRequest = {
     name: string;
-    barcode?: BarCodeRequest;
+    barcode?: BarCodeRequest | null;
     isActive?: boolean | null;
     classId?: string | null;
     parentId?: string | null;
@@ -4044,8 +4137,8 @@ export type CreateItemNonInventoryRequest = {
     unitOfMeasureSetId?: string | null;
     isTaxIncluded?: boolean | null;
     salesTaxCodeId?: string | null;
-    salesOrPurchaseDetails?: ItemNonInventorySalesOrPurchaseDetailsRequest;
-    salesAndPurchaseDetails?: ItemNonInventorySalesAndPurchaseDetailsRequest;
+    salesOrPurchaseDetails?: ItemNonInventorySalesOrPurchaseDetailsRequest | null;
+    salesAndPurchaseDetails?: ItemNonInventorySalesAndPurchaseDetailsRequest | null;
     externalId?: string | null;
 };
 /**
@@ -4053,7 +4146,7 @@ export type CreateItemNonInventoryRequest = {
  */
 export type CreateItemOtherChargeRequest = {
     name: string;
-    barcode?: BarCodeRequest;
+    barcode?: BarCodeRequest | null;
     isActive?: boolean | null;
     classId?: string | null;
     className?: string | null;
@@ -4061,8 +4154,8 @@ export type CreateItemOtherChargeRequest = {
     parentName?: string | null;
     isTaxIncluded?: boolean | null;
     salesTaxCodeId?: string | null;
-    salesOrPurchaseDetails?: ItemOtherChargeSalesOrPurchaseDetailsRequest;
-    salesAndPurchaseDetails?: ItemOtherChargeSalesAndPurchaseDetailsRequest;
+    salesOrPurchaseDetails?: ItemOtherChargeSalesOrPurchaseDetailsRequest | null;
+    salesAndPurchaseDetails?: ItemOtherChargeSalesAndPurchaseDetailsRequest | null;
     externalId?: string | null;
 };
 /**
@@ -4137,7 +4230,7 @@ export type CreateItemReceiptRequest = {
  */
 export type CreateItemSalesTaxGroupRequest = {
     name: string;
-    barCode?: BarCodeRequest;
+    barCode?: BarCodeRequest | null;
     isActive?: boolean | null;
     description?: string | null;
     externalId?: string | null;
@@ -4153,7 +4246,10 @@ export type CreateItemSalesTaxRequest = {
      * (Required) The name or identifier for the new sales tax item.
      */
     name: string;
-    barcode?: BarCodeRequest;
+    /**
+     * (Optional) BarCode information.
+     */
+    barcode?: BarCodeRequest | null;
     /**
      * (Optional) Indicates whether the sales tax item is active.
      */
@@ -4194,7 +4290,7 @@ export type CreateItemSubtotalRequest = {
     name: string;
     isActive?: boolean | null;
     barCodeValue?: string | null;
-    barCode?: BarCodeRequest;
+    barCode?: BarCodeRequest | null;
     externalId?: string | null;
 };
 /**
@@ -4270,8 +4366,8 @@ export type CreateOtherNameRequest = {
     firstName?: string | null;
     middleName?: string | null;
     lastName?: string | null;
-    address?: Address;
-    addressBlock?: AddressBlock;
+    address?: Address | null;
+    addressBlock?: AddressBlock | null;
     phone?: string | null;
     alternatPhone?: string | null;
     fax?: string | null;
@@ -4472,8 +4568,14 @@ export type CreatePurchaseOrderRequest = {
      * (Optional) The document number. (Max 11 characters)
      */
     refNumber?: string | null;
-    vendorAddress?: AddressRequest;
-    shipAddress?: AddressRequest;
+    /**
+     * (Optional) The primary address for the Vendor on this Purchase Order.
+     */
+    vendorAddress?: AddressRequest | null;
+    /**
+     * (Optional) The shipping address for the Purchase Order.
+     */
+    shipAddress?: AddressRequest | null;
     /**
      * (Optional) The ListID or FullName of the payment terms.
      * Follows the Flattened-ID Pattern for TermsRef.
@@ -4556,7 +4658,7 @@ export type CreateReceivePaymentRequest = {
      * Account to deposit the payment into.
      */
     depositToAccountId?: string | null;
-    creditCardTransactionInfo?: CreditCardTxnInfoRequest;
+    creditCardTransactionInfo?: CreditCardTxnInfoRequest | null;
     externalId?: string | null;
     /**
      * If true, QuickBooks will automatically apply the payment to outstanding invoices.
@@ -4670,7 +4772,7 @@ export type CreateSalesReceiptLineRequest = {
     salesTaxCodeId?: string | null;
     otherCustomField1?: string | null;
     otherCustomField2?: string | null;
-    creditCardTransaction?: CreateCreditCardTransactionInfoRequest;
+    creditCardTransaction?: CreateCreditCardTransactionInfoRequest | null;
 };
 /**
  * A request model for adding a new Sales Receipt transaction.
@@ -4694,8 +4796,8 @@ export type CreateSalesReceiptRequest = {
      * (Optional) The document number (e.g., receipt number). (Max 11 characters)
      */
     refNumber?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     /**
      * (Optional) Indicates if the transaction is pending.
      */
@@ -4741,7 +4843,7 @@ export type CreateSalesReceiptRequest = {
      * (Optional) The ListID or FullName of the account to deposit the payment to.
      */
     depositToAccountId?: string | null;
-    creditCardTransaction?: CreateCreditCardTransactionInfoRequest;
+    creditCardTransaction?: CreateCreditCardTransactionInfoRequest | null;
     /**
      * (Optional) Exchange rate if this is a foreign currency Sales Receipt.
      */
@@ -4820,7 +4922,10 @@ export type CreateSalesTaxPaymentCheckRequest = {
      * (Optional) A memo for the transaction. Max 4095 chars.
      */
     memo?: string | null;
-    address?: AddressRequest;
+    /**
+     * (Optional) The address of the payee.
+     */
+    address?: AddressRequest | null;
     externalId?: string | null;
     /**
      * (Required) A list of sales tax items and the amounts being paid.
@@ -4829,7 +4934,7 @@ export type CreateSalesTaxPaymentCheckRequest = {
 };
 export type CreateServiceItemRequest = {
     name: string;
-    barCode?: BarCodeRequest;
+    barCode?: BarCodeRequest | null;
     externalId?: string | null;
     isActive?: boolean | null;
     classId?: string | null;
@@ -4839,8 +4944,8 @@ export type CreateServiceItemRequest = {
     forceUOMChange?: boolean | null;
     isTaxIncluded?: boolean | null;
     dataExt?: Array<QbdDataExt> | null;
-    salesOrPurchase?: CreateSalesOrPurchaseRequest;
-    salesAndPurchase?: CreateSalesAndPurchaseRequest;
+    salesOrPurchase?: CreateSalesOrPurchaseRequest | null;
+    salesAndPurchase?: CreateSalesAndPurchaseRequest | null;
 };
 /**
  * Represents the SetCredit aggregate in QBXML.
@@ -4894,7 +4999,10 @@ export type CreateSpecialItemRequest = {
      * Valid values: "FinanceCharge", "ReimbursableExpenseGroup", "ReimbursableExpenseSubtotal"
      */
     specialItemType: string;
-    barCode?: BarCodeRequest;
+    /**
+     * (Optional) Bar Code details for the special item.
+     */
+    barCode?: BarCodeRequest | null;
     externalId?: string | null;
 };
 /**
@@ -5053,8 +5161,8 @@ export type CreateVendorRequest = {
     middleName?: string | null;
     lastName?: string | null;
     jobTitle?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     phone?: string | null;
     alternatePhone?: string | null;
     fax?: string | null;
@@ -5154,7 +5262,7 @@ export type CreditCardBill = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * Exchange rate (required if currency is specified)
      */
@@ -5167,15 +5275,20 @@ export type CreditCardBill = {
      * Memo/description for the payment
      */
     memo?: string | null;
-    creditCardAccount?: QbdRef;
-    payablesAccount?: QbdRef;
+    /**
+     * Credit card account being charged (required)
+     * The credit card account to which this bill credit card payment is being charged.
+     * This bill credit card payment will decrease the balance of this account.
+     */
+    creditCardAccount?: QbdRef | null;
+    payablesAccount?: QbdRef | null;
     appliedToTransactions?: Array<AppliedToTxn> | null;
     /**
      * Total amount of the payment
      */
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -5195,16 +5308,16 @@ export type CreditCardCharge = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     exchangeRate?: number | null;
     refNumber?: string | null;
     memo?: string | null;
     transactionNumber?: string | null;
     isTaxIncluded?: boolean | null;
-    salesTaxCode?: QbdRef;
+    salesTaxCode?: QbdRef | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -5225,7 +5338,7 @@ export type CreditCardCredit = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * Exchange rate for multi-currency transactions (Optional).
      */
@@ -5244,10 +5357,13 @@ export type CreditCardCredit = {
      * Indicates if tax is included in the line items.
      */
     isTaxIncluded?: boolean | null;
-    salesTaxCode?: QbdRef;
+    /**
+     * Reference to the sales tax code.
+     */
+    salesTaxCode?: QbdRef | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -5307,8 +5423,11 @@ export type CreditCardTransactionInputInfo = {
      * (Optional) New commercial card code. (Max 4 characters)
      */
     commercialCardCode?: string | null;
-    transactionMode?: NullableTransactionMode;
-    transactionType?: NullableCreditCardTransactionType;
+    /**
+     * (Optional) New transaction mode (0 for CardNotPresent [DEFAULT], 1 for CardPresent).
+     */
+    transactionMode?: NullableTransactionMode | null;
+    transactionType?: NullableCreditCardTransactionType | null;
 };
 /**
  * DTO for credit card result details.
@@ -5319,9 +5438,9 @@ export type CreditCardTransactionResultInfo = {
     creditCardTransID: string;
     merchantAccountNumber: string;
     authorizationCode?: string | null;
-    avsStreet?: NullableAvsStreet;
-    avsZip?: NullableAvsZip;
-    cardSecurityCodeMatch?: NullableCardSecurityCodeMatch;
+    avsStreet?: NullableAvsStreet | null;
+    avsZip?: NullableAvsZip | null;
+    cardSecurityCodeMatch?: NullableCardSecurityCodeMatch | null;
     reconBatchID?: string | null;
     paymentGroupingCode?: number | null;
     paymentStatus: PaymentStatus;
@@ -5353,7 +5472,7 @@ export type CreditMemo = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * (Optional) The exchange rate for the transaction.
      */
@@ -5367,25 +5486,25 @@ export type CreditMemo = {
      */
     memo?: string | null;
     transactionNumber?: number | null;
-    customer?: QbdRef;
-    class?: QbdRef;
-    receivablesAccount?: QbdRef;
-    template?: QbdRef;
-    billingAddress?: Address;
-    billingAddressBlock?: AddressBlock;
-    shippingAddress?: Address;
-    shippingAddressBlock?: AddressBlock;
+    customer?: QbdRef | null;
+    class?: QbdRef | null;
+    receivablesAccount?: QbdRef | null;
+    template?: QbdRef | null;
+    billingAddress?: Address | null;
+    billingAddressBlock?: AddressBlock | null;
+    shippingAddress?: Address | null;
+    shippingAddressBlock?: AddressBlock | null;
     /**
      * (Optional) Indicates if the credit memo is pending.
      */
     isPending?: boolean | null;
     poNumber?: string | null;
-    terms?: QbdRef;
+    terms?: QbdRef | null;
     /**
      * (Optional) The due date.
      */
     dueDate?: string | null;
-    salesRepresentative?: QbdRef;
+    salesRepresentative?: QbdRef | null;
     /**
      * (Optional) Free On Board (FOB) terms. (Max 13 characters)
      */
@@ -5394,15 +5513,15 @@ export type CreditMemo = {
      * (Optional) The date of shipment.
      */
     shipDate?: string | null;
-    shipMethod?: QbdRef;
+    shipMethod?: QbdRef | null;
     subtotal?: number | null;
-    itemSalesTax?: QbdRef;
+    itemSalesTax?: QbdRef | null;
     salesTaxPercentage?: number | null;
     salesTaxTotal?: number | null;
     totalAmount?: number | null;
     creditRemaining?: number | null;
     creditRemainingInHomeCurrency?: number | null;
-    customerMsg?: QbdRef;
+    customerMsg?: QbdRef | null;
     /**
      * (Optional) Indicates if the transaction is to be printed.
      */
@@ -5415,7 +5534,7 @@ export type CreditMemo = {
      * (Optional) Indicates if tax is included in the amounts.
      */
     isTaxIncluded?: boolean | null;
-    customerSalesTaxCode?: QbdRef;
+    customerSalesTaxCode?: QbdRef | null;
     /**
      * (Optional) Other custom field. (Max 29 characters)
      */
@@ -5426,8 +5545,8 @@ export type CreditMemo = {
     lines?: Array<CreditMemoLine> | null;
     lineGroups?: Array<CreditMemoLineGroup> | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
     linkedTransactions?: Array<LinkedTransaction> | null;
@@ -5443,7 +5562,7 @@ export type CreditMemo = {
 export type CreditMemoLine = {
     objectType?: string;
     id: string;
-    item?: QbdRef;
+    item?: QbdRef | null;
     /**
      * (Optional) Description of the line item.
      */
@@ -5456,7 +5575,7 @@ export type CreditMemoLine = {
      * (Optional) Unit of measure.
      */
     unitOfMeasure?: string | null;
-    overrideUnitOfMeasureSet?: QbdRef;
+    overrideUnitOfMeasureSet?: QbdRef | null;
     /**
      * (Optional) Rate or price per unit.
      */
@@ -5465,13 +5584,13 @@ export type CreditMemoLine = {
      * (Optional) Rate expressed as a percentage.
      */
     ratePercent?: number | null;
-    class?: QbdRef;
+    class?: QbdRef | null;
     /**
      * (Optional) Total amount for the line.
      */
     amount?: number | null;
-    inventorySite?: QbdRef;
-    inventorySiteLocation?: QbdRef;
+    inventorySite?: QbdRef | null;
+    inventorySiteLocation?: QbdRef | null;
     /**
      * (Optional) Serial number for the item.
      */
@@ -5485,10 +5604,10 @@ export type CreditMemoLine = {
      * (Optional) Service date for the item.
      */
     serviceDate?: string | null;
-    salesTaxCode?: QbdRef;
+    salesTaxCode?: QbdRef | null;
     otherCustomField1?: string | null;
     otherCustomField2?: string | null;
-    creditCardTransaction?: CreditCardTransactionInfo;
+    creditCardTransaction?: CreditCardTransactionInfo | null;
     customFields?: Array<QbdDataExt> | null;
 };
 /**
@@ -5498,7 +5617,7 @@ export type CreditMemoLine = {
 export type CreditMemoLineGroup = {
     id: string;
     objectType?: string;
-    itemGroup?: QbdRef;
+    itemGroup?: QbdRef | null;
     description?: string | null;
     /**
      * (Optional) Quantity of the group.
@@ -5508,7 +5627,7 @@ export type CreditMemoLineGroup = {
      * (Optional) Unit of measure.
      */
     unitOfMeasure?: string | null;
-    overrideUnitOfMeasureSet?: QbdRef;
+    overrideUnitOfMeasureSet?: QbdRef | null;
     shouldPrintItemsInGroup?: boolean | null;
     totalAmount?: number | null;
     /**
@@ -5535,7 +5654,10 @@ export type Currency = {
      * (Required) The three-letter currency code (e.g., USD, EUR). Values are normalized to trimmed uppercase. (Max 3 characters)
      */
     currencyCode?: string | null;
-    currencyFormat?: CurrencyFormat;
+    /**
+     * (Optional) Specifies the formatting rules for the currency.
+     */
+    currencyFormat?: CurrencyFormat | null;
     isUserDefinedCurrency?: boolean | null;
     exchangeRate?: number | null;
     asOfDate?: string | null;
@@ -5644,8 +5766,8 @@ export type Customer = {
      * Job title of the customer's primary contact.
      */
     jobTitle?: string | null;
-    billingAddress?: Address;
-    shippingAddress?: Address;
+    billingAddress?: Address | null;
+    shippingAddress?: Address | null;
     alternateShippingAddresses?: Array<ShipToAddress> | null;
     /**
      * Primary phone number for the customer.
@@ -5679,17 +5801,50 @@ export type Customer = {
      * Maps to Contacts in QbXML.
      */
     additionalContacts?: Array<Contact> | null;
-    class?: QbdRef;
-    parent?: QbdRef;
-    customerType?: QbdRef;
-    terms?: QbdRef;
-    salesRep?: QbdRef;
-    salesTaxCode?: QbdRef;
-    itemSalesTax?: QbdRef;
-    preferredPaymentMethod?: QbdRef;
-    jobType?: QbdRef;
-    priceLevel?: QbdRef;
-    currency?: QbdRef;
+    /**
+     * The class assigned to this customer for departmental tracking.
+     */
+    class?: QbdRef | null;
+    /**
+     * The parent customer or job this record belongs to (for sub-customers/jobs).
+     */
+    parent?: QbdRef | null;
+    /**
+     * The customer type category assigned to this customer.
+     */
+    customerType?: QbdRef | null;
+    /**
+     * The default payment terms for this customer (e.g., "Net 30").
+     */
+    terms?: QbdRef | null;
+    /**
+     * The sales representative assigned to this customer.
+     */
+    salesRep?: QbdRef | null;
+    /**
+     * The sales tax code that determines whether sales to this customer are taxable.
+     */
+    salesTaxCode?: QbdRef | null;
+    /**
+     * The default sales tax item applied to taxable sales for this customer.
+     */
+    itemSalesTax?: QbdRef | null;
+    /**
+     * The customer's preferred payment method.
+     */
+    preferredPaymentMethod?: QbdRef | null;
+    /**
+     * The type of job (used when this record represents a job under a customer).
+     */
+    jobType?: QbdRef | null;
+    /**
+     * The custom price level applied to sales for this customer.
+     */
+    priceLevel?: QbdRef | null;
+    /**
+     * The currency used for transactions with this customer (multi-currency files only).
+     */
+    currency?: QbdRef | null;
     /**
      * Current outstanding balance owed by this customer.
      */
@@ -5714,7 +5869,7 @@ export type Customer = {
      * Maximum credit limit extended to this customer.
      */
     creditLimit?: number | null;
-    creditCard?: CreditCardInfo;
+    creditCard?: CreditCardInfo | null;
     /**
      * Current status of the job (e.g., "InProgress", "Awarded", "Closed"). Applies when this record is a job.
      */
@@ -5773,7 +5928,7 @@ export type CustomerType = {
      * The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.
      */
     fullName?: string | null;
-    parent?: QbdRef;
+    parent?: QbdRef | null;
     sublevel?: number | null;
     /**
      * (Optional) If false, this Customer Type is inactive. Default is true.
@@ -5875,7 +6030,7 @@ export type Deposit = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * (Optional) Exchange rate if this is a foreign currency Deposit.
      */
@@ -5886,17 +6041,20 @@ export type Deposit = {
      */
     memo?: string | null;
     transactionNumber?: number | null;
-    depositToAccount?: QbdRef;
+    depositToAccount?: QbdRef | null;
     depositTotal?: number | null;
     depositTotalInHomeCurrency?: number | null;
-    cashBackInfo?: CashBackInfo;
+    /**
+     * (Optional) Information about cash back requested from the deposit total.
+     */
+    cashBackInfo?: CashBackInfo | null;
     /**
      * (Optional) A list of payment and manual lines making up the total deposit amount.
      */
     depositLines?: Array<DepositLine> | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -5914,12 +6072,12 @@ export type DepositLine = {
     transactionId?: string | null;
     transactionLineId?: string | null;
     paymentTransactionLineId?: string | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     memo?: string | null;
     checkNumber?: string | null;
-    paymentMethod?: QbdRef;
-    class?: QbdRef;
+    paymentMethod?: QbdRef | null;
+    class?: QbdRef | null;
     amount?: number | null;
 };
 /**
@@ -5987,8 +6145,14 @@ export type DictionaryStringString = {
     [key: string]: string;
 };
 export type EmergencyContact = {
-    primaryContact?: AdditionalContact;
-    secondaryContact?: AdditionalContact;
+    /**
+     * The employee's primary emergency contact.
+     */
+    primaryContact?: AdditionalContact | null;
+    /**
+     * The employee's secondary emergency contact.
+     */
+    secondaryContact?: AdditionalContact | null;
 };
 /**
  * Data transfer object for an employee.
@@ -6006,11 +6170,11 @@ export type Employee = {
     middleName?: string | null;
     lastName?: string | null;
     jobTitle?: string | null;
-    supervisor?: QbdRef;
+    supervisor?: QbdRef | null;
     department?: string | null;
     description?: string | null;
     targetBonus?: number | null;
-    employeeAddress?: EmployeeAddress;
+    employeeAddress?: EmployeeAddress | null;
     printAs?: string | null;
     phone?: string | null;
     mobile?: string | null;
@@ -6020,7 +6184,10 @@ export type Employee = {
     fax?: string | null;
     ssn?: string | null;
     email?: string | null;
-    emergencyContacts?: EmergencyContact;
+    /**
+     * Emergency contacts for the employee (QBD only, v13.0+).
+     */
+    emergencyContacts?: EmergencyContact | null;
     /**
      * Additional contact references (may repeat, v12.0+).
      */
@@ -6049,8 +6216,8 @@ export type Employee = {
     militaryStatus?: string | null;
     accountNumber?: string | null;
     notes?: string | null;
-    billingRate?: QbdRef;
-    employeePayrollInfo?: EmployeePayrollInfo;
+    billingRate?: QbdRef | null;
+    employeePayrollInfo?: EmployeePayrollInfo | null;
     externalId?: string | null;
     /**
      * The employee's name (required). This is the display name in QuickBooks.
@@ -6078,13 +6245,13 @@ export type EmployeeAddress = {
  */
 export type EmployeePayrollInfo = {
     payPeriod?: string | null;
-    paySchedule?: QbdRef;
-    class?: QbdRef;
+    paySchedule?: QbdRef | null;
+    class?: QbdRef | null;
     clearEarnings?: boolean | null;
     clearNonEarnings?: boolean | null;
     useTimeDataToCreatePaychecks?: string | null;
-    sickHours?: SickHours;
-    vacationHours?: VacationHours;
+    sickHours?: SickHours | null;
+    vacationHours?: VacationHours | null;
 };
 /**
  * Detailed error information conforming to the standardized error schema.
@@ -6133,7 +6300,7 @@ export type Estimate = {
      * (Optional) The date of the transaction. Cannot be cleared. (DATETYPE)
      */
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * (Optional) The exchange rate for multi-currency transactions. (FLOATTYPE)
      */
@@ -6147,11 +6314,11 @@ export type Estimate = {
      */
     memo?: string | null;
     transactionNumber?: number | null;
-    customer?: QbdRef;
-    class?: QbdRef;
-    template?: QbdRef;
-    billingAddress?: Address;
-    shippingAddress?: Address;
+    customer?: QbdRef | null;
+    class?: QbdRef | null;
+    template?: QbdRef | null;
+    billingAddress?: Address | null;
+    shippingAddress?: Address | null;
     /**
      * (Optional) Whether the Estimate is active. (BOOLTYPE)
      */
@@ -6160,22 +6327,22 @@ export type Estimate = {
      * (Optional) Customer's Purchase Order number. (STRTYPE)
      */
     poNumber?: string | null;
-    terms?: QbdRef;
+    terms?: QbdRef | null;
     /**
      * (Optional) The due date calculated from the terms. (DATETYPE)
      */
     dueDate?: string | null;
-    salesRepresentative?: QbdRef;
+    salesRepresentative?: QbdRef | null;
     /**
      * (Optional) Freight on Board term. (STRTYPE)
      */
     fob?: string | null;
     subtotal?: number | null;
-    itemSalesTax?: QbdRef;
+    itemSalesTax?: QbdRef | null;
     salesTaxPercentage?: number | null;
     salesTaxTotal?: number | null;
     totalAmountInHomeCurrency?: number | null;
-    customerMsg?: QbdRef;
+    customerMsg?: QbdRef | null;
     /**
      * (Optional) Whether the Estimate should be flagged to be emailed. (BOOLTYPE)
      */
@@ -6184,7 +6351,7 @@ export type Estimate = {
      * (Optional) Whether tax is included in the line item amounts. (BOOLTYPE)
      */
     isTaxIncluded?: boolean | null;
-    customerSalesTaxCode?: QbdRef;
+    customerSalesTaxCode?: QbdRef | null;
     linkedTransactions?: Array<LinkedTransaction> | null;
     itemLines?: Array<EstimateItemLine> | null;
     itemGroupLines?: Array<EstimateItemGroupLine> | null;
@@ -6193,8 +6360,8 @@ export type Estimate = {
      */
     other?: string | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
     expenseLines?: Array<ExpenseLine> | null;
@@ -6206,11 +6373,11 @@ export type Estimate = {
 export type EstimateItemGroupLine = {
     id: string;
     objectType?: string;
-    itemGroup?: QbdRef;
+    itemGroup?: QbdRef | null;
     description?: string | null;
     quantity?: number | null;
     unitOfMeasure?: string | null;
-    overrideUnitOfMeasureSet?: QbdRef;
+    overrideUnitOfMeasureSet?: QbdRef | null;
     isPrintItemsInGroup?: boolean | null;
     totalAmount?: number | null;
     itemLines?: Array<EstimateItemLine> | null;
@@ -6222,18 +6389,18 @@ export type EstimateItemGroupLine = {
 export type EstimateItemLine = {
     id: string;
     objectType?: string;
-    item?: QbdRef;
+    item?: QbdRef | null;
     description?: string | null;
     quantity?: number | null;
     unitOfMeasure?: string | null;
-    overrideUnitOfMeasureSet?: QbdRef;
+    overrideUnitOfMeasureSet?: QbdRef | null;
     rate?: number | null;
     ratePercent?: number | null;
-    class?: QbdRef;
+    class?: QbdRef | null;
     amount?: number | null;
-    inventorySite?: QbdRef;
-    inventorySiteLocation?: QbdRef;
-    salesTaxCode?: QbdRef;
+    inventorySite?: QbdRef | null;
+    inventorySiteLocation?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     markupRate?: number | null;
     markupRatePercent?: number | null;
     other?: string | null;
@@ -6246,7 +6413,10 @@ export type EstimateItemLine = {
 export type ExpenseLine = {
     id: string;
     objectType?: string;
-    account?: QbdRef;
+    /**
+     * Expense account (e.g., "Office Supplies")
+     */
+    account?: QbdRef | null;
     /**
      * (Optional) The amount of the expense line.
      */
@@ -6255,13 +6425,16 @@ export type ExpenseLine = {
      * (Optional) A memo specific to this line item.
      */
     memo?: string | null;
-    class?: QbdRef;
-    customer?: QbdRef;
-    salesRepresentative?: QbdRef;
-    salesTaxCode?: QbdRef;
+    class?: QbdRef | null;
+    customer?: QbdRef | null;
+    salesRepresentative?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     taxAmount?: number | null;
-    vendor?: QbdRef;
-    billableStatus?: NullableBillableStatus;
+    vendor?: QbdRef | null;
+    /**
+     * (Optional) Billable status (Billable, NotBillable, HasBeenBilled).
+     */
+    billableStatus?: NullableBillableStatus | null;
     customFields?: Array<QbdDataExt> | null;
 };
 /**
@@ -6297,7 +6470,7 @@ export type InventoryAdjustment = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     exchangeRate?: number | null;
     /**
      * (Optional) The document number. (Max 11 characters)
@@ -6308,13 +6481,13 @@ export type InventoryAdjustment = {
      */
     memo?: string | null;
     transactionNumber?: number | null;
-    account?: QbdRef;
-    inventorySite?: QbdRef;
-    customer?: QbdRef;
-    class?: QbdRef;
+    account?: QbdRef | null;
+    inventorySite?: QbdRef | null;
+    customer?: QbdRef | null;
+    class?: QbdRef | null;
     lines?: Array<InventoryAdjustmentLine> | null;
     amount?: number | null;
-    entity?: QbdRef;
+    entity?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -6330,12 +6503,12 @@ export type InventoryAdjustment = {
  */
 export type InventoryAdjustmentLine = {
     id: string;
-    item?: QbdRef;
+    item?: QbdRef | null;
     serialNumber?: string | null;
     serialNumberAddedOrRemoved?: string | null;
     lotNumber?: string | null;
     expirationDate?: string | null;
-    inventorySiteLocation?: QbdRef;
+    inventorySiteLocation?: QbdRef | null;
     quantityDifference?: number | null;
     valueDifference?: number | null;
     customFields?: Array<QbdDataExt> | null;
@@ -6358,13 +6531,13 @@ export type InventoryItem = {
     isTaxIncluded?: boolean | null;
     salesDesc?: string | null;
     salesPrice?: number | null;
-    incomeAccount?: QbdRef;
+    incomeAccount?: QbdRef | null;
     purchaseDesc?: string | null;
     purchaseCost?: number | null;
-    purchaseTaxCode?: QbdRef;
-    cogsAccount?: QbdRef;
-    preferredVendor?: QbdRef;
-    assetAccount?: QbdRef;
+    purchaseTaxCode?: QbdRef | null;
+    cogsAccount?: QbdRef | null;
+    preferredVendor?: QbdRef | null;
+    assetAccount?: QbdRef | null;
     reorderPoint?: number | null;
     max?: number | null;
     quantityOnHand?: number | null;
@@ -6373,11 +6546,11 @@ export type InventoryItem = {
     quantityOnSalesOrder?: number | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -6394,15 +6567,15 @@ export type InventorySite = {
     createdAt: string;
     updatedAt: string;
     revisionNumber: string;
-    parentSite?: QbdRef;
+    parentSite?: QbdRef | null;
     isDefaultSite?: boolean | null;
     siteDesc?: string | null;
     contact?: string | null;
     phone?: string | null;
     fax?: string | null;
     email?: string | null;
-    siteAddress?: Address;
-    siteAddressBlock?: AddressBlock;
+    siteAddress?: Address | null;
+    siteAddressBlock?: AddressBlock | null;
     isActive?: boolean;
     customFields?: Array<QbdDataExt> | null;
 };
@@ -6419,7 +6592,7 @@ export type Invoice = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     exchangeRate?: number | null;
     /**
      * Reference number for the invoice.
@@ -6429,30 +6602,42 @@ export type Invoice = {
      * Memo/description for the invoice.
      */
     memo?: string | null;
-    customer?: QbdRef;
-    class?: QbdRef;
-    receivablesAccount?: QbdRef;
-    template?: QbdRef;
+    /**
+     * The customer to whom the invoice is addressed.
+     */
+    customer?: QbdRef | null;
+    /**
+     * Class Reference.
+     */
+    class?: QbdRef | null;
+    receivablesAccount?: QbdRef | null;
+    /**
+     * Reference to the visual template (e.g., "Custom Invoice") used in QuickBooks.
+     */
+    template?: QbdRef | null;
     /**
      * The date the invoice is due.
      */
     dueDate?: string | null;
-    billingAddress?: Address;
-    shippingAddress?: Address;
+    billingAddress?: Address | null;
+    shippingAddress?: Address | null;
     isPending?: boolean | null;
     isFinanceCharge?: boolean | null;
     purchaseOrderNumber?: string | null;
-    terms?: QbdRef;
-    salesRepresentative?: QbdRef;
+    /**
+     * Reference to the payment terms (e.g., "Net 30") applied to this invoice.
+     */
+    terms?: QbdRef | null;
+    salesRepresentative?: QbdRef | null;
     shipmentOrigin?: string | null;
     shippingDate?: string | null;
-    shippingMethod?: QbdRef;
-    itemSalesTax?: QbdRef;
-    customerMsg?: QbdRef;
+    shippingMethod?: QbdRef | null;
+    itemSalesTax?: QbdRef | null;
+    customerMsg?: QbdRef | null;
     isQueuedForPrint?: boolean | null;
     isQueuedForEmail?: boolean | null;
     isTaxIncluded?: boolean | null;
-    customerSalesTaxCode?: QbdRef;
+    customerSalesTaxCode?: QbdRef | null;
     otherCustomField?: string | null;
     /**
      * The total of all line items, before sales tax.
@@ -6472,8 +6657,11 @@ export type Invoice = {
      */
     isPaid?: boolean | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    /**
+     * The Accounts Receivable (A/R) account associated with this invoice.
+     */
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -6533,14 +6721,14 @@ export type ItemDiscount = {
     itemDesc?: string | null;
     discountRate?: number | null;
     discountRatePercent?: number | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -6577,8 +6765,11 @@ export type ItemFixedAsset = {
      * The original purchase price or cost of acquiring the asset.
      */
     vendorOrPayeeName?: string | null;
-    assetAccount?: QbdRef;
-    salesInfo?: FixedAssetSalesInfo;
+    /**
+     * A reference to the specific Fixed Asset account in the Chart of Accounts used to track this asset's financial value.
+     */
+    assetAccount?: QbdRef | null;
+    salesInfo?: FixedAssetSalesInfo | null;
     /**
      * A general description of the fixed asset.
      */
@@ -6621,11 +6812,11 @@ export type ItemFixedAsset = {
     yearEndBookValue?: number | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -6646,11 +6837,11 @@ export type ItemGroup = {
     lines?: Array<ItemGroupLineDetail> | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -6662,7 +6853,7 @@ export type ItemGroup = {
 export type ItemGroupLine = {
     id: string;
     objectType?: string;
-    itemGroup?: QbdRef;
+    itemGroup?: QbdRef | null;
     description?: string | null;
     /**
      * (Optional) Quantity of the group. QuickBooks will multiply this by the group's internal quantities.
@@ -6681,7 +6872,7 @@ export type ItemGroupLine = {
  * Represents a line item detail request for ItemGroup operations.
  */
 export type ItemGroupLineDetail = {
-    item?: QbdRef;
+    item?: QbdRef | null;
     quantity?: number | null;
     unitOfMeasure?: string | null;
 };
@@ -6708,13 +6899,13 @@ export type ItemInventoryAssembly = {
     isTaxIncluded?: boolean | null;
     salesDescription?: string | null;
     salesPrice?: number | null;
-    incomeAccount?: QbdRef;
+    incomeAccount?: QbdRef | null;
     purchaseDescription?: string | null;
     purchaseCost?: number | null;
-    purchaseTaxCode?: QbdRef;
-    cogsAccount?: QbdRef;
-    preferredVendor?: QbdRef;
-    assetAccount?: QbdRef;
+    purchaseTaxCode?: QbdRef | null;
+    cogsAccount?: QbdRef | null;
+    preferredVendor?: QbdRef | null;
+    assetAccount?: QbdRef | null;
     buildPoint?: number | null;
     max?: number | null;
     quantityOnHand?: number | null;
@@ -6725,18 +6916,18 @@ export type ItemInventoryAssembly = {
     lines?: Array<ItemInventoryAssemblyLine> | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
     customFields?: Array<QbdDataExt> | null;
 };
 export type ItemInventoryAssemblyLine = {
-    inventoryItem?: QbdRef;
+    inventoryItem?: QbdRef | null;
     quantity?: number | null;
 };
 /**
@@ -6758,13 +6949,13 @@ export type ItemInventoryItem = {
     isTaxIncluded?: boolean | null;
     salesDesc?: string | null;
     salesPrice?: number | null;
-    incomeAccount?: QbdRef;
+    incomeAccount?: QbdRef | null;
     purchaseDesc?: string | null;
     purchaseCost?: number | null;
-    purchaseTaxCode?: QbdRef;
-    cogsAccount?: QbdRef;
-    preferredVendor?: QbdRef;
-    assetAccount?: QbdRef;
+    purchaseTaxCode?: QbdRef | null;
+    cogsAccount?: QbdRef | null;
+    preferredVendor?: QbdRef | null;
+    assetAccount?: QbdRef | null;
     reorderPoint?: number | null;
     max?: number | null;
     quantityOnHand?: number | null;
@@ -6773,11 +6964,11 @@ export type ItemInventoryItem = {
     quantityOnSalesOrder?: number | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -6804,14 +6995,14 @@ export type ItemItemDiscount = {
     itemDesc?: string | null;
     discountRate?: number | null;
     discountRatePercent?: number | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -6841,8 +7032,8 @@ export type ItemItemFixedAsset = {
     purchaseDate?: string | null;
     purchaseCost?: number | null;
     vendorOrPayeeName?: string | null;
-    assetAccount?: QbdRef;
-    salesInfo?: FixedAssetSalesInfo;
+    assetAccount?: QbdRef | null;
+    salesInfo?: FixedAssetSalesInfo | null;
     assetDesc?: string | null;
     location?: string | null;
     poNumber?: string | null;
@@ -6855,11 +7046,11 @@ export type ItemItemFixedAsset = {
     yearEndBookValue?: number | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -6888,11 +7079,11 @@ export type ItemItemGroup = {
     lines?: Array<ItemGroupLineDetail> | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -6921,13 +7112,13 @@ export type ItemItemInventoryAssembly = {
     isTaxIncluded?: boolean | null;
     salesDescription?: string | null;
     salesPrice?: number | null;
-    incomeAccount?: QbdRef;
+    incomeAccount?: QbdRef | null;
     purchaseDescription?: string | null;
     purchaseCost?: number | null;
-    purchaseTaxCode?: QbdRef;
-    cogsAccount?: QbdRef;
-    preferredVendor?: QbdRef;
-    assetAccount?: QbdRef;
+    purchaseTaxCode?: QbdRef | null;
+    cogsAccount?: QbdRef | null;
+    preferredVendor?: QbdRef | null;
+    assetAccount?: QbdRef | null;
     buildPoint?: number | null;
     max?: number | null;
     quantityOnHand?: number | null;
@@ -6938,11 +7129,11 @@ export type ItemItemInventoryAssembly = {
     lines?: Array<ItemInventoryAssemblyLine> | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -6971,22 +7162,22 @@ export type ItemItemNonInventory = {
     desc?: string | null;
     price?: number | null;
     pricePercent?: number | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     salesDesc?: string | null;
     salesPrice?: number | null;
-    incomeAccount?: QbdRef;
+    incomeAccount?: QbdRef | null;
     purchaseDesc?: string | null;
     purchaseCost?: number | null;
-    purchaseTaxCode?: QbdRef;
-    expenseAccount?: QbdRef;
-    preferredVendor?: QbdRef;
+    purchaseTaxCode?: QbdRef | null;
+    expenseAccount?: QbdRef | null;
+    preferredVendor?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7016,22 +7207,22 @@ export type ItemItemOtherCharge = {
     itemOtherChargeDescription?: string | null;
     price?: number | null;
     pricePercent?: number | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     salesDesc?: string | null;
     salesPrice?: number | null;
-    incomeAccount?: QbdRef;
+    incomeAccount?: QbdRef | null;
     purchaseDesc?: string | null;
     purchaseCost?: number | null;
-    purchaseTaxCode?: QbdRef;
-    expenseAccount?: QbdRef;
-    preferredVendor?: QbdRef;
+    purchaseTaxCode?: QbdRef | null;
+    expenseAccount?: QbdRef | null;
+    preferredVendor?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7056,15 +7247,15 @@ export type ItemItemPayment = {
     updatedAt: string;
     revisionNumber: string;
     itemDesc?: string | null;
-    depositToAccount?: QbdRef;
-    paymentMethod?: QbdRef;
+    depositToAccount?: QbdRef | null;
+    paymentMethod?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7090,15 +7281,15 @@ export type ItemItemSalesTax = {
     revisionNumber: string;
     itemDesc?: string | null;
     taxRate?: number | null;
-    taxVendor?: QbdRef;
-    salesTaxReturnLine?: QbdRef;
+    taxVendor?: QbdRef | null;
+    salesTaxReturnLine?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7129,11 +7320,11 @@ export type ItemItemSalesTaxGroup = {
     itemSalesTax?: Array<QbdRef> | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7168,11 +7359,11 @@ export type ItemItemSubtotal = {
     specialItemType?: string | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7193,7 +7384,7 @@ export type ItemLine = {
     objectType?: string;
     otherCustomField1?: string | null;
     otherCustomField2?: string | null;
-    item?: QbdRef;
+    item?: QbdRef | null;
     /**
      * (Optional) Description for the line item.
      */
@@ -7210,11 +7401,14 @@ export type ItemLine = {
      * (Optional) Total amount for the line.
      */
     amount?: number | null;
-    customer?: QbdRef;
-    class?: QbdRef;
-    overrideItemAccount?: QbdRef;
-    billableStatus?: NullableBillableStatus;
-    itemGroup?: QbdRef;
+    customer?: QbdRef | null;
+    class?: QbdRef | null;
+    overrideItemAccount?: QbdRef | null;
+    /**
+     * (Optional) Billable status (Billable, NotBillable, HasBeenBilled).
+     */
+    billableStatus?: NullableBillableStatus | null;
+    itemGroup?: QbdRef | null;
     /**
      * (Optional) Unit of measure.
      */
@@ -7223,9 +7417,9 @@ export type ItemLine = {
      * (Optional) Price per item (used in sales).
      */
     rate?: number | null;
-    salesTaxCode?: QbdRef;
-    inventorySite?: QbdRef;
-    inventorySiteLocation?: QbdRef;
+    salesTaxCode?: QbdRef | null;
+    inventorySite?: QbdRef | null;
+    inventorySiteLocation?: QbdRef | null;
     /**
      * (Optional) Serial number for the item.
      */
@@ -7255,22 +7449,22 @@ export type ItemNonInventory = {
     desc?: string | null;
     price?: number | null;
     pricePercent?: number | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     salesDesc?: string | null;
     salesPrice?: number | null;
-    incomeAccount?: QbdRef;
+    incomeAccount?: QbdRef | null;
     purchaseDesc?: string | null;
     purchaseCost?: number | null;
-    purchaseTaxCode?: QbdRef;
-    expenseAccount?: QbdRef;
-    preferredVendor?: QbdRef;
+    purchaseTaxCode?: QbdRef | null;
+    expenseAccount?: QbdRef | null;
+    preferredVendor?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7312,22 +7506,22 @@ export type ItemOtherCharge = {
     itemOtherChargeDescription?: string | null;
     price?: number | null;
     pricePercent?: number | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     salesDesc?: string | null;
     salesPrice?: number | null;
-    incomeAccount?: QbdRef;
+    incomeAccount?: QbdRef | null;
     purchaseDesc?: string | null;
     purchaseCost?: number | null;
-    purchaseTaxCode?: QbdRef;
-    expenseAccount?: QbdRef;
-    preferredVendor?: QbdRef;
+    purchaseTaxCode?: QbdRef | null;
+    expenseAccount?: QbdRef | null;
+    preferredVendor?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7360,15 +7554,15 @@ export type ItemPayment = {
     updatedAt: string;
     revisionNumber: string;
     itemDesc?: string | null;
-    depositToAccount?: QbdRef;
-    paymentMethod?: QbdRef;
+    depositToAccount?: QbdRef | null;
+    paymentMethod?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7392,7 +7586,7 @@ export type ItemReceipt = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * Exchange rate for multi-currency transactions (Optional).
      */
@@ -7406,16 +7600,19 @@ export type ItemReceipt = {
      */
     memo?: string | null;
     transactionNumber?: number | null;
-    payablesAccount?: QbdRef;
-    liabilityAccount?: QbdRef;
+    payablesAccount?: QbdRef | null;
+    /**
+     * The Liability account (e.g., for items received without a bill).
+     */
+    liabilityAccount?: QbdRef | null;
     /**
      * Indicates if tax is included in line items (Optional).
      */
     isTaxIncluded?: boolean | null;
-    salesTaxCode?: QbdRef;
+    salesTaxCode?: QbdRef | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -7455,18 +7652,18 @@ export type ItemSalesTax = {
      * (Optional) The tax rate as a percentage (e.g., 7.5 for 7.5%).
      */
     taxRate?: number | null;
-    taxVendor?: QbdRef;
-    salesTaxReturnLine?: QbdRef;
+    taxVendor?: QbdRef | null;
+    salesTaxReturnLine?: QbdRef | null;
     fullName?: string | null;
     /**
      * (Optional) BarCode information.
      */
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     /**
@@ -7499,11 +7696,11 @@ export type ItemSalesTaxGroup = {
     itemSalesTax?: Array<QbdRef> | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7523,22 +7720,22 @@ export type ItemServiceItem = {
     desc?: string | null;
     price?: number | null;
     pricePercent?: number | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     salesDescription?: string | null;
     salesPrice?: number | null;
-    incomeAccount?: QbdRef;
+    incomeAccount?: QbdRef | null;
     purchaseDesc?: string | null;
     purchaseCost?: number | null;
-    purchaseTaxCode?: QbdRef;
-    expenseAccount?: QbdRef;
-    preferredVendor?: QbdRef;
+    purchaseTaxCode?: QbdRef | null;
+    expenseAccount?: QbdRef | null;
+    preferredVendor?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7573,11 +7770,11 @@ export type ItemSubtotal = {
     specialItemType?: string | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -7593,7 +7790,7 @@ export type JournalEntry = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     exchangeRate?: number | null;
     /**
      * Reference number for the journal entry. (Max 20 characters)
@@ -7616,8 +7813,8 @@ export type JournalEntry = {
     debitLines?: Array<JournalLine> | null;
     creditLines?: Array<JournalLine> | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -7633,7 +7830,7 @@ export type JournalEntry = {
 export type JournalLine = {
     objectType?: string;
     id: string;
-    account?: QbdRef;
+    account?: QbdRef | null;
     /**
      * (Required) Amount for the line.
      */
@@ -7642,9 +7839,9 @@ export type JournalLine = {
      * Memo for the line. (Max 4095 characters)
      */
     memo?: string | null;
-    entity?: QbdRef;
-    class?: QbdRef;
-    itemSalesTax?: QbdRef;
+    entity?: QbdRef | null;
+    class?: QbdRef | null;
+    itemSalesTax?: QbdRef | null;
     /**
      * Billable status of the line (Billable, NotBillable, HasBeenBilled).
      */
@@ -7790,8 +7987,14 @@ export type OtherName = {
     firstName?: string | null;
     middleName?: string | null;
     lastName?: string | null;
-    address?: Address;
-    addressBlock?: AddressBlock;
+    /**
+     * The primary address for the "Other Name".
+     */
+    address?: Address | null;
+    /**
+     * The address formatted as a 5-line block.
+     */
+    addressBlock?: AddressBlock | null;
     phone?: string | null;
     alternatePhone?: string | null;
     fax?: string | null;
@@ -7813,7 +8016,7 @@ export type PayableBill = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     amountDue?: number | null;
     exchangeRate?: number | null;
     /**
@@ -7823,10 +8026,10 @@ export type PayableBill = {
     refNumber?: string | null;
     memo?: string | null;
     transactionType?: string | null;
-    payablesAccount?: QbdRef;
+    payablesAccount?: QbdRef | null;
     dueDate?: string | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -7883,8 +8086,14 @@ export type PayrollItemNonWage = {
      * Possible values: Addition, CompanyContribution, Deduction, DirectDeposit, Tax
      */
     nonWageType: string;
-    expenseAccount?: QbdRef;
-    liabilityAccount?: QbdRef;
+    /**
+     * The expense account associated with this payroll item.
+     */
+    expenseAccount?: QbdRef | null;
+    /**
+     * The liability account associated with this payroll item.
+     */
+    liabilityAccount?: QbdRef | null;
     /**
      * (Optional) Indicates whether the payroll item is active.
      */
@@ -7945,7 +8154,10 @@ export type PriceLevel = {
      * List of per-item price level rules (only for PerItem type).
      */
     perItemPriceLevels?: Array<PriceLevelPerItem> | null;
-    currency?: QbdRef;
+    /**
+     * The currency associated with this price level.
+     */
+    currency?: QbdRef | null;
     /**
      * (Optional) Whether the price level is active. Defaults to true.
      */
@@ -7957,7 +8169,10 @@ export type PriceLevel = {
  * Maps to PriceLevelPerItemRet in QBXML.
  */
 export type PriceLevelPerItem = {
-    item?: QbdRef;
+    /**
+     * The item this pricing rule applies to.
+     */
+    item?: QbdRef | null;
     /**
      * The custom price for this item (mutually exclusive with CustomPricePercent).
      */
@@ -8004,7 +8219,7 @@ export type PurchaseOrder = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * (Optional) Exchange rate if this is a foreign currency Purchase Order.
      */
@@ -8018,16 +8233,22 @@ export type PurchaseOrder = {
      */
     memo?: string | null;
     transactionNumber?: number | null;
-    vendor?: QbdRef;
-    class?: QbdRef;
-    inventorySite?: QbdRef;
-    shipToEntity?: QbdRef;
-    template?: QbdRef;
-    vendorAddress?: Address;
-    vendorAddressBlock?: AddressBlock;
-    shipAddress?: Address;
-    shipAddressBlock?: AddressBlock;
-    terms?: QbdRef;
+    vendor?: QbdRef | null;
+    class?: QbdRef | null;
+    inventorySite?: QbdRef | null;
+    shipToEntity?: QbdRef | null;
+    template?: QbdRef | null;
+    /**
+     * (Optional) The primary address for the Vendor on this Purchase Order.
+     */
+    vendorAddress?: Address | null;
+    vendorAddressBlock?: AddressBlock | null;
+    /**
+     * (Optional) The shipping address for the Purchase Order.
+     */
+    shipAddress?: Address | null;
+    shipAddressBlock?: AddressBlock | null;
+    terms?: QbdRef | null;
     /**
      * (Optional) The date the payment is due based on terms.
      */
@@ -8036,7 +8257,7 @@ export type PurchaseOrder = {
      * (Optional) The date the vendor is expected to deliver the item.
      */
     expectedDate?: string | null;
-    shipmentMethod?: QbdRef;
+    shipmentMethod?: QbdRef | null;
     shipmentOrigin?: string | null;
     totalAmount?: number | null;
     /**
@@ -8051,14 +8272,14 @@ export type PurchaseOrder = {
      * (Optional) If true, the line item rates/amounts are inclusive of sales tax.
      */
     isTaxIncluded?: boolean | null;
-    salesTaxCode?: QbdRef;
+    salesTaxCode?: QbdRef | null;
     otherCustomField1?: string | null;
     otherCustomField2?: string | null;
     lines?: Array<PurchaseOrderLine> | null;
     lineGroups?: Array<PurchaseOrderLineGroup> | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -8073,7 +8294,7 @@ export type PurchaseOrder = {
  */
 export type PurchaseOrderLine = {
     id: string;
-    item?: QbdRef;
+    item?: QbdRef | null;
     /**
      * (Optional) The manufacturer's part number for the item. (Max 31 characters)
      */
@@ -8087,23 +8308,23 @@ export type PurchaseOrderLine = {
      */
     quantity?: number | null;
     unitOfMeasure?: string | null;
-    overrideUnitOfMeasureSet?: QbdRef;
+    overrideUnitOfMeasureSet?: QbdRef | null;
     /**
      * (Optional) Cost/Rate per item unit.
      */
     rate?: number | null;
-    class?: QbdRef;
+    class?: QbdRef | null;
     /**
      * (Optional) Total amount for the line.
      */
     amount?: number | null;
-    inventorySiteLocation?: QbdRef;
-    customer?: QbdRef;
+    inventorySiteLocation?: QbdRef | null;
+    customer?: QbdRef | null;
     /**
      * (Optional) The date the service was performed (if this is a service item).
      */
     serviceDate?: string | null;
-    salesTaxCode?: QbdRef;
+    salesTaxCode?: QbdRef | null;
     receivedQuantity?: number | null;
     unbilledQuantity?: number | null;
     isBilled?: boolean | null;
@@ -8121,14 +8342,14 @@ export type PurchaseOrderLine = {
 export type PurchaseOrderLineGroup = {
     id: string;
     objectType?: string;
-    itemGroup?: QbdRef;
+    itemGroup?: QbdRef | null;
     description?: string | null;
     /**
      * (Optional) Quantity of the group to purchase.
      */
     quantity?: number | null;
     unitOfMeasure?: string | null;
-    overrideUnitOfMeasureSet?: QbdRef;
+    overrideUnitOfMeasureSet?: QbdRef | null;
     isPrintItemsInGroup?: boolean | null;
     totalAmount?: number | null;
     lines?: Array<PurchaseOrderLine> | null;
@@ -8208,7 +8429,7 @@ export type ReceivePayment = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * Exchange rate for multi-currency transactions (v8.0+).
      */
@@ -8222,11 +8443,11 @@ export type ReceivePayment = {
      */
     memo?: string | null;
     txnNumber?: number | null;
-    customer?: QbdRef;
-    receivablesAccount?: QbdRef;
-    paymentMethod?: QbdRef;
-    depositToAccount?: QbdRef;
-    creditCardTransaction?: CreditCardTransactionInfo;
+    customer?: QbdRef | null;
+    receivablesAccount?: QbdRef | null;
+    paymentMethod?: QbdRef | null;
+    depositToAccount?: QbdRef | null;
+    creditCardTransaction?: CreditCardTransactionInfo | null;
     unusedPayment?: number | null;
     unusedCredits?: number | null;
     /**
@@ -8235,8 +8456,8 @@ export type ReceivePayment = {
      */
     appliedToTxns?: Array<AppliedToTxn> | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -8341,7 +8562,7 @@ export type Report = {
     columnCount?: number | null;
     headerRowCount?: number | null;
     columns?: Array<ReportColumnDescription> | null;
-    data?: ReportData;
+    data?: ReportData | null;
     customFields?: Array<QbdDataExt> | null;
 };
 /**
@@ -8357,7 +8578,10 @@ export type ReportColData = {
      * The data type of the column.
      */
     dataType?: string | null;
-    attributes?: DictionaryStringString;
+    /**
+     * The attributes of the column.
+     */
+    attributes?: DictionaryStringString | null;
 };
 /**
  * Describes a column in the report (maps ColDesc QBXML element).
@@ -8417,7 +8641,7 @@ export type ReportRow = {
      * The value of the row.
      */
     value?: string | null;
-    info?: ReportRowData;
+    info?: ReportRowData | null;
     values?: Array<ReportColData> | null;
     rows?: Array<ReportRow> | null;
 };
@@ -8457,7 +8681,7 @@ export type SalesReceipt = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * (Optional) Exchange rate if this is a foreign currency Sales Receipt.
      */
@@ -8471,13 +8695,13 @@ export type SalesReceipt = {
      */
     memo?: string | null;
     txnNumber?: number | null;
-    customer?: QbdRef;
-    class?: QbdRef;
-    template?: QbdRef;
-    billingAddress?: Address;
-    billingAddressBlock?: AddressBlock;
-    shippingAddress?: Address;
-    shippingAddressBlock?: AddressBlock;
+    customer?: QbdRef | null;
+    class?: QbdRef | null;
+    template?: QbdRef | null;
+    billingAddress?: Address | null;
+    billingAddressBlock?: AddressBlock | null;
+    shippingAddress?: Address | null;
+    shippingAddressBlock?: AddressBlock | null;
     /**
      * (Optional) Indicates if the transaction is pending.
      */
@@ -8486,37 +8710,37 @@ export type SalesReceipt = {
      * (Optional) Check number if payment method is check. (Max 25 characters)
      */
     checkNumber?: string | null;
-    paymentMethod?: QbdRef;
+    paymentMethod?: QbdRef | null;
     /**
      * (Optional) The date the payment is due (if applicable).
      */
     dueDate?: string | null;
-    salesRepresentative?: QbdRef;
+    salesRepresentative?: QbdRef | null;
     shipDate?: string | null;
-    shipMethod?: QbdRef;
+    shipMethod?: QbdRef | null;
     shipmentOrigin?: string | null;
     subtotal?: number | null;
-    itemSalesTax?: QbdRef;
+    itemSalesTax?: QbdRef | null;
     salesTaxPercentage?: number | null;
     salesTaxTotal?: number | null;
     totalAmount?: number | null;
     totalAmountInHomeCurrency?: number | null;
-    customerMessage?: QbdRef;
+    customerMessage?: QbdRef | null;
     isQueuedForPrint?: boolean | null;
     isQueuedForEmail?: boolean | null;
     /**
      * (Optional) If true, tax is included in the item amounts (tax-inclusive pricing).
      */
     isTaxIncluded?: boolean | null;
-    customerSalesTaxCode?: QbdRef;
-    depositToAccount?: QbdRef;
-    creditCardTransaction?: CreditCardTransactionInfo;
+    customerSalesTaxCode?: QbdRef | null;
+    depositToAccount?: QbdRef | null;
+    creditCardTransaction?: CreditCardTransactionInfo | null;
     otherCustomField?: string | null;
     lines?: Array<SalesReceiptLine> | null;
     lineGroups?: Array<SalesReceiptLineGroup> | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -8532,7 +8756,7 @@ export type SalesReceipt = {
 export type SalesReceiptLine = {
     id: string;
     objectType?: string | null;
-    item?: QbdRef;
+    item?: QbdRef | null;
     /**
      * (Optional) Description for the line item. (Max 4095 characters)
      */
@@ -8545,7 +8769,7 @@ export type SalesReceiptLine = {
      * (Optional) Unit of measure override. (Max 31 characters)
      */
     unitOfMeasure?: string | null;
-    overrideUOMSet?: QbdRef;
+    overrideUOMSet?: QbdRef | null;
     /**
      * (Optional) The direct rate per unit. Use either Rate, RatePercent, or PriceLevelId.
      */
@@ -8554,13 +8778,13 @@ export type SalesReceiptLine = {
      * (Optional) The percentage rate based on item price. Use either Rate, RatePercent, or PriceLevelId.
      */
     ratePercent?: number | null;
-    class?: QbdRef;
+    class?: QbdRef | null;
     /**
      * (Optional) Total amount for the line. Overrides calculation if Rate/RatePercent not set.
      */
     amount?: number | null;
-    inventorySite?: QbdRef;
-    inventorySiteLocation?: QbdRef;
+    inventorySite?: QbdRef | null;
+    inventorySiteLocation?: QbdRef | null;
     /**
      * (Optional) Serial number for the item. Mutually exclusive with LotNumber. (Max 4095 characters)
      */
@@ -8574,10 +8798,10 @@ export type SalesReceiptLine = {
      * (Optional) The date the service was performed.
      */
     serviceDate?: string | null;
-    salesTaxCode?: QbdRef;
+    salesTaxCode?: QbdRef | null;
     otherCustomField1?: string | null;
     otherCustomField2?: string | null;
-    creditCardTransaction?: CreditCardTransactionInfo;
+    creditCardTransaction?: CreditCardTransactionInfo | null;
     customFields?: Array<QbdDataExt> | null;
 };
 /**
@@ -8586,7 +8810,7 @@ export type SalesReceiptLine = {
 export type SalesReceiptLineGroup = {
     id: string;
     objectType?: string | null;
-    itemGroup?: QbdRef;
+    itemGroup?: QbdRef | null;
     description?: string | null;
     /**
      * (Optional) Quantity of the group.
@@ -8596,7 +8820,7 @@ export type SalesReceiptLineGroup = {
      * (Optional) Unit of measure override. (Max 31 characters)
      */
     unitOfMeasure?: string | null;
-    overrideUnitOfMeasureSet?: QbdRef;
+    overrideUnitOfMeasureSet?: QbdRef | null;
     shouldPrintItemsInGroup?: boolean | null;
     totalAmount?: number | null;
     lines?: Array<SalesReceiptLine> | null;
@@ -8621,8 +8845,8 @@ export type SalesTaxCode = {
      */
     isTaxable?: boolean;
     desc?: string | null;
-    itemPurchaseTax?: QbdRef;
-    itemSalesTax?: QbdRef;
+    itemPurchaseTax?: QbdRef | null;
+    itemSalesTax?: QbdRef | null;
     /**
      * (Optional) If false, this Sales Tax Code is inactive. Default is true.
      */
@@ -8643,7 +8867,7 @@ export type SalesTaxPaymentCheck = {
      * (Required) The date of the transaction.
      */
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     exchangeRate?: number | null;
     refNumber?: string | null;
     /**
@@ -8651,16 +8875,19 @@ export type SalesTaxPaymentCheck = {
      */
     memo?: string | null;
     transactionNumber?: number | null;
-    address?: Address;
-    addressBlock?: AddressBlock;
+    /**
+     * (Optional) The address of the payee.
+     */
+    address?: Address | null;
+    addressBlock?: AddressBlock | null;
     isQueuedForPrint?: boolean | null;
     /**
      * (Required) A list of sales tax items and the amounts being paid.
      */
     lines?: Array<SalesTaxPaymentCheckLine> | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -8676,7 +8903,7 @@ export type SalesTaxPaymentCheck = {
 export type SalesTaxPaymentCheckLine = {
     objectType?: string;
     id: string;
-    itemSalesTax?: QbdRef;
+    itemSalesTax?: QbdRef | null;
     /**
      * (Required) The amount of the payment for this line.
      */
@@ -8704,22 +8931,22 @@ export type ServiceItem = {
     desc?: string | null;
     price?: number | null;
     pricePercent?: number | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     salesDescription?: string | null;
     salesPrice?: number | null;
-    incomeAccount?: QbdRef;
+    incomeAccount?: QbdRef | null;
     purchaseDesc?: string | null;
     purchaseCost?: number | null;
-    purchaseTaxCode?: QbdRef;
-    expenseAccount?: QbdRef;
-    preferredVendor?: QbdRef;
+    purchaseTaxCode?: QbdRef | null;
+    expenseAccount?: QbdRef | null;
+    preferredVendor?: QbdRef | null;
     fullName?: string | null;
     barcode?: string | null;
-    class?: QbdRef;
-    parent?: QbdRef;
+    class?: QbdRef | null;
+    parent?: QbdRef | null;
     sublevel?: number | null;
-    unitOfMeasureSet?: QbdRef;
-    salesTaxCode?: QbdRef;
+    unitOfMeasureSet?: QbdRef | null;
+    salesTaxCode?: QbdRef | null;
     description?: string | null;
     externalId?: string | null;
     isActive?: boolean;
@@ -8936,19 +9163,19 @@ export type TimeTracking = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     exchangeRate?: number | null;
     refNumber?: string | null;
     memo?: string | null;
     transactionNumber?: number | null;
-    customer?: QbdRef;
-    itemService?: QbdRef;
+    customer?: QbdRef | null;
+    itemService?: QbdRef | null;
     /**
      * (Required) The duration of the work performed, formatted as an XML TimeIntervalType string (e.g., "PT8H0M0S" for 8 hours).
      */
     duration?: string | null;
-    class?: QbdRef;
-    payrollItemWage?: QbdRef;
+    class?: QbdRef | null;
+    payrollItemWage?: QbdRef | null;
     /**
      * (Optional) General notes about the time entry. Max 4095 chars.
      */
@@ -8963,8 +9190,8 @@ export type TimeTracking = {
     isBillable?: boolean | null;
     isBilled?: boolean | null;
     amount?: number | null;
-    entity?: QbdRef;
-    account?: QbdRef;
+    entity?: QbdRef | null;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -8985,15 +9212,18 @@ export type Transaction = {
     updatedAt: string;
     revisionNumber: string;
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     exchangeRate?: number | null;
     refNumber?: string | null;
     memo?: string | null;
     transactionType?: string | null;
     transactionLineId?: string | null;
-    entity?: QbdRef;
+    /**
+     * The entity associated with this transaction (Customer, Vendor, Employee, etc.)
+     */
+    entity?: QbdRef | null;
     amount?: number | null;
-    account?: QbdRef;
+    account?: QbdRef | null;
     amountInHomeCurrency?: string | null;
     hasValidLineItems?: boolean;
     externalId?: string | null;
@@ -9021,7 +9251,10 @@ export type UnitOfMeasureSet = {
      * The type of measurement: "Area", "Count", "Length", "Other", "Time", "Volume", "Weight".
      */
     unitOfMeasureType?: string | null;
-    baseUnit?: BaseUnit;
+    /**
+     * The base unit definition for this set.
+     */
+    baseUnit?: BaseUnit | null;
     /**
      * List of related units with conversion ratios.
      */
@@ -9049,7 +9282,11 @@ export type UpdateAccountRequest = {
      * Whether the account is active
      */
     isActive?: boolean | null;
-    accountType?: NullableAccountType;
+    /**
+     * Account type (optional)
+     * NOTE: Cannot create non_posting accounts via API - QuickBooks creates these internally
+     */
+    accountType?: NullableAccountType | null;
     /**
      * Whether the account is a tax account (optional)
      */
@@ -9135,7 +9372,10 @@ export type UpdateArRefundCreditCardRequest = {
      * (Optional) The reference number for the refund.
      */
     refNumber?: string | null;
-    address?: AddressRequest;
+    /**
+     * (Optional) Address details for the refund.
+     */
+    address?: AddressRequest | null;
     /**
      * (Optional) The ListID or FullName of the payment method.
      */
@@ -9144,7 +9384,7 @@ export type UpdateArRefundCreditCardRequest = {
      * (Optional) A memo for the transaction.
      */
     memo?: string | null;
-    creditCardTransaction?: CreditCardTransactionInfo;
+    creditCardTransaction?: CreditCardTransactionInfo | null;
     /**
      * (Optional) The exchange rate for the transaction.
      */
@@ -9168,7 +9408,7 @@ export type UpdateBillRequest = {
      * Filter by Vendor ID.
      */
     vendorId?: string | null;
-    vendorAddress?: AddressRequest;
+    vendorAddress?: AddressRequest | null;
     payablesAccountId?: string | null;
     transactionDate?: string | null;
     dueDate?: string | null;
@@ -9387,7 +9627,10 @@ export type UpdateCheckRequest = {
      */
     memo?: string | null;
     isQueuedForPrint?: boolean | null;
-    address?: Address;
+    /**
+     * Payee address
+     */
+    address?: Address | null;
     /**
      * If true, the amount includes sales tax.
      */
@@ -9615,8 +9858,8 @@ export type UpdateCreditCardRequest = {
  * Aggregate containing credit card input and result information for a payment (Mod).
  */
 export type UpdateCreditCardTransactionInfoRequest = {
-    creditCardTxnInputInfoMod?: UpdateCreditCardTransactionInputInfoRequest;
-    creditCardTxnResultInfoMod?: UpdateCreditCardTransactionResultInfoRequest;
+    creditCardTxnInputInfoMod?: UpdateCreditCardTransactionInputInfoRequest | null;
+    creditCardTxnResultInfoMod?: UpdateCreditCardTransactionResultInfoRequest | null;
 };
 /**
  * Contains modifiable data about the credit card itself for a payment request (Mod).
@@ -9651,8 +9894,15 @@ export type UpdateCreditCardTransactionInputInfoRequest = {
      * (Optional) New commercial card code. (Max 4 characters)
      */
     commercialCardCode?: string | null;
-    transactionMode?: NullableTransactionMode;
-    creditCardTxnType?: NullableCreditCardTransactionType;
+    /**
+     * (Optional) New transaction mode (0 for CardNotPresent [DEFAULT], 1 for CardPresent).
+     */
+    transactionMode?: NullableTransactionMode | null;
+    /**
+     * (Optional) New type of credit card transaction.
+     * Used for actions like changing an Authorization to a Capture (1).
+     */
+    creditCardTxnType?: NullableCreditCardTransactionType | null;
 };
 export type UpdateCreditCardTransactionResultInfoRequest = {
     resultCode: number;
@@ -9662,9 +9912,9 @@ export type UpdateCreditCardTransactionResultInfoRequest = {
     paymentStatus: PaymentStatus;
     txnAuthorizationTime: string;
     authorizationCode?: string | null;
-    avsStreet?: NullableAvsStreet;
-    avsZip?: NullableAvsZip;
-    cardSecurityCodeMatch?: NullableCardSecurityCodeMatch;
+    avsStreet?: NullableAvsStreet | null;
+    avsZip?: NullableAvsZip | null;
+    cardSecurityCodeMatch?: NullableCardSecurityCodeMatch | null;
     reconBatchId?: string | null;
     paymentGroupingCode?: number | null;
     txnAuthorizationStamp?: number | null;
@@ -9798,8 +10048,8 @@ export type UpdateCreditMemoRequest = {
      * (Optional) The reference number.
      */
     refNumber?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     /**
      * (Optional) Indicates if the credit memo is pending.
      */
@@ -9874,7 +10124,10 @@ export type UpdateCurrencyRequest = {
      * (Optional) The three-letter currency code (e.g., USD, EUR). Values are normalized to trimmed uppercase. Cannot be changed for built-in QuickBooks currencies. (Max 3 characters)
      */
     currencyCode?: string | null;
-    currencyFormat?: CurrencyFormatRequest;
+    /**
+     * (Optional) Specifies the formatting rules for the currency.
+     */
+    currencyFormat?: CurrencyFormatRequest | null;
 };
 /**
  * Request model for updating an existing customer
@@ -9900,14 +10153,14 @@ export type UpdateCustomerRequest = {
     taxRegistrationNumber?: string | null;
     jobTypeId?: string | null;
     currencyId?: string | null;
-    creditCardInfo?: CreditCardInfo;
+    creditCardInfo?: CreditCardInfo | null;
     salutation?: string | null;
     firstName?: string | null;
     middleName?: string | null;
     lastName?: string | null;
     jobTitle?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     /**
      * Additional ship-to addresses (up to 50 allowed by QuickBooks).
      * Note: Updating ship-to addresses replaces the entire list.
@@ -9925,7 +10178,7 @@ export type UpdateCustomerRequest = {
      */
     customContactFields?: Array<CustomContactField> | null;
     creditLimit?: number | null;
-    jobStatus?: NullableJobStatus;
+    jobStatus?: NullableJobStatus | null;
     jobStartDate?: string | null;
     jobProjectedEndDate?: string | null;
     jobEndDate?: string | null;
@@ -9959,8 +10212,16 @@ export type UpdateDateDrivenTermRequest = {
  */
 export type UpdateDepositLineRequest = {
     transactionLineId: string;
-    paymentLineMod?: DepositPaymentLineRequest;
-    manualLineMod?: DepositManualLineRequest;
+    /**
+     * (Optional) Modification details for a payment line (PaymentTxnID, OverrideMemo, etc.).
+     * Mutually exclusive with ManualLineMod.
+     */
+    paymentLineMod?: DepositPaymentLineRequest | null;
+    /**
+     * (Optional) Modification details for a manual line (EntityId, AccountId, Amount, etc.).
+     * Mutually exclusive with PaymentLineMod.
+     */
+    manualLineMod?: DepositManualLineRequest | null;
 };
 /**
  * A request model for modifying an existing Deposit transaction.
@@ -9978,7 +10239,7 @@ export type UpdateDepositRequest = {
      * (Optional) New general memo about the Deposit. (Max 4095 characters)
      */
     memo?: string | null;
-    cashBackInfo?: CashBackInfoRequest;
+    cashBackInfo?: CashBackInfoRequest | null;
     /**
      * (Optional) The ListID or FullName of the currency for the transaction.
      * Follows the Flattened-ID Pattern for CurrencyRef.
@@ -10008,7 +10269,7 @@ export type UpdateEmployeeRequest = {
     supervisorId?: string | null;
     department?: string | null;
     description?: string | null;
-    employeeAddress?: EmployeeAddress;
+    employeeAddress?: EmployeeAddress | null;
     printAs?: string | null;
     phone?: string | null;
     mobile?: string | null;
@@ -10022,7 +10283,10 @@ export type UpdateEmployeeRequest = {
      * Additional contact references (may repeat, v12.0+).
      */
     additionalContacts?: Array<AdditionalContact> | null;
-    emergencyContacts?: EmergencyContact;
+    /**
+     * Emergency contacts for the employee (QBD only, v13.0+).
+     */
+    emergencyContacts?: EmergencyContact | null;
     employeeType?: string | null;
     partOrFullTime?: string | null;
     gender?: string | null;
@@ -10053,7 +10317,7 @@ export type UpdateEmployeeRequest = {
     workAuthExpireDate?: string | null;
     usVeteran?: string | null;
     militaryStatus?: string | null;
-    employeePayrollInfo?: EmployeePayrollInfo;
+    employeePayrollInfo?: EmployeePayrollInfo | null;
     externalId?: string | null;
 };
 /**
@@ -10145,8 +10409,8 @@ export type UpdateEstimateRequest = {
      * (Optional) The sequential reference number for the Estimate (e.g., Estimate Number). (STRTYPE)
      */
     refNumber?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     /**
      * (Optional) Whether the Estimate is active. Cannot be cleared. (BOOLTYPE)
      */
@@ -10305,7 +10569,7 @@ export type UpdateInventoryAdjustmentRequest = {
  */
 export type UpdateInventoryItemRequest = {
     name: string;
-    barcode?: BarCodeRequest;
+    barcode?: BarCodeRequest | null;
     classId?: string | null;
     parentId?: string | null;
     sku?: string | null;
@@ -10339,7 +10603,7 @@ export type UpdateInventorySiteRequest = {
     phone?: string | null;
     fax?: string | null;
     email?: string | null;
-    address?: AddressRequest;
+    address?: AddressRequest | null;
 };
 /**
  * Request model for updating an existing invoice.
@@ -10365,8 +10629,8 @@ export type UpdateInvoiceRequest = {
      * Reference number for the invoice.
      */
     refNumber?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     isPending?: boolean | null;
     purchaseOrderNumber?: string | null;
     /**
@@ -10471,7 +10735,7 @@ export type UpdateItemGroupLineRequest = {
  */
 export type UpdateItemGroupRequest = {
     name?: string | null;
-    barCode?: BarCodeRequest;
+    barCode?: BarCodeRequest | null;
     isActive?: boolean | null;
     description?: string | null;
     unitOfMeasureSetId?: string | null;
@@ -10500,7 +10764,7 @@ export type UpdateItemInventoryAssemblyLineRequest = {
 export type UpdateItemInventoryAssemblyRequest = {
     revisionNumber: string;
     name?: string | null;
-    barCode?: BarCodeRequest;
+    barCode?: BarCodeRequest | null;
     isActive?: boolean | null;
     classId?: string | null;
     parentId?: string | null;
@@ -10600,7 +10864,7 @@ export type UpdateItemLineRequest = {
 export type UpdateItemNonInventoryRequest = {
     revisionNumber: string;
     name?: string | null;
-    barcode?: BarCodeRequest;
+    barcode?: BarCodeRequest | null;
     isActive?: boolean | null;
     classId?: string | null;
     parentId?: string | null;
@@ -10608,8 +10872,8 @@ export type UpdateItemNonInventoryRequest = {
     unitOfMeasureSetId?: string | null;
     isTaxIncluded?: boolean | null;
     salesTaxCodeId?: string | null;
-    salesOrPurchaseDetails?: ItemNonInventorySalesOrPurchaseDetailsRequest;
-    salesAndPurchaseDetails?: ItemNonInventorySalesAndPurchaseDetailsRequest;
+    salesOrPurchaseDetails?: ItemNonInventorySalesOrPurchaseDetailsRequest | null;
+    salesAndPurchaseDetails?: ItemNonInventorySalesAndPurchaseDetailsRequest | null;
 };
 /**
  * Request model for updating an ItemOtherCharge.
@@ -10617,14 +10881,14 @@ export type UpdateItemNonInventoryRequest = {
 export type UpdateItemOtherChargeRequest = {
     revisionNumber: string;
     name?: string | null;
-    barcode?: BarCodeRequest;
+    barcode?: BarCodeRequest | null;
     isActive?: boolean | null;
     classId?: string | null;
     parentId?: string | null;
     isTaxIncluded?: boolean | null;
     salesTaxCodeId?: string | null;
-    salesOrPurchaseDetails?: ItemOtherChargeSalesOrPurchaseDetailsRequest;
-    salesAndPurchaseDetails?: ItemOtherChargeSalesAndPurchaseDetailsRequest;
+    salesOrPurchaseDetails?: ItemOtherChargeSalesOrPurchaseDetailsRequest | null;
+    salesAndPurchaseDetails?: ItemOtherChargeSalesAndPurchaseDetailsRequest | null;
 };
 /**
  * Request model for updating an ItemPayment.
@@ -10698,7 +10962,7 @@ export type UpdateItemReceiptRequest = {
 export type UpdateItemSalesTaxGroupRequest = {
     revisionNumber: string;
     name?: string | null;
-    barCode?: BarCodeRequest;
+    barCode?: BarCodeRequest | null;
     isActive?: boolean | null;
     description?: string | null;
     itemSalesTaxIds?: Array<string> | null;
@@ -10713,7 +10977,10 @@ export type UpdateItemSalesTaxRequest = {
      * (Optional) The name or identifier for the sales tax item.
      */
     name?: string | null;
-    barcode?: BarCodeRequest;
+    /**
+     * (Optional) BarCode information.
+     */
+    barcode?: BarCodeRequest | null;
     /**
      * (Optional) Indicates whether the sales tax item is active.
      */
@@ -10754,7 +11021,7 @@ export type UpdateItemSubtotalRequest = {
     name: string;
     isActive?: boolean | null;
     barCodeValue?: string | null;
-    barCode?: BarCodeRequest;
+    barCode?: BarCodeRequest | null;
     externalId?: string | null;
 };
 /**
@@ -10830,8 +11097,8 @@ export type UpdateOtherNameRequest = {
     firstName?: string | null;
     middleName?: string | null;
     lastName?: string | null;
-    address?: Address;
-    addressBlock?: AddressBlock;
+    address?: Address | null;
+    addressBlock?: AddressBlock | null;
     phone?: string | null;
     alternatePhone?: string | null;
     fax?: string | null;
@@ -11006,8 +11273,14 @@ export type UpdatePurchaseOrderRequest = {
      * (Optional) The document number. (Max 11 characters)
      */
     refNumber?: string | null;
-    vendorAddress?: AddressRequest;
-    shipAddress?: AddressRequest;
+    /**
+     * (Optional) The primary address for the Vendor on this Purchase Order.
+     */
+    vendorAddress?: AddressRequest | null;
+    /**
+     * (Optional) The shipping address for the Purchase Order.
+     */
+    shipAddress?: AddressRequest | null;
     /**
      * (Optional) The ListID or FullName of the payment terms.
      * Follows the Flattened-ID Pattern for TermsRef.
@@ -11104,7 +11377,10 @@ export type UpdateReceivePaymentRequest = {
      * Account to deposit the payment into.
      */
     depositToAccountId?: string | null;
-    creditCardTxnInfo?: CreditCardTxnInfoRequest;
+    /**
+     * Credit card transaction information (v7.0+ for mod).
+     */
+    creditCardTxnInfo?: CreditCardTxnInfoRequest | null;
     appliedToTransactions?: Array<AppliedToTransactionRequest> | null;
 };
 export type UpdateSalesAndPurchaseRequest = {
@@ -11238,8 +11514,8 @@ export type UpdateSalesReceiptRequest = {
      * (Optional) The new document number (e.g., receipt number). (Max 11 characters)
      */
     refNumber?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     /**
      * (Optional) New check number if payment method is check. (Max 25 characters)
      */
@@ -11283,7 +11559,7 @@ export type UpdateSalesReceiptRequest = {
      */
     exchangeRate?: number | null;
     otherCustomField?: string | null;
-    creditCardTransaction?: UpdateCreditCardTransactionInfoRequest;
+    creditCardTransaction?: UpdateCreditCardTransactionInfoRequest | null;
     lines?: Array<UpdateSalesReceiptLineRequest> | null;
     lineGroups?: Array<UpdateSalesReceiptLineGroupRequest> | null;
 };
@@ -11342,12 +11618,15 @@ export type UpdateSalesTaxPaymentCheckRequest = {
      * (Optional) A memo for the transaction. Max 4095 chars.
      */
     memo?: string | null;
-    address?: AddressRequest;
+    /**
+     * (Optional) The address of the payee.
+     */
+    address?: AddressRequest | null;
 };
 export type UpdateServiceItemRequest = {
     revisionNumber: string;
     name?: string | null;
-    barCode?: BarCodeRequest;
+    barCode?: BarCodeRequest | null;
     isActive?: boolean | null;
     parentId?: string | null;
     salesTaxCodeId?: string | null;
@@ -11357,8 +11636,8 @@ export type UpdateServiceItemRequest = {
     applyAccountToExistingTransactions?: boolean | null;
     applyIncomeAccountToExistingTransactions?: boolean | null;
     applyExpenseAccountToExistingTransactions?: boolean | null;
-    salesOrPurchaseMod?: UpdateSalesOrPurchaseRequest;
-    salesAndPurchaseMod?: UpdateSalesAndPurchaseRequest;
+    salesOrPurchaseMod?: UpdateSalesOrPurchaseRequest | null;
+    salesAndPurchaseMod?: UpdateSalesAndPurchaseRequest | null;
     includeRetElement?: Array<string> | null;
 };
 /**
@@ -11503,8 +11782,8 @@ export type UpdateVendorRequest = {
     middleName?: string | null;
     lastName?: string | null;
     jobTitle?: string | null;
-    billingAddress?: AddressRequest;
-    shippingAddress?: AddressRequest;
+    billingAddress?: AddressRequest | null;
+    shippingAddress?: AddressRequest | null;
     phone?: string | null;
     alternatePhone?: string | null;
     fax?: string | null;
@@ -11667,18 +11946,39 @@ export type Vendor = {
      */
     accountNumber?: string | null;
     note?: string | null;
-    class?: QbdRef;
-    vendorType?: QbdRef;
-    terms?: QbdRef;
-    billingRate?: QbdRef;
-    salesTaxCode?: QbdRef;
-    salesTaxReturn?: QbdRef;
-    purchaseTaxAccount?: QbdRef;
-    salesTaxAccount?: QbdRef;
-    currency?: QbdRef;
+    /**
+     * The class assigned to this vendor for departmental tracking.
+     */
+    class?: QbdRef | null;
+    /**
+     * The vendor type category assigned to this vendor.
+     */
+    vendorType?: QbdRef | null;
+    /**
+     * The default payment terms for this vendor (e.g., "Net 30").
+     */
+    terms?: QbdRef | null;
+    /**
+     * The billing rate used when tracking time for this vendor.
+     */
+    billingRate?: QbdRef | null;
+    /**
+     * The sales tax code assigned to this vendor.
+     */
+    salesTaxCode?: QbdRef | null;
+    /**
+     * The sales tax return account for this tax-agency vendor.
+     */
+    salesTaxReturn?: QbdRef | null;
+    purchaseTaxAccount?: QbdRef | null;
+    salesTaxAccount?: QbdRef | null;
+    /**
+     * The currency used for transactions with this vendor (multi-currency files only).
+     */
+    currency?: QbdRef | null;
     defaultExpenseAccounts?: Array<QbdRef> | null;
-    billingAddress?: Address;
-    shippingAddress?: Address;
+    billingAddress?: Address | null;
+    shippingAddress?: Address | null;
     /**
      * Custom contact fields (name/value pairs) defined for this vendor.
      */
@@ -11741,7 +12041,7 @@ export type VendorCredit = {
      * (Optional) The date of the transaction. Defaults to the current date.
      */
     transactionDate?: string | null;
-    currency?: QbdRef;
+    currency?: QbdRef | null;
     /**
      * (Optional) The exchange rate, if using multi-currency.
      */
@@ -11755,10 +12055,19 @@ export type VendorCredit = {
      */
     memo?: string | null;
     transactionNumber?: number | null;
-    entity?: QbdRef;
-    vendor?: QbdRef;
-    account?: QbdRef;
-    payablesAccount?: QbdRef;
+    /**
+     * Refers to the Vendor. Note: The base Entity is for PayeeEntityRef.
+     */
+    entity?: QbdRef | null;
+    /**
+     * Refers to the Vendor.
+     */
+    vendor?: QbdRef | null;
+    /**
+     * Refers to the Payables Account. Note: The base Account is for PayeeAccountRef.
+     */
+    account?: QbdRef | null;
+    payablesAccount?: QbdRef | null;
     /**
      * The total amount of the credit.
      */
@@ -11771,7 +12080,7 @@ export type VendorCredit = {
      * (Optional) If true, the amount includes sales tax.
      */
     isTaxIncluded?: boolean | null;
-    salesTaxCode?: QbdRef;
+    salesTaxCode?: QbdRef | null;
     /**
      * The amount of this credit that has not yet been applied.
      */
@@ -11814,7 +12123,7 @@ export type VendorType = {
      * The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.
      */
     fullName?: string | null;
-    parent?: QbdRef;
+    parent?: QbdRef | null;
     sublevel?: number | null;
     /**
      * (Optional) If false, this Vendor Type is inactive. Default is true.