Dane firmy po NIP

Endpoint /company/nip-lookup pobiera dane polskiej firmy z rejestru GUS. Użyj go, żeby automatycznie uzupełnić dane kontrahenta albo nabywcy przy tworzeniu dokumentu, zamiast prosić użytkownika o ręczne przepisywanie.

Wymagany zakres uprawnień: gus:company:read.

Wyszukiwanie#

curl -s "https://prod.api.fakturnia.pl/external/v1/company/nip-lookup?nip=5252248481" \
  -H "Authorization: Bearer $TOKEN"

NIP podajesz jako 10 cyfr. Myślniki i spacje są ignorowane, więc 525-224-84-81 też zadziała.

{
  "success": true,
  "data": {
    "company": {
      "nip": "5252248481",
      "name": "PRZYKŁAD SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ",
      "regon": "146061343",
      "street": "ul. Prosta 1 lok. 2",
      "postcode": "00-001",
      "city": "Warszawa",
      "country": "Polska",
      "countryCode": "PL"
    }
  }
}

Błędy#

Typowy przepływ#

1. Użytkownik podaje NIP w Twoim formularzu.
2. Wywołujesz nip-lookup i wypełniasz formularz zwróconymi danymi.
3. Po zatwierdzeniu tworzysz kontrahenta albo przekazujesz dane nabywcy wprost w POST /documents.

Dane pochodzą z rejestru publicznego i mają charakter pomocniczy: przed wystawieniem faktury użytkownik powinien móc je poprawić. Pamiętaj też, że wysyłka do KSeF wymaga pełnego adresu nabywcy.