Աշխատակիցներ

Ուղղորդիչ:  REST API (ամպային տարբերակ) > Տեղեկատուներ >

Աշխատակիցներ

Previous pageReturn to chapter overviewNext page

Բացել/Փակել թաքցված տեքստը

API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) Աշխատակիցների տեղեկատուն։

URI

https://api.armsoft.am/accountant/v1/directories/employees

URL Swagger

https://api.armsoft.am/accountant/swagger/index.html#/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):

email

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. Աշխատակցի ավելացում (պարտադիր դաշտերով)

POST

 

Օրինակ 2. Աշխատակցի ավելացում

POST

 

Օրինակ 3. Նշված կոդով աշխատակցի տեղեկատուի տվյալների ստացում

GET

hmtoggle_arrow0 /v1/directories/employees/:code                                                                              

 

Օրինակ 4. Նշված կոդով աշխատակցի տեղեկատուի դաշտերի խմբագրում

PUT

 

Օրինակ 5. Նշված կոդով աշխատակցի տեղեկատուի հեռացում

DELETE

hmtoggle_arrow0 /v1/directories/employees/:code