chargebee 2.28.0 → 2.30.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 (54) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.yml +81 -0
  2. package/.github/ISSUE_TEMPLATE/config.yml +6 -0
  3. package/.github/ISSUE_TEMPLATE/feature_request.yml +34 -0
  4. package/.github/PULL_REQUEST_TEMPLATE.md +8 -0
  5. package/.github/workflows/greeting.yml +47 -0
  6. package/CHANGELOG.md +59 -0
  7. package/SECURITY.md +8 -0
  8. package/lib/chargebee.js +1 -1
  9. package/lib/resources/api_endpoints.js +0 -14
  10. package/package.json +1 -1
  11. package/types/core.d.ts +4 -4
  12. package/types/resources/AttachedItem.d.ts +88 -88
  13. package/types/resources/Card.d.ts +68 -68
  14. package/types/resources/Comment.d.ts +50 -44
  15. package/types/resources/Coupon.d.ts +242 -207
  16. package/types/resources/CouponSet.d.ts +72 -68
  17. package/types/resources/CreditNote.d.ts +612 -236
  18. package/types/resources/Customer.d.ts +655 -513
  19. package/types/resources/DifferentialPrice.d.ts +99 -74
  20. package/types/resources/EntitlementOverride.d.ts +27 -12
  21. package/types/resources/Estimate.d.ts +450 -450
  22. package/types/resources/Event.d.ts +30 -12
  23. package/types/resources/Export.d.ts +200 -200
  24. package/types/resources/Feature.d.ts +66 -35
  25. package/types/resources/Gift.d.ts +54 -44
  26. package/types/resources/HostedPage.d.ts +381 -381
  27. package/types/resources/InAppSubscription.d.ts +94 -90
  28. package/types/resources/Invoice.d.ts +1242 -660
  29. package/types/resources/Item.d.ts +148 -142
  30. package/types/resources/ItemEntitlement.d.ts +36 -36
  31. package/types/resources/ItemFamily.d.ts +45 -45
  32. package/types/resources/ItemPrice.d.ts +317 -273
  33. package/types/resources/PaymentIntent.d.ts +60 -60
  34. package/types/resources/PaymentReferenceNumber.d.ts +1 -1
  35. package/types/resources/PaymentVoucher.d.ts +74 -59
  36. package/types/resources/PortalSession.d.ts +45 -20
  37. package/types/resources/PromotionalCredit.d.ts +68 -68
  38. package/types/resources/Purchase.d.ts +3 -3
  39. package/types/resources/Quote.d.ts +655 -366
  40. package/types/resources/QuoteLineGroup.d.ts +245 -0
  41. package/types/resources/QuotedCharge.d.ts +170 -0
  42. package/types/resources/QuotedSubscription.d.ts +219 -0
  43. package/types/resources/SiteMigrationDetail.d.ts +7 -7
  44. package/types/resources/Subscription.d.ts +1219 -932
  45. package/types/resources/SubscriptionEntitlement.d.ts +33 -12
  46. package/types/resources/ThirdPartyPaymentMethod.d.ts +1 -1
  47. package/types/resources/TimeMachine.d.ts +15 -15
  48. package/types/resources/Token.d.ts +0 -116
  49. package/types/resources/Transaction.d.ts +229 -112
  50. package/types/resources/UnbilledCharge.d.ts +112 -67
  51. package/types/resources/Usage.d.ts +46 -47
  52. package/types/resources/VirtualBankAccount.d.ts +66 -66
  53. package/types/resources/Media.d.ts +0 -33
  54. package/types/resources/NonSubscription.d.ts +0 -65
@@ -23,6 +23,11 @@ declare module 'chargebee' {
23
23
 
24
24
  item_family_id?:string;
25
25
 
26
+ /**
27
+ * @description Identifier of the product
28
+
29
+ */
30
+
26
31
  product_id?:string;
27
32
 
28
33
  /**
@@ -33,7 +38,9 @@ declare module 'chargebee' {
33
38
  item_id?:string;
34
39
 
35
40
  /**
36
- * @description Description of the item price.
41
+ * @description Description of the item price.
42
+ **Note:**
43
+ If your input contains characters that are subjected to sanitization (like incomplete HTML tags), the sanitization process might increase the length of your input. If the sanitized input exceeds the limit, your request will be rejected.
37
44
 
38
45
  */
39
46
 
@@ -218,7 +225,7 @@ In-App Subscriptions is currently in early access. Contact [eap@chargebee.com](m
218
225
  is_taxable?:boolean;
219
226
 
220
227
  /**
221
- * @description A set of key-value pairs stored as additional information for the item price. [Learn more](./#meta_data).
228
+ * @description A collection of key-value pairs that provides extra information about the item price. [Learn more](advanced-features#metadata).
222
229
 
223
230
  */
224
231
 
@@ -269,11 +276,11 @@ In-App Subscriptions is currently in early access. Contact [eap@chargebee.com](m
269
276
  export namespace ItemPrice {
270
277
  export class ItemPriceResource {
271
278
  /**
272
- * @description Returns the set of all applicable [addon-items](items?prod_cat_ver=2#addon-items) for a specific [plan-item price](item_prices?prod_cat_ver=2#types). This set consists of all addon-items whose item prices can be applied to a subscription having the plan-item price in it. When determining this set, Chargebee considers the [item_applicability](items?prod_cat_ver=2#item_item_applicability) and [applicable_items](items?prod_cat_ver=2#item_applicable_items) defined for the parent item of the plan-item price.
279
+ * @description This API creates an item price (a price point) for an [item](./items?prod_cat_ver=2).
273
280
 
274
281
  */
275
282
 
276
- find_applicable_items(item_price_id:string, input?:FindApplicableItemsInputParam):ChargebeeRequest<FindApplicableItemsResponse>;
283
+ create(input:CreateInputParam):ChargebeeRequest<CreateResponse>;
277
284
 
278
285
  /**
279
286
  * @description This API retrieves a specific item price using the id.
@@ -289,6 +296,13 @@ In-App Subscriptions is currently in early access. Contact [eap@chargebee.com](m
289
296
 
290
297
  update(item_price_id:string, input?:UpdateInputParam):ChargebeeRequest<UpdateResponse>;
291
298
 
299
+ /**
300
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
301
+
302
+ */
303
+
304
+ list(input?:ListInputParam):ChargebeeRequest<ListResponse>;
305
+
292
306
  /**
293
307
  * @description Deletes an item price, marking its &#x60;status&#x60; as &#x60;deleted&#x60;. If it is part of a subscription or invoice, the item price &#x60;status&#x60; is marked &#x60;archived&#x60; instead. Once deleted, the &#x60;id&#x60; and &#x60;name&#x60; of the item price can be reused to create a new item price.
294
308
 
@@ -296,6 +310,13 @@ In-App Subscriptions is currently in early access. Contact [eap@chargebee.com](m
296
310
 
297
311
  delete(item_price_id:string):ChargebeeRequest<DeleteResponse>;
298
312
 
313
+ /**
314
+ * @description Returns the set of all applicable [addon-items](items?prod_cat_ver&#x3D;2#addon-items) for a specific [plan-item price](item_prices?prod_cat_ver&#x3D;2#types). This set consists of all addon-items whose item prices can be applied to a subscription having the plan-item price in it. When determining this set, Chargebee considers the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price.
315
+
316
+ */
317
+
318
+ find_applicable_items(item_price_id:string, input?:FindApplicableItemsInputParam):ChargebeeRequest<FindApplicableItemsResponse>;
319
+
299
320
  /**
300
321
  * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
301
322
 
@@ -309,58 +330,219 @@ If an addon-item price has [differential pricing](differential_prices?prod_cat_v
309
330
  */
310
331
 
311
332
  find_applicable_item_prices(item_price_id:string, input?:FindApplicableItemPricesInputParam):ChargebeeRequest<FindApplicableItemPricesResponse>;
333
+ }
334
+ export interface CreateResponse {
335
+ item_price:ItemPrice;
336
+ }
337
+ export interface CreateInputParam {
338
+ [key : string] : any;
339
+ /**
340
+ * @description The identifier for the item price. It is unique and immutable.
341
+
342
+ */
343
+
344
+ id:string;
312
345
 
313
346
  /**
314
- * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
347
+ * @description A unique display name for the item price in the Chargebee UI. If &#x60;external_name&#x60; is not provided, this is also used in customer-facing pages and documents such as [invoices](./invoices?prod_cat_ver&#x3D;2) and [hosted pages](hosted_pages?prod_cat_ver&#x3D;2).
315
348
 
316
349
  */
317
-
318
- list(input?:ListInputParam):ChargebeeRequest<ListResponse>;
350
+
351
+ name:string;
319
352
 
320
353
  /**
321
- * @description This API creates an item price (a price point) for an [item](./items?prod_cat_ver&#x3D;2).
354
+ * @description Description of the item price.
355
+ **Note:**
356
+ If your input contains characters that are subjected to sanitization (like incomplete HTML tags), the sanitization process might increase the length of your input. If the sanitized input exceeds the limit, your request will be rejected.
322
357
 
323
358
  */
324
-
325
- create(input:CreateInputParam):ChargebeeRequest<CreateResponse>;
326
- }
327
- export interface FindApplicableItemsResponse {
359
+
360
+ description?:string;
361
+
328
362
  /**
329
- * @description Returns the set of all applicable [addon-items](items?prod_cat_ver&#x3D;2#addon-items) for a specific [plan-item price](item_prices?prod_cat_ver&#x3D;2#types). This set consists of all addon-items whose item prices can be applied to a subscription having the plan-item price in it. When determining this set, Chargebee considers the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price.
363
+ * @description The id of the item that the item price belongs to.
330
364
 
331
365
  */
332
366
 
333
- list:{item:Item}[];
367
+ item_id:string;
334
368
 
335
369
  /**
336
- * @description Returns the set of all applicable [addon-items](items?prod_cat_ver&#x3D;2#addon-items) for a specific [plan-item price](item_prices?prod_cat_ver&#x3D;2#types). This set consists of all addon-items whose item prices can be applied to a subscription having the plan-item price in it. When determining this set, Chargebee considers the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price.
370
+ * @description A customer-facing note added to all invoices associated with this API resource. This note becomes one among [all the notes](/docs/api/invoices#invoice_notes) displayed on the invoice PDF.
337
371
 
338
372
  */
339
373
 
340
- next_offset?:string;
341
- }
342
- export interface FindApplicableItemsInputParam {
343
- [key : string]: any;
374
+ invoice_notes?:string;
375
+
344
376
  /**
345
- * @description The number of resources to be returned.
377
+ * @description The name of the item price used in customer-facing pages and documents. These include [invoices](./invoices?prod_cat_ver&#x3D;2) and [hosted pages](hosted_pages?prod_cat_ver&#x3D;2). If not provided, then &#x60;name&#x60; is used.
346
378
 
347
379
  */
348
-
349
- limit?:number;
380
+
381
+ external_name?:string;
350
382
 
351
383
  /**
352
- * @description Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set \&#x60;offset\&#x60; to the value of \&#x60;next_offset\&#x60; obtained in the previous iteration of the API call.
384
+ * @description The currency code ([ISO 4217 format](https://www.chargebee.com/docs/supported-currencies.html)) for the item price. Is required when multiple currencies have been enabled.
353
385
 
354
386
  */
355
-
356
- offset?:string;
387
+
388
+ currency_code?:string;
357
389
 
358
390
  /**
359
- * @description Returns the set of all applicable [addon-items](items?prod_cat_ver&#x3D;2#addon-items) for a specific [plan-item price](item_prices?prod_cat_ver&#x3D;2#types). This set consists of all addon-items whose item prices can be applied to a subscription having the plan-item price in it. When determining this set, Chargebee considers the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price.
391
+ * @description Specifies whether taxes apply to this item price. This value is set and returned even if [Taxes](https://www.chargebee.com/docs/tax.html) have been disabled in Chargebee. However, the value is effective only while Taxes are enabled.
360
392
 
361
393
  */
362
-
363
- sort_by?:{asc?:'updated_at' | 'name' | 'id',desc?:'updated_at' | 'name' | 'id'};
394
+
395
+ is_taxable?:boolean;
396
+
397
+ /**
398
+ * @description Free quantity the subscriptions of this item_price will have. Only the quantity more than this will be charged for the subscription.
399
+
400
+ */
401
+
402
+ free_quantity?:number;
403
+
404
+ /**
405
+ * @description The quantity of the item that is available free-of-charge, represented in decimal. When a subscription is created for this plan or when the plan of a subscription is changed to this one, only the quantity above this number is charged for. Applicable for quantity-based plans and only when [multi-decimal pricing](https://apidocs.chargebee.com/docs/api#handling_currency_units) is enabled.
406
+
407
+ */
408
+
409
+ free_quantity_in_decimal?:string;
410
+
411
+ /**
412
+ * @description A collection of key-value pairs that provides extra information about the item price.
413
+ **Note:** There&#x27;s a character limit of 65,535.
414
+ [Learn more](advanced-features#metadata).
415
+
416
+ */
417
+
418
+ metadata?:object;
419
+
420
+ /**
421
+ * @description Whether the item price&#x27;s description should be shown on [invoice PDFs](/docs/api/invoices#retrieve_invoice_as_pdf). If this Boolean is changed, only invoices generated (or [regenerated](https://www.chargebee.com/docs/invoice-operations.html#actions-for-payment-due-not-paid-invoices_regenerate-invoice)) after the change are affected; past invoices are not.
422
+
423
+ */
424
+
425
+ show_description_in_invoices?:boolean;
426
+
427
+ /**
428
+ * @description Whether the item price&#x27;s description should be shown on [quote PDFs](/docs/api/quotes#retrieve_quote_as_pdf). If this Boolean is changed, only quotes created after the change are affected; past quotes are not.
429
+
430
+ */
431
+
432
+ show_description_in_quotes?:boolean;
433
+
434
+ /**
435
+ * @description The [pricing scheme](https://www.chargebee.com/docs/2.0/plans.html#pricing-models) for this item price. If subscriptions, invoices or [differential prices](./differential_prices?prod_cat_ver&#x3D;2) exist for this item price, &#x60;pricing_model&#x60; cannot be changed.
436
+ \* tiered - The per unit price is based on the tier that the total quantity falls in.
437
+ \* per_unit - A fixed price per unit quantity.
438
+ \* flat_fee - A fixed price that is not quantity-based.
439
+ \* volume - There are quantity tiers for which per unit prices are set. Quantities are purchased from successive tiers.
440
+ \* stairstep - A quantity-based pricing scheme. The item is charged a fixed price based on the tier that the total quantity falls in.
441
+
442
+ */
443
+
444
+ pricing_model?:PricingModel;
445
+
446
+ /**
447
+ * @description The cost of the item price when the pricing model is &#x60;flat_fee&#x60;. When the pricing model is &#x60;per_unit&#x60;, it is the price per unit quantity of the item. Not applicable for the other pricing models. The value is in the [minor unit of the currency](https://apidocs.chargebee.com/docs/api#handling_currency_units).
448
+
449
+ */
450
+
451
+ price?:number;
452
+
453
+ /**
454
+ * @description The price of the item when the pricing_model is &#x60;flat_fee&#x60;. When the pricing model is &#x60;per_unit&#x60;, it is the price per unit quantity of the item. Not applicable for the other pricing models. The value is in decimal and in major units of the currency. Also, this is only applicable when [multi-decimal pricing](https://apidocs.chargebee.com/docs/api#handling_currency_units) is enabled.
455
+
456
+ */
457
+
458
+ price_in_decimal?:string;
459
+
460
+ /**
461
+ * @description The unit of time for &#x60;period&#x60;. If subscriptions or invoices exist for this item price, &#x60;period_unit&#x60; cannot be changed. The &#x60;period_unit&#x60; is mandatory when the item &#x60;type&#x60; is &#x60;plan&#x60; or &#x60;addon&#x60;. \* month - A period of 1 calendar month. \* week - A period of 7 days. \* year - A period of 1 calendar year. \* day - A period of 24 hours.
462
+
463
+ */
464
+
465
+ period_unit?:'week' | 'month' | 'year' | 'day';
466
+
467
+ /**
468
+ * @description
469
+
470
+ * When the item &#x60;type&#x60; is &#x60;plan&#x60;: The billing period of the plan in &#x60;period_unit&#x60;s. For example, create a 6 month plan by providing &#x60;period&#x60; as 6 and &#x60;period_unit&#x60; as month.
471
+ * When item &#x60;type&#x60; is &#x60;addon&#x60;: The period of the addon in &#x60;period_unit&#x60;s. For example, create an addon with a 2 month &#x60;period&#x60; by providing period as 2 and &#x60;period_unit&#x60; as &#x60;month&#x60;. The period of an addon is the duration for which its &#x60;price&#x60; applies. When attached to a plan, the addon is billed for the billing period of the plan. [Learn more.](https://www.chargebee.com/docs/2.0/addons-billingcycle.html)
472
+
473
+
474
+
475
+ If subscriptions or invoices exist for this item price, &#x60;period&#x60; cannot be changed. The &#x60;period&#x60; is mandatory when the item &#x60;type&#x60; is &#x60;plan&#x60; or &#x60;addon&#x60;.
476
+
477
+ */
478
+
479
+ period?:number;
480
+
481
+ /**
482
+ * @description The unit of time for &#x60;trial_period&#x60;. \* month - A period of 1 calendar month. \* day - A period of 24 hours.
483
+
484
+ */
485
+
486
+ trial_period_unit?:'month' | 'day';
487
+
488
+ /**
489
+ * @description The trial period of the plan in &#x60;trial_period_unit&#x60;s. You can also set [trial periods for addons](https://www.chargebee.com/docs/2.0/addons-trial.html); contact [Support](https://chargebee.freshdesk.com/support/home) to enable that feature.
490
+
491
+ */
492
+
493
+ trial_period?:number;
494
+
495
+ /**
496
+ * @description Defines the shipping frequency. Example: to bill customer every 2 weeks, provide &quot;2&quot; here.
497
+
498
+ */
499
+
500
+ shipping_period?:number;
501
+
502
+ /**
503
+ * @description Defines the shipping frequency in association with shipping period. \* day - A period of 24 hours. \* week - A period of 7 days. \* year - A period of 1 calendar year. \* month - A period of 1 calendar month.
504
+
505
+ */
506
+
507
+ shipping_period_unit?:'week' | 'month' | 'year' | 'day';
508
+
509
+ /**
510
+ * @description The default number of billing cycles a subscription to the plan must run. Can be [overridden](./subscriptions?prod_cat_ver&#x3D;2) for a subscription.
511
+
512
+ Addons can also [have billing cycles](https://www.chargebee.com/docs/2.0/addons-billingcycle.html). However, you must contact [Support](https://chargebee.freshdesk.com/support/home) to enable that. Also, for addons, you can [override this](./attached_items?prod_cat_ver&#x3D;2) while attaching it to a plan. However, if you provide the value while [applying the addon to a subscription](./subscriptions?prod_cat_ver&#x3D;2#subscription_subscription_items_item_type), then that value takes still higher precedence.
513
+ If subscriptions, invoices or [differential prices](./differential_prices?prod_cat_ver&#x3D;2) exist for this item price, &#x60;billing_cycles&#x60; cannot be changed.
514
+
515
+ */
516
+
517
+ billing_cycles?:number;
518
+
519
+ /**
520
+ * @description Applicable only when [End-of-trial Action](https://www.chargebee.com/docs/trial_periods.html#how-to-define-the-end-of-trial-actions-for-subscriptions) has been enabled for the site. Specifies the operation to be carried out for the subscription once the trial ends. Whenever the &#x60;item.type&#x60; is &#x60;plan&#x60; and a trial period is defined for this item price, this attribute (parameter) is returned (required). This can be overridden at the [subscription-level](subscriptions?prod_cat_ver&#x3D;2#subscription_trial_end_action). \* cancel_subscription - The subscription cancels. \* activate_subscription - The subscription activates and charges are raised for non-metered items. \* site_default - The action [configured for the site](https://www.chargebee.com/docs/trial_periods.html#how-to-define-the-end-of-trial-actions-for-subscriptions) at the time when the trial ends, takes effect.
521
+
522
+ */
523
+
524
+ trial_end_action?:'activate_subscription' | 'cancel_subscription' | 'site_default';
525
+
526
+ /**
527
+ * @description Parameters for tax_detail
528
+
529
+ */
530
+
531
+ tax_detail?:{avalara_sale_type?:AvalaraSaleType,avalara_service_type?:number,avalara_tax_code?:string,avalara_transaction_type?:number,hsn_code?:string,tax_profile_id?:string,taxjar_product_code?:string};
532
+
533
+ /**
534
+ * @description Parameters for accounting_detail
535
+
536
+ */
537
+
538
+ accounting_detail?:{accounting_category1?:string,accounting_category2?:string,accounting_category3?:string,accounting_category4?:string,accounting_code?:string,sku?:string};
539
+
540
+ /**
541
+ * @description Parameters for tiers
542
+
543
+ */
544
+
545
+ tiers?:{ending_unit?:number,ending_unit_in_decimal?:string,price?:number,price_in_decimal?:string,starting_unit?:number,starting_unit_in_decimal?:string}[];
364
546
  }
365
547
  export interface RetrieveResponse {
366
548
  item_price:ItemPrice;
@@ -379,7 +561,9 @@ If an addon-item price has [differential pricing](differential_prices?prod_cat_v
379
561
  name?:string;
380
562
 
381
563
  /**
382
- * @description Description of the item price.
564
+ * @description Description of the item price.
565
+ **Note:**
566
+ If your input contains characters that are subjected to sanitization (like incomplete HTML tags), the sanitization process might increase the length of your input. If the sanitized input exceeds the limit, your request will be rejected.
383
567
 
384
568
  */
385
569
 
@@ -435,7 +619,9 @@ If an addon-item price has [differential pricing](differential_prices?prod_cat_v
435
619
  free_quantity_in_decimal?:string;
436
620
 
437
621
  /**
438
- * @description A set of key-value pairs stored as additional information for the item price. [Learn more](./#meta_data).
622
+ * @description A collection of key-value pairs that provides extra information about the item price.
623
+ **Note:** There&#x27;s a character limit of 65,535.
624
+ [Learn more](advanced-features#metadata).
439
625
 
440
626
  */
441
627
 
@@ -568,207 +754,130 @@ If subscriptions, invoices or [differential prices](./differential_prices?prod_c
568
754
 
569
755
  tiers?:{ending_unit?:number,ending_unit_in_decimal?:string,price?:number,price_in_decimal?:string,starting_unit?:number,starting_unit_in_decimal?:string}[];
570
756
  }
571
- export interface DeleteResponse {
572
- item_price:ItemPrice;
573
- }
574
-
575
- export interface FindApplicableItemPricesResponse {
757
+ export interface ListResponse {
576
758
  /**
577
- * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
578
-
579
- * the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price
580
- * the [compatibility](subscriptions?prod_cat_ver&#x3D;2#compatibility) of the addon-item prices to the plan-item price
581
-
582
- **Note**
583
-
584
- If an addon-item price has [differential pricing](differential_prices?prod_cat_ver&#x3D;2) defined against the parent item of the plan-item price, then the pricing information in the addon-item price object returned, reflects the differential pricing.
759
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
585
760
 
586
761
  */
587
762
 
588
763
  list:{item_price:ItemPrice}[];
589
764
 
590
765
  /**
591
- * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
592
-
593
- * the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price
594
- * the [compatibility](subscriptions?prod_cat_ver&#x3D;2#compatibility) of the addon-item prices to the plan-item price
595
-
596
- **Note**
597
-
598
- If an addon-item price has [differential pricing](differential_prices?prod_cat_ver&#x3D;2) defined against the parent item of the plan-item price, then the pricing information in the addon-item price object returned, reflects the differential pricing.
766
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
599
767
 
600
768
  */
601
769
 
602
770
  next_offset?:string;
603
771
  }
604
- export interface FindApplicableItemPricesInputParam {
772
+ export interface ListInputParam {
605
773
  [key : string]: any;
606
774
  /**
607
- * @description The number of resources to be returned.
775
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
608
776
 
609
777
  */
610
778
 
611
779
  limit?:number;
612
780
 
613
781
  /**
614
- * @description Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set \&#x60;offset\&#x60; to the value of \&#x60;next_offset\&#x60; obtained in the previous iteration of the API call.
782
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
615
783
 
616
784
  */
617
785
 
618
786
  offset?:string;
619
787
 
620
788
  /**
621
- * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
622
-
623
- * the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price
624
- * the [compatibility](subscriptions?prod_cat_ver&#x3D;2#compatibility) of the addon-item prices to the plan-item price
625
-
626
- **Note**
627
-
628
- If an addon-item price has [differential pricing](differential_prices?prod_cat_ver&#x3D;2) defined against the parent item of the plan-item price, then the pricing information in the addon-item price object returned, reflects the differential pricing.
629
-
630
- */
631
-
632
- item_id?:string;
633
-
634
- /**
635
- * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
636
-
637
- * the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price
638
- * the [compatibility](subscriptions?prod_cat_ver&#x3D;2#compatibility) of the addon-item prices to the plan-item price
639
-
640
- **Note**
641
-
642
- If an addon-item price has [differential pricing](differential_prices?prod_cat_ver&#x3D;2) defined against the parent item of the plan-item price, then the pricing information in the addon-item price object returned, reflects the differential pricing.
643
-
644
- */
645
-
646
- sort_by?:{asc?:'updated_at' | 'name' | 'id',desc?:'updated_at' | 'name' | 'id'};
647
- }
648
- export interface ListResponse {
649
- /**
650
- * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
651
-
652
- */
653
-
654
- list:{item_price:ItemPrice}[];
655
-
656
- /**
657
- * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
658
-
659
- */
660
-
661
- next_offset?:string;
662
- }
663
- export interface ListInputParam {
664
- [key : string]: any;
665
- /**
666
- * @description The number of resources to be returned.
667
-
668
- */
669
-
670
- limit?:number;
671
-
672
- /**
673
- * @description Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set \&#x60;offset\&#x60; to the value of \&#x60;next_offset\&#x60; obtained in the previous iteration of the API call.
674
-
675
- */
676
-
677
- offset?:string;
678
-
679
- /**
680
- * @description Filter item prices based on their [id](#).
789
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
681
790
 
682
791
  */
683
792
 
684
793
  id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
685
794
 
686
795
  /**
687
- * @description Filter item prices based on their &#x60;name&#x60;s.
796
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
688
797
 
689
798
  */
690
799
 
691
800
  name?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
692
801
 
693
802
  /**
694
- * @description Filter item prices based on their &#x60;pricing_model&#x60;.
803
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
695
804
 
696
805
  */
697
806
 
698
807
  pricing_model?:{in?:string,is?:'volume' | 'per_unit' | 'tiered' | 'flat_fee' | 'stairstep',is_not?:'volume' | 'per_unit' | 'tiered' | 'flat_fee' | 'stairstep',not_in?:string};
699
808
 
700
809
  /**
701
- * @description Filter item prices based on their &#x60;item_id&#x60;.
810
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
702
811
 
703
812
  */
704
813
 
705
814
  item_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
706
815
 
707
816
  /**
708
- * @description Filter item prices based on &#x60;item_family_id&#x60;.
817
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
709
818
 
710
819
  */
711
820
 
712
821
  item_family_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
713
822
 
714
823
  /**
715
- * @description Filter item prices based on &#x60;item_type&#x60;.
824
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
716
825
 
717
826
  */
718
827
 
719
828
  item_type?:{in?:string,is?:'charge' | 'addon' | 'plan',is_not?:'charge' | 'addon' | 'plan',not_in?:string};
720
829
 
721
830
  /**
722
- * @description Filter item prices based on their &#x60;currency_code&#x60;.
831
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
723
832
 
724
833
  */
725
834
 
726
835
  currency_code?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
727
836
 
728
837
  /**
729
- * @description Filter item prices based on their &#x60;trial_period&#x60;.
838
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
730
839
 
731
840
  */
732
841
 
733
842
  trial_period?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string};
734
843
 
735
844
  /**
736
- * @description Filter item prices based on their &#x60;trial_period_unit&#x60;.
845
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
737
846
 
738
847
  */
739
848
 
740
849
  trial_period_unit?:{in?:string,is?:'month' | 'day',is_not?:'month' | 'day',not_in?:string};
741
850
 
742
851
  /**
743
- * @description Filter item prices based on their &#x60;status&#x60;.
852
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
744
853
 
745
854
  */
746
855
 
747
856
  status?:{in?:string,is?:'archived' | 'deleted' | 'active',is_not?:'archived' | 'deleted' | 'active',not_in?:string};
748
857
 
749
858
  /**
750
- * @description Filter item prices based on their &#x60;updated_at&#x60;.
859
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
751
860
 
752
861
  */
753
862
 
754
863
  updated_at?:{after?:string,before?:string,between?:string,on?:string};
755
864
 
756
865
  /**
757
- * @description Filter item prices based on their &#x60;period_unit&#x60;.
866
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
758
867
 
759
868
  */
760
869
 
761
870
  period_unit?:{in?:string,is?:'week' | 'month' | 'year' | 'day',is_not?:'week' | 'month' | 'year' | 'day',not_in?:string};
762
871
 
763
872
  /**
764
- * @description Filter item prices based on their &#x60;period&#x60;.
873
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
765
874
 
766
875
  */
767
876
 
768
877
  period?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string};
769
878
 
770
879
  /**
771
- * @description The subscription channel this object originated from and is maintained in.
880
+ * @description Returns a list of item prices satisfying **all** the conditions specified in the filter parameters below. The list is sorted by the date of creation in descending order.
772
881
 
773
882
  */
774
883
 
@@ -781,221 +890,156 @@ If an addon-item price has [differential pricing](differential_prices?prod_cat_v
781
890
 
782
891
  sort_by?:{asc?:'updated_at' | 'name' | 'id',desc?:'updated_at' | 'name' | 'id'};
783
892
  }
784
- export interface CreateResponse {
893
+ export interface DeleteResponse {
785
894
  item_price:ItemPrice;
786
895
  }
787
- export interface CreateInputParam {
788
- [key : string] : any;
896
+
897
+ export interface FindApplicableItemsResponse {
789
898
  /**
790
- * @description The identifier for the item price. It is unique and immutable.
899
+ * @description Returns the set of all applicable [addon-items](items?prod_cat_ver&#x3D;2#addon-items) for a specific [plan-item price](item_prices?prod_cat_ver&#x3D;2#types). This set consists of all addon-items whose item prices can be applied to a subscription having the plan-item price in it. When determining this set, Chargebee considers the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price.
791
900
 
792
901
  */
793
902
 
794
- id:string;
903
+ list:{item:Item}[];
795
904
 
796
905
  /**
797
- * @description A unique display name for the item price in the Chargebee UI. If &#x60;external_name&#x60; is not provided, this is also used in customer-facing pages and documents such as [invoices](./invoices?prod_cat_ver&#x3D;2) and [hosted pages](hosted_pages?prod_cat_ver&#x3D;2).
906
+ * @description Returns the set of all applicable [addon-items](items?prod_cat_ver&#x3D;2#addon-items) for a specific [plan-item price](item_prices?prod_cat_ver&#x3D;2#types). This set consists of all addon-items whose item prices can be applied to a subscription having the plan-item price in it. When determining this set, Chargebee considers the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price.
798
907
 
799
908
  */
800
909
 
801
- name:string;
802
-
910
+ next_offset?:string;
911
+ }
912
+ export interface FindApplicableItemsInputParam {
913
+ [key : string]: any;
803
914
  /**
804
- * @description Description of the item price.
915
+ * @description Returns the set of all applicable [addon-items](items?prod_cat_ver&#x3D;2#addon-items) for a specific [plan-item price](item_prices?prod_cat_ver&#x3D;2#types). This set consists of all addon-items whose item prices can be applied to a subscription having the plan-item price in it. When determining this set, Chargebee considers the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price.
805
916
 
806
917
  */
807
-
808
- description?:string;
918
+
919
+ limit?:number;
809
920
 
810
921
  /**
811
- * @description The id of the item that the item price belongs to.
922
+ * @description Returns the set of all applicable [addon-items](items?prod_cat_ver&#x3D;2#addon-items) for a specific [plan-item price](item_prices?prod_cat_ver&#x3D;2#types). This set consists of all addon-items whose item prices can be applied to a subscription having the plan-item price in it. When determining this set, Chargebee considers the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price.
812
923
 
813
924
  */
814
-
815
- item_id:string;
925
+
926
+ offset?:string;
816
927
 
817
928
  /**
818
- * @description A customer-facing note added to all invoices associated with this API resource. This note becomes one among [all the notes](/docs/api/invoices#invoice_notes) displayed on the invoice PDF.
929
+ * @description Returns the set of all applicable [addon-items](items?prod_cat_ver&#x3D;2#addon-items) for a specific [plan-item price](item_prices?prod_cat_ver&#x3D;2#types). This set consists of all addon-items whose item prices can be applied to a subscription having the plan-item price in it. When determining this set, Chargebee considers the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price.
819
930
 
820
931
  */
821
-
822
- invoice_notes?:string;
823
-
932
+
933
+ sort_by?:{asc?:'updated_at' | 'name' | 'id',desc?:'updated_at' | 'name' | 'id'};
934
+ }
935
+ export interface FindApplicableItemPricesResponse {
824
936
  /**
825
- * @description The name of the item price used in customer-facing pages and documents. These include [invoices](./invoices?prod_cat_ver&#x3D;2) and [hosted pages](hosted_pages?prod_cat_ver&#x3D;2). If not provided, then &#x60;name&#x60; is used.
937
+ * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
826
938
 
827
- */
828
-
829
- external_name?:string;
830
-
831
- /**
832
- * @description The currency code ([ISO 4217 format](https://www.chargebee.com/docs/supported-currencies.html)) for the item price. Is required when multiple currencies have been enabled.
939
+ * the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price
940
+ * the [compatibility](subscriptions?prod_cat_ver&#x3D;2#compatibility) of the addon-item prices to the plan-item price
833
941
 
834
- */
835
-
836
- currency_code?:string;
837
-
838
- /**
839
- * @description Specifies whether taxes apply to this item price. This value is set and returned even if [Taxes](https://www.chargebee.com/docs/tax.html) have been disabled in Chargebee. However, the value is effective only while Taxes are enabled.
942
+ **Note**
840
943
 
841
- */
842
-
843
- is_taxable?:boolean;
844
-
845
- /**
846
- * @description Free quantity the subscriptions of this item_price will have. Only the quantity more than this will be charged for the subscription.
944
+ If an addon-item price has [differential pricing](differential_prices?prod_cat_ver&#x3D;2) defined against the parent item of the plan-item price, then the pricing information in the addon-item price object returned, reflects the differential pricing.
847
945
 
848
946
  */
849
947
 
850
- free_quantity?:number;
948
+ list:{item_price:ItemPrice}[];
851
949
 
852
950
  /**
853
- * @description The quantity of the item that is available free-of-charge, represented in decimal. When a subscription is created for this plan or when the plan of a subscription is changed to this one, only the quantity above this number is charged for. Applicable for quantity-based plans and only when [multi-decimal pricing](https://apidocs.chargebee.com/docs/api#handling_currency_units) is enabled.
951
+ * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
854
952
 
855
- */
856
-
857
- free_quantity_in_decimal?:string;
858
-
859
- /**
860
- * @description A set of key-value pairs stored as additional information for the item price. [Learn more](./#meta_data).
953
+ * the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price
954
+ * the [compatibility](subscriptions?prod_cat_ver&#x3D;2#compatibility) of the addon-item prices to the plan-item price
861
955
 
862
- */
863
-
864
- metadata?:object;
865
-
866
- /**
867
- * @description Whether the item price&#x27;s description should be shown on [invoice PDFs](/docs/api/invoices#retrieve_invoice_as_pdf). If this Boolean is changed, only invoices generated (or [regenerated](https://www.chargebee.com/docs/invoice-operations.html#actions-for-payment-due-not-paid-invoices_regenerate-invoice)) after the change are affected; past invoices are not.
956
+ **Note**
868
957
 
869
- */
870
-
871
- show_description_in_invoices?:boolean;
872
-
873
- /**
874
- * @description Whether the item price&#x27;s description should be shown on [quote PDFs](/docs/api/quotes#retrieve_quote_as_pdf). If this Boolean is changed, only quotes created after the change are affected; past quotes are not.
958
+ If an addon-item price has [differential pricing](differential_prices?prod_cat_ver&#x3D;2) defined against the parent item of the plan-item price, then the pricing information in the addon-item price object returned, reflects the differential pricing.
875
959
 
876
960
  */
877
961
 
878
- show_description_in_quotes?:boolean;
879
-
962
+ next_offset?:string;
963
+ }
964
+ export interface FindApplicableItemPricesInputParam {
965
+ [key : string]: any;
880
966
  /**
881
- * @description The [pricing scheme](https://www.chargebee.com/docs/2.0/plans.html#pricing-models) for this item price. If subscriptions, invoices or [differential prices](./differential_prices?prod_cat_ver&#x3D;2) exist for this item price, &#x60;pricing_model&#x60; cannot be changed.
882
- \* tiered - The per unit price is based on the tier that the total quantity falls in.
883
- \* per_unit - A fixed price per unit quantity.
884
- \* flat_fee - A fixed price that is not quantity-based.
885
- \* volume - There are quantity tiers for which per unit prices are set. Quantities are purchased from successive tiers.
886
- \* stairstep - A quantity-based pricing scheme. The item is charged a fixed price based on the tier that the total quantity falls in.
967
+ * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
887
968
 
888
- */
889
-
890
- pricing_model?:PricingModel;
891
-
892
- /**
893
- * @description The cost of the item price when the pricing model is &#x60;flat_fee&#x60;. When the pricing model is &#x60;per_unit&#x60;, it is the price per unit quantity of the item. Not applicable for the other pricing models. The value is in the [minor unit of the currency](https://apidocs.chargebee.com/docs/api#handling_currency_units).
969
+ * the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price
970
+ * the [compatibility](subscriptions?prod_cat_ver&#x3D;2#compatibility) of the addon-item prices to the plan-item price
894
971
 
895
- */
896
-
897
- price?:number;
898
-
899
- /**
900
- * @description The price of the item when the pricing_model is &#x60;flat_fee&#x60;. When the pricing model is &#x60;per_unit&#x60;, it is the price per unit quantity of the item. Not applicable for the other pricing models. The value is in decimal and in major units of the currency. Also, this is only applicable when [multi-decimal pricing](https://apidocs.chargebee.com/docs/api#handling_currency_units) is enabled.
972
+ **Note**
901
973
 
902
- */
903
-
904
- price_in_decimal?:string;
905
-
906
- /**
907
- * @description The unit of time for &#x60;period&#x60;. If subscriptions or invoices exist for this item price, &#x60;period_unit&#x60; cannot be changed. The &#x60;period_unit&#x60; is mandatory when the item &#x60;type&#x60; is &#x60;plan&#x60; or &#x60;addon&#x60;. \* month - A period of 1 calendar month. \* week - A period of 7 days. \* year - A period of 1 calendar year. \* day - A period of 24 hours.
974
+ If an addon-item price has [differential pricing](differential_prices?prod_cat_ver&#x3D;2) defined against the parent item of the plan-item price, then the pricing information in the addon-item price object returned, reflects the differential pricing.
908
975
 
909
976
  */
910
-
911
- period_unit?:'week' | 'month' | 'year' | 'day';
977
+
978
+ limit?:number;
912
979
 
913
980
  /**
914
- * @description
915
-
916
- * When the item &#x60;type&#x60; is &#x60;plan&#x60;: The billing period of the plan in &#x60;period_unit&#x60;s. For example, create a 6 month plan by providing &#x60;period&#x60; as 6 and &#x60;period_unit&#x60; as month.
917
- * When item &#x60;type&#x60; is &#x60;addon&#x60;: The period of the addon in &#x60;period_unit&#x60;s. For example, create an addon with a 2 month &#x60;period&#x60; by providing period as 2 and &#x60;period_unit&#x60; as &#x60;month&#x60;. The period of an addon is the duration for which its &#x60;price&#x60; applies. When attached to a plan, the addon is billed for the billing period of the plan. [Learn more.](https://www.chargebee.com/docs/2.0/addons-billingcycle.html)
981
+ * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
918
982
 
983
+ * the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price
984
+ * the [compatibility](subscriptions?prod_cat_ver&#x3D;2#compatibility) of the addon-item prices to the plan-item price
919
985
 
986
+ **Note**
920
987
 
921
- If subscriptions or invoices exist for this item price, &#x60;period&#x60; cannot be changed. The &#x60;period&#x60; is mandatory when the item &#x60;type&#x60; is &#x60;plan&#x60; or &#x60;addon&#x60;.
988
+ If an addon-item price has [differential pricing](differential_prices?prod_cat_ver&#x3D;2) defined against the parent item of the plan-item price, then the pricing information in the addon-item price object returned, reflects the differential pricing.
922
989
 
923
990
  */
924
-
925
- period?:number;
991
+
992
+ offset?:string;
926
993
 
927
994
  /**
928
- * @description The unit of time for &#x60;trial_period&#x60;. \* month - A period of 1 calendar month. \* day - A period of 24 hours.
995
+ * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
929
996
 
930
- */
931
-
932
- trial_period_unit?:'month' | 'day';
933
-
934
- /**
935
- * @description The trial period of the plan in &#x60;trial_period_unit&#x60;s. You can also set [trial periods for addons](https://www.chargebee.com/docs/2.0/addons-trial.html); contact [Support](https://chargebee.freshdesk.com/support/home) to enable that feature.
997
+ * the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price
998
+ * the [compatibility](subscriptions?prod_cat_ver&#x3D;2#compatibility) of the addon-item prices to the plan-item price
936
999
 
937
- */
938
-
939
- trial_period?:number;
940
-
941
- /**
942
- * @description Defines the shipping frequency. Example: to bill customer every 2 weeks, provide &quot;2&quot; here.
1000
+ **Note**
943
1001
 
944
- */
945
-
946
- shipping_period?:number;
947
-
948
- /**
949
- * @description Defines the shipping frequency in association with shipping period. \* day - A period of 24 hours. \* week - A period of 7 days. \* year - A period of 1 calendar year. \* month - A period of 1 calendar month.
1002
+ If an addon-item price has [differential pricing](differential_prices?prod_cat_ver&#x3D;2) defined against the parent item of the plan-item price, then the pricing information in the addon-item price object returned, reflects the differential pricing.
950
1003
 
951
1004
  */
952
-
953
- shipping_period_unit?:'week' | 'month' | 'year' | 'day';
1005
+
1006
+ item_id?:string;
954
1007
 
955
1008
  /**
956
- * @description The default number of billing cycles a subscription to the plan must run. Can be [overridden](./subscriptions?prod_cat_ver&#x3D;2) for a subscription.
1009
+ * @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver&#x3D;2#types) prices for a specific plan-item price. This set consists of all the addon-item prices that can be applied to a subscription having the plan-item price. When determining this set, Chargebee considers the following:
957
1010
 
958
- Addons can also [have billing cycles](https://www.chargebee.com/docs/2.0/addons-billingcycle.html). However, you must contact [Support](https://chargebee.freshdesk.com/support/home) to enable that. Also, for addons, you can [override this](./attached_items?prod_cat_ver&#x3D;2) while attaching it to a plan. However, if you provide the value while [applying the addon to a subscription](./subscriptions?prod_cat_ver&#x3D;2#subscription_subscription_items_item_type), then that value takes still higher precedence.
959
- If subscriptions, invoices or [differential prices](./differential_prices?prod_cat_ver&#x3D;2) exist for this item price, &#x60;billing_cycles&#x60; cannot be changed.
1011
+ * the [item_applicability](items?prod_cat_ver&#x3D;2#item_item_applicability) and [applicable_items](items?prod_cat_ver&#x3D;2#item_applicable_items) defined for the parent item of the plan-item price
1012
+ * the [compatibility](subscriptions?prod_cat_ver&#x3D;2#compatibility) of the addon-item prices to the plan-item price
960
1013
 
961
- */
962
-
963
- billing_cycles?:number;
964
-
965
- /**
966
- * @description Applicable only when [End-of-trial Action](https://www.chargebee.com/docs/trial_periods.html#how-to-define-the-end-of-trial-actions-for-subscriptions) has been enabled for the site. Specifies the operation to be carried out for the subscription once the trial ends. Whenever the &#x60;item.type&#x60; is &#x60;plan&#x60; and a trial period is defined for this item price, this attribute (parameter) is returned (required). This can be overridden at the [subscription-level](subscriptions?prod_cat_ver&#x3D;2#subscription_trial_end_action). \* cancel_subscription - The subscription cancels. \* activate_subscription - The subscription activates and charges are raised for non-metered items. \* site_default - The action [configured for the site](https://www.chargebee.com/docs/trial_periods.html#how-to-define-the-end-of-trial-actions-for-subscriptions) at the time when the trial ends, takes effect.
1014
+ **Note**
967
1015
 
968
- */
969
-
970
- trial_end_action?:'activate_subscription' | 'cancel_subscription' | 'site_default';
971
-
972
- /**
973
- * @description Parameters for tax_detail
1016
+ If an addon-item price has [differential pricing](differential_prices?prod_cat_ver&#x3D;2) defined against the parent item of the plan-item price, then the pricing information in the addon-item price object returned, reflects the differential pricing.
974
1017
 
975
1018
  */
976
-
977
- tax_detail?:{avalara_sale_type?:AvalaraSaleType,avalara_service_type?:number,avalara_tax_code?:string,avalara_transaction_type?:number,hsn_code?:string,tax_profile_id?:string,taxjar_product_code?:string};
978
-
979
- /**
980
- * @description Parameters for accounting_detail
1019
+
1020
+ sort_by?:{asc?:'updated_at' | 'name' | 'id',desc?:'updated_at' | 'name' | 'id'};
1021
+ }
1022
+ export interface Tier {
1023
+ /**
1024
+ * @description The lower limit of a range of units for the tier
981
1025
 
982
- */
1026
+ */
983
1027
 
984
- accounting_detail?:{accounting_category1?:string,accounting_category2?:string,accounting_category3?:string,accounting_category4?:string,accounting_code?:string,sku?:string};
1028
+ starting_unit:number;
985
1029
 
986
- /**
987
- * @description Parameters for tiers
1030
+ /**
1031
+ * @description The upper limit of a range of units for the tier
988
1032
 
989
- */
990
-
991
- tiers?:{ending_unit?:number,ending_unit_in_decimal?:string,price?:number,price_in_decimal?:string,starting_unit?:number,starting_unit_in_decimal?:string}[];
992
- }
993
- export interface Tier {
994
- starting_unit?:number;
1033
+ */
995
1034
 
996
1035
  ending_unit?:number;
997
1036
 
998
- price?:number;
1037
+ /**
1038
+ * @description The per-unit price for the tier when the &#x60;pricing_model&#x60; is &#x60;tiered&#x60; or &#x60;volume&#x60;; the total cost for the item price when the &#x60;pricing_model&#x60; is &#x60;stairstep&#x60;. The value is in the [minor unit of the currency](https://apidocs.chargebee.com/docs/api#handling_currency_units).
1039
+
1040
+ */
1041
+
1042
+ price:number;
999
1043
 
1000
1044
  starting_unit_in_decimal?:string;
1001
1045
 
@@ -1033,7 +1077,7 @@ If subscriptions, invoices or [differential prices](./differential_prices?prod_c
1033
1077
  avalara_service_type?:number;
1034
1078
 
1035
1079
  /**
1036
- * @description The [Avalara tax codes](https://taxcode.avatax.avalara.com) for the item price. Applicable only if you use [AvaTax for Sales integration](https://www.chargebee.com/docs/2.0/avalara-for-sales.html).
1080
+ * @description The [Avalara tax codes](https://taxcode.avatax.avalara.com) for the item price. Applicable only if you use [AvaTax for Sales integration](https://www.chargebee.com/docs/2.0/avatax-for-sales.html).
1037
1081
 
1038
1082
  */
1039
1083
 
@@ -1043,7 +1087,7 @@ If subscriptions, invoices or [differential prices](./differential_prices?prod_c
1043
1087
  * @description The [HSN code](https://cbic-gst.gov.in/gst-goods-services-rates.html) to which the item is mapped for calculating the customer&#x27;s tax in India. Applicable only when both of the following conditions are true:
1044
1088
 
1045
1089
  * **[India](https://www.chargebee.com/docs/indian-gst.html#configuring-indian-gst)** has been enabled as a **Tax Region**. (An error is returned when this condition is not true.)
1046
- * The [**AvaTax for Sales** integration](\&quot;https://www.chargebee.com/docs/avalara.html\&quot;) has been enabled in Chargebee.
1090
+ * The [**AvaTax for Sales** integration](https://www.chargebee.com/docs/avalara.html) has been enabled in Chargebee.
1047
1091
 
1048
1092
  */
1049
1093