<@gu HddlmZddlmZddlmZddlmZddlm Z ddl m Z ddl m Z ddlmZdd lmZmZdd lmZmZmZmZmZmZdd lmZmZmZmZmZer0dd l m!Z!dd l"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/Gddedede dedZ0y))CreateableAPIResource)DeletableAPIResource)ExpandableField) ListObject)ListableAPIResource)RequestOptions) StripeObject)UpdateableAPIResource)class_method_variant sanitize_id)ClassVarDictListOptionalcastoverload)Literal NotRequired TypedDictUnpack TYPE_CHECKING)Customer)Discount)Invoice)Plan)Price) Subscription)TaxRate) TestClockcVeZdZUdZdZeeded<GddeZ Gdde Z Gdd e Z Gd d e ZGd d e ZGdde ZGdde ZGdde ZGdde ZGdde ZGdde ZGdde ZGdde Zeed< eed< ed ed!< eed"< eeed#< eed$< eeed%ed&< eed'< eed(ed)< eed*< eeeefed+< eded,< e ed-<ed.ed/< ed0ed1< eed2< eed3< eed4ed5< eeed6< eed7ed8< eed9ed:< eeed;< eeed<< eed=ed>< ed?e d@dAdfdBZ!ed?e d@dAdfdCZ"edDed?e dEdAdfdFZ#e$e%dDed?e dEdAdfdGZ&e$d?e dEdAdfdHZ&e'dId?e dEdAdfdJZ&edDed?e dEdAdfdKZ(e$e%dDed?e dEdAdfdLZ)e$d?e dEdAdfdMZ)e'dNd?e dEdAdfdOZ)ed?e dPdAe*dfdQZ+ed?e dPdAe*dfdRZ,ed'ed?e dSdAdfdTZ-ed'ed?e dSdAdfdUZ.ed'ed?e dVdAdfdWZ/ed'ed?e dVdAdfdXZ0d-e iZ1yY)Z InvoiceItemak Invoice Items represent the component lines of an [invoice](https://stripe.com/docs/api/invoices). An invoice item is added to an invoice by creating or updating it with an `invoice` field, at which point it will be included as [an invoice line item](https://stripe.com/docs/api/invoices/line_item) within [invoice.lines](https://stripe.com/docs/api/invoices/object#invoice_object-lines). Invoice Items can be created before you are ready to actually send the invoice. This can be particularly useful when combined with a [subscription](https://stripe.com/docs/api/subscriptions). Sometimes you want to add a charge or credit to a customer, but actually charge or credit the customer's card only at the end of a regular billing cycle. This is useful for combining several charges (to minimize per-transaction fees), or for having Stripe tabulate your usage-based billing totals. Related guides: [Integrate with the Invoicing API](https://stripe.com/docs/invoicing/integration), [Subscription Invoices](https://stripe.com/docs/billing/invoices/subscription#adding-upcoming-invoice-items). invoiceitem OBJECT_NAMEc$eZdZUeed< eed<y)InvoiceItem.PeriodendstartN__name__ __module__ __qualname__int__annotations__S/var/www/html/AdoubleTech/venv/lib/python3.12/site-packages/stripe/_invoice_item.pyPeriodr%6    r/r1cneZdZUeeed< eeed< eed< eeed< eeed< eded< eeeed< eeed < ed ed < ed ed < eeed< eded< eeed< eeed< ee ded< eded< eeeed< eeed< eeed<y)InvoiceItem.CreateParamsamountcurrencycustomer description discountablez2Literal['']|List[InvoiceItem.CreateParamsDiscount] discountsexpandinvoiceLiteral['']|Dict[str, str]metadataInvoiceItem.CreateParamsPeriodperiodprice!InvoiceItem.CreateParamsPriceData price_dataquantity subscription exclusive inclusive unspecified tax_behaviorLiteral['']|strtax_code tax_rates unit_amountunit_amount_decimalN r)r*r+rr,r-strboolrrr.r/r0 CreateParamsr4@slC   c""   !%% "$''  @   DI&& S!! :;; <== 3  CDD c"" "#&& " ; <   /00 tCy)) !%% )-- r/rScBeZdZUeeed< eeed< eeed<y) InvoiceItem.CreateParamsDiscountcoupondiscountpromotion_codeNr)r*r+rrQr-r.r/r0CreateParamsDiscountrU6C   c"" $C(( r/rZc$eZdZUeed< eed<y)r?r&r'Nr(r.r/r0CreateParamsPeriodzInvoiceItem.CreateParamsPeriodr2r/r]c`eZdZUeed< eed< eeded< eeed< eeed<y)rBr6productrFrJrNrONr)r*r+rQr-rrr,r.r/r0CreateParamsPriceDataz!InvoiceItem.CreateParamsPriceDataY    " ; <   !%% )-- r/rac eZdZy)InvoiceItem.DeleteParamsN)r)r*r+r.r/r0 DeleteParamsrds r/receZdZUeded< eeed< eeed< eeeed< eeed< eeed< eeed< eeed <y ) InvoiceItem.ListParamsz!InvoiceItem.ListParamsCreated|intcreatedr7 ending_beforer;r<limitpendingstarting_afterN) r)r*r+rr-rQrr,rRr.r/r0 ListParamsrgs@AA c"" #3'' DI&& S!! 3 T"" $C(( r/rmcTeZdZUeeed< eeed< eeed< eeed<y)InvoiceItem.ListParamsCreatedgtgteltlteN)r)r*r+rr,r-r.r/r0ListParamsCreatedrosH          r/rtc&eZdZUeeed< eeed< eeed< eded< eeeed< eded< ed ed < eeed < ed ed < eeed< ee ded< eded< eded< eeed< eeed<y)InvoiceItem.ModifyParamsr5r8r9z2Literal['']|List[InvoiceItem.ModifyParamsDiscount]r:r;r=r>InvoiceItem.ModifyParamsPeriodr@rA!InvoiceItem.ModifyParamsPriceDatarCrDrFrJrKrLzLiteral['']|List[str]rMrNrONrPr.r/r0 ModifyParamsrvs'C   !%% "$''  @   DI&& :;; <== 3  CDD c"" " ; <   /00 677 !%% )-- r/rycBeZdZUeeed< eeed< eeed<y) InvoiceItem.ModifyParamsDiscountrVrWrXNrYr.r/r0ModifyParamsDiscountr{;r[r/r|c$eZdZUeed< eed<y)rwr&r'Nr(r.r/r0ModifyParamsPeriodzInvoiceItem.ModifyParamsPeriodIr2r/r~c`eZdZUeed< eed< eeded< eeed< eeed<y)rxr6r_rFrJrNrONr`r.r/r0ModifyParamsPriceDataz!InvoiceItem.ModifyParamsPriceDataSrbr/rc$eZdZUeeeed<y)InvoiceItem.RetrieveParamsr;N)r)r*r+rrrQr-r.r/r0RetrieveParamsrksDI&& r/rr5r6rr7dater8r9rr:idrr<livemoder>objectr@rplanrrA prorationrDrrEsubscription_itemrrMr test_clockrNrOTdeletedparamsr4returnc Ztd|jd|j|S) Creates an item to be added to a draft invoice (up to 250 items per invoice). If no invoice is specified, the item will be on the next invoice created for the customer specified. r!postr)r_static_request class_urlclsrs r0createzInvoiceItem.creates6         r/cvKtd|jd|j|d{S7w)rr!rrN)r_static_request_asyncrrs r0 create_asynczInvoiceItem.create_asyncsD ++ ,    s ,97 9sidrdc z|jdt|}td|jd||S) Deletes an invoice item, removing it from an invoice. Deleting invoice items is only possible when they're not attached to invoices, or if it's attached to a draft invoice. /r!deleterrr rrrrrurls r0 _cls_deletezInvoiceItem._cls_deletesE+c*:;        r/c yrNr.rrs r0rzInvoiceItem.deletes r/c yrr.selfrs r0rzInvoiceItem.delete s r/rc F|jd|j|S)rrr)_request_and_refresh instance_urlrs r0rzInvoiceItem.deletes.((     )  r/cK|jdt|}td|jd||d{S7w)rrr!rrNrr rrrs r0_cls_delete_asynczInvoiceItem._cls_delete_async sS+c*:; ++,    :;; }$Y((566#"#&gdm $$  89        89        !'(B!C     "#=>    9:   -(  9:    )    !'(B!C     "#=>    9:   -.  9:    /  67 M "&67 M "&  &'A B     &'A B    &'C D  &'C D #F+r/r!N)1stripe._createable_api_resourcerstripe._deletable_api_resourcerstripe._expandable_fieldrstripe._list_objectrstripe._listable_api_resourcerstripe._request_optionsrstripe._stripe_objectr stripe._updateable_api_resourcer stripe._utilr r typingr rrrrrtyping_extensionsrrrrrstripe._customerrstripe._discountrstripe._invoicer stripe._planr stripe._pricerstripe._subscriptionrstripe._tax_raterstripe.test_helpers._test_clockrr!r.r/r0rs|B?4*=2.A:AA))'!#1(9Q ,-(' &-( Q ,r/