conductor-node 14.18.0 → 14.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/package.json +1 -1
  3. package/resources/end-users.d.mts +15 -4
  4. package/resources/end-users.d.mts.map +1 -1
  5. package/resources/end-users.d.ts +15 -4
  6. package/resources/end-users.d.ts.map +1 -1
  7. package/resources/end-users.js +9 -2
  8. package/resources/end-users.js.map +1 -1
  9. package/resources/end-users.mjs +9 -2
  10. package/resources/end-users.mjs.map +1 -1
  11. package/resources/qbd/bill-check-payments.d.mts +1 -1
  12. package/resources/qbd/bill-check-payments.d.ts +1 -1
  13. package/resources/qbd/bill-check-payments.js +1 -1
  14. package/resources/qbd/bill-check-payments.mjs +1 -1
  15. package/resources/qbd/bill-credit-card-payments.d.mts +1 -1
  16. package/resources/qbd/bill-credit-card-payments.d.ts +1 -1
  17. package/resources/qbd/bill-credit-card-payments.js +1 -1
  18. package/resources/qbd/bill-credit-card-payments.mjs +1 -1
  19. package/resources/qbd/bills.d.mts +1 -1
  20. package/resources/qbd/bills.d.ts +1 -1
  21. package/resources/qbd/bills.js +1 -1
  22. package/resources/qbd/bills.mjs +1 -1
  23. package/resources/qbd/build-assemblies.d.mts +1 -1
  24. package/resources/qbd/build-assemblies.d.ts +1 -1
  25. package/resources/qbd/build-assemblies.js +1 -1
  26. package/resources/qbd/build-assemblies.mjs +1 -1
  27. package/resources/qbd/checks.d.mts +2 -2
  28. package/resources/qbd/checks.d.ts +2 -2
  29. package/resources/qbd/checks.js +2 -2
  30. package/resources/qbd/checks.mjs +2 -2
  31. package/resources/qbd/credit-card-charges.d.mts +1 -1
  32. package/resources/qbd/credit-card-charges.d.ts +1 -1
  33. package/resources/qbd/credit-card-charges.js +1 -1
  34. package/resources/qbd/credit-card-charges.mjs +1 -1
  35. package/resources/qbd/credit-card-credits.d.mts +1 -1
  36. package/resources/qbd/credit-card-credits.d.ts +1 -1
  37. package/resources/qbd/credit-card-credits.js +1 -1
  38. package/resources/qbd/credit-card-credits.mjs +1 -1
  39. package/resources/qbd/credit-card-refunds.d.mts +1 -1
  40. package/resources/qbd/credit-card-refunds.d.ts +1 -1
  41. package/resources/qbd/credit-card-refunds.js +1 -1
  42. package/resources/qbd/credit-card-refunds.mjs +1 -1
  43. package/resources/qbd/credit-memos.d.mts +2 -2
  44. package/resources/qbd/credit-memos.d.ts +2 -2
  45. package/resources/qbd/credit-memos.js +2 -2
  46. package/resources/qbd/credit-memos.mjs +2 -2
  47. package/resources/qbd/deposits.d.mts +1 -1
  48. package/resources/qbd/deposits.d.ts +1 -1
  49. package/resources/qbd/deposits.js +1 -1
  50. package/resources/qbd/deposits.mjs +1 -1
  51. package/resources/qbd/estimates.d.mts +1 -1
  52. package/resources/qbd/estimates.d.ts +1 -1
  53. package/resources/qbd/estimates.js +1 -1
  54. package/resources/qbd/estimates.mjs +1 -1
  55. package/resources/qbd/index.d.mts +2 -0
  56. package/resources/qbd/index.d.mts.map +1 -1
  57. package/resources/qbd/index.d.ts +2 -0
  58. package/resources/qbd/index.d.ts.map +1 -1
  59. package/resources/qbd/index.js +6 -2
  60. package/resources/qbd/index.js.map +1 -1
  61. package/resources/qbd/index.mjs +2 -0
  62. package/resources/qbd/index.mjs.map +1 -1
  63. package/resources/qbd/inventory-adjustments.d.mts +1 -1
  64. package/resources/qbd/inventory-adjustments.d.ts +1 -1
  65. package/resources/qbd/inventory-adjustments.js +1 -1
  66. package/resources/qbd/inventory-adjustments.mjs +1 -1
  67. package/resources/qbd/invoices.d.mts +1 -1
  68. package/resources/qbd/invoices.d.ts +1 -1
  69. package/resources/qbd/invoices.js +1 -1
  70. package/resources/qbd/invoices.mjs +1 -1
  71. package/resources/qbd/item-receipts.d.mts +2 -2
  72. package/resources/qbd/item-receipts.d.ts +2 -2
  73. package/resources/qbd/item-receipts.js +2 -2
  74. package/resources/qbd/item-receipts.mjs +2 -2
  75. package/resources/qbd/journal-entries.d.mts +2 -2
  76. package/resources/qbd/journal-entries.d.ts +2 -2
  77. package/resources/qbd/journal-entries.js +2 -2
  78. package/resources/qbd/journal-entries.mjs +2 -2
  79. package/resources/qbd/purchase-orders.d.mts +1 -1
  80. package/resources/qbd/purchase-orders.d.ts +1 -1
  81. package/resources/qbd/purchase-orders.js +1 -1
  82. package/resources/qbd/purchase-orders.mjs +1 -1
  83. package/resources/qbd/qbd.d.mts +8 -0
  84. package/resources/qbd/qbd.d.mts.map +1 -1
  85. package/resources/qbd/qbd.d.ts +8 -0
  86. package/resources/qbd/qbd.d.ts.map +1 -1
  87. package/resources/qbd/qbd.js +8 -0
  88. package/resources/qbd/qbd.js.map +1 -1
  89. package/resources/qbd/qbd.mjs +8 -0
  90. package/resources/qbd/qbd.mjs.map +1 -1
  91. package/resources/qbd/receive-payments.d.mts +1 -1
  92. package/resources/qbd/receive-payments.d.ts +1 -1
  93. package/resources/qbd/receive-payments.js +1 -1
  94. package/resources/qbd/receive-payments.mjs +1 -1
  95. package/resources/qbd/sales-orders.d.mts +2 -2
  96. package/resources/qbd/sales-orders.d.ts +2 -2
  97. package/resources/qbd/sales-orders.js +2 -2
  98. package/resources/qbd/sales-orders.mjs +2 -2
  99. package/resources/qbd/sales-receipts.d.mts +2 -2
  100. package/resources/qbd/sales-receipts.d.ts +2 -2
  101. package/resources/qbd/sales-receipts.js +2 -2
  102. package/resources/qbd/sales-receipts.mjs +2 -2
  103. package/resources/qbd/sales-tax-group-items.d.mts +417 -0
  104. package/resources/qbd/sales-tax-group-items.d.mts.map +1 -0
  105. package/resources/qbd/sales-tax-group-items.d.ts +417 -0
  106. package/resources/qbd/sales-tax-group-items.d.ts.map +1 -0
  107. package/resources/qbd/sales-tax-group-items.js +102 -0
  108. package/resources/qbd/sales-tax-group-items.js.map +1 -0
  109. package/resources/qbd/sales-tax-group-items.mjs +98 -0
  110. package/resources/qbd/sales-tax-group-items.mjs.map +1 -0
  111. package/resources/qbd/sales-tax-payment-checks.d.mts +809 -0
  112. package/resources/qbd/sales-tax-payment-checks.d.mts.map +1 -0
  113. package/resources/qbd/sales-tax-payment-checks.d.ts +809 -0
  114. package/resources/qbd/sales-tax-payment-checks.d.ts.map +1 -0
  115. package/resources/qbd/sales-tax-payment-checks.js +146 -0
  116. package/resources/qbd/sales-tax-payment-checks.js.map +1 -0
  117. package/resources/qbd/sales-tax-payment-checks.mjs +142 -0
  118. package/resources/qbd/sales-tax-payment-checks.mjs.map +1 -0
  119. package/resources/qbd/time-tracking-activities.d.mts +3 -3
  120. package/resources/qbd/time-tracking-activities.d.ts +3 -3
  121. package/resources/qbd/time-tracking-activities.js +3 -3
  122. package/resources/qbd/time-tracking-activities.mjs +3 -3
  123. package/resources/qbd/vendor-credits.d.mts +2 -2
  124. package/resources/qbd/vendor-credits.d.ts +2 -2
  125. package/resources/qbd/vendor-credits.js +2 -2
  126. package/resources/qbd/vendor-credits.mjs +2 -2
  127. package/src/resources/end-users.ts +15 -4
  128. package/src/resources/qbd/bill-check-payments.ts +1 -1
  129. package/src/resources/qbd/bill-credit-card-payments.ts +1 -1
  130. package/src/resources/qbd/bills.ts +1 -1
  131. package/src/resources/qbd/build-assemblies.ts +1 -1
  132. package/src/resources/qbd/checks.ts +2 -2
  133. package/src/resources/qbd/credit-card-charges.ts +1 -1
  134. package/src/resources/qbd/credit-card-credits.ts +1 -1
  135. package/src/resources/qbd/credit-card-refunds.ts +1 -1
  136. package/src/resources/qbd/credit-memos.ts +2 -2
  137. package/src/resources/qbd/deposits.ts +1 -1
  138. package/src/resources/qbd/estimates.ts +1 -1
  139. package/src/resources/qbd/index.ts +22 -0
  140. package/src/resources/qbd/inventory-adjustments.ts +1 -1
  141. package/src/resources/qbd/invoices.ts +1 -1
  142. package/src/resources/qbd/item-receipts.ts +2 -2
  143. package/src/resources/qbd/journal-entries.ts +2 -2
  144. package/src/resources/qbd/purchase-orders.ts +1 -1
  145. package/src/resources/qbd/qbd.ts +55 -0
  146. package/src/resources/qbd/receive-payments.ts +1 -1
  147. package/src/resources/qbd/sales-orders.ts +2 -2
  148. package/src/resources/qbd/sales-receipts.ts +2 -2
  149. package/src/resources/qbd/sales-tax-group-items.ts +533 -0
  150. package/src/resources/qbd/sales-tax-payment-checks.ts +1014 -0
  151. package/src/resources/qbd/time-tracking-activities.ts +3 -3
  152. package/src/resources/qbd/vendor-credits.ts +2 -2
  153. package/src/version.ts +1 -1
  154. package/version.d.mts +1 -1
  155. package/version.d.ts +1 -1
  156. package/version.js +1 -1
  157. package/version.mjs +1 -1
@@ -0,0 +1,809 @@
1
+ import { APIResource } from "../../core/resource.mjs";
2
+ import { APIPromise } from "../../core/api-promise.mjs";
3
+ import { CursorPage, type CursorPageParams, PagePromise } from "../../core/pagination.mjs";
4
+ import { RequestOptions } from "../../internal/request-options.mjs";
5
+ export declare class SalesTaxPaymentChecks extends APIResource {
6
+ /**
7
+ * Creates a new sales-tax payment check.
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * const salesTaxPaymentCheck =
12
+ * await conductor.qbd.salesTaxPaymentChecks.create({
13
+ * bankAccountId: '80000001-1234567890',
14
+ * lines: [{ amount: '1000.00' }],
15
+ * transactionDate: '2024-10-01',
16
+ * vendorId: '80000001-1234567890',
17
+ * conductorEndUserId: 'end_usr_1234567abcdefg',
18
+ * });
19
+ * ```
20
+ */
21
+ create(params: SalesTaxPaymentCheckCreateParams, options?: RequestOptions): APIPromise<SalesTaxPaymentCheck>;
22
+ /**
23
+ * Retrieves a sales-tax payment check by ID.
24
+ *
25
+ * **IMPORTANT:** If you need to fetch multiple specific sales-tax payment checks
26
+ * by ID, use the list endpoint instead with the `ids` parameter. It accepts an
27
+ * array of IDs so you can batch the request into a single call, which is
28
+ * significantly faster.
29
+ *
30
+ * @example
31
+ * ```ts
32
+ * const salesTaxPaymentCheck =
33
+ * await conductor.qbd.salesTaxPaymentChecks.retrieve(
34
+ * '123ABC-1234567890',
35
+ * { conductorEndUserId: 'end_usr_1234567abcdefg' },
36
+ * );
37
+ * ```
38
+ */
39
+ retrieve(id: string, params: SalesTaxPaymentCheckRetrieveParams, options?: RequestOptions): APIPromise<SalesTaxPaymentCheck>;
40
+ /**
41
+ * Updates an existing sales-tax payment check.
42
+ *
43
+ * @example
44
+ * ```ts
45
+ * const salesTaxPaymentCheck =
46
+ * await conductor.qbd.salesTaxPaymentChecks.update(
47
+ * '123ABC-1234567890',
48
+ * {
49
+ * revisionNumber: '1721172183',
50
+ * conductorEndUserId: 'end_usr_1234567abcdefg',
51
+ * },
52
+ * );
53
+ * ```
54
+ */
55
+ update(id: string, params: SalesTaxPaymentCheckUpdateParams, options?: RequestOptions): APIPromise<SalesTaxPaymentCheck>;
56
+ /**
57
+ * Returns a list of sales-tax payment checks. Use the `cursor` parameter to
58
+ * paginate through the results.
59
+ *
60
+ * @example
61
+ * ```ts
62
+ * // Automatically fetches more pages as needed.
63
+ * for await (const salesTaxPaymentCheck of conductor.qbd.salesTaxPaymentChecks.list(
64
+ * { conductorEndUserId: 'end_usr_1234567abcdefg' },
65
+ * )) {
66
+ * // ...
67
+ * }
68
+ * ```
69
+ */
70
+ list(params: SalesTaxPaymentCheckListParams, options?: RequestOptions): PagePromise<SalesTaxPaymentChecksCursorPage, SalesTaxPaymentCheck>;
71
+ /**
72
+ * Permanently deletes a sales-tax payment check. The deletion will fail if the
73
+ * sales-tax payment check is currently in use or has any linked transactions that
74
+ * are in use.
75
+ *
76
+ * @example
77
+ * ```ts
78
+ * const salesTaxPaymentCheck =
79
+ * await conductor.qbd.salesTaxPaymentChecks.delete(
80
+ * '123ABC-1234567890',
81
+ * { conductorEndUserId: 'end_usr_1234567abcdefg' },
82
+ * );
83
+ * ```
84
+ */
85
+ delete(id: string, params: SalesTaxPaymentCheckDeleteParams, options?: RequestOptions): APIPromise<SalesTaxPaymentCheckDeleteResponse>;
86
+ /**
87
+ * Voids a sales-tax payment check by setting its amount to zero while keeping a
88
+ * record of it in QuickBooks. The void will fail if the sales-tax payment check is
89
+ * currently in use or has any linked transactions that are in use.
90
+ *
91
+ * @example
92
+ * ```ts
93
+ * const response =
94
+ * await conductor.qbd.salesTaxPaymentChecks.void(
95
+ * '123ABC-1234567890',
96
+ * { conductorEndUserId: 'end_usr_1234567abcdefg' },
97
+ * );
98
+ * ```
99
+ */
100
+ void(id: string, params: SalesTaxPaymentCheckVoidParams, options?: RequestOptions): APIPromise<SalesTaxPaymentCheckVoidResponse>;
101
+ }
102
+ export type SalesTaxPaymentChecksCursorPage = CursorPage<SalesTaxPaymentCheck>;
103
+ export interface SalesTaxPaymentCheck {
104
+ /**
105
+ * The unique identifier assigned by QuickBooks to this sales-tax payment check.
106
+ * This ID is unique across all transaction types.
107
+ */
108
+ id: string;
109
+ /**
110
+ * The address that is printed on the sales-tax payment check.
111
+ */
112
+ address: SalesTaxPaymentCheck.Address | null;
113
+ /**
114
+ * The total monetary amount of this sales-tax payment check, represented as a
115
+ * decimal string. This equals the sum of the amounts in the sales-tax payment
116
+ * check lines.
117
+ */
118
+ amount: string;
119
+ /**
120
+ * The bank account from which the funds are being drawn for this sales-tax payment
121
+ * check; e.g., Checking or Savings. This sales-tax payment check will decrease the
122
+ * balance of this account.
123
+ */
124
+ bankAccount: SalesTaxPaymentCheck.BankAccount;
125
+ /**
126
+ * The date and time when this sales-tax payment check was created, in ISO 8601
127
+ * format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the
128
+ * local timezone of the end-user's computer.
129
+ */
130
+ createdAt: string;
131
+ /**
132
+ * The custom fields for the sales-tax payment check object, added as user-defined
133
+ * data extensions, not included in the standard QuickBooks object.
134
+ */
135
+ customFields: Array<SalesTaxPaymentCheck.CustomField>;
136
+ /**
137
+ * A globally unique identifier (GUID) you, the developer, can provide for tracking
138
+ * this object in your external system. This field is immutable and can only be set
139
+ * during object creation.
140
+ */
141
+ externalId: string | null;
142
+ /**
143
+ * Indicates whether this sales-tax payment check is included in the queue of
144
+ * documents for QuickBooks to print.
145
+ */
146
+ isQueuedForPrint: boolean | null;
147
+ /**
148
+ * The payment lines in this sales-tax payment check, each recording an amount paid
149
+ * toward a sales-tax item.
150
+ */
151
+ lines: Array<SalesTaxPaymentCheck.Line>;
152
+ /**
153
+ * A memo or note for this sales-tax payment check.
154
+ */
155
+ memo: string | null;
156
+ /**
157
+ * The type of object. This value is always `"qbd_sales_tax_payment_check"`.
158
+ */
159
+ objectType: 'qbd_sales_tax_payment_check';
160
+ /**
161
+ * The case-sensitive user-defined reference number for this sales-tax payment
162
+ * check, which can be used to identify the transaction in QuickBooks. This value
163
+ * is not required to be unique and can be arbitrarily changed by the QuickBooks
164
+ * user.
165
+ *
166
+ * **IMPORTANT**: For checks, this field is the check number.
167
+ */
168
+ refNumber: string | null;
169
+ /**
170
+ * The current QuickBooks-assigned revision number of this sales-tax payment check
171
+ * object, which changes each time the object is modified. When updating this
172
+ * object, you must provide the most recent `revisionNumber` to ensure you're
173
+ * working with the latest data; otherwise, the update will return an error.
174
+ */
175
+ revisionNumber: string;
176
+ /**
177
+ * The date of this sales-tax payment check, in ISO 8601 format (YYYY-MM-DD).
178
+ */
179
+ transactionDate: string;
180
+ /**
181
+ * The date and time when this sales-tax payment check was last updated, in ISO
182
+ * 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in
183
+ * the local timezone of the end-user's computer.
184
+ */
185
+ updatedAt: string;
186
+ /**
187
+ * The sales-tax agency, represented as a QuickBooks vendor, receiving this
188
+ * sales-tax payment check. This must match the tax vendor associated with the
189
+ * sales-tax items in the payment lines.
190
+ */
191
+ vendor: SalesTaxPaymentCheck.Vendor | null;
192
+ }
193
+ export declare namespace SalesTaxPaymentCheck {
194
+ /**
195
+ * The address that is printed on the sales-tax payment check.
196
+ */
197
+ interface Address {
198
+ /**
199
+ * The city, district, suburb, town, or village name of the address.
200
+ */
201
+ city: string | null;
202
+ /**
203
+ * The country name of the address.
204
+ */
205
+ country: string | null;
206
+ /**
207
+ * The first line of the address (e.g., street, PO Box, or company name).
208
+ */
209
+ line1: string | null;
210
+ /**
211
+ * The second line of the address, if needed (e.g., apartment, suite, unit, or
212
+ * building).
213
+ */
214
+ line2: string | null;
215
+ /**
216
+ * The third line of the address, if needed.
217
+ */
218
+ line3: string | null;
219
+ /**
220
+ * The fourth line of the address, if needed.
221
+ */
222
+ line4: string | null;
223
+ /**
224
+ * The fifth line of the address, if needed.
225
+ */
226
+ line5: string | null;
227
+ /**
228
+ * A note written at the bottom of the address in the form in which it appears,
229
+ * such as the invoice form.
230
+ */
231
+ note: string | null;
232
+ /**
233
+ * The postal code or ZIP code of the address.
234
+ */
235
+ postalCode: string | null;
236
+ /**
237
+ * The state, county, province, or region name of the address.
238
+ */
239
+ state: string | null;
240
+ }
241
+ /**
242
+ * The bank account from which the funds are being drawn for this sales-tax payment
243
+ * check; e.g., Checking or Savings. This sales-tax payment check will decrease the
244
+ * balance of this account.
245
+ */
246
+ interface BankAccount {
247
+ /**
248
+ * The unique identifier assigned by QuickBooks to this object. This ID is unique
249
+ * across all objects of the same type, but not across different QuickBooks object
250
+ * types.
251
+ */
252
+ id: string | null;
253
+ /**
254
+ * The fully-qualified unique name for this object, formed by combining the names
255
+ * of its parent objects with its own `name`, separated by colons. Not
256
+ * case-sensitive.
257
+ */
258
+ fullName: string | null;
259
+ }
260
+ interface CustomField {
261
+ /**
262
+ * The name of the custom field, unique for the specified `ownerId`. For public
263
+ * custom fields, this name is visible as a label in the QuickBooks UI.
264
+ */
265
+ name: string;
266
+ /**
267
+ * The identifier of the owner of the custom field, which QuickBooks internally
268
+ * calls a "data extension". For public custom fields visible in the UI, such as
269
+ * those added by the QuickBooks user, this is always "0". For private custom
270
+ * fields that are only visible to the application that created them, this is a
271
+ * valid GUID identifying the owning application. Internally, Conductor always
272
+ * fetches all public custom fields (those with an `ownerId` of "0") for all
273
+ * objects.
274
+ */
275
+ ownerId: string;
276
+ /**
277
+ * The data type of this custom field.
278
+ */
279
+ type: 'amount_type' | 'date_time_type' | 'integer_type' | 'percent_type' | 'price_type' | 'quantity_type' | 'string_1024_type' | 'string_255_type';
280
+ /**
281
+ * The value of this custom field. The maximum length depends on the field's data
282
+ * type.
283
+ */
284
+ value: string;
285
+ }
286
+ interface Line {
287
+ /**
288
+ * The unique identifier assigned by QuickBooks to this sales-tax payment check
289
+ * line. This ID is unique across all transaction line types.
290
+ */
291
+ id: string;
292
+ /**
293
+ * The sales-tax payment amount paid toward this line's sales-tax item, represented
294
+ * as a decimal string.
295
+ */
296
+ amount: string | null;
297
+ /**
298
+ * The type of object. This value is always `"qbd_sales_tax_payment_check_line"`.
299
+ */
300
+ objectType: 'qbd_sales_tax_payment_check_line';
301
+ /**
302
+ * The sales-tax item whose payable balance this sales-tax payment check line is
303
+ * paying.
304
+ */
305
+ salesTaxItem: Line.SalesTaxItem | null;
306
+ /**
307
+ * The sales-tax amount due on this sales-tax payment check line, represented as a
308
+ * decimal string. QuickBooks Desktop returns this field only for Australian
309
+ * company files.
310
+ */
311
+ taxAmount: string | null;
312
+ }
313
+ namespace Line {
314
+ /**
315
+ * The sales-tax item whose payable balance this sales-tax payment check line is
316
+ * paying.
317
+ */
318
+ interface SalesTaxItem {
319
+ /**
320
+ * The unique identifier assigned by QuickBooks to this object. This ID is unique
321
+ * across all objects of the same type, but not across different QuickBooks object
322
+ * types.
323
+ */
324
+ id: string | null;
325
+ /**
326
+ * The fully-qualified unique name for this object, formed by combining the names
327
+ * of its parent objects with its own `name`, separated by colons. Not
328
+ * case-sensitive.
329
+ */
330
+ fullName: string | null;
331
+ }
332
+ }
333
+ /**
334
+ * The sales-tax agency, represented as a QuickBooks vendor, receiving this
335
+ * sales-tax payment check. This must match the tax vendor associated with the
336
+ * sales-tax items in the payment lines.
337
+ */
338
+ interface Vendor {
339
+ /**
340
+ * The unique identifier assigned by QuickBooks to this object. This ID is unique
341
+ * across all objects of the same type, but not across different QuickBooks object
342
+ * types.
343
+ */
344
+ id: string | null;
345
+ /**
346
+ * The fully-qualified unique name for this object, formed by combining the names
347
+ * of its parent objects with its own `name`, separated by colons. Not
348
+ * case-sensitive.
349
+ */
350
+ fullName: string | null;
351
+ }
352
+ }
353
+ export interface SalesTaxPaymentCheckDeleteResponse {
354
+ /**
355
+ * The QuickBooks-assigned unique identifier of the deleted sales-tax payment
356
+ * check.
357
+ */
358
+ id: string;
359
+ /**
360
+ * Indicates whether the sales-tax payment check was deleted.
361
+ */
362
+ deleted: boolean;
363
+ /**
364
+ * The type of object. This value is always `"qbd_sales_tax_payment_check"`.
365
+ */
366
+ objectType: 'qbd_sales_tax_payment_check';
367
+ /**
368
+ * The case-sensitive user-defined reference number of the deleted sales-tax
369
+ * payment check.
370
+ */
371
+ refNumber: string | null;
372
+ }
373
+ export interface SalesTaxPaymentCheckVoidResponse {
374
+ /**
375
+ * The QuickBooks-assigned unique identifier of the voided sales-tax payment check.
376
+ */
377
+ id: string;
378
+ /**
379
+ * The date and time when this sales-tax payment check was created, in ISO 8601
380
+ * format (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the
381
+ * local timezone of the end-user's computer.
382
+ */
383
+ createdAt: string | null;
384
+ /**
385
+ * The type of object. This value is always `"qbd_sales_tax_payment_check"`.
386
+ */
387
+ objectType: 'qbd_sales_tax_payment_check';
388
+ /**
389
+ * The case-sensitive user-defined reference number of the voided sales-tax payment
390
+ * check.
391
+ */
392
+ refNumber: string | null;
393
+ /**
394
+ * The date and time when this sales-tax payment check was last updated, in ISO
395
+ * 8601 format (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in
396
+ * the local timezone of the end-user's computer.
397
+ */
398
+ updatedAt: string | null;
399
+ /**
400
+ * Indicates whether the sales-tax payment check was voided.
401
+ */
402
+ voided: boolean;
403
+ }
404
+ export interface SalesTaxPaymentCheckCreateParams {
405
+ /**
406
+ * Body param: The bank account from which the funds are being drawn for this
407
+ * sales-tax payment check; e.g., Checking or Savings. This sales-tax payment check
408
+ * will decrease the balance of this account.
409
+ */
410
+ bankAccountId: string;
411
+ /**
412
+ * Body param: The payment lines in this sales-tax payment check, each recording an
413
+ * amount paid toward a sales-tax item.
414
+ */
415
+ lines: Array<SalesTaxPaymentCheckCreateParams.Line>;
416
+ /**
417
+ * Body param: The date of this sales-tax payment check, in ISO 8601 format
418
+ * (YYYY-MM-DD).
419
+ */
420
+ transactionDate: string;
421
+ /**
422
+ * Body param: The sales-tax agency, represented as a QuickBooks vendor, receiving
423
+ * this sales-tax payment check. This must match the tax vendor associated with the
424
+ * sales-tax items in the payment lines.
425
+ */
426
+ vendorId: string;
427
+ /**
428
+ * Header param: The ID of the End-User to receive this request.
429
+ */
430
+ conductorEndUserId: string;
431
+ /**
432
+ * Body param: The address that is printed on the sales-tax payment check.
433
+ */
434
+ address?: SalesTaxPaymentCheckCreateParams.Address;
435
+ /**
436
+ * Body param: A globally unique identifier (GUID) you, the developer, can provide
437
+ * for tracking this object in your external system. This field is immutable and
438
+ * can only be set during object creation.
439
+ *
440
+ * **IMPORTANT**: This field must be formatted as a valid GUID; otherwise,
441
+ * QuickBooks will return an error.
442
+ */
443
+ externalId?: string;
444
+ /**
445
+ * Body param: Indicates whether this sales-tax payment check is included in the
446
+ * queue of documents for QuickBooks to print.
447
+ */
448
+ isQueuedForPrint?: boolean;
449
+ /**
450
+ * Body param: A memo or note for this sales-tax payment check.
451
+ */
452
+ memo?: string;
453
+ /**
454
+ * Body param: The case-sensitive user-defined reference number for this sales-tax
455
+ * payment check, which can be used to identify the transaction in QuickBooks. This
456
+ * value is not required to be unique and can be arbitrarily changed by the
457
+ * QuickBooks user. When left blank in this create request, this field will be left
458
+ * blank in QuickBooks (i.e., it does _not_ auto-increment).
459
+ *
460
+ * **IMPORTANT**: For checks, this field is the check number.
461
+ *
462
+ * Maximum length: 11 characters.
463
+ */
464
+ refNumber?: string;
465
+ }
466
+ export declare namespace SalesTaxPaymentCheckCreateParams {
467
+ interface Line {
468
+ /**
469
+ * The sales-tax payment amount paid toward this line's sales-tax item, represented
470
+ * as a decimal string.
471
+ *
472
+ * Decimal string format: exactly 2 decimal places when cents are included and up
473
+ * to 13 digits before the decimal point (for example, "123.45").
474
+ */
475
+ amount: string;
476
+ /**
477
+ * The sales-tax item whose payable balance this sales-tax payment check line is
478
+ * paying.
479
+ */
480
+ salesTaxItemId?: string;
481
+ }
482
+ /**
483
+ * The address that is printed on the sales-tax payment check.
484
+ */
485
+ interface Address {
486
+ /**
487
+ * The city, district, suburb, town, or village name of the address.
488
+ *
489
+ * Maximum length: 31 characters.
490
+ */
491
+ city?: string;
492
+ /**
493
+ * The country name of the address.
494
+ */
495
+ country?: string;
496
+ /**
497
+ * The first line of the address (e.g., street, PO Box, or company name).
498
+ *
499
+ * Maximum length: 41 characters.
500
+ */
501
+ line1?: string;
502
+ /**
503
+ * The second line of the address, if needed (e.g., apartment, suite, unit, or
504
+ * building).
505
+ *
506
+ * Maximum length: 41 characters.
507
+ */
508
+ line2?: string;
509
+ /**
510
+ * The third line of the address, if needed.
511
+ *
512
+ * Maximum length: 41 characters.
513
+ */
514
+ line3?: string;
515
+ /**
516
+ * The fourth line of the address, if needed.
517
+ *
518
+ * Maximum length: 41 characters.
519
+ */
520
+ line4?: string;
521
+ /**
522
+ * The fifth line of the address, if needed.
523
+ *
524
+ * Maximum length: 41 characters.
525
+ */
526
+ line5?: string;
527
+ /**
528
+ * A note written at the bottom of the address in the form in which it appears,
529
+ * such as the invoice form.
530
+ */
531
+ note?: string;
532
+ /**
533
+ * The postal code or ZIP code of the address.
534
+ *
535
+ * Maximum length: 13 characters.
536
+ */
537
+ postalCode?: string;
538
+ /**
539
+ * The state, county, province, or region name of the address.
540
+ *
541
+ * Maximum length: 21 characters.
542
+ */
543
+ state?: string;
544
+ }
545
+ }
546
+ export interface SalesTaxPaymentCheckRetrieveParams {
547
+ /**
548
+ * The ID of the End-User to receive this request.
549
+ */
550
+ conductorEndUserId: string;
551
+ }
552
+ export interface SalesTaxPaymentCheckUpdateParams {
553
+ /**
554
+ * Body param: The current QuickBooks-assigned revision number of the sales-tax
555
+ * payment check object you are updating, which you can get by fetching the object
556
+ * first. Provide the most recent `revisionNumber` to ensure you're working with
557
+ * the latest data; otherwise, the update will return an error.
558
+ */
559
+ revisionNumber: string;
560
+ /**
561
+ * Header param: The ID of the End-User to receive this request.
562
+ */
563
+ conductorEndUserId: string;
564
+ /**
565
+ * Body param: The address that is printed on the sales-tax payment check.
566
+ */
567
+ address?: SalesTaxPaymentCheckUpdateParams.Address;
568
+ /**
569
+ * Body param: The bank account from which the funds are being drawn for this
570
+ * sales-tax payment check; e.g., Checking or Savings. This sales-tax payment check
571
+ * will decrease the balance of this account.
572
+ */
573
+ bankAccountId?: string;
574
+ /**
575
+ * Body param: Indicates whether this sales-tax payment check is included in the
576
+ * queue of documents for QuickBooks to print.
577
+ */
578
+ isQueuedForPrint?: boolean;
579
+ /**
580
+ * Body param: A memo or note for this sales-tax payment check.
581
+ */
582
+ memo?: string;
583
+ /**
584
+ * Body param: The case-sensitive user-defined reference number for this sales-tax
585
+ * payment check, which can be used to identify the transaction in QuickBooks. This
586
+ * value is not required to be unique and can be arbitrarily changed by the
587
+ * QuickBooks user.
588
+ *
589
+ * **IMPORTANT**: For checks, this field is the check number.
590
+ *
591
+ * Maximum length: 11 characters.
592
+ */
593
+ refNumber?: string;
594
+ /**
595
+ * Body param: The date of this sales-tax payment check, in ISO 8601 format
596
+ * (YYYY-MM-DD).
597
+ */
598
+ transactionDate?: string;
599
+ }
600
+ export declare namespace SalesTaxPaymentCheckUpdateParams {
601
+ /**
602
+ * The address that is printed on the sales-tax payment check.
603
+ */
604
+ interface Address {
605
+ /**
606
+ * The city, district, suburb, town, or village name of the address.
607
+ *
608
+ * Maximum length: 31 characters.
609
+ */
610
+ city?: string;
611
+ /**
612
+ * The country name of the address.
613
+ */
614
+ country?: string;
615
+ /**
616
+ * The first line of the address (e.g., street, PO Box, or company name).
617
+ *
618
+ * Maximum length: 41 characters.
619
+ */
620
+ line1?: string;
621
+ /**
622
+ * The second line of the address, if needed (e.g., apartment, suite, unit, or
623
+ * building).
624
+ *
625
+ * Maximum length: 41 characters.
626
+ */
627
+ line2?: string;
628
+ /**
629
+ * The third line of the address, if needed.
630
+ *
631
+ * Maximum length: 41 characters.
632
+ */
633
+ line3?: string;
634
+ /**
635
+ * The fourth line of the address, if needed.
636
+ *
637
+ * Maximum length: 41 characters.
638
+ */
639
+ line4?: string;
640
+ /**
641
+ * The fifth line of the address, if needed.
642
+ *
643
+ * Maximum length: 41 characters.
644
+ */
645
+ line5?: string;
646
+ /**
647
+ * A note written at the bottom of the address in the form in which it appears,
648
+ * such as the invoice form.
649
+ */
650
+ note?: string;
651
+ /**
652
+ * The postal code or ZIP code of the address.
653
+ *
654
+ * Maximum length: 13 characters.
655
+ */
656
+ postalCode?: string;
657
+ /**
658
+ * The state, county, province, or region name of the address.
659
+ *
660
+ * Maximum length: 21 characters.
661
+ */
662
+ state?: string;
663
+ }
664
+ }
665
+ export interface SalesTaxPaymentCheckListParams extends CursorPageParams {
666
+ /**
667
+ * Header param: The ID of the End-User to receive this request.
668
+ */
669
+ conductorEndUserId: string;
670
+ /**
671
+ * Query param: Filter for sales-tax payment checks associated with these accounts.
672
+ */
673
+ accountIds?: Array<string>;
674
+ /**
675
+ * Query param: Filter for specific sales-tax payment checks by their
676
+ * QuickBooks-assigned unique identifier(s).
677
+ *
678
+ * **IMPORTANT**: If you include this parameter, QuickBooks will ignore all other
679
+ * query parameters for this request.
680
+ *
681
+ * **NOTE**: If any of the values you specify in this parameter are not found, the
682
+ * request will return an error.
683
+ */
684
+ ids?: Array<string>;
685
+ /**
686
+ * Query param: Whether to include line items in the response. Defaults to `true`.
687
+ */
688
+ includeLineItems?: boolean;
689
+ /**
690
+ * Query param: Filter for sales-tax payment checks containing these items.
691
+ */
692
+ itemIds?: Array<string>;
693
+ /**
694
+ * Query param: Filter for sales-tax payment checks whose `refNumber` contains this
695
+ * substring.
696
+ *
697
+ * **NOTE**: If you use this parameter, you cannot also use `refNumberStartsWith`
698
+ * or `refNumberEndsWith`.
699
+ */
700
+ refNumberContains?: string;
701
+ /**
702
+ * Query param: Filter for sales-tax payment checks whose `refNumber` ends with
703
+ * this substring.
704
+ *
705
+ * **NOTE**: If you use this parameter, you cannot also use `refNumberContains` or
706
+ * `refNumberStartsWith`.
707
+ */
708
+ refNumberEndsWith?: string;
709
+ /**
710
+ * Query param: Filter for sales-tax payment checks whose `refNumber` is greater
711
+ * than or equal to this value. If omitted, the range will begin with the first
712
+ * number of the list. Uses a numerical comparison for values that contain only
713
+ * digits; otherwise, uses a lexicographical comparison.
714
+ */
715
+ refNumberFrom?: string;
716
+ /**
717
+ * Query param: Filter for specific sales-tax payment checks by their
718
+ * ref-number(s), case-sensitive. In QuickBooks, ref-numbers are not required to be
719
+ * unique and can be arbitrarily changed by the QuickBooks user.
720
+ *
721
+ * **IMPORTANT**: If you include this parameter, QuickBooks will ignore all other
722
+ * query parameters for this request.
723
+ *
724
+ * **NOTE**: If any of the values you specify in this parameter are not found, the
725
+ * request will return an error.
726
+ */
727
+ refNumbers?: Array<string>;
728
+ /**
729
+ * Query param: Filter for sales-tax payment checks whose `refNumber` starts with
730
+ * this substring.
731
+ *
732
+ * **NOTE**: If you use this parameter, you cannot also use `refNumberContains` or
733
+ * `refNumberEndsWith`.
734
+ */
735
+ refNumberStartsWith?: string;
736
+ /**
737
+ * Query param: Filter for sales-tax payment checks whose `refNumber` is less than
738
+ * or equal to this value. If omitted, the range will end with the last number of
739
+ * the list. Uses a numerical comparison for values that contain only digits;
740
+ * otherwise, uses a lexicographical comparison.
741
+ */
742
+ refNumberTo?: string;
743
+ /**
744
+ * Query param: Filter for sales-tax payment checks whose `date` field is on or
745
+ * after this date, in ISO 8601 format (YYYY-MM-DD).
746
+ *
747
+ * **NOTE:** QuickBooks Desktop interprets this date as the **start of the
748
+ * specified day** in the local timezone of the end-user's computer (e.g.,
749
+ * `2025-01-01` → `2025-01-01T00:00:00`).
750
+ */
751
+ transactionDateFrom?: string;
752
+ /**
753
+ * Query param: Filter for sales-tax payment checks whose `date` field is on or
754
+ * before this date, in ISO 8601 format (YYYY-MM-DD).
755
+ *
756
+ * **NOTE:** QuickBooks Desktop interprets this date as the **end of the specified
757
+ * day** in the local timezone of the end-user's computer (e.g., `2025-01-01` →
758
+ * `2025-01-01T23:59:59`).
759
+ */
760
+ transactionDateTo?: string;
761
+ /**
762
+ * Query param: Filter for sales-tax payment checks updated on or after this
763
+ * date/time. Accepts the following ISO 8601 formats:
764
+ *
765
+ * - **date-only** (YYYY-MM-DD) - QuickBooks Desktop interprets the date as the
766
+ * **start of the specified day** in the local timezone of the end-user's
767
+ * computer (e.g., `2025-01-01` → `2025-01-01T00:00:00`).
768
+ * - **datetime without timezone** (YYYY-MM-DDTHH:mm:ss) - QuickBooks Desktop
769
+ * interprets the timestamp in the local timezone of the end-user's computer.
770
+ * - **datetime with timezone** (YYYY-MM-DDTHH:mm:ss±HH:mm) - QuickBooks Desktop
771
+ * interprets the timestamp using the specified timezone.
772
+ */
773
+ updatedAfter?: string;
774
+ /**
775
+ * Query param: Filter for sales-tax payment checks updated on or before this
776
+ * date/time. Accepts the following ISO 8601 formats:
777
+ *
778
+ * - **date-only** (YYYY-MM-DD) - QuickBooks Desktop interprets the date as the
779
+ * **end of the specified day** in the local timezone of the end-user's computer
780
+ * (e.g., `2025-01-01` → `2025-01-01T23:59:59`).
781
+ * - **datetime without timezone** (YYYY-MM-DDTHH:mm:ss) - QuickBooks Desktop
782
+ * interprets the timestamp in the local timezone of the end-user's computer.
783
+ * - **datetime with timezone** (YYYY-MM-DDTHH:mm:ss±HH:mm) - QuickBooks Desktop
784
+ * interprets the timestamp using the specified timezone.
785
+ */
786
+ updatedBefore?: string;
787
+ /**
788
+ * Query param: Filter for sales-tax payment checks paid to these vendors. These
789
+ * are the sales-tax agencies, represented as QuickBooks vendors, paid by these
790
+ * checks.
791
+ */
792
+ vendorIds?: Array<string>;
793
+ }
794
+ export interface SalesTaxPaymentCheckDeleteParams {
795
+ /**
796
+ * The ID of the End-User to receive this request.
797
+ */
798
+ conductorEndUserId: string;
799
+ }
800
+ export interface SalesTaxPaymentCheckVoidParams {
801
+ /**
802
+ * The ID of the End-User to receive this request.
803
+ */
804
+ conductorEndUserId: string;
805
+ }
806
+ export declare namespace SalesTaxPaymentChecks {
807
+ export { type SalesTaxPaymentCheck as SalesTaxPaymentCheck, type SalesTaxPaymentCheckDeleteResponse as SalesTaxPaymentCheckDeleteResponse, type SalesTaxPaymentCheckVoidResponse as SalesTaxPaymentCheckVoidResponse, type SalesTaxPaymentChecksCursorPage as SalesTaxPaymentChecksCursorPage, type SalesTaxPaymentCheckCreateParams as SalesTaxPaymentCheckCreateParams, type SalesTaxPaymentCheckRetrieveParams as SalesTaxPaymentCheckRetrieveParams, type SalesTaxPaymentCheckUpdateParams as SalesTaxPaymentCheckUpdateParams, type SalesTaxPaymentCheckListParams as SalesTaxPaymentCheckListParams, type SalesTaxPaymentCheckDeleteParams as SalesTaxPaymentCheckDeleteParams, type SalesTaxPaymentCheckVoidParams as SalesTaxPaymentCheckVoidParams, };
808
+ }
809
+ //# sourceMappingURL=sales-tax-payment-checks.d.mts.map