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.
Autorizări
O cheie API creată în setările ThinkOut. O cheie citește un singur spațiu de lucru.
Parametri interogare
Prima zi a intervalului, inclusiv.
Ultima zi a intervalului, inclusiv.
Intervalul de timp în care sunt grupate rândurile. O perioadă de grupare pentru rândurile de raport. Aceleași perioade pe care le oferă ecranul de cash flow din ThinkOut.
day, week, month O a doua dimensiune de grupare, pe lângă intervalul de timp. Cel mult una. Omite-o pentru un singur rând per interval. O dimensiune după care se grupează rândurile raportului, pe lângă intervalul de timp.
category, counterparty, label, account, activity, direction 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ă.
Cod de monedă alfabetic ISO 4217.
^[A-Z]{3}$"RON"
Doar rândurile de pe conturile alimentate de aceste conexiuni bancare. Separate prin virgulă pentru mai multe.
Doar rândurile de pe aceste conturi. Separate prin virgulă pentru mai multe.
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.
Doar rândurile care poartă cel puțin una dintre aceste etichete. Separate prin virgulă pentru mai multe.
Doar rândurile atribuite acestor parteneri. Separate prin virgulă pentru mai multe.
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.
inflow, outflow Răspuns
Sinteza.
"summary"Fereastra efectiv calculată, după rezolvarea oricărei macrocomenzi sau a datelor relative salvate.
Ce s-a făcut pentru ca sumele să fie comparabile.
O dimensiune după care se grupează rândurile raportului, pe lângă intervalul de timp.
category, counterparty, label, account, activity, direction false când nu s-a potrivit nimic. Distinge între „nu există tranzacții aici” și totaluri care chiar au ieșit zero.
Întregul interval însumat, după aceleași excluderi ca rândurile.