<@gE bddlmZddlmZddlmZddlmZddlm Z ddl m Z ddl m Z ddlmZdd lmZmZdd lmZmZmZmZmZmZdd lmZmZmZmZmZer6dd 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/ddl0m1Z1e dGddedededZ2y))CreateableAPIResource)ExpandableField) ListObject)ListableAPIResource)nested_resource_class_methods)RequestOptions) StripeObject)UpdateableAPIResource)class_method_variant sanitize_id)ClassVarDictListOptionalcastoverload)Literal NotRequired TypedDictUnpack TYPE_CHECKING)CreditNoteLineItem)Customer)CustomerBalanceTransaction)Discount)Invoice)Refund) ShippingRate)TaxRate)CreditBalanceTransactionlinecdeZdZUdZdZeeded<GddeZ GddeZ Gdd eZ Gd d eZ Gd d e ZGddeZGddeZGddeZGdde ZGdde ZGddeZGdde ZGdde ZGddeZGd d!eZGd"d#eZGd$d%e ZGd&d'eZGd(d)eZGd*d+eZGd,d-e ZGd.d/e Z e!ed0< e!ed1< e!ed2< e"ed3< e#d4ed5< e$e#d6ed7< e!ed8< e%e ed9< e$e!ed:< e"ed;< e#d<ed=< e&d>ed?< e'ed@< e$e"edA< e$e(e"e"fedB< e"edC< ededD< e$e!edE< e"edF< e$e%e edG< e$edHedI< e$e#dJedK< e$e edL< edMedN< e!edO< e$e!edP< e%e edQ< e!edR< e$e!edS< edTedU< e$e!edV< e)dWe*dXdYdfdZZ+e)dWe*dXdYdfd[Z,e)dWe*d\dYe&dfd]Z-e)dWe*d\dYe&dfd^Z.e)d;e"dWe*d_dYdfd`Z/e)d;e"dWe*d_dYdfdaZ0e)dWe*dbdYdfdcZ1e)dWe*dbdYdfddZ2e)dWe*dedYe&d>fdfZ3e)dWe*dedYe&d>fdgZ4e)d;e"dWe*dhdYdfdiZ5e)d;e"dWe*dhdYdfdjZ6e)d;e"dWe*dkdYdfdlZ7e8e9d;e"dWe*dkdYdfdmZ:e8dWe*dkdYdfdnZ:e;dodWe*dkdYdfdpZ:e)d;e"dWe*dkdYdfdqZfdwZ>e)de"dWe*dvdYe&d>fdxZ?e e e e dyZ@yz){ CreditNotez Issue a credit note to adjust an invoice's amount after the invoice is finalized. Related guide: [Credit notes](https://stripe.com/docs/billing/invoices/credit-notes) credit_note OBJECT_NAMEc*eZdZUeed< eded<y)CreditNote.DiscountAmountamountrdiscountN)__name__ __module__ __qualname__int__annotations__rR/var/www/html/AdoubleTech/venv/lib/python3.12/site-packages/stripe/_credit_note.pyDiscountAmountr'1s  "*-- r0r2cZeZdZUeed< eeded< eeded< eded<y) CreditNote.PretaxCreditAmountr(r credit_balance_transactionrr))r5r)typeN)r*r+r,r-r.rrrr/r0r1PretaxCreditAmountr4;sS  %- 6 7%   ?:677 >?? r0r7ceZdZUGddeZeed< eed< eed< eeded< ee eed< deiZ y ) CreditNote.ShippingCostcNeZdZUeed< ded< eeded< eeed<y)CreditNote.ShippingCost.Taxr(rratecustomer_exemptnot_collectingnot_subject_to_tax not_supportedportion_product_exemptportion_reduced_ratedportion_standard_ratedproduct_exemptproduct_exempt_holidayproportionally_rated reduced_ratedreverse_chargestandard_ratedtaxable_basis_reduced zero_ratedtaxability_reasontaxable_amountN)r*r+r,r-r.rrr/r0r1Taxr;PsJK O  ("  & %SM ) r0rOamount_subtotal amount_tax amount_totalr shipping_ratetaxesN) r*r+r,r rOr-r.rrr_inner_class_typesr/r0r1 ShippingCostr9Osn$ ,$ L     ?@@ S "" &s^r0rVc`eZdZUeed< eed< eded< eeded< eeed<y) CreditNote.TaxAmountr( inclusivertax_rater=rMrNN) r*r+r,r-r.boolrrrr/r0r1 TaxAmountrXs\   "),, $    & ! % r0r\c$eZdZUeeed< eeed< eeed< eeded< eeeed< eed< eeded < eeed < ee eefed < eeed < eed ed< eeed< eeed< eded<y)CreditNote.CreateParamsr( credit_amount effective_atr$none email_typeexpandinvoiceCreditNote.CreateParamsLinelinesmemometadataout_of_band_amount duplicate fraudulent order_changeproduct_unsatisfactoryreasonrefund refund_amount#CreditNote.CreateParamsShippingCost shipping_costN r*r+r,rr-r.rrstrrr/r0r1 CreateParamsr^sC   #3'' "#&&  (= >?? DI&&   4 =>?? # d38n-- (,,  *    C   #3'' ##HII r0rwceZdZUeeed< eeed< eeed< eeed< eded< eded< ed ed < eeed < eeed <y )rfr( descriptioninvoice_line_itemquantityz6Literal['']|List[CreditNote.CreateParamsLineTaxAmount] tax_amountsLiteral['']|List[str] tax_ratescustom_line_itemrzr6 unit_amountunit_amount_decimalNr*r+r,rr-r.rvrr/r0r1CreateParamsLinezCreditNote.CreateParamsLinesC   !%% 's++ c"" ! D   677 =>> !%% )-- r0rc0eZdZUeed< eed< eed<y)$CreditNote.CreateParamsLineTaxAmountr(rZrNNr*r+r,r-r.rvr/r0r1CreateParamsLineTaxAmountr%     r0rceZdZUeeed<y)rsrSNr*r+r,rrvr.r/r0r1CreateParamsShippingCostz#CreditNote.CreateParamsShippingCost+"3'' r0rcZeZdZUeeed< eeeed< eeed< eeed<y)CreditNote.ListLinesParams ending_beforerdlimitstarting_afterN)r*r+r,rrvr.rr-r/r0r1ListLinesParamsr1sL"3'' DI&& 3 $C(( r0rceZdZUeded< eeed< eeed< eeeed< eeed< eeed< eeed<y ) CreditNote.ListParamsz CreditNote.ListParamsCreated|intcreatedcustomerrrdrerrN)r*r+r,rr.rvrr-r/r0r1 ListParamsrCs?@@ c"" #3'' DI&& S!! 3 $C(( r0rcTeZdZUeeed< eeed< eeed< eeed<y)CreditNote.ListParamsCreatedgtgteltlteN)r*r+r,rr-r.r/r0r1ListParamsCreatedrasH          r0rcReZdZUeeeed< eeed< eeeefed<y)CreditNote.ModifyParamsrdrhriN)r*r+r,rrrvr.rr/r0r1 ModifyParamsrssBDI&& # d38n-- r0rcZeZdZUeeed< eeed< eeed< eeded< eeed< eeeed< eed< eeed < eed ed < eeed < ee eefed < eeed< eeded< eeed< eeed< eded< eeed<y)CreditNote.PreviewLinesParamsr(r_r`rarcrrdrer!CreditNote.PreviewLinesParamsLinergrhrirjrkrprqrr)CreditNote.PreviewLinesParamsShippingCostrtrN) r*r+r,rr-r.rrvrrr/r0r1PreviewLinesParamsrsTC   #3'' "#&&  (= >?? #3'' DI&&   3 4 CDEE # d38n-- (,,  *    C   #3'' ##NOO $C(( r0rceZdZUeeed< eeed< eeed< eeed< eded< eded< ed ed < eeed < eeed <y )rr(ryrzr{z> !%% )-- r0rc0eZdZUeed< eed< eed<y)*CreditNote.PreviewLinesParamsLineTaxAmountr(rZrNNrr/r0r1PreviewLinesParamsLineTaxAmountrrr0rceZdZUeeed<y)rrSNrr/r0r1PreviewLinesParamsShippingCostz)CreditNote.PreviewLinesParamsShippingCostrr0rc$eZdZUeeed< eeed< eeed< eeded< eeeed< eed< eeded < eeed < ee eefed < eeed < eed ed< eeed< eeed< eded<y)CreditNote.PreviewParamsr(r_r`rarcrdreCreditNote.PreviewParamsLinergrhrirjrkrprqrr$CreditNote.PreviewParamsShippingCostrtNrur/r0r1 PreviewParamsr sC   #3'' "#&&  (= >?? DI&&   4 >?@@ # d38n-- (,,  *    C   #3'' ##IJJ r0rceZdZUeeed< eeed< eeed< eeed< eded< eded< ed ed < eeed < eeed <y )rr(ryrzr{z7Literal['']|List[CreditNote.PreviewParamsLineTaxAmount]r|r}r~rr6rrNrr/r0r1PreviewParamsLinezCreditNote.PreviewParamsLineKsC   !%% 's++ c"" ! E   677 =>> !%% )-- r0rc0eZdZUeed< eed< eed<y)%CreditNote.PreviewParamsLineTaxAmountr(rZrNNrr/r0r1PreviewParamsLineTaxAmountrsrr0rceZdZUeeed<y)rrSNrr/r0r1PreviewParamsShippingCostz$CreditNote.PreviewParamsShippingCostrr0rc$eZdZUeeeed<y)CreditNote.RetrieveParamsrdNr*r+r,rrrvr.r/r0r1RetrieveParamsrDI&& r0rc$eZdZUeeeed<y)CreditNote.VoidCreditNoteParamsrdNrr/r0r1VoidCreditNoteParamsrrr0rr(amount_shippingrcurrencyrrrcustomer_balance_transactiondiscount_amountdiscount_amountsr`idrrerrglivemoderhrinumberobjectrjpdfpretax_credit_amountsrkrprrqrt)issuedvoidstatussubtotalsubtotal_excluding_taxr|totaltotal_excluding_tax) post_payment pre_paymentr6 voided_atparamsr^returnc Ztd|jd|j|S)+ Issue a credit note to adjust the amount of a finalized invoice. For a status=open invoice, a credit note reduces its amount_due. For a status=paid invoice, a credit note does not affect its amount_due. Instead, it can result in any combination of the following: Refund: create a new refund (using refund_amount) or link an existing refund (using refund). Customer balance credit: credit the customer's balance (using credit_amount) which will be automatically applied to their next invoice when it's finalized. Outside of Stripe credit: record the amount that is or will be credited outside of Stripe (using out_of_band_amount). For post-payment credit notes the sum of the refund, credit and outside of Stripe amounts must equal the credit note total. You may issue multiple credit notes for an invoice. Each credit note will increment the invoice's pre_payment_credit_notes_amount or post_payment_credit_notes_amount depending on its status at the time of credit note creation. r#postr)r_static_request class_urlclsrs r1createzCreditNote.creates6(         r0cvKtd|jd|j|d{S7w)rr#rrN)r_static_request_asyncrrs r1 create_asynczCreditNote.create_async3sD( ++ ,    s ,97 9rc |jd|j|}t|ts!t dt |j z|S)1 Returns a list of credit notes. getr%Expected list object from API, got %s)rr isinstancer TypeErrorr6r*rrresults r1listzCreditNote.listPs]$$  MMO%  &*-7<((*   r0cK|jd|j|d{}t|ts!t dt |j z|S77w)rrrNr)rrrrrr6r*rs r1 list_asynczCreditNote.list_asyncdsk00  MMO1   &*-7<((*    s&A"A 8A"rc z|jdt|}td|jd||S)2 Updates an existing credit note. /r#rr)rr rrrrrurls r1modifyzCreditNote.modifyxsD+b/:        r0cK|jdt|}td|jd||d{S7w)rrr#rrN)rr rrrs r1 modify_asynczCreditNote.modify_asyncsR+b/: ++,    std|jdd|S)E Get a preview of a credit note without creating it. r#r/v1/credit_notes/previewr)rrrs r1previewzCreditNote.previews0    *    r0cZKtd|jdd|d{S7w)rr#rrrN)rrrs r1 preview_asynczCreditNote.preview_asyncs> ++*,    s +) +rc Lttd|jdd|S) When retrieving a credit note preview, you'll get a lines property containing the first handful of those items. This URL you can retrieve the full (paginated) list of line items. rr/v1/credit_notes/preview/linesr)rrrrs r1 preview_lineszCreditNote.preview_liness6 + ,   0    r0chKttd|jdd|d{S7w)rrrrrN)rrrrs r1preview_lines_asynczCreditNote.preview_lines_asyncsD + ,++0,    s %20 2rc 8||fi|}|j|S)M Retrieves the credit note object with the given identifier. )refreshrrrinstances r1retrievezCreditNote.retrieves$r$V$r0cTK||fi|}|jd{|S7w)rN) refresh_asyncrs r1retrieve_asynczCreditNote.retrieve_asyncs3r$V$$$&&& 's (&(rc ptd|jddjt||S) Marks a credit note as void. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding). r#r/v1/credit_notes/{id}/voidrr)rrformatr rrrs r1_cls_void_credit_notez CreditNote._cls_void_credit_notesB    ,33{23G    r0c yrNr/rrs r1void_credit_notezCreditNote.void_credit_notes r0c yrr/selfrs r1rzCreditNote.void_credit_note s r0rc td|jddjt|j d|S)rr#rrrrr)r_requestrr rrs r1rzCreditNote.void_credit_notesP  MM,33"488D>24    r0c Ktd|jddjt||d{S7w)rr#rrrrN)rrrr rs r1_cls_void_credit_note_asyncz&CreditNote._cls_void_credit_note_async%sP ++,33{23G,    s7AA Ac Kywrr/rs r1void_credit_note_asyncz!CreditNote.void_credit_note_async5s  c Kywrr/rs r1r!z!CreditNote.void_credit_note_async?s  r"rc Ktd|jddjt|j d|d{S7w)rr#rrrrrN)r_request_asyncrr rrs r1r!z!CreditNote.void_credit_note_asyncHs` %%,33"488D>24 &    sAAA Arc ~ttd|jddjt ||S) When retrieving a credit note, you'll get a lines property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items. rr$/v1/credit_notes/{credit_note}/linesr$r)rrrrr rr$rs r1 list_lineszCreditNote.list_linesZsP + ,   6== +K 8>    r0c Kttd|jddjt ||d{S7w)r'rrr(r)rN)rrrrr r*s r1list_lines_asynczCreditNote.list_lines_asyncls^ + ,++6== +K 8> ,    s>A A  A )rrrtr|N)Ar*r+r,__doc__r%r rr.r r2r7rVr\rrwrrrrrrrrrrrrrrrrrrr-rvrrrrr[r classmethodrrrrrrrrrrrr r rr staticmethodrr rr!r+r-rUr/r0r1r#r##s  5BK'-01A   \ (;,|;,z& L& P? ~? B& 9& P  I   9  . $ ^ < I $  ~  K ^K Z& & P  )    ? ? B& I& P  Y   I    ~ KLMj))#+45#>**3- GY '' * ++N 3-tCH~&& K M ""! % H$D);$<==  O    _X. //L)) $ %%M%SM)i  J"#& / 00} 78   8 78   856 L !&56 L !&  &'@ A     &'@ A     89        89        =>  ( )      =>  ( )     &'B C  &'B C     &'H I        !"CD    @A   12 @A  3 "    &'H I        !"CD    @A   78 @A  9 "  )/0L)M ( )  "  )/0L)M ( )  $+!3% r0r#N)3stripe._createable_api_resourcerstripe._expandable_fieldrstripe._list_objectrstripe._listable_api_resourcer%stripe._nested_resource_class_methodsrstripe._request_optionsrstripe._stripe_objectr stripe._updateable_api_resourcer stripe._utilr r typingr rrrrrtyping_extensionsrrrrrstripe._credit_note_line_itemrstripe._customerr$stripe._customer_balance_transactionrstripe._discountrstripe._invoicerstripe._refundrstripe._shipping_raterstripe._tax_rater*stripe.billing._credit_balance_transactionr r#r/r0r1rEsB4*=O2.A:AA@)O)'%2( v&_,' %,'_'_r0