9082745612

Committed 14 May 2024 04:18PM UTC coverage: 96.387% (+0.01%) from 96.375%

Build # 9082745612

Build Type

Pull #1328

github

Committed by

web-flow

Commit Message

Merge cc9483ead into 46edbe3eb

Pull Request Pull Request #1328: Update generated code

Run Details

1288 of 1901 branches covered (67.75%)

Branch coverage included in aggregate %.

156 of 157 new or added lines in 17 files covered. (99.36%)

803 existing lines in 91 files now uncovered.

64264 of 66108 relevant lines covered (97.21%)

0.97 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

96.36

/stripe/_invoice_line_item_service.py

# -*- coding: utf-8 -*-
# File generated from our OpenAPI spec
from stripe._invoice_line_item import InvoiceLineItem
from stripe._list_object import ListObject
from stripe._request_options import RequestOptions
from stripe._stripe_service import StripeService
from stripe._util import sanitize_id
from typing import Dict, List, cast
from typing_extensions import Literal, NotRequired, TypedDict


class InvoiceLineItemService(StripeService):
    class ListParams(TypedDict):
        ending_before: NotRequired[str]
        """
        A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
        """
        expand: NotRequired[List[str]]
        """
        Specifies which fields in the response should be expanded.
        """
        limit: NotRequired[int]
        """
        A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
        """
        starting_after: NotRequired[str]
        """
        A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
        """

    class UpdateParams(TypedDict):
        amount: NotRequired[int]
        """
        The integer amount in cents (or local equivalent) of the charge to be applied to the upcoming invoice. If you want to apply a credit to the customer's account, pass a negative amount.
        """
        description: NotRequired[str]
        """
        An arbitrary string which you can attach to the invoice item. The description is displayed in the invoice for easy tracking.
        """
        discountable: NotRequired[bool]
        """
        Controls whether discounts apply to this line item. Defaults to false for prorations or negative line items, and true for all other line items. Cannot be set to true for prorations.
        """
        discounts: NotRequired[
            "Literal['']|List[InvoiceLineItemService.UpdateParamsDiscount]"
        ]
        """
        The coupons, promotion codes & existing discounts which apply to the line item. Item discounts are applied before invoice discounts. Pass an empty string to remove previously-defined discounts.
        """
        expand: NotRequired[List[str]]
        """
        Specifies which fields in the response should be expanded.
        """
        metadata: NotRequired["Literal['']|Dict[str, str]"]
        """
        Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. For `type=recurring` line items, the incoming metadata specified on the request is directly used to set this value, in contrast to `type=invoiceitem` line items, where any existing metadata on the invoice line is merged with the incoming data.
        """
        period: NotRequired["InvoiceLineItemService.UpdateParamsPeriod"]
        """
        The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details.
        """
        price: NotRequired[str]
        """
        The ID of the price object.
        """
        price_data: NotRequired["InvoiceLineItemService.UpdateParamsPriceData"]
        """
        Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline.
        """
        quantity: NotRequired[int]
        """
        Non-negative integer. The quantity of units for the line item.
        """
        tax_amounts: NotRequired[
            "Literal['']|List[InvoiceLineItemService.UpdateParamsTaxAmount]"
        ]
        """
        A list of up to 10 tax amounts for this line item. This can be useful if you calculate taxes on your own or use a third-party to calculate them. You cannot set tax amounts if any line item has [tax_rates](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-tax_rates) or if the invoice has [default_tax_rates](https://stripe.com/docs/api/invoices/object#invoice_object-default_tax_rates) or uses [automatic tax](https://stripe.com/docs/tax/invoicing). Pass an empty string to remove previously defined tax amounts.
        """
        tax_rates: NotRequired["Literal['']|List[str]"]
        """
        The tax rates which apply to the line item. When set, the `default_tax_rates` on the invoice do not apply to this line item. Pass an empty string to remove previously-defined tax rates.
        """

    class UpdateParamsDiscount(TypedDict):
        coupon: NotRequired[str]
        """
        ID of the coupon to create a new discount for.
        """
        discount: NotRequired[str]
        """
        ID of an existing discount on the object (or one of its ancestors) to reuse.
        """
        promotion_code: NotRequired[str]
        """
        ID of the promotion code to create a new discount for.
        """

    class UpdateParamsPeriod(TypedDict):
        end: int
        """
        The end of the period, which must be greater than or equal to the start. This value is inclusive.
        """
        start: int
        """
        The start of the period. This value is inclusive.
        """

    class UpdateParamsPriceData(TypedDict):
        currency: str
        """
        Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
        """
        product: NotRequired[str]
        """
        The ID of the product that this price will belong to. One of `product` or `product_data` is required.
        """
        product_data: NotRequired[
            "InvoiceLineItemService.UpdateParamsPriceDataProductData"
        ]
        """
        Data used to generate a new product object inline. One of `product` or `product_data` is required.
        """
        tax_behavior: NotRequired[
            Literal["exclusive", "inclusive", "unspecified"]
        ]
        """
        Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
        """
        unit_amount: NotRequired[int]
        """
        A non-negative integer in cents (or local equivalent) representing how much to charge. One of `unit_amount` or `unit_amount_decimal` is required.
        """
        unit_amount_decimal: NotRequired[str]
        """
        Same as `unit_amount`, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one of `unit_amount` and `unit_amount_decimal` can be set.
        """

    class UpdateParamsPriceDataProductData(TypedDict):
        description: NotRequired[str]
        """
        The product's description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes.
        """
        images: NotRequired[List[str]]
        """
        A list of up to 8 URLs of images for this product, meant to be displayable to the customer.
        """
        metadata: NotRequired[Dict[str, str]]
        """
        Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
        """
        name: str
        """
        The product's name, meant to be displayable to the customer.
        """
        tax_code: NotRequired[str]
        """
        A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
        """

    class UpdateParamsTaxAmount(TypedDict):
        amount: int
        """
        The amount, in cents (or local equivalent), of the tax.
        """
        tax_rate_data: (
            "InvoiceLineItemService.UpdateParamsTaxAmountTaxRateData"
        )
        """
        Data to find or create a TaxRate object.

        Stripe automatically creates or reuses a TaxRate object for each tax amount. If the `tax_rate_data` exactly matches a previous value, Stripe will reuse the TaxRate object. TaxRate objects created automatically by Stripe are immediately archived, do not appear in the line item's `tax_rates`, and cannot be directly added to invoices, payments, or line items.
        """
        taxable_amount: int
        """
        The amount on which tax is calculated, in cents (or local equivalent).
        """

    class UpdateParamsTaxAmountTaxRateData(TypedDict):
        country: NotRequired[str]
        """
        Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
        """
        description: NotRequired[str]
        """
        An arbitrary string attached to the tax rate for your internal use only. It will not be visible to your customers.
        """
        display_name: str
        """
        The display name of the tax rate, which will be shown to users.
        """
        inclusive: bool
        """
        This specifies if the tax rate is inclusive or exclusive.
        """
        jurisdiction: NotRequired[str]
        """
        The jurisdiction for the tax rate. You can use this label field for tax reporting purposes. It also appears on your customer's invoice.
        """
        percentage: float
        """
        The statutory tax rate percent. This field accepts decimal values between 0 and 100 inclusive with at most 4 decimal places. To accommodate fixed-amount taxes, set the percentage to zero. Stripe will not display zero percentages on the invoice unless the `amount` of the tax is also zero.
        """
        state: NotRequired[str]
        """
        [ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2:US), without country prefix. For example, "NY" for New York, United States.
        """
        tax_type: NotRequired[
            Literal[
                "amusement_tax",
                "communications_tax",
                "gst",
                "hst",
                "igst",
                "jct",
                "lease_tax",
                "pst",
                "qst",
                "rst",
                "sales_tax",
                "vat",
            ]
        ]
        """
        The high-level tax type, such as `vat` or `sales_tax`.
        """

    def list(
        self,
        invoice: str,
        params: "InvoiceLineItemService.ListParams" = {},
        options: RequestOptions = {},
    ) -> ListObject[InvoiceLineItem]:
        """
        When retrieving an invoice, you'll get a lines property containing the total count of line items and the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
        """
        return cast(
            ListObject[InvoiceLineItem],
            self._request(
                "get",
                "/v1/invoices/{invoice}/lines".format(
                    invoice=sanitize_id(invoice),
                ),
                api_mode="V1",
                base_address="api",
                params=params,
                options=options,
            ),
        )

    async def list_async(
        self,
        invoice: str,
        params: "InvoiceLineItemService.ListParams" = {},
        options: RequestOptions = {},
    ) -> ListObject[InvoiceLineItem]:
        """
        When retrieving an invoice, you'll get a lines property containing the total count of line items and the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
        """
        return cast(
            ListObject[InvoiceLineItem],
            await self._request_async(
                "get",
                "/v1/invoices/{invoice}/lines".format(
                    invoice=sanitize_id(invoice),
                ),
                api_mode="V1",
                base_address="api",
                params=params,
                options=options,
            ),
        )

    def update(
        self,
        invoice: str,
        line_item_id: str,
        params: "InvoiceLineItemService.UpdateParams" = {},
        options: RequestOptions = {},
    ) -> InvoiceLineItem:
        """
        Updates an invoice's line item. Some fields, such as tax_amounts, only live on the invoice line item,
        so they can only be updated through this endpoint. Other fields, such as amount, live on both the invoice
        item and the invoice line item, so updates on this endpoint will propagate to the invoice item as well.
        Updating an invoice's line item is only possible before the invoice is finalized.
        """
        return cast(
            InvoiceLineItem,
            self._request(
                "post",
                "/v1/invoices/{invoice}/lines/{line_item_id}".format(
                    invoice=sanitize_id(invoice),
                    line_item_id=sanitize_id(line_item_id),
                ),
                api_mode="V1",
                base_address="api",
                params=params,
                options=options,
            ),
        )

    async def update_async(
        self,
        invoice: str,
        line_item_id: str,
        params: "InvoiceLineItemService.UpdateParams" = {},
        options: RequestOptions = {},
    ) -> InvoiceLineItem:
        """
        Updates an invoice's line item. Some fields, such as tax_amounts, only live on the invoice line item,
        so they can only be updated through this endpoint. Other fields, such as amount, live on both the invoice
        item and the invoice line item, so updates on this endpoint will propagate to the invoice item as well.
        Updating an invoice's line item is only possible before the invoice is finalized.
        """
        return cast(
            InvoiceLineItem,
            await self._request_async(
                "post",
                "/v1/invoices/{invoice}/lines/{line_item_id}".format(
                    invoice=sanitize_id(invoice),
                    line_item_id=sanitize_id(line_item_id),
                ),
                api_mode="V1",
                base_address="api",
                params=params,
                options=options,
            ),
        )

1	# -- coding: utf-8 --
2	# File generated from our OpenAPI spec
3	from stripe._invoice_line_item import InvoiceLineItem	1✔
4	from stripe._list_object import ListObject	1✔
5	from stripe._request_options import RequestOptions	1✔
6	from stripe._stripe_service import StripeService	1✔
7	from stripe._util import sanitize_id	1✔
8	from typing import Dict, List, cast	1✔
9	from typing_extensions import Literal, NotRequired, TypedDict	1✔
10
11
12	class InvoiceLineItemService(StripeService):	1✔
13	class ListParams(TypedDict):	1✔
14	ending_before: NotRequired[str]	1✔
15	"""	1✔
16	A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
17	"""
18	expand: NotRequired[List[str]]	1✔
19	"""	1✔
20	Specifies which fields in the response should be expanded.
21	"""
22	limit: NotRequired[int]	1✔
23	"""	1✔
24	A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
25	"""
26	starting_after: NotRequired[str]	1✔
27	"""	1✔
28	A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
29	"""
30
31	class UpdateParams(TypedDict):	1✔
32	amount: NotRequired[int]	1✔
33	"""	1✔
34	The integer amount in cents (or local equivalent) of the charge to be applied to the upcoming invoice. If you want to apply a credit to the customer's account, pass a negative amount.
35	"""
36	description: NotRequired[str]	1✔
37	"""	1✔
38	An arbitrary string which you can attach to the invoice item. The description is displayed in the invoice for easy tracking.
39	"""
40	discountable: NotRequired[bool]	1✔
41	"""	1✔
42	Controls whether discounts apply to this line item. Defaults to false for prorations or negative line items, and true for all other line items. Cannot be set to true for prorations.
43	"""
44	discounts: NotRequired[	1✔
45	"Literal['']\|List[InvoiceLineItemService.UpdateParamsDiscount]"
46	]
47	"""	1✔
48	The coupons, promotion codes & existing discounts which apply to the line item. Item discounts are applied before invoice discounts. Pass an empty string to remove previously-defined discounts.
49	"""
50	expand: NotRequired[List[str]]	1✔
51	"""	1✔
52	Specifies which fields in the response should be expanded.
53	"""
54	metadata: NotRequired["Literal['']\|Dict[str, str]"]	1✔
55	"""	1✔
56	Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. For `type=recurring` line items, the incoming metadata specified on the request is directly used to set this value, in contrast to `type=invoiceitem` line items, where any existing metadata on the invoice line is merged with the incoming data.
57	"""
58	period: NotRequired["InvoiceLineItemService.UpdateParamsPeriod"]	1✔
59	"""	1✔
60	The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details.
61	"""
62	price: NotRequired[str]	1✔
63	"""	1✔
64	The ID of the price object.
65	"""
66	price_data: NotRequired["InvoiceLineItemService.UpdateParamsPriceData"]	1✔
67	"""	1✔
68	Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline.
69	"""
70	quantity: NotRequired[int]	1✔
71	"""	1✔
72	Non-negative integer. The quantity of units for the line item.
73	"""
74	tax_amounts: NotRequired[	1✔
75	"Literal['']\|List[InvoiceLineItemService.UpdateParamsTaxAmount]"
76	]
77	"""	1✔
78	A list of up to 10 tax amounts for this line item. This can be useful if you calculate taxes on your own or use a third-party to calculate them. You cannot set tax amounts if any line item has [tax_rates](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-tax_rates) or if the invoice has [default_tax_rates](https://stripe.com/docs/api/invoices/object#invoice_object-default_tax_rates) or uses [automatic tax](https://stripe.com/docs/tax/invoicing). Pass an empty string to remove previously defined tax amounts.
79	"""
80	tax_rates: NotRequired["Literal['']\|List[str]"]	1✔
81	"""	1✔
82	The tax rates which apply to the line item. When set, the `default_tax_rates` on the invoice do not apply to this line item. Pass an empty string to remove previously-defined tax rates.
83	"""
84
85	class UpdateParamsDiscount(TypedDict):	1✔
86	coupon: NotRequired[str]	1✔
87	"""	1✔
88	ID of the coupon to create a new discount for.
89	"""
90	discount: NotRequired[str]	1✔
91	"""	1✔
92	ID of an existing discount on the object (or one of its ancestors) to reuse.
93	"""
94	promotion_code: NotRequired[str]	1✔
95	"""	1✔
96	ID of the promotion code to create a new discount for.
97	"""
98
99	class UpdateParamsPeriod(TypedDict):	1✔
100	end: int	1✔
101	"""	1✔
102	The end of the period, which must be greater than or equal to the start. This value is inclusive.
103	"""
104	start: int	1✔
105	"""	1✔
106	The start of the period. This value is inclusive.
107	"""
108
109	class UpdateParamsPriceData(TypedDict):	1✔
110	currency: str	1✔
111	"""	1✔
112	Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
113	"""
114	product: NotRequired[str]	1✔
115	"""	1✔
116	The ID of the product that this price will belong to. One of `product` or `product_data` is required.
117	"""
118	product_data: NotRequired[	1✔
119	"InvoiceLineItemService.UpdateParamsPriceDataProductData"
120	]
121	"""	1✔
122	Data used to generate a new product object inline. One of `product` or `product_data` is required.
123	"""
124	tax_behavior: NotRequired[	1✔
125	Literal["exclusive", "inclusive", "unspecified"]
126	]
127	"""	1✔
128	Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
129	"""
130	unit_amount: NotRequired[int]	1✔
131	"""	1✔
132	A non-negative integer in cents (or local equivalent) representing how much to charge. One of `unit_amount` or `unit_amount_decimal` is required.
133	"""
134	unit_amount_decimal: NotRequired[str]	1✔
135	"""	1✔
136	Same as `unit_amount`, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one of `unit_amount` and `unit_amount_decimal` can be set.
137	"""
138
139	class UpdateParamsPriceDataProductData(TypedDict):	1✔
140	description: NotRequired[str]	1✔
141	"""	1✔
142	The product's description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes.
143	"""
144	images: NotRequired[List[str]]	1✔
145	"""	1✔
146	A list of up to 8 URLs of images for this product, meant to be displayable to the customer.
147	"""
148	metadata: NotRequired[Dict[str, str]]	1✔
149	"""	1✔
150	Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
151	"""
152	name: str	1✔
153	"""	1✔
154	The product's name, meant to be displayable to the customer.
155	"""
156	tax_code: NotRequired[str]	1✔
157	"""	1✔
158	A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
159	"""
160
161	class UpdateParamsTaxAmount(TypedDict):	1✔
162	amount: int	1✔
163	"""	1✔
164	The amount, in cents (or local equivalent), of the tax.
165	"""
166	tax_rate_data: (	1✔
167	"InvoiceLineItemService.UpdateParamsTaxAmountTaxRateData"
168	)
169	"""	1✔
170	Data to find or create a TaxRate object.
171
172	Stripe automatically creates or reuses a TaxRate object for each tax amount. If the `tax_rate_data` exactly matches a previous value, Stripe will reuse the TaxRate object. TaxRate objects created automatically by Stripe are immediately archived, do not appear in the line item's `tax_rates`, and cannot be directly added to invoices, payments, or line items.
173	"""
174	taxable_amount: int	1✔
175	"""	1✔
176	The amount on which tax is calculated, in cents (or local equivalent).
177	"""
178
179	class UpdateParamsTaxAmountTaxRateData(TypedDict):	1✔
180	country: NotRequired[str]	1✔
181	"""	1✔
182	Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
183	"""
184	description: NotRequired[str]	1✔
185	"""	1✔
186	An arbitrary string attached to the tax rate for your internal use only. It will not be visible to your customers.
187	"""
188	display_name: str	1✔
189	"""	1✔
190	The display name of the tax rate, which will be shown to users.
191	"""
192	inclusive: bool	1✔
193	"""	1✔
194	This specifies if the tax rate is inclusive or exclusive.
195	"""
196	jurisdiction: NotRequired[str]	1✔
197	"""	1✔
198	The jurisdiction for the tax rate. You can use this label field for tax reporting purposes. It also appears on your customer's invoice.
199	"""
200	percentage: float	1✔
201	"""	1✔
202	The statutory tax rate percent. This field accepts decimal values between 0 and 100 inclusive with at most 4 decimal places. To accommodate fixed-amount taxes, set the percentage to zero. Stripe will not display zero percentages on the invoice unless the `amount` of the tax is also zero.
203	"""
204	state: NotRequired[str]	1✔
205	"""	1✔
206	[ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2:US), without country prefix. For example, "NY" for New York, United States.
207	"""
208	tax_type: NotRequired[	1✔
209	Literal[
210	"amusement_tax",
211	"communications_tax",
212	"gst",
213	"hst",
214	"igst",
215	"jct",
216	"lease_tax",
217	"pst",
218	"qst",
219	"rst",
220	"sales_tax",
221	"vat",
222	]
223	]
224	"""	1✔
225	The high-level tax type, such as `vat` or `sales_tax`.
226	"""
227
228	def list(	1✔
229	self,
230	invoice: str,
231	params: "InvoiceLineItemService.ListParams" = {},
232	options: RequestOptions = {},
233	) -> ListObject[InvoiceLineItem]:
234	"""
235	When retrieving an invoice, you'll get a lines property containing the total count of line items and the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
236	"""
UNCOV 237	return cast(	×
238	ListObject[InvoiceLineItem],
239	self._request(
240	"get",
241	"/v1/invoices/{invoice}/lines".format(
242	invoice=sanitize_id(invoice),
243	),
244	api_mode="V1",
245	base_address="api",
246	params=params,
247	options=options,
248	),
249	)
250
251	async def list_async(	1✔
252	self,
253	invoice: str,
254	params: "InvoiceLineItemService.ListParams" = {},
255	options: RequestOptions = {},
256	) -> ListObject[InvoiceLineItem]:
257	"""
258	When retrieving an invoice, you'll get a lines property containing the total count of line items and the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
259	"""
UNCOV 260	return cast(	×
261	ListObject[InvoiceLineItem],
262	await self._request_async(
263	"get",
264	"/v1/invoices/{invoice}/lines".format(
265	invoice=sanitize_id(invoice),
266	),
267	api_mode="V1",
268	base_address="api",
269	params=params,
270	options=options,
271	),
272	)
273
274	def update(	1✔
275	self,
276	invoice: str,
277	line_item_id: str,
278	params: "InvoiceLineItemService.UpdateParams" = {},
279	options: RequestOptions = {},
280	) -> InvoiceLineItem:
281	"""
282	Updates an invoice's line item. Some fields, such as tax_amounts, only live on the invoice line item,
283	so they can only be updated through this endpoint. Other fields, such as amount, live on both the invoice
284	item and the invoice line item, so updates on this endpoint will propagate to the invoice item as well.
285	Updating an invoice's line item is only possible before the invoice is finalized.
286	"""
UNCOV 287	return cast(	×
288	InvoiceLineItem,
289	self._request(
290	"post",
291	"/v1/invoices/{invoice}/lines/{line_item_id}".format(
292	invoice=sanitize_id(invoice),
293	line_item_id=sanitize_id(line_item_id),
294	),
295	api_mode="V1",
296	base_address="api",
297	params=params,
298	options=options,
299	),
300	)
301
302	async def update_async(	1✔
303	self,
304	invoice: str,
305	line_item_id: str,
306	params: "InvoiceLineItemService.UpdateParams" = {},
307	options: RequestOptions = {},
308	) -> InvoiceLineItem:
309	"""
310	Updates an invoice's line item. Some fields, such as tax_amounts, only live on the invoice line item,
311	so they can only be updated through this endpoint. Other fields, such as amount, live on both the invoice
312	item and the invoice line item, so updates on this endpoint will propagate to the invoice item as well.
313	Updating an invoice's line item is only possible before the invoice is finalized.
314	"""
UNCOV 315	return cast(	×
316	InvoiceLineItem,
317	await self._request_async(
318	"post",
319	"/v1/invoices/{invoice}/lines/{line_item_id}".format(
320	invoice=sanitize_id(invoice),
321	line_item_id=sanitize_id(line_item_id),
322	),
323	api_mode="V1",
324	base_address="api",
325	params=params,
326	options=options,
327	),
328	)

stripe / stripe-python / 9082745612

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous