Kategorie kosztów z pozycji faktur
Wysyłasz nazwy pozycji z faktur kosztowych (z dostawcą i kwotą, jeśli chcesz), a model AI przypisuje każdej kategorię z listy: mojej domyślnej albo Twojej, np. kolumn KPiR, kont kosztów czy własnych grup. Kod pilnuje, żeby odpowiedź była zawsze z listy.
Biura rachunkowe, programy księgowe, obieg dokumentów
Start
49 złnetto miesięcznie
do 500 pozycji dziennie
Jedno biuro albo firma z większą liczbą faktur kosztowych.
Więcej
149 złnetto miesięcznie
do 3 000 pozycji dziennie
Program księgowy dla wielu klientów.
Koszt modelu AI jest w cenie.
Zapytanie i odpowiedź
curl https://odswiezona.pl/api/v1/kategorie \ -H "Authorization: Bearer odsw_TWÓJ_KLUCZ" \ -H "Content-Type: application/json" \ -d '{"pozycje": [{"nazwa": "Olej napędowy ON", "dostawca": "Stacja paliw", "kwota": 312.40}, {"nazwa": "Abonament Microsoft 365 Business"}], "kategorie": ["zakup towarów", "koszty uboczne zakupu", "wynagrodzenia", "pozostałe wydatki"]}'
200 OK
{ "ok": true, "kategorie": ["zakup towarów", "koszty uboczne zakupu", "wynagrodzenia", "pozostałe wydatki"], "wyniki": [{ "nazwa": "Olej napędowy ON", "kategoria": "pozostałe wydatki" }, { "nazwa": "Abonament Microsoft 365 Business", "kategoria": "pozostałe wydatki" }], "limit": { "dzienny": 500, "wykorzystano": 2 }}
| Co | Jak |
|---|---|
| Zapytanie | POST /api/v1/kategorie, JSON: pozycje (1–50, pola nazwa, opcjonalnie dostawca i kwota netto), kategorie (opcjonalnie 2–40 nazw) |
| Kategorie domyślne | towary i materiały, paliwo i transport, media i energia, telefon i internet, oprogramowanie i IT, marketing i reklama, księgowość i prawo, najem i nieruchomości, sprzęt i wyposażenie, usługi zewnętrzne, ubezpieczenia, szkolenia, inne |
| Wynik | zawsze nazwa z listy; gdy model nie jest pewny, „inne” (jeśli jest na liście) albo null |
| Klucz | nagłówek Authorization: Bearer odsw_…; ten sam klucz może obsługiwać kilka API (wszystkie API) |
| Limity | dzienny według planu (liczy się każda pozycja) i 20 zapytań na minutę; limit odnawia się o północy |
| Błędy | 400 złe dane (nie liczą się do limitu), 401 zły klucz, 429 limit, 502 chwilowy błąd |
To podpowiedź, nie porada podatkowa: o ujęciu kosztu i odliczeniu VAT decyduje księgowa. Wysyłaj tylko to, co potrzebne: nazwy pozycji, dostawców i kwoty, bez NIP-ów i danych osób. Pozycje przekazuję do modelu OpenAI (umowa z OpenAI Ireland; dane z API nie służą do trenowania modeli) i nie zapisuję ich u siebie; liczę tylko liczbę pozycji na klucz. OpenAI jest w umowie powierzenia, którą podpisuję razem z umową na API.
Klucz testowy na tydzień
Napisz, jakich kategorii używasz. Dostaniesz klucz z małym limitem, żeby sprawdzić trafność na własnych fakturach.