Cash flow (collected counts settled payments with status captured, booked, refunded or partial_refunded, by payment date), MRR movements (signed), billed net revenue by class (net = gross − tax after position discounts, credit notes negative), outstanding receivables at each month end, ageing of the invoices open today, and the receivables table. One currency, never converted. Cash and receivables have no product dimension: a product filter does not narrow them (meta.filtersNotApplied).
Datasets of the finance overview: cash flow, MRR movements, revenue by class, receivables at each month end, ageing of open invoices today, and the receivables table. Every series is aligned with months.
Collected, refunded and net cash per month (by payment date; null after the current month) and the invoice forecast ("Rechnungsprognose", gross by invoice month; null before the current month). Collected counts settled payments (status captured, booked, refunded, partial_refunded).
Receivables table: per invoice month the billed amounts, the status of those invoices today, cash in and out, and the outstanding amount at the month end.
Totals over the range: cash_collected, cash_refunded, cash_net (elapsed and current months), cash_forecast (invoice forecast, gross, current and later months), recurring, one_off, variable, revenue_total, new, expansion, contraction, lost, resurrecting (contraction and lost negative).
Calculation time, effective scope and currency, finding counts, datasets that ignore the filter.
Show child attributes
War diese Seite hilfreich?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Fynn Docs","colors":{"primary":"#000","light":"#fff","dark":"#000"},"logo":{"light":"https://mintcdn.com/fynnsubscriptionbilling/kPbBeWVEZfmEic9q/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=kPbBeWVEZfmEic9q\u0026q=85\u0026s=83e4b30a53d77c3809e0f22afa29335d","dark":"https://mintcdn.com/fynnsubscriptionbilling/kPbBeWVEZfmEic9q/logo/dark.svg?fit=max\u0026auto=format\u0026n=kPbBeWVEZfmEic9q\u0026q=85\u0026s=5798319f6c8632d79fe789f72eaa94e2"},"favicon":"https://mintcdn.com/fynnsubscriptionbilling/zDQkHT5wBBQ3jA-O/favicon.svg?fit=max\u0026auto=format\u0026n=zDQkHT5wBBQ3jA-O\u0026q=85\u0026s=410ff1f698a399faed9fbb877457bb43","api":{"openapi":["assets/openapi.json","assets/openapi-v2-plans.json","assets/openapi-v2-offers.json","assets/openapi-v2-commission.json","assets/openapi-v2-payment-plans.json","assets/openapi-v2-finance.json"],"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript","php"]}},"navbar":{"links":[{"href":"https://cal.com/team/fynn/fynn-documentation","label":"Termin buchen"},{"href":"mailto:hi@fynn.eu","label":"Support"}],"primary":{"type":"button","label":"App Login","href":"https://app.fynn.eu"}},"footer":{"socials":{"x":"https://twitter.com/wearefynn","github":"https://github.com/fynn-digital","linkedin":"https://www.linkedin.com/company/wearefynn"}},"integrations":{"gtm":{"tagId":"GTM-NKGQ4TQ9"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"de","default":true,"href":"introduction"},{"language":"en","href":"en/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fynnsubscriptionbilling","hasAudioNarration":false,"actualSubdomain":"fynnsubscriptionbilling","customDomains":["docs.fynn.eu"],"gitSource":{"type":"gitlab","owner":"fynn/core","repo":"core-api23","deployBranch":"main","contentDirectory":"public-docs","isPrivate":true,"projectId":396,"hostUrl":"https://git.netzfabrik.com","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ade24310e2252351b6bcf20","collectionId":"c63f4a48-46bb-4163-a4ce-a54574f206c1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ade24310e2252351b6bcf20"},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"REMOVE_BRANDING":{"status":"ENABLED"}},"buildId":"6ade65cd8bc03ecc3442159a","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"de","tag":"API Referenz","count":249},{"language":"de","tag":"Dokumentation","count":93},{"language":"de","tag":"API V2","count":71},{"language":"en","tag":"Documentation","count":59},{"language":"de","tag":"API","count":46},{"language":"de","tag":"Catalogue","count":42},{"language":"de","tag":"Angebote","count":36},{"language":"de","tag":"Subscription","count":30},{"language":"de","tag":"Customer","count":30},{"language":"de","tag":"Finanzberichte","count":29},{"language":"de","tag":"Payment","count":26},{"language":"default","tag":"API V2","count":18},{"language":"default","tag":"Dokumentation","count":15},{"language":"default","tag":"Pläne","count":15},{"language":"en","tag":"Integrations","count":15},{"language":"default","tag":"API","count":11},{"language":"default","tag":"API Referenz","count":10},{"language":"default","tag":"API documentation","count":10},{"language":"en","tag":"Products","count":9},{"language":"en","tag":"Settings","count":9},{"language":"en","tag":"Customers","count":7},{"language":"en","tag":"Subscriptions","count":7},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Plan-Verwaltung","count":6},{"language":"en","tag":"Payment Providers","count":6},{"language":"default","tag":"Nutzungsbasierte Abrechnung","count":5},{"language":"en","tag":"Accounting","count":5},{"language":"en","tag":"Developers","count":5},{"language":"en","tag":"Invoices","count":5},{"language":"default","tag":"KI-Assistent","count":4}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".update-container{display:flex}.update-container>div{position:unset!important}@media (min-width:1024px){.update-container{flex-direction:column!important}}[data-component-part=update-label]{background:0 0}[data-component-part=update-tag]{-webkit-text-size-adjust:100%;tab-size:4;font-variation-settings:normal;-webkit-tap-highlight-color:transparent;font-feature-settings:\"cv02\",\"cv03\",\"cv04\",\"cv11\";--scroll-mt:9.5rem;--font-inter:'__Inter_86cd50', '__Inter_Fallback_86cd50';--font-jetbrains-mono:'__JetBrains_Mono_3c557b', '__JetBrains_Mono_Fallback_3c557b';--primary:39 19 64;--primary-light:255 255 255;--primary-dark:0 0 0;--background-light:255 255 255;--background-dark:0 0 0;--gray-50:244 243 244;--gray-100:239 238 239;--gray-200:223 223 224;--gray-300:207 206 207;--gray-400:159 159 160;--gray-500:113 112 113;--gray-600:81 80 81;--gray-700:63 63 64;--gray-800:38 37 39;--gray-900:23 23 24;--gray-950:11 10 12;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif,\"Apple Color Emoji\",\"Segoe UI Emoji\",\"Segoe UI Symbol\";-webkit-font-smoothing:antialiased;--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgba(0,0,0,.5);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;-webkit-user-modify:read-only;box-sizing:border-box;border-width:0;border-style:solid;border-color:rgb(var(--gray-200));--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgba(59,130,246,.5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: ;display:flex;flex-grow:0;cursor:pointer;align-items:center;justify-content:center;border-radius:var(--rounded-lg,.5rem);background-color:rgb(var(--primary)/.1);padding:.25rem .5rem;font-size:.875rem;line-height:1.25rem;font-weight:500;--tw-text-opacity:1;color:rgb(var(--primary)/var(--tw-text-opacity))}"}],"page":{"pagePath":"v2-finance-api/datasets/get-overview","slug":"/v2-finance-api/datasets/get-overview","pageMetadata":{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/overview","title":"Finance overview datasets","description":"Cash flow (collected counts settled payments with status captured, booked, refunded or partial_refunded, by payment date), MRR movements (signed), billed net revenue by class (net = gross − tax after position discounts, credit notes negative), outstanding receivables at each month end, ageing of the invoices open today, and the receivables table. One currency, never converted. Cash and receivables have no product dimension: a product filter does not narrow them (`meta.filtersNotApplied`).\n\nRequired permission: `analytics:read`.","href":"/v2-finance-api/datasets/get-overview"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Cash flow (collected counts settled payments with status captured, booked, refunded or partial_refunded, by payment date), MRR movements (signed), billed net revenue by class (net = gross − tax after position discounts, credit notes negative), outstanding receivables at each month end, ageing of the invoices open today, and the receivables table. One currency, never converted. Cash and receivables have no product dimension: a product filter does not narrow them (\", _jsx(_components.code, {\n children: \"meta.filtersNotApplied\"\n }), \").\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Required permission: \", _jsx(_components.code, {\n children: \"analytics:read\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/overview","title":"Finance overview datasets","description":"Cash flow (collected counts settled payments with status captured, booked, refunded or partial_refunded, by payment date), MRR movements (signed), billed net revenue by class (net = gross − tax after position discounts, credit notes negative), outstanding receivables at each month end, ageing of the invoices open today, and the receivables table. One currency, never converted. Cash and receivables have no product dimension: a product filter does not narrow them (`meta.filtersNotApplied`).\n\nRequired permission: `analytics:read`.","href":"/v2-finance-api/datasets/get-overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/fynnsubscriptionbilling/086131e1768d5953/changelog-sidebar.js"],"openApiReferenceData":{"operation":{"tags":["Datensätze"],"summary":"Finance overview datasets","description":"Cash flow (collected counts settled payments with status captured, booked, refunded or partial_refunded, by payment date), MRR movements (signed), billed net revenue by class (net = gross − tax after position discounts, credit notes negative), outstanding receivables at each month end, ageing of the invoices open today, and the receivables table. One currency, never converted. Cash and receivables have no product dimension: a product filter does not narrow them (`meta.filtersNotApplied`).\n\nRequired permission: `analytics:read`.","parameters":["8a2d6f5f-a7ef-4732-b65a-de4ad57becd2","31cb244e-78f1-4a30-a145-316e2af3ef9e","38916206-1980-43a1-bf86-7f462a01a4df","02eddccd-7985-41a3-95b3-cc8c973ef6af","0b1c3749-4c94-4dab-a1b7-247e2beb0404","cec51afb-dc79-4f48-b4bd-052b028b7ec1","8b76f355-b713-40cf-b518-f274a0af03fe"],"responses":{"200":"39a4a91a-9f02-40d3-8416-91e86c51ce0f","401":"7a61d710-25fc-4c1d-a5fb-fdc31987bea8","403":"ce6372ac-dd7c-4991-a0d3-1ca892aef4af","422":"9aa7a423-0719-4c77-84d6-0b084736ef8e"},"security":["93252035-0f05-4ae1-856f-35859bfff132"],"operationId":"getFinanceOverview","method":"get","type":"path","servers":["58ca1bf5-c883-4c98-a975-3a85f96f2f94","761f9cb6-1d17-4197-9e03-b79594029e5c"],"path":"/api/analytics/finance/overview","baseUrlOptions":["https://coreapi.io","https://preview.coreapi.io"],"title":"Finance overview datasets","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"8a2d6f5f-a7ef-4732-b65a-de4ad57becd2":{"name":"from","in":"query","description":"First month (YYYY-MM, time zone of the organisation). Default: `to` minus 11 months.","required":false,"schema":{"type":"string","isRequired":false,"description":"First month (YYYY-MM, time zone of the organisation). Default: `to` minus 11 months.","uniqueKey":"","typeLabel":"string"}},"31cb244e-78f1-4a30-a145-316e2af3ef9e":{"name":"to","in":"query","description":"Last month (YYYY-MM). Default: the current month. At most 36 months.","required":false,"schema":{"type":"string","isRequired":false,"description":"Last month (YYYY-MM). Default: the current month. At most 36 months.","uniqueKey":"","typeLabel":"string"}},"38916206-1980-43a1-bf86-7f462a01a4df":{"name":"currency","in":"query","description":"ISO-4217 code. Default: the default currency.","required":false,"schema":{"type":"string","isRequired":false,"description":"ISO-4217 code. Default: the default currency.","uniqueKey":"","typeLabel":"string"}},"02eddccd-7985-41a3-95b3-cc8c973ef6af":{"name":"scope","in":"query","description":"Movement scope of `mrrMovements`. Default: the organisation setting.","required":false,"schema":{"type":"string","enum":["subscription","invoice_address","customer","organisation"],"isRequired":false,"description":"Movement scope of `mrrMovements`. Default: the organisation setting.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"0b1c3749-4c94-4dab-a1b7-247e2beb0404":{"name":"segmentId","in":"query","description":"Analytics segment filter.","required":false,"schema":{"type":"string","format":"uuid","isRequired":false,"description":"Analytics segment filter.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"cec51afb-dc79-4f48-b4bd-052b028b7ec1":{"name":"customerIds[]","in":"query","description":"Customer filter.","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":false,"description":"Customer filter.","uniqueKey":"","typeLabel":"string\u003cuuid>[]"}},"8b76f355-b713-40cf-b518-f274a0af03fe":{"name":"productIds[]","in":"query","description":"Product filter (MRR movements and revenue).","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":false,"description":"Product filter (MRR movements and revenue).","uniqueKey":"","typeLabel":"string\u003cuuid>[]"}}},"responses":{"39a4a91a-9f02-40d3-8416-91e86c51ce0f":{"description":"The datasets.","content":{"application/json":{"schema":{"description":"Datasets of the finance overview: cash flow, MRR movements, revenue by class, receivables at each month end, ageing of open invoices today, and the receivables table. Every series is aligned with `months`.","properties":{"months":{"description":"Months of the range (YYYY-MM, time zone of the organisation), ascending.","type":"array","items":{"type":"string","uniqueKey":"months.items.[INDEX]","typeLabel":"string"},"uniqueKey":"months","typeLabel":"string[]"},"cashflow":{"type":"object","description":"Collected, refunded and net cash per month (by payment date; null after the current month) and the invoice forecast (\"Rechnungsprognose\", gross by invoice month; null before the current month). Collected counts settled payments (status captured, booked, refunded, partial_refunded).","properties":{"collected":{"description":"Collected per month; null after the current month (nothing happened yet).","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.collected.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.collected.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.collected.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.collected.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.collected.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.collected","typeLabel":"(object | null)[]"},"refunded":{"description":"Cash out per month (positive): refunds, chargebacks, payouts and return debit fees; null after the current month.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.refunded.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.refunded.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.refunded.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.refunded.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.refunded.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.refunded","typeLabel":"(object | null)[]"},"net":{"description":"Collected minus refunded per month; null after the current month.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.net.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.net.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.net.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.net.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.net.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.net","typeLabel":"(object | null)[]"},"totals":{"description":"Totals over the range: `collected`, `collected_this_month`, `collected_other_months`, `collected_unassigned` (the split of `collected`), `refunded`, `refunded_refund`, `refunded_chargeback`, `refunded_payout`, `refunded_return_fee` (the split of `refunded`), `collected_refund_returned` (the fourth part of `collected`), `corrections`, `corrections_reversed`, `corrections_counter` (the correction pairs, outside `collected` and `refunded`), `net`, `cash_net` (same as `net`), `forecast_billed` (sum of `forecastBilled`); and the averages per month for the chart's dashed line, rounded half-up to the cent, over the months that have a value (null when none has): `averageCollected`, `averageRefunded`, `averageNet` over the months up to the current one, `averageForecastBilled` over the months with a forecast (the current month and later).","type":"object","additionalProperties":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.totals.additionalProperties.oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.totals.additionalProperties.oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.totals.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.totals.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.totals.additionalProperties","typeLabel":"object | null"},"uniqueKey":"cashflow.totals","typeLabel":"object"},"forecastBilled":{"description":"Invoice forecast (\"Rechnungsprognose\"): gross of the invoices the billing forecast expects, by invoice month, for the current month (the invoices not yet issued) and later months; null for elapsed months. No assumption about the payment date.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.forecastBilled.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.forecastBilled.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.forecastBilled.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.forecastBilled.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.forecastBilled.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.forecastBilled","typeLabel":"(object | null)[]"},"collectedThisMonth":{"description":"Collected per month for invoices finalized in the same month; null after the current month.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.collectedThisMonth.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.collectedThisMonth.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.collectedThisMonth.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.collectedThisMonth.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.collectedThisMonth.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.collectedThisMonth","typeLabel":"(object | null)[]"},"collectedOtherMonths":{"description":"Collected per month for invoices finalized in another month (earlier invoices paid late, or paid before the invoice was finalized); null after the current month.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.collectedOtherMonths.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.collectedOtherMonths.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.collectedOtherMonths.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.collectedOtherMonths.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.collectedOtherMonths.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.collectedOtherMonths","typeLabel":"(object | null)[]"},"collectedUnassigned":{"description":"Collected per month that pays no finalized invoice (balance top-ups, prepayments without an invoice, the part above the gross of an overpaid invoice); null after the current month. The three parts add up to `collected`.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.collectedUnassigned.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.collectedUnassigned.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.collectedUnassigned.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.collectedUnassigned.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.collectedUnassigned.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.collectedUnassigned","typeLabel":"(object | null)[]"},"refundedRefund":{"description":"Refunds per month (part of `refunded`); null after the current month.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.refundedRefund.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.refundedRefund.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.refundedRefund.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.refundedRefund.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.refundedRefund.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.refundedRefund","typeLabel":"(object | null)[]"},"refundedChargeback":{"description":"Chargebacks per month: SEPA returns and card chargebacks (part of `refunded`); null after the current month.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.refundedChargeback.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.refundedChargeback.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.refundedChargeback.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.refundedChargeback.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.refundedChargeback.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.refundedChargeback","typeLabel":"(object | null)[]"},"refundedPayout":{"description":"Payouts of customer balances per month (part of `refunded`); null after the current month. With `refundedReturnFee` the four parts add up to `refunded`.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.refundedPayout.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.refundedPayout.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.refundedPayout.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.refundedPayout.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.refundedPayout.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.refundedPayout","typeLabel":"(object | null)[]"},"collectedRefundReturned":{"description":"Refunds that came back from the customer's bank per month (\"Erstattung zurückgekommen\": a negative refund matched from the bank account), part of `collected`; null after the current month. With it the four parts add up to `collected`.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.collectedRefundReturned.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.collectedRefundReturned.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.collectedRefundReturned.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.collectedRefundReturned.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.collectedRefundReturned.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.collectedRefundReturned","typeLabel":"(object | null)[]"},"corrections":{"description":"Corrections per month (\"Korrekturen\"): refunds entered by hand and cancelled by a counter-entry with the same amount; no money moved, so they are part of neither `collected` nor `refunded`. The sum of `correctionsReversed` and `correctionsCounter`; 0 over any range that holds both entries of every pair. Null after the current month. Shown in the tooltip, not as a bar.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.corrections.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.corrections.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.corrections.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.corrections.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.corrections.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.corrections","typeLabel":"(object | null)[]"},"correctionsReversed":{"description":"The cancelled refunds of the corrections per month (\"storniert\", positive); null after the current month.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.correctionsReversed.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.correctionsReversed.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.correctionsReversed.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.correctionsReversed.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.correctionsReversed.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.correctionsReversed","typeLabel":"(object | null)[]"},"correctionsCounter":{"description":"The counter-entries of the corrections per month (\"Gegenbuchung\", negative); null after the current month.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.correctionsCounter.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.correctionsCounter.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.correctionsCounter.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.correctionsCounter.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.correctionsCounter.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.correctionsCounter","typeLabel":"(object | null)[]"},"correctionCount":{"description":"Number of correction pairs per month, counted in the month of the counter-entry; null after the current month.","type":"array","items":{"oneOf":[{"type":"integer","uniqueKey":"cashflow.correctionCount.items.[INDEX].oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"cashflow.correctionCount.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.correctionCount.items.[INDEX]","typeLabel":"integer | null"},"uniqueKey":"cashflow.correctionCount","typeLabel":"(integer | null)[]"},"refundedReturnFee":{"description":"Bank fees of return debits per month (\"Rücklastschrift-Gebühren\": a negative direct-debit payment without a return case that is a collected payment plus a fee; the fee is not part of the invoice), part of `refunded`; null after the current month.","type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"cashflow.refundedReturnFee.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"cashflow.refundedReturnFee.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"cashflow.refundedReturnFee.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"cashflow.refundedReturnFee.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"cashflow.refundedReturnFee.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"cashflow.refundedReturnFee","typeLabel":"(object | null)[]"}},"uniqueKey":"cashflow","typeLabel":"object"},"mrrMovements":{"type":"object","description":"MRR movements per month, signed: contraction and lost are negative.","properties":{"new":{"type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"mrrMovements.new.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"mrrMovements.new.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"mrrMovements.new.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"mrrMovements.new.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"mrrMovements.new.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"mrrMovements.new","typeLabel":"(object | null)[]"},"expansion":{"type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"mrrMovements.expansion.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"mrrMovements.expansion.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"mrrMovements.expansion.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"mrrMovements.expansion.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"mrrMovements.expansion.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"mrrMovements.expansion","typeLabel":"(object | null)[]"},"contraction":{"type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"mrrMovements.contraction.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"mrrMovements.contraction.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"mrrMovements.contraction.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"mrrMovements.contraction.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"mrrMovements.contraction.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"mrrMovements.contraction","typeLabel":"(object | null)[]"},"lost":{"type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"mrrMovements.lost.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"mrrMovements.lost.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"mrrMovements.lost.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"mrrMovements.lost.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"mrrMovements.lost.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"mrrMovements.lost","typeLabel":"(object | null)[]"},"resurrecting":{"type":"array","items":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"mrrMovements.resurrecting.items.[INDEX].oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"mrrMovements.resurrecting.items.[INDEX].oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"mrrMovements.resurrecting.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"mrrMovements.resurrecting.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"mrrMovements.resurrecting.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"mrrMovements.resurrecting","typeLabel":"(object | null)[]"}},"uniqueKey":"mrrMovements","typeLabel":"object"},"revenueBreakdown":{"type":"object","description":"Billed net revenue per month by class (net = gross − tax, after position discounts; credit notes negative).","properties":{"recurring":{"description":"Recurring positions (subscription charges).","type":"array","items":{"description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"revenueBreakdown.recurring.items.[INDEX].amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"revenueBreakdown.recurring.items.[INDEX].currency","typeLabel":"string"}},"type":"object","uniqueKey":"revenueBreakdown.recurring.items.[INDEX]","typeLabel":"object"},"uniqueKey":"revenueBreakdown.recurring","typeLabel":"object[]"},"oneOff":{"description":"Net (gross − tax, after position discounts) of the one-off positions of the documents finalized in the month: one-time prices of subscription items, manual positions, setup fees, and discounts without a parent position (dunning fees are other operating income, not revenue); credit notes and cancellations count negative.","type":"array","items":{"description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"revenueBreakdown.oneOff.items.[INDEX].amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"revenueBreakdown.oneOff.items.[INDEX].currency","typeLabel":"string"}},"type":"object","uniqueKey":"revenueBreakdown.oneOff.items.[INDEX]","typeLabel":"object"},"uniqueKey":"revenueBreakdown.oneOff","typeLabel":"object[]"},"variable":{"description":"Net (gross − tax, after position discounts) of the usage-based positions of the documents finalized in the month: usage quantities, metered measurements and percentage prices; credit notes and cancellations count negative.","type":"array","items":{"description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"revenueBreakdown.variable.items.[INDEX].amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"revenueBreakdown.variable.items.[INDEX].currency","typeLabel":"string"}},"type":"object","uniqueKey":"revenueBreakdown.variable.items.[INDEX]","typeLabel":"object"},"uniqueKey":"revenueBreakdown.variable","typeLabel":"object[]"},"total":{"description":"Sum of the three classes per month.","type":"array","items":{"description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"revenueBreakdown.total.items.[INDEX].amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"revenueBreakdown.total.items.[INDEX].currency","typeLabel":"string"}},"type":"object","uniqueKey":"revenueBreakdown.total.items.[INDEX]","typeLabel":"object"},"uniqueKey":"revenueBreakdown.total","typeLabel":"object[]"}},"uniqueKey":"revenueBreakdown","typeLabel":"object"},"receivablesTrend":{"description":"Outstanding receivables at each month end. Months after the current one carry the invoices open today forward (no payment assumed).","type":"array","items":{"description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"receivablesTrend.items.[INDEX].amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"receivablesTrend.items.[INDEX].currency","typeLabel":"string"}},"type":"object","uniqueKey":"receivablesTrend.items.[INDEX]","typeLabel":"object"},"uniqueKey":"receivablesTrend","typeLabel":"object[]"},"receivablesTrendOverdue":{"description":"Part of `receivablesTrend` overdue at each month end (due date before the last day of the month); the rest is not yet due.","type":"array","items":{"description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"receivablesTrendOverdue.items.[INDEX].amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"receivablesTrendOverdue.items.[INDEX].currency","typeLabel":"string"}},"type":"object","uniqueKey":"receivablesTrendOverdue.items.[INDEX]","typeLabel":"object"},"uniqueKey":"receivablesTrendOverdue","typeLabel":"object[]"},"ageing":{"type":"object","description":"Open invoices today by days past due.","properties":{"asOf":{"description":"The instant the ageing refers to (ISO 8601).","type":"string","format":"date-time","uniqueKey":"ageing.asOf","typeLabel":"string\u003cdate-time>"},"total":{"type":"object","description":"Open amount over all buckets.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"ageing.total.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"ageing.total.currency","typeLabel":"string"}},"uniqueKey":"ageing.total","typeLabel":"object"},"overdueTotal":{"type":"object","description":"Open amount past due (all buckets except `not_due`).","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"ageing.overdueTotal.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"ageing.overdueTotal.currency","typeLabel":"string"}},"uniqueKey":"ageing.overdueTotal","typeLabel":"object"},"buckets":{"description":"The five buckets in order: `not_due`, `1_30`, `31_60`, `61_90`, `over_90`.","type":"array","items":{"description":"One ageing bucket.","properties":{"key":{"description":"Bucket key.","type":"string","enum":["not_due","1_30","31_60","61_90","over_90"],"uniqueKey":"ageing.buckets.items.[INDEX].key","typeLabel":"enum\u003cstring>"},"amount":{"type":"object","description":"Open amount in the bucket.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"ageing.buckets.items.[INDEX].amount.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"ageing.buckets.items.[INDEX].amount.currency","typeLabel":"string"}},"uniqueKey":"ageing.buckets.items.[INDEX].amount","typeLabel":"object"},"invoiceCount":{"description":"Number of open invoices in the bucket.","type":"integer","uniqueKey":"ageing.buckets.items.[INDEX].invoiceCount","typeLabel":"integer"},"topCustomers":{"description":"The ten customers with the largest open amount in the bucket.","type":"array","items":{"description":"A customer's open amount in one ageing bucket.","properties":{"customer":{"type":"object","description":"The customer.","properties":{"id":{"oneOf":[{"description":"Id (UUID).","type":"string","uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].customer.id.oneOf.0","typeLabel":"string"},{"description":"Id (UUID).","type":"null","uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].customer.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].customer.id","typeLabel":"string | null"},"number":{"oneOf":[{"description":"Human-readable number (customer number, subscription number, invoice number).","type":"string","uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].customer.number.oneOf.0","typeLabel":"string"},{"description":"Human-readable number (customer number, subscription number, invoice number).","type":"null","uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].customer.number.oneOf.1","typeLabel":"null"}],"uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].customer.number","typeLabel":"string | null"},"name":{"oneOf":[{"description":"Display name.","type":"string","uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].customer.name.oneOf.0","typeLabel":"string"},{"description":"Display name.","type":"null","uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].customer.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].customer.name","typeLabel":"string | null"}},"uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].customer","typeLabel":"object"},"amount":{"type":"object","description":"Open amount of the customer in the bucket.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].amount.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].amount.currency","typeLabel":"string"}},"uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].amount","typeLabel":"object"},"invoiceCount":{"description":"Number of the customer's open invoices in the bucket.","type":"integer","uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX].invoiceCount","typeLabel":"integer"}},"type":"object","uniqueKey":"ageing.buckets.items.[INDEX].topCustomers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ageing.buckets.items.[INDEX].topCustomers","typeLabel":"object[]"}},"type":"object","uniqueKey":"ageing.buckets.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ageing.buckets","typeLabel":"object[]"},"over365":{"type":"object","description":"Part of `over_90` more than 365 days past due (\"davon über 365 Tage\"): claims that need a value adjustment and approach the limitation period.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"ageing.over365.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"ageing.over365.currency","typeLabel":"string"}},"uniqueKey":"ageing.over365","typeLabel":"object"}},"uniqueKey":"ageing","typeLabel":"object"},"receivablesTable":{"type":"object","description":"Receivables table: per invoice month the billed amounts, the status of those invoices today, cash in and out, and the outstanding amount at the month end.","properties":{"rows":{"description":"Series per row key: `billed_gross`, `billed_net` (invoices finalized in the month; credit notes and cancellations are not rows, they reduce the invoice they reference through `status_credited`); status of those invoices today, mutually exclusive and adding up to `billed_gross`: `status_paid` (paid through payment transactions), `status_settled` (settled without a payment transaction, e.g. customer balance), `status_open` (open, not yet due), `status_overdue`, `status_credited` (credited or cancelled), `status_written_off`; `status_total` (\"Summe Status\": the sum of the six status buckets, equal to `billed_gross`); `billed_after_credits` (\"Rechnungsbetrag nach Gutschriften und Stornos\": `billed_gross − status_credited`); `status_overpaid` (\"Überzahlt\": paid above the gross, e.g. an invoice paid twice; NOT one of the buckets, they still add up to `billed_gross`); `cash_in_for_month` (\"Bezahlt bis heute (Rechnungen dieses Monats)\": every payment for the invoices of the month, whatever its payment date, as of today; shown with the status rows); `cash_in` / `cash_out` (\"Zahlungseingang\" / \"Zahlungsausgang\": payments in and money out by payment date, all invoices, not comparable with the status rows); `cash_out` split by kind, adding up to it: `cash_refunded_refund` (refunds), `cash_refunded_chargeback` (chargebacks), `cash_refunded_payout` (payouts of customer balances), `cash_refunded_return_fee` (\"Rücklastschrift-Gebühren\": bank fees of return debits without a return case, not part of the invoice); `cash_in` split by the invoice the money pays, adding up to `cash_in`: `cash_collected_this_month` (for invoices finalized in the same month), `cash_collected_other_months` (for invoices of other months), `cash_collected_unassigned` (no finalized invoice: top-ups, prepayments, the part above the gross of an overpaid invoice), `cash_collected_refund_returned` (\"Erstattung zurückgekommen\"); `cash_corrections` (\"Korrekturen\": refunds entered by hand and cancelled by a counter-entry, outside `cash_in` and `cash_out`) with `cash_corrections_reversed` (\"storniert\") and `cash_corrections_counter` (\"Gegenbuchung\", negative); `outstanding_eop` (open at the month end; months after the current one carry the invoices open today forward, no payment assumed), split into `outstanding_not_due_eop` (\"Offen\": due date on or after the last day of the month) and `outstanding_overdue_eop` (\"Überfällig\" at the month end); `owed_to_customers` (\"Guthaben an Kunden\": at the month end, what customers paid above what their invoices still claim, e.g. a paid invoice credited without a refund, neither refunded nor moved to the customer balance; never netted with `outstanding_eop`); invoice forecast, separate from the real buckets: `forecast_billed_gross`, `forecast_billed_net` (the invoices the billing forecast expects in the month; 0 for elapsed months).","type":"object","additionalProperties":{"type":"array","items":{"description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"receivablesTable.rows.additionalProperties.items.[INDEX].amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"receivablesTable.rows.additionalProperties.items.[INDEX].currency","typeLabel":"string"}},"type":"object","uniqueKey":"receivablesTable.rows.additionalProperties.items.[INDEX]","typeLabel":"object"},"uniqueKey":"receivablesTable.rows.additionalProperties","typeLabel":"object[]"},"uniqueKey":"receivablesTable.rows","typeLabel":"object"},"totals":{"description":"Total column: sums over the range, `outstanding_eop`, `outstanding_not_due_eop`, `outstanding_overdue_eop` and `owed_to_customers` = the last month.","type":"object","additionalProperties":{"description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"receivablesTable.totals.additionalProperties.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"receivablesTable.totals.additionalProperties.currency","typeLabel":"string"}},"type":"object","uniqueKey":"receivablesTable.totals.additionalProperties","typeLabel":"object"},"uniqueKey":"receivablesTable.totals","typeLabel":"object"},"forecastInvoiceCount":{"description":"Number of forecast invoices per month (aligned with `months`).","type":"array","items":{"type":"integer","uniqueKey":"receivablesTable.forecastInvoiceCount.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"receivablesTable.forecastInvoiceCount","typeLabel":"integer[]"}},"uniqueKey":"receivablesTable","typeLabel":"object"},"totals":{"description":"Totals over the range: `cash_collected`, `cash_refunded`, `cash_net` (elapsed and current months), `cash_forecast` (invoice forecast, gross, current and later months), `recurring`, `one_off`, `variable`, `revenue_total`, `new`, `expansion`, `contraction`, `lost`, `resurrecting` (contraction and lost negative).","type":"object","additionalProperties":{"oneOf":[{"type":"object","description":"A money amount. `amount` is an exact decimal string with two decimal places (net, excluding VAT, unless stated otherwise); `currency` is the ISO-4217 code.","properties":{"amount":{"description":"Exact decimal amount with two decimal places, dot as separator. Negative amounts carry a leading minus.","type":"string","example":"1234.56","uniqueKey":"totals.additionalProperties.oneOf.0.amount","typeLabel":"string"},"currency":{"description":"ISO-4217 currency code.","type":"string","example":"EUR","uniqueKey":"totals.additionalProperties.oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"totals.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"totals.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"totals.additionalProperties","typeLabel":"object | null"},"uniqueKey":"totals","typeLabel":"object"},"meta":{"type":"object","description":"Calculation time, effective scope and currency, finding counts, datasets that ignore the filter.","properties":{"asOf":{"oneOf":[{"description":"When the figures were last calculated (ISO 8601). Null when no calculation exists yet.","type":"string","format":"date-time","uniqueKey":"meta.asOf.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"When the figures were last calculated (ISO 8601). Null when no calculation exists yet.","type":"null","format":"date-time","uniqueKey":"meta.asOf.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.asOf","typeLabel":"string\u003cdate-time> | null"},"buildId":{"oneOf":[{"description":"Id of the calculation the figures come from. Null when no calculation exists yet.","type":"string","uniqueKey":"meta.buildId.oneOf.0","typeLabel":"string"},{"description":"Id of the calculation the figures come from. Null when no calculation exists yet.","type":"null","uniqueKey":"meta.buildId.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.buildId","typeLabel":"string | null"},"scope":{"description":"Effective movement scope: the level on which new, expansion, contraction, lost and resurrecting are classified.","type":"string","enum":["subscription","invoice_address","customer","organisation"],"example":"invoice_address","uniqueKey":"meta.scope","typeLabel":"enum\u003cstring>"},"currency":{"description":"Effective currency (ISO-4217). Amounts are never converted between currencies.","type":"string","example":"EUR","uniqueKey":"meta.currency","typeLabel":"string"},"from":{"description":"First month of the range (YYYY-MM, time zone of the organisation).","type":"string","example":"2025-10","uniqueKey":"meta.from","typeLabel":"string"},"to":{"description":"Last month of the range (YYYY-MM, time zone of the organisation).","type":"string","example":"2026-09","uniqueKey":"meta.to","typeLabel":"string"},"findings":{"type":"object","description":"Number of data-quality findings of the calculation.","properties":{"error":{"description":"Findings that point at wrong numbers.","type":"integer","example":0,"uniqueKey":"meta.findings.error","typeLabel":"integer"},"warning":{"description":"Findings that point at data that should be checked.","type":"integer","example":3,"uniqueKey":"meta.findings.warning","typeLabel":"integer"},"info":{"description":"Informational findings.","type":"integer","example":12,"uniqueKey":"meta.findings.info","typeLabel":"integer"}},"uniqueKey":"meta.findings","typeLabel":"object"},"filtersNotApplied":{"description":"Datasets of this response that ignore the customer, product or segment filter because the underlying facts have no such dimension (for example receivables at past month ends).","type":"array","items":{"type":"string","uniqueKey":"meta.filtersNotApplied.items.[INDEX]","typeLabel":"string"},"uniqueKey":"meta.filtersNotApplied","typeLabel":"string[]"},"notSnapshotted":{"description":"MRR table rows a month-end snapshot does not hold (invoice, cash and forecast figures). In the snapshot view they keep their current values. Empty when the range has no snapshot or a segment is applied.","type":"array","items":{"type":"string","uniqueKey":"meta.notSnapshotted.items.[INDEX]","typeLabel":"string"},"example":["one_off","accounted_mrr","cash_collected"],"uniqueKey":"meta.notSnapshotted","typeLabel":"string[]"},"projectedFrom":{"oneOf":[{"description":"First month of the range after the current one (YYYY-MM): from there the month-end stocks (open receivables, amounts owed to customers) carry today's open invoices forward, a projection as of today (\"Prognose (Stand heute)\"), not a fact. Null when the range ends in or before the current month.","type":"string","example":"2026-10","uniqueKey":"meta.projectedFrom.oneOf.0","typeLabel":"string"},{"description":"First month of the range after the current one (YYYY-MM): from there the month-end stocks (open receivables, amounts owed to customers) carry today's open invoices forward, a projection as of today (\"Prognose (Stand heute)\"), not a fact. Null when the range ends in or before the current month.","type":"null","example":"2026-10","uniqueKey":"meta.projectedFrom.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.projectedFrom","typeLabel":"string | null"},"forecast":{"type":"object","description":"Completeness of the invoice forecast (\"Rechnungsprognose\") in the range: `incomplete` with the number of subscriptions whose forecast failed. The forecast rows then show what the other subscriptions bring; they are marked \"unvollständig\", never read as 0.","properties":{"incomplete":{"description":"True when the forecast of at least one subscription failed and the range contains forecast months (the current month or later).","type":"boolean","example":false,"uniqueKey":"meta.forecast.incomplete","typeLabel":"boolean"},"failedSubscriptions":{"description":"Number of subscriptions whose billing forecast failed (0 when complete).","type":"integer","example":0,"uniqueKey":"meta.forecast.failedSubscriptions","typeLabel":"integer"}},"uniqueKey":"meta.forecast","typeLabel":"object"},"build":{"oneOf":[{"type":"object","description":"The latest calculation attempt, also when it failed (\"Berechnung abgebrochen\"). Null when the organisation was never calculated.","properties":{"status":{"description":"Outcome of the attempt: `succeeded`, or `failed` when it broke a consistency check and was cancelled (nothing of it was stored).","type":"string","enum":["succeeded","failed"],"example":"failed","uniqueKey":"meta.build.oneOf.0.status","typeLabel":"enum\u003cstring>"},"builtAt":{"description":"When the attempt started (ISO 8601).","type":"string","format":"date-time","uniqueKey":"meta.build.oneOf.0.builtAt","typeLabel":"string\u003cdate-time>"},"buildId":{"description":"Id of the attempt. Equal to `meta.dataBuildId` when it succeeded.","type":"string","uniqueKey":"meta.build.oneOf.0.buildId","typeLabel":"string"},"failed":{"oneOf":[{"type":"object","description":"The broken checks; null unless `status` is `failed`.","properties":{"invariants":{"description":"Codes of the broken checks (sorted), e.g. `CASH_WITHIN_DOCUMENT`; `IDENTITY` for the MRR identity.","type":"array","items":{"type":"string","uniqueKey":"meta.build.oneOf.0.failed.oneOf.0.invariants.items.[INDEX]","typeLabel":"string"},"example":["CASH_WITHIN_DOCUMENT"],"uniqueKey":"meta.build.oneOf.0.failed.oneOf.0.invariants","typeLabel":"string[]"},"rowCount":{"description":"Number of rows that broke a check (complete, also above the listed rows).","type":"integer","example":5,"uniqueKey":"meta.build.oneOf.0.failed.oneOf.0.rowCount","typeLabel":"integer"},"invoiceRowCount":{"description":"Number of the listed rows that name an invoice. Equal to `rowCount` when every row is an invoice.","type":"integer","example":5,"uniqueKey":"meta.build.oneOf.0.failed.oneOf.0.invoiceRowCount","typeLabel":"integer"}},"uniqueKey":"meta.build.oneOf.0.failed.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"meta.build.oneOf.0.failed.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.build.oneOf.0.failed","typeLabel":"object | null"}},"uniqueKey":"meta.build.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"meta.build.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.build","typeLabel":"object | null"},"dataBuildId":{"oneOf":[{"description":"Id of the calculation the figures come from (the last successful one). Differs from `build.buildId` when the latest attempt failed. Null when no calculation exists yet.","type":"string","uniqueKey":"meta.dataBuildId.oneOf.0","typeLabel":"string"},{"description":"Id of the calculation the figures come from (the last successful one). Differs from `build.buildId` when the latest attempt failed. Null when no calculation exists yet.","type":"null","uniqueKey":"meta.dataBuildId.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.dataBuildId","typeLabel":"string | null"}},"uniqueKey":"meta","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"months":["\u003cstring>"],"cashflow":{"collected":[{"amount":"1234.56","currency":"EUR"}],"refunded":[{"amount":"1234.56","currency":"EUR"}],"net":[{"amount":"1234.56","currency":"EUR"}],"totals":{},"forecastBilled":[{"amount":"1234.56","currency":"EUR"}],"collectedThisMonth":[{"amount":"1234.56","currency":"EUR"}],"collectedOtherMonths":[{"amount":"1234.56","currency":"EUR"}],"collectedUnassigned":[{"amount":"1234.56","currency":"EUR"}],"refundedRefund":[{"amount":"1234.56","currency":"EUR"}],"refundedChargeback":[{"amount":"1234.56","currency":"EUR"}],"refundedPayout":[{"amount":"1234.56","currency":"EUR"}],"collectedRefundReturned":[{"amount":"1234.56","currency":"EUR"}],"corrections":[{"amount":"1234.56","currency":"EUR"}],"correctionsReversed":[{"amount":"1234.56","currency":"EUR"}],"correctionsCounter":[{"amount":"1234.56","currency":"EUR"}],"correctionCount":[123],"refundedReturnFee":[{"amount":"1234.56","currency":"EUR"}]},"mrrMovements":{"new":[{"amount":"1234.56","currency":"EUR"}],"expansion":[{"amount":"1234.56","currency":"EUR"}],"contraction":[{"amount":"1234.56","currency":"EUR"}],"lost":[{"amount":"1234.56","currency":"EUR"}],"resurrecting":[{"amount":"1234.56","currency":"EUR"}]},"revenueBreakdown":{"recurring":[{"amount":"1234.56","currency":"EUR"}],"oneOff":[{"amount":"1234.56","currency":"EUR"}],"variable":[{"amount":"1234.56","currency":"EUR"}],"total":[{"amount":"1234.56","currency":"EUR"}]},"receivablesTrend":[{"amount":"1234.56","currency":"EUR"}],"receivablesTrendOverdue":[{"amount":"1234.56","currency":"EUR"}],"ageing":{"asOf":"2023-11-07T05:31:56Z","total":{"amount":"1234.56","currency":"EUR"},"overdueTotal":{"amount":"1234.56","currency":"EUR"},"buckets":[{"key":"not_due","amount":{"amount":"1234.56","currency":"EUR"},"invoiceCount":123,"topCustomers":[{"customer":{"id":"\u003cstring>","number":"\u003cstring>","name":"\u003cstring>"},"amount":{"amount":"1234.56","currency":"EUR"},"invoiceCount":123}]}],"over365":{"amount":"1234.56","currency":"EUR"}},"receivablesTable":{"rows":{},"totals":{},"forecastInvoiceCount":[123]},"totals":{},"meta":{"asOf":"2023-11-07T05:31:56Z","buildId":"\u003cstring>","scope":"invoice_address","currency":"EUR","from":"2025-10","to":"2026-09","findings":{"error":0,"warning":3,"info":12},"filtersNotApplied":["\u003cstring>"],"notSnapshotted":["one_off","accounted_mrr","cash_collected"],"projectedFrom":"2026-10","forecast":{"incomplete":false,"failedSubscriptions":0},"build":{"status":"failed","builtAt":"2023-11-07T05:31:56Z","buildId":"\u003cstring>","failed":{"invariants":["CASH_WITHIN_DOCUMENT"],"rowCount":5,"invoiceRowCount":5}},"dataBuildId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7a61d710-25fc-4c1d-a5fb-fdc31987bea8":{"description":"Missing or invalid authentication.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"ce6372ac-dd7c-4991-a0d3-1ca892aef4af":{"description":"Missing permission `analytics:read` (`FRAMEWORK__ACCESS_DENIED`), or the finance reports are not enabled for the organisation (feature flag `analytics.advanced`, `type` https://fynn.dev/problems/feature-not-available).","content":{"application/problem+json":{"schema":{"oneOf":[{"type":"object","description":"Error body (problem+json). `type` is the error key, e.g. `ANALYTICS_MRR_FINANCIALS__SNAPSHOT_MONTH_NOT_ENDED`; further keys carry the parameters of the error.","required":["status","type","title","detail"],"properties":{"status":{"type":"integer","example":409,"isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"integer"},"type":{"type":"string","example":"ANALYTICS_MRR_FINANCIALS__SNAPSHOT_MONTH_NOT_ENDED","isRequired":true,"uniqueKey":"oneOf.0.type","typeLabel":"string"},"title":{"type":"string","example":"An error occurred","isRequired":true,"uniqueKey":"oneOf.0.title","typeLabel":"string"},"detail":{"type":"string","description":"German sentence that can be shown to the user.","isRequired":true,"uniqueKey":"oneOf.0.detail","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"403 body when the finance reports are not enabled for the organisation (feature flag `analytics.advanced`).","required":["type","title","detail","featureFlags"],"properties":{"type":{"type":"string","enum":["https://fynn.dev/problems/feature-not-available"],"isRequired":true,"uniqueKey":"oneOf.1.type","typeLabel":"enum\u003cstring>"},"title":{"type":"string","example":"Feature not available","isRequired":true,"uniqueKey":"oneOf.1.title","typeLabel":"string"},"detail":{"type":"string","example":"The requested feature is not available. Please contact customer support.","isRequired":true,"uniqueKey":"oneOf.1.detail","typeLabel":"string"},"featureFlags":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.featureFlags.items.[INDEX]","typeLabel":"string"},"example":["analytics.advanced"],"isRequired":true,"uniqueKey":"oneOf.1.featureFlags","typeLabel":"string[]"}},"additionalProperties":true,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":409,"type":"ANALYTICS_MRR_FINANCIALS__SNAPSHOT_MONTH_NOT_ENDED","title":"An error occurred","detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"9aa7a423-0719-4c77-84d6-0b084736ef8e":{"description":"Invalid query parameter. The body lists the offending parameters in `violations` (`propertyPath`, `message`, `code`).","content":{"application/problem+json":{"schema":{"type":"object","description":"422 body: one entry per rejected field in `violations`.","properties":{"status":{"type":"integer","example":422,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","example":"https://tools.ietf.org/html/rfc2616#section-10","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","example":"to","isRequired":true,"uniqueKey":"violations.items.[INDEX].propertyPath","typeLabel":"string"},"message":{"type":"string","example":"Der Zeitraum darf höchstens 36 Monate umfassen.","isRequired":true,"uniqueKey":"violations.items.[INDEX].message","typeLabel":"string"},"code":{"type":"string","example":"analytics.mrr_financials.range_too_long","isRequired":true,"uniqueKey":"violations.items.[INDEX].code","typeLabel":"string"}},"required":["propertyPath","message","code"],"uniqueKey":"violations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"violations","typeLabel":"object[]"},"title":{"type":"string","example":"Validation Failed","uniqueKey":"title","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"}},"required":["status","type","violations"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":422,"type":"https://tools.ietf.org/html/rfc2616#section-10","violations":[{"propertyPath":"to","message":"Der Zeitraum darf höchstens 36 Monate umfassen.","code":"analytics.mrr_financials.range_too_long"}],"title":"Validation Failed","detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"93252035-0f05-4ae1-856f-35859bfff132":{"ApiToken":{"type":"http","scheme":"bearer","description":"API token of the organisation. Send it as Authorization: Bearer api_... The token is bound to exactly one organisation.","scopes":[],"schemeName":"ApiToken"}}},"servers":{"58ca1bf5-c883-4c98-a975-3a85f96f2f94":{"url":"https://coreapi.io","description":"Production"},"761f9cb6-1d17-4197-9e03-b79594029e5c":{"url":"https://preview.coreapi.io","description":"Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API token of the organisation. Send it as Authorization: Bearer api_... The token is bound to exactly one organisation.","scopes":[],"schemeName":"ApiToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API token of the organisation. Send it as Authorization: Bearer api_... The token is bound to exactly one organisation.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiToken","name":"Authorization"}],"title":"ApiToken"}]},"originalFileLocation":"assets/openapi-v2-finance.json"},"subdomain":"fynnsubscriptionbilling","siteName":"Fynn Docs","title":"Finance overview datasets - Fynn Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"de":{"href":"/v2-finance-api/datasets/get-overview","matchLevel":0},"en":{"href":"/en/introduction","matchLevel":4}}},"lastModified":"2026-10-25T20:26:34.052Z","originalFileLocation":"v2-finance-api/datasets/get-overview.mdx","locale":"de"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Cash flow (collected counts settled payments with status captured, booked, refunded or partial_refunded, by payment date), MRR movements (signed), billed net revenue by class (net = gross − tax after position discounts, credit notes negative), outstanding receivables at each month end, ageing of the invoices open today, and the receivables table. One currency, never converted. Cash and receivables have no product dimension: a product filter does not narrow them (meta.filtersNotApplied). Required permission: analytics:read.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fynn Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Finance overview datasets - Fynn Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cash flow (collected counts settled payments with status captured, booked, refunded or partial_refunded, by payment date), MRR movements (signed), billed net revenue by class (net = gross − tax after position discounts, credit notes negative), outstanding receivables at each month end, ageing of the invoices open today, and the receivables table. One currency, never converted. Cash and receivables have no product dimension: a product filter does not narrow them (meta.filtersNotApplied). Required permission: analytics:read.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fynn Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fynn.eu/v2-finance-api/datasets/get-overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fynnsubscriptionbilling.mintlify.app/_mintlify/api/og/v2?division=Datens%C3%A4tze\u0026amp;title=Finance+overview+datasets\u0026amp;description=Cash+flow+%28collected+counts+settled+payments+with+status+captured%2C+booked%2C+refunded+or+partial_refunded%2C+by+payment+date%29%2C+MRR+movements+%28signed%29%2C+billed+net+re\u0026amp;theme=4b76c1a49202070b198dd6e7\u0026amp;signature=25e646734466278b3b7095595761f55e6fa82c2de9ca812e345294e141947b98\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Finance overview datasets - Fynn Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cash flow (collected counts settled payments with status captured, booked, refunded or partial_refunded, by payment date), MRR movements (signed), billed net revenue by class (net = gross − tax after position discounts, credit notes negative), outstanding receivables at each month end, ageing of the invoices open today, and the receivables table. One currency, never converted. Cash and receivables have no product dimension: a product filter does not narrow them (meta.filtersNotApplied). Required permission: analytics:read.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fynnsubscriptionbilling.mintlify.app/_mintlify/api/og/v2?division=Datens%C3%A4tze\u0026amp;title=Finance+overview+datasets\u0026amp;description=Cash+flow+%28collected+counts+settled+payments+with+status+captured%2C+booked%2C+refunded+or+partial_refunded%2C+by+payment+date%29%2C+MRR+movements+%28signed%29%2C+billed+net+re\u0026amp;theme=4b76c1a49202070b198dd6e7\u0026amp;signature=25e646734466278b3b7095595761f55e6fa82c2de9ca812e345294e141947b98\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fynn Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fynn.eu/v2-finance-api/datasets/get-overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v2-finance-api/datasets/get-overview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fynn.eu/#organization\",\"name\":\"Fynn Docs\",\"url\":\"https://docs.fynn.eu\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fynnsubscriptionbilling/kPbBeWVEZfmEic9q/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=kPbBeWVEZfmEic9q\u0026q=85\u0026s=83e4b30a53d77c3809e0f22afa29335d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fynn.eu#website\",\"name\":\"Fynn Docs\",\"url\":\"https://docs.fynn.eu\",\"publisher\":{\"@id\":\"https://docs.fynn.eu/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fynn.eu/v2-finance-api/datasets/get-overview#webpage\",\"url\":\"https://docs.fynn.eu/v2-finance-api/datasets/get-overview\",\"name\":\"Finance overview datasets\",\"description\":\"Cash flow (collected counts settled payments with status captured, booked, refunded or partial_refunded, by payment date), MRR movements (signed), billed net revenue by class (net = gross − tax after position discounts, credit notes negative), outstanding receivables at each month end, ageing of the invoices open today, and the receivables table. One currency, never converted. Cash and receivables have no product dimension: a product filter does not narrow them (meta.filtersNotApplied). Required permission: analytics:read.\",\"dateModified\":\"2026-10-25T20:26:34.052Z\",\"isPartOf\":{\"@id\":\"https://docs.fynn.eu#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fynn.eu/v2-finance-api/datasets/get-overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fynn.eu/v2-finance-api/datasets/get-overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Finanzberichte\",\"item\":\"https://docs.fynn.eu/v2-finance-api/concepts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API\",\"item\":\"https://docs.fynn.eu/v2-finance-api/datasets/get-recurring\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Datensätze\",\"item\":\"https://docs.fynn.eu/v2-finance-api/datasets/get-recurring\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Finance overview datasets\",\"item\":\"https://docs.fynn.eu/v2-finance-api/datasets/get-overview\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fynn.eu/v2-finance-api/datasets/get-overview#apireference\",\"headline\":\"Finance overview datasets\",\"name\":\"Finance overview datasets\",\"description\":\"Cash flow (collected counts settled payments with status captured, booked, refunded or partial_refunded, by payment date), MRR movements (signed), billed net revenue by class (net = gross − tax after position discounts, credit notes negative), outstanding receivables at each month end, ageing of the invoices open today, and the receivables table. One currency, never converted. Cash and receivables have no product dimension: a product filter does not narrow them (meta.filtersNotApplied). Required permission: analytics:read.\",\"url\":\"https://docs.fynn.eu/v2-finance-api/datasets/get-overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fynn.eu/v2-finance-api/datasets/get-overview#webpage\"},\"dateModified\":\"2026-10-25T20:26:34.052Z\",\"publisher\":{\"@id\":\"https://docs.fynn.eu/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fynn.eu#website\"}}]}\u003c/script>","siteName":"Fynn Docs","nav":{"global":null,"languages":[{"language":"de","default":true,"tabs":[{"tab":"Dokumentation","pages":[{"title":"Dokumentation","href":"/introduction"}]},{"tab":"Integrationen","pages":[{"title":"Integrationen","href":"/integrations/overview"}]},{"tab":"API Referenz","pages":[{"title":"API Referenz","href":"/api-reference/introduction"}]},{"tab":"API V2","groups":[{"group":"Einführung","icon":"compass","pages":[{"title":"Fynn API V2","sidebarTitle":"Einführung","icon":"compass","href":"/v2-plans-api/introduction"}]},{"group":"Grundlagen","icon":"cube","pages":[{"title":"Authentifizierung","sidebarTitle":"Authentifizierung","icon":"key","href":"/v2-plans-api/authentication"},{"title":"Asynchrone Abrechnung","sidebarTitle":"Asynchrone Abrechnung","icon":"receipt","href":"/v2-plans-api/billing"}]},{"group":"Pläne","icon":"layer-group","pages":[{"title":"Schnellstart","sidebarTitle":"Schnellstart","icon":"rocket","href":"/v2-plans-api/quickstart"},{"title":"Kernkonzepte","sidebarTitle":"Kernkonzepte","icon":"book","href":"/v2-plans-api/concepts"},{"title":"Up- und Downgrades","sidebarTitle":"Up- und Downgrades","icon":"arrow-up-arrow-down","href":"/v2-plans-api/upgrades-downgrades"},{"title":"Checkout","sidebarTitle":"Checkout","icon":"cart-shopping","href":"/v2-plans-api/checkout-and-sales-channels"},{"group":"API","pages":[{"group":"Plan-Verwaltung","pages":[{"openapi":"get /api/plans","title":"List plans","href":"/v2-plans-api/plans/list-plans"},{"openapi":"post /api/plans","title":"Create a plan","href":"/v2-plans-api/plans/create-plan"},{"openapi":"get /api/plans/{id}","title":"Retrieve a plan","href":"/v2-plans-api/plans/get-plan"},{"openapi":"put /api/plans/{id}","title":"Update a plan","href":"/v2-plans-api/plans/update-plan"},{"openapi":"post /api/plans/{id}/activate","title":"Activate a plan","href":"/v2-plans-api/plans/activate-plan"},{"openapi":"delete /api/plans/{id}","title":"Delete or archive a plan","href":"/v2-plans-api/plans/delete-plan"}]},{"group":"Checkout-Links","pages":[{"openapi":"post /api/plans/{id}/checkout-links","title":"Create a checkout link","href":"/v2-plans-api/checkout-links/create-checkout-link"},{"openapi":"get /api/plans/{id}/checkout-links","title":"List checkout links of a plan","href":"/v2-plans-api/checkout-links/list-checkout-links"}]},{"group":"Tarifwechsel","pages":[{"openapi":"get /api/customer/subscriptions/{id}/plan-options","title":"Get plan switch options","href":"/v2-plans-api/customer/plan-options"},{"openapi":"post /api/customer/subscriptions/{id}/plan-tier-preview","title":"Preview a tier switch","href":"/v2-plans-api/customer/preview-plan-tier-switch"},{"openapi":"post /api/customer/subscriptions/{id}/switch-plan-tier","title":"Switch the plan tier","href":"/v2-plans-api/customer/switch-plan-tier"}]}]}]},{"group":"Angebote","icon":"file-signature","pages":[{"title":"Angebote","sidebarTitle":"Einführung","icon":"file-signature","href":"/v2-offers-api/introduction"},{"title":"Schnellstart","sidebarTitle":"Schnellstart","icon":"rocket","href":"/v2-offers-api/quickstart"},{"title":"Kernkonzepte","sidebarTitle":"Kernkonzepte","icon":"book","href":"/v2-offers-api/concepts"},{"title":"Der Angebots-Editor","sidebarTitle":"Der Editor","icon":"pen-ruler","href":"/v2-offers-api/editor"},{"title":"Die Angebots-Ansicht","sidebarTitle":"Angebots-Ansicht","icon":"eye","href":"/v2-offers-api/angebots-ansicht"},{"title":"Annahme und Signatur","sidebarTitle":"Annahme und Signatur","icon":"file-signature","href":"/v2-offers-api/acceptance-and-signing"},{"title":"Rechnungsdaten","sidebarTitle":"Rechnungsdaten","icon":"receipt","href":"/v2-offers-api/billing-details"},{"title":"Veröffentlichen und Empfänger","sidebarTitle":"Veröffentlichen","icon":"paper-plane","href":"/v2-offers-api/sending-and-recipients"},{"title":"Freigaben","sidebarTitle":"Freigaben","icon":"circle-check","href":"/v2-offers-api/freigaben"},{"title":"Einstellungen","sidebarTitle":"Einstellungen","icon":"gear","href":"/v2-offers-api/settings"},{"title":"Authentifizierung","sidebarTitle":"Authentifizierung","icon":"key","href":"/v2-offers-api/authentication"},{"title":"Webhooks","sidebarTitle":"Webhooks","icon":"bell","href":"/v2-offers-api/webhooks"},{"group":"API","pages":[{"group":"Angebote","pages":[{"openapi":"assets/openapi-v2-offers.json get /offers","title":"List offers","href":"/v2-offers-api/offers/list-offers"},{"openapi":"assets/openapi-v2-offers.json get /api/offers/{id}","title":"Get an offer","href":"/v2-offers-api/offers/get-offer"},{"openapi":"assets/openapi-v2-offers.json put /offers/{id}","title":"Update an offer","href":"/v2-offers-api/offers/update-offer"},{"openapi":"assets/openapi-v2-offers.json get /offers/{id}/document","title":"Download an offer as PDF","href":"/v2-offers-api/offers/download-offer"},{"openapi":"assets/openapi-v2-offers.json post /api/offers/{id}/publish","title":"Publish an offer","href":"/v2-offers-api/offers/publish-offer"},{"openapi":"assets/openapi-v2-offers.json post /api/offers/{id}/accept","title":"Accept an offer manually","href":"/v2-offers-api/offers/accept-offer"},{"openapi":"assets/openapi-v2-offers.json post /offers/{id}/cancel-signing","title":"Cancel a signing process","href":"/v2-offers-api/offers/cancel-signing"},{"openapi":"assets/openapi-v2-offers.json post /offers/{id}/recipients","title":"Add a recipient","href":"/v2-offers-api/offers/add-recipient"},{"openapi":"assets/openapi-v2-offers.json get /api/offers/{id}/activities","title":"List offer activity","href":"/v2-offers-api/offers/list-activities"},{"openapi":"assets/openapi-v2-offers.json delete /offers/{id}","title":"Archive an offer","href":"/v2-offers-api/offers/archive-offer"}]},{"group":"Freigabe","pages":[{"openapi":"assets/openapi-v2-offers.json get /api/offers/{id}/approval","title":"Get the approval state","href":"/v2-offers-api/approval/get-approval"},{"openapi":"assets/openapi-v2-offers.json post /api/offers/{id}/approval/approve","title":"Approve a pending request","href":"/v2-offers-api/approval/approve"},{"openapi":"assets/openapi-v2-offers.json post /api/offers/{id}/approval/reject","title":"Reject a pending request","href":"/v2-offers-api/approval/reject"},{"openapi":"assets/openapi-v2-offers.json post /api/offers/{id}/approval/cancel","title":"Cancel a pending request","href":"/v2-offers-api/approval/cancel-approval"}]}]}]},{"group":"Finanzberichte","icon":"chart-line","pages":[{"title":"Finanzberichte: Konzepte","sidebarTitle":"Konzepte","icon":"book","href":"/v2-finance-api/concepts"},{"title":"Datensätze","sidebarTitle":"Datensätze","icon":"table","href":"/v2-finance-api/datasets"},{"title":"Drill-downs","sidebarTitle":"Drill-downs","icon":"magnifying-glass","href":"/v2-finance-api/drill-downs"},{"title":"Snapshots","sidebarTitle":"Snapshots","icon":"lock","href":"/v2-finance-api/snapshots"},{"title":"Excel-Exporte","sidebarTitle":"Excel-Exporte","icon":"file-excel","href":"/v2-finance-api/excel"},{"title":"Fehler","sidebarTitle":"Fehler","icon":"triangle-exclamation","href":"/v2-finance-api/errors"},{"title":"Definitionen","sidebarTitle":"Definitionen","icon":"book-open","href":"/v2-finance-api/definitions"},{"group":"API","pages":[{"group":"Datensätze","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/recurring","title":"Recurring revenue page datasets","href":"/v2-finance-api/datasets/get-recurring"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/customers","title":"Customer base page datasets","href":"/v2-finance-api/datasets/get-customers"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/liquidity","title":"Liquidity page datasets","href":"/v2-finance-api/datasets/get-liquidity"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/revenue","title":"Revenue page datasets","href":"/v2-finance-api/datasets/get-revenue"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/revenue/customers","title":"Revenue per customer, paged","description":"Customers with billed net revenue in the range (all classes; net = gross − tax after position discounts, credit notes negative), ranked by net revenue (descending; equal amounts by customer id), each with product sub-rows and a 12-month sparkline ending with the last month of the range. Same filters as the revenue datasets.\n\nRequired permission: `analytics:read`.","href":"/v2-finance-api/datasets/get-revenue-customers"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/overview","title":"Finance overview datasets","href":"/v2-finance-api/datasets/get-overview"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials","title":"MRR financials table","description":"Monthly recurring revenue (MRR) at the start and end of every month, its movements (new, expansion, contraction, lost, resurrecting) with their reasons, ARR, revenue churn rate, month-over-month growth, non-recurring revenue (one-off and variable, net), cash collected and refunded, and outstanding receivables at the month end. One currency per response, never converted. MRR is the monthly-normalized recurring net amount the contracts entitle to at the last second of the month (time zone of the organisation). Non-recurring revenue is net = gross − tax of the finalized invoice positions (after position discounts), by finalization month; credit notes are negative. Collected cash counts settled payments (status captured, booked, refunded, partial_refunded) by payment date; refunds count separately. The figures come from the latest calculation (`meta.asOf`).\n\nRequired permission: `analytics:read`.","href":"/v2-finance-api/datasets/get-mrr-table"}]},{"group":"Drill-downs und Hinweise","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/details","title":"Lines behind one cell of the finance tables","href":"/v2-finance-api/drill-downs/get-details"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/findings","title":"Data-quality findings of the MRR calculation","href":"/v2-finance-api/drill-downs/list-findings"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/findings/{id}","title":"One data-quality finding with its explanation","href":"/v2-finance-api/drill-downs/get-finding"}]},{"group":"Snapshots","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/snapshots","title":"Month-end MRR snapshots","href":"/v2-finance-api/snapshots/list-snapshots"},{"openapi":"assets/openapi-v2-finance.json post /api/analytics/finance/snapshots","title":"Take a month-end MRR snapshot again","href":"/v2-finance-api/snapshots/take-snapshot"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/snapshots/{month}/{version}","title":"Frozen MRR figures of a snapshot","href":"/v2-finance-api/snapshots/get-snapshot"}]},{"group":"Excel-Exporte","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/recurring/excel","title":"Export the recurring revenue page as XLSX","href":"/v2-finance-api/excel/export-recurring"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/customers/excel","title":"Export the customer base page as XLSX","href":"/v2-finance-api/excel/export-customers"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/liquidity/excel","title":"Export the liquidity page as XLSX","href":"/v2-finance-api/excel/export-liquidity"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/revenue/excel","title":"Export the revenue page as XLSX","href":"/v2-finance-api/excel/export-revenue"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/export/excel","title":"Export the MRR financials as XLSX","href":"/v2-finance-api/excel/export-mrr-table"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/findings/export/excel","title":"Export the data-quality findings as XLSX","href":"/v2-finance-api/excel/export-findings"}]},{"group":"Definitionen","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/definitions","title":"Read the finance definitions catalogue","href":"/v2-finance-api/definitions/get-definitions"}]},{"group":"Einstellungen","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/settings","title":"Read the finance settings","href":"/v2-finance-api/settings/get-settings"},{"openapi":"assets/openapi-v2-finance.json patch /api/analytics/mrr-financials/settings","title":"Update the finance settings","href":"/v2-finance-api/settings/update-settings"}]}]}]},{"group":"Provisionen","icon":"percent","pages":[{"title":"Provisionen API","sidebarTitle":"Einführung","icon":"percent","href":"/v2-commission-api/introduction"},{"title":"Kernkonzepte","sidebarTitle":"Kernkonzepte","icon":"book","href":"/v2-commission-api/concepts"},{"group":"API","pages":[{"group":"Provisionspläne","pages":[{"openapi":"assets/openapi-v2-commission.json get /api/commissions/plans","title":"List commission plans","href":"/v2-commission-api/plans/list-plans"},{"openapi":"assets/openapi-v2-commission.json post /api/commissions/plans","title":"Create a commission plan","href":"/v2-commission-api/plans/create-plan"},{"openapi":"assets/openapi-v2-commission.json get /api/commissions/plans/{id}","title":"Get a commission plan","href":"/v2-commission-api/plans/get-plan"},{"openapi":"assets/openapi-v2-commission.json put /api/commissions/plans/{id}","title":"Update a commission plan","href":"/v2-commission-api/plans/update-plan"},{"openapi":"assets/openapi-v2-commission.json delete /api/commissions/plans/{id}","title":"Delete a commission plan","href":"/v2-commission-api/plans/delete-plan"}]}]}]},{"group":"Zahlungspläne","icon":"calendar-days","pages":[{"title":"Zahlungsplan API","sidebarTitle":"Einführung","icon":"calendar-days","href":"/v2-payment-plans-api/introduction"},{"title":"Schnellstart","sidebarTitle":"Schnellstart","icon":"rocket","href":"/v2-payment-plans-api/quickstart"},{"title":"Kernkonzepte","sidebarTitle":"Kernkonzepte","icon":"book","href":"/v2-payment-plans-api/concepts"},{"title":"Webhooks","sidebarTitle":"Webhooks","icon":"bell","href":"/v2-payment-plans-api/webhooks"},{"group":"API","pages":[{"group":"Zahlungsplan-Verwaltung","pages":[{"openapi":"assets/openapi-v2-payment-plans.json post /api/payment-plans","title":"Create a payment plan","href":"/v2-payment-plans-api/payment-plans/create-payment-plan"},{"openapi":"assets/openapi-v2-payment-plans.json get /api/payment-plans/{id}","title":"Get a payment plan","href":"/v2-payment-plans-api/payment-plans/get-payment-plan"},{"openapi":"assets/openapi-v2-payment-plans.json get /api/invoices/{id}/payment-plan","title":"Get the payment plan of an invoice","href":"/v2-payment-plans-api/payment-plans/get-invoice-payment-plan"},{"openapi":"assets/openapi-v2-payment-plans.json post /api/payment-plans/{id}/cancel","title":"Cancel a payment plan","href":"/v2-payment-plans-api/payment-plans/cancel-payment-plan"},{"openapi":"assets/openapi-v2-payment-plans.json post /api/payment-plans/{id}/extend","title":"Extend a payment plan","href":"/v2-payment-plans-api/payment-plans/extend-payment-plan"}]}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026-07"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/introduction"}]}]},"title":"Finance overview datasets - Fynn Docs","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}