Poprzez API ifirma.pl możliwe jest zarządzanie kwestionariuszami osobowymi dla pracowników. Możliwe jest:
Możliwe jest pobranie kwestionariusza osobowego pracownika na podstawie identyfikatora kwestionariusza.
Pobranie kwestionariusza w formacie JSON | |
---|---|
Adres URL: | https://www.ifirma.pl/iapi/kwestionariusz/find/{ticket}.json |
Typ żądania: | GET |
Klucz autoryzacji: | abonent |
Pobranie kwestionariusza w formacie PDF | |
---|---|
Adres URL: | https://www.ifirma.pl/iapi/kwestionariusz/find/{ticket}.pdf |
Typ żądania: | GET |
Klucz autoryzacji: | abonent |
gdzie jako ticket należy wstawić identyfikator kwestionariusza, np.:
https://www.ifirma.pl/iapi/kwestionariusz/find/rM0e7SS6i2uLV7591FsH.json
https://www.ifirma.pl/iapi/kwestionariusz/find/rM0e7SS6i2uLV7591FsH.pdf
Na wskazany w żądaniu adres e-mail zostanie przesłany kwestionariusz osobowy.
Jednocześnie na koncie użytkownika zostanie utworzony nowy pracownik ze statusem przesłano kwestionariusz.
Żądanie | |
---|---|
Adres URL: | https://www.ifirma.pl/iapi/kwestionariusz/send.json |
Typ żądania: | POST |
Format żądania: | JSON |
Klucz autoryzacji: | abonent |
Struktura JSON żądania:
Nazwa w JSON | Typ danych | Wartości | Wymagane | Opis |
---|---|---|---|---|
String | >= 1 znak; <= 65 znaków |
T | Adres e-mail, na który zostanie przesłany kwestionariusz osobowy | |
Imie | String | >= 1 znak; <= 30 znaków |
T | Imię odbiorcy kwestionariusza |
Nazwisko | String | >= 1 znak; <= 50 znaków |
T | Nazwisko odbiorcy kwestionariusza |
OsobaWspolpracujaca | Boolean | T | Pracownikowi dodanemu z wartością true nie będą naliczane składki FGŚP | |
Telefon | String | <= 16 znaków | N |
Przykładowa zawartość żądania (JSON):
{
"Email": "andrzej@krzywy.pl";
"OsobaWspolpracujaca": false;
"Imie": "Andrzej";
"Nazwisko": "Krzywy";
"Telefon": "608255998";
}
W odpowiedzi zwracany jest kod wiadomości mówiący o poprawności wykonania żądania oraz identyfikator kwestionariusza.
W oparciu o przesłane dane, na koncie użytkownika zostanie utworzony nowy pracownik ze statusem kwestionariusz wypełniony
Żądanie | |
---|---|
Adres URL: | https://www.ifirma.pl/iapi/kwestionariusz.json |
Typ żądania: | POST |
Format żądania: | JSON |
Klucz autoryzacji: | abonent |
Struktura JSON żądania:
Nazwa w JSON | Typ danych | Wartości | Wymagane | Opis |
---|---|---|---|---|
OsobaWspolpracujaca | Boolean | T | Pracownikowi dodanemu z wartością true nie będą naliczane składki FGŚP | |
String | >= 1 znak; <= 65 znaków |
T | ||
Telefon | String | <= 16 znaków | N | Numer telefonu |
Imie | String | >= 1 znak; <= 30 znaków |
T | |
DrugieImie | String | <= 30 znaków | N | |
Nazwisko | String | >= 1 znak; <= 50 znaków |
T | |
PESEL | String | 11 znaków | T/N | Pole wymagane, jeśli obywatelstwo polskie |
DataUrodzenia | String | Format: DD-MM-RRRR | N | Numer telefonu odbiorcy kwestionariusza |
Plec | String | M (mężczyzna); K (kobieta) |
T | |
RodzajDokumentuTozsamości | String | DOWOD_OSOBISTY (dla dowodu osobistego); PASZPORT (dla paszportu) |
N | Rodzaj dowodu tożsamości pracownika |
SeriaNumerDowoduTozsamosci | String | <= 20 znaków | N | Seria i numer wybranego dokumentu tożsamości |
Obywatelstwo | String | np. Polskie | T | |
MiejsceRezydencjiPolska | Boolean | T | Wartość TRUE oznacza, że pracownik jest rezydentem polskim | |
UrzadSkarbowyKod | String | kod urzędu skarbowego | T | Tabela: Urzędy skarbowe |
KodNFZ | String | kod oddziału NFZ | N | Tabela: Oddziały NFZ |
KontoBankowe | String | 26 znaków | N | Numer konta bankowego pracownika |
NazwaBanku | String | <= 50 znaków | N | Nazwa banku, w któym założone jest konto bankowe |
TypUkonczonejSzkolyId | String | Identyfikator rodzaju szkoły | N | Tabela: Rodzaj szkoły |
StazPracy | Integer | N | Staż pracy pracownika liczony w latach | |
AdresZameldowania | Nie wypełniać, jeśli pracownik nie posiada adresu zameldowania | |||
Ulica | String | <= 50 znaków | T | |
NumerDomu | String | <= 10 znaków | T | |
NumerLokalu | String | <= 10 znaków | N | |
AdresZagraniczny | Boolean | T | Wartość TRUE znosi walidację na polski kod pocztowy | |
KodPocztowy | String | <= 16 znaków | T | Walidacja na polski kod pocztowy w zależności od wartości pola AdresZagraniczny |
Miejscowosc | String | <= 50 znaków | T | |
Poczta | String | <= 50 znaków | T | |
Gmina | String | <= 50 znaków | T | |
Powiat | String | <= 50 znaków | T | |
Wojewodztwo | String | np. dolnośląskie | T | |
Kraj | String | np. Niemcy | T/N | Pole obowiązkowe, jeśli adres jest zagraniczny |
AdresZamieszkania | ||||
Ulica | String | <= 50 znaków | T | |
NumerDomu | String | <= 10 znaków | T | |
NumerLokalu | String | <= 10 znaków | N | |
AdresZagraniczny | Boolean | T | Wartość TRUE znosi walidację na polski kod pocztowy | |
KodPocztowy | String | <= 16 znaków | T | Walidacja na polski kod pocztowy w zależności od wartości pola AdresZagraniczny |
Miejscowosc | String | <= 50 znaków | T | |
Poczta | String | <= 50 znaków | T | |
Gmina | String | <= 50 znaków | T | |
Powiat | String | <= 50 znaków | T | |
Wojewodztwo | String | np. dolnośląskie | T | |
Kraj | String | np. Niemcy | T/N | Pole obowiązkowe, jeśli adres jest zagraniczny |
AdresKorespondencyjny | ||||
Ulica | String | <= 50 znaków | T | |
NumerDomu | String | <= 10 znaków | T | |
NumerLokalu | String | <= 10 znaków | N | |
AdresZagraniczny | Boolean | T | Wartość TRUE znosi walidację na polski kod pocztowy | |
KodPocztowy | String | <= 16 znaków | T | Walidacja na polski kod pocztowy w zależności od wartości pola AdresZagraniczny |
Miejscowosc | String | <= 50 znaków | T | |
Poczta | String | <= 50 znaków | T | |
Kraj | String | np. Niemcy | T/N | Pole obowiązkowe, jeśli adres jest zagraniczny |
Oświadczenia | Treść oświadczenia | |||
ZatrudnienieRodzimyZaklad | Boolean | T | Oświadczam, że jestem pracownikiem zatrudnionym w rodzimym zakładzie pracy | |
ZatrudnienieInnyZaklad | Boolean | T | Oświadczam, że jestem zatrudniony na podstawie umowy o pracę w innym zakładzie pracy | |
MinimalneWynagrodzenie | Boolean | T | Osiągam co najmniej minimalne wynagrodzenie brutto | |
ZleceniobiorcaSpeleczneZdrowotne | Boolean | T | Oświadczam, że jestem zleceniobiorcą zgłoszonym do ubezpieczenia społecznego i zdrowotnego | |
ZleceniobiorcaTylkoZdrowotne | Boolean | T | Oświadczam, że jestem zleceniobiorcą zgłoszonym do ubezpieczenia zdrowotnego | |
Rencista | Boolean | T | Oświadczam, że jestem rencistą | |
Emeryt | Boolean | T | Oświadczam, że jestem emerytem | |
Student | Boolean | T | Oświadczam, że jestem studentem lub uczniem szkoły ponadpodstawowej do 26 roku życia | |
DzialanoscGospodarcza | Boolean | T | Oświadczam, że jestem osobą prowadzącą działalność gospodarczą | |
PodlegaKRUS | Boolean | T | Oświadczam, że jestem osobą podlegającą ubezpieczeniu w KRUS | |
BrakTytuluUbezpieczenia | Boolean | T | Oświadczam, że jestem osobą nie posiadającą żadnego tytułu do ubezpieczeń | |
Bezrobotny | Boolean | T | Oświadczam, że jestem osobą pozostającą w rejestrze bezrobotnych | |
Niepelnosprawny | Boolean | T | Oświadczam, że posiadam orzeczenie o stopniu niepełnosprawności | |
StopienNiepelnosprawnosciID | String | Identyfikator stopnia niepełnosprawności | T | Tabela: Stopnie niepełnosprawności |
Przykładowa zawartość żądania (JSON):
{
"OsobaWspolpracujaca": false,
"Email": "andrzej@krzywy.pl",
"Imie": "Andrzej",
"DrugieImie": "Maria",
"Nazwisko": "Krzywy",
"PESEL": "65063011212",
"DataUrodzenia": "30-06-1965",
"Plec": "M",
"RodzajDowoduTozsamosci": "DOWOD_OSOBISTY",
"SeriaNumerDowoduTozsamosci": "AIT123432",
"Obywatelstwo": "Polskie",
"MiejsceRezydencjiPolska": true,
"UrzadSkarbowyKod": "0202",
"KodNFZ": "15R",
"KontoBankowe": "26105014451000002276470461",
"NazwaBanku": "ING",
"TypUkonczonejSzkolyId": 1,
"StazPracy": 0,
"AdresZameldowania": {
"KodPocztowy": "51-314",
"Miejscowosc": "Wrocław",
"NumerDomu": "21",
"NumerLokalu": "21",
"Poczta": "Wrocław",
"Ulica": "Grabiszyńska",
"Kraj": "Polska",
"AdresZagraniczny": false,
"Gmina": "m. wrocław",
"Powiat": "Wrocław",
"Wojewodztwo": "Dolnośląskie"
},
"Oswiadczenia": {
"ZatrudnienieRodzimyZaklad": false,
"ZatrudnienieInnyZaklad": false,
"MinimalneWynagrodzenie": false,
"ZleceniobiorcaSpoleczneZdrowotne": false,
"ZleceniobiorcaTylkoZdrowotne": false,
"Rencista": false,
"Emeryt": false,
"Student": false,
"DzialalnoscGospodarcza": false,
"PodlegaKRUS": false,
"BrakTytuluUbezpieczenia": false,
"Bezrobotny": false,
"Niepelnosprawny": false,
"StopienNiepelnosprawnosciId": "0"
}
}
W odpowiedzi zwracany jest kod wiadomości mówiący o poprawności wykonania żądania oraz identyfikator kwestionariusza.
Program do faktur IFIRMA w prosty sposób zintegrujesz z Allegro i popularnymi platformami e‑commerce jak Shoper, WooCommerce czy PrestaShop.
ifirma.pl łączy się z urządzeniami fiskalnymi, pozwala na eksport przelewów do banku i zatwierdzanie ich jednym kodem, co znacznie usprawnia codzienną pracę i samodzielne księgowanie.
Dzięki integracji z bazą GUS ułatwiamy też wystawianie faktur – wystarczy, że wpiszesz NIP kontrahenta, a reszta danych uzupełni się automatycznie.