Costs, credits and limits

Sekcje Koszty, Kredyty i Polecenia organizacji (Panel → organizacja) pokazują, za co płacisz, i pozwalają tym zarządzać. Wszystkie kwoty kosztów są w PLN netto, saldo kredytów w PLN brutto.

Eksplorator kosztów

Koszt per projekt, usługa i dzień dla wybranego miesiąca: opłata za plan (rozłożona na dni), compute (godzinowo), transfer, Edge Functions, rozmiar bazy i storage, e-mail, AI Gateway i Workers. Nadwyżki ponad limity planu trafiają na dzień, w którym limit został przekroczony, więc suma miesiąca zgadza się z fakturą. Prognoza na koniec miesiąca łączy regresję liniową z dotychczasowych dni z bieżącym tempem (średnia z 7 dni) i pokazuje zakres ±1σ. Porównanie z poprzednim miesiącem dotyczy tej samej liczby dni. Eksport CSV: przycisk w panelu lub GET /api/orgs/{slug}/costs/export?period=YYYY-MM.

Nowa usługa rozliczana (Sites, Apps, wolumeny…) dołącza do eksploratora przez rejestr źródeł kosztów: plik lib/finops/sources/<usługa>.ts z wywołaniem registerCostSource() i jedna linia importu w sources/index.ts.

Kredyty prepaid

Doładowanie (50–2500 zł lub własna kwota, Stripe Checkout; bez Stripe — checkout demo) zasila saldo kredytów. Cena brutto = wartość kredytów. Kredyty są zużywane przed fakturą: faktura za zużycie dostaje ujemne pozycje rozliczenia, a kwota do zapłaty to reszta (przy pełnym pokryciu faktura od razu jest opłacona). Zużywamy najpierw pule wygasające najwcześniej. Księga kredytów jest idempotentna — ponowione zdarzenie Stripe czy ponowne generowanie faktur nie zdubluje salda ani zużycia. Alerty: niskie saldo (próg do ustawienia lub < 5 dni zużycia) i zbliżające się wygaśnięcie. Kredyty z zakupu domyślnie nie wygasają, promocyjne ważą 12 miesięcy.

VAT

Kredyty to bon jednego przeznaczenia (art. 2 pkt 41–43 i art. 8a ustawy o VAT, art. 30a–30b dyrektywy 2006/112/WE): usługi i VAT są znane w chwili sprzedaży, więc faktura VAT na kredyty (pozycja „Bon jednego przeznaczenia”) jest wystawiana przy zakupie ze stawką wynikającą z danych nabywcy (23% / np). Wykorzystanie bonu nie jest drugą dostawą — na fakturze za zużycie widać ujemną pozycję „Rozliczenie bonu”, która odejmuje wartość netto i VAT już zafakturowany. Kredyty promocyjne (polecenia) nie były sprzedane, więc są rabatem obniżającym podstawę opodatkowania. Zwrot niewykorzystanego bonu odbywa się fakturą korygującą. Kredyty nie są pieniądzem elektronicznym: działają tylko u jednego wystawcy, na jego usługi.

Limity wydatków

Miesięczny limit (PLN netto) dla organizacji lub projektu. Powiadomienia przy 50%, 80% i 100%. Akcja po 100%: alert; blokada nowych zasobów (projekty, workery; brak wznowienia wstrzymanych projektów); zatrzymanie (blokada + wstrzymanie działających projektów). Blokada znika po zwiększeniu limitu lub z nowym miesiącem. Limity liczą tylko pozycje naliczane na fakturze i są sprawdzane co kilka minut.

Program poleceń

Kod i link /r/KOD. Po zakwalifikowaniu się nowej organizacji (opłacone co najmniej 50 zł, płatność starsza niż 14 dni i niezwrócona, projekt uruchomiony łącznie 7 dni) obie strony dostają po 50 zł kredytów promocyjnych. Zabezpieczenia: jedna organizacja = jedno polecenie, ten sam właściciel/administrator, e-mail, konto Stripe, NIP, VAT-UE lub e-mail do faktur wykluczają nagrodę, maks. 10 nagród rocznie na polecającego, tylko kredyty (bez prowizji).

Active CPU (opcjonalnie)

Domyślnie Functions rozliczamy za wywołania, a Workers za godziny repliki. Flaga BILLING_ACTIVE_CPU=true (lub włączenie dla organizacji przez administratora platformy) przełącza na godziny aktywnego CPU: Functions wg czasu CPU wywołań, Workers wg godzin ważonych użyciem CPU (min. 10%). To szacunek oparty na metrykach agenta.

Management API i MCP

GET    /api/v1/organizations/{slug}/costs?period=2026-10&project={ref}&detail=1
GET    /api/v1/organizations/{slug}/credits
GET|PUT|DELETE /api/v1/organizations/{slug}/spend-limits   # PUT {"amount":500,"action":"block","project":"ref"}

Narzędzia MCP: get_org_costs, get_org_credits, list_spend_limits, set_spend_limit, delete_spend_limit.