Format, cyfra kontrolna, przykłady przyjmowane i odrzucane oraz wywołanie API dla NIP / REGON (Polska). Każdy przykład na tej stronie przechodzi przez te same walidatory co bezpłatny walidator identyfikatorów, więc wartość pokazana jako przyjęta jest wartością, którą walidator przyjmuje.
| Pole | Wartość |
|---|---|
| Rejestr | Krajowa Administracja Skarbowa (KAS) |
| Kształt | N{9} C |
| Cyfra kontrolna | Wymuszana. Wagi 6,5,7,2,3,4,5,6,7 dla pierwszych 9 cyfr; suma modulo 11 jest cyfrą kontrolną. Reszta 10 nigdy nie jest nadawana. |
| Przykład z obliczeniem (przyjęty) | 7740001454 |
| Postać znormalizowana | 7740001454 |
| Przyjmowane także na wejściu | 774-000-14-54 |
| Pomyłka jednego znaku | 7740001455 jest odrzucany |
| Wyrażenie regularne (postać znormalizowana) | ^[0-9]{10}$ |
| Wywołanie API | GET /companies/search?country=PL&nip=7740001454 |
| Numer VAT | PL + NIP — zbudowany z identyfikatora według reguły; rejestracja nie jest potwierdzona |
NIP to numer podatkowy. Numer KRS (10 cyfr, uzupełniony zerami, podawany w company_number) nie ma cyfry kontrolnej i nie jest tu sprawdzany.
curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?country=PL&nip=7740001454" \ -H "Authorization: Bearer YOUR_API_KEY"
| Pole | Wartość |
|---|---|
| Rejestr | GUS (REGON) |
| Kształt | N{8} C | N{13} C |
| Cyfra kontrolna | Wymuszana. REGON-9: wagi 8,9,2,3,4,5,6,7, suma modulo 11 (10 oznacza 0). REGON-14 powtarza to dla pierwszych 9 cyfr i dodaje drugą kontrolę dla wszystkich 13 (wagi 2,4,8,5,0,9,7,3,6,1,2,4,8). |
| Przykład z obliczeniem (przyjęty) | 610188201 |
| Postać znormalizowana | 610188201 |
| Pomyłka jednego znaku | 610188202 jest odrzucany |
| Wyrażenie regularne (postać znormalizowana) | ^([0-9]{9}|[0-9]{14})$ |
| Wywołanie API | GET /companies/search?country=PL®on=610188201 |
| Numer VAT | Dane rejestru nie zawierają numeru VAT dla tego identyfikatora. |
REGON-9 identyfikuje podmiot, REGON-14 jego jednostkę lokalną.
curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?country=PL®on=610188201" \ -H "Authorization: Bearer YOUR_API_KEY"
Oznaczenia kształtu: N cyfra · L litera · X cyfra lub litera · C cyfra lub znak kontrolny · {n} powtórzone n razy.
Poprawny kształt i cyfra kontrolna dowodzą, że numer jest poprawnie zbudowany, a nie że firma go posiada. Odpowiedź daje dopiero sprawdzenie w rejestrze.
Rozpocznij 14-dniowy darmowy okres próbny · 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.