Dokumentacja API - ifirma.pl


Wyszukiwanie kontrahentów


Możliwe jest wyszukiwanie kontrahentów podając poniższe dane lub ich fragment:

  • identyfikator
  • nazwa
  • numer NIP

W celu wyszukania kontrahenta należy przesłać żądanie GET na adres:

https://www.ifirma.pl/iapi/kontrahenci/{SZUKANA_FRAZA}.json

Klucz autoryzacji: FAKTURA

Szukana fraza może zawierać znaki niedozwolone w URL, takie jak np. spacja, jeśli te zostaną odpowiednio zakodowane (np. zamiast znaku spacji należy podać %20).

W odpowiedzi zostaje zwrócony obiekt response zawierający pola:

  • Kod:
    • 0 – w przypadku odnalezienia dopasowania
    • 208 – jeśli nie odnaleziono pasującego kontrahenta
    • 100 – problem techniczny
  • Informacja – tekstowa informacja w przypadku błędu
  • Wynik – lista szczegółów odnalezionych kontrahentów z ograniczeniem do 20 pozycji

Przykład adresu URL dla wyszukiwania kontrahenta o nazwie IFIRMA SA:

https://www.ifirma.pl/iapi/kontrahenci/IFIRMA%20SA.json

Odpowiedź:

{
    "response":{
        "Kod": 0,
        "Informacja": "",
        "Wynik":[
            {
            "Nazwa": "IFIRMA SA",
            "Nazwa2": "",
            "Identyfikator": "IFIRMA",
            "PrefiksUE": "PL",
            "NIP": "8981647572",
            "Ulica": "Grabiszyńska 241 B",
            "KodPocztowy": "53-234",
            "Kraj": "",
            "Miejscowosc": "Wrocław",
            "Email": "bok@ifirma.pl",
            "Telefon": "71 7694300",
            "OsobaFizyczna": false,
            "ZgodaNaEfaktury": true,
            "DataUdzieleniaZgody": null,
            "EmailDlaFaktury": null,
            "JestDostawca": false,
            "JestOdbiorca": false,
            "AdresZagraniczny": false,
            "Skype": "",
            "Faks": "",
            "Uwagi": "",
            "Www": "www.ifirma.pl",
            "NazwaBanku": null,
            "NumerKonta": null,
            "DrugiTelefon": "",
            "AdresKorespondencyjnyUlica": "",
            "AdresKorespondencyjnyKodPocztowy": "",
            "AdresKorespondencyjnyKraj": "",
            "AdresKorespondencyjnyMiejscowosc": "",
            "Wybrany": false,
            "WyslijNaObaEmaile": false
            }
        ]
    }
}


Copyright 2001-2018 ifirma.pl