Kevytyrittäjälaskuri API & AI Agent Documentation

Laskentarajapinta

GET /api/calculate sekä /api/calculate.json käyttävät samaa laskentamoottoria kuin sivuston laskurit. Esimerkki: 1 000 euron UKKO-laskelma.

Parametreja ovat billingAmount, serviceId, calculationMode (gig/monthly), isVatIncluded, vatRate, expenseAmount, expenseVatRate, vatRegistered, taxRatePercent, includeYel, yelMonthlyIncome, isNewEntrepreneur, includeInsurance, needsInstantPayout, instantPayoutTiming (before-payment/after-payment), annualBillingEstimate ja cumulativeBillingEstimate. Totuusarvot annetaan muodossa true tai false. Vanhat taxPercent, expenses ja hasYel toimivat edelleen. needsInstantPayout=true ilman ajoitusta tarkoittaa rahoitusta ennen asiakkaan maksua. Nopeaan tilitykseen asiakkaan maksun jälkeen käytä instantPayoutTiming=after-payment.

Tulos erottaa välittömän tuloarvion (immediatePayoutEur), myöhemmän verohyödyn (futureTaxBenefitEur), kulujen ALV:n (serviceCostsVatEur) ja kokonaishyödyn (netIncomeInHand). Virheellinen syöte, ylittyvä laskutus- tai rahoitusraja, puuttuva maksuvaihtoehto tai palvelu, jonka kokonaiskulu ei ole laskettavissa, palauttaa HTTP 400 -vastauksen.

Euromäärät kulkevat tässä rajapinnassa osoiteparametreina. Käyttäjien laskelmien jakamiseen käytetään etusivun Jaa laskelma -toimintoa ja URL-fragmenttia. Rajapinta toimii dynaamisesti Cloudflare Pages Functions -julkaisussa; staattinen koontitiedosto on vain esimerkkivastaus.

Palveluhakemisto

GET /api/services ja /api/services.json palauttavat palveluiden tilan, laskettavuuden, lähteet ja hinnoittelun. Tarkista isClosed ja calculationAvailable ennen laskentaa. calculationUnavailableReason kuvaa puuttuvan tiedon tai rajoituksen. Vanhojen tasaisten hintakenttien arvo on null suljetulle tai puutteelliselle palvelulle.

pricing sisältää ALV-käsittelyn, vähimmäismaksut, hintaportaat, vakuutustiedot ja payoutOptions-maksuvaihtoehdot. Maksuvaihtoehdolla on ajoitus, hinta, ALV-käsittely, mahdollinen raja ja sen ALV-peruste sekä ehdot ja lähde. Hakemiston laskettavuus ei takaa rahoituksen hyväksyntää. pricingNotes ja pricingCheckedAt kertovat tietojen rajauksista ja tarkistuksesta.