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

> Tabul Toate de pe ecranul de scenarii: pe lună, soldul final al cash flow-ului alături de cel al fiecărui scenariu. Trimite `period`, sau atât `from`, cât și `to`, sau niciunul pentru fereastra tabului, luna aceasta și cele douăsprezece de după ea.

Fereastra se extinde la luni întregi. `cash_flow_final_balance` este soldul final al cash flow-ului, cum îl arată ecranul de cash flow, proiectat pentru lunile care se termină după azi. `final_balance` al unui scenariu este soldul lui de început plus rezultatul net, cum îl arată tabul scenariului, și este `null` în lunile din afara scenariului. Soldul final al cash flow-ului include și conturile deschise, transferurile și mișcările excluse, așa că soldul final al unui scenariu poate diferi de el chiar și în lunile pe care scenariul nu le schimbă.

Cu `interval=total` există un singur rând, cu soldurile de la sfârșitul ferestrei. Sumele sunt în moneda spațiului de lucru și nu se convertesc niciodată.

**Cash flow-ul și fiecare scenariu, lună de lună, pentru anul următor**

```http
GET /scenarios/summary
```



## OpenAPI

````yaml /openapi/v1.ro.yaml get /scenarios/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:
  /scenarios/summary:
    get:
      tags:
        - Scenarii
      summary: Sintetizează scenariile
      description: >-
        Tabul Toate de pe ecranul de scenarii: pe lună, soldul final al cash
        flow-ului alături de cel al fiecărui scenariu. Trimite `period`, sau
        atât `from`, cât și `to`, sau niciunul pentru fereastra tabului, luna
        aceasta și cele douăsprezece de după ea.


        Fereastra se extinde la luni întregi. `cash_flow_final_balance` este
        soldul final al cash flow-ului, cum îl arată ecranul de cash flow,
        proiectat pentru lunile care se termină după azi. `final_balance` al
        unui scenariu este soldul lui de început plus rezultatul net, cum îl
        arată tabul scenariului, și este `null` în lunile din afara scenariului.
        Soldul final al cash flow-ului include și conturile deschise,
        transferurile și mișcările excluse, așa că soldul final al unui scenariu
        poate diferi de el chiar și în lunile pe care scenariul nu le schimbă.


        Cu `interval=total` există un singur rând, cu soldurile de la sfârșitul
        ferestrei. Sumele sunt în moneda spațiului de lucru și nu se convertesc
        niciodată.


        **Cash flow-ul și fiecare scenariu, lună de lună, pentru anul următor**


        ```http

        GET /scenarios/summary

        ```
      operationId: summariseScenarios
      parameters:
        - $ref: '#/components/parameters/period'
        - $ref: '#/components/parameters/window_from'
        - $ref: '#/components/parameters/window_to'
        - $ref: '#/components/parameters/planning_interval'
      responses:
        '200':
          description: Tabul Toate.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScenariosSummary'
              example:
                object: scenarios_summary
                period:
                  from: '2026-11-01'
                  to: '2027-01-31'
                  macro: null
                  interval: month
                currency: RON
                data:
                  - period_start: '2026-11-01'
                    period_end: '2026-11-30'
                    currency: RON
                    cash_flow_final_balance: '239843.75'
                    scenarios:
                      - id: 2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f
                        name: Pessimistic
                        final_balance: '228659.50'
                      - id: 7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a
                        name: Hiring two developers
                        final_balance: null
                  - period_start: '2026-12-01'
                    period_end: '2026-12-31'
                    currency: RON
                    cash_flow_final_balance: '251210.40'
                    scenarios:
                      - id: 2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f
                        name: Pessimistic
                        final_balance: '240659.50'
                      - id: 7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a
                        name: Hiring two developers
                        final_balance: null
                  - period_start: '2027-01-01'
                    period_end: '2027-01-31'
                    currency: RON
                    cash_flow_final_balance: '266480.90'
                    scenarios:
                      - id: 2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f
                        name: Pessimistic
                        final_balance: '247159.50'
                      - id: 7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a
                        name: Hiring two developers
                        final_balance: '236000.00'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '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'
    window_from:
      name: from
      in: query
      description: >-
        Prima zi a ferestrei, inclusiv. Trimite-o împreună cu `to`. Omite
        `period`, `from` și `to` pentru fereastra implicită.
      schema:
        type: string
        format: date
    window_to:
      name: to
      in: query
      description: >-
        Ultima zi a ferestrei, inclusiv. Trimite-o împreună cu `from`. Omite
        `period`, `from` și `to` pentru fereastra implicită.
      schema:
        type: string
        format: date
    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'
  schemas:
    ScenariosSummary:
      type: object
      required:
        - object
        - period
        - currency
        - data
      properties:
        object:
          type: string
          const: scenarios_summary
        period:
          $ref: '#/components/schemas/ResolvedPlanningPeriod'
        currency:
          $ref: '#/components/schemas/Currency'
          description: >-
            Moneda spațiului de lucru. Sumele scenariilor nu se convertesc
            niciodată.
        data:
          type: array
          items:
            $ref: '#/components/schemas/ScenariosSummaryRow'
    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
    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'
    Currency:
      type: string
      description: Cod de monedă alfabetic ISO 4217.
      pattern: ^[A-Z]{3}$
      example: RON
    ScenariosSummaryRow:
      type: object
      description: Un interval din tabul Toate.
      required:
        - period_start
        - period_end
        - currency
        - cash_flow_final_balance
        - scenarios
      properties:
        period_start:
          type: string
          format: date
        period_end:
          type: string
          format: date
        currency:
          $ref: '#/components/schemas/Currency'
        cash_flow_final_balance:
          $ref: '#/components/schemas/Money'
          description: >-
            Soldul cash flow-ului la sfârșitul intervalului, proiectat când
            intervalul se termină după azi.
        scenarios:
          type: array
          description: >-
            Fiecare scenariu din spațiul de lucru, cu soldul lui la sfârșitul
            intervalului.
          items:
            $ref: '#/components/schemas/ScenarioFinalBalance'
    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'
    ScenarioFinalBalance:
      type: object
      required:
        - id
        - name
        - final_balance
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
          example: Pessimistic
        final_balance:
          oneOf:
            - $ref: '#/components/schemas/Money'
            - type: 'null'
          description: >-
            Soldul scenariului la sfârșitul intervalului, cum îl arată tabul
            lui. `null` într-un interval din afara lunilor scenariului.
  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
    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.