> ## Documentation Index > Fetch the complete documentation index at: https://developers.thinkout.io/llms.txt > Use this file to discover all available pages before exploring further. # Sintetizează cash flow-ul > Ce arată ecranul de cash flow, descompus, pe interval de timp și cel mult încă o dimensiune. Trimite `period`, sau atât `from`, cât și `to`. Fiecare interval are o parte realizată și o parte previzionată. Partea realizată o formează tranzacțiile datate în interval, numărate cum le numără `/transactions/summary`: transferurile între conturile proprii ale spațiului de lucru și mișcările excluse sunt lăsate deoparte, iar tranzacțiile împărțite se numără prin bucățile lor. Partea previzionată este suma rămasă a previziunilor nerealizate datate în interval. O previziune acoperită parțial se numără doar cu ce mai este așteptat, iar tranzacțiile asociate ei se numără ca realizate. `inflow`, `outflow` și `net` adună cele două părți și coincid cu ecranul. Previziunile datate înainte de azi și încă nerealizate sunt restante. Ele sunt lăsate în afara rândurilor, dacă nu este trimis `include_overdue=true`. `totals.overdue_inflow` și `totals.overdue_outflow` raportează mereu suma rămasă a previziunilor restante pe care rândurile nu le-au numărat. Sumele se convertesc în `currency` la cursul din data fiecărei mișcări. Intervalele sunt aliniate la calendar și tăiate la fereastra cerută. `totals` acoperă întreaga fereastră. Rândurile grupate doar pe interval poartă și soldul de început, conturile deschise, transferurile, mișcările excluse și soldul de final ale intervalului. Soldul de final al unui interval viitor este soldul proiectat. Cele cinci sunt `null` când este trimis `group_by` sau `direction`. Un filtru `bank_id` sau `account_id` restrânge partea realizată și soldurile, niciodată previziunile, care nu au cont și acoperă mereu întregul spațiu de lucru. Un `bank_id` care nu se potrivește cu niciun cont întoarce rezultatul gol: niciun rând și totaluri zero. `group_by=account` este respins cu 400 din același motiv. Rândurile grupate sunt ordonate după `net` în valoare absolută, cel mai mare primul. Un interval păstrează cel mult 50 de grupuri; restul se strâng într-un singur rând etichetat `other`. Tranzacțiile și previziunile fără partener sau fără etichetă ajung într-un rând `none`, iar una cu mai multe etichete se numără o dată pentru fiecare etichetă. Aici `category_id` acoperă și subcategoriile. Filtrele se combină cu AND; un filtru care acceptă o listă își combină valorile cu OR. **Cash flow pe luni pentru trimestrul următor** ```http GET /cash-flow/summary?period=next_quarter&interval=month ``` **Încasări așteptate pe partener luna viitoare** ```http GET /cash-flow/summary?period=next_month&group_by=counterparty&direction=inflow ``` ## OpenAPI ````yaml /openapi/v1.ro.yaml get /cash-flow/summary openapi: 3.1.0 info: title: ThinkOut API version: '1.0' description: >- Acces de citire la datele unui spațiu de lucru ThinkOut. În versiunea 1 fiecare endpoint este un `GET`. Listele folosesc același înveliș și se paginează cu un cursor oriunde pot crește. Fiecare răspuns poartă `X-RateLimit-Limit`, `X-RateLimit-Remaining` și `X-RateLimit-Reset`. Versiunea 1 se schimbă doar prin adăugare: pot apărea oricând endpointuri noi, parametri opționali, câmpuri de răspuns și valori de enumerare. Tolerează câmpurile necunoscute și nu trata niciodată o enumerare ca închisă. contact: name: Suport ThinkOut url: https://developers.thinkout.io/guides/support servers: - url: https://api.thinkout.io/v1 security: - apiKey: [] tags: - name: Bănci description: Conexiunile bancare ale spațiului de lucru și starea fiecăreia. - name: Conturi description: Conturi manuale, sincronizate cu banca și delegate, cu solduri calculate. - name: Tranzacții description: Mișcări înregistrate și în așteptare pe conturile spațiului de lucru. - name: Categorii description: Arborele de categorii al spațiului de lucru, pe direcție și activitate. - name: Parteneri description: >- Clienții și furnizorii cărora le sunt atribuite tranzacțiile și previziunile. - name: Etichete description: Etichete libere, grupate pe tipuri. - name: Previziuni description: Încasări și plăți planificate și tranzacțiile care le-au realizat. - name: Rapoarte description: >- Totaluri, nu rânduri. Sinteze peste tranzacții, previziuni și cash flow, plus soldurile pe conturi. paths: /cash-flow/summary: get: tags: - Rapoarte summary: Sintetizează cash flow-ul description: >- Ce arată ecranul de cash flow, descompus, pe interval de timp și cel mult încă o dimensiune. Trimite `period`, sau atât `from`, cât și `to`. Fiecare interval are o parte realizată și o parte previzionată. Partea realizată o formează tranzacțiile datate în interval, numărate cum le numără `/transactions/summary`: transferurile între conturile proprii ale spațiului de lucru și mișcările excluse sunt lăsate deoparte, iar tranzacțiile împărțite se numără prin bucățile lor. Partea previzionată este suma rămasă a previziunilor nerealizate datate în interval. O previziune acoperită parțial se numără doar cu ce mai este așteptat, iar tranzacțiile asociate ei se numără ca realizate. `inflow`, `outflow` și `net` adună cele două părți și coincid cu ecranul. Previziunile datate înainte de azi și încă nerealizate sunt restante. Ele sunt lăsate în afara rândurilor, dacă nu este trimis `include_overdue=true`. `totals.overdue_inflow` și `totals.overdue_outflow` raportează mereu suma rămasă a previziunilor restante pe care rândurile nu le-au numărat. Sumele se convertesc în `currency` la cursul din data fiecărei mișcări. Intervalele sunt aliniate la calendar și tăiate la fereastra cerută. `totals` acoperă întreaga fereastră. Rândurile grupate doar pe interval poartă și soldul de început, conturile deschise, transferurile, mișcările excluse și soldul de final ale intervalului. Soldul de final al unui interval viitor este soldul proiectat. Cele cinci sunt `null` când este trimis `group_by` sau `direction`. Un filtru `bank_id` sau `account_id` restrânge partea realizată și soldurile, niciodată previziunile, care nu au cont și acoperă mereu întregul spațiu de lucru. Un `bank_id` care nu se potrivește cu niciun cont întoarce rezultatul gol: niciun rând și totaluri zero. `group_by=account` este respins cu 400 din același motiv. Rândurile grupate sunt ordonate după `net` în valoare absolută, cel mai mare primul. Un interval păstrează cel mult 50 de grupuri; restul se strâng într-un singur rând etichetat `other`. Tranzacțiile și previziunile fără partener sau fără etichetă ajung într-un rând `none`, iar una cu mai multe etichete se numără o dată pentru fiecare etichetă. Aici `category_id` acoperă și subcategoriile. Filtrele se combină cu AND; un filtru care acceptă o listă își combină valorile cu OR. **Cash flow pe luni pentru trimestrul următor** ```http GET /cash-flow/summary?period=next_quarter&interval=month ``` **Încasări așteptate pe partener luna viitoare** ```http GET /cash-flow/summary?period=next_month&group_by=counterparty&direction=inflow ``` operationId: summariseCashFlow parameters: - $ref: '#/components/parameters/period' - name: from in: query description: >- Prima zi a ferestrei, inclusiv. Obligatoriu împreună cu `to`, dacă nu este trimis `period`. schema: type: string format: date - name: to in: query description: >- Ultima zi a ferestrei, inclusiv. Obligatoriu împreună cu `from`, dacă nu este trimis `period`. schema: type: string format: date - $ref: '#/components/parameters/interval' - name: group_by in: query description: >- O a doua dimensiune de grupare, pe lângă intervalul de timp. Omite-o pentru un singur rând per interval. schema: $ref: '#/components/schemas/CashFlowGroupDimension' - $ref: '#/components/parameters/currency' - $ref: '#/components/parameters/bank_id' - $ref: '#/components/parameters/account_id' - $ref: '#/components/parameters/category_id' - $ref: '#/components/parameters/label_id' - $ref: '#/components/parameters/counterparty_id' - $ref: '#/components/parameters/direction' - $ref: '#/components/parameters/activity' - name: include_overdue in: query description: >- Dacă previziunile restante, cele datate înainte de azi și încă nerealizate, se numără în rândurile intervalelor în care cad. Dezactivat, ele apar doar în `totals.overdue_inflow` și `totals.overdue_outflow`. schema: type: boolean default: false responses: '200': description: Sinteza. content: application/json: schema: $ref: '#/components/schemas/CashFlowSummary' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '422': $ref: '#/components/responses/RequestTooLarge' '429': $ref: '#/components/responses/RateLimited' components: parameters: period: name: period in: query description: >- O fereastră cu nume, rezolvată față de ziua locală a spațiului de lucru și întoarsă în răspuns. Are prioritate față de `from` și `to`. schema: $ref: '#/components/schemas/PeriodMacro' interval: name: interval in: query description: Intervalul de timp în care sunt grupate rândurile. schema: $ref: '#/components/schemas/Interval' currency: name: currency in: query description: >- Moneda în care se raportează. Implicit moneda spațiului de lucru. Un cod necunoscut este respins. schema: $ref: '#/components/schemas/Currency' bank_id: name: bank_id in: query description: >- Doar rândurile de pe conturile alimentate de aceste conexiuni bancare. Separate prin virgulă pentru mai multe. style: form explode: false schema: type: array items: type: string format: uuid account_id: name: account_id in: query description: >- Doar rândurile de pe aceste conturi. Separate prin virgulă pentru mai multe. style: form explode: false schema: type: array items: type: string format: uuid category_id: name: category_id in: query description: >- Doar rândurile din aceste categorii. Separate prin virgulă pentru mai multe. Pe `/transactions` se potrivește și cu o tranzacție împărțită ale cărei bucăți sunt în una dintre ele. Subcategoriile sunt incluse doar pe sinteze. style: form explode: false schema: type: array items: type: string format: uuid label_id: name: label_id in: query description: >- Doar rândurile care poartă cel puțin una dintre aceste etichete. Separate prin virgulă pentru mai multe. style: form explode: false schema: type: array items: type: string format: uuid counterparty_id: name: counterparty_id in: query description: >- Doar rândurile atribuite acestor parteneri. Separate prin virgulă pentru mai multe. style: form explode: false schema: type: array items: type: string format: uuid direction: name: direction in: query schema: $ref: '#/components/schemas/Direction' activity: name: activity in: query description: >- Doar rândurile a căror categorie se află în aceste secțiuni ale situației fluxurilor de numerar. Separate prin virgulă pentru mai multe. style: form explode: false schema: type: array items: $ref: '#/components/schemas/Activity' schemas: CashFlowGroupDimension: type: string description: >- O dimensiune după care se grupează rândurile de cash flow, pe lângă intervalul de timp. Nu există `account`, pentru că previziunile nu au cont. enum: - category - counterparty - label - activity - direction CashFlowSummary: type: object required: - object - period - conversion - group_by - bank_ids - account_ids - forecast_scope - include_overdue - has_data - totals - data properties: object: type: string const: cash_flow_summary period: $ref: '#/components/schemas/ResolvedPeriod' conversion: $ref: '#/components/schemas/Conversion' group_by: oneOf: - $ref: '#/components/schemas/CashFlowGroupDimension' - type: 'null' bank_ids: type: array description: Filtrul `bank_id` întors în răspuns, gol când nu a fost trimis. items: type: string format: uuid account_ids: type: array description: Filtrul `account_id` întors în răspuns, gol când nu a fost trimis. items: type: string format: uuid forecast_scope: type: string const: workspace description: >- Ce acoperă partea previzionată și totalurile restante. Mereu întregul spațiu de lucru: o previziune nu are cont, așa că `bank_ids` și `account_ids` restrâng doar partea realizată și soldurile. include_overdue: type: boolean description: >- Dacă previziunile restante au fost numărate în rânduri, așa cum s-a cerut. has_data: type: boolean description: '`false` când nicio tranzacție și nicio previziune nu s-au potrivit.' totals: $ref: '#/components/schemas/CashFlowSummaryTotals' data: type: array items: $ref: '#/components/schemas/CashFlowSummaryRow' PeriodMacro: type: string description: >- O fereastră cu nume, rezolvată pe server. `last_30_days` și `last_90_days` se termină azi și includ ziua de azi; `last_12_months` începe în ziua de după azi minus douăsprezece luni. `next_month`, `next_quarter` și `next_year` acoperă întreaga lună, întregul trimestru sau întregul an calendaristic următor. enum: - this_month - last_month - this_quarter - last_quarter - this_year - last_year - month_to_date - quarter_to_date - year_to_date - last_30_days - last_90_days - last_12_months - next_month - next_quarter - next_year Interval: type: string description: Intervalul de timp pentru rândurile unui raport. enum: - day - week - month default: month Currency: type: string description: Cod de monedă alfabetic ISO 4217. pattern: ^[A-Z]{3}$ example: RON Direction: type: string description: >- Dacă banii intră sau ies. Pe o tranzacție sau o previziune urmează semnul lui `amount`. enum: - inflow - outflow Activity: type: string description: >- Secțiunea din situația fluxurilor de numerar căreia îi aparține categoria. enum: - operating - investing - financing ResolvedPeriod: type: object description: Fereastra efectiv calculată. required: - from - to - macro - interval properties: from: type: string format: date to: type: string format: date macro: oneOf: - $ref: '#/components/schemas/PeriodMacro' - type: 'null' description: >- Macrocomanda care a produs aceste date, sau `null` când au fost trimise direct. interval: $ref: '#/components/schemas/Interval' Conversion: type: object description: Ce s-a făcut pentru ca sumele să fie comparabile. required: - applied - currency - basis properties: applied: type: boolean description: '`false` când toate sumele erau deja în `currency`.' currency: $ref: '#/components/schemas/Currency' basis: type: string description: >- `transaction_date` convertește fiecare mișcare la cursul din data ei. `balance_date` convertește un sold întreg la un singur curs. `none` când nu s-a convertit nimic. enum: - transaction_date - balance_date - none CashFlowSummaryTotals: type: object description: >- Întreaga fereastră însumată, peste aceleași tranzacții și previziuni ca rândurile. required: - currency - actual_inflow - actual_outflow - actual_count - forecast_inflow - forecast_outflow - forecast_count - inflow - outflow - net - overdue_inflow - overdue_outflow - starting_balance - opened_accounts - transfers - excluded - final_balance properties: currency: $ref: '#/components/schemas/Currency' actual_inflow: $ref: '#/components/schemas/Money' actual_outflow: $ref: '#/components/schemas/Money' actual_count: type: integer forecast_inflow: $ref: '#/components/schemas/Money' forecast_outflow: $ref: '#/components/schemas/Money' forecast_count: type: integer inflow: $ref: '#/components/schemas/Money' outflow: $ref: '#/components/schemas/Money' net: $ref: '#/components/schemas/Money' overdue_inflow: $ref: '#/components/schemas/Money' description: >- Suma rămasă a previziunilor de încasări restante și nerealizate care se potrivesc filtrelor și pe care niciun rând nu le-a numărat. Toate, când `include_overdue` este dezactivat; cele datate în afara ferestrei, când este activat. overdue_outflow: $ref: '#/components/schemas/Money' description: La fel pentru previziunile de plăți, negativă. starting_balance: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- `starting_balance` al primului interval. `null` când este trimis `group_by` sau `direction`. opened_accounts: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Cifrele intervalelor însumate pe toată fereastra. `null` când este trimis `group_by` sau `direction`. transfers: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Cifrele intervalelor însumate pe toată fereastra. `null` când este trimis `group_by` sau `direction`. excluded: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Cifrele intervalelor însumate pe toată fereastra. `null` când este trimis `group_by` sau `direction`. final_balance: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- `final_balance` al ultimului interval. `null` când este trimis `group_by` sau `direction`. CashFlowSummaryRow: type: object required: - period_start - period_end - group - currency - actual_inflow - actual_outflow - actual_count - forecast_inflow - forecast_outflow - forecast_count - inflow - outflow - net - starting_balance - opened_accounts - transfers - excluded - final_balance properties: period_start: type: string format: date period_end: type: string format: date group: oneOf: - $ref: '#/components/schemas/ReportGroup' - type: 'null' currency: $ref: '#/components/schemas/Currency' actual_inflow: $ref: '#/components/schemas/Money' description: Încasările din tranzacții în interval, după excluderile raportului. actual_outflow: $ref: '#/components/schemas/Money' description: >- Plățile din tranzacții în interval, după excluderile raportului. Negativ. actual_count: type: integer description: Tranzacțiile din spatele acestui rând, după excluderile raportului. forecast_inflow: $ref: '#/components/schemas/Money' description: >- Suma rămasă a previziunilor de încasare nerealizate, datate în interval. forecast_outflow: $ref: '#/components/schemas/Money' description: >- Suma rămasă a previziunilor de plată nerealizate, datate în interval. Negativ. forecast_count: type: integer description: Previziunile din spatele acestui rând. inflow: $ref: '#/components/schemas/Money' description: >- `actual_inflow` plus `forecast_inflow`. Ce arată ecranul de cash flow. outflow: $ref: '#/components/schemas/Money' description: >- `actual_outflow` plus `forecast_outflow`. Ce arată ecranul de cash flow. net: $ref: '#/components/schemas/Money' description: '`inflow` plus `outflow`. Ce arată ecranul de cash flow.' starting_balance: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Soldul conturilor spațiului de lucru la începutul intervalului, proiectat când intervalul începe după azi. `null` când este trimis `group_by` sau `direction`. opened_accounts: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Soldurile inițiale ale conturilor deschise în interval. Nu fac parte din fluxuri. `null` când este trimis `group_by` sau `direction`. transfers: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Netul transferurilor între conturile proprii ale spațiului de lucru în interval. Nu face parte din fluxuri. `null` când este trimis `group_by` sau `direction`. excluded: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Netul mișcărilor excluse de utilizator din cash flow în interval. Nu face parte din fluxuri. `null` când este trimis `group_by` sau `direction`. final_balance: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Soldul la sfârșitul intervalului, proiectat când intervalul se termină după azi. Soldul de început plus `net`, `opened_accounts`, `transfers` și `excluded`. `null` când este trimis `group_by` sau `direction`. Error: type: object required: - error properties: error: type: object required: - type - code - message - param - request_id properties: type: type: string enum: - invalid_request - authentication - not_found - rate_limit - server code: type: string description: >- Motiv stabil, citibil de o mașină. Ramifică pe acesta, nu pe `message`. Unul dintre `invalid_parameter`, `invalid_cursor`, `limit_out_of_range`, `invalid_expand`, `as_of_in_future`, `unauthorized`, `forbidden`, `resource_not_found`, `too_many_groups`, `period_too_long`, `rate_limited`, `internal_error`. message: type: string description: >- Explicație pentru oameni, în engleză. Formularea se poate schimba. param: type: - string - 'null' description: Parametrul de query vinovat, când există unul. request_id: type: string description: Menționează-l când contactezi suportul. Money: type: string description: >- Sumă zecimală ca șir de caractere, cu două decimale. Negativ înseamnă ieșire la tranzacții, previziuni și cifre din rapoarte. pattern: ^-?[0-9]+\.[0-9]{2}$ example: '-1250.00' ReportGroup: type: object description: >- După ce este grupat un rând de raport. `null` la rândurile grupate doar pe interval. required: - dimension - id - label properties: dimension: type: string example: category id: type: - string - 'null' format: uuid description: >- Identificatorul obiectului grupat, al activității pentru `activity`. `null` pentru `direction` și `status`, și pentru rândurile `none` și `other`. label: type: string description: >- Numele grupului. Grupurile care nu sunt obiecte sunt coduri cu litere mici pe fiecare sinteză: `inflow` sau `outflow`, un cod de activitate precum `operating`, o stare de previziune precum `planned`, și `none` sau `other`. example: Telecom responses: BadRequest: description: Un parametru este invalid. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request code: invalid_parameter message: direction must be 'inflow' or 'outflow' param: direction request_id: 0HNF8K3QJL2VM:00000001 Unauthorized: description: Cheia API lipsește, este malformată, necunoscută sau revocată. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication code: unauthorized message: Missing, malformed, unknown or revoked API key param: null request_id: 0HNF8K3QJL2VM:00000001 Forbidden: description: Cheia este validă, dar planul ThinkOut al companiei nu include API-ul. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication code: forbidden message: >- The API is not included in this company's ThinkOut plan. Contact support@thinkout.io to enable it. param: null request_id: 0HNF8K3QJL2VM:00000001 RequestTooLarge: description: >- Raportul ar depăși 1000 de rânduri. `period_too_long` apare doar din fereastră și interval, `too_many_groups` după grupare. Restrânge fereastra, folosește un interval mai mare sau adaugă filtre. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request code: too_many_groups message: >- Grouping by counterparty over this period produces 1240 groups. The maximum is 1000. Narrow the period or the filters. param: group_by request_id: 0HNF8K3QJL2VM:00000001 RateLimited: description: >- Peste 120 de cereri în minutul curent pentru această cheie. Așteaptă secundele din `Retry-After`. headers: Retry-After: schema: type: integer description: Secunde până se resetează fereastra de un minut. X-RateLimit-Limit: schema: type: integer description: Cereri permise pe minut. X-RateLimit-Remaining: schema: type: integer description: Cereri rămase în minutul curent. X-RateLimit-Reset: schema: type: integer description: Secunde până se resetează fereastra de un minut. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: rate_limit code: rate_limited message: Too many requests param: null request_id: 0HNF8K3QJL2VM:00000001 securitySchemes: apiKey: type: http scheme: bearer description: >- O cheie API creată în setările ThinkOut. O cheie citește un singur spațiu de lucru. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.