_jYg 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?dS) )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< eeed< 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/< eeed0< eed1< eeed2< eee ed3< ed4ed5< eeed6< ed7ed8d9dfd:Zed7ed8d9dfd;Zed7ed<d9edfd=Zed7ed<d9edfd>Zeded7ed?d9dfd@Zeded7ed?d9dfdAZed7edBd9dfdCZed7edBd9dfdDZed7edEd9edfdFZ ed7edEd9edfdGZ!eded7edHd9dfdIZ"eded7edHd9dfdJZ#eded7edKd9dfdLZ$e%e&ded7edKd9dfdMZ'e%d7edKd9dfdNZ'e(dOd7edKd9dfdPZ'eded7edKd9dfdQZ)e%e&ded7edKd9dfdRZ*e%d7edKd9dfdSZ*e(dTd7edKd9dfdUZ*eded7edVd9edfdWZ+eded7edVd9edfdXZ,e e e e e dYZ-dZS)[ CreditNotez Issue a credit note to adjust an invoice's amount after the invoice is finalized. Related guide: [Credit notes](https://docs.stripe.com/billing/invoices/credit-notes) credit_note OBJECT_NAMEc2eZdZUeed< eded<dS)CreditNote.DiscountAmountamountrdiscountN)__name__ __module__ __qualname__int__annotations__rW/var/www/app.qaans.com/backend/venv/lib/python3.11/site-packages/stripe/_credit_note.pyDiscountAmountr,<s7  "*----  r5r7czeZdZUeed< eeded< eeded< eded<dS) CreditNote.PretaxCreditAmountr-rcredit_balance_transactionrr.)r:r.typeN)r/r0r1r2r3rrrr4r5r6PretaxCreditAmountr9Fs|  %- 6 7%     ?:67777 >????  r5r<ceZdZUGddeZeed< eeed< eded< ee ded< deiZ d S) CreditNote.Refundc&eZdZUeed< eed<dS)%CreditNote.Refund.PaymentRecordRefundpayment_record refund_groupNr/r0r1strr3r4r5r6PaymentRecordRefundr@[s5         r5rEamount_refundedpayment_record_refundRefundResourcerefund)rGrIr;N) r/r0r1rrEr2r3rrr_inner_class_typesr4r5r6rr>Zs     ,     ((;<<<<  01111 w@ABBBB 67JKr5rceZdZUGddeZeed< eed< eed< eeded< ee eed< deiZ d S) CreditNote.ShippingCostcbeZdZUeed< ded< eeded< eeed<dS)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/r0r1r2r3rrr4r5r6TaxrNxsqKKK OOO  ("    & %SM ) ) )  r5raamount_subtotal amount_tax amount_totalr shipping_ratetaxesN) r/r0r1rrar2r3rrrrJr4r5r6 ShippingCostrLws$ $ $ $ $ ,$ $ $ L     ?@@@@ S """" &s^r5rgceZdZUGddeZeed< eded< eeed< eded< eeed < eded < deiZ d S) CreditNote.TotalTaxceZdZUeed<dS)"CreditNote.TotalTax.TaxRateDetailstax_rateNrCr4r5r6TaxRateDetailsrksMMM  r5rmr-) exclusive inclusive tax_behaviortax_rate_details)rP not_availablerQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r`r;N) r/r0r1rrmr2r3rrrJr4r5r6TotalTaxris     \      67777 #>2222 #     $ ! %%% ()))) 1.Ar5rsr-amount_shippingcreatedcurrencyrcustomercustomer_accountrcustomer_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 rtd|d||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.createusB&           r5cKtd|d||d{VS)rr(rrN)r_static_request_asyncrrs r6 create_asynczCreditNote.create_asyncsd& ++ ,         r5r c |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 r6listzCreditNote.listsp$$  MMOO%   &*-- 7<<(*   r5cK|d||d{V}t|ts$t dt |jz|S)rrrNr)rrrrrr;r/rs r6 list_asynczCreditNote.list_asyncs00  MMOO1         &*-- 7<<(*   r5r!c |dt|}td|d||S)2 Updates an existing credit note. /r(rr)rr rrrr}rurls r6modifyzCreditNote.modifysX+b///:          r5cK|dt|}td|d||d{VS)rrr(rrN)rr rrrs r6 modify_asynczCreditNote.modify_asyncsz+b///: ++,         r5r#c Ntd|dd|S)E Get a preview of a credit note without creating it. r(r/v1/credit_notes/previewr)rrrs r6previewzCreditNote.previews:    *      r5c^Ktd|dd|d{VS)rr(rrrN)rrrs r6 preview_asynczCreditNote.preview_asyncs\ ++*,         r5r"c 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 r6 preview_lineszCreditNote.preview_liness@ + ,   0      r5ctKttd|dd|d{VS)rrrrrN)rrrrs r6preview_lines_asynczCreditNote.preview_lines_async'sb + ,++0,         r5r$c @||fi|}||S)M Retrieves the credit note object with the given identifier. )refreshrr}rinstances r6retrievezCreditNote.retrieve7s23r$$V$$r5cPK||fi|}|d{V|S)rN) refresh_asyncrs r6retrieve_asynczCreditNote.retrieve_asyncBsH3r$$V$$$$&&&&&&&&&r5r%c td|ddt||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_noteMsQ    ,33{23GG      r5c dSrNr4r}rs r6void_credit_notezCreditNote.void_credit_note]s  r5c dSrr4selfrs r6rzCreditNote.void_credit_notegs  r5rc td|ddt|d|S)rr(rrr}rr)r_requestrr rrs r6rzCreditNote.void_credit_notepsd  MM,33"488D>>224      r5c Ktd|ddt||d{VS)rr(rrrrN)rrrr rs r6_cls_void_credit_note_asyncz&CreditNote._cls_void_credit_note_asyncss ++,33{23GG,         r5c KdSrr4rs r6void_credit_note_asyncz!CreditNote.void_credit_note_asyncs  r5c KdSrr4rs r6rz!CreditNote.void_credit_note_asyncs  r5rc Ktd|ddt|d|d{VS)rr(rrr}rrN)r_request_asyncrr rrs r6rz!CreditNote.void_credit_note_asyncs %%,33"488D>>224 &         r5rc 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)rrrrr rr)rs r6 list_lineszCreditNote.list_linessb + ,   6== +K 8 8>      r5c Kttd|ddt ||d{VS)rrrrrrN)rrrrr rs r6list_lines_asynczCreditNote.list_lines_asyncs + ,++6== +K 8 8> ,         r5)r{rrrrN).r/r0r1__doc__r*r rr3rr7r<rrgrsr2rDrrrrboolr classmethodrrrrrrrrrrrrrrr staticmethodrr rrrrrJr4r5r6r(r(.s{  5BK'-01AAA             \   (LLLLLLLL:;,;,;,;,;,|;,;,;,z0B0B0B0B0B<0B0B0Bd KKKLLLMMMj))))sm####+45#>****3- GGGY '''' * ++++NNN 3-tCH~&&&& KKK M """"! %%% HHH 23333  O   &\L)))) $ %%%%MMM%SM))) JJJ"#&&&$x.)))) 8 9999} 67    [ 6 67    [ 645 L ![&45 L ![&  &'? @    [   &'? @    [   78      [    78      [    <=  ( )    [    <=  ( )    [   &'A B [ &'A B [    &'G H      [    !"BC    \X  ?@    X 122 ?@    32 "    &'G H      [    !"BC    \X  ?@    X 788 ?@    98 "  )/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(r4r5r6rsBAAAAA444444******======OOOOOO......AAAAAA::::::::AAAAAAAAAAAAAAAA<<<<<<<<<<@@@@@@))))))OOOOOO))))))''''''777777222222((((((POOOOOLKKKKKOOOOOO v&&r r r r r ,' %,'r r '&r r r r5