Трудоустройства

curl --location 'https://api.exode.biz/saas/v2/staff/employment/list?take=10&activeOnly=true' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

const listEmployments = async () => {
  const { data } = await axios.get('https://api.exode.biz/saas/v2/staff/employment/list', {
    params: { take: 10, activeOnly: true },
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload.items);
};

listEmployments();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 4,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 9,
        "createdAt": "2026-07-02T11:15:47.312Z",
        "updatedAt": "2026-07-02T11:15:47.312Z",
        "archivedAt": null,
        "schoolId": 198,
        "userId": 1683,
        "positionId": 4,
        "departmentId": 4,
        "extId": "emp-1683",
        "startAt": "2026-07-02T11:15:47.316Z",
        "finishAt": null,
        "status": "Active",
        "kind": "Main",
        "type": "FullTime",
        "rate": 1
      },
      {
        "id": 8,
        "createdAt": "2026-07-02T11:15:47.295Z",
        "updatedAt": "2026-07-02T11:15:47.312Z",
        "archivedAt": null,
        "schoolId": 198,
        "userId": 1683,
        "positionId": 3,
        "departmentId": 4,
        "extId": "emp-1683",
        "startAt": "2026-07-02T11:15:47.299Z",
        "finishAt": "2026-07-02T11:15:47.316Z",
        "status": "Terminated",
        "kind": "Main",
        "type": "FullTime",
        "rate": 1
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffView",
  "message": "Forbidden seller resource - permissions StaffView"
}

curl --location 'https://api.exode.biz/saas/v2/staff/employment/hire' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "userId": 1683,
    "extId": "emp-1683",
    "positionId": 3,
    "departmentId": 3,
    "startAt": "2026-07-02T00:00:00.000Z",
    "kind": "Main",
    "type": "PartTime",
    "rate": 0.5
  }'

const axios = require('axios');

const hireEmployment = async () => {
  const { data } = await axios.post('https://api.exode.biz/saas/v2/staff/employment/hire', {
    userId: 1683,
    extId: 'emp-1683',
    positionId: 3,
    departmentId: 3,
    startAt: '2026-07-02T00:00:00.000Z',
    kind: 'Main',
    type: 'PartTime',
    rate: 0.5,
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

hireEmployment();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 6,
    "createdAt": "2026-07-02T11:15:47.273Z",
    "updatedAt": "2026-07-02T11:15:47.273Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1683,
    "positionId": 3,
    "departmentId": 3,
    "extId": "emp-1683",
    "startAt": "2026-07-02T11:15:47.273Z",
    "finishAt": null,
    "status": "Active",
    "kind": "Main",
    "type": "PartTime",
    "rate": 0.5
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentAlreadyExists",
  "message": "Staff active employment already exists",
  "error": "Staff active employment already exists"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentExtIdIsNotUniq",
  "message": "Staff employment extId is not uniq",
  "error": "Staff employment extId is not uniq"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionNotFound",
  "message": "Staff position not found",
  "error": "Staff position not found"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffDepartmentNotFound",
  "message": "Staff department not found",
  "error": "Staff department not found"
}

{
  "code": 400,
  "success": false,
  "cause": "UserNotBelongsToSchool",
  "message": "User does not belong to the school",
  "error": "User does not belong to the school"
}

curl --location 'https://api.exode.biz/saas/v2/staff/employment/transfer' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "employmentId": 6,
    "toDepartmentId": 4,
    "startAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const transferEmployment = async () => {
  const { data } = await axios.post('https://api.exode.biz/saas/v2/staff/employment/transfer', {
    employmentId: 6,
    toDepartmentId: 4,
    startAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

transferEmployment();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 8,
    "createdAt": "2026-07-02T11:15:47.295Z",
    "updatedAt": "2026-07-02T11:15:47.295Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1683,
    "positionId": 3,
    "departmentId": 4,
    "extId": "emp-1683",
    "startAt": "2026-07-02T11:15:47.299Z",
    "finishAt": null,
    "status": "Active",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff active employment not found",
  "error": "Staff active employment not found"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentInvalidTransitionDate",
  "message": "Staff employment transition date is outside employment interval",
  "error": "Staff employment transition date is outside employment interval"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentAlreadyExists",
  "message": "Staff active employment already exists",
  "error": "Staff active employment already exists"
}

curl --location 'https://api.exode.biz/saas/v2/staff/employment/ext/emp-1683/transfer' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "toDepartmentExtId": "dep-sales",
    "startAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const transferEmploymentByExtId = async () => {
  const extId = encodeURIComponent('emp-1683');

  const { data } = await axios.post(`https://api.exode.biz/saas/v2/staff/employment/ext/${extId}/transfer`, {
    toDepartmentExtId: 'dep-sales',
    startAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

transferEmploymentByExtId();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 8,
    "createdAt": "2026-07-02T11:15:47.295Z",
    "updatedAt": "2026-07-02T11:15:47.295Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1683,
    "positionId": 3,
    "departmentId": 4,
    "extId": "emp-1683",
    "startAt": "2026-07-02T11:15:47.299Z",
    "finishAt": null,
    "status": "Active",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff active employment not found",
  "error": "Staff active employment not found"
}

curl --location 'https://api.exode.biz/saas/v2/staff/employment/promote' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "employmentId": 8,
    "toPositionId": 4,
    "startAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const promoteEmployment = async () => {
  const { data } = await axios.post('https://api.exode.biz/saas/v2/staff/employment/promote', {
    employmentId: 8,
    toPositionId: 4,
    startAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

promoteEmployment();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 9,
    "createdAt": "2026-07-02T11:15:47.312Z",
    "updatedAt": "2026-07-02T11:15:47.312Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1683,
    "positionId": 4,
    "departmentId": 4,
    "extId": "emp-1683",
    "startAt": "2026-07-02T11:15:47.316Z",
    "finishAt": null,
    "status": "Active",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff active employment not found",
  "error": "Staff active employment not found"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentInvalidTransitionDate",
  "message": "Staff employment transition date is outside employment interval",
  "error": "Staff employment transition date is outside employment interval"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentAlreadyExists",
  "message": "Staff active employment already exists",
  "error": "Staff active employment already exists"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentInputRequired",
  "message": "Staff employment promote target position is required",
  "error": "Staff employment promote target position is required"
}

curl --location 'https://api.exode.biz/saas/v2/staff/employment/ext/emp-1683/promote' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "toPositionExtId": "pos-lead",
    "startAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const promoteEmploymentByExtId = async () => {
  const extId = encodeURIComponent('emp-1683');

  const { data } = await axios.post(`https://api.exode.biz/saas/v2/staff/employment/ext/${extId}/promote`, {
    toPositionExtId: 'pos-lead',
    startAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

promoteEmploymentByExtId();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 9,
    "createdAt": "2026-07-02T11:15:47.312Z",
    "updatedAt": "2026-07-02T11:15:47.312Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1683,
    "positionId": 4,
    "departmentId": 4,
    "extId": "emp-1683",
    "startAt": "2026-07-02T11:15:47.316Z",
    "finishAt": null,
    "status": "Active",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff active employment not found",
  "error": "Staff active employment not found"
}

curl --location 'https://api.exode.biz/saas/v2/staff/employment/terminate' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "employmentId": 7,
    "finishAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const terminateEmployment = async () => {
  const { data } = await axios.post('https://api.exode.biz/saas/v2/staff/employment/terminate', {
    employmentId: 7,
    finishAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

terminateEmployment();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 7,
    "createdAt": "2026-07-02T11:15:47.284Z",
    "updatedAt": "2026-07-02T11:15:47.400Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1684,
    "positionId": 3,
    "departmentId": 4,
    "extId": "emp-1684",
    "startAt": "2026-07-02T11:15:47.285Z",
    "finishAt": "2026-07-02T11:15:47.401Z",
    "status": "Terminated",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentInvalidTransitionDate",
  "message": "Staff employment transition date is outside employment interval",
  "error": "Staff employment transition date is outside employment interval"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffCannotTerminateSelf",
  "message": "Staff cannot terminate himself",
  "error": "Staff cannot terminate himself"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffCannotTerminateSchoolOwner",
  "message": "Staff school owner cannot be terminated",
  "error": "Staff school owner cannot be terminated"
}

curl --location 'https://api.exode.biz/saas/v2/staff/employment/ext/emp-1684/terminate' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "finishAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const terminateEmploymentByExtId = async () => {
  const extId = encodeURIComponent('emp-1684');

  const { data } = await axios.post(`https://api.exode.biz/saas/v2/staff/employment/ext/${extId}/terminate`, {
    finishAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

terminateEmploymentByExtId();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 7,
    "createdAt": "2026-07-02T11:15:47.284Z",
    "updatedAt": "2026-07-02T11:15:47.400Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1684,
    "positionId": 3,
    "departmentId": 4,
    "extId": "emp-1684",
    "startAt": "2026-07-02T11:15:47.285Z",
    "finishAt": "2026-07-02T11:15:47.401Z",
    "status": "Terminated",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff active employment not found",
  "error": "Staff active employment not found"
}