Biura rachunkowe, programy księgowe, obieg dokumentów

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: naszej domyślnej albo Twojej, np. kolumn KPiR, kont kosztów czy własnych grup. Kod pilnuje, żeby odpowiedź była zawsze z listy.

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"]}'

{
  "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 przekazujemy do modelu OpenAI (umowa z OpenAI Ireland; dane z API nie służą do trenowania modeli) i nie zapisujemy ich u siebie; liczymy tylko liczbę pozycji na klucz. OpenAI jest w umowie powierzenia, którą podpisujemy 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.

Poproś o klucz testowy