chargebee 2.42.0 → 2.44.0

package/types/resources/Coupon.d.ts

@@ -1,670 +1,429 @@
 ///<reference path='./../core.d.ts'/>
+///<reference path='./../index.d.ts'/>
 declare module 'chargebee' {
   export interface Coupon {
     [key : string] : any;
-    /**
-      * @description Used to uniquely identify the coupon in your website/application and to integrate with Chargebee.  
-**Note:**
-
 
-When the coupon ID contains a special character; for example: &#x60;#&#x60;, the API returns an error.
-Make sure that you [encode](https://www.urlencoder.org/) the coupon ID in the path parameter before making an API call.
-
-      */
-    
     id:string;
-    
-    /**
-      * @description The display name used in web interface for identifying the coupon.  
-**Note:**
-
 
-When the name of the coupon set contains a special character; for example: &#x60;#&#x60;, the API returns an error.
-Make sure that you [encode](https://www.urlencoder.org/) the name of the coupon set in the path parameter before making an API call.
-
-      */
-    
     name:string;
-    
-    /**
-      * @description Display name used in invoice. If it is not configured then name is used in invoice.
 
-      */
-    
     invoice_name?:string;
-    
-    /**
-      * @description The type of deduction \* percentage - The specified percentage will be deducted. \* fixed_amount - The specified amount will be deducted.
 
-      */
-    
-    discount_type:'fixed_amount' | 'percentage';
-    
-    /**
-      * @description The percentage of the original amount that should be deducted from it.
+    discount_type:'fixed_amount' | 'percentage' | 'offer_quantity';
 
-      */
-    
     discount_percentage?:number;
-    
-    /**
-      * @description The value of the deduction. The format of this value depends on the [kind of currency](/docs/api#currencies).
 
-      */
-    
     discount_amount?:number;
-    
-    /**
-      * @description The currency code ([ISO 4217 format](https://www.chargebee.com/docs/supported-currencies.html)) of the coupon. Applicable for *fixed_amount* coupons alone.
 
-      */
-    
+    discount_quantity?:number;
+
     currency_code?:string;
-    
-    /**
-      * @description Specifies the time duration for which this coupon is attached to the subscription. \* forever - The coupon is attached to the subscription and applied on the invoices until explicitly removed. \* one_time - The coupon stays attached to the subscription till it is applied on an invoice **once** . It is removed after that from the subscription. \* limited_period - The discount is attached to the subscription and applied on the invoices for a limited duration. This duration starts from the point it is applied to an invoice for the first time and expires after a period specified by &#x60;period&#x60; and &#x60;period_unit&#x60;.
 
-      */
-    
-    duration_type:'limited_period' | 'one_time' | 'forever';
-    
-    /**
-      * @description Date upto which the coupon can be applied to new subscriptions.
+    duration_type:'one_time' | 'forever' | 'limited_period';
 
-      */
-    
-    valid_till?:number;
-    
-    /**
-      * @description Maximum number of times this coupon can be redeemed.  
-**Note:**
+    duration_month?:number;
 
+    valid_from?:number;
 
-If not specified, the coupon can be redeemed an indefinite number of times.
+    valid_till?:number;
 
-      */
-    
     max_redemptions?:number;
-    
-    /**
-      * @description Status of the coupon. \* expired - Cannot be applied to a subscription. A coupon may expire due to exceeding [max_redemptions](/docs/api/coupons?#coupon_max_redemptions) or [valid_till](/docs/api/coupons?#coupon_valid_till) date is past. Existing associations remain unaffected. \* archived - Cannot be applied to a subscription. Existing associations remain unaffected. \* active - Can be applied to a subscription. \* deleted - Indicates the coupon has been deleted.
 
-      */
-    
-    status?:'archived' | 'expired' | 'deleted' | 'active';
-    
-    /**
-      * @description The amount on the invoice to which the coupon is applied. \* invoice_amount - The coupon is applied to the invoice &#x60;sub_total&#x60;. \* each_specified_item - The coupon is applied to the &#x60;invoice.line_item.amount&#x60; that corresponds to the item price specified by &#x60;item_price_id&#x60;.
+    status?:'active' | 'expired' | 'archived' | 'deleted' | 'future';
+
+    apply_discount_on:'plans' | 'plans_and_addons' | 'plans_with_quantity' | 'not_applicable';
 
-      */
-    
     apply_on:'invoice_amount' | 'each_specified_item';
-    
-    /**
-      * @description Timestamp indicating when this coupon is created.
 
-      */
-    
+    plan_constraint:'none' | 'all' | 'specific' | 'not_applicable';
+
+    addon_constraint:'none' | 'all' | 'specific' | 'not_applicable';
+
     created_at:number;
-    
-    /**
-      * @description Timestamp indicating when this coupon was archived.
 
-      */
-    
     archived_at?:number;
-    
-    /**
-      * @description The version number of this resource. For every change made to the resource, &#x60;resource_version&#x60; is updated with a new timestamp in milliseconds.
 
-      */
-    
     resource_version?:number;
-    
-    /**
-      * @description Timestamp indicating when this coupon was last updated.   
-Note that this does not change when the [redemptions](/docs/api/coupons?#coupon_redemptions) attribute is changed. This attribute will be present only if the resource has been updated after 2016-11-09.
 
-      */
-    
     updated_at?:number;
-    
-    /**
-      * @description The duration of time for which the coupon is attached to the subscription, in &#x60;period_units&#x60;. Applicable only when [duration_type](/docs/api/coupons?#coupon_duration_type) is [limited_period](/docs/api/coupons?#coupon_duration_type).
 
-      */
-    
+    included_in_mrr?:boolean;
+
     period?:number;
-    
-    /**
-      * @description The unit of time for period. Applicable only when [duration_type](/docs/api/coupons?#coupon_duration_type) is [limited_period](/docs/api/coupons?#coupon_duration_type). \* 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.
 
-      */
-    
     period_unit?:PeriodUnit;
-    
-    /**
-      * @description The number of times this coupon has been redeemed.
 
-      */
-    
-    redemptions?:number;
-    
-    /**
-      * @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.
+    plan_ids?:string[];
 
-      */
-    
-    invoice_notes?:string;
-    
-    /**
-      * @description The list of item constraints.
+    addon_ids?:string[];
 
-      */
-    
     item_constraints?:Coupon.ItemConstraint[];
-    
-    /**
-      * @description The list of item constraint criteria.
 
-      */
-    
     item_constraint_criteria?:Coupon.ItemConstraintCriteria[];
-    
-    /**
-      * @description List of constraints applicable on the redemption of this coupon.
 
-      */
-    
+    redemptions?:number;
+
+    invoice_notes?:string;
+
+    meta_data?:object;
+
     coupon_constraints?:Coupon.CouponConstraint[];
+
   }
   export namespace Coupon {
     export class CouponResource {  
-      /**
-        * @description This API creates a new coupon for a specific promotion or offers.
-
-        */
-      
+      create(input:CreateInputParam):ChargebeeRequest<CreateResponse>;
+       
       create_for_items(input:CreateForItemsInputParam):ChargebeeRequest<CreateForItemsResponse>;
        
-      /**
-        * @description This API updates a coupon that is created for a specific promotion or offers.
-
-        */
-      
-      update_for_items(coupon_id:string, input?:UpdateForItemsInputParam):ChargebeeRequest<UpdateForItemsResponse>;
+      update_for_items(coupon_id:string, input:UpdateForItemsInputParam):ChargebeeRequest<UpdateForItemsResponse>;
        
-      /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
-
-        */
-      
       list(input?:ListInputParam):ChargebeeRequest<ListResponse>;
        
-      /**
-        * @description This API retrieves a specific coupon using the coupon ID.
-
-        */
-      
       retrieve(coupon_id:string):ChargebeeRequest<RetrieveResponse>;
        
-      /**
-        * @description If no Subscriptions/Invoices are linked to this Coupon, the Coupon will be deleted from your Chargebee site. This action cannot be undone.
-
-To ensure that existing Subscriptions/Invoices are not affected, Coupons associated with them will not be deleted, but moved to &quot;Archived&quot; state. Once a Coupon has been archived, it cannot be edited or used again unless [unarchived](coupons#unarchive_a_coupon). Unused Coupons codes are deleted.
-
-        */
-      
+      update(coupon_id:string, input?:UpdateInputParam):ChargebeeRequest<UpdateResponse>;
+       
       delete(coupon_id:string):ChargebeeRequest<DeleteResponse>;
        
-      /**
-        * @description Copies a coupon over from one site to another. Copying of [archived](./coupons?prod_cat_ver&#x3D;2#coupon_status) coupons is not supported.
-
-The item prices that are linked to the coupon in the source site are also linked to the coupon in the destination site. However, this will only work if those item prices exist and with the same [ids](./item_prices?prod_cat_ver&#x3D;2#item_price_id), in the destination site. Hence, it is recommended that the item prices be copied over before copying the coupons.
-
-The value for [redemptions](./coupons?prod_cat_ver&#x3D;2#coupon_redemptions) is not copied. It is set to &#x60;0&#x60; for the newly created coupon. Hence, if such a coupon had &#x60;expired&#x60; in the source site due to &#x60;redemptions&#x60; having reached [max_redemptions](./coupons?prod_cat_ver&#x3D;2#coupon_max_redemptions), it&#x27;s [status](./coupons?prod_cat_ver&#x3D;2#coupon_status) would be &#x60;active&#x60; in the destination site.
-
-
-        */
-      
       copy(input:CopyInputParam):ChargebeeRequest<CopyResponse>;
        
-      /**
-        * @description This API unarchives a specific coupon using the coupon ID.
-
-        */
-      
       unarchive(coupon_id:string):ChargebeeRequest<UnarchiveResponse>;
     }
-    export interface CreateForItemsResponse {  
+    export interface CreateResponse {  
        coupon:Coupon;
     }
-    export interface CreateForItemsInputParam {
-      [key : string] : any;  
-      /**
-        * @description Used to uniquely identify the coupon in your website/application and to integrate with Chargebee.  
-**Note:**
-
-
-When the coupon ID contains a special character; for example: &#x60;#&#x60;, the API returns an error.
-Make sure that you [encode](https://www.urlencoder.org/) the coupon ID in the path parameter before making an API call.
-.
-
-        */
+    export interface CreateInputParam {
        
       id:string;
        
-      /**
-        * @description The display name used in web interface for identifying the coupon.  
-**Note:**
-
-
-When the name of the coupon set contains a special character; for example: &#x60;#&#x60;, the API returns an error.
-Make sure that you [encode](https://www.urlencoder.org/) the name of the coupon set in the path parameter before making an API call.
-.
-
-        */
-       
       name:string;
        
-      /**
-        * @description Display name used in invoice. If it is not configured then name is used in invoice.
-
-        */
-       
       invoice_name?:string;
        
-      /**
-        * @description The type of deduction. \* percentage - The specified percentage will be deducted. \* fixed_amount - The specified amount will be deducted. \* offer_quantity - The specified units will be offered for free.
-
-        */
-       
-      discount_type?:'fixed_amount' | 'percentage';
-       
-      /**
-        * @description The value of the deduction. The format of this value depends on the [kind of currency](/docs/api#currencies).
-
-        */
+      discount_type?:'fixed_amount' | 'percentage' | 'offer_quantity';
        
       discount_amount?:number;
        
-      /**
-        * @description The currency code ([ISO 4217 format](https://www.chargebee.com/docs/2.0/supported-currencies.html)) of the coupon. Applicable for *fixed_amount* coupons alone.
-
-        */
-       
       currency_code?:string;
        
-      /**
-        * @description The percentage of the original amount that should be deducted from it.
-
-        */
-       
       discount_percentage?:number;
        
-      /**
-        * @description The amount on the invoice to which the coupon is applied. \* invoice_amount - The coupon is applied to the invoice &#x60;sub_total&#x60;. \* each_unit_of_specified_items - Discount will be applied to each unit of plan and addon items specified. \* each_specified_item - The coupon is applied to the &#x60;invoice.line_item.amount&#x60; that corresponds to the item price specified by &#x60;item_price_id&#x60;. \* specified_items_total - Discount will be applied to the total of plan and addon items specified.
-
-        */
+      discount_quantity?:number;
        
       apply_on:'invoice_amount' | 'each_specified_item';
        
-      /**
-        * @description Specifies the time duration for which this coupon is attached to the subscription. \* forever - The coupon is attached to the subscription and applied on the invoices until explicitly removed. \* one_time - The coupon stays attached to the subscription till it is applied on an invoice **once** . It is removed after that from the subscription. \* limited_period - The discount is attached to the subscription and applied on the invoices for a limited duration. This duration starts from the point it is applied to an invoice for the first time and expires after a period specified by &#x60;period&#x60; and &#x60;period_unit&#x60;.
-
-        */
+      duration_type?:'one_time' | 'forever' | 'limited_period';
        
-      duration_type?:'limited_period' | 'one_time' | 'forever';
+      duration_month?:number;
        
-      /**
-        * @description **(Deprecated)** The duration of time in months for which the coupon is attached to the subscription. Applicable only when &#x60;duration_type&#x60; is &#x60;limited_period&#x60;.   
-**Note:** This parameter has been deprecated. Use &#x60;period&#x60; and &#x60;period_unit&#x60; instead.
-
-        */
+      valid_till?:number;
        
-      duration_month?:number;
+      max_redemptions?:number;
        
-      /**
-        * @description Date upto which the coupon can be applied to new subscriptions.
-
-        */
+      invoice_notes?:string;
        
-      valid_till?:number;
+      meta_data?:object;
        
-      /**
-        * @description Maximum number of times this coupon can be redeemed.  
-**Note:**
-
-
-If not specified, the coupon can be redeemed an indefinite number of times.
-.
-
-        */
+      included_in_mrr?:boolean;
        
-      max_redemptions?:number;
+      period?:number;
        
-      /**
-        * @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.
-
-        */
+      period_unit?:PeriodUnit;
        
-      invoice_notes?:string;
+      plan_constraint?:'none' | 'all' | 'specific';
        
-      /**
-        * @description A collection of key-value pairs that provides extra information about the coupon.  
-**Note:** There&#x27;s a character limit of 65,535.
-[Learn more](advanced-features?prod_cat_ver&#x3D;2#metadata).
-
-        */
+      addon_constraint?:'none' | 'all' | 'specific';
        
-      meta_data?:object;
+      plan_ids?:string[];
        
-      /**
-        * @description The coupon is included in MRR calculations for your site. This attribute is only applicable for coupons of &#x60;duration_type &#x3D; one_time&#x60; and when the feature is enabled in Chargebee. Note: If the site-level setting is to exclude one-time coupons from MRR calculations, this value is always returned &#x60;false&#x60;.
-
-        */
+      addon_ids?:string[];
        
-      included_in_mrr?:boolean;
+      status?:'active' | 'archived';
+    }
+    export interface CreateForItemsResponse {  
+       coupon:Coupon;
+    }
+    export interface CreateForItemsInputParam {
+      [key : string] : any;  
+      item_constraints:{constraint:'none' | 'all' | 'specific' | 'criteria',item_price_ids?:any[],item_type:'plan' | 'addon' | 'charge'}[];
        
-      /**
-        * @description The duration of time for which the coupon is attached to the subscription, in &#x60;period_units&#x60;. Applicable only when [duration_type](/docs/api/coupons?#coupon_duration_type) is [limited_period](/docs/api/coupons?#coupon_duration_type).
-
-        */
+      item_constraint_criteria?:{currencies?:any[],item_family_ids?:any[],item_price_periods?:any[],item_type?:'plan' | 'addon' | 'charge'}[];
        
-      period?:number;
+      coupon_constraints:{entity_type:'customer',type:'max_redemptions' | 'unique_by' | 'existing_customer' | 'new_customer',value?:string}[];
        
-      /**
-        * @description The unit of time for period. Applicable only when [duration_type](/docs/api/coupons?#coupon_duration_type) is [limited_period](/docs/api/coupons?#coupon_duration_type). \* 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.
-
-        */
+      id:string;
        
-      period_unit?:PeriodUnit;
+      name:string;
        
-      /**
-        * @description Status of the coupon. \* expired - Cannot be applied to a subscription. A coupon may expire due to exceeding [max_redemptions](/docs/api/coupons?#coupon_max_redemptions) or [valid_till](/docs/api/coupons?#coupon_valid_till) date is past. Existing associations remain unaffected. \* archived - Cannot be applied to a subscription. Existing associations remain unaffected. \* active - Can be applied to a subscription. \* deleted - Indicates the coupon has been deleted.
-
-        */
+      invoice_name?:string;
        
-      status?:'archived' | 'active';
+      discount_type?:'fixed_amount' | 'percentage' | 'offer_quantity';
        
-      /**
-        * @description Parameters for item_constraints
-
-        */
+      discount_amount?:number;
        
-      item_constraints?:{constraint:'all' | 'criteria' | 'none' | 'specific',item_price_ids?:any[],item_type:'charge' | 'addon' | 'plan'}[];
+      currency_code?:string;
        
-      /**
-        * @description Parameters for item_constraint_criteria
-
-        */
+      discount_percentage?:number;
        
-      item_constraint_criteria?:{currencies?:any[],item_family_ids?:any[],item_price_periods?:any[],item_type?:'charge' | 'addon' | 'plan'}[];
+      discount_quantity?:number;
        
-      /**
-        * @description Parameters for &#x60;coupon_constraints&#x60;. Multiple &#x60;coupon_constraints&#x60; can be passed by specifying unique indices.
-
-        */
+      apply_on:'invoice_amount' | 'each_specified_item';
+       
+      duration_type?:'one_time' | 'forever' | 'limited_period';
+       
+      duration_month?:number;
+       
+      valid_from?:number;
        
-      coupon_constraints?:{entity_type:'customer',type:'max_redemptions' | 'unique_by',value?:string}[];
+      valid_till?:number;
+       
+      max_redemptions?:number;
+       
+      invoice_notes?:string;
+       
+      meta_data?:object;
+       
+      included_in_mrr?:boolean;
+       
+      period?:number;
+       
+      period_unit?:PeriodUnit;
+       
+      status?:'active' | 'archived';
     }
     export interface UpdateForItemsResponse {  
        coupon:Coupon;
     }
     export interface UpdateForItemsInputParam {
       [key : string] : any;  
-      /**
-        * @description The display name used in web interface for identifying the coupon.  
-**Note:**
-
-
-When the name of the coupon set contains a special character; for example: &#x60;#&#x60;, the API returns an error.
-Make sure that you [encode](https://www.urlencoder.org/) the name of the coupon set in the path parameter before making an API call.
-.
-
-        */
+      item_constraints:{constraint:'none' | 'all' | 'specific' | 'criteria',item_price_ids?:any[],item_type:'plan' | 'addon' | 'charge'}[];
        
-      name?:string;
+      item_constraint_criteria?:{currencies?:any[],item_family_ids?:any[],item_price_periods?:any[],item_type?:'plan' | 'addon' | 'charge'}[];
        
-      /**
-        * @description Display name used in invoice. If it is not configured then name is used in invoice.
-
-        */
+      coupon_constraints:{entity_type:'customer',type:'max_redemptions' | 'unique_by' | 'existing_customer' | 'new_customer',value?:string}[];
        
-      invoice_name?:string;
-       
-      /**
-        * @description The type of deduction. \* percentage - The specified percentage will be deducted. \* fixed_amount - The specified amount will be deducted. \* offer_quantity - The specified units will be offered for free.
-
-        */
+      name?:string;
        
-      discount_type?:'fixed_amount' | 'percentage';
+      invoice_name?:string;
        
-      /**
-        * @description The value of the deduction. The format of this value depends on the [kind of currency](/docs/api#currencies).
-
-        */
+      discount_type?:'fixed_amount' | 'percentage' | 'offer_quantity';
        
       discount_amount?:number;
        
-      /**
-        * @description The currency code ([ISO 4217 format](https://www.chargebee.com/docs/2.0/supported-currencies.html)) of the coupon. Applicable for *fixed_amount* coupons alone.
-
-        */
-       
       currency_code?:string;
        
-      /**
-        * @description The percentage of the original amount that should be deducted from it.
-
-        */
-       
       discount_percentage?:number;
        
-      /**
-        * @description The amount on the invoice to which the coupon is applied. \* invoice_amount - The coupon is applied to the invoice &#x60;sub_total&#x60;. \* each_unit_of_specified_items - Discount will be applied to each unit of plan and addon items specified. \* each_specified_item - The coupon is applied to the &#x60;invoice.line_item.amount&#x60; that corresponds to the item price specified by &#x60;item_price_id&#x60;. \* specified_items_total - Discount will be applied to the total of plan and addon items specified.
-
-        */
+      discount_quantity?:number;
        
       apply_on?:'invoice_amount' | 'each_specified_item';
        
-      /**
-        * @description Specifies the time duration for which this coupon is attached to the subscription. \* forever - The coupon is attached to the subscription and applied on the invoices until explicitly removed. \* one_time - The coupon stays attached to the subscription till it is applied on an invoice **once** . It is removed after that from the subscription. \* limited_period - The discount is attached to the subscription and applied on the invoices for a limited duration. This duration starts from the point it is applied to an invoice for the first time and expires after a period specified by &#x60;period&#x60; and &#x60;period_unit&#x60;.
-
-        */
-       
-      duration_type?:'limited_period' | 'one_time' | 'forever';
-       
-      /**
-        * @description **(Deprecated)** The duration of time in months for which the coupon is attached to the subscription. Applicable only when &#x60;duration_type&#x60; is &#x60;limited_period&#x60;.   
-**Note:** This parameter has been deprecated. Use &#x60;period&#x60; and &#x60;period_unit&#x60; instead.
-
-        */
+      duration_type?:'one_time' | 'forever' | 'limited_period';
        
       duration_month?:number;
        
-      /**
-        * @description Date upto which the coupon can be applied to new subscriptions.
-
-        */
+      valid_from?:number;
        
       valid_till?:number;
        
-      /**
-        * @description Maximum number of times this coupon can be redeemed.  
-**Note:**
-
-
-If not specified, the coupon can be redeemed an indefinite number of times.
-.
-
-        */
-       
       max_redemptions?:number;
        
-      /**
-        * @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.
-
-        */
-       
       invoice_notes?:string;
        
-      /**
-        * @description A collection of key-value pairs that provides extra information about the coupon.  
-**Note:** There&#x27;s a character limit of 65,535.
-[Learn more](advanced-features?prod_cat_ver&#x3D;2#metadata).
-
-        */
-       
       meta_data?:object;
        
-      /**
-        * @description The coupon is included in MRR calculations for your site. This attribute is only applicable for coupons of &#x60;duration_type &#x3D; one_time&#x60; and when the feature is enabled in Chargebee. Note: If the site-level setting is to exclude one-time coupons from MRR calculations, this value is always returned &#x60;false&#x60;.
-
-        */
-       
       included_in_mrr?:boolean;
        
-      /**
-        * @description The duration of time for which the coupon is attached to the subscription, in &#x60;period_units&#x60;. Applicable only when [duration_type](/docs/api/coupons?#coupon_duration_type) is [limited_period](/docs/api/coupons?#coupon_duration_type).
-
-        */
-       
       period?:number;
        
-      /**
-        * @description The unit of time for period. Applicable only when [duration_type](/docs/api/coupons?#coupon_duration_type) is [limited_period](/docs/api/coupons?#coupon_duration_type). \* 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.
-
-        */
-       
       period_unit?:PeriodUnit;
+    }
+    export interface ListResponse {  
+       list:{coupon:Coupon}[];
        
+       next_offset?:string;
+    }
+    export interface ListInputParam {
+      [key : string]: any;  
       /**
-        * @description Parameters for item_constraints
+        * @description The number of resources to be returned.
 
         */
-       
-      item_constraints?:{constraint:'all' | 'criteria' | 'none' | 'specific',item_price_ids?:any[],item_type:'charge' | 'addon' | 'plan'}[];
+        
+      limit?:number;
        
       /**
-        * @description Parameters for item_constraint_criteria
+        * @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.
 
         */
-       
-      item_constraint_criteria?:{currencies?:any[],item_family_ids?:any[],item_price_periods?:any[],item_type?:'charge' | 'addon' | 'plan'}[];
+        
+      offset?:string;
        
       /**
-        * @description Parameters for &#x60;coupon_constraints&#x60;. Multiple &#x60;coupon_constraints&#x60; can be passed by specifying unique indices.
+        * @description Parameters for addon
 
         */
+        
+      addon?:{};
        
-      coupon_constraints?:{entity_type:'customer',type:'max_redemptions' | 'unique_by',value?:string}[];
-    }
-    export interface ListResponse {  
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description Parameters for plan
 
         */
-       
-       list:{coupon:Coupon}[];
+        
+      plan?:{};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description Used to uniquely identify the coupon in your website/application and to integrate with Chargebee.  
+**Note:**
 
-        */
-       
-       next_offset?:string;
-    }
-    export interface ListInputParam {
-      [key : string]: any;  
-      /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+
+When the coupon ID contains a special character; for example: &#x60;#&#x60;, the API returns an error.
+Make sure that you [encode](https://www.urlencoder.org/) the coupon ID in the path parameter before making an API call.
 
         */
         
-      limit?:number;
+      id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description The display name used in web interface for identifying the coupon.  
+**Note:**
+
+
+When the name of the coupon set contains a special character; for example: &#x60;#&#x60;, the API returns an error.
+Make sure that you [encode](https://www.urlencoder.org/) the name of the coupon set in the path parameter before making an API call.
 
         */
         
-      offset?:string;
+      name?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description The type of deduction
 
         */
         
-      id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
+      discount_type?:{in?:string,is?:'fixed_amount' | 'percentage' | 'offer_quantity',is_not?:'fixed_amount' | 'percentage' | 'offer_quantity',not_in?:string};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description Specifies the time duration for which this coupon is attached to the subscription.
 
         */
         
-      name?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
+      duration_type?:{in?:string,is?:'one_time' | 'forever' | 'limited_period',is_not?:'one_time' | 'forever' | 'limited_period',not_in?:string};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description Status of the coupon.
 
         */
         
-      discount_type?:{in?:string,is?:'fixed_amount' | 'percentage',is_not?:'fixed_amount' | 'percentage',not_in?:string};
+      status?:{in?:string,is?:'active' | 'expired' | 'archived' | 'deleted' | 'future',is_not?:'active' | 'expired' | 'archived' | 'deleted' | 'future',not_in?:string};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description The amount on the invoice to which the coupon is applied.
 
         */
         
-      duration_type?:{in?:string,is?:'limited_period' | 'one_time' | 'forever',is_not?:'limited_period' | 'one_time' | 'forever',not_in?:string};
+      apply_on?:{in?:string,is?:'invoice_amount' | 'each_specified_item',is_not?:'invoice_amount' | 'each_specified_item',not_in?:string};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description Timestamp indicating when this coupon is created.
 
         */
         
-      status?:{in?:string,is?:'archived' | 'expired' | 'deleted' | 'active',is_not?:'archived' | 'expired' | 'deleted' | 'active',not_in?:string};
+      created_at?:{after?:string,before?:string,between?:string,on?:string};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description To filter based on updated at. This attribute will be present only if the resource has been updated after 2016-11-09.
 
         */
         
-      apply_on?:{in?:string,is?:'invoice_amount' | 'each_specified_item',is_not?:'invoice_amount' | 'each_specified_item',not_in?:string};
+      updated_at?:{after?:string,before?:string,between?:string,on?:string};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description Plans the coupon can be applied to.
 
         */
         
-      created_at?:{after?:string,before?:string,between?:string,on?:string};
+      plan_constraint?:{in?:string,is?:'none' | 'all' | 'specific' | 'not_applicable',is_not?:'none' | 'all' | 'specific' | 'not_applicable',not_in?:string};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description Addons the coupon can be applied to.
 
         */
         
-      updated_at?:{after?:string,before?:string,between?:string,on?:string};
+      addon_constraint?:{in?:string,is?:'none' | 'all' | 'specific' | 'not_applicable',is_not?:'none' | 'all' | 'specific' | 'not_applicable',not_in?:string};
+       
+      sort_by?:{asc?:'created_at',desc?:'created_at'};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description The currency code ([ISO 4217 format](https://www.chargebee.com/docs/supported-currencies.html)) of the coupon. Applicable for *fixed_amount* coupons alone.
 
         */
         
-      sort_by?:{asc?:'created_at',desc?:'created_at'};
+      currency_code?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
        
       /**
-        * @description List all the available coupons that are created for a specific promotion or offers. You can find list of coupon codes that are currently active, expired, archived or deleted.
+        * @description Item families for which this coupon is applicable.
 
         */
         
-      currency_code?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
+      item_family?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
+       
+      include_discounts?:boolean;
     }
     export interface RetrieveResponse {  
        coupon:Coupon;
     }
     
+    export interface UpdateResponse {  
+       coupon:Coupon;
+    }
+    export interface UpdateInputParam {
+       
+      name?:string;
+       
+      invoice_name?:string;
+       
+      discount_type?:'fixed_amount' | 'percentage' | 'offer_quantity';
+       
+      discount_amount?:number;
+       
+      currency_code?:string;
+       
+      discount_percentage?:number;
+       
+      discount_quantity?:number;
+       
+      apply_on?:'invoice_amount' | 'each_specified_item';
+       
+      duration_type?:'one_time' | 'forever' | 'limited_period';
+       
+      duration_month?:number;
+       
+      valid_till?:number;
+       
+      max_redemptions?:number;
+       
+      invoice_notes?:string;
+       
+      meta_data?:object;
+       
+      included_in_mrr?:boolean;
+       
+      period?:number;
+       
+      period_unit?:PeriodUnit;
+       
+      plan_constraint?:'none' | 'all' | 'specific';
+       
+      addon_constraint?:'none' | 'all' | 'specific';
+       
+      plan_ids?:string[];
+       
+      addon_ids?:string[];
+    }
     export interface DeleteResponse {  
        coupon:Coupon;
     }
@@ -674,34 +433,12 @@ If not specified, the coupon can be redeemed an indefinite number of times.
     }
     export interface CopyInputParam {
        
-      /**
-        * @description Your Chargebee site name having the coupon to be copied.  
-**Note:** Unless you are copying from a twin site (acme \&amp; acme-test are twin sites), [contact support](https://chargebee.freshdesk.com/support/home) to have this allow-listed.
-
-        */
-       
       from_site:string;
        
-      /**
-        * @description Id of the coupon to be copied. The new coupon created in this site will have the same Id.
-
-        */
-       
       id_at_from_site:string;
        
-      /**
-        * @description Id of copied coupon in this site.
-
-        */
-       
       id?:string;
        
-      /**
-        * @description If copy action is performed as part of Chargebee site merge action, pass the value as true.  
-**Note:** If this parameter is passed true coupon state, redemptions, coupon set and coupon codes associated with this coupon will be copied.
-
-        */
-       
       for_site_merging?:boolean;
     }
     export interface UnarchiveResponse {  
@@ -709,80 +446,25 @@ If not specified, the coupon can be redeemed an indefinite number of times.
     }
     
     export interface ItemConstraint {  
-         /**
-          * @description Item type for which this criteria is applicable for. \* charge - Charge \* plan - Plan \* addon - Addon
-
-          */
-       
-      item_type:'charge' | 'addon' | 'plan';
-       
-         /**
-          * @description Constraint applicable for the item \* specific - Coupon applicable to specific items. \* all - Coupon applicable to all items. \* criteria - Coupon applicable based on criteria. \* none - Coupon not applicable to any items.
-
-          */
-       
-      constraint:'all' | 'criteria' | 'none' | 'specific';
+      item_type:'plan' | 'addon' | 'charge';
        
-         /**
-          * @description List of item price ids for which this coupon is applicable.
-
-          */
+      constraint:'none' | 'all' | 'specific' | 'criteria';
        
       item_price_ids?:any[];
     }
     export interface ItemConstraintCriteria {  
-         /**
-          * @description Item type for which this criteria is applicable for. \* charge - Charge is a type of item \* plan - Plan is a type of item \* addon - Addon is a type of item
-
-          */
-       
-      item_type:'charge' | 'addon' | 'plan';
-       
-         /**
-          * @description List of currencies ([ISO 4217 format](https://www.chargebee.com/docs/supported-currencies.html)) for which this coupon is applicable.
-
-          */
+      item_type:'plan' | 'addon' | 'charge';
        
       currencies?:any[];
        
-         /**
-          * @description List of families for which this coupon is applicable.
-
-          */
-       
       item_family_ids?:any[];
        
-         /**
-          * @description List of frequencies for which this coupon is applicable. Allowed frequencies are \[day, week, month, year\].
-
-          */
-       
       item_price_periods?:any[];
     }
     export interface CouponConstraint {  
-         /**
-          * @description The resource type for the constraint. This, along with &#x60;type&#x60; and &#x60;value&#x60;, helps define the specific rule applied. \* customer - The constraint is based on &#x60;customer&#x60; records.
-
-          */
-       
       entity_type:'customer';
        
-         /**
-          * @description Type of coupon constraints \* unique_by - Indicates - when &#x60;entity_type&#x60; is &#x60;customer&#x60; - that the coupon can be redeemed only once for every unique value of a specified &#x60;customer&#x60; attribute. The &#x60;customer&#x60; attribute is specified using &#x60;value&#x60;. For example, if &#x60;value&#x60; is &#x60;email&#x60;, then the coupon can be redeemed only once for every unique value of &#x60;customer.email&#x60;. In other words, when there are multiple &#x60;customer&#x60; records with the same value for &#x60;email&#x60;, once the coupon has been redeemed for one of those customer records, no further redemptions of the coupon are allowed for any of those &#x60;customer&#x60; records. \* max_redemptions - The coupon can be redeemed up to a set number of times for a specific resource type. The maximum redemptions are specified using &#x60;value&#x60;, and the resource type is specified using &#x60;entity_type&#x60;. For example, if &#x60;entity_type&#x60; is &#x60;customer&#x60; and &#x60;value&#x60; is &#x60;10&#x60; then the coupon can only be redeemed up to 10 times for any particular &#x60;customer&#x60; record.
-
-          */
-       
-      type:'max_redemptions' | 'unique_by';
-       
-         /**
-          * @description The value of the coupon constraint. The possible values depend on the value of &#x60;constraints[type]&#x60;:
-
-* When &#x60;type&#x60; is &#x60;unique_by&#x60;, then &#x60;value&#x60; can be &#x60;email&#x60; or &#x60;id&#x60;.
-
-* When &#x60;type&#x60; is &#x60;max_redemptions&#x60;, then &#x60;value&#x60; can be any integer in the range &#x60;1&#x60; &#x60;coupon.max_redemptions&#x60;, inclusive.
-
-
-          */
+      type:'max_redemptions' | 'unique_by' | 'existing_customer' | 'new_customer';
        
       value?:string;
     }