Numer KSeF: sprawdzenie struktury


curl "https://api.prometiam.com/functions/v1/risk-api/einvoicing/check?type=pl_ksef_number&reference=5265877635-20250826-0100001AF629-AF" \
  -H "Authorization: Bearer YOUR_API_KEY"

Wklej numer KSeF i zobacz, czy ma poprawną budowę: NIP sprzedawcy, datę, część skrótu i dwa znaki kontrolne. Bezpłatnie, w przeglądarce, bez rejestracji.

Z czego składa się numer KSeF

Numer KSeF faktury ma 35 znaków: NIP sprzedawcy (10 cyfr), datę (8 cyfr), 12 znaków szesnastkowych i dwa znaki kontrolne, połączone myślnikami. Strona odczytuje z niego NIP sprzedawcy i datę tak, jak są zapisane w numerze.

To sprawdzenie nie łączy się z KSeF. Mówi tylko, że numer ma poprawną budowę i że jego znaki kontrolne się zgadzają, nie że faktura o tym numerze istnieje w KSeF.

Co mówi sprawdzenie

W przypadku numeru KSeF sprawdzana jest forma określona przez wydawcę oraz cyfry kontrolne. Wartość, która przechodzi, ma poprawną budowę, a jej cyfry kontrolne się zgadzają.

Czego sprawdzenie nie mówi

  • Nie mówi, że referencja została nadana, jest zarejestrowana lub aktywna, ani że organ podatkowy przyjmie fakturę, która ją zawiera.
  • Status na żywo z krajowego organu podatkowego (w tym KSeF) nie jest udostępniany.
  • Sprawdzenie działa w Twojej przeglądarce: to, co wpiszesz, nie jest wysyłane do Prometiam.
  • Prometiam nie jest punktem dostępowym Peppol: nie wysyła, nie odbiera ani nie waliduje faktur.

To samo sprawdzenie przez API

GET /einvoicing/check z type=pl_ksef_number i reference zwraca valid, normalized, basis oraz, gdy wartość coś koduje, parts. Jeden kredyt za wywołanie, błędy są bezpłatne.

curl 'https://api.prometiam.com/functions/v1/risk-api/einvoicing/check?type=pl_ksef_number&reference=5265877635-20250826-0100001AF629-AF' \
  -H 'Authorization: Bearer rk_live_...'

Powiązane strony

Zarejestruj się · Dokumentacja API

Okres próbny trwa 14 dni i obejmuje 500 kredytów. Wymagana jest karta, w trakcie okresu próbnego nic nie jest pobierane; potem obowiązuje plan Starter (9,99 € miesięcznie), jeśli go nie anulujesz.

Najczęstsze pytania

Czy pozytywny wynik oznacza, że numeru KSeF istnieje?
Nie. Oznacza, że wartość ma poprawną budowę i jej cyfry kontrolne się zgadzają. Sprawdzenie offline nigdy nie mówi, że referencja została nadana, jest zarejestrowana lub aktywna.
Czy to jest sprawdzane w organie podatkowym?
Nie. Status na żywo z krajowego organu podatkowego nie jest udostępniany; sprawdzenie działa offline.
Czy mogę to zrobić w kodzie?
Tak: GET /einvoicing/check?type=pl_ksef_number&reference=... z kluczem API, jeden kredyt za wywołanie.