> ## 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ă bugetele

> Ce arată ecranul de bugete, pe lună sau pentru întreaga fereastră, pe direcție sau pe categorie. Trimite `period`, sau atât `from`, cât și `to`.

Bugetele sunt lunare, așa că fereastra se extinde la luni întregi. Fiecare rând pune bugetul alături de ce s-a întâmplat. `budgeted` este bugetul. `actual` sunt tranzacțiile, coloana Real din tabul Execuție. `forecast` este suma rămasă a previziunilor nerealizate datate în interval, coloana Previzionat din tabul Execuție. `realised` le adună pe cele două și este cifra pe care tabul Planificare o compară cu bugetul. Plățile sunt negative.

`on_budget` este pictograma de bifă sau de avertizare din tabul Planificare. Este `true` când `realised` a atins un buget de încasări sau a rămas în limitele unui buget de plăți, și `null` pentru o lună care nu a început, pentru o celulă fără buget și cu `interval=total`.

Cifrele acoperă categoriile afișate pe ecranul de bugete. În majoritatea spațiilor de lucru, categoriile ascunse acolo includ încasările și plățile necategorisite și transferurile, așa că totalurile bugetelor diferă de `/transactions/summary` și de `/cash-flow/summary` pentru aceleași luni.

Bugetele se convertesc în `currency` la cursul din prima zi a lunii lor, iar tranzacțiile și previziunile la cursul din data lor. `totals` este coloana Total din tabul Planificare, pentru fiecare direcție.

Fără `group_by` există câte un rând pe direcție pe interval, iar `balances` conține rândul de sold final din tabul Planificare: `final_balance` odată ce luna a început și `budgeted_final_balance`, soldul dacă bugetele se respectă, până când luna se încheie. `balances` este gol cu `interval=total`, `group_by`, `category_id` sau `direction`.

Cu `group_by=category` rândurile sunt imbricate ca pe ecran. Rândul unei categorii părinte este întreaga ei ramură, așa că dacă aduni un părinte cu copiii lui, copiii se numără de două ori. Un rând al cărui `id` este egal cu `parent_id` reprezintă banii înregistrați direct pe părinte, pe care ecranul îi arată ca „Altele din" părinte. O categorie apare într-un interval când are ceva bugetat, mișcat sau așteptat. `category_id` restrânge rândurile și `totals` la acele categorii și la cele imbricate sub ele.

Rândurile sunt ordonate după interval. În cadrul unui interval încasările vin înaintea plăților, iar categoriile urmează ordinea ecranului, părinții înaintea copiilor.

**Încasări și plăți față de buget în trimestrul acesta, cu solduri**

```http
GET /budgets/summary?period=this_quarter
```

**Plățile din anul acesta față de buget, pe categorii, în total**

```http
GET /budgets/summary?period=this_year&interval=total&group_by=category&direction=outflow
```



## OpenAPI

````yaml /openapi/v1.ro.yaml get /budgets/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: Bugete
    description: >-
      Bugetele lunare pe categorii, alături de ce s-a mișcat și de ce mai este
      așteptat, cum le arată ecranul de bugete.
  - name: Scenarii
    description: >-
      Scenariile construite pe ecranul de scenarii și cifrele pe care ecranul le
      arată pentru ele.
  - name: Rapoarte
    description: >-
      Totaluri, nu rânduri. Sinteze peste tranzacții, previziuni și cash flow,
      plus soldurile pe conturi.
paths:
  /budgets/summary:
    get:
      tags:
        - Bugete
      summary: Sintetizează bugetele
      description: >-
        Ce arată ecranul de bugete, pe lună sau pentru întreaga fereastră, pe
        direcție sau pe categorie. Trimite `period`, sau atât `from`, cât și
        `to`.


        Bugetele sunt lunare, așa că fereastra se extinde la luni întregi.
        Fiecare rând pune bugetul alături de ce s-a întâmplat. `budgeted` este
        bugetul. `actual` sunt tranzacțiile, coloana Real din tabul Execuție.
        `forecast` este suma rămasă a previziunilor nerealizate datate în
        interval, coloana Previzionat din tabul Execuție. `realised` le adună pe
        cele două și este cifra pe care tabul Planificare o compară cu bugetul.
        Plățile sunt negative.


        `on_budget` este pictograma de bifă sau de avertizare din tabul
        Planificare. Este `true` când `realised` a atins un buget de încasări
        sau a rămas în limitele unui buget de plăți, și `null` pentru o lună
        care nu a început, pentru o celulă fără buget și cu `interval=total`.


        Cifrele acoperă categoriile afișate pe ecranul de bugete. În majoritatea
        spațiilor de lucru, categoriile ascunse acolo includ încasările și
        plățile necategorisite și transferurile, așa că totalurile bugetelor
        diferă de `/transactions/summary` și de `/cash-flow/summary` pentru
        aceleași luni.


        Bugetele se convertesc în `currency` la cursul din prima zi a lunii lor,
        iar tranzacțiile și previziunile la cursul din data lor. `totals` este
        coloana Total din tabul Planificare, pentru fiecare direcție.


        Fără `group_by` există câte un rând pe direcție pe interval, iar
        `balances` conține rândul de sold final din tabul Planificare:
        `final_balance` odată ce luna a început și `budgeted_final_balance`,
        soldul dacă bugetele se respectă, până când luna se încheie. `balances`
        este gol cu `interval=total`, `group_by`, `category_id` sau `direction`.


        Cu `group_by=category` rândurile sunt imbricate ca pe ecran. Rândul unei
        categorii părinte este întreaga ei ramură, așa că dacă aduni un părinte
        cu copiii lui, copiii se numără de două ori. Un rând al cărui `id` este
        egal cu `parent_id` reprezintă banii înregistrați direct pe părinte, pe
        care ecranul îi arată ca „Altele din" părinte. O categorie apare într-un
        interval când are ceva bugetat, mișcat sau așteptat. `category_id`
        restrânge rândurile și `totals` la acele categorii și la cele imbricate
        sub ele.


        Rândurile sunt ordonate după interval. În cadrul unui interval
        încasările vin înaintea plăților, iar categoriile urmează ordinea
        ecranului, părinții înaintea copiilor.


        **Încasări și plăți față de buget în trimestrul acesta, cu solduri**


        ```http

        GET /budgets/summary?period=this_quarter

        ```


        **Plățile din anul acesta față de buget, pe categorii, în total**


        ```http

        GET
        /budgets/summary?period=this_year&interval=total&group_by=category&direction=outflow

        ```
      operationId: summariseBudgets
      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/planning_interval'
        - name: group_by
          in: query
          description: >-
            `category` pentru câte un rând pe categorie pe interval. Omite-l
            pentru câte un rând pe direcție pe interval.
          schema:
            type: string
            enum:
              - category
        - $ref: '#/components/parameters/currency'
        - $ref: '#/components/parameters/planning_category_id'
        - $ref: '#/components/parameters/direction'
      responses:
        '200':
          description: Sinteza.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BudgetsSummary'
              examples:
                By month, with balances:
                  summary: >-
                    One row per direction per month, the final balance row
                    filled
                  value:
                    object: budgets_summary
                    period:
                      from: '2026-10-01'
                      to: '2026-12-31'
                      macro: this_quarter
                      interval: month
                    conversion:
                      applied: true
                      currency: RON
                      basis: own_date
                    group_by: null
                    has_data: true
                    totals:
                      inflow:
                        currency: RON
                        budgeted: '280000.00'
                        actual: '127700.00'
                        forecast: '100000.00'
                        realised: '227700.00'
                      outflow:
                        currency: RON
                        budgeted: '-190000.00'
                        actual: '-88456.25'
                        forecast: '-59200.00'
                        realised: '-147656.25'
                    data:
                      - period_start: '2026-10-01'
                        period_end: '2026-10-31'
                        direction: inflow
                        group: null
                        currency: RON
                        budgeted: '90000.00'
                        actual: '86500.00'
                        forecast: '0.00'
                        realised: '86500.00'
                        on_budget: false
                        note: null
                      - period_start: '2026-10-01'
                        period_end: '2026-10-31'
                        direction: outflow
                        group: null
                        currency: RON
                        budgeted: '-62000.00'
                        actual: '-58340.50'
                        forecast: '0.00'
                        realised: '-58340.50'
                        on_budget: true
                        note: null
                      - period_start: '2026-11-01'
                        period_end: '2026-11-30'
                        direction: inflow
                        group: null
                        currency: RON
                        budgeted: '95000.00'
                        actual: '41200.00'
                        forecast: '48000.00'
                        realised: '89200.00'
                        on_budget: false
                        note: null
                      - period_start: '2026-11-01'
                        period_end: '2026-11-30'
                        direction: outflow
                        group: null
                        currency: RON
                        budgeted: '-64000.00'
                        actual: '-30115.75'
                        forecast: '-27400.00'
                        realised: '-57515.75'
                        on_budget: true
                        note: null
                      - period_start: '2026-12-01'
                        period_end: '2026-12-31'
                        direction: inflow
                        group: null
                        currency: RON
                        budgeted: '95000.00'
                        actual: '0.00'
                        forecast: '52000.00'
                        realised: '52000.00'
                        on_budget: null
                        note: null
                      - period_start: '2026-12-01'
                        period_end: '2026-12-31'
                        direction: outflow
                        group: null
                        currency: RON
                        budgeted: '-64000.00'
                        actual: '0.00'
                        forecast: '-31800.00'
                        realised: '-31800.00'
                        on_budget: null
                        note: null
                    balances:
                      - period_start: '2026-10-01'
                        period_end: '2026-10-31'
                        currency: RON
                        final_balance: '208159.50'
                        budgeted_final_balance: null
                      - period_start: '2026-11-01'
                        period_end: '2026-11-30'
                        currency: RON
                        final_balance: '239843.75'
                        budgeted_final_balance: '239159.50'
                      - period_start: '2026-12-01'
                        period_end: '2026-12-31'
                        currency: RON
                        final_balance: null
                        budgeted_final_balance: '270159.50'
                Outflows by category, in total:
                  summary: >-
                    One row per category for the whole window, nested, no
                    balances
                  value:
                    object: budgets_summary
                    period:
                      from: '2026-01-01'
                      to: '2026-12-31'
                      macro: this_year
                      interval: total
                    conversion:
                      applied: false
                      currency: RON
                      basis: none
                    group_by: category
                    has_data: true
                    totals:
                      inflow: null
                      outflow:
                        currency: RON
                        budgeted: '-600000.00'
                        actual: '-497050.00'
                        forecast: '-96000.00'
                        realised: '-593050.00'
                    data:
                      - period_start: '2026-01-01'
                        period_end: '2026-12-31'
                        direction: outflow
                        group:
                          dimension: category
                          id: 6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d
                          label: Marketing
                          parent_id: null
                        currency: RON
                        budgeted: '-60000.00'
                        actual: '-47250.00'
                        forecast: '-6000.00'
                        realised: '-53250.00'
                        on_budget: null
                        note: null
                      - period_start: '2026-01-01'
                        period_end: '2026-12-31'
                        direction: outflow
                        group:
                          dimension: category
                          id: 3b4c5d6e-7f80-4a1b-9c2d-3e4f5a6b7c8d
                          label: Online ads
                          parent_id: 6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d
                        currency: RON
                        budgeted: '-36000.00'
                        actual: '-30100.00'
                        forecast: '-4000.00'
                        realised: '-34100.00'
                        on_budget: null
                        note: null
                      - period_start: '2026-01-01'
                        period_end: '2026-12-31'
                        direction: outflow
                        group:
                          dimension: category
                          id: 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b
                          label: Events
                          parent_id: 6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d
                        currency: RON
                        budgeted: '-24000.00'
                        actual: '-15400.00'
                        forecast: '-2000.00'
                        realised: '-17400.00'
                        on_budget: null
                        note: null
                      - period_start: '2026-01-01'
                        period_end: '2026-12-31'
                        direction: outflow
                        group:
                          dimension: category
                          id: 6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d
                          label: Others for Marketing
                          parent_id: 6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d
                        currency: RON
                        budgeted: '0.00'
                        actual: '-1750.00'
                        forecast: '0.00'
                        realised: '-1750.00'
                        on_budget: null
                        note: null
                      - period_start: '2026-01-01'
                        period_end: '2026-12-31'
                        direction: outflow
                        group:
                          dimension: category
                          id: 8c9d0e1f-2a3b-4c4d-9e5f-6a7b8c9d0e1f
                          label: Salaries
                          parent_id: null
                        currency: RON
                        budgeted: '-540000.00'
                        actual: '-449800.00'
                        forecast: '-90000.00'
                        realised: '-539800.00'
                        on_budget: null
                        note: null
                    balances: []
        '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'
    planning_interval:
      name: interval
      in: query
      description: >-
        Intervalul în care sunt grupate rândurile. `month` pentru fiecare lună
        calendaristică, `total` pentru întreaga fereastră ca un singur interval.
      schema:
        $ref: '#/components/schemas/PlanningInterval'
    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'
    planning_category_id:
      name: category_id
      in: query
      description: >-
        Doar aceste categorii și categoriile imbricate sub ele. 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:
    BudgetsSummary:
      type: object
      required:
        - object
        - period
        - conversion
        - group_by
        - has_data
        - totals
        - data
        - balances
      properties:
        object:
          type: string
          const: budgets_summary
        period:
          $ref: '#/components/schemas/ResolvedPlanningPeriod'
        conversion:
          $ref: '#/components/schemas/Conversion'
        group_by:
          type:
            - string
            - 'null'
          enum:
            - category
            - null
        has_data:
          type: boolean
          description: >-
            `false` când în fereastră nu este nimic bugetat, mișcat sau
            așteptat, spre deosebire de cifrele care dau zero.
        totals:
          $ref: '#/components/schemas/BudgetsSummaryTotals'
        data:
          type: array
          items:
            $ref: '#/components/schemas/BudgetsSummaryRow'
        balances:
          type: array
          description: >-
            Rândul de sold final din tabul Planificare, câte o intrare pe lună.
            Gol cu `interval=total`, `group_by`, `category_id` sau `direction`.
          items:
            $ref: '#/components/schemas/BudgetsBalance'
    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
    PlanningInterval:
      type: string
      description: >-
        Intervalul de timp pentru rândurile de buget și de scenariu, care sunt
        lunare. `total` raportează întreaga fereastră ca un singur interval, ca
        coloana Total de pe ecranul de bugete.
      enum:
        - month
        - total
      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
    ResolvedPlanningPeriod:
      type: object
      description: Fereastra efectiv calculată, extinsă la luni întregi.
      required:
        - from
        - to
        - macro
        - interval
      properties:
        from:
          type: string
          format: date
          description: Prima zi a primei luni.
        to:
          type: string
          format: date
          description: Ultima zi a ultimei luni.
        macro:
          oneOf:
            - $ref: '#/components/schemas/PeriodMacro'
            - type: 'null'
          description: >-
            Macrocomanda care a produs fereastra, sau `null` când datele au fost
            trimise direct sau s-a aplicat fereastra implicită a endpoint-ului.
        interval:
          $ref: '#/components/schemas/PlanningInterval'
    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.
            `own_date` convertește fiecare buget la cursul din prima zi a lunii
            lui, iar fiecare tranzacție și previziune la cursul din data ei.
            `none` când nu s-a convertit nimic.
          enum:
            - transaction_date
            - balance_date
            - own_date
            - none
    BudgetsSummaryTotals:
      type: object
      description: >-
        Coloana Total din tabul Planificare pentru fiecare direcție, pe întreaga
        fereastră și pe aceleași categorii ca rândurile.
      required:
        - inflow
        - outflow
      properties:
        inflow:
          oneOf:
            - $ref: '#/components/schemas/BudgetFigures'
            - type: 'null'
          description: '`null` când `direction` sau `category_id` lasă încasările deoparte.'
        outflow:
          oneOf:
            - $ref: '#/components/schemas/BudgetFigures'
            - type: 'null'
          description: '`null` când `direction` sau `category_id` lasă plățile deoparte.'
    BudgetsSummaryRow:
      type: object
      description: >-
        O direcție a unui interval, sau o categorie a unui interval cu
        `group_by=category`. Plățile sunt negative.
      required:
        - period_start
        - period_end
        - direction
        - group
        - currency
        - budgeted
        - actual
        - forecast
        - realised
        - on_budget
        - note
      properties:
        period_start:
          type: string
          format: date
        period_end:
          type: string
          format: date
        direction:
          $ref: '#/components/schemas/Direction'
        group:
          oneOf:
            - $ref: '#/components/schemas/PlanningCategory'
            - type: 'null'
          description: >-
            Categoria, cu `group_by=category`. `null` pe un rând care reprezintă
            o direcție întreagă.
        currency:
          $ref: '#/components/schemas/Currency'
        budgeted:
          $ref: '#/components/schemas/Money'
          description: Bugetul.
        actual:
          $ref: '#/components/schemas/Money'
          description: Tranzacțiile datate în interval. Coloana Real din tabul Execuție.
        forecast:
          $ref: '#/components/schemas/Money'
          description: >-
            Suma rămasă a previziunilor nerealizate datate în interval. Coloana
            Previzionat din tabul Execuție.
        realised:
          $ref: '#/components/schemas/Money'
          description: >-
            `actual` plus `forecast`. Cifra pe care tabul Planificare o compară
            cu bugetul.
        on_budget:
          type:
            - boolean
            - 'null'
          description: >-
            Pictograma de bifă sau de avertizare din tabul Planificare. `true`
            când `realised` a atins un buget de încasări sau a rămas în limitele
            unui buget de plăți. `null` pentru o lună care nu a început, pentru
            o celulă fără buget și cu `interval=total`.
        note:
          type:
            - string
            - 'null'
          description: >-
            Nota scrisă pe buget. Completată doar pe rândurile de categorie cu
            `interval=month`.
    BudgetsBalance:
      type: object
      description: O lună din rândul de sold final al tabului Planificare.
      required:
        - period_start
        - period_end
        - currency
        - final_balance
        - budgeted_final_balance
      properties:
        period_start:
          type: string
          format: date
        period_end:
          type: string
          format: date
        currency:
          $ref: '#/components/schemas/Currency'
        final_balance:
          oneOf:
            - $ref: '#/components/schemas/Money'
            - type: 'null'
          description: >-
            Soldul cash flow-ului la sfârșitul lunii, proiectat pentru luna în
            curs. `null` pentru o lună care nu a început.
        budgeted_final_balance:
          oneOf:
            - $ref: '#/components/schemas/Money'
            - type: 'null'
          description: >-
            Soldul la sfârșitul lunii dacă bugetele se respectă, dus mai departe
            din luna curentă cu rezultatele nete bugetate. `null` pentru o lună
            încheiată.
    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.
    BudgetFigures:
      type: object
      description: >-
        Coloana Total din tabul Planificare pentru o direcție. Plățile sunt
        negative.
      required:
        - currency
        - budgeted
        - actual
        - forecast
        - realised
      properties:
        currency:
          $ref: '#/components/schemas/Currency'
        budgeted:
          $ref: '#/components/schemas/Money'
          description: Bugetul.
        actual:
          $ref: '#/components/schemas/Money'
          description: Tranzacțiile. Coloana Real din tabul Execuție.
        forecast:
          $ref: '#/components/schemas/Money'
          description: >-
            Suma rămasă a previziunilor nerealizate. Coloana Previzionat din
            tabul Execuție.
        realised:
          $ref: '#/components/schemas/Money'
          description: >-
            `actual` plus `forecast`. Cifra pe care tabul Planificare o compară
            cu bugetul.
    PlanningCategory:
      type: object
      description: >-
        Categoria pe care o reprezintă un rând de buget sau de scenariu.
        Rândurile sunt imbricate ca pe ecran, deci rândul unei categorii părinte
        acoperă întreaga ei ramură. Un rând al cărui `id` este egal cu
        `parent_id` reprezintă banii înregistrați direct pe categoria părinte,
        pe care ecranul de bugete îi arată ca „Altele din" părinte.
      required:
        - dimension
        - id
        - label
        - parent_id
      properties:
        dimension:
          type: string
          const: category
        id:
          type: string
          format: uuid
        label:
          type: string
          example: Marketing
        parent_id:
          type:
            - string
            - 'null'
          format: uuid
          description: >-
            Id-ul categoriei sub care este imbricat rândul. `null` pentru o
            categorie de pe primul nivel.
    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'
  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.