Polish tax calculators for B2B sole traders and employees: PIT, ZUS, VAT, leasing. No account.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Średnia z kwot z wyników narzędzi — zamiast dzielenia w pamięci. Z period { from, to } (RRRR-MM, oba włącznie): suma kwot ÷ miesiące okresu, np. „ile średnio miesięcznie od tego kontrahenta”; miesiące liczy narzędzie. Z count: suma ÷ liczba, np. średnio na jeden przelew. Bez obu: średnia kilku kwot (np. miesięcy z tabeli). Kwoty podaj dokładnie tak, jak zwróciło je narzędzie.
Kwoty: jedna suma albo kilka wartości (np. miesięcy)
Średnio na jedną: suma kwot ÷ liczba (np. operacji)
Średnia miesięczna: suma kwot ÷ miesiące okresu, oba końce włącznie
Kwoty to prognoza — wtedy okres może sięgać przyszłych miesięcy
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http kalkulator-b2b https://www.kalkulatorb2b.pl/mcp
Średnia z kwot z wyników narzędzi — zamiast dzielenia w pamięci. Z period { from, to } (RRRR-MM, oba włącznie): suma kwot ÷ miesiące okresu, np. „ile średnio miesięcznie od tego kontrahenta”; miesiące liczy narzędzie. Z count: suma ÷ liczba, np. średnio na jeden przelew. Bez obu: średnia kilku kwot (np. miesięcy z tabeli). Kwoty podaj dokładnie tak, jak zwróciło je narzędzie.
| Argument | Type | Description |
|---|---|---|
| count | integer | Średnio na jedną: suma kwot ÷ liczba (np. operacji) |
| period | object | Średnia miesięczna: suma kwot ÷ miesiące okresu, oba końce włącznie |
| amounts* | array | Kwoty: jedna suma albo kilka wartości (np. miesięcy) |
| forecast | boolean | Kwoty to prognoza — wtedy okres może sięgać przyszłych miesięcy |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"amounts"
],
"properties": {
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Średnio na jedną: suma kwot ÷ liczba (np. operacji)"
},
"period": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}$",
"description": "Ostatni miesiąc okresu, RRRR-MM (włącznie)"
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}$",
"description": "Pierwszy miesiąc okresu, RRRR-MM"
}
},
"description": "Średnia miesięczna: suma kwot ÷ miesiące okresu, oba końce włącznie",
"additionalProperties": false
},
"amounts": {
"type": "array",
"items": {
"type": [
"number",
"string"
],
"description": "Kwota w złotych dokładnie tak, jak zwróciło ją narzędzie, np. 149915.26"
},
"maxItems": 500,
"minItems": 1,
"description": "Kwoty: jedna suma albo kilka wartości (np. miesięcy)"
},
"forecast": {
"type": "boolean",
"description": "Kwoty to prognoza — wtedy okres może sięgać przyszłych miesięcy"
}
},
"additionalProperties": false
}Porównuje skalę, podatek liniowy i ryczałt przy tym samym przychodzie i kosztach, w skali roku (dwanaście miesięcy takich jak podany). Zwraca roczną kwotę do zapłaty formy obecnej i najkorzystniejszej oraz różnicę — rocznie i średnio na miesiąc. Bez ryczaltRate porównuje tylko skalę i liniowy: stawka ryczałtu zależy od rodzaju działalności, więc narzędzie jej nie zgaduje. ZUS społeczny to etap podanego miesiąca, jak w b2b_monthly: przy zusVariant BRAK (ulga na start) miesiąc działalności 1–6 bez ZUS społecznego, potem Mały ZUS — liczony od zusStart (pierwszego pełnego miesiąca ulgi), a bez niego od stycznia; dwanaście miesięcy porównania jest na tym jednym etapie i wynik mówi, na którym. Gdy wynik wlicza dobrowolną składkę chorobową, a sickness nie podano, wynik to mówi i każe o nią zapytać.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| ipbox | boolean | IP Box — 5% od kwalifikowanego dochodu |
| month* | integer | Miesiąc 1-12 |
| sickness | boolean | Dobrowolna składka chorobowa |
| zusStart | object | Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej. Nie później niż liczony miesiąc — przy BRAK najwyżej miesiąc po nim: miesiąc tuż przed zusStart to miesiąc założenia w trakcie miesiąca, objęty ulgą od dnia założenia. Bez tego pola przy BRAK narzędzie liczy miesiąc jako miesiąc działalności firmy założonej w styczniu tego roku i pisze to w wyniku, a przy PREFERENCYJNY — jako Mały ZUS. Przy DUZY_ZUS i UOP bez znaczenia |
Rozlicza stratę z lat ubiegłych według art. 9 ust. 3 ustawy o PIT: jednorazowo do 5 mln zł, reszta przez pięć lat po najwyżej połowie rocznie. Ryczałt strat nie przenosi i narzędzie mówi to wprost.
| Argument | Type | Description |
|---|---|---|
| years* | array | |
| taxForm* | string | LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"taxForm",
"years"
],
"properties": {
"years": {
"type": "array",
"items": {
"type": "object",
"required": [
"year",
"income"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2035,
"minimum": 2015
},
"income": {
"type": "number",
"description": "Dochód roczny — ujemny znaczy stratę"
}
}
},
"maxItems": 10,
"minItems": 1
},
"taxForm": {
"enum": [
"LINIOWY",
"SKALA",
"RYCZALT"
],
"type": "string",
"description": "LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu"
}
}
}Liczy podatki za miesiąc wprost z listy faktur: sprzedażowych i zakupowych. Przepisz pozycje z dokumentów (netto, kwota VAT, tryb VAT), a narzędzie zsumuje je samo i zwróci PIT, ZUS, składkę zdrowotną oraz VAT należny, naliczony i do zapłaty. Obsługuje odwrotne obciążenie („np"), zwolnienie, 0% i częściowe odliczenie VAT (np. 50% od samochodu). NIE sumuj kwot samodzielnie — od tego jest to narzędzie. Przy zusVariant BRAK (ulga na start) narzędzie liczy etap miesiąca działalności: 1–6 bez ZUS społecznego, potem Mały ZUS — te same etapy co w b2b_year. Miesiące działalności liczy od zusStart (pierwszego pełnego miesiąca ulgi: miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny; miesiąc tuż przed nim to miesiąc założenia firmy założonej w trakcie miesiąca, też bez ZUS społecznego); bez zusStart podany miesiąc jest zarazem miesiącem działalności (firma od stycznia) i wynik to mówi. Gdy firma po uldze płaci pełny ZUS, policz z DUZY_ZUS. Gdy nie wiesz, od kiedy firma działa, zapytaj o datę założenia i policz ten miesiąc z zusStart; gdy nie wiesz, co płaci po uldze albo czy płaci dobrowolną chorobową — też zapytaj. Cały rok z etapami ZUS liczy b2b_year z zusStart, gdy ulga trwała już w styczniu tego roku.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| month* | integer | Miesiąc rozliczenia. Dla sprzedaży decyduje DATA WYKONANIA USŁUGI, nie data wystawienia — faktura wystawiona w sierpniu za lipiec należy do lipca |
| taxForm* | string | LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu |
Pełne rozliczenie miesiąca na działalności: PIT, ZUS społeczny, składka zdrowotna, VAT i danina solidarnościowa. Obsługuje kilka źródeł przychodu (także walutowych), koszty pozycja po pozycji, IP Box, wspólne rozliczenie z małżonkiem, ulgę na powrót, odkładanie na urlop i odliczenie straty z lat ubiegłych. Miesiąc liczony tak, jakby był jedynym w roku: bez dochodu wcześniejszych miesięcy, na skali z 1/12 kwoty zmniejszającej i progiem 32% wobec dochodu tego jednego miesiąca. Zaliczki narastająco i próg skali w roku liczy b2b_year. Przy zusVariant BRAK (ulga na start) narzędzie liczy etap miesiąca działalności: 1–6 bez ZUS społecznego, potem Mały ZUS — te same etapy co w b2b_year. Miesiące działalności liczy od zusStart (pierwszego pełnego miesiąca ulgi: miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny; miesiąc tuż przed nim to miesiąc założenia firmy założonej w trakcie miesiąca, też bez ZUS społecznego); bez zusStart podany miesiąc jest zarazem miesiącem działalności (firma od stycznia) i wynik to mówi. Gdy firma po uldze płaci pełny ZUS, policz z DUZY_ZUS. Gdy nie wiesz, od kiedy firma działa, zapytaj o datę założenia i policz ten miesiąc z zusStart; gdy nie wiesz, co płaci po uldze albo czy płaci dobrowolną chorobową — też zapytaj. Cały rok z etapami ZUS liczy b2b_year z zusStart, gdy ulga trwała już w styczniu tego roku.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| ipbox | boolean | IP Box — 5% od kwalifikowanego dochodu |
| month* | integer | Miesiąc 1-12 |
| taxForm* |
Projekcja na kilka lat z podanym wzrostem przychodu i kosztów (netto). Każdy rok liczony jak w b2b_year: na skali PIT od dochodu całego roku, z rocznym progiem 32% i kwotą zmniejszającą; liniowy PIT, danina i zdrowotna miesiąc po miesiącu, bez rozliczenia rocznego (miesiące, w których rok przez to odbiega od rozliczenia, wynik wskazuje). Ulga na start (BRAK; po niej Mały ZUS i pełny albo od razu pełny — zusAfterRelief, bez niego Mały ZUS jako założenie) i Mały ZUS (PREFERENCYJNY) biegną przez kolejne lata od zusStart, bez niego od stycznia startYear — wynik to mówi i podaje miesiące, od których ZUS rośnie. Na rękę = przychód − koszty − obciążenia (PIT, danina, ZUS, zdrowotna); VAT należny i do zapłaty nie wchodzi ani do obciążeń, ani do kwoty na rękę, a nadwyżki VAT naliczonego nad należnym projekcja nie odzyskuje i mówi wtedy, o ile pomniejsza kwotę na rękę. Bez isVatPayer przyjmuje czynnego podatnika VAT i pisze to w wyniku. Rok z opublikowanymi stałymi liczy się na własnych progach, stawkach i płacy minimalnej. Rok, na który rejestr nie ma jeszcze stałych, liczy się na stałych ostatniego opublikowanego roku i jest oznaczony gwiazdką jako założenie. Projekcji nie da się zacząć przed pierwszym rokiem rejestru.
| Argument | Type | Description |
|---|---|---|
| years* | integer | Ile lat policzyć |
| taxForm* | string | LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu |
| sickness | boolean | |
| zusStart | object | Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej, także przez kolejne lata. Nie później niż styczeń pierwszego roku projekcji. Bez tego pola narzędzie liczy etap od stycznia tego roku i pisze to w wyniku. Przy DUZY_ZUS i UOP bez znaczenia |
Porównuje umowę o pracę z działalnością: ile zostaje na rękę w jednym i w drugim, przy podanej stawce na fakturze oraz przy stawce równej całkowitemu kosztowi pracodawcy. Pokazuje też, czego na B2B nie ma w cenie — urlopu i chorobowego. Działalność liczona na czerwcu podanego roku. Przy zusVariant BRAK (ulga na start) liczy etap czerwca: miesiąc działalności 1–6 bez ZUS społecznego, potem Mały ZUS — od zusStart (pierwszego pełnego miesiąca ulgi), a bez niego czerwiec to 6. miesiąc ulgi, czyli działalność bez ZUS społecznego; wynik mówi, na którym etapie liczył. Rok po uldze porównaj z zusVariant PREFERENCYJNY. Gdy wynik wlicza dobrowolną składkę chorobową na B2B, a sickness nie podano, wynik to mówi i każe o nią zapytać.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| hasPIT2 | boolean | |
| taxForm* | string | LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu |
| sickness | boolean | Dobrowolna składka chorobowa na działalności (B2B). Pominięta = wliczona na Małym i pełnym ZUS-ie, jak w b2b_monthly |
| zusStart | object | Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej. Nie później niż liczony miesiąc — przy BRAK najwyżej miesiąc po nim: miesiąc tuż przed zusStart to miesiąc założenia w trakcie miesiąca, objęty ulgą od dnia założenia. Bez tego pola przy BRAK narzędzie liczy miesiąc jako miesiąc działalności firmy założonej w styczniu tego roku i pisze to w wyniku, a przy PREFERENCYJNY — jako Mały ZUS. Przy DUZY_ZUS i UOP bez znaczenia |
Projekcja roczna miesiąc po miesiącu. Na skali PIT miesiąca to zaliczka narastająco: podatek od dochodu od 1 stycznia według skali rocznej (cała kwota zmniejszająca od stycznia, próg 32% wobec dochodu od początku roku) minus zaliczki za wcześniejsze miesiące, a PIT roku to podatek od dochodu całego roku. Na skali używaj tego zamiast mnożenia miesiąca przez dwanaście, gdy przychód jest nierówny albo dochód roku może przekroczyć próg skali. PIT na liniowym i ryczałcie oraz ZUS, zdrowotna i danina w każdej formie liczone są dla każdego miesiąca osobno, jak w b2b_monthly: na liniowym strata miesiąca nie pomniejsza dochodu innych miesięcy, a odliczenie zdrowotnej ma limit 1/12 rocznego w każdym miesiącu; zdrowotna na skali i liniowym to w każdym miesiącu co najmniej minimalna składka; danina liczy się od dochodu miesiąca razy dwanaście, a na ryczałcie próg zdrowotnej od przychodu miesiąca razy dwanaście. Przy nierównym dochodzie liniowy PIT roku, danina i zdrowotna na skali i liniowym mogą więc wyjść za wysokie (w prawie liczy się je od dochodu od 1 stycznia, a zdrowotną rozlicza się rocznie od dochodu całego roku), a zdrowotna na ryczałcie — za wysoka albo za niska (rozliczenie roczne wyrównuje miesiące do progu całego roku). Narzędzie wskazuje w wyniku miesiące ze stratą i z odliczeniem zdrowotnej ponad 1/12 limitu na liniowym, z daniną obok miesięcy bez niej, z minimalną zdrowotną obok wyższych i w różnych progach zdrowotnej ryczałtu. Ulga na start (BRAK: 6 miesięcy bez ZUS społecznego, potem to, co podaje zusAfterRelief — 24 miesiące Małego ZUS-u i pełny albo od razu pełny; bez niego Mały ZUS jako założenie) i Mały ZUS (PREFERENCYJNY: 24 miesiące, potem pełny) biegną od zusStart; bez niego od stycznia — wynik to mówi i podaje miesiące, od których ZUS rośnie. Przychód i koszty netto; na rękę = przychód − koszty − PIT − danina − ZUS − zdrowotna. VAT podany osobno — dolicza go klient, więc nie pomniejsza kwoty na rękę; nadwyżki VAT naliczonego nad należnym projekcja nie odzyskuje i mówi wtedy, o ile pomniejsza kwotę na rękę. Bez isVatPayer przyjmuje czynnego podatnika VAT i pisze to w wyniku.
| Argument | Type | Description |
|---|---|---|
| year |
Sprawdza polską firmę po NIP w rejestrach publicznych: GUS REGON (nazwa, adres, rodzaj podmiotu, data zakończenia działalności), a z bankAccount — czy ten rachunek jest na Białej liście Ministerstwa Finansów dla tego NIP w dniu date, z identyfikatorem zapytania jako dowodem sprawdzenia (reguła przelewów powyżej 15 000 zł). Użyj przed przelewem do nowego kontrahenta albo przy fakturze od nieznanej firmy. Nie podaje statusu VAT ani listy rachunków firmy. Rejestry mają dzienne limity — nie sprawdzaj tej samej firmy dwa razy.
| Argument | Type | Description |
|---|---|---|
| nip* | string | NIP firmy — 10 cyfr, np. 5261040828, 526-104-08-28 albo PL5261040828 |
| date | string | Dzień, na który czytać Białą listę (RRRR-MM-DD), np. dzień zlecenia przelewu; domyślnie dziś (czas polski). Nie z przyszłości |
| bankAccount | string | Numer rachunku z faktury albo do przelewu (26 cyfr, z „PL” albo bez, spacje dowolne) — sprawdzę, czy jest na Białej liście tej firmy w dniu date. Bez niego rachunek nie jest sprawdzany |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"nip"
],
"properties": {
"nip": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "NIP firmy — 10 cyfr, np. 5261040828, 526-104-08-28 albo PL5261040828"
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Dzień, na który czytać Białą listę (RRRR-MM-DD), np. dzień zlecenia przelewu; domyślnie dziś (czas polski). Nie z przyszłości"
},
"bankAccount": {
"type": "string",
"maxLength": 40,
"description": "Numer rachunku z faktury albo do przelewu (26 cyfr, z „PL” albo bez, spacje dowolne) — sprawdzę, czy jest na Białej liście tej firmy w dniu date. Bez niego rachunek nie jest sprawdzany"
}
}
}Limit wpłat na IKZE w roku i ile podatku oszczędza wpłata przy podanym przychodzie i kosztach JDG: PIT za rok bez wpłaty i z wpłatą, z tego samego silnika roku (różnica to oszczędność), co odliczenie obniża w danej formie (skala i liniowy — dochód, ryczałt — przychód), podatek od wypłaty na emeryturze i limit IKE dla porównania. Wpłata ponad limit jest wskazana wprost i liczona do limitu. selfEmployed trzeba podać — limit zależy od osoby, nie od firmy. Lata tylko z opublikowanymi stałymi.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| taxForm* | string | LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu |
| isVatPayer* | boolean | true = czynny podatnik VAT, false = zwolniony z VAT |
| zusVariant* | string | BRAK = ulga na start — narzędzie liczy cały rok bez składek społecznych (ulga trwa 6 miesięcy; rok po niej policz z PREFERENCYJNY albo DUZY_ZUS), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy) |
| ryczaltRate | number | Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje |
| contribution* |
Co ten serwer liczy i czego nie wie. Wywołaj, gdy pytanie dotyczy danych konkretnej firmy (faktury, płatności, saldo) albo gdy nie wiesz, które narzędzie to policzy.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Leasing operacyjny samochodu osobowego dla czynnego podatnika VAT: rata netto i brutto, VAT do odliczenia (50% albo 100%), ile raty jest kosztem według art. 23 ust. 5f PIT (część kapitałowa do limitu wartości auta z rejestru, według emisji CO2 i daty każdej płatności — od 2026 r. niższy, także w umowach z 2025 r.; odsetki i eksploatacja w 75% przy użytku mieszanym), oszczędność PIT i składki zdrowotnej miesięcznie i przez całą umowę, koszt po oszczędnościach. Harmonogram z silnika leasing.kalkulatorb2b.pl. Nie liczy leasingu finansowego, firmy zwolnionej z VAT, wykupu ani dopłat; ryczałt dostaje tylko odliczenie VAT. Koszty eksploatacji wyłącznie z podanych kwot. Każdej wartości (stawki skali, oprocentowania, kategorii auta) zapytaj — nie zakładaj.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Rok zawarcia umowy — decyduje o stawkach PIT i VAT. Limit wartości auta w kosztach idzie za datą każdej płatności: od 2026 r. niższy dla emisji CO2 od 50 g/km, także dla rat umów z 2025 r. |
| month* | integer | Miesiąc zawarcia umowy 1-12 |
| usage* | string | MIESZANY = także prywatnie (VAT od raty 50%), TYLKO_FIRMOWY = wyłącznie w firmie (VAT 100%, wymaga ewidencji przebiegu i VAT-26) |
| wibor | object | Oprocentowanie zmienne: WIBOR z datą notowania i marża. Podaj to ALBO interestRatePercent, nie oba |
| taxForm* | string |
Porównuje leasing operacyjny samochodu osobowego z zakupem za gotówkę dla czynnego podatnika VAT, przez okres umowy: ile zapłacisz brutto, VAT do odliczenia (50% albo 100%), ile jest kosztem, oszczędność PIT i składki zdrowotnej po obu stronach, koszt netto i różnica. Leasing liczy jak leasing_calculate (limit wartości auta według daty każdej raty, odsetki w 75% przy użytku mieszanym); gotówka to amortyzacja 20% rocznie z limitem wartości auta z dnia wprowadzenia do ewidencji (auto sprzed 2026 r. zachowuje dawny limit). Koszt alternatywny gotówki tylko ze stopy podanej w argumencie. Bez wykupu, bez wyceny auta po umowie i bez kosztów eksploatacji (te same w obu wariantach). Każdej wartości (stawki skali, oprocentowania, kategorii auta, stopy) zapytaj — nie zakładaj.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Rok zakupu auta za gotówkę i zawarcia umowy leasingu (ten sam moment w obu wariantach). Decyduje o stawkach PIT i VAT, a przy zakupie także o limicie amortyzacji: auto wprowadzone do ewidencji przed 2026 r. zachowuje limit 150 000 zł, od 2026 r. limit zależy od emisji CO2. W leasingu limit idzie za datą każdej raty |
| month* | integer | Miesiąc zakupu i zawarcia umowy 1-12 — w tym miesiącu auto wchodzi do ewidencji środków trwałych |
| usage* | string | MIESZANY = także prywatnie (VAT od raty 50%), TYLKO_FIRMOWY = wyłącznie w firmie (VAT 100%, wymaga ewidencji przebiegu i VAT-26) |
| wibor | object | Oprocentowanie zmienne: WIBOR z datą notowania i marża. Podaj to ALBO interestRatePercent, nie oba |
Harmonogram spłaty kredytu (hipotecznego, konsumenckiego albo firmowego) przy STAŁYM oprocentowaniu podanym w argumentach: raty równe (annuitetowe) albo malejące, opcjonalnie nadpłata jednorazowa i/lub co miesiąc — z obniżeniem raty albo ze skróceniem okresu — i rekompensata za nadpłatę ze stawki z umowy, z limitami ustawowymi kredytu hipotecznego (art. 40 ustawy o kredycie hipotecznym) i konsumenckiego (art. 49 ustawy o kredycie konsumenckim); obie ustawy chronią tylko konsumentów, więc kredytu firmowego (na działalność) nie obejmują — wtedy wiąże wyłącznie umowa. Zwraca pierwszą i ostatnią ratę, odsetki i kwotę zapłaconą razem, liczbę rat oraz podsumowanie rok po roku (kapitał, odsetki, saldo). Nie prognozuje WIBOR-u ani POLSTR-u i nie ocenia zdolności kredytowej — nie mówi, ile bank pożyczy. Raty równe i malejące porównasz, wywołując narzędzie dwa razy.
| Argument | Type | Description |
|---|---|---|
| months* | integer | Liczba rat miesięcznych, 1–420 |
| principal* | number | Kwota kredytu (saldo do spłaty na start harmonogramu), zł |
| overpayment | object | Nadpłata: jednorazowa (oneTime) i/lub co miesiąc (monthly), z trybem |
| annualRatePct* | number | Oprocentowanie nominalne roczne w procentach (0–30), stałe przez cały harmonogram |
| installmentType* | string | equal = raty równe (annuitetowe), decreasing = raty malejące (stała część kapitałowa) |
Kurs średni NBP (tabela A) z ostatniego dnia roboczego PRZED podaną datą — po nim przelicza się na złote przychód, koszt i VAT z faktury w walucie (art. 11a ustawy o PIT, art. 31a ustawy o VAT). Podaj walutę i datę zdarzenia (np. dzień wystawienia faktury); weekendy i święta narzędzie omija samo. Zwraca kurs, numer tabeli i jej datę — nie podawaj kursu z pamięci. Waluty spoza tabeli A nie są obsługiwane.
| Argument | Type | Description |
|---|---|---|
| date* | string | Dzień zdarzenia (RRRR-MM-DD): wystawienia faktury, uzyskania przychodu, poniesienia kosztu albo powstania obowiązku VAT — NIE dzień wcześniej; kurs będzie z ostatniego dnia roboczego przed tą datą |
| currency* | string | Kod waluty ISO 4217 z tabeli A NBP, np. EUR, USD, GBP, CHF |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"currency",
"date"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Dzień zdarzenia (RRRR-MM-DD): wystawienia faktury, uzyskania przychodu, poniesienia kosztu albo powstania obowiązku VAT — NIE dzień wcześniej; kurs będzie z ostatniego dnia roboczego przed tą datą"
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Kod waluty ISO 4217 z tabeli A NBP, np. EUR, USD, GBP, CHF"
}
}
}Obowiązujące stałe na dany miesiąc: płaca minimalna i przeciętna, stawki ZUS, składka zdrowotna, próg skali, kwota wolna, danina solidarnościowa. Z rejestru stałych — użyj tego zamiast liczb z pamięci.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| month* | integer | Miesiąc 1-12 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
}
}
}Terminy płatności ZUS, zaliczki PIT (albo ryczałtu) i VAT, które przypadają w danym miesiącu, z przesunięciem z weekendu i święta na dzień roboczy. Dla jednoosobowej działalności, która płaci składki ZUS wyłącznie za siebie. Bez kwot — tylko daty i okresy, za które się płaci.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| month* | integer | Miesiąc, w którym przypadają płatności (1-12) |
| pitFrequency | string | Zaliczki PIT (albo ryczałtu) miesięczne czy kwartalne; bez wartości — oba warianty |
| vatFrequency | string | VAT miesięczny, kwartalny albo EXEMPT (zwolniony z VAT); bez wartości — oba warianty |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc, w którym przypadają płatności (1-12)"
},
"pitFrequency": {
"enum": [
"MONTHLY",
"QUARTERLY"
],
"type": "string",
"description": "Zaliczki PIT (albo ryczałtu) miesięczne czy kwartalne; bez wartości — oba warianty"
},
"vatFrequency": {
"enum": [
"MONTHLY",
"QUARTERLY",
"EXEMPT"
],
"type": "string",
"description": "VAT miesięczny, kwartalny albo EXEMPT (zwolniony z VAT); bez wartości — oba warianty"
}
}
}Pełne rozliczenie umowy o pracę na cały rok: ZUS pracownika, składka zdrowotna, zaliczka PIT, PPK, netto miesiąc po miesiącu oraz koszt pracodawcy. Obsługuje ulgę dla młodych, prorodzinną, 4+, PIT-0 dla rodzin, koszty autorskie i ulgę na powrót. Liczy narastająco, więc pokazuje miesiąc przekroczenia progu skali.
| Argument | Type | Description |
|---|---|---|
| ppk | object | |
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| hasPIT2 | boolean | Złożony PIT-2 (kwota wolna dzielona na miesiące) |
| allowances | object | |
| monthlyGross* | array | Brutto na kolejne miesiące. Jedna liczba = tyle samo przez cały rok |
| withSickness | boolean | Składka chorobowa — na umowie o pracę obowiązkowa |
| costDeductionType | string | Koszty uzyskania: local = miejscowe, non-local = dojazdowe |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"monthlyGross",
"year"
],
"properties": {
"ppk": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
},
"employeeAdditional": {
"type": "number",
"maximum": 2,
"minimum": 0
},
"employerAdditional": {
"type": "number",
"maximum": 2.5,
"minimum": 0
},
"employeeContribution": {
"type": "number",
"maximum": 4,
"minimum": 0,
"description": "Procent, podstawowo 2"
},
"employerContribution": {
"type": "number",
"maximum": 4,
"minimum": 0,
"description": "Procent, podstawowo 1,5"
}
}
},
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"hasPIT2": {
"type": "boolean",
"default": true,
"description": "Złożony PIT-2 (kwota wolna dzielona na miesiące)"
},
"allowances": {
"type": "object",
"properties": {
"authorCosts": {
"type": "object",
"required": [
"enabled",
"monthlyAuthorIncome",
"percentage"
],
"properties": {
"enabled": {
"type": "boolean"
},
"percentage": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"monthlyAuthorIncome": {
"type": "number",
"minimum": 0
}
},
"description": "50% koszty autorskie od części wynagrodzenia"
},
"youngWorker": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
},
"birthDate": {
"type": "string"
}
},
"description": "Ulga dla młodych — do ukończenia 26 lat"
},
"familyPitZero": {
"type": "object",
"required": [
"enabled",
"numberOfChildren",
"incomeLimit"
],
"properties": {
"enabled": {
"type": "boolean"
},
"incomeLimit": {
"type": "number",
"minimum": 0
},
"numberOfChildren": {
"type": "integer",
"maximum": 15,
"minimum": 0
}
},
"description": "PIT-0 dla rodzin — limit dochodu na rodzica"
},
"familyAllowance": {
"type": "object",
"required": [
"enabled",
"numberOfChildren"
],
"properties": {
"enabled": {
"type": "boolean"
},
"numberOfChildren": {
"type": "integer",
"maximum": 10,
"minimum": 0
}
},
"description": "Ulga prorodzinna (odliczenie od podatku)"
},
"returningToPoland": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
}
},
"description": "Ulga na powrót"
},
"largeFamilyAllowance": {
"type": "object",
"required": [
"enabled",
"numberOfChildren"
],
"properties": {
"enabled": {
"type": "boolean"
},
"numberOfChildren": {
"type": "integer",
"maximum": 15,
"minimum": 0
}
},
"description": "Ulga dla rodzin 4+"
}
}
},
"monthlyGross": {
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 12,
"minItems": 1,
"description": "Brutto na kolejne miesiące. Jedna liczba = tyle samo przez cały rok"
},
"withSickness": {
"type": "boolean",
"default": true,
"description": "Składka chorobowa — na umowie o pracę obowiązkowa"
},
"costDeductionType": {
"enum": [
"local",
"non-local"
],
"type": "string",
"default": "local",
"description": "Koszty uzyskania: local = miejscowe, non-local = dojazdowe"
}
}
}Szuka wynagrodzenia brutto, przy którym na rękę zostaje zadana kwota. Liczone iteracyjnie na stałych wskazanego miesiąca, z tymi samymi ulgami i PPK co pozostałe narzędzia etatowe.
| Argument | Type | Description |
|---|---|---|
| ppk | object | |
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| month* | integer | Miesiąc 1-12 |
| hasPIT2 | boolean | Złożony PIT-2 (kwota wolna dzielona na miesiące) |
| targetNet* | number | Kwota na rękę, dla której szukamy brutto |
| allowances | object | |
| withSickness | boolean | Składka chorobowa — na umowie o pracę obowiązkowa |
| costDeductionType | string | Koszty uzyskania: local = miejscowe, non-local = dojazdowe |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"targetNet",
"year",
"month"
],
"properties": {
"ppk": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
},
"employeeAdditional": {
"type": "number",
"maximum": 2,
"minimum": 0
},
"employerAdditional": {
"type": "number",
"maximum": 2.5,
"minimum": 0
},
"employeeContribution": {
"type": "number",
"maximum": 4,
"minimum": 0,
"description": "Procent, podstawowo 2"
},
"employerContribution": {
"type": "number",
"maximum": 4,
"minimum": 0,
"description": "Procent, podstawowo 1,5"
}
}
},
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
},
"hasPIT2": {
"type": "boolean",
"default": true,
"description": "Złożony PIT-2 (kwota wolna dzielona na miesiące)"
},
"targetNet": {
"type": "number",
"minimum": 0,
"description": "Kwota na rękę, dla której szukamy brutto"
},
"allowances": {
"type": "object",
"properties": {
"authorCosts": {
"type": "object",
"required": [
"enabled",
"monthlyAuthorIncome",
"percentage"
],
"properties": {
"enabled": {
"type": "boolean"
},
"percentage": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"monthlyAuthorIncome": {
"type": "number",
"minimum": 0
}
},
"description": "50% koszty autorskie od części wynagrodzenia"
},
"youngWorker": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
},
"birthDate": {
"type": "string"
}
},
"description": "Ulga dla młodych — do ukończenia 26 lat"
},
"familyPitZero": {
"type": "object",
"required": [
"enabled",
"numberOfChildren",
"incomeLimit"
],
"properties": {
"enabled": {
"type": "boolean"
},
"incomeLimit": {
"type": "number",
"minimum": 0
},
"numberOfChildren": {
"type": "integer",
"maximum": 15,
"minimum": 0
}
},
"description": "PIT-0 dla rodzin — limit dochodu na rodzica"
},
"familyAllowance": {
"type": "object",
"required": [
"enabled",
"numberOfChildren"
],
"properties": {
"enabled": {
"type": "boolean"
},
"numberOfChildren": {
"type": "integer",
"maximum": 10,
"minimum": 0
}
},
"description": "Ulga prorodzinna (odliczenie od podatku)"
},
"returningToPoland": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
}
},
"description": "Ulga na powrót"
},
"largeFamilyAllowance": {
"type": "object",
"required": [
"enabled",
"numberOfChildren"
],
"properties": {
"enabled": {
"type": "boolean"
},
"numberOfChildren": {
"type": "integer",
"maximum": 15,
"minimum": 0
}
},
"description": "Ulga dla rodzin 4+"
}
}
},
"withSickness": {
"type": "boolean",
"default": true,
"description": "Składka chorobowa — na umowie o pracę obowiązkowa"
},
"costDeductionType": {
"enum": [
"local",
"non-local"
],
"type": "string",
"default": "local",
"description": "Koszty uzyskania: local = miejscowe, non-local = dojazdowe"
}
}
}Projekcja etatu na kilka lat z coroczną podwyżką, każdy rok z własnym narastaniem progu. Rok z opublikowanymi stałymi liczy się na własnych stałych podatkowych. Rok, na który rejestr nie ma jeszcze stałych, liczy się na stałych ostatniego opublikowanego roku i jest oznaczony gwiazdką jako założenie. Projekcji nie da się zacząć przed pierwszym rokiem rejestru.
| Argument | Type | Description |
|---|---|---|
| ppk | object | |
| years* | integer | |
| hasPIT2 | boolean | Złożony PIT-2 (kwota wolna dzielona na miesiące) |
| startYear* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| allowances | object | |
| initialGross* | number | Brutto miesięcznie w pierwszym roku |
| withSickness | boolean | Składka chorobowa — na umowie o pracę obowiązkowa |
| costDeductionType | string | Koszty uzyskania: local = miejscowe, non-local = dojazdowe |
Limit sprzedaży dla zwolnienia podmiotowego z VAT (art. 113) na dany rok — pełny albo proporcjonalny do dni działalności dla firmy otwartej w trakcie roku (art. 113 ust. 9). Z podaną sprzedażą netto od 1 stycznia: ile zostało, jaki to procent limitu i poziom ostrzeżenia, a z dniem stanu (asOf) — ile średnio dziennie można jeszcze sprzedać do końca roku. Liczy wyłącznie z podanych liczb, bez prognozy. Mówi też, kto zwolnienia nie ma bez względu na sprzedaż (art. 113 ust. 13: m.in. usługi prawnicze i doradztwo). Lata tylko z opublikowanymi stałymi.
| Argument | Type | Description |
|---|---|---|
| asOf | string | Dzień, na który podajesz salesSoFar (RRRR-MM-DD, w tym samym roku). Wymaga salesSoFar; z nim narzędzie mówi też, ile średnio dziennie można jeszcze sprzedać do 31 grudnia |
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| salesSoFar | number | Wartość sprzedaży NETTO (bez VAT) od 1 stycznia, liczona do limitu, w złotych |
| businessStartDate | string | Dzień rozpoczęcia działalności (sprzedaży), RRRR-MM-DD. Firma, która ruszyła w tym roku, ma limit proporcjonalny do dni działalności (art. 113 ust. 9). Bez daty — pełny limit roczny, jak dla firmy działającej od początku roku: zapytaj, gdy firma może być nowa |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"year"
],
"properties": {
"asOf": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Dzień, na który podajesz salesSoFar (RRRR-MM-DD, w tym samym roku). Wymaga salesSoFar; z nim narzędzie mówi też, ile średnio dziennie można jeszcze sprzedać do 31 grudnia"
},
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"salesSoFar": {
"type": "number",
"minimum": 0,
"description": "Wartość sprzedaży NETTO (bez VAT) od 1 stycznia, liczona do limitu, w złotych"
},
"businessStartDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Dzień rozpoczęcia działalności (sprzedaży), RRRR-MM-DD. Firma, która ruszyła w tym roku, ma limit proporcjonalny do dni działalności (art. 113 ust. 9). Bez daty — pełny limit roczny, jak dla firmy działającej od początku roku: zapytaj, gdy firma może być nowa"
}
}
}Dni i godziny robocze w miesiącu według polskiego kalendarza świąt — do wyceny kontraktu godzinowego. Nie zakłada „22 dni": każdy miesiąc jest policzony.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| month* | integer | Miesiąc 1-12 |
| dailyHours | number | Godzin dziennie |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
},
"dailyHours": {
"type": "number",
"default": 8,
"maximum": 24,
"minimum": 1,
"description": "Godzin dziennie"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 18, 2026.
| isVatPayer | boolean | false = zwolniony z VAT |
| zusVariant* | string | BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy) |
| costEntries | array | Koszty pozycja po pozycji — zastępuje monthlyCosts |
| ryczaltRate | number | Stawka ryczałtu w procentach dla rodzaju działalności. Bez niej ryczałt nie wchodzi do porównania (porównane są skala i liniowy); firma dziś na ryczałcie musi ją podać |
| monthlyCosts | number | Koszty BRUTTO miesięcznie (z VAT) |
| vacationDays | number | Dni urlopu do odłożenia |
| incomeStreams | array | Kilka źródeł przychodu naraz — zastępuje monthlyRevenue |
| lossDeduction | number | Strata z lat ubiegłych odliczana w tym miesiącu |
| currentTaxForm* | string | Forma, na której firma jest dzisiaj |
| monthlyRevenue | number | Przychód netto miesięcznie (PLN) |
| ipboxIncomePart | number | Procent dochodu (0–100) objęty IP Box — opodatkowany stawką 5% |
| partnerTaxation | boolean | Wspólne rozliczenie z małżonkiem (tylko skala) |
| saveForVacation | boolean | Odkładanie na urlop |
| returningToPoland | boolean | Ulga na powrót |
| partnerAnnualIncome | number | Roczny dochód małżonka |
| ryczaltAnnualRevenue | number | Rzeczywisty roczny przychód — decyduje o progu składki zdrowotnej przy ryczałcie |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"zusVariant",
"year",
"month",
"currentTaxForm"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"ipbox": {
"type": "boolean",
"default": false,
"description": "IP Box — 5% od kwalifikowanego dochodu"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
},
"sickness": {
"type": "boolean",
"description": "Dobrowolna składka chorobowa"
},
"zusStart": {
"type": "object",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 1990,
"description": "Rok"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
}
},
"description": "Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej. Nie później niż liczony miesiąc — przy BRAK najwyżej miesiąc po nim: miesiąc tuż przed zusStart to miesiąc założenia w trakcie miesiąca, objęty ulgą od dnia założenia. Bez tego pola przy BRAK narzędzie liczy miesiąc jako miesiąc działalności firmy założonej w styczniu tego roku i pisze to w wyniku, a przy PREFERENCYJNY — jako Mały ZUS. Przy DUZY_ZUS i UOP bez znaczenia"
},
"isVatPayer": {
"type": "boolean",
"default": true,
"description": "false = zwolniony z VAT"
},
"zusVariant": {
"enum": [
"BRAK",
"PREFERENCYJNY",
"DUZY_ZUS",
"UOP"
],
"type": "string",
"description": "BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy)"
},
"costEntries": {
"type": "array",
"items": {
"type": "object",
"required": [
"net",
"vat",
"vatDeductible"
],
"properties": {
"net": {
"type": "number",
"minimum": 0,
"description": "Kwota netto"
},
"vat": {
"type": "number",
"minimum": 0,
"description": "Kwota VAT"
},
"vatDeductible": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Ile procent VAT do odliczenia (0-100)"
}
}
},
"maxItems": 20,
"description": "Koszty pozycja po pozycji — zastępuje monthlyCosts"
},
"ryczaltRate": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Stawka ryczałtu w procentach dla rodzaju działalności. Bez niej ryczałt nie wchodzi do porównania (porównane są skala i liniowy); firma dziś na ryczałcie musi ją podać"
},
"monthlyCosts": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Koszty BRUTTO miesięcznie (z VAT)"
},
"vacationDays": {
"type": "number",
"default": 0,
"maximum": 60,
"minimum": 0,
"description": "Dni urlopu do odłożenia"
},
"incomeStreams": {
"type": "array",
"items": {
"type": "object",
"required": [
"monthly"
],
"properties": {
"monthly": {
"type": "number",
"minimum": 0,
"description": "Kwota netto miesięcznie w walucie źródła"
},
"vatRate": {
"type": "number",
"maximum": 50,
"minimum": 0,
"description": "Stawka VAT w procentach (domyślnie 23)"
},
"ryczaltRate": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Własna stawka ryczałtu dla tego źródła — przy ryczałcie stawka jest ważona przychodem"
},
"exchangeRate": {
"type": "number",
"minimum": 0,
"description": "Kurs waluty do PLN (1 dla złotówek)"
}
}
},
"maxItems": 10,
"description": "Kilka źródeł przychodu naraz — zastępuje monthlyRevenue"
},
"lossDeduction": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Strata z lat ubiegłych odliczana w tym miesiącu"
},
"currentTaxForm": {
"enum": [
"LINIOWY",
"SKALA",
"RYCZALT"
],
"type": "string",
"description": "Forma, na której firma jest dzisiaj"
},
"monthlyRevenue": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Przychód netto miesięcznie (PLN)"
},
"ipboxIncomePart": {
"type": "number",
"default": 0,
"maximum": 100,
"minimum": 0,
"description": "Procent dochodu (0–100) objęty IP Box — opodatkowany stawką 5%"
},
"partnerTaxation": {
"type": "boolean",
"default": false,
"description": "Wspólne rozliczenie z małżonkiem (tylko skala)"
},
"saveForVacation": {
"type": "boolean",
"default": false,
"description": "Odkładanie na urlop"
},
"returningToPoland": {
"type": "boolean",
"default": false,
"description": "Ulga na powrót"
},
"partnerAnnualIncome": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Roczny dochód małżonka"
},
"ryczaltAnnualRevenue": {
"type": "number",
"minimum": 0,
"description": "Rzeczywisty roczny przychód — decyduje o progu składki zdrowotnej przy ryczałcie"
}
}
}| invoices* |
| array |
| Faktury z jednego miesiąca |
| sickness | boolean | Dobrowolna składka chorobowa |
| zusStart | object | Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej. Nie później niż liczony miesiąc — przy BRAK najwyżej miesiąc po nim: miesiąc tuż przed zusStart to miesiąc założenia w trakcie miesiąca, objęty ulgą od dnia założenia. Bez tego pola przy BRAK narzędzie liczy miesiąc jako miesiąc działalności firmy założonej w styczniu tego roku i pisze to w wyniku, a przy PREFERENCYJNY — jako Mały ZUS. Przy DUZY_ZUS i UOP bez znaczenia |
| isVatPayer | boolean | false = zwolniony podmiotowo z VAT |
| zusVariant* | string | BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy) |
| ryczaltRate | number | Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje |
| ryczaltAnnualRevenue | number | Roczny przychód narastająco — decyduje o progu składki zdrowotnej przy ryczałcie |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"invoices",
"taxForm",
"zusVariant",
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc rozliczenia. Dla sprzedaży decyduje DATA WYKONANIA USŁUGI, nie data wystawienia — faktura wystawiona w sierpniu za lipiec należy do lipca"
},
"taxForm": {
"enum": [
"LINIOWY",
"SKALA",
"RYCZALT"
],
"type": "string",
"description": "LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu"
},
"invoices": {
"type": "array",
"items": {
"type": "object",
"required": [
"direction",
"net"
],
"properties": {
"net": {
"type": "number",
"minimum": 0,
"description": "Wartość netto z faktury"
},
"vat": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "KWOTA VAT z faktury (nie stawka). Dla „np\", „zw\" i 0% wpisz 0"
},
"label": {
"type": "string",
"maxLength": 80,
"description": "Numer albo opis faktury — wraca w odpowiedzi"
},
"vatMode": {
"enum": [
"standard",
"reverse_charge",
"exempt",
"zero"
],
"type": "string",
"default": "standard",
"description": "standard = zwykły VAT, reverse_charge = odwrotne obciążenie / „np\" (m.in. usługi dla firm z UE), exempt = zwolnione („zw\"), zero = stawka 0%"
},
"direction": {
"enum": [
"sale",
"purchase"
],
"type": "string",
"description": "sale = faktura sprzedaży (przychód), purchase = zakupu (koszt)"
},
"ryczaltRate": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Tylko dla sprzedaży przy ryczałcie: stawka dla TEJ pozycji, gdy usługi są różne"
},
"vatDeductiblePercent": {
"type": "number",
"default": 100,
"maximum": 100,
"minimum": 0,
"description": "Tylko dla zakupów: ile procent VAT-u do odliczenia (np. 50 dla samochodu)"
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "Faktury z jednego miesiąca"
},
"sickness": {
"type": "boolean",
"description": "Dobrowolna składka chorobowa"
},
"zusStart": {
"type": "object",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 1990,
"description": "Rok"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
}
},
"description": "Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej. Nie później niż liczony miesiąc — przy BRAK najwyżej miesiąc po nim: miesiąc tuż przed zusStart to miesiąc założenia w trakcie miesiąca, objęty ulgą od dnia założenia. Bez tego pola przy BRAK narzędzie liczy miesiąc jako miesiąc działalności firmy założonej w styczniu tego roku i pisze to w wyniku, a przy PREFERENCYJNY — jako Mały ZUS. Przy DUZY_ZUS i UOP bez znaczenia"
},
"isVatPayer": {
"type": "boolean",
"default": true,
"description": "false = zwolniony podmiotowo z VAT"
},
"zusVariant": {
"enum": [
"BRAK",
"PREFERENCYJNY",
"DUZY_ZUS",
"UOP"
],
"type": "string",
"description": "BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy)"
},
"ryczaltRate": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje"
},
"ryczaltAnnualRevenue": {
"type": "number",
"minimum": 0,
"description": "Roczny przychód narastająco — decyduje o progu składki zdrowotnej przy ryczałcie"
}
}
}| string |
| LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu |
| sickness | boolean | Dobrowolna składka chorobowa |
| zusStart | object | Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej. Nie później niż liczony miesiąc — przy BRAK najwyżej miesiąc po nim: miesiąc tuż przed zusStart to miesiąc założenia w trakcie miesiąca, objęty ulgą od dnia założenia. Bez tego pola przy BRAK narzędzie liczy miesiąc jako miesiąc działalności firmy założonej w styczniu tego roku i pisze to w wyniku, a przy PREFERENCYJNY — jako Mały ZUS. Przy DUZY_ZUS i UOP bez znaczenia |
| isVatPayer | boolean | false = zwolniony z VAT |
| zusVariant* | string | BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy) |
| costEntries | array | Koszty pozycja po pozycji — zastępuje monthlyCosts |
| ryczaltRate | number | Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje |
| monthlyCosts | number | Koszty BRUTTO miesięcznie (z VAT) |
| vacationDays | number | Dni urlopu do odłożenia |
| incomeStreams | array | Kilka źródeł przychodu naraz — zastępuje monthlyRevenue |
| lossDeduction | number | Strata z lat ubiegłych odliczana w tym miesiącu |
| monthlyRevenue | number | Przychód netto miesięcznie (PLN) |
| ipboxIncomePart | number | Procent dochodu (0–100) objęty IP Box — opodatkowany stawką 5% |
| partnerTaxation | boolean | Wspólne rozliczenie z małżonkiem (tylko skala) |
| saveForVacation | boolean | Odkładanie na urlop |
| returningToPoland | boolean | Ulga na powrót |
| partnerAnnualIncome | number | Roczny dochód małżonka |
| ryczaltAnnualRevenue | number | Rzeczywisty roczny przychód — decyduje o progu składki zdrowotnej przy ryczałcie |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"taxForm",
"zusVariant",
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"ipbox": {
"type": "boolean",
"default": false,
"description": "IP Box — 5% od kwalifikowanego dochodu"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
},
"taxForm": {
"enum": [
"LINIOWY",
"SKALA",
"RYCZALT"
],
"type": "string",
"description": "LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu"
},
"sickness": {
"type": "boolean",
"description": "Dobrowolna składka chorobowa"
},
"zusStart": {
"type": "object",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 1990,
"description": "Rok"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
}
},
"description": "Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej. Nie później niż liczony miesiąc — przy BRAK najwyżej miesiąc po nim: miesiąc tuż przed zusStart to miesiąc założenia w trakcie miesiąca, objęty ulgą od dnia założenia. Bez tego pola przy BRAK narzędzie liczy miesiąc jako miesiąc działalności firmy założonej w styczniu tego roku i pisze to w wyniku, a przy PREFERENCYJNY — jako Mały ZUS. Przy DUZY_ZUS i UOP bez znaczenia"
},
"isVatPayer": {
"type": "boolean",
"default": true,
"description": "false = zwolniony z VAT"
},
"zusVariant": {
"enum": [
"BRAK",
"PREFERENCYJNY",
"DUZY_ZUS",
"UOP"
],
"type": "string",
"description": "BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy)"
},
"costEntries": {
"type": "array",
"items": {
"type": "object",
"required": [
"net",
"vat",
"vatDeductible"
],
"properties": {
"net": {
"type": "number",
"minimum": 0,
"description": "Kwota netto"
},
"vat": {
"type": "number",
"minimum": 0,
"description": "Kwota VAT"
},
"vatDeductible": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Ile procent VAT do odliczenia (0-100)"
}
}
},
"maxItems": 20,
"description": "Koszty pozycja po pozycji — zastępuje monthlyCosts"
},
"ryczaltRate": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje"
},
"monthlyCosts": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Koszty BRUTTO miesięcznie (z VAT)"
},
"vacationDays": {
"type": "number",
"default": 0,
"maximum": 60,
"minimum": 0,
"description": "Dni urlopu do odłożenia"
},
"incomeStreams": {
"type": "array",
"items": {
"type": "object",
"required": [
"monthly"
],
"properties": {
"monthly": {
"type": "number",
"minimum": 0,
"description": "Kwota netto miesięcznie w walucie źródła"
},
"vatRate": {
"type": "number",
"maximum": 50,
"minimum": 0,
"description": "Stawka VAT w procentach (domyślnie 23)"
},
"ryczaltRate": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Własna stawka ryczałtu dla tego źródła — przy ryczałcie stawka jest ważona przychodem"
},
"exchangeRate": {
"type": "number",
"minimum": 0,
"description": "Kurs waluty do PLN (1 dla złotówek)"
}
}
},
"maxItems": 10,
"description": "Kilka źródeł przychodu naraz — zastępuje monthlyRevenue"
},
"lossDeduction": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Strata z lat ubiegłych odliczana w tym miesiącu"
},
"monthlyRevenue": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Przychód netto miesięcznie (PLN)"
},
"ipboxIncomePart": {
"type": "number",
"default": 0,
"maximum": 100,
"minimum": 0,
"description": "Procent dochodu (0–100) objęty IP Box — opodatkowany stawką 5%"
},
"partnerTaxation": {
"type": "boolean",
"default": false,
"description": "Wspólne rozliczenie z małżonkiem (tylko skala)"
},
"saveForVacation": {
"type": "boolean",
"default": false,
"description": "Odkładanie na urlop"
},
"returningToPoland": {
"type": "boolean",
"default": false,
"description": "Ulga na powrót"
},
"partnerAnnualIncome": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Roczny dochód małżonka"
},
"ryczaltAnnualRevenue": {
"type": "number",
"minimum": 0,
"description": "Rzeczywisty roczny przychód — decyduje o progu składki zdrowotnej przy ryczałcie"
}
}
}| startYear* | integer | Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| isVatPayer | boolean | false = firma zwolniona z VAT: przychód bez VAT-u, koszty to kwoty zapłacone (z VAT-em) i w całości są kosztem. Bez tego pola narzędzie przyjmuje czynnego podatnika VAT (VAT od kosztów odliczany w całości) i pisze to w wyniku |
| zusVariant* | string | BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy) |
| ryczaltRate | number | Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje |
| monthlyCosts | number | Koszty NETTO (bez VAT) miesięcznie w pierwszym roku; VAT od nich odliczany w całości. Przy isVatPayer: false — kwoty zapłacone (z VAT-em), w całości kosztem |
| monthlyRevenue* | number | Przychód netto w pierwszym roku |
| zusAfterRelief | string | Tylko przy BRAK: co firma płaci po sześciu miesiącach ulgi na start — PREFERENCYJNY (Mały ZUS przez 24 miesiące, potem pełny) albo DUZY_ZUS (pełny ZUS od razu). Mały ZUS po uldze to wybór firmy, nie kolejny etap z ustawy. Bez tego pola narzędzie przyjmuje Mały ZUS i pisze to w wyniku |
| annualGrowthPercent | number | Zmiana przychodu i kosztów rok do roku, w procentach |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"startYear",
"years",
"monthlyRevenue",
"taxForm",
"zusVariant"
],
"properties": {
"years": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "Ile lat policzyć"
},
"taxForm": {
"enum": [
"LINIOWY",
"SKALA",
"RYCZALT"
],
"type": "string",
"description": "LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu"
},
"sickness": {
"type": "boolean",
"default": true
},
"zusStart": {
"type": "object",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 1990,
"description": "Rok"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
}
},
"description": "Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej, także przez kolejne lata. Nie później niż styczeń pierwszego roku projekcji. Bez tego pola narzędzie liczy etap od stycznia tego roku i pisze to w wyniku. Przy DUZY_ZUS i UOP bez znaczenia"
},
"startYear": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"isVatPayer": {
"type": "boolean",
"description": "false = firma zwolniona z VAT: przychód bez VAT-u, koszty to kwoty zapłacone (z VAT-em) i w całości są kosztem. Bez tego pola narzędzie przyjmuje czynnego podatnika VAT (VAT od kosztów odliczany w całości) i pisze to w wyniku"
},
"zusVariant": {
"enum": [
"BRAK",
"PREFERENCYJNY",
"DUZY_ZUS",
"UOP"
],
"type": "string",
"description": "BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy)"
},
"ryczaltRate": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje"
},
"monthlyCosts": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Koszty NETTO (bez VAT) miesięcznie w pierwszym roku; VAT od nich odliczany w całości. Przy isVatPayer: false — kwoty zapłacone (z VAT-em), w całości kosztem"
},
"monthlyRevenue": {
"type": "number",
"minimum": 0,
"description": "Przychód netto w pierwszym roku"
},
"zusAfterRelief": {
"enum": [
"PREFERENCYJNY",
"DUZY_ZUS"
],
"type": "string",
"description": "Tylko przy BRAK: co firma płaci po sześciu miesiącach ulgi na start — PREFERENCYJNY (Mały ZUS przez 24 miesiące, potem pełny) albo DUZY_ZUS (pełny ZUS od razu). Mały ZUS po uldze to wybór firmy, nie kolejny etap z ustawy. Bez tego pola narzędzie przyjmuje Mały ZUS i pisze to w wyniku"
},
"annualGrowthPercent": {
"type": "number",
"default": 0,
"maximum": 100,
"minimum": -50,
"description": "Zmiana przychodu i kosztów rok do roku, w procentach"
}
}
}| isVatPayer | boolean | VAT jest przerzucany na klienta, więc nie wchodzi do „na rękę" |
| zusVariant* | string | BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy) |
| ryczaltRate | number | Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje |
| withSickness | boolean | Chorobowe na etacie |
| b2bMonthlyCosts | number | Koszty firmowe BRUTTO miesięcznie |
| uopMonthlyGross* | number | Wynagrodzenie brutto na etacie, miesięcznie |
| b2bMonthlyRevenue | number | Stawka na fakturze (netto, miesięcznie). Pominięta = przyjmujemy kwotę równą całkowitemu kosztowi pracodawcy z etatu |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"uopMonthlyGross",
"taxForm",
"zusVariant",
"year"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"hasPIT2": {
"type": "boolean",
"default": true
},
"taxForm": {
"enum": [
"LINIOWY",
"SKALA",
"RYCZALT"
],
"type": "string",
"description": "LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu"
},
"sickness": {
"type": "boolean",
"description": "Dobrowolna składka chorobowa na działalności (B2B). Pominięta = wliczona na Małym i pełnym ZUS-ie, jak w b2b_monthly"
},
"zusStart": {
"type": "object",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 1990,
"description": "Rok"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
}
},
"description": "Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej. Nie później niż liczony miesiąc — przy BRAK najwyżej miesiąc po nim: miesiąc tuż przed zusStart to miesiąc założenia w trakcie miesiąca, objęty ulgą od dnia założenia. Bez tego pola przy BRAK narzędzie liczy miesiąc jako miesiąc działalności firmy założonej w styczniu tego roku i pisze to w wyniku, a przy PREFERENCYJNY — jako Mały ZUS. Przy DUZY_ZUS i UOP bez znaczenia"
},
"isVatPayer": {
"type": "boolean",
"default": true,
"description": "VAT jest przerzucany na klienta, więc nie wchodzi do „na rękę\""
},
"zusVariant": {
"enum": [
"BRAK",
"PREFERENCYJNY",
"DUZY_ZUS",
"UOP"
],
"type": "string",
"description": "BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy)"
},
"ryczaltRate": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje"
},
"withSickness": {
"type": "boolean",
"default": true,
"description": "Chorobowe na etacie"
},
"b2bMonthlyCosts": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Koszty firmowe BRUTTO miesięcznie"
},
"uopMonthlyGross": {
"type": "number",
"minimum": 0,
"description": "Wynagrodzenie brutto na etacie, miesięcznie"
},
"b2bMonthlyRevenue": {
"type": "number",
"minimum": 0,
"description": "Stawka na fakturze (netto, miesięcznie). Pominięta = przyjmujemy kwotę równą całkowitemu kosztowi pracodawcy z etatu"
}
}
}| integer |
| Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna) |
| ipbox | boolean |
| taxForm* | string | LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu |
| sickness | boolean |
| zusStart | object | Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej, także przez kolejne lata. Nie później niż styczeń pierwszego roku projekcji. Bez tego pola narzędzie liczy etap od stycznia tego roku i pisze to w wyniku. Przy DUZY_ZUS i UOP bez znaczenia |
| isVatPayer | boolean | false = firma zwolniona z VAT: przychód bez VAT-u, koszty to kwoty zapłacone (z VAT-em) i w całości są kosztem. Bez tego pola narzędzie przyjmuje czynnego podatnika VAT (VAT od kosztów odliczany w całości) i pisze to w wyniku |
| zusVariant* | string | BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy) |
| ryczaltRate | number | Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje |
| monthlyCosts | array | Koszty NETTO (bez VAT) na kolejne miesiące, tak samo rozciągane; VAT od nich odliczany w całości. Inaczej niż monthlyCosts w b2b_monthly, które jest brutto. Przy isVatPayer: false — kwoty zapłacone (z VAT-em, którego firma zwolniona nie odlicza), w całości kosztem |
| zusAfterRelief | string | Tylko przy BRAK: co firma płaci po sześciu miesiącach ulgi na start — PREFERENCYJNY (Mały ZUS przez 24 miesiące, potem pełny) albo DUZY_ZUS (pełny ZUS od razu). Mały ZUS po uldze to wybór firmy, nie kolejny etap z ustawy. Bez tego pola narzędzie przyjmuje Mały ZUS i pisze to w wyniku |
| ipboxIncomePart | number | Procent dochodu (0–100) objęty IP Box — opodatkowany stawką 5% |
| monthlyRevenues* | array | Przychód netto na kolejne miesiące. Jedna liczba = tyle samo co miesiąc |
| partnerTaxation | boolean | Wspólne rozliczenie z małżonkiem (tylko skala) |
| returningToPoland | boolean |
| partnerAnnualIncome | number | Roczny dochód małżonka opodatkowany skalą; wspólne rozliczenie liczy się, gdy jest większy od zera |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"monthlyRevenues",
"taxForm",
"zusVariant",
"year"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"ipbox": {
"type": "boolean",
"default": false
},
"taxForm": {
"enum": [
"LINIOWY",
"SKALA",
"RYCZALT"
],
"type": "string",
"description": "LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu"
},
"sickness": {
"type": "boolean",
"default": true
},
"zusStart": {
"type": "object",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 1990,
"description": "Rok"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc 1-12"
}
},
"description": "Od kiedy trwa wybrany wariant ZUS: przy BRAK (ulga na start) — pierwszy miesiąc działalności liczony do ulgi (miesiąc założenia, gdy firma powstała 1. dnia miesiąca, inaczej następny), przy PREFERENCYJNY — pierwszy miesiąc Małego ZUS-u (Mały ZUS zaraz po uldze na start: zusVariant BRAK z pierwszym pełnym miesiącem ulgi). Etap biegnie od niego dalej, także przez kolejne lata. Nie później niż styczeń pierwszego roku projekcji. Bez tego pola narzędzie liczy etap od stycznia tego roku i pisze to w wyniku. Przy DUZY_ZUS i UOP bez znaczenia"
},
"isVatPayer": {
"type": "boolean",
"description": "false = firma zwolniona z VAT: przychód bez VAT-u, koszty to kwoty zapłacone (z VAT-em) i w całości są kosztem. Bez tego pola narzędzie przyjmuje czynnego podatnika VAT (VAT od kosztów odliczany w całości) i pisze to w wyniku"
},
"zusVariant": {
"enum": [
"BRAK",
"PREFERENCYJNY",
"DUZY_ZUS",
"UOP"
],
"type": "string",
"description": "BRAK = ulga na start (6 miesięcy bez społecznych, potem Mały ZUS — etap liczy narzędzie), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy)"
},
"ryczaltRate": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje"
},
"monthlyCosts": {
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"default": [
0
],
"maxItems": 12,
"minItems": 1,
"description": "Koszty NETTO (bez VAT) na kolejne miesiące, tak samo rozciągane; VAT od nich odliczany w całości. Inaczej niż monthlyCosts w b2b_monthly, które jest brutto. Przy isVatPayer: false — kwoty zapłacone (z VAT-em, którego firma zwolniona nie odlicza), w całości kosztem"
},
"zusAfterRelief": {
"enum": [
"PREFERENCYJNY",
"DUZY_ZUS"
],
"type": "string",
"description": "Tylko przy BRAK: co firma płaci po sześciu miesiącach ulgi na start — PREFERENCYJNY (Mały ZUS przez 24 miesiące, potem pełny) albo DUZY_ZUS (pełny ZUS od razu). Mały ZUS po uldze to wybór firmy, nie kolejny etap z ustawy. Bez tego pola narzędzie przyjmuje Mały ZUS i pisze to w wyniku"
},
"ipboxIncomePart": {
"type": "number",
"default": 0,
"maximum": 100,
"minimum": 0,
"description": "Procent dochodu (0–100) objęty IP Box — opodatkowany stawką 5%"
},
"monthlyRevenues": {
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 12,
"minItems": 1,
"description": "Przychód netto na kolejne miesiące. Jedna liczba = tyle samo co miesiąc"
},
"partnerTaxation": {
"type": "boolean",
"default": false,
"description": "Wspólne rozliczenie z małżonkiem (tylko skala)"
},
"returningToPoland": {
"type": "boolean",
"default": false
},
"partnerAnnualIncome": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Roczny dochód małżonka opodatkowany skalą; wspólne rozliczenie liczy się, gdy jest większy od zera"
}
}
}| any |
| Planowana wpłata na IKZE w tym roku, w złotych. "LIMIT" = wpłata całego limitu roku |
| monthlyCosts* | array | Koszty uzyskania przychodu NETTO na kolejne miesiące, tak samo rozciągane ([0] = bez kosztów). Zwolniony z VAT podaje je razem z VAT-em — nie odlicza go, więc VAT jest u niego kosztem |
| selfEmployed* | boolean | Czy oszczędzający prowadzi pozarolniczą działalność (art. 8 ust. 6 ustawy o systemie ubezpieczeń społecznych) — wtedy ma wyższy limit IKZE (art. 13a ust. 1a ustawy o IKE i IKZE). Właściciel JDG: true. Wymagane, bez wartości domyślnej: limit przysługuje osobie w danym roku, nie wynika z formy opodatkowania |
| monthlyRevenues* | array | Przychód netto na kolejne miesiące roku. Jedna liczba = tyle samo co miesiąc |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"monthlyRevenues",
"monthlyCosts",
"taxForm",
"zusVariant",
"isVatPayer",
"year",
"contribution",
"selfEmployed"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"taxForm": {
"enum": [
"LINIOWY",
"SKALA",
"RYCZALT"
],
"type": "string",
"description": "LINIOWY = 19%, SKALA = 12/32%, RYCZALT = od przychodu"
},
"isVatPayer": {
"type": "boolean",
"description": "true = czynny podatnik VAT, false = zwolniony z VAT"
},
"zusVariant": {
"enum": [
"BRAK",
"PREFERENCYJNY",
"DUZY_ZUS",
"UOP"
],
"type": "string",
"description": "BRAK = ulga na start — narzędzie liczy cały rok bez składek społecznych (ulga trwa 6 miesięcy; rok po niej policz z PREFERENCYJNY albo DUZY_ZUS), PREFERENCYJNY = mały ZUS (30% podstawy), DUZY_ZUS = pełny, UOP = etat obok działalności (społeczne po stronie pracodawcy)"
},
"ryczaltRate": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Stawka ryczałtu w procentach. WYMAGANA dla RYCZALT — silnik jej nie zgaduje"
},
"contribution": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "string",
"const": "LIMIT"
}
],
"description": "Planowana wpłata na IKZE w tym roku, w złotych. \"LIMIT\" = wpłata całego limitu roku"
},
"monthlyCosts": {
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 12,
"minItems": 1,
"description": "Koszty uzyskania przychodu NETTO na kolejne miesiące, tak samo rozciągane ([0] = bez kosztów). Zwolniony z VAT podaje je razem z VAT-em — nie odlicza go, więc VAT jest u niego kosztem"
},
"selfEmployed": {
"type": "boolean",
"description": "Czy oszczędzający prowadzi pozarolniczą działalność (art. 8 ust. 6 ustawy o systemie ubezpieczeń społecznych) — wtedy ma wyższy limit IKZE (art. 13a ust. 1a ustawy o IKE i IKZE). Właściciel JDG: true. Wymagane, bez wartości domyślnej: limit przysługuje osobie w danym roku, nie wynika z formy opodatkowania"
},
"monthlyRevenues": {
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 12,
"minItems": 1,
"description": "Przychód netto na kolejne miesiące roku. Jedna liczba = tyle samo co miesiąc"
}
}
}| LINIOWY, SKALA (wymaga scaleMarginalRate) albo RYCZALT (rata nie jest tam kosztem) |
| vatPayer* | boolean | Czy firma jest czynnym podatnikiem VAT. Narzędzie liczy wyłącznie dla czynnego (true) |
| leasingType* | string | Rodzaj leasingu. Narzędzie liczy wyłącznie OPERACYJNY — FINANSOWY odrzuca |
| runningCosts | object | Koszty eksploatacji — wyłącznie kwoty podane przez użytkownika. Bez nich nie są liczone (żadnych cen paliwa ani kosztów serwisu „z tabeli") |
| buyoutPercent* | number | Wartość wykupu w procentach ceny netto, z oferty |
| durationMonths* | integer | Okres umowy w miesiącach (co najmniej 24 — minimum leasingu operacyjnego nowego auta). Silnik liczy N−1 rat i wykup jako N-tą płatność |
| vehicleCategory* | string | Kategoria auta dla limitu wartości w kosztach (emisja CO2 z dowodu rejestracyjnego, pole V.7): ELEKTRYCZNY = elektryczny albo wodorowy, EMISJA_PONIZEJ_50 = poniżej 50 g/km (zwykle hybryda plug-in), EMISJA_OD_50 = 50 g/km i więcej (benzyna, diesel, LPG, zwykła hybryda). Zapytaj, nie zgaduj |
| vehiclePriceNet* | number | Cena samochodu osobowego NETTO (PLN, bez VAT), z oferty |
| scaleMarginalRate | any | Tylko SKALA: stawka PIT, w której jest dochód firmy (12 albo 32). WYMAGANA dla SKALA — narzędzie jej nie zgaduje |
| downPaymentPercent* | number | Opłata wstępna w procentach ceny netto, z oferty (0 = bez opłaty) |
| interestRatePercent | number | Oprocentowanie nominalne roczne w procentach (stałe, z oferty). Podaj to ALBO wibor, nie oba |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"vehiclePriceNet",
"vehicleCategory",
"leasingType",
"durationMonths",
"downPaymentPercent",
"buyoutPercent",
"usage",
"vatPayer",
"taxForm",
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok zawarcia umowy — decyduje o stawkach PIT i VAT. Limit wartości auta w kosztach idzie za datą każdej płatności: od 2026 r. niższy dla emisji CO2 od 50 g/km, także dla rat umów z 2025 r."
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc zawarcia umowy 1-12"
},
"usage": {
"enum": [
"MIESZANY",
"TYLKO_FIRMOWY"
],
"type": "string",
"description": "MIESZANY = także prywatnie (VAT od raty 50%), TYLKO_FIRMOWY = wyłącznie w firmie (VAT 100%, wymaga ewidencji przebiegu i VAT-26)"
},
"wibor": {
"type": "object",
"required": [
"ratePercent",
"quotedOn",
"marginPercent"
],
"properties": {
"quotedOn": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Data notowania WIBOR-u (RRRR-MM-DD) — bez niej liczba nie ma znaczenia"
},
"ratePercent": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "WIBOR w procentach, z notowania"
},
"marginPercent": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Marża leasingodawcy w procentach, z oferty"
}
},
"description": "Oprocentowanie zmienne: WIBOR z datą notowania i marża. Podaj to ALBO interestRatePercent, nie oba"
},
"taxForm": {
"enum": [
"LINIOWY",
"SKALA",
"RYCZALT"
],
"type": "string",
"description": "LINIOWY, SKALA (wymaga scaleMarginalRate) albo RYCZALT (rata nie jest tam kosztem)"
},
"vatPayer": {
"type": "boolean",
"description": "Czy firma jest czynnym podatnikiem VAT. Narzędzie liczy wyłącznie dla czynnego (true)"
},
"leasingType": {
"enum": [
"OPERACYJNY",
"FINANSOWY"
],
"type": "string",
"description": "Rodzaj leasingu. Narzędzie liczy wyłącznie OPERACYJNY — FINANSOWY odrzuca"
},
"runningCosts": {
"type": "object",
"properties": {
"fuelGrossMonthly": {
"type": "number",
"minimum": 0,
"description": "Paliwo albo ładowanie BRUTTO na miesiąc (PLN, z faktur, VAT według stawki podstawowej)"
},
"insuranceOcAnnual": {
"type": "number",
"minimum": 0,
"description": "Składka OC za rok (PLN). Ubezpieczenie jest zwolnione z VAT. AC i GAP nie są obsługiwane"
},
"serviceGrossMonthly": {
"type": "number",
"minimum": 0,
"description": "Serwis, opony, części, myjnia BRUTTO na miesiąc (PLN, VAT według stawki podstawowej)"
}
},
"description": "Koszty eksploatacji — wyłącznie kwoty podane przez użytkownika. Bez nich nie są liczone (żadnych cen paliwa ani kosztów serwisu „z tabeli\")"
},
"buyoutPercent": {
"type": "number",
"maximum": 30,
"minimum": 1,
"description": "Wartość wykupu w procentach ceny netto, z oferty"
},
"durationMonths": {
"type": "integer",
"maximum": 120,
"minimum": 24,
"description": "Okres umowy w miesiącach (co najmniej 24 — minimum leasingu operacyjnego nowego auta). Silnik liczy N−1 rat i wykup jako N-tą płatność"
},
"vehicleCategory": {
"enum": [
"ELEKTRYCZNY",
"EMISJA_PONIZEJ_50",
"EMISJA_OD_50"
],
"type": "string",
"description": "Kategoria auta dla limitu wartości w kosztach (emisja CO2 z dowodu rejestracyjnego, pole V.7): ELEKTRYCZNY = elektryczny albo wodorowy, EMISJA_PONIZEJ_50 = poniżej 50 g/km (zwykle hybryda plug-in), EMISJA_OD_50 = 50 g/km i więcej (benzyna, diesel, LPG, zwykła hybryda). Zapytaj, nie zgaduj"
},
"vehiclePriceNet": {
"type": "number",
"description": "Cena samochodu osobowego NETTO (PLN, bez VAT), z oferty",
"exclusiveMinimum": 0
},
"scaleMarginalRate": {
"anyOf": [
{
"type": "number",
"const": 12
},
{
"type": "number",
"const": 32
}
],
"description": "Tylko SKALA: stawka PIT, w której jest dochód firmy (12 albo 32). WYMAGANA dla SKALA — narzędzie jej nie zgaduje"
},
"downPaymentPercent": {
"type": "number",
"maximum": 45,
"minimum": 0,
"description": "Opłata wstępna w procentach ceny netto, z oferty (0 = bez opłaty)"
},
"interestRatePercent": {
"type": "number",
"maximum": 30,
"minimum": 0,
"description": "Oprocentowanie nominalne roczne w procentach (stałe, z oferty). Podaj to ALBO wibor, nie oba"
}
}
}| taxForm* | string | LINIOWY, SKALA (wymaga scaleMarginalRate) albo RYCZALT (rata nie jest tam kosztem) |
| vatPayer* | boolean | Czy firma jest czynnym podatnikiem VAT. Narzędzie liczy wyłącznie dla czynnego (true) |
| leasingType* | string | Rodzaj leasingu. Narzędzie liczy wyłącznie OPERACYJNY — FINANSOWY odrzuca |
| buyoutPercent* | number | Wartość wykupu w procentach ceny netto, z oferty |
| durationMonths* | integer | Okres umowy w miesiącach (co najmniej 24 — minimum leasingu operacyjnego nowego auta). Silnik liczy N−1 rat i wykup jako N-tą płatność |
| vehicleCategory* | string | Kategoria auta dla limitu wartości w kosztach (emisja CO2 z dowodu rejestracyjnego, pole V.7): ELEKTRYCZNY = elektryczny albo wodorowy, EMISJA_PONIZEJ_50 = poniżej 50 g/km (zwykle hybryda plug-in), EMISJA_OD_50 = 50 g/km i więcej (benzyna, diesel, LPG, zwykła hybryda). Zapytaj, nie zgaduj |
| vehiclePriceNet* | number | Cena samochodu osobowego NETTO (PLN, bez VAT), z oferty |
| scaleMarginalRate | any | Tylko SKALA: stawka PIT, w której jest dochód firmy (12 albo 32). WYMAGANA dla SKALA — narzędzie jej nie zgaduje |
| downPaymentPercent* | number | Opłata wstępna w procentach ceny netto, z oferty (0 = bez opłaty) |
| interestRatePercent | number | Oprocentowanie nominalne roczne w procentach (stałe, z oferty). Podaj to ALBO wibor, nie oba |
| alternativeReturnPercent | number | Roczna stopa zwrotu z inwestycji, w którą włożyłbyś gotówkę zamiast kupić auto (%, np. oprocentowanie lokaty albo obligacji). Tylko gdy ją podasz, liczę koszt alternatywny gotówki — narzędzie jej nie zakłada |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"vehiclePriceNet",
"vehicleCategory",
"leasingType",
"durationMonths",
"downPaymentPercent",
"buyoutPercent",
"usage",
"vatPayer",
"taxForm",
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok zakupu auta za gotówkę i zawarcia umowy leasingu (ten sam moment w obu wariantach). Decyduje o stawkach PIT i VAT, a przy zakupie także o limicie amortyzacji: auto wprowadzone do ewidencji przed 2026 r. zachowuje limit 150 000 zł, od 2026 r. limit zależy od emisji CO2. W leasingu limit idzie za datą każdej raty"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Miesiąc zakupu i zawarcia umowy 1-12 — w tym miesiącu auto wchodzi do ewidencji środków trwałych"
},
"usage": {
"enum": [
"MIESZANY",
"TYLKO_FIRMOWY"
],
"type": "string",
"description": "MIESZANY = także prywatnie (VAT od raty 50%), TYLKO_FIRMOWY = wyłącznie w firmie (VAT 100%, wymaga ewidencji przebiegu i VAT-26)"
},
"wibor": {
"type": "object",
"required": [
"ratePercent",
"quotedOn",
"marginPercent"
],
"properties": {
"quotedOn": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Data notowania WIBOR-u (RRRR-MM-DD) — bez niej liczba nie ma znaczenia"
},
"ratePercent": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "WIBOR w procentach, z notowania"
},
"marginPercent": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "Marża leasingodawcy w procentach, z oferty"
}
},
"description": "Oprocentowanie zmienne: WIBOR z datą notowania i marża. Podaj to ALBO interestRatePercent, nie oba"
},
"taxForm": {
"enum": [
"LINIOWY",
"SKALA",
"RYCZALT"
],
"type": "string",
"description": "LINIOWY, SKALA (wymaga scaleMarginalRate) albo RYCZALT (rata nie jest tam kosztem)"
},
"vatPayer": {
"type": "boolean",
"description": "Czy firma jest czynnym podatnikiem VAT. Narzędzie liczy wyłącznie dla czynnego (true)"
},
"leasingType": {
"enum": [
"OPERACYJNY",
"FINANSOWY"
],
"type": "string",
"description": "Rodzaj leasingu. Narzędzie liczy wyłącznie OPERACYJNY — FINANSOWY odrzuca"
},
"buyoutPercent": {
"type": "number",
"maximum": 30,
"minimum": 1,
"description": "Wartość wykupu w procentach ceny netto, z oferty"
},
"durationMonths": {
"type": "integer",
"maximum": 120,
"minimum": 24,
"description": "Okres umowy w miesiącach (co najmniej 24 — minimum leasingu operacyjnego nowego auta). Silnik liczy N−1 rat i wykup jako N-tą płatność"
},
"vehicleCategory": {
"enum": [
"ELEKTRYCZNY",
"EMISJA_PONIZEJ_50",
"EMISJA_OD_50"
],
"type": "string",
"description": "Kategoria auta dla limitu wartości w kosztach (emisja CO2 z dowodu rejestracyjnego, pole V.7): ELEKTRYCZNY = elektryczny albo wodorowy, EMISJA_PONIZEJ_50 = poniżej 50 g/km (zwykle hybryda plug-in), EMISJA_OD_50 = 50 g/km i więcej (benzyna, diesel, LPG, zwykła hybryda). Zapytaj, nie zgaduj"
},
"vehiclePriceNet": {
"type": "number",
"description": "Cena samochodu osobowego NETTO (PLN, bez VAT), z oferty",
"exclusiveMinimum": 0
},
"scaleMarginalRate": {
"anyOf": [
{
"type": "number",
"const": 12
},
{
"type": "number",
"const": 32
}
],
"description": "Tylko SKALA: stawka PIT, w której jest dochód firmy (12 albo 32). WYMAGANA dla SKALA — narzędzie jej nie zgaduje"
},
"downPaymentPercent": {
"type": "number",
"maximum": 45,
"minimum": 0,
"description": "Opłata wstępna w procentach ceny netto, z oferty (0 = bez opłaty)"
},
"interestRatePercent": {
"type": "number",
"maximum": 30,
"minimum": 0,
"description": "Oprocentowanie nominalne roczne w procentach (stałe, z oferty). Podaj to ALBO wibor, nie oba"
},
"alternativeReturnPercent": {
"type": "number",
"maximum": 30,
"minimum": 0,
"description": "Roczna stopa zwrotu z inwestycji, w którą włożyłbyś gotówkę zamiast kupić auto (%, np. oprocentowanie lokaty albo obligacji). Tylko gdy ją podasz, liczę koszt alternatywny gotówki — narzędzie jej nie zakłada"
}
}
}| earlyRepaymentFeePct | number | Rekompensata za wcześniejszą spłatę ze stawki w umowie, % nadpłacanej kwoty. Bez wartości opłata nie jest liczona. Przy kredycie konsumenckim bank może żądać najwyżej 1% (0,5% w ostatnim roku umowy, art. 49 ustawy o kredycie konsumenckim); przy kredycie firmowym (na działalność) wiąże tylko umowa |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"principal",
"annualRatePct",
"months",
"installmentType"
],
"properties": {
"months": {
"type": "integer",
"maximum": 420,
"minimum": 1,
"description": "Liczba rat miesięcznych, 1–420"
},
"principal": {
"type": "number",
"description": "Kwota kredytu (saldo do spłaty na start harmonogramu), zł",
"exclusiveMinimum": 0
},
"overpayment": {
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"lower_installment",
"shorter_term"
],
"type": "string",
"description": "lower_installment = niższa rata, okres bez zmian; shorter_term = rata bez zmian, krótszy okres"
},
"monthly": {
"type": "object",
"required": [
"amount",
"fromMonth"
],
"properties": {
"amount": {
"type": "number",
"description": "Nadpłata co miesiąc, zł",
"exclusiveMinimum": 0
},
"fromMonth": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Od której raty (numer od 1) — pierwsza nadpłata po tej racie"
},
"untilMonth": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Do której raty włącznie; bez wartości — do spłaty kredytu"
}
},
"description": "Nadpłata co miesiąc"
},
"oneTime": {
"type": "object",
"required": [
"month",
"amount"
],
"properties": {
"month": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Po której racie (numer raty od 1) wpłacasz nadpłatę"
},
"amount": {
"type": "number",
"description": "Kwota nadpłaty jednorazowej, zł",
"exclusiveMinimum": 0
}
},
"description": "Nadpłata jednorazowa"
}
},
"description": "Nadpłata: jednorazowa (oneTime) i/lub co miesiąc (monthly), z trybem"
},
"annualRatePct": {
"type": "number",
"maximum": 30,
"minimum": 0,
"description": "Oprocentowanie nominalne roczne w procentach (0–30), stałe przez cały harmonogram"
},
"installmentType": {
"enum": [
"equal",
"decreasing"
],
"type": "string",
"description": "equal = raty równe (annuitetowe), decreasing = raty malejące (stała część kapitałowa)"
},
"earlyRepaymentFeePct": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Rekompensata za wcześniejszą spłatę ze stawki w umowie, % nadpłacanej kwoty. Bez wartości opłata nie jest liczona. Przy kredycie konsumenckim bank może żądać najwyżej 1% (0,5% w ostatnim roku umowy, art. 49 ustawy o kredycie konsumenckim); przy kredycie firmowym (na działalność) wiąże tylko umowa"
}
}
}| annualRaisePercent | number | Podwyżka rocznie, w procentach |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"startYear",
"years",
"initialGross"
],
"properties": {
"ppk": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
},
"employeeAdditional": {
"type": "number",
"maximum": 2,
"minimum": 0
},
"employerAdditional": {
"type": "number",
"maximum": 2.5,
"minimum": 0
},
"employeeContribution": {
"type": "number",
"maximum": 4,
"minimum": 0,
"description": "Procent, podstawowo 2"
},
"employerContribution": {
"type": "number",
"maximum": 4,
"minimum": 0,
"description": "Procent, podstawowo 1,5"
}
}
},
"years": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"hasPIT2": {
"type": "boolean",
"default": true,
"description": "Złożony PIT-2 (kwota wolna dzielona na miesiące)"
},
"startYear": {
"type": "integer",
"maximum": 2030,
"minimum": 2024,
"description": "Rok podatkowy — decyduje o stałych (progi, ZUS, płaca minimalna)"
},
"allowances": {
"type": "object",
"properties": {
"authorCosts": {
"type": "object",
"required": [
"enabled",
"monthlyAuthorIncome",
"percentage"
],
"properties": {
"enabled": {
"type": "boolean"
},
"percentage": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"monthlyAuthorIncome": {
"type": "number",
"minimum": 0
}
},
"description": "50% koszty autorskie od części wynagrodzenia"
},
"youngWorker": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
},
"birthDate": {
"type": "string"
}
},
"description": "Ulga dla młodych — do ukończenia 26 lat"
},
"familyPitZero": {
"type": "object",
"required": [
"enabled",
"numberOfChildren",
"incomeLimit"
],
"properties": {
"enabled": {
"type": "boolean"
},
"incomeLimit": {
"type": "number",
"minimum": 0
},
"numberOfChildren": {
"type": "integer",
"maximum": 15,
"minimum": 0
}
},
"description": "PIT-0 dla rodzin — limit dochodu na rodzica"
},
"familyAllowance": {
"type": "object",
"required": [
"enabled",
"numberOfChildren"
],
"properties": {
"enabled": {
"type": "boolean"
},
"numberOfChildren": {
"type": "integer",
"maximum": 10,
"minimum": 0
}
},
"description": "Ulga prorodzinna (odliczenie od podatku)"
},
"returningToPoland": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
}
},
"description": "Ulga na powrót"
},
"largeFamilyAllowance": {
"type": "object",
"required": [
"enabled",
"numberOfChildren"
],
"properties": {
"enabled": {
"type": "boolean"
},
"numberOfChildren": {
"type": "integer",
"maximum": 15,
"minimum": 0
}
},
"description": "Ulga dla rodzin 4+"
}
}
},
"initialGross": {
"type": "number",
"minimum": 0,
"description": "Brutto miesięcznie w pierwszym roku"
},
"withSickness": {
"type": "boolean",
"default": true,
"description": "Składka chorobowa — na umowie o pracę obowiązkowa"
},
"costDeductionType": {
"enum": [
"local",
"non-local"
],
"type": "string",
"default": "local",
"description": "Koszty uzyskania: local = miejscowe, non-local = dojazdowe"
},
"annualRaisePercent": {
"type": "number",
"default": 0,
"maximum": 100,
"minimum": -50,
"description": "Podwyżka rocznie, w procentach"
}
}
}