jofU |ddlmZddlmZddlmZddlmZddlm 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/e dGddedededZ0dS))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)TaxRatelinec eZdZUdZdZeeded<GddeZ GddeZ Gdd eZ Gd d e Z Gd d eZGddeZGddeZGdde ZGdde ZGddeZGdde ZGdde ZGddeZGddeZGd d!eZGd"d#e ZGd$d%eZGd&d'eZGd(d)eZGd*d+e ZGd,d-e Ze ed.< e ed/< e ed0< e!ed1< e"d2ed3< e#e"d4ed5< e ed6< e$e ed7< e#e ed8< e!ed9< e"d:ed;< e%d<ed=< e&ed>< e#e!ed?< e#e'e!e!fed@< e!edA< ededB< e#e edC< e!edD< e#edEedF< e#e"dGedH< e#e edI< edJedK< e edL< e#e edM< e$e edN< e edO< e#e edP< edQedR< e#e edS< e(dTe)dUdVdfdWZ*e(dTe)dUdVdfdXZ+e(dTe)dYdVe%dfdZZ,e(dTe)dYdVe%dfd[Z-e(d9e!dTe)d\dVdfd]Z.e(d9e!dTe)d\dVdfd^Z/e(dTe)d_dVdfd`Z0e(dTe)d_dVdfdaZ1e(dTe)dbdVe%d<fdcZ2e(dTe)dbdVe%d<fddZ3e(d9e!dTe)dedVdfdfZ4e(d9e!dTe)dedVdfdgZ5e(d9e!dTe)dhdVdfdiZ6e7e8d9e!dTe)dhdVdfdjZ9e7dTe)dhdVdfdkZ9e:dldTe)dhdVdfdmZ9e(d9e!dTe)dhdVdfdnZ;e7e8d9e!dTe)dhdVdfdoZe e e dvZ?dwS)x 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_NAMEc2eZdZUeed< eded<dS)CreditNote.DiscountAmountamountrdiscountN)__name__ __module__ __qualname__int__annotations__rM/var/www/html/Alfredo/env/lib/python3.11/site-packages/stripe/_credit_note.pyDiscountAmountr&.s7  "*----  r/r1ceZdZUGddeZeed< eed< eed< eeded< ee eed< deiZ d S) CreditNote.ShippingCostcbeZdZUeed< ded< eeded< eeed<dS)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.r/r0Taxr59sqKKK OOO  ("    & %SM ) ) )  r/rIamount_subtotal amount_tax amount_totalr shipping_ratetaxesN) r)r*r+r rIr,r-rrr_inner_class_typesr.r/r0 ShippingCostr38s$ $ $ $ $ ,$ $ $ L     ?@@@@ S """" &s^r/rPczeZdZUeed< eed< eded< eeded< eeed<dS) CreditNote.TaxAmountr' inclusivertax_rater7rGrHN) r)r*r+r,r-boolrrrr.r/r0 TaxAmountrRus   "),,,, $      & ! %%%  r/rVceZdZUeeed< eeed< eeed< eeded< eeeed< eed< eeded < eeed < ee eefed < eeed < eed ed< eeed< eeed< eded<dS)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.r/r0 CreateParamsrXsC     #3'''' "#&&&&  (= >???? DI&&&&   4 =>???? # d38n---- (,,,,  *      C     #3'''' ##HIIII  r/rqceZdZUeeed< eeed< eeed< eeed< eded< eded< ed ed < eeed < eeed <d S)r`r' descriptioninvoice_line_itemquantityz6Literal['']|List[CreditNote.CreateParamsLineTaxAmount] tax_amountsLiteral['']|List[str] tax_ratescustom_line_itemrttype unit_amountunit_amount_decimalNr)r*r+rr,r-rprr.r/r0CreateParamsLinezCreditNote.CreateParamsLinesC     !%%%% 's++++ c"""" ! D     67777 =>>>> !%%%% )----  r/rc2eZdZUeed< eed< eed<dS)$CreditNote.CreateParamsLineTaxAmountr'rTrHNr)r*r+r,r-rpr.r/r0CreateParamsLineTaxAmountrB      r/rc&eZdZUeeed<dS)rmrMNr)r*r+rrpr-r.r/r0CreateParamsShippingCostz#CreditNote.CreateParamsShippingCost'"3''''  r/rczeZdZUeeed< eeeed< eeed< eeed<dS)CreditNote.ListLinesParams ending_beforer^limitstarting_afterN)r)r*r+rrpr-rr,r.r/r0ListLinesParamsrss"3'''' DI&&&& 3 $C((((  r/rceZdZUeded< eeed< eeed< eeeed< eeed< eeed< eeed<d S) CreditNote.ListParamsz CreditNote.ListParamsCreated|intcreatedcustomerrr^r_rrN)r)r*r+rr-rprr,r.r/r0 ListParamsr,s?@@@@ c"""" #3'''' DI&&&& S!!!! 3 $C((((  r/rcneZdZUeeed< eeed< eeed< eeed<dS)CreditNote.ListParamsCreatedgtgteltlteN)r)r*r+rr,r-r.r/r0ListParamsCreatedrJso           r/rcreZdZUeeeed< eeed< eeeefed<dS)CreditNote.ModifyParamsr^rbrcN)r)r*r+rrrpr-rr.r/r0 ModifyParamsr\scDI&&&& # d38n----  r/rceZdZUeeed< eeed< eeed< eeded< eeed< eeeed< eed< eeed < eed ed < eeed < ee eefed < eeed< eeded< eeed< eeed< eded< eeed<dS)CreditNote.PreviewLinesParamsr'rYrZr[r]rr^r_r!CreditNote.PreviewLinesParamsLinerarbrcrdrerjrkrl)CreditNote.PreviewLinesParamsShippingCostrnrN) r)r*r+rr,r-rrprrr.r/r0PreviewLinesParamsrjsC     #3'''' "#&&&&  (= >???? #3'''' DI&&&&   3 4 CDEEEE # d38n---- (,,,,  *      C     #3'''' ##NOOOO $C((((  r/rceZdZUeeed< eeed< eeed< eeed< eded< eded< ed ed < eeed < eeed <d S)rr'rsrtruz>>> !%%%% )----  r/rc2eZdZUeed< eed< eed<dS)*CreditNote.PreviewLinesParamsLineTaxAmountr'rTrHNrr.r/r0PreviewLinesParamsLineTaxAmountrrr/rc&eZdZUeeed<dS)rrMNrr.r/r0PreviewLinesParamsShippingCostz)CreditNote.PreviewLinesParamsShippingCostrr/rceZdZUeeed< eeed< eeed< eeded< eeeed< eed< eeded < eeed < ee eefed < eeed < eed ed< eeed< eeed< eded<dS)CreditNote.PreviewParamsr'rYrZr[r]r^r_CreditNote.PreviewParamsLinerarbrcrdrerjrkrl$CreditNote.PreviewParamsShippingCostrnNror.r/r0 PreviewParamsrsC     #3'''' "#&&&&  (= >???? DI&&&&   4 >?@@@@ # d38n---- (,,,,  *      C     #3'''' ##IJJJJ  r/rceZdZUeeed< eeed< eeed< eeed< eded< eded< ed ed < eeed < eeed <d S)rr'rsrtruz7Literal['']|List[CreditNote.PreviewParamsLineTaxAmount]rvrwrxryr{r|r}Nr~r.r/r0PreviewParamsLinezCreditNote.PreviewParamsLine4sC     !%%%% 's++++ c"""" ! E     67777 =>>>> !%%%% )----  r/rc2eZdZUeed< eed< eed<dS)%CreditNote.PreviewParamsLineTaxAmountr'rTrHNrr.r/r0PreviewParamsLineTaxAmountr\rr/rc&eZdZUeeed<dS)rrMNrr.r/r0PreviewParamsShippingCostz$CreditNote.PreviewParamsShippingCostjrr/rc2eZdZUeeeed<dS)CreditNote.RetrieveParamsr^Nr)r*r+rrrpr-r.r/r0RetrieveParamsrp+DI&&&&  r/rc2eZdZUeeeed<dS)CreditNote.VoidCreditNoteParamsr^Nrr.r/r0VoidCreditNoteParamsrvrr/rr'amount_shippingrcurrencyrrrcustomer_balance_transactiondiscount_amountdiscount_amountsrZidrr_rralivemoderbrcnumberobjectrdpdfrerjrrkrn)issuedvoidstatussubtotalsubtotal_excluding_taxrvtotaltotal_excluding_tax) post_payment pre_paymentr{ voided_atparamsrXreturnc rtd|d||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 r0createzCreditNote.createsB(           r/cKtd|d||d{VS)rr"rrN)r_static_request_asyncrrs r0 create_asynczCreditNote.create_asyncsd( ++ ,         r/rc |d||}t|ts$t dt |jz|S)1 Returns a list of credit notes. getr%Expected list object from API, got %s)rr isinstancer TypeErrorr{r)rrresults r0listzCreditNote.list5sp$$  MMOO%   &*-- 7<<(*   r/cK|d||d{V}t|ts$t dt |jz|S)rrrNr)rrrrrr{r)rs r0 list_asynczCreditNote.list_asyncIs00  MMOO1         &*-- 7<<(*   r/rc |dt|}td|d||S)2 Updates an existing credit note. /r"rr)rr rrrrrurls r0modifyzCreditNote.modify]sX+b///:          r/cK|dt|}td|d||d{VS)rrr"rrN)rr rrrs r0 modify_asynczCreditNote.modify_asyncnsz+b///: ++,         r/rc Ntd|dd|S)E Get a preview of a credit note without creating it. r"r/v1/credit_notes/previewr)rrrs r0previewzCreditNote.previews:    *      r/c^Ktd|dd|d{VS)rr"rrrN)rrrs r0 preview_asynczCreditNote.preview_asyncs\ ++*,         r/rc dttd|dd|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 r0 preview_lineszCreditNote.preview_liness@ + ,   0      r/ctKttd|dd|d{VS)rrrrrN)rrrrs r0preview_lines_asynczCreditNote.preview_lines_asyncsb + ,++0,         r/rc @||fi|}||S)M Retrieves the credit note object with the given identifier. )refreshrrrinstances r0retrievezCreditNote.retrieves23r$$V$$r/cPK||fi|}|d{V|S)rN) refresh_asyncrs r0retrieve_asynczCreditNote.retrieve_asyncsH3r$$V$$$$&&&&&&&&&r/rc td|ddt||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 r0_cls_void_credit_notez CreditNote._cls_void_credit_notesQ    ,33{23GG      r/c dSr Nr.rrs r0void_credit_notezCreditNote.void_credit_notes  r/c dSrr.selfrs r0rzCreditNote.void_credit_notes  r/rc td|ddt|d|S)r r"rr rr r)r_requestr r rrs r0rzCreditNote.void_credit_notesd  MM,33"488D>>224      r/c Ktd|ddt||d{VS)r r"rr r rN)rrr r r s r0_cls_void_credit_note_asyncz&CreditNote._cls_void_credit_note_async ss ++,33{23GG,         r/c KdSrr.rs r0void_credit_note_asyncz!CreditNote.void_credit_note_asyncs  r/c KdSrr.rs r0rz!CreditNote.void_credit_note_async$s  r/rc Ktd|ddt|d|d{VS)r r"rr rr rN)r_request_asyncr r rrs r0rz!CreditNote.void_credit_note_async-s %%,33"488D>>224 &         r/rc ttd|ddt ||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)rrrr r rr#rs r0 list_lineszCreditNote.list_lines?sb + ,   6== +K 8 8>      r/c Kttd|ddt ||d{VS)r rrr!r"rN)rrrr r r#s r0list_lines_asynczCreditNote.list_lines_asyncQs + ,++6== +K 8 8> ,         r/)rrnrvN)@r)r*r+__doc__r$r rr-r r1rPrVrrqrrrrrrrrrrrrrrrrrrr,rprrrrrUr classmethodrrrrrrrrrrrrrrr staticmethodrr rrr$r&rOr.r/r0r"r" s  5BK'-01AAA        ;,;,;,;,;,|;,;,;,z& & & & & L& & & P? ? ? ? ? ~? ? ? B& & & & & 9& & & P      I         9        .   $     ^   <     I   $      ~    K K K K K ^K K K Z& & & & & & & & P      )            ? ? ? ? ? ? ? ? B& & & & & I& & & P      Y         I                ~   KKKLLLMMMj))))#+45#>****3- GGGY '''' * ++++NNN 3-tCH~&&&& KKK M """"! %%% HHH  O    _X. ////L)))) $ %%%%MMM%SM)))i    JJJ"#&&& / 0000} 78    [ 8 78    [ 856 L ![&56 L ![&  &'@ A    [   &'@ A    [   89      [    89      [    =>  ( )    [    =>  ( )    [   &'B C [ &'B C [    &'H I      [    !"CD    \X  @A    X 122 @A    32 "    &'H I      [    !"CD    \X  @A    X 788 @A    98 "  )/0L)M ( )   [ "  )/0L)M ( )   [ $+% r/r"N)1stripe._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_raterr"r.r/r0r=s,BAAAAA444444******======OOOOOO222222......AAAAAA::::::::AAAAAAAAAAAAAAAA)@@@@@@))))))OOOOOO))))))''''''%%%%%%222222((((((v&&FFFFF,' %,'FF'&FFFr/