+h RddlmZddlmZmZmZmZddlmZddl m Z ddl m Z ddl mZddlmZddlmZmZmZmZmZmZdd lmZmZmZmZmZdd lmZer0dd l m!Z!dd l"m#Z#dd l$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/edGddedededZ0y))util)CreateableAPIResourceListableAPIResourceUpdateableAPIResourcenested_resource_class_methods)ExpandableField) ListObject)RequestOptions) StripeObject)class_method_variant)ClassVarDictListOptionalcastoverload)Literal NotRequired TypedDictUnpack TYPE_CHECKING) quote_plus)CreditNoteLineItem)Customer)CustomerBalanceTransaction)Discount)Invoice)Refund) ShippingRate)TaxRatelinecveZdZUdZdZeeded<GddeZ GddeZ Gdd eZ e rGd d e ZGd d eZGddeZGdde ZGdde ZGdde ZGddeZGddeZGdde ZGddeZGddeZGd d!e ZGd"d#e ZGd$d%e Zeed&< eed'< eed(< eed)< ed*ed+< e ed,ed-< eed.< e!e ed/< e eed0< eed1< ed2ed3< e"d4ed5< e#ed6< e eed7< e e$eefed8< eed9< eded:< e eed;< eed<< e ed=ed>< e ed?ed@< e e edA< edBedC< eedD< e eedE< e!e edF< eedG< e eedH< edIedJ< e eedK< e% dhdMe edNe edOe edPe edQe&dRdSdf dTZ'e% didMe edOe edPe edQe&dUdSe"df dVZ(e%d1edQe&dWdSdfdXZ)e% didMe edOe edPe edQe&dYdSdf dZZ*e% didMe edOe edPe edQe&d[dSe"d4f d\Z+e%d1edQe&d]dSdfd^Z,e% did1edMe edOe edPe edQe&d_dSdf d`Z-e.e/ did1edMe edOe edPe edQe&d_dSdf daZ0e. djdNe edQe&d_dSdfdbZ0e1dc djdNe edQe&d_dSdfddZ0e% didedMe edOe edPe edQe&dedSe"d4f dfZ2e e e dgZ3yL)k 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__rS/var/www/html/venv/lib/python3.12/site-packages/stripe/api_resources/credit_note.pyDiscountAmountr'4s  "*-- r0r2ceZdZUGddeZeed< eed< eed< eeded< ee eed< deiZ y ) CreditNote.ShippingCostcNeZdZUeed< ded< eeded< eeed<y)CreditNote.ShippingCost.Taxr(r ratecustomer_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/r0r1Taxr6?sJK O  ("  & %SM ) r0rJamount_subtotal amount_tax amount_totalr shipping_ratetaxesN) r*r+r,r rJr-r.rrr_inner_class_typesr/r0r1 ShippingCostr4>sn$ ,$ L     ?@@ S "" &s^r0rQc`eZdZUeed< eed< eded< eeded< eeed<y) CreditNote.TaxAmountr( inclusiver tax_rater8rHrIN) r*r+r,r-r.boolrrrr/r0r1 TaxAmountrS{s\   "),, $    & ! % r0rWceZdZUeded< eded< eded< eded< eed< eded < ed ed < ed ed < eded< eded< ed ed< eded< eded<y)CreditNote.CreateParamsr-r( credit_amount effective_at List[str]expandinvoicez!List[CreditNote.CreateParamsLine]linesstrmemoDict[str, str]metadataout_of_band_amountLLiteral['duplicate', 'fraudulent', 'order_change', 'product_unsatisfactory']reasonrefund refund_amount#CreditNote.CreateParamsShippingCost shipping_costNr*r+r,rr.r`r/r0r1 CreateParamsrYs& & 'u- - &e, ,  , , L BC C e$ $ ""23 3 !,E 2 2  ^   & & 'u- - ''LM M r0rlceZdZUeded<y)rir`rNNr*r+r,rr.r/r0r1CreateParamsShippingCostz#CreditNote.CreateParamsShippingCost&u- - r0roceZdZUeded< eded< eded< eded< eded< ed ed < eded < eded <y )CreditNote.CreateParamsLiner-r(r` descriptioninvoice_line_itemquantityLiteral['']|List[str] tax_ratescustom_line_itemrttype unit_amountunit_amount_decimalNr*r+r,rr.rr/r0r1CreateParamsLinerr& & %U+ +  +51 1 "%( ( ##:; ; AB B %U+ + "-U!3 3 r0r~cxeZdZUeded< eded< eded< eded< eded< eded <y ) CreditNote.ListParamsr`customer ending_beforer\r]r^r-limitstarting_afterNrnr/r0r1 ListParamsrsl!%( ( 'u- -  , , !' ' u% % (. . r0rcBeZdZUeded< eded< eded<y)CreditNote.ModifyParamsr\r]r`rarbrcNrnr/r0r1 ModifyParamsrs7 , , e$ $ ""23 3 r0rceZdZUeded< eded< eded< eded< eed< eded < ed ed < ed ed < eded< eded< ed ed< eded< eded<y)CreditNote.PreviewParamsr-r(rZr[r\r]r^z"List[CreditNote.PreviewParamsLine]r_r`rarbrcrdrerfrgrh$CreditNote.PreviewParamsShippingCostrjNrkr/r0r1 PreviewParamsr-s& & 'u- - &e, ,  , , L CD D e$ $ ""23 3 !,E 2 2  ^   & & 'u- - ''MN N r0rceZdZUeded<y)rr`rNNrnr/r0r1PreviewParamsShippingCostz$CreditNote.PreviewParamsShippingCosterpr0rceZdZUeded< eded< eded< eded< eded< ed ed < eded < eded <y )CreditNote.PreviewParamsLiner-r(r`rsrtrurvrwrxrzr{r|Nr}r/r0r1PreviewParamsLinerkrr0rc&eZdZUeded< eded< eded< eded< eded< eed < eded < ed ed < eded < eded< eded< eded< eded< eded< eded< eded<y)CreditNote.PreviewLinesParamsr-r(rZr[r`rr\r]r^rz'List[CreditNote.PreviewLinesParamsLine]r_rarbrcrdrerfrgrh)CreditNote.PreviewLinesParamsShippingCostrjrNrkr/r0r1PreviewLinesParamsrs&& & 'u- - &e, , 'u- -  , , L u% % HI I e$ $ ""23 3 !,E 2 2  ^   & & 'u- - ';  (. . r0rceZdZUeded<y)rr`rNNrnr/r0r1PreviewLinesParamsShippingCostz)CreditNote.PreviewLinesParamsShippingCostrpr0rceZdZUeded< eded< eded< eded< eded< ed ed < eded < eded <y )!CreditNote.PreviewLinesParamsLiner-r(r`rsrtrurvrwrxrzr{r|Nr}r/r0r1PreviewLinesParamsLinerrr0rceZdZUeded<y)CreditNote.RetrieveParamsr\r]Nrnr/r0r1RetrieveParamsr , , r0rceZdZUeded<y)CreditNote.VoidCreditNoteParamsr\r]Nrnr/r0r1VoidCreditNoteParamsrrr0rcTeZdZUeded< eded< eded< eded<y) CreditNote.ListLinesParamsr`rr\r]r-rrNrnr/r0r1ListLinesParamsrsH&u- -  , , u% % (. . r0rr(amount_shippingcreatedcurrencyrrrcustomer_balance_transactiondiscount_amountdiscount_amountsr[idrr^rr_livemoderarcnumberobjectrdpdf) duplicate fraudulent order_changeproduct_unsatisfactoryrfrrgrj)issuedvoidstatussubtotalsubtotal_excluding_tax tax_amountstotaltotal_excluding_tax) post_payment pre_paymentrz voided_atNapi_keyidempotency_keystripe_versionstripe_accountparamsrYreturnc `td|jd|j|||||S)a+ 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#post)r_static_request class_url)clsrrrrrs r1createzCreditNote.creates=2        r0rc |jd|j||||}t|ts!t dt |j z|S)z1 Returns a list of credit notes. getrrrrz%Expected list object from API, got %s)rr isinstancer TypeErrorrzr*)rrrrrresults r1listzCreditNote.listsf$$  MMO)) % &*-7<((*   r0rc z|jdt|}td|jd||S)z2 Updates an existing credit note. /r#r)r)rrrr)rrrurls r1modifyzCreditNote.modifys=*R.9    F  ;  r0rc Dtd|jdd||||S)zE Get a preview of a credit note without creating it. r#rz/v1/credit_notes/previewr)rrrrrrrs r1previewzCreditNote.previews9    *--    r0rc Rttd|jdd||||S)z 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. rrz/v1/credit_notes/preview/linesr)rr rrs r1 preview_lineszCreditNote.preview_liness? + ,   0--    r0rc 8||fi|}|j|S)zM Retrieves the credit note object with the given identifier. )refresh)rrrinstances r1retrievezCreditNote.retrieves$r$V$r0rc td|jddjtj|||||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 sanitize_id)rrrrrrs r1_cls_void_credit_notez CreditNote._cls_void_credit_note sR    ,33t7G7G7K3L--    r0c yrNr/)rrrrrs r1void_credit_notezCreditNote.void_credit_note8s r0c yrr/selfrrs r1rzCreditNote.void_credit_noteFs r0rc td|jddjtj|j d||S)rr#rrrr)rr)r_requestrrrrrs r1rzCreditNote.void_credit_noteQsY  MM,33''74!0    r0rc ttd|jddjt j |||||S)z When retrieving a credit note, you'll get a lines property containing the the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items. rrz$/v1/credit_notes/{credit_note}/lines)r$r)rr rrrr)rr$rrrrs r1 list_lineszCreditNote.list_linesfs_ + ,   6== $ 0 0 => --   r0)rrjr)NNNN)NNN)N)4r*r+r,__doc__r%r rr.r r2rQrWrr rlrror~rrrrrrrrrrrr-r`rrrr rVr classmethodrrrrrrrrr staticmethodrr rrPr/r0r1r#r#&s  5BK'-01A  ;,|;,z& L& P6 >6 p y  y D  4 > 6 N6 p     DD D L Y  Y D ^   >   n $ KLMj))#+45#>**3- GY '' * ++N 3-tCH~&& K M ""! % H  O    _X. //L)) $ %%M%SM)i  J"#& / 00}"&)-(,(, # ## "## ! # ! # 23 #  # # J"&(,(, #! !  01  L ! 6    &'@ A      "&(,(,  # !  !  34     ,"&(,(,  # !  !  89  ( )   , &'B C "&(,(,   # !  !  :;     ."&(,(,    #  !   !  :;      *. !# :;     12*. !# :;    3 ("&(,(,   # !  !  56   ( )  4+% r0r#N)1striperstripe.api_resources.abstractrrrr%stripe.api_resources.expandable_fieldr stripe.api_resources.list_objectr stripe.request_optionsr stripe.stripe_objectr stripe.utilr typingr rrrrrtyping_extensionsrrrrr urllib.parser*stripe.api_resources.credit_note_line_itemrstripe.api_resources.customerr1stripe.api_resources.customer_balance_transactionrstripe.api_resources.discountrstripe.api_resources.invoicerstripe.api_resources.refundr"stripe.api_resources.shipping_raterstripe.api_resources.tax_rater r#r/r0r1rs B71-,AA$M6742?5v&] ,' %,'] '] r0