Գործընկերներ

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

Գործընկերներ

 Previous pageReturn to chapter overviewNext page

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

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

URI

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

URL Swagger

https://api.armsoft.am/accountant/swagger/index.html#/Partners

Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ API բանալու օգտագործմամբ։ Այն անհրաժեշտ է տեղադրել հարցման գլխագրի apiKey դաշտում. API բանալին ստանալու համար անհրաժեշտ է կատարել API գաղտնի բանալու ստացում էջում նկարագրված քայլերը:

@SKq7*ERI]ZIgXvpkWhV

 

Գործընկերների օբյեկտի դաշտերը

Անվանում

Տեսակ

Կիրառումը

Նկարագրություն

id

Integer

System defined

Գործընկերոջ ներքին նույնացուցիչ։Դրամարկղի կոդ։

code

String(20)

*Required

Գործընկերոջ կոդը։Նոր ավելացվող գործընկերոջ համար, որպես հերթական կոդ, համակարգն ավտոմատ առաջարկում է հաջորդը, որը   հաշվարկվում է վերջին ավելացված գործընկերոջ կոդից։ Այս դաշտը խմբագրման ենթակա չէ։Պարտադիր լրացվող դաշտ է։

name

String(50)

*Required

Գործընկերոջ անվանումը։Պարտադիր լրացվող դաշտ է։  

fullName

String(255)

Optional

Գործընկերոջ լրիվ անվանումը։

taxCode

String(20)

*Required

Գործընկերոջ հարկ վճարողի հաշվառման համարը։

group

String(5)

*Required

Reference type

Գործընկերոջ խմբի անվանումը։

vatPayer

String(5)

Optional

Հանդիսանում է գործընկերը ԱԱՀ վճարող` 0 / False - ԱԱՀ վճարող չէ, 1 / True - ԱԱՀ վճարող է:

legalAddress

String(255)

Optional

Գործընկերոջ իրավաբանական հասցեն։

businessAddress

String(255)

Optional

Գործընկերոջ գործունեության իրականացման վայրի հասցեն։

managerName

String(50)

Optional

Գործընկերոջ ղեկավարի ազգանուն, անուն, հայրանունը։

managerPosition

String(50)

Optional

Գործընկերոջ ղեկավարի պաշտոնը։

accountantName

String(50)

Optional

Գործընկերոջ հաշվապահի ազգանուն, անուն, հայրանունը։

accountantPosition

String(50)

Optional

Գործընկերոջ հաշվապահի պաշտոնը։

stateRegisterNumber

String(50)

Optional

Եթե տվյալ գործընկերը անհատ ձեռնարկատեր է, ապա այստեղ լրացվում է նրա պետական գրանցման վկայականի համարը։

idDocumentType

Enum

Optional

Գործընկերոջ անձը հաստատող փաստաթղթի տեսակ:

passportNumber

String(32)

Optional

Գործընկերոջ անձնագևային համարը։

socialCardNumber

String

Optional

Հանրային ծառայությունների համարանիշ։

paymentMainAim

String(50)

Optional

Վճարման հիմնական նպատակ։

phoneNumber

String(50)

Optional

Գործընկերոջ հեռախոսը։

email

String(129)

Optional

Գործընկերոջ էլեկտրոնային փոստի հասցեն։

contract

String

Optional

Պայմանագրիր:

contractDate

DateTime(YYYY-MM-DDTHH:mm:ss.SSSZ)

Optional

Պայմանագրի ամսաթիվը:

salesDiscountPercent

String

Optional

Լրացվում է վաճառքի զեղչի տոկոսը:

status

String

Optional

Գործընկերոջ կարգավիճակ։

groupName

String(50)

Optional

Գործընկերոջ խմբի անվանումը։

settlementAccount

Array

Optional

Հաշվարկային հաշիվներ (մասսիվ):

userId

Integer

Optional

Օգտագործողի ներքին նույնացուցիչ:

userName

String(50)

Optional

Օգտագործողի անվանումը։

lastChange

DateTime(YYYY-MM-DDTHH:mm:ss.SSSZ)

Optional

Վերջին կատարված փոփոխություն։

 

Օրինակ 1. Գործընկերներ տեղեկատուում նոր գործընկերոջ ավելացում

POST

Request

 

curl -X 'POST' \

 'https://api.armsoft.am/accountant/v1/directories/partners' \

 -H 'accept: text/plain' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: N03S=AI8*vE]vkhplZYD' \

 -H 'Content-Type: application/json' \

 -d '{

 "id": 100000,

 "code": "10011",

 "name": "Գործընկեր",

 "fullName": "Գործընկեր",

 "taxCode": "00807555",

 "group": "01",

 "vatPayer": true,

 "legalAddress": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

 "businessAddress": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

 "managerName": "Մկրտչյան Ֆ",

 "managerPosition": "Տնօրեն",

 "accountantName": "Չիլինգարյան",

 "accountantPosition": "Գլխավոր հաշվապահ",

 "stateRegisterNumber": "",

 "idDocumentType": "",

 "passportNumber": "",

 "socialCardNumber": "",

 "paymentMainAim": "",

 "phoneNumber": "",

 "email": "",

 "contract": "",

 "contractDate": "2026-03-10",

 "salesDiscountPercent": 0,

 "status": "",

 "additionalData": "",

 "shippingMethod": "",

 "additionalFullName": "",

 "credentialNumber": "",

 "credentialDate": "2026-03-10",

 "settlementAccounts": [

   {

     "account": "77700008263903",

     "name": "Օրինակելի բանկ",

     "default": true

   }

 ],

 "additionalAddresses": [

   {

     "name": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

     "default": true

   }

 ]

}'

 

Response body (200 Created)

 

{

 "id": 100021,

 "code": "10011",

 "name": "Գործընկեր",

 "fullName": "Գործընկեր",

 "taxCode": "00807555",

 "group": "01",

 "vatPayer": true,

 "legalAddress": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

 "businessAddress": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

 "managerName": "Մկրտչյան Ֆ",

 "managerPosition": "Տնօրեն",

 "accountantName": "Չիլինգարյան",

 "accountantPosition": "Գլխավոր հաշվապահ",

 "stateRegisterNumber": "",

 "idDocumentType": " ",

 "passportNumber": "",

 "socialCardNumber": "",

 "paymentMainAim": "",

 "phoneNumber": "",

 "email": "",

 "contract": "",

 "contractDate": "2026-03-10",

 "salesDiscountPercent": 0,

 "status": "Գործող",

 "additionalData": "",

 "shippingMethod": "",

 "additionalFullName": "",

 "credentialNumber": "",

 "credentialDate": "2026-03-10",

 "settlementAccounts": [

   {

     "account": "77700008263903",

     "name": "Օրինակելի բանկ",

     "default": true

   }

 ],

 "additionalAddresses": [

   {

     "name": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

     "default": true

   }

 ]

}

 

Օրինակ 2. Նշված կոդով գործընկերոջ տեղեկատուի տվյալների ստացում

GET

Request

 

curl -X 'GET' \

 'https://api.armsoft.am/accountant/v1/directories/partners/10001' \

 -H 'accept: */*' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: N03S=AI8*vE]vkhplZYD'

 

Response body  (200 OK)

 

{

 "id": 100020,

 "code": "20009",

 "name": "Սերվիս Կենտրոն ՍՊԸ",

 "fullName": "Սերվիս Կենտրոն ՍՊԸ",

 "taxCode": "02514983",

 "group": "02",

 "vatPayer": true,

 "legalAddress": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

 "businessAddress": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

 "managerName": "Մկրտչյան Ֆ.",

 "managerPosition": "Տնօրեն",

 "accountantName": "Չիլինգարյան Վ.",

 "accountantPosition": "Գլխավոր հաշվապահ",

 "stateRegisterNumber": "",

 "idDocumentType": " ",

 "passportNumber": "",

 "socialCardNumber": "",

 "paymentMainAim": "",

 "phoneNumber": "",

 "email": "",

 "contract": "",

 "salesDiscountPercent": 0,

 "status": "Գործող",

 "additionalData": "",

 "shippingMethod": "",

 "additionalFullName": "",

 "credentialNumber": "",

 "settlementAccounts": [

   {

     "account": "77700008263903",

     "name": "Օրինակելի բանկ",

     "default": true

   }

 ],

 "additionalAddresses": [

   {

     "name": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

     "default": true

   }

 ]

}

 

Օրինակ 3. Նշված կոդով գործընկերոջ տեղեկատուի տվյալների խմբագրում

PUT

Request

 

curl -X 'PUT' \

 'https://api.armsoft.am/accountant/v1/directories/partners/10011' \

 -H 'accept: text/plain' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: N03S=AI8*vE]vkhplZYD' \

 -H 'Content-Type: application/json' \

 -d '{

 "id": 0,

 "code": "10011",

 "name": "Գործընկեր",

 "fullName": "Գործընկեր",

 "taxCode": "00807555",

 "group": "01",

 "vatPayer": true,

 "legalAddress": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

 "businessAddress": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

 "managerName": "",

 "managerPosition": "",

 "accountantName": "",

 "accountantPosition": "",

 "stateRegisterNumber": "",

 "idDocumentType": "",

 "passportNumber": "",

 "socialCardNumber": "",

 "paymentMainAim": "",

 "phoneNumber": "",

 "email": "string",

 "contract": "string",

 "contractDate": "2026-03-10",

 "salesDiscountPercent": 0,

 "status": "",

 "additionalData": "",

 "shippingMethod": "",

 "additionalFullName": "",

 "credentialNumber": "",

 "credentialDate": "2026-03-10",

 "settlementAccounts": [

   {

     "account": "77700008263903",

     "name": "Օրինակելի բանկ",

     "default": true

   }

 ],

 "additionalAddresses": [

   {

     "name": "ք․ Երևան, Չարենցի 1",

     "default": true

   }

 ]

}'

 

Response body  (200 OK)

 

{

 "id": 100021,

 "code": "10011",

 "name": "Գործընկեր",

 "fullName": "Գործընկեր",

 "taxCode": "00807555",

 "group": "01",

 "vatPayer": true,

 "legalAddress": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

 "businessAddress": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

 "managerName": "",

 "managerPosition": "",

 "accountantName": "",

 "accountantPosition": "",

 "stateRegisterNumber": "",

 "idDocumentType": " ",

 "passportNumber": "",

 "socialCardNumber": "",

 "paymentMainAim": "",

 "phoneNumber": "",

 "email": "string",

 "contract": "string",

 "contractDate": "2026-03-10",

 "salesDiscountPercent": 0,

 "status": "Գործող",

 "additionalData": "",

 "shippingMethod": "",

 "additionalFullName": "",

 "credentialNumber": "",

 "credentialDate": "2026-03-10",

 "settlementAccounts": [

   {

     "account": "77700008263903",

     "name": "Օրինակելի բանկ",

     "default": true

   }

 ],

 "additionalAddresses": [

   {

     "name": "ք. Երևան, Հանր. հրապ., Կառավարական 2շ.",

     "default": true

   }

 ]

}

 

Օրինակ 4. Նշված կոդով գործընկերոջ տեղեկատուի տվյալների հեռացում

DELETE

Request

 

curl -X 'DELETE' \

 'https://api.armsoft.am/accountant/v1/directories/partners/10011' \

 -H 'accept: */*' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: N03S=AI8*vE]vkhplZYD'

 

Response body  (200 OK)