> ## 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ă un scenariu

> Ce arată tabul unui scenariu pe ecranul de scenarii, pe lună sau pentru întreaga fereastră, pe interval sau pe categorie. Trimite `period`, sau atât `from`, cât și `to`, sau niciunul pentru lunile scenariului.

Fereastra se extinde la luni întregi și se limitează la lunile scenariului. O fereastră din afara lor este respinsă cu 400. Sumele sunt în moneda spațiului de lucru și nu se convertesc niciodată. Plățile sunt negative.

Fără `group_by` există câte un rând pe interval cu `inflow`, `outflow` și `net`, plus liniile de sold ale tabului. `final_balance` este `starting_balance` plus `net`, cum îl calculează tabul. `opened_accounts`, `transfers` și `excluded` apar alături de el și nu intră în el. Un scenariu `dynamic` are toate liniile. Un scenariu `snapshot` are `opened_accounts`, `transfers` și `excluded`, mai puțin liniile care sunt zero în fiecare lună. Un scenariu `blank` are doar `final_balance`. Liniile pe care tabul nu le arată sunt `null`.

`totals` acoperă întreaga fereastră: fluxurile și liniile de sold însumate, `starting_balance` al primului interval și `final_balance` al ultimului.

Cu `group_by=category` există câte un rând pe categorie pe interval, imbricat 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. `edited` este `true` acolo unde scenariul stabilește el însuși suma, în loc să o ia din cash flow. O categorie apare într-un interval când are o sumă sau când scenariul a modificat-o. `category_id` restrânge rândurile și `totals` la acele categorii și la cele imbricate sub ele, iar câmpurile de sold sunt atunci `null`.

**Un scenariu lună de lună**

```http
GET /scenarios/2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f/summary
```

**Un scenariu pe categorii, pe toată fereastra lui**

```http
GET /scenarios/2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f/summary?interval=total&group_by=category
```



## OpenAPI

````yaml /openapi/v1.ro.yaml get /scenarios/{id}/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/{id}/summary:
    get:
      tags:
        - Scenarii
      summary: Sintetizează un scenariu
      description: >-
        Ce arată tabul unui scenariu pe ecranul de scenarii, pe lună sau pentru
        întreaga fereastră, pe interval sau pe categorie. Trimite `period`, sau
        atât `from`, cât și `to`, sau niciunul pentru lunile scenariului.


        Fereastra se extinde la luni întregi și se limitează la lunile
        scenariului. O fereastră din afara lor este respinsă cu 400. Sumele sunt
        în moneda spațiului de lucru și nu se convertesc niciodată. Plățile sunt
        negative.


        Fără `group_by` există câte un rând pe interval cu `inflow`, `outflow`
        și `net`, plus liniile de sold ale tabului. `final_balance` este
        `starting_balance` plus `net`, cum îl calculează tabul.
        `opened_accounts`, `transfers` și `excluded` apar alături de el și nu
        intră în el. Un scenariu `dynamic` are toate liniile. Un scenariu
        `snapshot` are `opened_accounts`, `transfers` și `excluded`, mai puțin
        liniile care sunt zero în fiecare lună. Un scenariu `blank` are doar
        `final_balance`. Liniile pe care tabul nu le arată sunt `null`.


        `totals` acoperă întreaga fereastră: fluxurile și liniile de sold
        însumate, `starting_balance` al primului interval și `final_balance` al
        ultimului.


        Cu `group_by=category` există câte un rând pe categorie pe interval,
        imbricat 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. `edited` este `true` acolo unde scenariul stabilește el însuși
        suma, în loc să o ia din cash flow. O categorie apare într-un interval
        când are o sumă sau când scenariul a modificat-o. `category_id`
        restrânge rândurile și `totals` la acele categorii și la cele imbricate
        sub ele, iar câmpurile de sold sunt atunci `null`.


        **Un scenariu lună de lună**


        ```http

        GET /scenarios/2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f/summary

        ```


        **Un scenariu pe categorii, pe toată fereastra lui**


        ```http

        GET
        /scenarios/2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f/summary?interval=total&group_by=category

        ```
      operationId: summariseScenario
      parameters:
        - $ref: '#/components/parameters/id'
        - $ref: '#/components/parameters/period'
        - $ref: '#/components/parameters/window_from'
        - $ref: '#/components/parameters/window_to'
        - $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 interval.
          schema:
            type: string
            enum:
              - category
        - $ref: '#/components/parameters/planning_category_id'
      responses:
        '200':
          description: Tabul scenariului.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScenarioSummary'
              examples:
                By month:
                  summary: One row per month with the tab's balance lines
                  value:
                    object: scenario_summary
                    scenario:
                      id: 2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f
                      name: Pessimistic
                      type: dynamic
                    period:
                      from: '2026-11-01'
                      to: '2026-12-31'
                      macro: null
                      interval: month
                    currency: RON
                    group_by: null
                    has_data: true
                    totals:
                      period_start: '2026-11-01'
                      period_end: '2026-12-31'
                      currency: RON
                      inflow: '160000.00'
                      outflow: '-127500.00'
                      net: '32500.00'
                      starting_balance: '208159.50'
                      opened_accounts: '0.00'
                      transfers: '0.00'
                      excluded: '-1500.00'
                      final_balance: '240659.50'
                    data:
                      - period_start: '2026-11-01'
                        period_end: '2026-11-30'
                        currency: RON
                        inflow: '82000.00'
                        outflow: '-61500.00'
                        net: '20500.00'
                        starting_balance: '208159.50'
                        opened_accounts: '0.00'
                        transfers: '0.00'
                        excluded: '-1500.00'
                        final_balance: '228659.50'
                      - period_start: '2026-12-01'
                        period_end: '2026-12-31'
                        currency: RON
                        inflow: '78000.00'
                        outflow: '-66000.00'
                        net: '12000.00'
                        starting_balance: '228659.50'
                        opened_accounts: '0.00'
                        transfers: '0.00'
                        excluded: '0.00'
                        final_balance: '240659.50'
                By category, in total:
                  summary: One row per category for the scenario's whole window
                  value:
                    object: scenario_summary
                    scenario:
                      id: 2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f
                      name: Pessimistic
                      type: dynamic
                    period:
                      from: '2026-11-01'
                      to: '2027-10-31'
                      macro: null
                      interval: total
                    currency: RON
                    group_by: category
                    has_data: true
                    totals:
                      period_start: '2026-11-01'
                      period_end: '2027-10-31'
                      currency: RON
                      inflow: '912000.00'
                      outflow: '-588000.00'
                      net: '324000.00'
                      starting_balance: '208159.50'
                      opened_accounts: '0.00'
                      transfers: '0.00'
                      excluded: '-1500.00'
                      final_balance: '532159.50'
                    data:
                      - period_start: '2026-11-01'
                        period_end: '2027-10-31'
                        direction: inflow
                        group:
                          dimension: category
                          id: 1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d
                          label: Sales
                          parent_id: null
                        currency: RON
                        amount: '912000.00'
                        edited: true
                        note: null
                      - period_start: '2026-11-01'
                        period_end: '2027-10-31'
                        direction: outflow
                        group:
                          dimension: category
                          id: 8c9d0e1f-2a3b-4c4d-9e5f-6a7b8c9d0e1f
                          label: Salaries
                          parent_id: null
                        currency: RON
                        amount: '-540000.00'
                        edited: false
                        note: null
                      - period_start: '2026-11-01'
                        period_end: '2027-10-31'
                        direction: outflow
                        group:
                          dimension: category
                          id: 6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d
                          label: Marketing
                          parent_id: null
                        currency: RON
                        amount: '-48000.00'
                        edited: true
                        note: null
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/RequestTooLarge'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  parameters:
    id:
      name: id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    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'
    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
  schemas:
    ScenarioSummary:
      type: object
      required:
        - object
        - scenario
        - period
        - currency
        - group_by
        - has_data
        - totals
        - data
      properties:
        object:
          type: string
          const: scenario_summary
        scenario:
          $ref: '#/components/schemas/ScenarioReference'
        period:
          $ref: '#/components/schemas/ResolvedPlanningPeriod'
        currency:
          $ref: '#/components/schemas/Currency'
          description: >-
            Moneda spațiului de lucru. Sumele scenariilor nu se convertesc
            niciodată.
        group_by:
          type:
            - string
            - 'null'
          enum:
            - category
            - null
        has_data:
          type: boolean
          description: >-
            `false` când `totals.inflow`, `totals.outflow` și
            `totals.final_balance` sunt toate zero sau lipsesc.
        totals:
          $ref: '#/components/schemas/ScenarioPeriod'
        data:
          type: array
          description: >-
            Câte un `ScenarioPeriod` pe interval fără `group_by`. Câte un
            `ScenarioCategoryRow` pe categorie pe interval cu
            `group_by=category`.
          items:
            oneOf:
              - $ref: '#/components/schemas/ScenarioPeriod'
              - $ref: '#/components/schemas/ScenarioCategoryRow'
    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
    ScenarioReference:
      type: object
      description: Scenariul raportat.
      required:
        - id
        - name
        - type
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
          example: Pessimistic
        type:
          $ref: '#/components/schemas/ScenarioType'
    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
    ScenarioPeriod:
      type: object
      description: >-
        Un interval din tabul unui scenariu, sau întreaga lui fereastră în
        `totals`. Plățile sunt negative.
      required:
        - period_start
        - period_end
        - currency
        - inflow
        - outflow
        - net
        - starting_balance
        - opened_accounts
        - transfers
        - excluded
        - final_balance
      properties:
        period_start:
          type: string
          format: date
        period_end:
          type: string
          format: date
        currency:
          $ref: '#/components/schemas/Currency'
        inflow:
          $ref: '#/components/schemas/Money'
        outflow:
          $ref: '#/components/schemas/Money'
        net:
          $ref: '#/components/schemas/Money'
          description: '`inflow` plus `outflow`.'
        starting_balance:
          oneOf:
            - $ref: '#/components/schemas/Money'
            - type: 'null'
          description: >-
            Soldul scenariului la începutul intervalului. `null` pe un scenariu
            `blank` și cu `category_id`.
        opened_accounts:
          oneOf:
            - $ref: '#/components/schemas/Money'
            - type: 'null'
          description: >-
            Soldurile inițiale ale conturilor deschise în interval. Afișate
            alături de soldul final, fără să facă parte din el. `null` acolo
            unde tabul nu are această linie și cu `category_id`.
        transfers:
          oneOf:
            - $ref: '#/components/schemas/Money'
            - type: 'null'
          description: >-
            Netul transferurilor între conturile proprii ale spațiului de lucru
            în interval. Afișat alături de soldul final, fără să facă parte din
            el. `null` acolo unde tabul nu are această linie și cu
            `category_id`.
        excluded:
          oneOf:
            - $ref: '#/components/schemas/Money'
            - type: 'null'
          description: >-
            Netul mișcărilor excluse din cash flow în interval. Afișat alături
            de soldul final, fără să facă parte din el. `null` acolo unde tabul
            nu are această linie și cu `category_id`.
        final_balance:
          oneOf:
            - $ref: '#/components/schemas/Money'
            - type: 'null'
          description: >-
            Soldul scenariului la sfârșitul intervalului, cum îl arată tabul
            lui, adică soldul de la începutul intervalului plus `net`. `null` cu
            `category_id`.
    ScenarioCategoryRow:
      type: object
      description: O categorie a unui interval din tabul unui scenariu.
      required:
        - period_start
        - period_end
        - direction
        - group
        - currency
        - amount
        - edited
        - note
      properties:
        period_start:
          type: string
          format: date
        period_end:
          type: string
          format: date
        direction:
          $ref: '#/components/schemas/Direction'
        group:
          $ref: '#/components/schemas/PlanningCategory'
        currency:
          $ref: '#/components/schemas/Currency'
        amount:
          $ref: '#/components/schemas/Money'
          description: >-
            Suma scenariului pentru categorie în interval. Negativă pentru
            plăți.
        edited:
          type: boolean
          description: >-
            `true` acolo unde scenariul stabilește el însuși suma în interval,
            `false` acolo unde un scenariu `dynamic` o ia din cash flow.
        note:
          type:
            - string
            - 'null'
          description: Nota scrisă pe celulă. Completată doar cu `interval=month`.
    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.
    ScenarioType:
      type: string
      description: >-
        `dynamic` este cash flow-ul, realizat și încă așteptat, cu modificările
        scenariului peste el, și se mișcă odată cu datele. `snapshot` este o
        copie a cash flow-ului făcută la crearea scenariului, apoi modificată.
        `blank` conține doar sumele introduse în el, pornind de la soldul lui
        inițial.
      enum:
        - dynamic
        - snapshot
        - blank
    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'
    Direction:
      type: string
      description: >-
        Dacă banii intră sau ies. Pe o tranzacție sau o previziune urmează
        semnul lui `amount`.
      enum:
        - inflow
        - outflow
    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.
  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
    NotFound:
      description: Nu există niciun obiect cu acest id în spațiul de lucru al cheii.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              type: not_found
              code: resource_not_found
              message: Transaction not found
              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.