chargebee 2.30.0 → 2.31.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/CHANGELOG.md +55 -0
- package/lib/chargebee.js +1 -1
- package/lib/resources/api_endpoints.js +16 -0
- package/package.json +1 -1
- package/types/core.d.ts +6 -5
- package/types/index.d.ts +2 -0
- package/types/resources/Card.d.ts +2 -2
- package/types/resources/CreditNote.d.ts +23 -2
- package/types/resources/CreditNoteEstimate.d.ts +2 -2
- package/types/resources/Customer.d.ts +98 -74
- package/types/resources/Entitlement.d.ts +78 -0
- package/types/resources/Export.d.ts +7 -7
- package/types/resources/Feature.d.ts +89 -17
- package/types/resources/Hierarchy.d.ts +5 -5
- package/types/resources/Invoice.d.ts +99 -49
- package/types/resources/InvoiceEstimate.d.ts +26 -20
- package/types/resources/ItemPrice.d.ts +21 -0
- package/types/resources/PaymentSource.d.ts +380 -246
- package/types/resources/Quote.d.ts +46 -25
- package/types/resources/QuoteLineGroup.d.ts +23 -17
- package/types/resources/Subscription.d.ts +29 -17
- package/types/resources/SubscriptionEntitlement.d.ts +1 -1
- package/types/resources/SubscriptionEstimate.d.ts +12 -12
- package/types/resources/ThirdPartyPaymentMethod.d.ts +1 -1
- package/types/resources/Transaction.d.ts +35 -3
- package/types/resources/VirtualBankAccount.d.ts +4 -4
|
@@ -39,9 +39,9 @@ declare module 'chargebee' {
|
|
|
39
39
|
recurring:boolean;
|
|
40
40
|
|
|
41
41
|
/**
|
|
42
|
-
* @description Current status of this invoice. \*
|
|
42
|
+
* @description Current status of this invoice. \* paid - Indicates a paid invoice. \* posted - Indicates the payment is not yet collected and will be in this state till the due date to indicate the due period \* pending -
|
|
43
43
|
The [invoice](/docs/api/invoices?prod_cat_ver=2#invoice_status) is yet to be closed (sent for payment collection). An invoice is generated with this `status` when it has line items that belong to items that are `metered` or when the `subscription.create_pending_invoices`attribute is set to `true`.
|
|
44
|
-
The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to be closed (sent for payment collection). All invoices are generated with this `status` when [Metered Billing](https://www.chargebee.com/docs/1.0/metered_billing.html) is enabled for the site. \* payment_due - Indicates the payment is not yet collected and is being retried as per retry settings.
|
|
44
|
+
The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to be closed (sent for payment collection). All invoices are generated with this `status` when [Metered Billing](https://www.chargebee.com/docs/1.0/metered_billing.html) is enabled for the site. \* payment_due - Indicates the payment is not yet collected and is being retried as per retry settings. \* not_paid - Indicates the payment is not made and all attempts to collect is failed. \* voided - Indicates a voided invoice.
|
|
45
45
|
|
|
46
46
|
*/
|
|
47
47
|
|
|
@@ -55,7 +55,7 @@ The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to b
|
|
|
55
55
|
vat_number?:string;
|
|
56
56
|
|
|
57
57
|
/**
|
|
58
|
-
* @description The price type of the invoice. \*
|
|
58
|
+
* @description The price type of the invoice. \* tax_exclusive - All amounts in the document are exclusive of tax. \* tax_inclusive - All amounts in the document are inclusive of tax.
|
|
59
59
|
|
|
60
60
|
*/
|
|
61
61
|
|
|
@@ -330,10 +330,9 @@ Ireland** . The first two characters of the VAT number in such a case is `X
|
|
|
330
330
|
vat_number_prefix?:string;
|
|
331
331
|
|
|
332
332
|
/**
|
|
333
|
-
* @description The subscription channel this object originated from and is maintained in. \* play_store - The object data is synchronized with data from [in-app subscription(s)](https://apidocs.chargebee.com/docs/api/in_app_subscriptions) created in Google Play Store. Direct manipulation of this object via UI or API is disallowed.
|
|
333
|
+
* @description The subscription channel this object originated from and is maintained in. \* app_store - The object data is synchronized with data from [in-app subscription(s)](https://apidocs.chargebee.com/docs/api/in_app_subscriptions) created in Apple App Store. Direct manipulation of this object via UI or API is disallowed. \* play_store - The object data is synchronized with data from [in-app subscription(s)](https://apidocs.chargebee.com/docs/api/in_app_subscriptions) created in Google Play Store. Direct manipulation of this object via UI or API is disallowed.
|
|
334
334
|
|
|
335
|
-
In-App Subscriptions is currently in early access. Contact [eap@chargebee.com](mailto:eap@chargebee.com) for more information.
|
|
336
|
-
\* web - The object was created (and is maintained) for the web channel directly in Chargebee via API or UI. \* app_store - The object data is synchronized with data from [in-app subscription(s)](https://apidocs.chargebee.com/docs/api/in_app_subscriptions) created in Apple App Store. Direct manipulation of this object via UI or API is disallowed.
|
|
335
|
+
In-App Subscriptions is currently in early access. Contact [eap@chargebee.com](mailto:eap@chargebee.com) for more information. \* web - The object was created (and is maintained) for the web channel directly in Chargebee via API or UI.
|
|
337
336
|
|
|
338
337
|
*/
|
|
339
338
|
|
|
@@ -447,6 +446,11 @@ In-App Subscriptions is currently in early access. Contact [eap@chargebee.com](m
|
|
|
447
446
|
|
|
448
447
|
shipping_address?:Invoice.ShippingAddress;
|
|
449
448
|
|
|
449
|
+
/**
|
|
450
|
+
* @description Statement descriptor for the invoice.
|
|
451
|
+
|
|
452
|
+
*/
|
|
453
|
+
|
|
450
454
|
statement_descriptor?:Invoice.StatementDescriptor;
|
|
451
455
|
|
|
452
456
|
/**
|
|
@@ -477,7 +481,7 @@ In-App Subscriptions is currently in early access. Contact [eap@chargebee.com](m
|
|
|
477
481
|
|
|
478
482
|
*/
|
|
479
483
|
|
|
480
|
-
create_for_charge_items_and_charges(input
|
|
484
|
+
create_for_charge_items_and_charges(input:CreateForChargeItemsAndChargesInputParam):ChargebeeRequest<CreateForChargeItemsAndChargesResponse>;
|
|
481
485
|
|
|
482
486
|
/**
|
|
483
487
|
* @description This API is used to stop dunning for "Payment Due" invoices that have been enabled for Auto Collection. When dunning is stopped, the status of the invoice will be changed to "Not Paid".
|
|
@@ -580,7 +584,7 @@ For example, if you have an excess payment of $25.00, and the invoice to which y
|
|
|
580
584
|
|
|
581
585
|
*/
|
|
582
586
|
|
|
583
|
-
add_charge_item(invoice_id:string, input
|
|
587
|
+
add_charge_item(invoice_id:string, input:AddChargeItemInputParam):ChargebeeRequest<AddChargeItemResponse>;
|
|
584
588
|
|
|
585
589
|
/**
|
|
586
590
|
* @description Invoices for a subscription are created with a `pending` `status` when the subscription has `create_pending_invoices` attribute set to `true`. This API call finalizes a `pending` invoice. Any `refundable_credits` and `excess_payments` for the customer are applied to the invoice, and any payment due is collected automatically if `auto_collection` is `on` for the customer.
|
|
@@ -594,9 +598,12 @@ This operation can be automated by using a [site setting](https://www.chargebee.
|
|
|
594
598
|
close(invoice_id:string, input?:CloseInputParam):ChargebeeRequest<CloseResponse>;
|
|
595
599
|
|
|
596
600
|
/**
|
|
597
|
-
* @description
|
|
601
|
+
* @description **Important:**
|
|
598
602
|
|
|
599
|
-
|
|
603
|
+
* Storing card after successful 3DS completion is not supported in this API. Use [create using Payment Intent API](https://apidocs.chargebee.com/docs/api/payment_sources#create_using_payment_intent) under Payment source to store the card after successful 3DS flow completion.
|
|
604
|
+
* This endpoint returns an error if a payment is initiated for an invoice with a [status](https://apidocs.chargebee.com/docs/api/invoices?prod_cat_ver=2#invoice_status) of `payment_due` associated with the `app_store` and `play_store` [channels](https://apidocs.chargebee.com/docs/api/invoices?prod_cat_ver=2#invoice_channel).
|
|
605
|
+
|
|
606
|
+
This API is used to collect payments for `payment_due` and `not_paid invoices`. If no payment methods are present for the customer or if the payment is unsuccessful, the corresponding error will be thrown.
|
|
600
607
|
|
|
601
608
|
Pass `authorization_transaction_id` to capture the already blocked funds to collect payments. Note that if the invoice due amount is greater than the authorized amount, the invoice status is returned as `payment_due`.
|
|
602
609
|
|
|
@@ -613,7 +620,7 @@ The invoice status will be marked as 'paid' if its amount due becomes
|
|
|
613
620
|
|
|
614
621
|
*/
|
|
615
622
|
|
|
616
|
-
record_payment(invoice_id:string, input
|
|
623
|
+
record_payment(invoice_id:string, input:RecordPaymentInputParam):ChargebeeRequest<RecordPaymentResponse>;
|
|
617
624
|
|
|
618
625
|
/**
|
|
619
626
|
* @description Records [tax_withheld](/docs/api/tax_withheld) by the customer against the invoice specified. This operation is allowed only when all of the following conditions are true:
|
|
@@ -625,7 +632,7 @@ The invoice status will be marked as 'paid' if its amount due becomes
|
|
|
625
632
|
|
|
626
633
|
*/
|
|
627
634
|
|
|
628
|
-
record_tax_withheld(invoice_id:string, input
|
|
635
|
+
record_tax_withheld(invoice_id:string, input:RecordTaxWithheldInputParam):ChargebeeRequest<RecordTaxWithheldResponse>;
|
|
629
636
|
|
|
630
637
|
/**
|
|
631
638
|
* @description Removes a [linked_taxes_withheld](/docs/api/invoices#invoice_linked_taxes_withheld) record from the `invoice` specified. This operation is allowed only when all of the following conditions are true:
|
|
@@ -636,7 +643,7 @@ The invoice status will be marked as 'paid' if its amount due becomes
|
|
|
636
643
|
|
|
637
644
|
*/
|
|
638
645
|
|
|
639
|
-
remove_tax_withheld(invoice_id:string, input
|
|
646
|
+
remove_tax_withheld(invoice_id:string, input:RemoveTaxWithheldInputParam):ChargebeeRequest<RemoveTaxWithheldResponse>;
|
|
640
647
|
|
|
641
648
|
/**
|
|
642
649
|
* @description Refunds the invoice. The [refund](https://www.chargebee.com/docs/refunds.html) request is processed via the payment gateway originally used to charge the customer. You can choose to either make a full refund for the entire amount or make many partial refunds until you reach the total amount charged for the invoice. The API returns an error if an attempt is made to:
|
|
@@ -678,14 +685,14 @@ If the order of precendence described above does not work for your use case, and
|
|
|
678
685
|
|
|
679
686
|
*/
|
|
680
687
|
|
|
681
|
-
record_refund(invoice_id:string, input
|
|
688
|
+
record_refund(invoice_id:string, input:RecordRefundInputParam):ChargebeeRequest<RecordRefundResponse>;
|
|
682
689
|
|
|
683
690
|
/**
|
|
684
691
|
* @description This API [removes payments](https://www.chargebee.com/docs/2.0/invoice-operations.html#actions-for-paid-invoices_remove-payment) applied to an invoice. Once the applied payment is removed, the invoice status returns to `not_paid` or `payment_due`. The removed payment is then added to the customer's excess payment balance.
|
|
685
692
|
|
|
686
693
|
*/
|
|
687
694
|
|
|
688
|
-
remove_payment(invoice_id:string, input
|
|
695
|
+
remove_payment(invoice_id:string, input:RemovePaymentInputParam):ChargebeeRequest<RemovePaymentResponse>;
|
|
689
696
|
|
|
690
697
|
/**
|
|
691
698
|
* @description This API removes a credit note attached to an invoice. When you remove a credit note from an invoice, the invoice status returns to `not_paid`.
|
|
@@ -694,7 +701,7 @@ If the order of precendence described above does not work for your use case, and
|
|
|
694
701
|
|
|
695
702
|
*/
|
|
696
703
|
|
|
697
|
-
remove_credit_note(invoice_id:string, input
|
|
704
|
+
remove_credit_note(invoice_id:string, input:RemoveCreditNoteInputParam):ChargebeeRequest<RemoveCreditNoteResponse>;
|
|
698
705
|
|
|
699
706
|
/**
|
|
700
707
|
* @description Voids the specified invoice. Any payments must be [removed](/docs/api/invoices?prod_cat_ver=2#remove_payment_from_an_invoice) from the invoice before voiding it.
|
|
@@ -876,6 +883,13 @@ The invoice is [linked](/docs/api?prod_cat_ver=2#mbe-linked-be) to the same
|
|
|
876
883
|
|
|
877
884
|
retain_payment_source?:boolean;
|
|
878
885
|
|
|
886
|
+
/**
|
|
887
|
+
* @description null
|
|
888
|
+
|
|
889
|
+
*/
|
|
890
|
+
|
|
891
|
+
payment_initiator?:PaymentInitiator;
|
|
892
|
+
|
|
879
893
|
/**
|
|
880
894
|
* @description Parameters for shipping_address
|
|
881
895
|
|
|
@@ -951,7 +965,7 @@ The invoice is [linked](/docs/api?prod_cat_ver=2#mbe-linked-be) to the same
|
|
|
951
965
|
|
|
952
966
|
*/
|
|
953
967
|
|
|
954
|
-
discounts
|
|
968
|
+
discounts:{amount?:number,apply_on:ApplyOn,item_price_id?:string,percentage?:number}[];
|
|
955
969
|
}
|
|
956
970
|
export interface StopDunningResponse {
|
|
957
971
|
invoice:Invoice;
|
|
@@ -1159,42 +1173,42 @@ The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to b
|
|
|
1159
1173
|
|
|
1160
1174
|
*/
|
|
1161
1175
|
|
|
1162
|
-
line_items
|
|
1176
|
+
line_items:{amount?:number,amount_in_decimal?:string,date_from?:number,date_to?:number,description:string,entity_id?:string,entity_type?:'addon_item_price' | 'plan_item_price' | 'charge_item_price' | 'adhoc',id?:string,item_level_discount1_amount?:number,item_level_discount1_entity_id?:string,item_level_discount2_amount?:number,item_level_discount2_entity_id?:string,quantity?:number,quantity_in_decimal?:string,subscription_id?:string,tax10_amount?:number,tax10_name?:string,tax1_amount?:number,tax1_name?:string,tax2_amount?:number,tax2_name?:string,tax3_amount?:number,tax3_name?:string,tax4_amount?:number,tax4_name?:string,tax5_amount?:number,tax5_name?:string,tax6_amount?:number,tax6_name?:string,tax7_amount?:number,tax7_name?:string,tax8_amount?:number,tax8_name?:string,tax9_amount?:number,tax9_name?:string,unit_amount?:number,unit_amount_in_decimal?:string}[];
|
|
1163
1177
|
|
|
1164
1178
|
/**
|
|
1165
1179
|
* @description Parameters for payment_reference_numbers
|
|
1166
1180
|
|
|
1167
1181
|
*/
|
|
1168
1182
|
|
|
1169
|
-
payment_reference_numbers
|
|
1183
|
+
payment_reference_numbers:{id?:string,number:string,type:'frn' | 'kid' | 'fik' | 'swiss_reference' | 'ocr'}[];
|
|
1170
1184
|
|
|
1171
1185
|
/**
|
|
1172
1186
|
* @description Parameters for line_item_tiers
|
|
1173
1187
|
|
|
1174
1188
|
*/
|
|
1175
1189
|
|
|
1176
|
-
line_item_tiers
|
|
1190
|
+
line_item_tiers:{ending_unit?:number,ending_unit_in_decimal?:string,line_item_id:string,quantity_used?:number,quantity_used_in_decimal?:string,starting_unit?:number,starting_unit_in_decimal?:string,unit_amount?:number,unit_amount_in_decimal?:string}[];
|
|
1177
1191
|
|
|
1178
1192
|
/**
|
|
1179
1193
|
* @description Parameters for discounts
|
|
1180
1194
|
|
|
1181
1195
|
*/
|
|
1182
1196
|
|
|
1183
|
-
discounts
|
|
1197
|
+
discounts:{amount:number,description?:string,entity_id?:string,entity_type:'item_level_coupon' | 'promotional_credits' | 'item_level_discount' | 'document_level_discount' | 'document_level_coupon',line_item_id?:string}[];
|
|
1184
1198
|
|
|
1185
1199
|
/**
|
|
1186
1200
|
* @description Parameters for taxes
|
|
1187
1201
|
|
|
1188
1202
|
*/
|
|
1189
1203
|
|
|
1190
|
-
taxes
|
|
1204
|
+
taxes:{amount?:number,description?:string,juris_code?:string,juris_name?:string,juris_type?:'special' | 'country' | 'unincorporated' | 'other' | 'city' | 'federal' | 'county' | 'state',name:string,rate:number}[];
|
|
1191
1205
|
|
|
1192
1206
|
/**
|
|
1193
1207
|
* @description Parameters for payments
|
|
1194
1208
|
|
|
1195
1209
|
*/
|
|
1196
1210
|
|
|
1197
|
-
payments
|
|
1211
|
+
payments:{amount:number,date?:number,payment_method:PaymentMethod,reference_number?:string}[];
|
|
1198
1212
|
|
|
1199
1213
|
/**
|
|
1200
1214
|
* @description Parameters for notes
|
|
@@ -1617,7 +1631,7 @@ The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to b
|
|
|
1617
1631
|
|
|
1618
1632
|
*/
|
|
1619
1633
|
|
|
1620
|
-
item_price
|
|
1634
|
+
item_price:{date_from?:number,date_to?:number,item_price_id:string,quantity?:number,quantity_in_decimal?:string,unit_price?:number,unit_price_in_decimal?:string};
|
|
1621
1635
|
|
|
1622
1636
|
/**
|
|
1623
1637
|
* @description Parameters for item_tiers
|
|
@@ -1727,7 +1741,7 @@ The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to b
|
|
|
1727
1741
|
|
|
1728
1742
|
*/
|
|
1729
1743
|
|
|
1730
|
-
transaction
|
|
1744
|
+
transaction:{amount?:number,custom_payment_method_id?:string,date?:number,error_code?:string,error_text?:string,id_at_gateway?:string,payment_method:PaymentMethod,reference_number?:string,status?:'success' | 'failure'};
|
|
1731
1745
|
}
|
|
1732
1746
|
export interface RecordTaxWithheldResponse {
|
|
1733
1747
|
invoice:Invoice;
|
|
@@ -1739,7 +1753,7 @@ The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to b
|
|
|
1739
1753
|
|
|
1740
1754
|
*/
|
|
1741
1755
|
|
|
1742
|
-
tax_withheld
|
|
1756
|
+
tax_withheld:{amount:number,date?:number,description?:string,reference_number?:string};
|
|
1743
1757
|
}
|
|
1744
1758
|
export interface RemoveTaxWithheldResponse {
|
|
1745
1759
|
invoice:Invoice;
|
|
@@ -1751,7 +1765,7 @@ The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to b
|
|
|
1751
1765
|
|
|
1752
1766
|
*/
|
|
1753
1767
|
|
|
1754
|
-
tax_withheld
|
|
1768
|
+
tax_withheld:{id:string};
|
|
1755
1769
|
}
|
|
1756
1770
|
export interface RefundResponse {
|
|
1757
1771
|
invoice:Invoice;
|
|
@@ -1818,7 +1832,7 @@ The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to b
|
|
|
1818
1832
|
|
|
1819
1833
|
*/
|
|
1820
1834
|
|
|
1821
|
-
transaction
|
|
1835
|
+
transaction:{amount?:number,custom_payment_method_id?:string,date:number,payment_method:PaymentMethod,reference_number?:string};
|
|
1822
1836
|
|
|
1823
1837
|
/**
|
|
1824
1838
|
* @description Parameters for credit_note
|
|
@@ -1839,7 +1853,7 @@ The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to b
|
|
|
1839
1853
|
|
|
1840
1854
|
*/
|
|
1841
1855
|
|
|
1842
|
-
transaction
|
|
1856
|
+
transaction:{id:string};
|
|
1843
1857
|
}
|
|
1844
1858
|
export interface RemoveCreditNoteResponse {
|
|
1845
1859
|
invoice:Invoice;
|
|
@@ -1853,7 +1867,7 @@ The [invoice](/docs/api/invoices?prod_cat_ver=1#invoice_status) is yet to b
|
|
|
1853
1867
|
|
|
1854
1868
|
*/
|
|
1855
1869
|
|
|
1856
|
-
credit_note
|
|
1870
|
+
credit_note:{id:string};
|
|
1857
1871
|
}
|
|
1858
1872
|
export interface VoidInvoiceResponse {
|
|
1859
1873
|
invoice:Invoice;
|
|
@@ -2038,7 +2052,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2038
2052
|
amount?:number;
|
|
2039
2053
|
|
|
2040
2054
|
/**
|
|
2041
|
-
* @description The [pricing scheme](https://www.chargebee.com/docs/2.0/plans.html#pricing-models) for this item price. \* stairstep - A quantity-based pricing scheme. The item is charged a fixed price based on the tier that the total quantity falls in. \* flat_fee - A fixed price that is not quantity-based. \* tiered - The per unit price is based on the tier that the total quantity falls in.
|
|
2055
|
+
* @description The [pricing scheme](https://www.chargebee.com/docs/2.0/plans.html#pricing-models) for this item price. \* per_unit - A fixed price per unit quantity. \* volume - There are quantity tiers for which per unit prices are set. Quantities are purchased from successive tiers. \* stairstep - A quantity-based pricing scheme. The item is charged a fixed price based on the tier that the total quantity falls in. \* flat_fee - A fixed price that is not quantity-based. \* tiered - The per unit price is based on the tier that the total quantity falls in.
|
|
2042
2056
|
|
|
2043
2057
|
*/
|
|
2044
2058
|
|
|
@@ -2122,14 +2136,14 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2122
2136
|
entity_description?:string;
|
|
2123
2137
|
|
|
2124
2138
|
/**
|
|
2125
|
-
* @description Specifies the modelled entity this line item is based on. \* addon - Indicates that this lineitem is based on 'Addon' entity. The 'entity_id' attribute specifies the [addon](/docs/api/addons#addon_attributes) id \* plan - Indicates that this lineitem is based on 'Plan' entity. The 'entity_id' attribute specifies the [plan](/docs/api/plans#plan_attributes) id \* plan_item_price - Indicates that this line item is based on plan Item Price \*
|
|
2139
|
+
* @description Specifies the modelled entity this line item is based on. \* addon_item_price - Indicates that this line item is based on addon Item Price \* adhoc - Indicates that this lineitem is not modelled. i.e created adhoc. So the 'entity_id' attribute will be null in this case \* addon - Indicates that this lineitem is based on 'Addon' entity. The 'entity_id' attribute specifies the [addon](/docs/api/addons#addon_attributes) id \* plan - Indicates that this lineitem is based on 'Plan' entity. The 'entity_id' attribute specifies the [plan](/docs/api/plans#plan_attributes) id \* plan_item_price - Indicates that this line item is based on plan Item Price \* charge_item_price - Indicates that this line item is based on charge Item Price \* plan_setup - Indicates that this lineitem is based on 'Plan Setup' charge. The 'entity_id' attribute specifies the [plan](/docs/api/plans#plan_attributes) id
|
|
2126
2140
|
|
|
2127
2141
|
*/
|
|
2128
2142
|
|
|
2129
2143
|
entity_type:'addon_item_price' | 'plan_item_price' | 'charge_item_price' | 'adhoc';
|
|
2130
2144
|
|
|
2131
2145
|
/**
|
|
2132
|
-
* @description The reason due to which the line item price/amount is exempted from tax. \* zero_value_item - If the total invoice value/amount is equal to zero. E.g., If the total order value is $10 and a $10 coupon has been applied against that order, the total order value becomes $0. Hence the invoice value also becomes $0. \* reverse_charge - If the Customer is identified as B2B customer (when VAT Number is entered), applicable for EU only \*
|
|
2146
|
+
* @description The reason due to which the line item price/amount is exempted from tax. \* tax_not_configured - If tax is not enabled for the site \* customer_exempt - If the Customer is marked as Tax exempt \* region_non_taxable - If the product sold is not taxable in this region, but it is taxable in other regions, hence this region is not part of the Taxable jurisdiction \* product_exempt - If the Plan or Addon is marked as Tax exempt \* zero_value_item - If the total invoice value/amount is equal to zero. E.g., If the total order value is $10 and a $10 coupon has been applied against that order, the total order value becomes $0. Hence the invoice value also becomes $0. \* reverse_charge - If the Customer is identified as B2B customer (when VAT Number is entered), applicable for EU only \* high_value_physical_goods - If physical goods are sold from outside Australia to customers in Australia, and the price of all the physical good line items is greater than AUD 1000, then tax will not be applied \* zero_rated - If the rate of tax is 0% and no Sales/ GST tax is collectable for that line item \* export - You are not registered for tax in the customer's region. This is also the reason code when both `billing_address` and `shipping_address` have not been provided for the customer and subscription respectively
|
|
2133
2147
|
|
|
2134
2148
|
*/
|
|
2135
2149
|
|
|
@@ -2172,7 +2186,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2172
2186
|
line_item_id?:string;
|
|
2173
2187
|
|
|
2174
2188
|
/**
|
|
2175
|
-
* @description The type of deduction and the amount to which it is applied. \* prorated_credits - The deduction is due to a legacy adjustment credit applied to the invoice. The `entity_id` is `null` in this case. The legacy credits feature is superseded by [adjustment_credit_notes](/docs/api/invoices?prod_cat_ver=2#invoice_adjustment_credit_notes). \*
|
|
2189
|
+
* @description The type of deduction and the amount to which it is applied. \* prorated_credits - The deduction is due to a legacy adjustment credit applied to the invoice. The `entity_id` is `null` in this case. The legacy credits feature is superseded by [adjustment_credit_notes](/docs/api/invoices?prod_cat_ver=2#invoice_adjustment_credit_notes). \* item_level_discount - The deduction is due to a [discount](/docs/api/discounts?prod_cat_ver=2) applied to a line item of the invoice. The discount `id` is available as the `entity_id`. \* promotional_credits - The deduction is due to a [promotional credit](/docs/api/promotional_credits?prod_cat_ver=2) applied to the invoice. \* document_level_discount - The deduction is due to a [discount](/docs/api/discounts?prod_cat_ver=2) applied to the invoice `sub_total`. The discount `id` is available as the `entity_id`. \* item_level_coupon - The deduction is due to a coupon applied to line item. The coupon `id` is passed as `entity_id`. \* document_level_coupon - The deduction is due to a coupon applied to the invoice `sub_total`. The coupon id is passed as `entity_id`.
|
|
2176
2190
|
|
|
2177
2191
|
*/
|
|
2178
2192
|
|
|
@@ -2208,7 +2222,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2208
2222
|
line_item_id:string;
|
|
2209
2223
|
|
|
2210
2224
|
/**
|
|
2211
|
-
* @description The type of deduction and the amount to which it is applied. \* prorated_credits - The deduction is due to a legacy adjustment credit applied to the invoice. The `entity_id` is `null` in this case. The legacy credits feature is superseded by [adjustment_credit_notes](/docs/api/invoices?prod_cat_ver=2#invoice_adjustment_credit_notes). \*
|
|
2225
|
+
* @description The type of deduction and the amount to which it is applied. \* prorated_credits - The deduction is due to a legacy adjustment credit applied to the invoice. The `entity_id` is `null` in this case. The legacy credits feature is superseded by [adjustment_credit_notes](/docs/api/invoices?prod_cat_ver=2#invoice_adjustment_credit_notes). \* promotional_credits - The deduction is due to a [promotional credit](/docs/api/promotional_credits) applied to the invoice. The `entity_id` is `null` in this case. \* document_level_discount - The deduction is due to a [discount](/docs/api/discounts?prod_cat_ver=2) applied to the invoice `sub_total`. The discount `id` is available as the `entity_id`. \* item_level_discount - The deduction is due to a [discount](/docs/api/discounts?prod_cat_ver=2) applied to a line item of the invoice. The discount `id` is available as the `entity_id`. \* document_level_coupon - The deduction is due to a coupon applied to the invoice `sub_total`. The coupon `id` is available as `entity_id`. \* item_level_coupon - The deduction is due to a coupon applied to a line item of the invoice. The coupon `id` is available as `entity_id`.
|
|
2212
2226
|
|
|
2213
2227
|
*/
|
|
2214
2228
|
|
|
@@ -2274,6 +2288,27 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2274
2288
|
|
|
2275
2289
|
tax_rate:number;
|
|
2276
2290
|
|
|
2291
|
+
/**
|
|
2292
|
+
* @description Indicates the service period end of the tax rate for the line item.
|
|
2293
|
+
|
|
2294
|
+
*/
|
|
2295
|
+
|
|
2296
|
+
date_to?:number;
|
|
2297
|
+
|
|
2298
|
+
/**
|
|
2299
|
+
* @description Indicates the service period start of the tax rate for the line item.
|
|
2300
|
+
|
|
2301
|
+
*/
|
|
2302
|
+
|
|
2303
|
+
date_from?:number;
|
|
2304
|
+
|
|
2305
|
+
/**
|
|
2306
|
+
* @description Indicates the prorated line item amount in cents.
|
|
2307
|
+
|
|
2308
|
+
*/
|
|
2309
|
+
|
|
2310
|
+
prorated_taxable_amount?:number;
|
|
2311
|
+
|
|
2277
2312
|
/**
|
|
2278
2313
|
* @description Indicates if tax is applied only on a portion of the line item amount.
|
|
2279
2314
|
|
|
@@ -2303,7 +2338,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2303
2338
|
tax_amount:number;
|
|
2304
2339
|
|
|
2305
2340
|
/**
|
|
2306
|
-
* @description The type of tax jurisdiction \* federal - The tax jurisdiction is a federal \* state - The tax jurisdiction is a state \*
|
|
2341
|
+
* @description The type of tax jurisdiction \* federal - The tax jurisdiction is a federal \* state - The tax jurisdiction is a state \* city - The tax jurisdiction is a city \* special - Special tax jurisdiction. \* unincorporated - Combined tax of state and county. \* county - The tax jurisdiction is a county \* country - The tax jurisdiction is a country \* other - Jurisdictions other than the ones listed above.
|
|
2307
2342
|
|
|
2308
2343
|
*/
|
|
2309
2344
|
|
|
@@ -2424,7 +2459,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2424
2459
|
applied_at:number;
|
|
2425
2460
|
|
|
2426
2461
|
/**
|
|
2427
|
-
* @description The status of this transaction. \* timeout - Transaction failed because of Gateway not accepting the connection. \*
|
|
2462
|
+
* @description The status of this transaction. \* timeout - Transaction failed because of Gateway not accepting the connection. \* failure - Transaction failed. Refer the 'error_code' and 'error_text' fields to know the reason for failure \* in_progress - Transaction is being processed by the gateway. This typically happens for [direct debit transactions](https://www.chargebee.com/docs/direct-debit-payments.html) or, in case of cards, refund transactions. Such transactions can take 2-7 days to complete, depending on the gateway and payment method. \* success - The transaction is successful. \* voided - The transaction got voided or authorization expired at gateway. \* needs_attention - Connection with Gateway got terminated abruptly. So, status of this transaction needs to be resolved manually
|
|
2428
2463
|
|
|
2429
2464
|
*/
|
|
2430
2465
|
|
|
@@ -2474,7 +2509,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2474
2509
|
created_at?:number;
|
|
2475
2510
|
|
|
2476
2511
|
/**
|
|
2477
|
-
* @description The status of this transaction. \* success - The transaction is successful. \*
|
|
2512
|
+
* @description The status of this transaction. \* success - The transaction is successful. \* needs_attention - Connection with Gateway got terminated abruptly. So, status of this transaction needs to be resolved manually \* failure - Transaction failed. Refer the 'error_code' and 'error_text' fields to know the reason for failure \* voided - The transaction got voided or authorization expired at gateway. \* in_progress - Transaction is being processed by the gateway. This typically happens for [direct debit transactions](https://www.chargebee.com/docs/direct-debit-payments.html) or, in case of cards, refund transactions. Such transactions can take 2-7 days to complete, depending on the gateway and payment method. \* timeout - Transaction failed because of Gateway not accepting the connection.
|
|
2478
2513
|
|
|
2479
2514
|
*/
|
|
2480
2515
|
|
|
@@ -2510,7 +2545,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2510
2545
|
applied_at:number;
|
|
2511
2546
|
|
|
2512
2547
|
/**
|
|
2513
|
-
* @description Credit note reason code. Deprecated; use the cn_create_reason_code parameter instead \*
|
|
2548
|
+
* @description Credit note reason code. Deprecated; use the cn_create_reason_code parameter instead \* other - Can be set when none of the above reason codes are applicable \* order_cancellation - Order Cancellation \* product_unsatisfactory - Product Unsatisfactory \* chargeback - Can be set when you are recording your customer Chargebacks \* subscription_cancellation - This reason will be set automatically for Credit Notes created during cancel subscription operation \* fraudulent - FRAUDULENT \* subscription_pause - This reason will be automatically set to credit notes created during pause/resume subscription operation. \* service_unsatisfactory - Service Unsatisfactory \* subscription_change - This reason will be set automatically for Credit Notes created during Change Subscription operation when [proration](https://www.chargebee.com/docs/proration.html) is enabled \* write_off - This reason will be set automatically for the Credit Notes created during invoice [Write Off](https://www.chargebee.com/docs/invoice-operations.html#write-off) operation. \* order_change - Order Change \* waiver - Waiver
|
|
2514
2549
|
|
|
2515
2550
|
*/
|
|
2516
2551
|
|
|
@@ -2531,7 +2566,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2531
2566
|
cn_date?:number;
|
|
2532
2567
|
|
|
2533
2568
|
/**
|
|
2534
|
-
* @description Credit note status. \*
|
|
2569
|
+
* @description Credit note status. \* voided - When the Credit Note has been cancelled. \* adjusted - When the Credit Note has been adjusted against an invoice. \* refund_due - When the credits are yet to be used, or have been partially used. \* refunded - When the entire credits (Credit Note amount) have been used (i.e either allocated to invoices or refunded).
|
|
2535
2570
|
|
|
2536
2571
|
*/
|
|
2537
2572
|
|
|
@@ -2546,7 +2581,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2546
2581
|
cn_id:string;
|
|
2547
2582
|
|
|
2548
2583
|
/**
|
|
2549
|
-
* @description Credit note reason code. Deprecated; use the cn_create_reason_code parameter instead \* subscription_cancellation - This reason will be set automatically for Credit Notes created during cancel subscription operation \* waiver - Waiver \*
|
|
2584
|
+
* @description Credit note reason code. Deprecated; use the cn_create_reason_code parameter instead \* subscription_cancellation - This reason will be set automatically for Credit Notes created during cancel subscription operation \* waiver - Waiver \* write_off - This reason will be set automatically for the Credit Notes created during invoice [Write Off](https://www.chargebee.com/docs/invoice-operations.html#write-off) operation. \* service_unsatisfactory - Service Unsatisfactory \* fraudulent - FRAUDULENT \* product_unsatisfactory - Product Unsatisfactory \* order_change - Order Change \* subscription_change - This reason will be set automatically for Credit Notes created during Change Subscription operation when [proration](https://www.chargebee.com/docs/proration.html) is enabled \* order_cancellation - Order Cancellation \* other - Can be set when none of the above reason codes are applicable \* chargeback - Can be set when you are recording your customer Chargebacks \* subscription_pause - This reason will be automatically set to credit notes created during pause/resume subscription operation.
|
|
2550
2585
|
|
|
2551
2586
|
*/
|
|
2552
2587
|
|
|
@@ -2574,7 +2609,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2574
2609
|
cn_total?:number;
|
|
2575
2610
|
|
|
2576
2611
|
/**
|
|
2577
|
-
* @description Credit note status. \*
|
|
2612
|
+
* @description Credit note status. \* refunded - When the entire credits (Credit Note amount) have been used (i.e either allocated to invoices or refunded). \* voided - When the Credit Note has been cancelled. \* refund_due - When the credits are yet to be used, or have been partially used. \* adjusted - When the Credit Note has been adjusted against an invoice.
|
|
2578
2613
|
|
|
2579
2614
|
*/
|
|
2580
2615
|
|
|
@@ -2589,7 +2624,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2589
2624
|
cn_id:string;
|
|
2590
2625
|
|
|
2591
2626
|
/**
|
|
2592
|
-
* @description Credit note reason code. Deprecated; use the cn_create_reason_code parameter instead \* fraudulent - FRAUDULENT \*
|
|
2627
|
+
* @description Credit note reason code. Deprecated; use the cn_create_reason_code parameter instead \* fraudulent - FRAUDULENT \* chargeback - Can be set when you are recording your customer Chargebacks \* subscription_pause - This reason will be automatically set to credit notes created during pause/resume subscription operation. \* order_change - Order Change \* subscription_change - This reason will be set automatically for Credit Notes created during Change Subscription operation when [proration](https://www.chargebee.com/docs/proration.html) is enabled \* product_unsatisfactory - Product Unsatisfactory \* write_off - This reason will be set automatically for the Credit Notes created during invoice [Write Off](https://www.chargebee.com/docs/invoice-operations.html#write-off) operation. \* subscription_cancellation - This reason will be set automatically for Credit Notes created during cancel subscription operation \* service_unsatisfactory - Service Unsatisfactory \* waiver - Waiver \* order_cancellation - Order Cancellation \* other - Can be set when none of the above reason codes are applicable
|
|
2593
2628
|
|
|
2594
2629
|
*/
|
|
2595
2630
|
|
|
@@ -2617,7 +2652,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2617
2652
|
cn_total?:number;
|
|
2618
2653
|
|
|
2619
2654
|
/**
|
|
2620
|
-
* @description Credit note status. \* refund_due - When the credits are yet to be used, or have been partially used. \* adjusted - When the Credit Note has been adjusted against an invoice. \* refunded - When the entire credits (Credit Note amount) have been used (i.e either allocated to invoices or refunded).
|
|
2655
|
+
* @description Credit note status. \* refund_due - When the credits are yet to be used, or have been partially used. \* adjusted - When the Credit Note has been adjusted against an invoice. \* voided - When the Credit Note has been cancelled. \* refunded - When the entire credits (Credit Note amount) have been used (i.e either allocated to invoices or refunded).
|
|
2621
2656
|
|
|
2622
2657
|
*/
|
|
2623
2658
|
|
|
@@ -2639,14 +2674,14 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2639
2674
|
document_number?:string;
|
|
2640
2675
|
|
|
2641
2676
|
/**
|
|
2642
|
-
* @description The status of this order. \* awaiting_shipment - The order has been picked up by an integration system, and synced to a shipping management platform \*
|
|
2677
|
+
* @description The status of this order. \* awaiting_shipment - The order has been picked up by an integration system, and synced to a shipping management platform \* queued - Order is yet to be processed by any system, these are scheduled orders created by Chargebee \* returned - The order has been returned after delivery. \* complete - Order has been processed successfully. Applicable only if you are using Chargebee's legacy order management system \* processing - Order is being processed. Applicable only if you are using Chargebee's legacy order management system \* new - Order has been created. Applicable only if you are using Chargebee's legacy order management system. \* shipped - The order has moved from order management system to a shipping system. \* on_hold - The order is paused from being processed. \* cancelled - Order has been cancelled. Applicable only if you are using Chargebee's legacy order management system \* delivered - The order has been delivered to the customer. \* partially_delivered - The order has been partially delivered to the customer. \* voided - Order has been voided. Applicable only if you are using Chargebee's legacy order management system
|
|
2643
2678
|
|
|
2644
2679
|
*/
|
|
2645
2680
|
|
|
2646
2681
|
status?:'new' | 'partially_delivered' | 'queued' | 'delivered' | 'on_hold' | 'shipped' | 'processing' | 'cancelled' | 'voided' | 'complete' | 'awaiting_shipment' | 'returned';
|
|
2647
2682
|
|
|
2648
2683
|
/**
|
|
2649
|
-
* @description Order type \*
|
|
2684
|
+
* @description Order type \* system_generated - The order has been created by Chargebee automatically based on the preferences set by the user. \* manual - The order has been created by the the user using Chargebee's legacy order management system.
|
|
2650
2685
|
|
|
2651
2686
|
*/
|
|
2652
2687
|
|
|
@@ -2682,7 +2717,7 @@ For metered line items, this value is updated from [usages](https://apidocs.char
|
|
|
2682
2717
|
}
|
|
2683
2718
|
export interface Note {
|
|
2684
2719
|
/**
|
|
2685
|
-
* @description Type of entity to which the note belongs. \* subscription - Entity that represents a subscription of customer. \*
|
|
2720
|
+
* @description Type of entity to which the note belongs. \* subscription - Entity that represents a subscription of customer. \* customer - Entity that represents a customer. \* plan - Entity that represents a plan. \* tax - The note is configured as part of the [tax configuration](https://www.chargebee.com/docs/tax.html) in Chargebee Billing. \* addon_item_price - Indicates that this line item is based on addon Item Price \* addon - Entity that represents an addon. \* plan_item_price - Indicates that this line item is based on plan Item Price \* coupon - Entity that represents a coupon. \* charge_item_price - Indicates that this line item is based on charge Item Price
|
|
2686
2721
|
|
|
2687
2722
|
*/
|
|
2688
2723
|
|
|
@@ -2816,10 +2851,25 @@ If you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021
|
|
|
2816
2851
|
index:number;
|
|
2817
2852
|
}
|
|
2818
2853
|
export interface StatementDescriptor {
|
|
2854
|
+
/**
|
|
2855
|
+
* @description Uniquely identifies a statement_descriptor
|
|
2856
|
+
|
|
2857
|
+
*/
|
|
2858
|
+
|
|
2819
2859
|
id:string;
|
|
2820
2860
|
|
|
2861
|
+
/**
|
|
2862
|
+
* @description Payment descriptor text
|
|
2863
|
+
|
|
2864
|
+
*/
|
|
2865
|
+
|
|
2821
2866
|
descriptor?:string;
|
|
2822
2867
|
|
|
2868
|
+
/**
|
|
2869
|
+
* @description Payment descriptor additional info
|
|
2870
|
+
|
|
2871
|
+
*/
|
|
2872
|
+
|
|
2823
2873
|
additional_info?:string;
|
|
2824
2874
|
}
|
|
2825
2875
|
export interface BillingAddress {
|
|
@@ -2922,7 +2972,7 @@ If you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021
|
|
|
2922
2972
|
zip?:string;
|
|
2923
2973
|
|
|
2924
2974
|
/**
|
|
2925
|
-
* @description The address verification status. \* valid - Address was validated successfully. \* partially_valid - The address is valid for taxability but has not been validated for shipping. \*
|
|
2975
|
+
* @description The address verification status. \* valid - Address was validated successfully. \* partially_valid - The address is valid for taxability but has not been validated for shipping. \* not_validated - Address is not yet validated. \* invalid - Address is invalid.
|
|
2926
2976
|
|
|
2927
2977
|
*/
|
|
2928
2978
|
|
|
@@ -2944,7 +2994,7 @@ If you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021
|
|
|
2944
2994
|
reference_number?:string;
|
|
2945
2995
|
|
|
2946
2996
|
/**
|
|
2947
|
-
* @description The status of processing the e-invoice. To obtain detailed information about the current `status`, see `message`. \*
|
|
2997
|
+
* @description The status of processing the e-invoice. To obtain detailed information about the current `status`, see `message`. \* skipped - The e-invoice was not sent. This could be due to missing information or because the `entity_identifier` is not registered on the e-invoicing network. \* failed - The e-invoice was sent and there was an error due to which it was not delivered. \* in_progress - The e-invoice has been sent and Chargebee is waiting for confirmation from the receiving entity. \* scheduled - Sending the e-invoice to the customer has been scheduled. \* success - The e-invoice has been successfully delivered to the customer. \* registered - The e-invoice was sent and there was an error due to which it was not delivered but got cleared in the IRP.
|
|
2948
2998
|
|
|
2949
2999
|
*/
|
|
2950
3000
|
|