Ծառայություններ

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

Ծառայություններ

 Previous pageReturn to chapter overviewNext page

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

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

URI

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

URL Swagger

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

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

-H 'apiKey: @SKq7*ERI]ZIgXvpkWhV'

Այս հարցման դեպքում գործում է էջավորման մեխանիզմը:

 

Ծառայությունների օբյեկտի դաշտերը

Ստորև ներկայացված է օբյեկտի դաշտերի նկարագրությունը.

Անվանում

Տեսակ

Կիրառումը

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

id

Integer

System defined

Ծառայության ներքին նույնացուցիչ։

code

String(20)

*Required

Ծառայության կոդ։ Արժեք չտալու դեպքում ընդունում է ծրագրից գեներացված հերթական համարը։

name

String(200)

*Required

Ծառայության անվանում։

fullName

String(255)

Optional

Ծառայության լրիվ անվանում։

unitMeasure

String(3)

*Required

Reference type

Ծառայության չափման միավորի կոդ։

unitMeasureName

String(50)

Read only

Ծառայության չափման միավորի անվանում:

unitMeasureAbbreviation

String(6)

Read only

Ծառայության չափման միավորի հապավում:

cpaClassifier

String(12)

Optional

Reference type

Ծառայության ԱՏԳԱԱ դասակարգիչ։

account

String(12)

Optional

Reference type

Ծառայության հաշվառման հաշիվ։

revenueAccount

String(12)

Optional

Reference type

Ծառայության վաճառքից հասույթի հաշիվ։

retailRevenueAccount

String(12)

Optional

Reference type

Ծառայության մանրածախ վաճառքից հասույթի հաշիվ։

revenueAdjustmentAccount

String(12)

Optional

Reference type

Ծառայության վաճառքից հետ վերադարձի հասույթի ճշգրտման հաշիվ։

wholePrice

Decimal

Optional

Ծառայության մեծածախ գին դրամով։

retailPrice

Decimal

Optional

Ծառայության մանրածախ գին դրամով։

currency

String(3)

Optional

Reference type

Արտարժույթի կոդ։

currencyPrice

Decimal

*Required

Ծառայության մեծածախ վաճառքի գին արտարժույթով։

barcode

String(20)

Optional

Ծառայության գծիկավոր կոդ։

vat

Boolean

Optional

Ծառայության ԱԱՀ-ով հարկման հայտանիշ։

 

Օրինակ 1. Ծառայության ավելացում (պարտադիր դաշտերով)

POST

Request

 

curl -X POST \

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

 -H 'accept: text/plain' \

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

 -H 'apiKey: @SKq7*ERI]ZIgXvpkWhV' \

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

 -d '

{

 "name": "Կապի ծառայություն",

 "unitMeasure": "401"

}'

 

Response body (201 Created)

 

{

   "id": 100005,

   "code": "204",

   "name": "Կապի ծառայություն",

   "fullName": "",

   "unitMeasure": "401",

   "unitMeasureName": "Ամիս",

   "unitMeasureAbbreviation": "ամիս",

   "cpaClassifier": "",

   "account": "",

   "revenueAccount": "",

   "retailRevenueAccount": "",

   "revenueAdjustmentAccount": "",

   "wholePrice": 0,

   "retailPrice": 0,

   "currency": "",

   "currencyPrice": 0,

   "barcode": "",

   "vat": true

}

 

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

GET

hmtoggle_arrow0 /v1/directories/services/:{code}                                                                              

Request

 

curl -X GET \

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

 -H 'accept: */*' \

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

 -H 'apiKey: @SKq7*ERI]ZIgXvpkWhV'

 

Response body  (200 OK)

 

{

   "id": 100005,

   "code": "204",

   "name": "Կապի ծառայություն",

   "fullName": "",

   "unitMeasure": "401",

   "unitMeasureName": "Ամիս",

   "unitMeasureAbbreviation": "ամիս",

   "cpaClassifier": "",

   "account": "",

   "revenueAccount": "",

   "retailRevenueAccount": "",

   "revenueAdjustmentAccount": "",

   "wholePrice": 0,

   "retailPrice": 0,

   "currency": "",

   "currencyPrice": 0,

   "barcode": "",

   "vat": true

}

 

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

PUT

Request

 

curl -X PUT \

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

 -H 'accept: text/plain' \

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

 -H 'apiKey: @SKq7*ERI]ZIgXvpkWhV' \

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

 -d {

   "id": 100005,

   "code": "204",

   "name": "Կապի ծառայություն",

   "fullName": "",

   "unitMeasure": "401",

   "unitMeasureName": "Ամիս",

   "unitMeasureAbbreviation": "ամիս",

   "cpaClassifier": "",

   "account": "61141",

   "revenueAccount": "61141",

   "retailRevenueAccount": "61141",

   "revenueAdjustmentAccount": "",

   "wholePrice": 16000,

   "retailPrice": 14000,

   "currency": "",

   "currencyPrice": 0,

   "barcode": "",

   "vat": true

}'

 

Response body  (200 OK)

 

{

   "id": 100005,

   "code": "204",

   "name": "Կապի ծառայություն",

   "fullName": "",

   "unitMeasure": "401",

   "unitMeasureName": "Ամիս",

   "unitMeasureAbbreviation": "ամիս",

   "cpaClassifier": "",

   "account": "61141",

   "revenueAccount": "61141",

   "retailRevenueAccount": "61141",

   "revenueAdjustmentAccount": "",

   "wholePrice": 16000.0000,

   "retailPrice": 14000.0000,

   "currency": "",

   "barcode": "",

   "vat": true

}

 

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

DELETE

hmtoggle_arrow0 /v1/directories/services/:{code}                                                                                

Request

 

curl -X DELETE \

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

 -H 'accept: */*' \

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

 -H 'apiKey: @SKq7*ERI]ZIgXvpkWhV'

 

Response body  (200 OK)