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.
- package/.github/ISSUE_TEMPLATE/bug_report.yml +81 -0
- package/.github/ISSUE_TEMPLATE/config.yml +6 -0
- package/.github/ISSUE_TEMPLATE/feature_request.yml +34 -0
- package/.github/PULL_REQUEST_TEMPLATE.md +8 -0
- package/.github/workflows/greeting.yml +47 -0
- package/CHANGELOG.md +59 -0
- package/SECURITY.md +8 -0
- package/lib/chargebee.js +1 -1
- package/lib/resources/api_endpoints.js +0 -14
- package/package.json +1 -1
- package/types/core.d.ts +4 -4
- package/types/resources/AttachedItem.d.ts +88 -88
- package/types/resources/Card.d.ts +68 -68
- package/types/resources/Comment.d.ts +50 -44
- package/types/resources/Coupon.d.ts +242 -207
- package/types/resources/CouponSet.d.ts +72 -68
- package/types/resources/CreditNote.d.ts +612 -236
- package/types/resources/Customer.d.ts +655 -513
- package/types/resources/DifferentialPrice.d.ts +99 -74
- package/types/resources/EntitlementOverride.d.ts +27 -12
- package/types/resources/Estimate.d.ts +450 -450
- package/types/resources/Event.d.ts +30 -12
- package/types/resources/Export.d.ts +200 -200
- package/types/resources/Feature.d.ts +66 -35
- package/types/resources/Gift.d.ts +54 -44
- package/types/resources/HostedPage.d.ts +381 -381
- package/types/resources/InAppSubscription.d.ts +94 -90
- package/types/resources/Invoice.d.ts +1242 -660
- package/types/resources/Item.d.ts +148 -142
- package/types/resources/ItemEntitlement.d.ts +36 -36
- package/types/resources/ItemFamily.d.ts +45 -45
- package/types/resources/ItemPrice.d.ts +317 -273
- package/types/resources/PaymentIntent.d.ts +60 -60
- package/types/resources/PaymentReferenceNumber.d.ts +1 -1
- package/types/resources/PaymentVoucher.d.ts +74 -59
- package/types/resources/PortalSession.d.ts +45 -20
- package/types/resources/PromotionalCredit.d.ts +68 -68
- package/types/resources/Purchase.d.ts +3 -3
- package/types/resources/Quote.d.ts +655 -366
- package/types/resources/QuoteLineGroup.d.ts +245 -0
- package/types/resources/QuotedCharge.d.ts +170 -0
- package/types/resources/QuotedSubscription.d.ts +219 -0
- package/types/resources/SiteMigrationDetail.d.ts +7 -7
- package/types/resources/Subscription.d.ts +1219 -932
- package/types/resources/SubscriptionEntitlement.d.ts +33 -12
- package/types/resources/ThirdPartyPaymentMethod.d.ts +1 -1
- package/types/resources/TimeMachine.d.ts +15 -15
- package/types/resources/Token.d.ts +0 -116
- package/types/resources/Transaction.d.ts +229 -112
- package/types/resources/UnbilledCharge.d.ts +112 -67
- package/types/resources/Usage.d.ts +46 -47
- package/types/resources/VirtualBankAccount.d.ts +66 -66
- package/types/resources/Media.d.ts +0 -33
- 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
|
|
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
|
|
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
|
-
|
|
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 `status` as `deleted`. If it is part of a subscription or invoice, the item price `status` is marked `archived` instead. Once deleted, the `id` and `name` 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=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.
|
|
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=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
|
|
347
|
+
* @description A unique display name for the item price in the Chargebee UI. If `external_name` is not provided, this is also used in customer-facing pages and documents such as [invoices](./invoices?prod_cat_ver=2) and [hosted pages](hosted_pages?prod_cat_ver=2).
|
|
315
348
|
|
|
316
349
|
*/
|
|
317
|
-
|
|
318
|
-
|
|
350
|
+
|
|
351
|
+
name:string;
|
|
319
352
|
|
|
320
353
|
/**
|
|
321
|
-
* @description
|
|
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
|
-
|
|
326
|
-
|
|
327
|
-
export interface FindApplicableItemsResponse {
|
|
359
|
+
|
|
360
|
+
description?:string;
|
|
361
|
+
|
|
328
362
|
/**
|
|
329
|
-
* @description
|
|
363
|
+
* @description The id of the item that the item price belongs to.
|
|
330
364
|
|
|
331
365
|
*/
|
|
332
366
|
|
|
333
|
-
|
|
367
|
+
item_id:string;
|
|
334
368
|
|
|
335
369
|
/**
|
|
336
|
-
* @description
|
|
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
|
-
|
|
341
|
-
|
|
342
|
-
export interface FindApplicableItemsInputParam {
|
|
343
|
-
[key : string]: any;
|
|
374
|
+
invoice_notes?:string;
|
|
375
|
+
|
|
344
376
|
/**
|
|
345
|
-
* @description The
|
|
377
|
+
* @description The name of the item price used in customer-facing pages and documents. These include [invoices](./invoices?prod_cat_ver=2) and [hosted pages](hosted_pages?prod_cat_ver=2). If not provided, then `name` is used.
|
|
346
378
|
|
|
347
379
|
*/
|
|
348
|
-
|
|
349
|
-
|
|
380
|
+
|
|
381
|
+
external_name?:string;
|
|
350
382
|
|
|
351
383
|
/**
|
|
352
|
-
* @description
|
|
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
|
-
|
|
387
|
+
|
|
388
|
+
currency_code?:string;
|
|
357
389
|
|
|
358
390
|
/**
|
|
359
|
-
* @description
|
|
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
|
-
|
|
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'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'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'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=2) exist for this item price, `pricing_model` 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 `flat_fee`. When the pricing model is `per_unit`, 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 `flat_fee`. When the pricing model is `per_unit`, 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 `period`. If subscriptions or invoices exist for this item price, `period_unit` cannot be changed. The `period_unit` is mandatory when the item `type` is `plan` or `addon`. \* 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 `type` is `plan`: The billing period of the plan in `period_unit`s. For example, create a 6 month plan by providing `period` as 6 and `period_unit` as month.
|
|
471
|
+
* When item `type` is `addon`: The period of the addon in `period_unit`s. For example, create an addon with a 2 month `period` by providing period as 2 and `period_unit` as `month`. The period of an addon is the duration for which its `price` 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, `period` cannot be changed. The `period` is mandatory when the item `type` is `plan` or `addon`.
|
|
476
|
+
|
|
477
|
+
*/
|
|
478
|
+
|
|
479
|
+
period?:number;
|
|
480
|
+
|
|
481
|
+
/**
|
|
482
|
+
* @description The unit of time for `trial_period`. \* 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 `trial_period_unit`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 "2" 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=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=2) while attaching it to a plan. However, if you provide the value while [applying the addon to a subscription](./subscriptions?prod_cat_ver=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=2) exist for this item price, `billing_cycles` 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 `item.type` is `plan` 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=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
|
|
622
|
+
* @description A collection of key-value pairs that provides extra information about the item price.
|
|
623
|
+
**Note:** There'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
|
|
572
|
-
item_price:ItemPrice;
|
|
573
|
-
}
|
|
574
|
-
|
|
575
|
-
export interface FindApplicableItemPricesResponse {
|
|
757
|
+
export interface ListResponse {
|
|
576
758
|
/**
|
|
577
|
-
* @description Returns
|
|
578
|
-
|
|
579
|
-
* 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
|
|
580
|
-
* the [compatibility](subscriptions?prod_cat_ver=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=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
|
|
592
|
-
|
|
593
|
-
* 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
|
|
594
|
-
* the [compatibility](subscriptions?prod_cat_ver=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=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
|
|
772
|
+
export interface ListInputParam {
|
|
605
773
|
[key : string]: any;
|
|
606
774
|
/**
|
|
607
|
-
* @description The
|
|
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
|
|
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
|
|
622
|
-
|
|
623
|
-
* 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
|
|
624
|
-
* the [compatibility](subscriptions?prod_cat_ver=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=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=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=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
|
|
638
|
-
* the [compatibility](subscriptions?prod_cat_ver=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=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 \`offset\` to the value of \`next_offset\` 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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
893
|
+
export interface DeleteResponse {
|
|
785
894
|
item_price:ItemPrice;
|
|
786
895
|
}
|
|
787
|
-
|
|
788
|
-
|
|
896
|
+
|
|
897
|
+
export interface FindApplicableItemsResponse {
|
|
789
898
|
/**
|
|
790
|
-
* @description
|
|
899
|
+
* @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.
|
|
791
900
|
|
|
792
901
|
*/
|
|
793
902
|
|
|
794
|
-
|
|
903
|
+
list:{item:Item}[];
|
|
795
904
|
|
|
796
905
|
/**
|
|
797
|
-
* @description
|
|
906
|
+
* @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.
|
|
798
907
|
|
|
799
908
|
*/
|
|
800
909
|
|
|
801
|
-
|
|
802
|
-
|
|
910
|
+
next_offset?:string;
|
|
911
|
+
}
|
|
912
|
+
export interface FindApplicableItemsInputParam {
|
|
913
|
+
[key : string]: any;
|
|
803
914
|
/**
|
|
804
|
-
* @description
|
|
915
|
+
* @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.
|
|
805
916
|
|
|
806
917
|
*/
|
|
807
|
-
|
|
808
|
-
|
|
918
|
+
|
|
919
|
+
limit?:number;
|
|
809
920
|
|
|
810
921
|
/**
|
|
811
|
-
* @description
|
|
922
|
+
* @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.
|
|
812
923
|
|
|
813
924
|
*/
|
|
814
|
-
|
|
815
|
-
|
|
925
|
+
|
|
926
|
+
offset?:string;
|
|
816
927
|
|
|
817
928
|
/**
|
|
818
|
-
* @description
|
|
929
|
+
* @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.
|
|
819
930
|
|
|
820
931
|
*/
|
|
821
|
-
|
|
822
|
-
|
|
823
|
-
|
|
932
|
+
|
|
933
|
+
sort_by?:{asc?:'updated_at' | 'name' | 'id',desc?:'updated_at' | 'name' | 'id'};
|
|
934
|
+
}
|
|
935
|
+
export interface FindApplicableItemPricesResponse {
|
|
824
936
|
/**
|
|
825
|
-
* @description
|
|
937
|
+
* @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver=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=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
|
|
940
|
+
* the [compatibility](subscriptions?prod_cat_ver=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=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
|
-
|
|
948
|
+
list:{item_price:ItemPrice}[];
|
|
851
949
|
|
|
852
950
|
/**
|
|
853
|
-
* @description
|
|
951
|
+
* @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver=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=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
|
|
954
|
+
* the [compatibility](subscriptions?prod_cat_ver=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'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'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=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
|
-
|
|
879
|
-
|
|
962
|
+
next_offset?:string;
|
|
963
|
+
}
|
|
964
|
+
export interface FindApplicableItemPricesInputParam {
|
|
965
|
+
[key : string]: any;
|
|
880
966
|
/**
|
|
881
|
-
* @description
|
|
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=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 `flat_fee`. When the pricing model is `per_unit`, 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=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
|
|
970
|
+
* the [compatibility](subscriptions?prod_cat_ver=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 `flat_fee`. When the pricing model is `per_unit`, 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 `period`. If subscriptions or invoices exist for this item price, `period_unit` cannot be changed. The `period_unit` is mandatory when the item `type` is `plan` or `addon`. \* 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=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
|
-
|
|
977
|
+
|
|
978
|
+
limit?:number;
|
|
912
979
|
|
|
913
980
|
/**
|
|
914
|
-
* @description
|
|
915
|
-
|
|
916
|
-
* When the item `type` is `plan`: The billing period of the plan in `period_unit`s. For example, create a 6 month plan by providing `period` as 6 and `period_unit` as month.
|
|
917
|
-
* When item `type` is `addon`: The period of the addon in `period_unit`s. For example, create an addon with a 2 month `period` by providing period as 2 and `period_unit` as `month`. The period of an addon is the duration for which its `price` 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=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=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
|
|
984
|
+
* the [compatibility](subscriptions?prod_cat_ver=2#compatibility) of the addon-item prices to the plan-item price
|
|
919
985
|
|
|
986
|
+
**Note**
|
|
920
987
|
|
|
921
|
-
If
|
|
988
|
+
If an addon-item price has [differential pricing](differential_prices?prod_cat_ver=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
|
-
|
|
991
|
+
|
|
992
|
+
offset?:string;
|
|
926
993
|
|
|
927
994
|
/**
|
|
928
|
-
* @description
|
|
995
|
+
* @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver=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 `trial_period_unit`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=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
|
|
998
|
+
* the [compatibility](subscriptions?prod_cat_ver=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 "2" 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=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
|
-
|
|
1005
|
+
|
|
1006
|
+
item_id?:string;
|
|
954
1007
|
|
|
955
1008
|
/**
|
|
956
|
-
* @description
|
|
1009
|
+
* @description Returns the set of all applicable [addon-item](item_prices?prod_cat_ver=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
|
-
|
|
959
|
-
|
|
1011
|
+
* 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
|
|
1012
|
+
* the [compatibility](subscriptions?prod_cat_ver=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 `item.type` is `plan` 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=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=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
|
-
|
|
978
|
-
|
|
979
|
-
|
|
980
|
-
|
|
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
|
-
|
|
1028
|
+
starting_unit:number;
|
|
985
1029
|
|
|
986
|
-
|
|
987
|
-
|
|
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
|
-
|
|
1037
|
+
/**
|
|
1038
|
+
* @description The per-unit price for the tier when the `pricing_model` is `tiered` or `volume`; the total cost for the item price when the `pricing_model` is `stairstep`. 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/
|
|
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'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](
|
|
1090
|
+
* The [**AvaTax for Sales** integration](https://www.chargebee.com/docs/avalara.html) has been enabled in Chargebee.
|
|
1047
1091
|
|
|
1048
1092
|
*/
|
|
1049
1093
|
|