[{"data":1,"prerenderedAt":1116},["ShallowReactive",2],{"navigation_docs":3,"-packages-python-orders":465,"-packages-python-orders-surround":1111},[4,8,62,115,450],{"title":5,"path":6,"stem":7},"Introduction","\u002Fintroduction","0.introduction",{"title":9,"path":10,"stem":11,"children":12,"page":61},"Guides","\u002Fguides","1.guides",[13,17,21,25,29,33,37,41,45,49,53,57],{"title":14,"path":15,"stem":16},"Quickstart","\u002Fguides\u002Fquickstart","1.guides\u002F1.quickstart",{"title":18,"path":19,"stem":20},"Payouts & Settlement","\u002Fguides\u002Fpayouts","1.guides\u002F10.payouts",{"title":22,"path":23,"stem":24},"Customer Emails","\u002Fguides\u002Fcustomer-emails","1.guides\u002F11.customer-emails",{"title":26,"path":27,"stem":28},"Build your own integration","\u002Fguides\u002Fbuild-your-own-integration","1.guides\u002F2.build-your-own-integration",{"title":30,"path":31,"stem":32},"Selling Workflow","\u002Fguides\u002Fselling-workflow","1.guides\u002F2.selling-workflow",{"title":34,"path":35,"stem":36},"Vatly SDKs","\u002Fguides\u002Fsdks","1.guides\u002F3.sdks",{"title":38,"path":39,"stem":40},"Authentication","\u002Fguides\u002Fauthentication","1.guides\u002F4.authentication",{"title":42,"path":43,"stem":44},"Pagination","\u002Fguides\u002Fpagination","1.guides\u002F5.pagination",{"title":46,"path":47,"stem":48},"Errors","\u002Fguides\u002Ferrors","1.guides\u002F6.errors",{"title":50,"path":51,"stem":52},"Webhooks","\u002Fguides\u002Fwebhooks","1.guides\u002F7.webhooks",{"title":54,"path":55,"stem":56},"Idempotency","\u002Fguides\u002Fidempotency","1.guides\u002F8.idempotency",{"title":58,"path":59,"stem":60},"Testing","\u002Fguides\u002Ftesting","1.guides\u002F9.testing",false,{"title":63,"path":64,"stem":65,"children":66,"page":61},"Api Reference","\u002Fapi-reference","2.api-reference",[67,71,75,79,83,87,91,95,99,103,107,111],{"title":68,"path":69,"stem":70},"Customers","\u002Fapi-reference\u002Fcustomers","2.api-reference\u002F1.customers",{"title":72,"path":73,"stem":74},"Webhook Endpoints","\u002Fapi-reference\u002Fwebhook-endpoints","2.api-reference\u002F10.webhook-endpoints",{"title":76,"path":77,"stem":78},"Test helpers","\u002Fapi-reference\u002Ftest-helpers","2.api-reference\u002F11.test-helpers",{"title":80,"path":81,"stem":82},"Checkouts","\u002Fapi-reference\u002Fcheckouts","2.api-reference\u002F2.checkouts",{"title":84,"path":85,"stem":86},"One-off Products","\u002Fapi-reference\u002Fone-off-products","2.api-reference\u002F3.one-off-products",{"title":88,"path":89,"stem":90},"Subscriptions","\u002Fapi-reference\u002Fsubscriptions","2.api-reference\u002F4.subscriptions",{"title":92,"path":93,"stem":94},"Subscription Plans","\u002Fapi-reference\u002Fsubscription-plans","2.api-reference\u002F5.subscription-plans",{"title":96,"path":97,"stem":98},"Orders","\u002Fapi-reference\u002Forders","2.api-reference\u002F6.orders",{"title":100,"path":101,"stem":102},"Order Refunds","\u002Fapi-reference\u002Frefunds","2.api-reference\u002F7.refunds",{"title":104,"path":105,"stem":106},"Refunds","\u002Fapi-reference\u002Fglobal-refunds","2.api-reference\u002F8.global-refunds",{"title":108,"path":109,"stem":110},"Chargebacks","\u002Fapi-reference\u002Fchargebacks","2.api-reference\u002F9.chargebacks",{"title":112,"path":113,"stem":114},"Webhook Events","\u002Fapi-reference\u002Fwebhook-events","2.api-reference\u002F99.webhook-events",{"title":116,"path":117,"stem":118,"children":119},"Packages","\u002Fpackages","3.packages",[120,122,164,210,244,283,318,366,408],{"title":116,"path":117,"stem":121},"3.packages\u002Findex",{"title":123,"path":124,"stem":125,"children":126,"page":61},"PHP SDK","\u002Fpackages\u002Fphp","3.packages\u002F1.php",[127,131,134,137,140,144,147,151,154,157,160],{"title":128,"path":129,"stem":130},"Getting started","\u002Fpackages\u002Fphp\u002Freadme","3.packages\u002F1.php\u002F00.readme",{"title":68,"path":132,"stem":133},"\u002Fpackages\u002Fphp\u002Fcustomers","3.packages\u002F1.php\u002F02.customers",{"title":80,"path":135,"stem":136},"\u002Fpackages\u002Fphp\u002Fcheckouts","3.packages\u002F1.php\u002F03.checkouts",{"title":88,"path":138,"stem":139},"\u002Fpackages\u002Fphp\u002Fsubscriptions","3.packages\u002F1.php\u002F04.subscriptions",{"title":141,"path":142,"stem":143},"Subscription plans","\u002Fpackages\u002Fphp\u002Fsubscriptionplans","3.packages\u002F1.php\u002F05.subscriptionplans",{"title":96,"path":145,"stem":146},"\u002Fpackages\u002Fphp\u002Forders","3.packages\u002F1.php\u002F06.orders",{"title":148,"path":149,"stem":150},"One-off products","\u002Fpackages\u002Fphp\u002Foneoffproducts","3.packages\u002F1.php\u002F07.oneoffproducts",{"title":104,"path":152,"stem":153},"\u002Fpackages\u002Fphp\u002Frefunds","3.packages\u002F1.php\u002F08.refunds",{"title":108,"path":155,"stem":156},"\u002Fpackages\u002Fphp\u002Fchargebacks","3.packages\u002F1.php\u002F09.chargebacks",{"title":50,"path":158,"stem":159},"\u002Fpackages\u002Fphp\u002Fwebhooks","3.packages\u002F1.php\u002F10.webhooks",{"title":161,"path":162,"stem":163},"Webhook URLs","\u002Fpackages\u002Fphp\u002Fwebhookendpoints","3.packages\u002F1.php\u002F11.webhookendpoints",{"title":165,"path":166,"stem":167,"children":168,"page":61},"PHP Fluent","\u002Fpackages\u002Ffluent-php","3.packages\u002F2.fluent-php",[169,172,176,180,183,186,189,192,196,199,203,207],{"title":128,"path":170,"stem":171},"\u002Fpackages\u002Ffluent-php\u002Freadme","3.packages\u002F2.fluent-php\u002F00.readme",{"title":173,"path":174,"stem":175},"Configuration","\u002Fpackages\u002Ffluent-php\u002Fconfiguration","3.packages\u002F2.fluent-php\u002F01.configuration",{"title":177,"path":178,"stem":179},"Core concepts","\u002Fpackages\u002Ffluent-php\u002Fcoreconcepts","3.packages\u002F2.fluent-php\u002F02.coreconcepts",{"title":68,"path":181,"stem":182},"\u002Fpackages\u002Ffluent-php\u002Fcustomers","3.packages\u002F2.fluent-php\u002F03.customers",{"title":80,"path":184,"stem":185},"\u002Fpackages\u002Ffluent-php\u002Fcheckouts","3.packages\u002F2.fluent-php\u002F04.checkouts",{"title":88,"path":187,"stem":188},"\u002Fpackages\u002Ffluent-php\u002Fsubscriptions","3.packages\u002F2.fluent-php\u002F05.subscriptions",{"title":96,"path":190,"stem":191},"\u002Fpackages\u002Ffluent-php\u002Forders","3.packages\u002F2.fluent-php\u002F06.orders",{"title":193,"path":194,"stem":195},"Customer portal","\u002Fpackages\u002Ffluent-php\u002Fcustomerportal","3.packages\u002F2.fluent-php\u002F07.customerportal",{"title":50,"path":197,"stem":198},"\u002Fpackages\u002Ffluent-php\u002Fwebhooks","3.packages\u002F2.fluent-php\u002F08.webhooks",{"title":200,"path":201,"stem":202},"Webhook event flow","\u002Fpackages\u002Ffluent-php\u002Fwebhook-flow","3.packages\u002F2.fluent-php\u002F09.webhook-flow",{"title":204,"path":205,"stem":206},"Existing tables","\u002Fpackages\u002Ffluent-php\u002Fhost-owns-its-tables","3.packages\u002F2.fluent-php\u002F10.host-owns-its-tables",{"title":58,"path":208,"stem":209},"\u002Fpackages\u002Ffluent-php\u002Ftesting","3.packages\u002F2.fluent-php\u002F11.testing",{"title":211,"path":212,"stem":213,"children":214,"page":61},"Laravel","\u002Fpackages\u002Flaravel","3.packages\u002F3.laravel",[215,218,221,224,227,230,233,236,240],{"title":128,"path":216,"stem":217},"\u002Fpackages\u002Flaravel\u002Freadme","3.packages\u002F3.laravel\u002F00.readme",{"title":173,"path":219,"stem":220},"\u002Fpackages\u002Flaravel\u002Fconfiguration","3.packages\u002F3.laravel\u002F01.configuration",{"title":68,"path":222,"stem":223},"\u002Fpackages\u002Flaravel\u002Fcustomers","3.packages\u002F3.laravel\u002F02.customers",{"title":80,"path":225,"stem":226},"\u002Fpackages\u002Flaravel\u002Fcheckouts","3.packages\u002F3.laravel\u002F03.checkouts",{"title":88,"path":228,"stem":229},"\u002Fpackages\u002Flaravel\u002Fsubscriptions","3.packages\u002F3.laravel\u002F04.subscriptions",{"title":96,"path":231,"stem":232},"\u002Fpackages\u002Flaravel\u002Forders","3.packages\u002F3.laravel\u002F05.orders",{"title":50,"path":234,"stem":235},"\u002Fpackages\u002Flaravel\u002Fwebhooks","3.packages\u002F3.laravel\u002F06.webhooks",{"title":237,"path":238,"stem":239},"Comparison","\u002Fpackages\u002Flaravel\u002Fcomparison","3.packages\u002F3.laravel\u002F07.comparison",{"title":241,"path":242,"stem":243},"Migrating from Cashier","\u002Fpackages\u002Flaravel\u002Fmigrating-to-vatly","3.packages\u002F3.laravel\u002F08.migrating-to-vatly",{"title":245,"path":246,"stem":247,"children":248,"page":61},"JavaScript SDK","\u002Fpackages\u002Fjavascript","3.packages\u002F4.javascript",[249,252,255,258,261,264,267,270,273,276,279],{"title":128,"path":250,"stem":251},"\u002Fpackages\u002Fjavascript\u002Freadme","3.packages\u002F4.javascript\u002F00.readme",{"title":68,"path":253,"stem":254},"\u002Fpackages\u002Fjavascript\u002Fcustomers","3.packages\u002F4.javascript\u002F02.customers",{"title":80,"path":256,"stem":257},"\u002Fpackages\u002Fjavascript\u002Fcheckouts","3.packages\u002F4.javascript\u002F03.checkouts",{"title":88,"path":259,"stem":260},"\u002Fpackages\u002Fjavascript\u002Fsubscriptions","3.packages\u002F4.javascript\u002F04.subscriptions",{"title":141,"path":262,"stem":263},"\u002Fpackages\u002Fjavascript\u002Fsubscriptionplans","3.packages\u002F4.javascript\u002F05.subscriptionplans",{"title":96,"path":265,"stem":266},"\u002Fpackages\u002Fjavascript\u002Forders","3.packages\u002F4.javascript\u002F06.orders",{"title":148,"path":268,"stem":269},"\u002Fpackages\u002Fjavascript\u002Foneoffproducts","3.packages\u002F4.javascript\u002F07.oneoffproducts",{"title":104,"path":271,"stem":272},"\u002Fpackages\u002Fjavascript\u002Frefunds","3.packages\u002F4.javascript\u002F08.refunds",{"title":108,"path":274,"stem":275},"\u002Fpackages\u002Fjavascript\u002Fchargebacks","3.packages\u002F4.javascript\u002F09.chargebacks",{"title":50,"path":277,"stem":278},"\u002Fpackages\u002Fjavascript\u002Fwebhooks","3.packages\u002F4.javascript\u002F10.webhooks",{"title":280,"path":281,"stem":282},"API reference","\u002Fpackages\u002Fjavascript\u002Fapi","3.packages\u002F4.javascript\u002F12.api",{"title":284,"path":285,"stem":286,"children":287,"page":61},"JavaScript Fluent","\u002Fpackages\u002Ffluent-js","3.packages\u002F5.fluent-js",[288,291,294,297,300,303,306,309,312,315],{"title":128,"path":289,"stem":290},"\u002Fpackages\u002Ffluent-js\u002Freadme","3.packages\u002F5.fluent-js\u002F00.readme",{"title":173,"path":292,"stem":293},"\u002Fpackages\u002Ffluent-js\u002Fconfiguration","3.packages\u002F5.fluent-js\u002F01.configuration",{"title":177,"path":295,"stem":296},"\u002Fpackages\u002Ffluent-js\u002Fcoreconcepts","3.packages\u002F5.fluent-js\u002F02.coreconcepts",{"title":68,"path":298,"stem":299},"\u002Fpackages\u002Ffluent-js\u002Fcustomers","3.packages\u002F5.fluent-js\u002F03.customers",{"title":80,"path":301,"stem":302},"\u002Fpackages\u002Ffluent-js\u002Fcheckouts","3.packages\u002F5.fluent-js\u002F04.checkouts",{"title":88,"path":304,"stem":305},"\u002Fpackages\u002Ffluent-js\u002Fsubscriptions","3.packages\u002F5.fluent-js\u002F05.subscriptions",{"title":96,"path":307,"stem":308},"\u002Fpackages\u002Ffluent-js\u002Forders","3.packages\u002F5.fluent-js\u002F06.orders",{"title":193,"path":310,"stem":311},"\u002Fpackages\u002Ffluent-js\u002Fcustomerportal","3.packages\u002F5.fluent-js\u002F07.customerportal",{"title":50,"path":313,"stem":314},"\u002Fpackages\u002Ffluent-js\u002Fwebhooks","3.packages\u002F5.fluent-js\u002F08.webhooks",{"title":58,"path":316,"stem":317},"\u002Fpackages\u002Ffluent-js\u002Ftesting","3.packages\u002F5.fluent-js\u002F11.testing",{"title":319,"path":320,"stem":321,"children":322,"page":61},"Python SDK","\u002Fpackages\u002Fpython","3.packages\u002F6.python",[323,326,329,332,335,338,341,344,347,350,353,356,359,362],{"title":128,"path":324,"stem":325},"\u002Fpackages\u002Fpython\u002Freadme","3.packages\u002F6.python\u002F00.readme",{"title":173,"path":327,"stem":328},"\u002Fpackages\u002Fpython\u002Fconfiguration","3.packages\u002F6.python\u002F01.configuration",{"title":68,"path":330,"stem":331},"\u002Fpackages\u002Fpython\u002Fcustomers","3.packages\u002F6.python\u002F02.customers",{"title":80,"path":333,"stem":334},"\u002Fpackages\u002Fpython\u002Fcheckouts","3.packages\u002F6.python\u002F03.checkouts",{"title":88,"path":336,"stem":337},"\u002Fpackages\u002Fpython\u002Fsubscriptions","3.packages\u002F6.python\u002F04.subscriptions",{"title":141,"path":339,"stem":340},"\u002Fpackages\u002Fpython\u002Fsubscriptionplans","3.packages\u002F6.python\u002F05.subscriptionplans",{"title":96,"path":342,"stem":343},"\u002Fpackages\u002Fpython\u002Forders","3.packages\u002F6.python\u002F06.orders",{"title":148,"path":345,"stem":346},"\u002Fpackages\u002Fpython\u002Foneoffproducts","3.packages\u002F6.python\u002F07.oneoffproducts",{"title":104,"path":348,"stem":349},"\u002Fpackages\u002Fpython\u002Frefunds","3.packages\u002F6.python\u002F08.refunds",{"title":108,"path":351,"stem":352},"\u002Fpackages\u002Fpython\u002Fchargebacks","3.packages\u002F6.python\u002F09.chargebacks",{"title":50,"path":354,"stem":355},"\u002Fpackages\u002Fpython\u002Fwebhooks","3.packages\u002F6.python\u002F10.webhooks",{"title":161,"path":357,"stem":358},"\u002Fpackages\u002Fpython\u002Fwebhookendpoints","3.packages\u002F6.python\u002F11.webhookendpoints",{"title":280,"path":360,"stem":361},"\u002Fpackages\u002Fpython\u002Fapi","3.packages\u002F6.python\u002F12.api",{"title":363,"path":364,"stem":365},"Development","\u002Fpackages\u002Fpython\u002Fdevelopment","3.packages\u002F6.python\u002F13.development",{"title":367,"path":368,"stem":369,"children":370,"page":61},"Python Fluent","\u002Fpackages\u002Ffluent-python","3.packages\u002F7.fluent-python",[371,374,377,380,383,386,389,392,395,398,401,405],{"title":128,"path":372,"stem":373},"\u002Fpackages\u002Ffluent-python\u002Freadme","3.packages\u002F7.fluent-python\u002F00.readme",{"title":173,"path":375,"stem":376},"\u002Fpackages\u002Ffluent-python\u002Fconfiguration","3.packages\u002F7.fluent-python\u002F01.configuration",{"title":177,"path":378,"stem":379},"\u002Fpackages\u002Ffluent-python\u002Fcoreconcepts","3.packages\u002F7.fluent-python\u002F02.coreconcepts",{"title":68,"path":381,"stem":382},"\u002Fpackages\u002Ffluent-python\u002Fcustomers","3.packages\u002F7.fluent-python\u002F03.customers",{"title":80,"path":384,"stem":385},"\u002Fpackages\u002Ffluent-python\u002Fcheckouts","3.packages\u002F7.fluent-python\u002F04.checkouts",{"title":88,"path":387,"stem":388},"\u002Fpackages\u002Ffluent-python\u002Fsubscriptions","3.packages\u002F7.fluent-python\u002F05.subscriptions",{"title":96,"path":390,"stem":391},"\u002Fpackages\u002Ffluent-python\u002Forders","3.packages\u002F7.fluent-python\u002F06.orders",{"title":193,"path":393,"stem":394},"\u002Fpackages\u002Ffluent-python\u002Fcustomerportal","3.packages\u002F7.fluent-python\u002F07.customerportal",{"title":50,"path":396,"stem":397},"\u002Fpackages\u002Ffluent-python\u002Fwebhooks","3.packages\u002F7.fluent-python\u002F08.webhooks",{"title":58,"path":399,"stem":400},"\u002Fpackages\u002Ffluent-python\u002Ftesting","3.packages\u002F7.fluent-python\u002F11.testing",{"title":402,"path":403,"stem":404},"Porting","\u002Fpackages\u002Ffluent-python\u002Fporting","3.packages\u002F7.fluent-python\u002F12.porting",{"title":363,"path":406,"stem":407},"\u002Fpackages\u002Ffluent-python\u002Fdevelopment","3.packages\u002F7.fluent-python\u002F13.development",{"title":409,"path":410,"stem":411,"children":412,"page":61},"Django","\u002Fpackages\u002Fdjango","3.packages\u002F8.django",[413,416,420,423,427,431,434,437,440,444,447],{"title":128,"path":414,"stem":415},"\u002Fpackages\u002Fdjango\u002Freadme","3.packages\u002F8.django\u002F00.readme",{"title":417,"path":418,"stem":419},"Installation","\u002Fpackages\u002Fdjango\u002Finstallation","3.packages\u002F8.django\u002F01.installation",{"title":173,"path":421,"stem":422},"\u002Fpackages\u002Fdjango\u002Fconfiguration","3.packages\u002F8.django\u002F02.configuration",{"title":424,"path":425,"stem":426},"Billable models","\u002Fpackages\u002Fdjango\u002Fbillablemodels","3.packages\u002F8.django\u002F03.billablemodels",{"title":428,"path":429,"stem":430},"Checkout","\u002Fpackages\u002Fdjango\u002Fcheckout","3.packages\u002F8.django\u002F04.checkout",{"title":88,"path":432,"stem":433},"\u002Fpackages\u002Fdjango\u002Fbilling","3.packages\u002F8.django\u002F05.billing",{"title":193,"path":435,"stem":436},"\u002Fpackages\u002Fdjango\u002Fcustomerportal","3.packages\u002F8.django\u002F06.customerportal",{"title":50,"path":438,"stem":439},"\u002Fpackages\u002Fdjango\u002Fwebhooks","3.packages\u002F8.django\u002F07.webhooks",{"title":441,"path":442,"stem":443},"Admin","\u002Fpackages\u002Fdjango\u002Fadmin","3.packages\u002F8.django\u002F08.admin",{"title":58,"path":445,"stem":446},"\u002Fpackages\u002Fdjango\u002Ftesting","3.packages\u002F8.django\u002F09.testing",{"title":363,"path":448,"stem":449},"\u002Fpackages\u002Fdjango\u002Fdevelopment","3.packages\u002F8.django\u002F10.development",{"title":451,"path":452,"stem":453,"children":454},"Integrations","\u002Fintegrations","4.integrations",[455,457,461],{"title":451,"path":452,"stem":456},"4.integrations\u002Findex",{"title":458,"path":459,"stem":460},"Lovable payments with Vatly","\u002Fintegrations\u002Flovable","4.integrations\u002F1.lovable",{"title":462,"path":463,"stem":464},"Bolt payments with Vatly","\u002Fintegrations\u002Fbolt","4.integrations\u002F2.bolt",{"id":466,"title":96,"body":467,"description":1104,"extension":1105,"links":1106,"meta":1107,"navigation":1108,"path":342,"seo":1109,"stem":343,"__hash__":1110},"docs\u002F3.packages\u002F6.python\u002F06.orders.md",{"type":468,"value":469,"toc":1100},"minimark",[470,484,489,800,897,910,929,933,1060,1072,1083,1096],[471,472,473,474,478,479,483],"p",{},"Orders contain purchased lines, tax and financial totals. Read an order after its\ncheckout has an ",[475,476,477],"code",{},"order_id",". Keep exact decimal amounts for accounting.\nExamples accept the client from ",[480,481,482],"a",{"href":324},"setup",".",[485,486,488],"h2",{"id":487},"read-an-order-and-its-lines","Read an order and its lines",[490,491,496],"pre",{"className":492,"code":493,"language":494,"meta":495,"style":495},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","from decimal import Decimal\nfrom vatly import VatlyClient\n\n\ndef example(client: VatlyClient):\n    order = client.orders.get(\"order_example\")\n    lines = [(line.product_type, line.product_id, line.quantity) for line in order.lines]\n    subscription_ids = [\n        line.related_resources.subscription_id\n        for line in order.lines\n        if line.related_resources is not None\n    ]\n    refundable = Decimal(order.refundable_subtotal.root.value)\n    return order.status, lines, subscription_ids, refundable\n","python","",[475,497,498,517,530,537,542,570,607,668,679,695,712,733,739,772],{"__ignoreMap":495},[499,500,503,507,511,514],"span",{"class":501,"line":502},"line",1,[499,504,506],{"class":505},"s7zQu","from",[499,508,510],{"class":509},"sTEyZ"," decimal ",[499,512,513],{"class":505},"import",[499,515,516],{"class":509}," Decimal\n",[499,518,520,522,525,527],{"class":501,"line":519},2,[499,521,506],{"class":505},[499,523,524],{"class":509}," vatly ",[499,526,513],{"class":505},[499,528,529],{"class":509}," VatlyClient\n",[499,531,533],{"class":501,"line":532},3,[499,534,536],{"emptyLinePlaceholder":535},true,"\n",[499,538,540],{"class":501,"line":539},4,[499,541,536],{"emptyLinePlaceholder":535},[499,543,545,549,553,557,561,564,567],{"class":501,"line":544},5,[499,546,548],{"class":547},"spNyl","def",[499,550,552],{"class":551},"s2Zo4"," example",[499,554,556],{"class":555},"sMK4o","(",[499,558,560],{"class":559},"sHdIc","client",[499,562,563],{"class":555},":",[499,565,566],{"class":509}," VatlyClient",[499,568,569],{"class":555},"):\n",[499,571,573,576,579,582,584,588,590,593,595,598,602,604],{"class":501,"line":572},6,[499,574,575],{"class":509},"    order ",[499,577,578],{"class":555},"=",[499,580,581],{"class":509}," client",[499,583,483],{"class":555},[499,585,587],{"class":586},"swJcz","orders",[499,589,483],{"class":555},[499,591,592],{"class":551},"get",[499,594,556],{"class":555},[499,596,597],{"class":555},"\"",[499,599,601],{"class":600},"sfazB","order_example",[499,603,597],{"class":555},[499,605,606],{"class":555},")\n",[499,608,610,613,615,618,620,622,625,628,631,633,636,638,640,642,645,648,651,654,657,660,662,665],{"class":501,"line":609},7,[499,611,612],{"class":509},"    lines ",[499,614,578],{"class":555},[499,616,617],{"class":555}," [(",[499,619,501],{"class":509},[499,621,483],{"class":555},[499,623,624],{"class":586},"product_type",[499,626,627],{"class":555},",",[499,629,630],{"class":509}," line",[499,632,483],{"class":555},[499,634,635],{"class":586},"product_id",[499,637,627],{"class":555},[499,639,630],{"class":509},[499,641,483],{"class":555},[499,643,644],{"class":586},"quantity",[499,646,647],{"class":555},")",[499,649,650],{"class":505}," for",[499,652,653],{"class":509}," line ",[499,655,656],{"class":505},"in",[499,658,659],{"class":509}," order",[499,661,483],{"class":555},[499,663,664],{"class":586},"lines",[499,666,667],{"class":555},"]\n",[499,669,671,674,676],{"class":501,"line":670},8,[499,672,673],{"class":509},"    subscription_ids ",[499,675,578],{"class":555},[499,677,678],{"class":555}," [\n",[499,680,682,685,687,690,692],{"class":501,"line":681},9,[499,683,684],{"class":509},"        line",[499,686,483],{"class":555},[499,688,689],{"class":586},"related_resources",[499,691,483],{"class":555},[499,693,694],{"class":586},"subscription_id\n",[499,696,698,701,703,705,707,709],{"class":501,"line":697},10,[499,699,700],{"class":505},"        for",[499,702,653],{"class":509},[499,704,656],{"class":505},[499,706,659],{"class":509},[499,708,483],{"class":555},[499,710,711],{"class":586},"lines\n",[499,713,715,718,720,722,724,727,730],{"class":501,"line":714},11,[499,716,717],{"class":505},"        if",[499,719,630],{"class":509},[499,721,483],{"class":555},[499,723,689],{"class":586},[499,725,726],{"class":555}," is",[499,728,729],{"class":555}," not",[499,731,732],{"class":555}," None\n",[499,734,736],{"class":501,"line":735},12,[499,737,738],{"class":555},"    ]\n",[499,740,742,745,747,750,752,755,757,760,762,765,767,770],{"class":501,"line":741},13,[499,743,744],{"class":509},"    refundable ",[499,746,578],{"class":555},[499,748,749],{"class":551}," Decimal",[499,751,556],{"class":555},[499,753,754],{"class":551},"order",[499,756,483],{"class":555},[499,758,759],{"class":586},"refundable_subtotal",[499,761,483],{"class":555},[499,763,764],{"class":586},"root",[499,766,483],{"class":555},[499,768,769],{"class":586},"value",[499,771,606],{"class":555},[499,773,775,778,780,782,785,787,790,792,795,797],{"class":501,"line":774},14,[499,776,777],{"class":505},"    return",[499,779,659],{"class":509},[499,781,483],{"class":555},[499,783,784],{"class":586},"status",[499,786,627],{"class":555},[499,788,789],{"class":509}," lines",[499,791,627],{"class":555},[499,793,794],{"class":509}," subscription_ids",[499,796,627],{"class":555},[499,798,799],{"class":509}," refundable\n",[801,802,803,816],"table",{},[804,805,806],"thead",{},[807,808,809,813],"tr",{},[810,811,812],"th",{},"Response field",[810,814,815],{},"Meaning",[817,818,819,836,855,874,884],"tbody",{},[807,820,821,833],{},[822,823,824,827,828,827,830],"td",{},[475,825,826],{},"id",", ",[475,829,784],{},[475,831,832],{},"customer_id",[822,834,835],{},"Order identity and payment state",[807,837,838,842],{},[822,839,840],{},[475,841,664],{},[822,843,844,845,827,847,827,849,827,851,827,853],{},"OrderLine models with ",[475,846,826],{},[475,848,624],{},[475,850,635],{},[475,852,644],{},[475,854,689],{},[807,856,857,864],{},[822,858,859,827,861],{},[475,860,759],{},[475,862,863],{},"reversed_subtotal",[822,865,866,867,870,871],{},"Money wrappers; read ",[475,868,869],{},".root.value"," and ",[475,872,873],{},".root.currency",[807,875,876,881],{},[822,877,878],{},[475,879,880],{},"links.customer_invoice",[822,882,883],{},"Optional customer invoice link",[807,885,886,894],{},[822,887,888,827,891],{},[475,889,890],{},"testmode",[475,892,893],{},"metadata",[822,895,896],{},"Mode and custom data",[471,898,899,902,903,905,906,909],{},[475,900,901],{},"product_type=\"subscription_plan\""," means ",[475,904,635],{}," is a plan ID;\n",[475,907,908],{},"\"subscription\""," means a subscription ID. Never substitute one for the other.",[471,911,912,915,916,918,919,922,923,918,926,928],{},[475,913,914],{},"line.related_resources.subscription_id"," is the subscription associated with a\nsignup, renewal or immediate-update line. ",[475,917,689],{}," is ",[475,920,921],{},"None"," on\nhistorical and unrelated lines. On a signup line, ",[475,924,925],{},"subscription_id",[475,927,921],{},"\nuntil the subscription is available; read the order again later. An ID alone\ndoes not prove activation or entitlement: check the subscription's ownership and\nstatus before granting access.",[485,930,932],{"id":931},"list-orders-and-request-an-invoice-details-link","List orders and request an invoice-details link",[490,934,936],{"className":492,"code":935,"language":494,"meta":495,"style":495},"from vatly import VatlyClient\n\n\ndef example(client: VatlyClient):\n    orders = list(client.orders.list_all({\"limit\": 25}))\n    link = client.orders.create_invoice_update_link(\"order_example\")\n    return orders, link.href\n",[475,937,938,948,952,956,972,1015,1043],{"__ignoreMap":495},[499,939,940,942,944,946],{"class":501,"line":502},[499,941,506],{"class":505},[499,943,524],{"class":509},[499,945,513],{"class":505},[499,947,529],{"class":509},[499,949,950],{"class":501,"line":519},[499,951,536],{"emptyLinePlaceholder":535},[499,953,954],{"class":501,"line":532},[499,955,536],{"emptyLinePlaceholder":535},[499,957,958,960,962,964,966,968,970],{"class":501,"line":539},[499,959,548],{"class":547},[499,961,552],{"class":551},[499,963,556],{"class":555},[499,965,560],{"class":559},[499,967,563],{"class":555},[499,969,566],{"class":509},[499,971,569],{"class":555},[499,973,974,977,979,983,985,987,989,991,993,996,999,1001,1004,1006,1008,1012],{"class":501,"line":544},[499,975,976],{"class":509},"    orders ",[499,978,578],{"class":555},[499,980,982],{"class":981},"sBMFI"," list",[499,984,556],{"class":555},[499,986,560],{"class":551},[499,988,483],{"class":555},[499,990,587],{"class":586},[499,992,483],{"class":555},[499,994,995],{"class":551},"list_all",[499,997,998],{"class":555},"({",[499,1000,597],{"class":555},[499,1002,1003],{"class":600},"limit",[499,1005,597],{"class":555},[499,1007,563],{"class":555},[499,1009,1011],{"class":1010},"sbssI"," 25",[499,1013,1014],{"class":555},"}))\n",[499,1016,1017,1020,1022,1024,1026,1028,1030,1033,1035,1037,1039,1041],{"class":501,"line":572},[499,1018,1019],{"class":509},"    link ",[499,1021,578],{"class":555},[499,1023,581],{"class":509},[499,1025,483],{"class":555},[499,1027,587],{"class":586},[499,1029,483],{"class":555},[499,1031,1032],{"class":551},"create_invoice_update_link",[499,1034,556],{"class":555},[499,1036,597],{"class":555},[499,1038,601],{"class":600},[499,1040,597],{"class":555},[499,1042,606],{"class":555},[499,1044,1045,1047,1050,1052,1055,1057],{"class":501,"line":609},[499,1046,777],{"class":505},[499,1048,1049],{"class":509}," orders",[499,1051,627],{"class":555},[499,1053,1054],{"class":509}," link",[499,1056,483],{"class":555},[499,1058,1059],{"class":586},"href\n",[471,1061,1062,1063,827,1065,827,1068,1071],{},"The hosted link lets the customer update invoice details. Authorize the order\nbefore returning it. List filters include ",[475,1064,1003],{},[475,1066,1067],{},"startingAfter",[475,1069,1070],{},"endingBefore",";\nsee the API reference for resource-specific filters.",[471,1073,1074,1075,1078,1079,1082],{},"Use ",[480,1076,1077],{"href":348},"refunds"," for reversals and ",[480,1080,1081],{"href":351},"chargebacks"," for disputes.\nOwnership comes from your checkout records, not a shared customer ID.",[471,1084,1085,1091,1092],{},[480,1086,1090],{"href":1087,"rel":1088},"https:\u002F\u002Fdocs.vatly.com\u002Fapi-reference\u002Forders",[1089],"nofollow","Order API reference"," · ",[480,1093,1095],{"href":1094},"\u002Fpackages\u002Fpython\u002Fapi#orders","All methods",[1097,1098,1099],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":495,"searchDepth":519,"depth":519,"links":1101},[1102,1103],{"id":487,"depth":519,"text":488},{"id":931,"depth":519,"text":932},"Orders contain purchased lines, tax and financial totals.","md",null,{},{"title":96},{"title":96,"description":1104},"ktX663dNpo_EUdoLleoi-JPV16ev6EEin9GJAUctg7w",[1112,1114],{"title":141,"path":339,"stem":340,"description":1113,"children":-1},"Plans define the recurring product, price and billing interval sold through a checkout.",{"title":148,"path":345,"stem":346,"description":1115,"children":-1},"Sell a digital product once rather than on a recurring schedule.",1794594931861]