> ## 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ă tranzacțiile > Totaluri peste aceleași tranzacții pe care le listează `/transactions`, cu aceleași filtre, grupate pe o perioadă și pe cel mult o altă dimensiune. **Ce numără este fix și nu poate fi schimbat**, ca cifrele să coincidă cu totalurile pe care le arată ThinkOut. Transferurile între conturile proprii ale spațiului de lucru, tranzacțiile excluse de utilizator și duplicatele sunt lăsate deoparte. Tranzacțiile împărțite sunt numărate prin bucățile lor, niciodată prin original, așa că nimic nu este numărat de două ori. Niciuna dintre aceste distincții nu apare pe `/transactions`, care raportează mișcări, nu cash flow. Însumarea unei liste nu va reproduce, prin urmare, aceste cifre, și nici nu este menită să o facă. Sumele sunt convertite în `currency`, implicit moneda spațiului de lucru. Fiecare tranzacție se convertește la cursul din data ei. Obiectul `conversion` din răspuns spune ce s-a făcut. Rândurile grupate doar pe perioadă poartă ce arată ecranul de cash flow pentru perioada aceea: fluxurile, plus soldul de început, transferurile, mișcările excluse și soldul de final al conturilor din perimetru. Rândurile grupate după o a doua dimensiune poartă doar fluxurile, pentru că un sold per partener sau per categorie nu înseamnă nimic. `totals` acoperă întregul interval, ca apelantul să nu adune niciodată rânduri. Filtrele se cumulează: `bank_id`, `account_id`, `category_id`, `counterparty_id`, `label_id` și `direction` pot fi date toate împreună și se combină cu AND, iar fiecare filtru pe id acceptă mai multe id-uri, combinate cu OR. Gruparea este lucrul mai strict: o perioadă și cel mult o dimensiune în plus. Cheltuielile de marketing pe un proiect, pe luni, înseamnă un apel cu două filtre și fără `group_by`; cheltuielile pe categorii și pe etichete deodată înseamnă două apeluri. Trei forme de întrebare, trei cereri: ``` Încasări și plăți pe luni, cu solduri GET /transactions/summary?from=2026-03-01&to=2026-04-30&interval=month Primii parteneri din trimestrul acesta GET /transactions/summary?from=2026-07-01&to=2026-09-30&interval=month&group_by=counterparty&direction=outflow Cash flow pe luni pentru conturile unei bănci GET /transactions/summary?from=2026-03-01&to=2026-08-31&interval=month&bank_id=5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f ``` Exemplele de răspuns de mai jos le arată pe primele două. Intervalul este întotdeauna explicit. Nu există perioade cu nume aici; un apelant care vrea „trimestrul trecut” calculează cele două date și le trimite, iar răspunsul le întoarce ca ecou. ## OpenAPI ````yaml /openapi/v1.ro.yaml get /transactions/summary openapi: 3.1.0 info: title: ThinkOut API version: '1.0' description: >- Acces programatic la datele unui spațiu de lucru ThinkOut. În versiunea 1 fiecare endpoint este un `GET`. Listele folosesc același înveliș de răspuns și se paginează cu un cursor oriunde lista poate crește. Versiunea 1 se schimbă doar prin adăugare. Pot apărea oricând endpointuri noi, parametri opționali noi, câmpuri noi în răspuns și valori noi de enumerare, așa că tolerați câmpurile necunoscute și nu tratați niciodată o enumerare ca pe o mulțime î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 și previziuni, plus rapoartele de cash flow salvate în spațiul de lucru. paths: /transactions/summary: get: tags: - Rapoarte summary: Sintetizează tranzacțiile description: >- Totaluri peste aceleași tranzacții pe care le listează `/transactions`, cu aceleași filtre, grupate pe o perioadă și pe cel mult o altă dimensiune. **Ce numără este fix și nu poate fi schimbat**, ca cifrele să coincidă cu totalurile pe care le arată ThinkOut. Transferurile între conturile proprii ale spațiului de lucru, tranzacțiile excluse de utilizator și duplicatele sunt lăsate deoparte. Tranzacțiile împărțite sunt numărate prin bucățile lor, niciodată prin original, așa că nimic nu este numărat de două ori. Niciuna dintre aceste distincții nu apare pe `/transactions`, care raportează mișcări, nu cash flow. Însumarea unei liste nu va reproduce, prin urmare, aceste cifre, și nici nu este menită să o facă. Sumele sunt convertite în `currency`, implicit moneda spațiului de lucru. Fiecare tranzacție se convertește la cursul din data ei. Obiectul `conversion` din răspuns spune ce s-a făcut. Rândurile grupate doar pe perioadă poartă ce arată ecranul de cash flow pentru perioada aceea: fluxurile, plus soldul de început, transferurile, mișcările excluse și soldul de final al conturilor din perimetru. Rândurile grupate după o a doua dimensiune poartă doar fluxurile, pentru că un sold per partener sau per categorie nu înseamnă nimic. `totals` acoperă întregul interval, ca apelantul să nu adune niciodată rânduri. Filtrele se cumulează: `bank_id`, `account_id`, `category_id`, `counterparty_id`, `label_id` și `direction` pot fi date toate împreună și se combină cu AND, iar fiecare filtru pe id acceptă mai multe id-uri, combinate cu OR. Gruparea este lucrul mai strict: o perioadă și cel mult o dimensiune în plus. Cheltuielile de marketing pe un proiect, pe luni, înseamnă un apel cu două filtre și fără `group_by`; cheltuielile pe categorii și pe etichete deodată înseamnă două apeluri. Trei forme de întrebare, trei cereri: ``` Încasări și plăți pe luni, cu solduri GET /transactions/summary?from=2026-03-01&to=2026-04-30&interval=month Primii parteneri din trimestrul acesta GET /transactions/summary?from=2026-07-01&to=2026-09-30&interval=month&group_by=counterparty&direction=outflow Cash flow pe luni pentru conturile unei bănci GET /transactions/summary?from=2026-03-01&to=2026-08-31&interval=month&bank_id=5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f ``` Exemplele de răspuns de mai jos le arată pe primele două. Intervalul este întotdeauna explicit. Nu există perioade cu nume aici; un apelant care vrea „trimestrul trecut” calculează cele două date și le trimite, iar răspunsul le întoarce ca ecou. operationId: summariseTransactions parameters: - name: from in: query required: true description: Prima zi a intervalului, inclusiv. schema: type: string format: date - name: to in: query required: true description: Ultima zi a intervalului, inclusiv. 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. Cel mult una. Omite-o pentru un singur rând per interval. schema: $ref: '#/components/schemas/GroupDimension' - $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' responses: '200': description: Sinteza. content: application/json: schema: $ref: '#/components/schemas/Summary' examples: By month, with balances: summary: >- One row per month; balance fields present because nothing else is grouped value: object: summary period: from: '2026-03-01' to: '2026-04-30' macro: null interval: month conversion: applied: true currency: RON basis: transaction_date group_by: null has_data: true totals: currency: RON inflow: '163900.00' outflow: '-118420.75' net: '45479.25' count: 401 data: - period_start: '2026-03-01' period_end: '2026-03-31' group: null currency: RON inflow: '84200.00' outflow: '-61350.25' net: '22849.75' count: 212 starting_balance: '128400.10' transfers: '0.00' excluded: '-1500.00' final_balance: '149749.85' - period_start: '2026-04-01' period_end: '2026-04-30' group: null currency: RON inflow: '79700.00' outflow: '-57070.50' net: '22629.50' count: 189 starting_balance: '149749.85' transfers: '0.00' excluded: '0.00' final_balance: '172379.35' By month and counterparty: summary: >- One row per month per counterparty; balance fields null on grouped rows value: object: summary period: from: '2026-07-01' to: '2026-08-31' macro: null interval: month conversion: applied: true currency: RON basis: transaction_date group_by: counterparty has_data: true totals: currency: RON inflow: '0.00' outflow: '-42461.00' net: '-42461.00' count: 9 data: - period_start: '2026-07-01' period_end: '2026-07-31' group: dimension: counterparty id: 9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d label: Orange Romania currency: RON inflow: '0.00' outflow: '-6115.50' net: '-6115.50' count: 2 starting_balance: null transfers: null excluded: null final_balance: null - period_start: '2026-07-01' period_end: '2026-07-31' group: dimension: counterparty id: 4d5e6f70-8192-4a3b-9c4d-5e6f7a8b9c0d label: Regus currency: RON inflow: '0.00' outflow: '-12000.00' net: '-12000.00' count: 1 starting_balance: null transfers: null excluded: null final_balance: null - period_start: '2026-08-01' period_end: '2026-08-31' group: dimension: counterparty id: 9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d label: Orange Romania currency: RON inflow: '0.00' outflow: '-6115.50' net: '-6115.50' count: 2 starting_balance: null transfers: null excluded: null final_balance: null - period_start: '2026-08-01' period_end: '2026-08-31' group: dimension: counterparty id: 4d5e6f70-8192-4a3b-9c4d-5e6f7a8b9c0d label: Regus currency: RON inflow: '0.00' outflow: '-18230.00' net: '-18230.00' count: 4 starting_balance: null transfers: null excluded: null final_balance: null '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '422': $ref: '#/components/responses/RequestTooLarge' '429': $ref: '#/components/responses/RateLimited' components: parameters: 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 sunt raportate totalurile. Implicit moneda spațiului de lucru. Obiectul `conversion` din răspuns spune dacă s-a făcut conversie și pe ce bază. 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. La tranzacții, se potrivește și cu o tranzacție împărțită ale cărei bucăți se află în una dintre ele, chiar dacă rândul în sine nu are categorie. 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' schemas: GroupDimension: type: string description: >- O dimensiune după care se grupează rândurile raportului, pe lângă intervalul de timp. enum: - category - counterparty - label - account - activity - direction Summary: type: object required: - object - period - conversion - group_by - has_data - totals - data properties: object: type: string const: summary period: $ref: '#/components/schemas/ResolvedPeriod' conversion: $ref: '#/components/schemas/Conversion' group_by: oneOf: - $ref: '#/components/schemas/GroupDimension' - type: 'null' has_data: type: boolean description: >- `false` când nu s-a potrivit nimic. Distinge între „nu există tranzacții aici” și totaluri care chiar au ieșit zero. totals: $ref: '#/components/schemas/SummaryTotals' data: type: array items: $ref: '#/components/schemas/SummaryRow' example: object: summary period: from: '2026-03-01' to: '2026-04-30' macro: null interval: month conversion: applied: true currency: RON basis: transaction_date group_by: null has_data: true totals: currency: RON inflow: '163900.00' outflow: '-118420.75' net: '45479.25' count: 401 data: - period_start: '2026-03-01' period_end: '2026-03-31' group: null currency: RON inflow: '84200.00' outflow: '-61350.25' net: '22849.75' count: 212 starting_balance: '128400.10' transfers: '0.00' excluded: '-1500.00' final_balance: '149749.85' - period_start: '2026-04-01' period_end: '2026-04-30' group: null currency: RON inflow: '79700.00' outflow: '-57070.50' net: '22629.50' count: 189 starting_balance: '149749.85' transfers: '0.00' excluded: '0.00' final_balance: '172379.35' Interval: type: string description: >- O perioadă de grupare pentru rândurile de raport. Aceleași perioade pe care le oferă ecranul de cash flow din ThinkOut. 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 pe o previziune urmează semnul lui `amount` și nu îl poate contrazice niciodată. Există ca răspunsurile să poată fi grupate și citite fără să inspectezi semnele. enum: - inflow - outflow ResolvedPeriod: type: object description: >- Fereastra efectiv calculată, după rezolvarea oricărei macrocomenzi sau a datelor relative salvate. 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 propria ei dată, ceea ce folosesc totalurile peste mișcări. `balance_date` convertește un sold întreg la un singur curs, ceea ce folosesc soldurile, pentru că un cont ține o singură monedă. enum: - transaction_date - balance_date - none SummaryTotals: type: object description: Întregul interval însumat, după aceleași excluderi ca rândurile. required: - currency - inflow - outflow - net - count properties: currency: $ref: '#/components/schemas/Currency' inflow: $ref: '#/components/schemas/Money' outflow: $ref: '#/components/schemas/Money' net: $ref: '#/components/schemas/Money' count: type: integer SummaryRow: type: object required: - period_start - period_end - group - currency - inflow - outflow - net - count - starting_balance - 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' inflow: $ref: '#/components/schemas/Money' outflow: $ref: '#/components/schemas/Money' net: $ref: '#/components/schemas/Money' count: type: integer description: Tranzacțiile din spatele acestui rând, după excluderile raportului. starting_balance: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Soldul conturilor din perimetru la începutul perioadei. Prezent pe rândurile grupate doar pe perioadă; `null` pe rândurile grupate după o a doua dimensiune. transfers: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Netul transferurilor între conturile proprii ale spațiului de lucru în perioadă. Nu face parte din fluxuri. `null` pe rândurile grupate. excluded: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Netul mișcărilor excluse de utilizator din cash flow în perioadă. Nu face parte din fluxuri. `null` pe rândurile grupate. final_balance: oneOf: - $ref: '#/components/schemas/Money' - type: 'null' description: >- Soldul la sfârșitul perioadei: soldul de început plus net, transferuri și excluse. `null` pe rândurile grupate. 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`. Codurile specifice rapoartelor sunt `too_many_groups`, `period_too_long`, `as_of_in_future` și `invalid_expand`. message: type: string description: >- Explicație pentru oameni, în engleză. Formularea se poate schimba. param: type: - string - 'null' description: Parametrul de query sau de cale vinovat, când există unul. request_id: type: string description: Menționează-l când contactezi suportul. PeriodMacro: type: string description: >- O fereastră de timp cu nume, rezolvată pe server. Datele la care s-a rezolvat sunt întotdeauna raportate înapoi, ca cel care apelează să verifice că a cerut fereastra la care se gândea. 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 Money: type: string description: >- Sumă zecimală ca șir de caractere. Cu semn la tranzacții, previziuni și cifre din rapoarte, unde negativ înseamnă ieșire. Semnul este cel care contează: `direction` este derivat din el, iar cele două nu pot fi niciodată în contradicție. pattern: ^-?[0-9]+(\.[0-9]+)?$ 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, ca un total să poată fi urmărit înapoi la rândurile lui într-un singur apel. `null` pentru dimensiunile care nu sunt obiecte, cum ar fi `direction`. label: type: string description: Numele grupului, în formă citibilă. 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: Parameter 'from' must be a date in YYYY-MM-DD format. param: from request_id: req_01J8ZT4Q7Y6M3K Unauthorized: description: Cheia API lipsește, este necunoscută sau revocată. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication code: unauthorized message: Invalid API key. param: null request_id: req_01J8ZT4Q7Y6M3K RequestTooLarge: description: >- Cererea este validă, dar ar calcula mai mult decât are voie un raport. Mesajul numește atât ce s-a cerut, cât și plafonul, ca cererea să poată fi restrânsă fără ghicit. 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 4,182 groups. The maximum is 1,000. Narrow the period or the filters. param: group_by request_id: req_01J8ZT4Q7Y6M3K RateLimited: description: Prea multe cereri. Așteaptă numărul de secunde din `Retry-After`. headers: Retry-After: schema: type: integer description: Secunde de așteptat înainte de a reîncerca. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: rate_limit code: rate_limited message: Rate limit exceeded. Retry after 12 seconds. param: null request_id: req_01J8ZT4Q7Y6M3K 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. ````