API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) Աշխատակիցների տեղեկատուն։
URI |
https://api.armsoft.am/accountant/v1/directories/employees |
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ API բանալու օգտագործմամբ։ Այն անհրաժեշտ է տեղադրել հարցման գլխագրի apiKey դաշտում. API բանալին ստանալու համար անհրաժեշտ է կատարել API գաղտնի բանալու ստացում էջում նկարագրված քայլերը:
-H 'apiKey: @SKq7*ERI]ZIgXvpkWhV' |
Այս հարցման դեպքում գործում է էջավորման մեխանիզմը:
Աշխատակիցների օբյեկտի դաշտերը
Ստորև ներկայացված է օբյեկտի դաշտերի նկարագրությունը.
Անվանում |
Տեսակ |
Կիրառումը |
Նկարագրություն |
id |
Integer |
System defined |
Աշխատակցի ներքին նույնացուցիչ։ |
code |
String(12) |
*Required |
Աշխատակցի տաբելային համար։ Արժեք չտալու դեպքում ընդունում է ծրագրից գեներացված հերթական համարը։ |
fullName |
String(50) |
*Required |
Աշխատակցի ազգանուն, անուն, հայրանունը: |
departmentCode |
String(3) |
*Required Reference type |
Աշխատակցի ստորաբաժանման կոդը։ |
positionCode |
String(3) |
Optional Reference type |
Աշխատակցի պաշտոնի կոդը: |
positionStartDate |
Date(YYYY-MM-DD) |
Optional |
Աշխատակցի պաշտոնի նշանակման ամսաթիվը: |
professionCode |
String(4) |
Optional Reference type |
Աշխատակցի մասնագիտության կոդը: |
genderCode |
Enum |
Optional |
Աշխատակցի սեռը։ Ընդունում է հետևյալ արժեքները․ 1 - Արական, 2 - Իգական։ |
birthDate |
Date(YYYY-MM-DD) |
Optional |
Աշխատակցի ծննդյան ամսաթիվը: |
contractTypeCode |
Enum |
*Required |
Աշխատակցի հետ կնքված պայմանագրի տեսակը։ Ընդունում է հետևյալ արժքեները․ 1 - Աշխատանքային, 2 - Քաղաքացիաիրավական: Եթե արժեք չի փոխանցվում, ապա համակարգի կողմից տրվում է 1 - Աշխատանքային արժեքը: |
defaultAccrual |
String(3) |
Read only Reference type |
Աշխատակցի հիմնական հավելման կոդը։ |
defaultTimeSheet |
String(2) |
Optional Reference type |
Աշխատակցի հիմնական աշխատանքի գրաֆիկի կոդը։ |
employmentStartDate |
Date(YYYY-MM-DD) |
Optional |
Աշխատակցի աշխատանքի ընդունման ամսաթիվը: |
emlpoymentOrderNumber |
String(16) |
Optional |
Աշխատակցի աշխատանքի ընդունման հրամանի համարը: |
dateOfDismissal |
Date(YYYY-MM-DD) |
Optional |
Աշխատակցի աշխատանքից ազատման ամսաթիվը: |
dismissalOrderNumber |
String(16) |
*Required |
Աշխատակցի աշխատանքից ազատման հրամանի համարը: |
raCitizen |
Boolean |
Optional |
Աշխատակցի ՀՀ ռեզիդենտ լինելու հայտանիշ։ |
calculateIncomeTax |
Boolean |
Optional |
Աշխատակցից եկամային հարկը պահելու հայտանիշ։ |
reducePensionFromIncomeTax |
Boolean |
Optional |
Աշխատակցի կուտակայինի գումարը եկամտային հարկի գումարից նվազեցնելու հայտանիշ։ Սա նախատեսված է 1996թ.-ից հետո ծնված աշխատակիցների համար: |
salaryAccount |
String(12) |
Optional Reference type |
Աշխատավարձի հաշվառման սինթետիկ հաշիվը։ |
partnerCode |
String(20) |
*Conditional required Reference type |
Աշխատակցին կցված գործընկերոջ կոդը: Այս պարամետրը պարտադիր է ուղարկել, եթե աշխատավարձի հաշվառման սինթետիկ հաշիվը գործընկերով հաշվառվող հաշիվ է։ |
tradeUnionDuesPercent |
Decimal |
Optional |
Աշխատակցի արհմիութենական անդամավճարի տոկոսի չափը: |
participationStatus |
Enum |
*Required |
Կուտակային կենսաթոշակային համակարգին մասնակցության կարգավիճակը։ Ընդունում է հետևյալ արժեքները․ 0 - Կուտակային կենսաթոշակային համակարգի մասնակից չէ, 1 - Պարտադիր կուտակային կենսաթոշակային համակարգի պարտադիր մասնակից, 2 - Պարտադիր կուտակային կենսաթոշակային համակարգի կամավոր մասնակից, 3 - Կամավոր կուտակային կենսաթոշակային համակարգի մասնակից է, 4 - Միաժամանակ պարտադիր կուտակային կենսաթոշակային համակարգի պարտադիր մասնակից է և կամավոր կուտակային կենսաթոշակային համակարգի մասնակից է (1+3), 5 - Միաժամանակ պարտադիր կուտակային կենսաթոշակային համակարգի կամավոր մասնակից է և կամավոր կուտակային կենսաթոշակային համակարգի մասնակից է(2+3) Եթե արժեք չի փոխանցվում, ապա համակարգի կողմից տրվում է 0 - Կուտակային կենսաթոշակային համակարգի մասնակից չէ արժեքը: |
employerPercent |
Decimal |
Optional |
Կամավոր կուտակային կենսաթոշակային համակարգին աշխատակցի համար գործատուի կողմից վճարվող տոկոսը։ Կիրառվում է, եթե Մասնակցության կարգավիճակը ուղարկել ենք 3, 4 կամ 5 արժեքներից որևէ մեկը։ |
employerAmount |
Decimal |
Optional |
Կամավոր կուտակային կենսաթոշակային համակարգին աշխատակցի համար գործատուի կողմից վճարվող գումարը։ Կիրառվում է, եթե Մասնակցության կարգավիճակը ուղարկել ենք 3, 4 կամ 5 արժեքներից որևէ մեկը։ |
stampFeeType |
Enum |
*Required |
Դրոշմանիշային վճար վճարողի կարգավիճակը։ Ընդունում է հետևյալ արժեքները․ 0 - Չի վճարում, 1 - Վճարում է, 2 - Գործատուն է վճարում, 3 - Նվազագույն աշխատավարձի ստուգմամբ: Եթե արժեք չի փոխանցվում, ապա համակարգի կողմից տրվում է 1 արժեքը: |
insuranceFeeType |
Enum |
*Required |
Ապահովագրավճար վճարողի կարգավիճակը: Ընդունում է հետևյալ արժեքները․ 0 - Չի վճարում, 1 - Վճարում է, 2 - Գործատուն է վճարում: |
insuranceFeeDate |
Date(YYYY-MM-DD) |
*Required |
Ամսաթիվը, որից սկսած գործում է ապահովագրավճար վճարողի կարգավիճակը։ |
registrationPlaceRA |
Boolean |
Optional |
Աշխատակցի հաշվառման վայրը Հայաստանի Հանրապետությունը հանդիսանալու հայտանիշ: |
registrationRegion |
Enum |
Optional Reference type |
Աշխատակցի հաշվառման մարզի կոդը: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի հաշվառման վայրը ՀՀ-ն է: |
registrationCommunity |
Enum |
Optional Reference type |
Աշխատակցի հաշվառման համայնքի կոդը: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի հաշվառման վայրը ՀՀ-ն է: |
registrationCity |
String(50) |
Optional |
Աշխատակցի հաշվառման քաղաքը, ավանը կամ գյուղը: Լրացվում է միայն այն դեպքում, երբ աշխատակցի հաշվառման վայրը ՀՀ-ն է: |
registrationStreet |
String(50) |
Optional |
Աշխատակցի հաշվառման փողոցի անվանում: Լրացվում է այն դեպքում, երբ աշխատակցի հաշվառման վայրը ՀՀ-ն է: |
registrationHouse |
String(6) |
Optional |
Աշխատակցի հաշվառման տան/շենքի համար: Լրացվում է այն դեպքում, երբ աշխատակցի հաշվառման վայրը ՀՀ-ն է: |
registrationApartment |
String(3) |
Optional |
Աշխատակցի հաշվառման բնակարանի համար: Լրացվում է այն դեպքում, երբ աշխատակցի հաշվառման վայրը ՀՀ-ն է: |
registrationSameAsResidence |
Boolean |
Optional |
Աշխատակցի հաշվառման վայրը բնակության վայրի հետ համընկնելու հայտանիշ։ |
placeResidenceRA |
Boolean |
Optional |
Աշխատակցի բնակության վայրը ՀՀ հանդիսանալու հայտանիշ։ |
residenceRegion |
Enum |
Optional Reference type |
Աշխատակցի բնակության մարզի կոդը: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն է: |
residenceCommunity |
Enum |
Optional Reference type |
Աշխատակցի բնակության համայնքի կոդը: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն է: |
residenceLocation |
Enum |
Optional Reference type |
Աշխատակցի բնակավայրի կոդն ըստ ՀՀ վարչատարածքային բաժանման միավորների դասակարգչի: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն է: |
residenceCity |
String(50) |
Optional |
Աշխատակցի բնակության քաղաքի անվանումը: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն է: |
residenceStreet |
String(50) |
Optional |
Աշխատակցի բնակության ավանի անվանումը: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն է: |
residenceHouse |
String(6) |
Optional |
Աշխատակցի բնակության գյուղի անվանումը: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն է: |
residenceApartment |
String(3) |
Optional |
Աշխատակցի բնակության հասցեն: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն է: |
residenceCountry |
Enum |
Optional Reference type |
Աշխատակցի բնակության վայր հանդիսացող պետության կոդն ըստ ISO-3166-1 երկրների դասակարգչի: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն չէ: |
addressLine1 |
String(50) |
Optional |
Աշխատակցի արտերկրի բնակության հասցեները: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն չէ: |
addressLine2 |
String(50) |
Optional |
Աշխատակցի արտերկրի բնակության հասցեները: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն չէ: |
addressLine3 |
String(50) |
Optional |
Աշխատակցի արտերկրի բնակության հասցեները: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն չէ: |
postalCode |
String(15) |
Optional |
Աշխատակցի արտերկրի բնակության փոստի համարը: Այս դաշտը լրացվում է այն դեպքում, երբ աշխատակցի բնակության վայրը ՀՀ-ն չէ: |
bankAccount |
String(22) |
Optional |
Աշխատակցի հաշվի համարը բանկում: |
socialCardNumber |
String(11) |
Optional |
Աշխատակցի սոցիալական քարտի համարը: |
identificationDocumentType |
Enum |
Optional |
Անձը հաստատող փաստաթղթի տեսակ։ Ընդունում է հետևյալ արժեքները․ 1 - ՀՀ անձնագիր, 2 - Ծննդյան վկայական, 3 - Կացության քարտ, 4 - Կոնվենցիոն ճանապարհորդական փաստաթուղթ, 5 - Նույնականացման քարտ, 6 - Կենսաչափական անձնագիր, 7 - Օտարերկրյա անձնագիր՝ ՀՀ-ում աշխատանքի իրավունքով, 8 - Օտարերկրյա անձնագիր։ |
passport |
String(25) |
Optional |
Աշխատակցի անձնագրի համարը: |
passportIssueDate |
Date(YYYY-MM-DD) |
Optional |
Աշխատակցի անձը հաստատող փաստաթղթի տրման ամսաթիվը: |
passportIssuedBy |
String(3) |
Optional |
Լրացվում է, թե ում կողմից է տրվել աշխատակցի անձնագիրը: |
nationality |
String(50) |
Optional |
Աշխատակցի ազգությունը։ |
otherDocumentNumber |
String(25) |
Optional |
Լրացվում է անձը հաստատող փաստաթղթի համարը: |
phone |
String(50) |
Optional |
Աշխատակցի հեռախոսի համարը: |
mobilePhone |
String(50) |
Optional |
Աշխատակցի բջջային հեռախոսի համարը (օրինակ` +(374)77574734): |
String(129) |
Optional |
Աշխատակցի Էլեկտրոնային փոստի հասցեն: |
|
languages |
String(200) |
Optional |
Նշվում է, թե աշխատակիցը ինչ օտար լեզուների է տիրապետում։ |
maritalStatus |
String(200) |
Optional |
Նշվում է աշխատակցի ընտանեկան դրությունը։ |
education |
String(200) |
Optional |
Աշխատակցի կրթության վերաբերյալ տեղեկատվություն։ |
institute |
String(200) |
Optional |
Ուսումնական հաստատություն։ |
educationStartDate |
Date(YYYY-MM-DD) |
Optional |
Ընդունվելու ամսաթիվը։ |
educationEndDate |
Date(YYYY-MM-DD) |
Optional |
Ավարտելու կամ հեռանալու ամսաթիվը։ |
educationCertificateNumber |
String(200) |
Optional |
Դիպլոմի կամ վկայականի համարը։ |
militaryServiceDescription |
String(200) |
Optional |
Աշխատակցի զին. ծառայության վերաբերյալ տեղեկատվություն։ |
militaryServiceStartDate |
Date(YYYY-MM-DD) |
Optional |
Զին․ ծառայության սկզբի ամսաթիվ։ |
militaryServiceEndDate |
Date(YYYY-MM-DD) |
Optional |
Զին․ ծառայության վերջի ամսաթիվ։ |
familyMember1Type |
Enum |
Optional |
Ընտանիքի անդամի կարգավիճակ։ Ընդունում է հետևյալ արժեքները․ 1 - Ամուսին, 2 - Կին, 3 - Հայր, 4 - Մայր, 5 - Որդի, 6 - Դուստր, 7 - Քույր, 8 - Եղբայր, 9 - Այլ։ |
familyMember1FullName |
String(50) |
Optional |
Ընտանիքի անդամի ազգանուն, անուն, հայրանուն։ |
familyMember2Type |
Enum |
Optional |
Ընտանիքի անդամի կարգավիճակ։ Ընդունում է հետևյալ արժեքները․ 1 - Ամուսին, 2 - Կին, 3 - Հայր, 4 - Մայր, 5 - Որդի, 6 - Դուստր, 7 - Քույր, 8 - Եղբայր, 9 - Այլ։ |
familyMember2FullName |
String(50) |
Optional |
Ընտանիքի անդամի ազգանուն, անուն, հայրանուն։ |
familyMember3Type |
Enum |
Optional |
Ընտանիքի անդամի կարգավիճակ։ Ընդունում է հետևյալ արժեքները․ 1 - Ամուսին, 2 - Կին, 3 - Հայր, 4 - Մայր, 5 - Որդի, 6 - Դուստր, 7 - Քույր, 8 - Եղբայր, 9 - Այլ։ |
familyMember3FullName |
String(50) |
Optional |
Ընտանիքի անդամի ազգանուն, անուն, հայրանուն։ |
familyMember4Type |
Enum |
Optional |
Ընտանիքի անդամի կարգավիճակ։ Ընդունում է հետևյալ արժեքները․ 1 - Ամուսին, 2 - Կին, 3 - Հայր, 4 - Մայր, 5 - Որդի, 6 - Դուստր, 7 - Քույր, 8 - Եղբայր, 9 - Այլ։ |
familyMember4FullName |
String(50) |
Optional |
Ընտանիքի անդամի ազգանուն, անուն, հայրանուն։ |
accrualsDeductions[] |
Array |
Optional |
Հավելում/պահումներ (մասսիվ)։ |
Հավելում/պահումների տողերի դաշտերը
Անվանում |
Տեսակ |
Կիրառումը |
Նկարագրություն |
date |
Date(YYYY-MM-DD) |
Optional |
Հավելման կամ պահման նշանակման ամսաթիվը։ |
code |
String(3) |
Optional |
Հավելման կամ պահման կոդը: |
name |
String(50) |
Optional |
Հավելման կամ պահման անվանումը։ |
amount |
Decimal |
*Required |
Հավելման կամ պահման գումարը։ |
default |
Boolean |
Optional |
Հիմնական հանդիսանալու հայտանիշ։ |
Օրինակ 1. Աշխատակցի ավելացում (պարտադիր դաշտերով)
|
Օրինակ 2. Աշխատակցի ավելացում
POST |
|
Օրինակ 3. Նշված կոդով աշխատակցի տեղեկատուի տվյալների ստացում
|
Օրինակ 4. Նշված կոդով աշխատակցի տեղեկատուի դաշտերի խմբագրում
|
Օրինակ 5. Նշված կոդով աշխատակցի տեղեկատուի հեռացում
|