F-sąskaita API

F-sąskaita API leidžia išrašyti sąskaitas faktūras, registruoti išlaidas ir atsisiųsti dokumentus verslui, kurį valdote app.fsaskaita.lt. Tai nedidelė REST API: JSON įeina, JSON išeina, bearer prieigos raktai, priskirti vienam verslui.

https://app.fsaskaita.lt/api

Ką galite daryti

Resursas	Operacijos
Sąskaitos faktūros	sąrašas, kūrimas, peržiūra, atnaujinimas, šalinimas, PDF atsisiuntimas
Išlaidos	sąrašas, kūrimas su failu, peržiūra, atnaujinimas, failo pakeitimas, šalinimas, failo atsisiuntimas
Profilis	verslo, kuriam priklauso prieigos raktas, peržiūra
Valiutos	priimamų valiutų kodų sąrašas
Webhook pranešimai	gaukite `invoice.` ir `expense.` įvykius į savo HTTPS galinį tašką

Pradėkite čia

Autentifikacija: sukurkite verslo prieigos raktą ir atlikite pirmą užklausą.
Sąskaitos faktūros: sąskaitos modelis, numeracija ir kūrimo užklausa.
Išlaidos: multipart įkėlimai ir failo pakeitimas.
Webhook pranešimai: prenumerata, parašo tikrinimas, pakartotiniai siuntimai.
Konvencijos: puslapiavimas, klaidos, užklausų limitai, datos ir pinigų sumos.

Žinynas aprašo visus galinius taškus. Pati specifikacija pasiekiama adresu /openapi.json.

AI agentams

Skaitykite /llms.txt, kur pateiktas visų puslapių indeksas, /llms-full.txt, kur yra visas tekstas, ir agentų puslapį, kuriame glaustai aprašyta, kaip integruotis.

Instrukcijos agentuiAtverti kaip tekstą

Implement invoicing in this project with the F-sąskaita API.

Read first, in this order:
1. https://docs.fsaskaita.lt/llms.txt — the index of every documentation page. Fetch the Invoices and Conventions guides from it.
2. https://docs.fsaskaita.lt/openapi.json — the Spec: every endpoint, field and enum.
Take field names and behaviour from the Spec. Where this prompt and the Spec disagree, the Spec wins.

Facts
- Base URL: https://app.fsaskaita.lt/api. JSON in, JSON out.
- Authentication: a Business token, scoped to one business, sent as `Authorization: Bearer <token>`. Read it from the FSASKAITA_TOKEN environment variable and keep it out of code, logs and version control.
- Send `Accept: application/json` on every request; without it, 401 and 429 responses are HTML.
- Rate limit: 60 requests per minute per business. On 429, wait `Retry-After` seconds, then retry.
- Validation errors: 422 with `{ "message", "errors": { "field.path": ["..."] } }`. Messages are in Lithuanian; show them to the user unchanged.
- Lists: `?page=N`, 50 per page, newest first, no filters. Single resources are wrapped in `{ "data": ... }`.
- Identifiers are UUIDs, dates are `YYYY-MM-DD`, money values are JSON numbers, currency codes are uppercase ISO 4217 and must appear in `GET /currencies`.

Build
1. One client module with a narrow interface: base URL, both headers, JSON encoding, and typed errors for 401, 404, 422, 429 and 500. Retry only on 429, and only GET, PUT and DELETE.
2. createInvoice(input): `POST /invoices`. Default `use_default_seller_info: true`. For each line in `products` send exactly one of `price`, `total` or `total_incl_vat`. Types ending in `vat_invoice` need `vat_percentage` on every line. Omit `invoice_number` so the series assigns the next one. Return `data` from the 201 response; it includes `share_link`, a public page where the buyer views and downloads the invoice.
3. downloadInvoicePdf(id): `GET /invoices/{id}/download`, called after create. Stream the body: there is no Content-Length, and the response can take up to about 20 seconds if the PDF is not ready yet.
4. updateInvoice(id, input): `PUT /invoices/{id}` replaces the whole invoice. Read it first, change what you need, and send it back including the current `invoice_number`; an update without it renumbers the invoice.
5. Webhooks, when the project needs them: an HTTPS endpoint that verifies the `Signature` header (hex HMAC-SHA256 of the raw body with the subscription secret) before parsing, and treats deliveries as at-least-once.

Rules
- There is no idempotency key. After a network error on POST, list recent invoices with `GET /invoices` and check before creating again.
- Every invoice the API creates is final and numbered; drafts exist only in the app.
- Tokens and webhook subscriptions have no API. A person creates them in the app under Settings, Integrations, and the integration reads them from configuration.

Done when
- Unit tests with recorded responses cover 201, 422 and 429.
- A live check runs only when FSASKAITA_TOKEN is set. It creates a real, numbered invoice, so ask before running it and delete the invoice afterwards with `DELETE /invoices/{id}`.
- Your report names what you built, which endpoints you used, and what in the Spec you left out.

Plano reikalavimas

API prieiga ir webhook pranešimai įtraukti į Premium planą. Kituose planuose prieigos rakto ir webhook nustatymai programėlėje nepasiekiami.

Sąskaitos.
Jūsų kode.

Pirma užklausa

Pažinkite Public API

Kurkite su AI

Ką galite daryti

Pradėkite čia

AI agentams

Plano reikalavimas

Sąskaitos.Jūsų kode.

Pirma užklausa

Pažinkite Public API

Kurkite su AI

Ką galite daryti

Pradėkite čia

AI agentams

Plano reikalavimas

Sąskaitos.
Jūsų kode.