Aif ddlmZddlmZddlmZddlmZddlm Z ddl m Z ddl m Z ddlmZmZdd lmZmZmZmZmZmZdd lmZmZmZerfdd lmZdd lmZdd l m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:ddl;mZ>e dGddedede dZ?y) )CreateableAPIResource)ExpandableField) ListObject)ListableAPIResource)nested_resource_class_methods) StripeObject)UpdateableAPIResource)class_method_variant sanitize_id)ClassVarDictListOptionalcastoverload)LiteralUnpack TYPE_CHECKING)CreditNoteLineItem)Customer)CustomerBalanceTransaction)Discount)Invoice)Refund) ShippingRate)TaxRate)CreditBalanceTransaction)CreditNoteCreateParams)CreditNoteListLinesParams)CreditNoteListParams)CreditNoteModifyParams)CreditNotePreviewLinesParams)CreditNotePreviewParams)CreditNoteRetrieveParams)CreditNoteVoidCreditNoteParamslineceZdZUdZdZeeded<GddeZ GddeZ Gdd eZ Gd d eZ Gd d eZ eed< eed< eed< eed< eded< eeded< eed< ee ed< eeed< eed< eded< eded< eed< eeed< eeeefed < eed!< eded"< eeed#< eed$< eed%< eed&< ee ed'< eed(ed)< ee ed*< ee ed+< ed,ed-< eed.< eeed/< eed0< eeed1< eee ed2< ed3ed4< eeed5< ed6ed7d8dfd9Zed6ed7d8dfd:Zed6ed;d8edfd<Zed6ed;d8edfd=Zeded6ed>d8dfd?Zeded6ed>d8dfd@Zed6edAd8dfdBZed6edAd8dfdCZed6edDd8edfdEZ ed6edDd8edfdFZ!eded6edGd8dfdHZ"eded6edGd8dfdIZ#eded6edJd8dfdKZ$e%e&ded6edJd8dfdLZ'e%d6edJd8dfdMZ'e(dNd6edJd8dfdOZ'eded6edJd8dfdPZ)e%e&ded6edJd8dfdQZ*e%d6edJd8dfdRZ*e(dSd6edJd8dfdTZ*eded6edUd8edfdVZ+eded6edUd8edfdWZ,e e e e e dXZ-yY)Z 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__rF/var/www/html/immo/lib/python3.12/site-packages/stripe/_credit_note.pyDiscountAmountr,<s  "*-- r5r7cZeZdZUeed< eeded< eeded< eded<y) CreditNote.PretaxCreditAmountr-rcredit_balance_transactionrr.)r:r.typeN)r/r0r1r2r3rrrr4r5r6PretaxCreditAmountr9FsS  %- 6 7%   ?:677 >?? r5r<cteZdZUGddeZeed< eeed< eded< ee ded< deiZ y ) CreditNote.Refundc$eZdZUeed< eed<y)%CreditNote.Refund.PaymentRecordRefundpayment_record refund_groupNr/r0r1strr3r4r5r6PaymentRecordRefundr@[s    r5rEamount_refundedpayment_record_refundRefundResourcerefund)rGrIr;N) r/r0r1rrEr2r3rrr_inner_class_typesr4r5r6rr>Zsg ,   ((;<<  011 w@ABB 67JKr5rceZdZUGddeZeed< eed< eed< eeded< ee eed< deiZ y ) CreditNote.ShippingCostcNeZdZUeed< ded< eeded< eeed<y)CreditNote.ShippingCost.Taxr-rrate)customer_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/r0r1r2r3rrr4r5r6TaxrNxsJK O  ("  & %SM ) r5raamount_subtotal amount_tax amount_totalr shipping_ratetaxesN) r/r0r1rrar2r3rrrrJr4r5r6 ShippingCostrLwsn$ ,$ L     ?@@ S "" &s^r5rgceZdZUGddeZeed< eded< eeed< eded< eeed < eded < deiZ y ) CreditNote.TotalTaxceZdZUeed<y)"CreditNote.TotalTax.TaxRateDetailstax_rateNrCr4r5r6TaxRateDetailsrksMr5rmr-) exclusive inclusive tax_behaviortax_rate_details)rP not_availablerQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r`r;N) r/r0r1rrmr2r3rrrJr4r5r6TotalTaxris \   677 #>22 #   $ ! % ()) 1.Ar5rsr-amount_shippingcreatedcurrencyrcustomerrcustomer_balance_transactiondiscount_amountdiscount_amounts effective_atidrinvoicerlineslivemodememometadatanumberobjectout_of_band_amountpdfpost_payment_amountpre_payment_amountpretax_credit_amounts) duplicate fraudulent order_changeproduct_unsatisfactoryreasonrefunds shipping_cost)issuedvoidstatussubtotalsubtotal_excluding_taxtotaltotal_excluding_tax total_taxes)mixed post_payment pre_paymentr; voided_atparamsrreturnc Ztd|jd|j|S) Issue a credit note to adjust the amount of a finalized invoice. A credit note will first reduce the invoice's amount_remaining (and amount_due), but not below zero. This amount is indicated by the credit note's pre_payment_amount. The excess amount is indicated by post_payment_amount, and it can result in any combination of the following: Refunds: create a new refund (using refund_amount) or link existing refunds (using refunds). 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). The sum of refunds, customer balance credits, and outside of Stripe credits must equal the post_payment_amount. You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount, post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation. r(postr)r_static_request class_urlclsrs r6createzCreditNote.createns6&         r5cvKtd|jd|j|d{S7w)rr(rrN)r_static_request_asyncrrs r6 create_asynczCreditNote.create_asyncsD& ++ ,    s ,97 9r c |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 TypeErrorr;r/rrresults r6listzCreditNote.lists]$$  MMO%  &*-7<((*   r5cK|jd|j|d{}t|ts!t dt |j z|S77w)rrrNr)rrrrrr;r/rs r6 list_asynczCreditNote.list_asyncsk00  MMO1   &*-7<((*    s&A"A 8A"r!c z|jdt|}td|jd||S)2 Updates an existing credit note. /r(rr)rr rrrr|rurls r6modifyzCreditNote.modifysD+b/:        r5cK|jdt|}td|jd||d{S7w)rrr(rrN)rr rrrs r6 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 r6previewzCreditNote.previews0    *    r5cZKtd|jdd|d{S7w)rr(rrrN)rrrs r6 preview_asynczCreditNote.preview_asyncs> ++*,    s +) +r"c 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 r6 preview_lineszCreditNote.preview_liness6 + ,   0    r5chKttd|jdd|d{S7w)rrrrrN)rrrrs r6preview_lines_asynczCreditNote.preview_lines_async sD + ,++0,    s %20 2r$c 8||fi|}|j|S)M Retrieves the credit note object with the given identifier. )refreshrr|rinstances r6retrievezCreditNote.retrieve0s$r$V$r5cTK||fi|}|jd{|S7w)rN) refresh_asyncrs r6retrieve_asynczCreditNote.retrieve_async;s3r$V$$$&&& 's (&(r%c ptd|jddjt||S) Marks a credit note as void. Learn more about [voiding credit notes](https://docs.stripe.com/docs/billing/invoices/credit-notes#voiding). r(r/v1/credit_notes/{id}/voidr|r)rrformatr rr|rs r6_cls_void_credit_notez CreditNote._cls_void_credit_noteFsB    ,33{23G    r5c yrNr4r|rs r6void_credit_notezCreditNote.void_credit_noteVs r5c yrr4selfrs r6rzCreditNote.void_credit_note`s r5rc td|jddjt|j d|S)rr(rrr|rr)r_requestrr rrs r6rzCreditNote.void_credit_noteisP  MM,33"488D>24    r5c Ktd|jddjt||d{S7w)rr(rrrrN)rrrr rs r6_cls_void_credit_note_asyncz&CreditNote._cls_void_credit_note_async{sP ++,33{23G,    s7AA Ac Kywrr4rs r6void_credit_note_asyncz!CreditNote.void_credit_note_asyncs  c Kywrr4rs r6rz!CreditNote.void_credit_note_asyncs  rrc Ktd|jddjt|j d|d{S7w)rr(rrr|rrN)r_request_asyncrr rrs r6rz!CreditNote.void_credit_note_asyncs` %%,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 r6 list_lineszCreditNote.list_linessP + ,   6== +K 8>    r5c Kttd|jddjt ||d{S7w)rrrrrrN)rrrrr rs r6list_lines_asynczCreditNote.list_lines_asyncs^ + ,++6== +K 8> ,    s>A A  A )rzrrrrN).r/r0r1__doc__r*r rr3rr7r<rrgrsr2rDrrrrboolr classmethodrrrrrrrrrrrrrrr staticmethodrr rrrrrJr4r5r6r(r(.s  5BK'-01A   \ (LL:;,|;,z-B<-B^ KLMj))#+45#>**3- GY '' * ++N 3-tCH~&& K M ""! % H 233  O   &\L)) $ %%M%SM) J"#&$x.)) 8 99} 67   6 67   645 L !&45 L !&  &'? @     &'? @     78        78        <=  ( )      <=  ( )     &'A B  &'A B     &'G H        !"BC    ?@   12 ?@  3 "    &'G H        !"BC    ?@   78 ?@  9 "  )/0K)L ( )  "  )/0K)L ( )  $+!3% r5r(N)@stripe._createable_api_resourcerstripe._expandable_fieldrstripe._list_objectrstripe._listable_api_resourcer%stripe._nested_resource_class_methodsrstripe._stripe_objectrstripe._updateable_api_resourcer stripe._utilr r typingr r rrrrtyping_extensionsrrrstripe._credit_note_line_itemrstripe._customerr$stripe._customer_balance_transactionrstripe._discountrstripe._invoicerstripe._refundrrHstripe._shipping_raterstripe._tax_rater*stripe.billing._credit_balance_transactionr(stripe.params._credit_note_create_paramsr,stripe.params._credit_note_list_lines_paramsr&stripe.params._credit_note_list_paramsr (stripe.params._credit_note_modify_paramsr!/stripe.params._credit_note_preview_lines_paramsr")stripe.params._credit_note_preview_paramsr#*stripe.params._credit_note_retrieve_paramsr$2stripe.params._credit_note_void_credit_note_paramsr%r(r4r5r6rsB4*=O.A:AA<<@)O)'72(PLO v&k ,' %,'k 'k r5