Pracownicy

curl -H "Authorization: Bearer onb_..." \
  "https://www.onboardly.work/api/v1/employees?updatedSince=2026-07-01&pageSize=50"

{
  "data": [{
    "id": "uuid", "firstName": "Jan", "lastName": "Kowalski",
    "email": "jan@example.com", "phone": "+48…", "status": "podpisany",
    "contractType": "zlecenie", "isForeigner": false, "nationalityType": null,
    "position": "Kelner", "companyId": "uuid",
    "startDate": "2026-06-01", "endDate": null,
    "salaryNet": null, "salaryGross": 4806, "salaryKind": "brutto",
    "hourlyRate": null, "hourlyRateKind": null,
    "workTime": { "numerator": 1, "denominator": 2 },
    "employmentContractKind": "okreslony",
    "projects": [{ "id": "uuid", "name": "Bocca", "clientName": "OCTO", "dateFrom": "2026-06-01", "dateTo": null }],
    "projectName": "Bocca",
    "updatedAt": "2026-07-10T12:00:00.000Z"
  }],
  "page": 1, "pageSize": 50, "total": 130, "totalPages": 3
}

{
  "address": {
    "street": "Hetmańska", "houseNumber": "25", "apartmentNumber": null,
    "postalCode": "15-727", "city": "Białystok", "post": "Białystok",
    "gmina": "Białystok", "powiat": "Białystok", "voivodeship": "podlaskie",
    "country": "PL"
  },
  "registeredAddress": null, "correspondenceAddress": null,
  "taxAddressSource": "residence",
  "taxOffice": { "name": "Urząd Skarbowy w Białymstoku", "code": "2001" },
  "nip": null,
  "pit2": {
    "applied": true, "mode": "1/12", "declared": true, "source": "wizard",
    "declarations": {
      "reliefReturn": false, "reliefReturnFrom": null, "reliefReturnTo": null,
      "relief4plus": false, "reliefSenior": false,
      "jointSpouse": false, "jointIncomeVariant": null, "singleParent": false,
      "noAdvance": false, "noAdvanceYear": null,
      "resignYoungRelief": false, "resignKup": false, "resign50Kup": false,
      "withdrawReduction": false, "withdrawJoint": false, "withdrawElevatedKup": false,
      "withdrawExemptions": false, "withdrawYoungRelief": false, "withdrawKup": false,
      "withdraw50Kup": false, "withdrawNoAdvance": false,
      "art42eMode": null, "art42eWithdraw": null,
      "commuteKup": false
    }
  },
  "ppkResign": false,
  "ppk": { "resigned": false, "joinedAt": "2026-07-01", "resignedAt": null },
  "termination": {
    "type": "dyscyplinarne",
    "typeLabel": "Rozwiązanie umowy bez wypowiedzenia (art. 52 KP)",
    "date": "2026-09-30",
    "zusDeregistrationCode": "100",
    "optimaCode": "7"
  }
}

{
  "data": {
    "onboardingId": "uuid", "status": "podpisany",
    "firstName": "Jan", "lastName": "Kowalski", "email": "…", "phone": "…",
    "pesel": "86010112345", "birthDate": "1986-01-01", "placeOfBirth": "Warszawa",
    "nationality": "PL", "isForeigner": false,
    "residenceAddress": { "street": "…", "houseNumber": "…", "postalCode": "00-001", "city": "Warszawa", "gmina": "…", "powiat": "…", "voivodeship": "mazowieckie", "country": "PL" },
    "registeredAddress": null, "correspondenceAddress": null, "taxAddressSource": "residence",
    "contractType": "zlecenie", "position": "Kelner", "educationLevel": "srednie",
    "schoolType": "srednia_zawodowa", "schoolYearsForLeave": 5,
    "occupationCode": "941201", "startDate": "2026-06-01", "endDate": null,
    "workTime": null, "employmentContractKind": null, "probationEndDate": null,
    "hourlyRate": 30.0, "bankAccount": "PL…", "bankName": "mBank",
    "insurance": { "code": "041100", "confidence": "low", "requiresZusRegistration": true, "document": "ZUA" },
    "nfzCode": "07", "pit2": true, "pit2Mode": "1/12", "pit2Declared": true, "pit2Source": "wizard",
    "pit2Declarations": { "reliefReturn": false, "noAdvance": false, "…": false },
    "ppkResign": false, "ppkJoinedAt": "2026-07-01", "ppkResignedAt": null,
    "taxOfficeName": "…", "taxOfficeCode": "…",
    "terminationType": null, "terminationDate": null, "zusDeregistrationCode": null,
    "employer": { "name": "…", "nip": "…", "regon": "…", "address": "…" }
  }
}

{
  "yearMonth": "2026-09",
  "data": [{
    "id": "uuid", "onboardingId": "uuid", "worker": "Jan Kowalski",
    "companyId": "uuid", "contractType": "zlecenie", "yearMonth": "2026-09",
    "status": "approved",
    "totalHours": 168.5, "vacationDays": 2, "sickDays": 0,
    "netAmountOverride": null,
    "byProject": [
      { "projectId": "uuid", "projectName": "Sartoria — Centrum", "hours": 120 },
      { "projectId": "uuid", "projectName": "Hotel — Housekeeping", "hours": 48.5 }
    ],
    "submittedAt": "2026-10-02T09:12:00.000Z",
    "approvedAt": "2026-10-03T11:40:00.000Z", "approvedBy": "kadry@firma.pl"
  }],
  "count": 1
}

curl -H "Authorization: Bearer onb_..." \
  "https://www.onboardly.work/api/v1/employees/{id}/export?format=kedu" -o kedu.xml

curl -H "Authorization: Bearer onb_..." \
  "https://www.onboardly.work/api/v1/employees/{id}/ift?year=2026"

{
  "employeeId": "88ab2b33-6849-46ec-8d93-eca5e0446873",
  "status": "error",
  "message": "Niepoprawny numer PESEL, kartoteka nie została zapisana.",
  "system": "optima"
}

curl -X PATCH -H "Authorization: Bearer onb_..." -H "Content-Type: application/json" \
  -d '{"nfzCode":"07","bankName":"mBank","pit2":true}' \
  "https://www.onboardly.work/api/v1/employees/{id}"

{ "ok": true, "updated": ["nfzCode", "bankName", "pit2"] }

curl -X POST -H "Authorization: Bearer onb_..." -H "Content-Type: application/json" \
  -d '{"format":"kedu","content":"<KEDU>...</KEDU>"}' \
  "https://www.onboardly.work/api/v1/employees/import"

{
  "total": 12, "matched": 10, "new": 2,
  "rows": [{
    "name": "Jan Kowalski", "pesel": "860…",
    "matchedOnboardingId": "uuid", "match": "matched"
  }]
}

{
  "updated": 2, "skipped": 1,
  "updatedDetail": [{ "onboardingId": "uuid", "fields": ["personal.pesel", "nfzCode"] }],
  "skippedDetail": [{ "reason": "brak zmian", "pesel": "…" }]
}

curl -X POST -H "Authorization: Bearer onb_..." -H "Content-Type: application/json" \
  -d '{"endDate":"2026-07-31"}' \
  "https://www.onboardly.work/api/v1/employees/{id}/zus/deregister" -o zwua.xml