Հիշարար օրդեր

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

Հիշարար օրդեր

 Previous pageReturn to chapter overviewNext page

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

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

 

URI

https://api.armsoft.am/accountant/v1/documents/memorialorder

URL Swagger

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

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

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

 

Հիշարար օրդեր օբյեկտի ատրիբուտներ (Object Attributes)

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

Անվանում

Տեսակ

Կիրառումը

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

isn

UUID

Optional

*Required for update

System defined

Փաստաթղթի նույնացուցիչ: Պարտադիր է GET, PUT, DELETE հարցումների դեպքում։

Եթե POST հարցման ժամանակ UUID-ը չի փոխանցվում, սերվերը այն ավտոմատ գեներացնում է և վերադարձնում պատասխանում։

date

Date(YYYY-MM-DD)

*Required

Փաստաթղթի ամսաթիվ: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը:

documentNumber

String(12)

*Required

Փաստաթղթի համար: Եթե համարը չի փոխանցվում, ապա գրանցվում է վերջին համարին ավելացնելով 1:

state

Enum

*Required

Փաստաթղթի վիճակ: Ընդունում է հետևյալ արժեքները.

0 - Գրանցված կամ սևագիր,

1 - Սևագիր,

2 - Գրանցված,

99 - Հեռացված:

Եթե վիճակը չի փոխանցվում, փաստաթուղթը ավտոմատ գրանցված վիճակում է ուղարկվում։

amount

Decimal

Optional

Փաստաթղթի գումար: Գումարն ավտոմատ է հաշվարկվում տրված գնի և քանակի հիման վրա։

currency

String(3)

Optional

Reference type

Գործառնության արժույթ։

exchangeRate

Decimal

*Conditional required

Արժույթի փոխարժեք:

exchangeBase

Integer

*Conditional required

Արժույթի փոխարժեքի պատիկություն:

previousDayExchangeRate

Boolean

Optional

True արժեքի դեպքում արժույթի դրամային համարժեքը կհաշվարկվի նախորդ օրվա փոխարժեքի հիման վրա։

analytic1

String(12)

Optional

Reference type

Անալիտիկ խումբ 1-ի կոդը։

analytic2

String(12)

Optional

Reference type

Անալիտիկ խումբ 2-ի կոդը։

comment

String(255)

Optional

Փաստաթղթի մեկնաբանություն։

transactionsList []

Array

*Required

Գործառնությունների ցուցակ (մասսիվ): Ցուցակը պետք է պարունակի գործառնության առնվազն մեկ տող։

 

Անվանացուցակի տողի դաշտերը (itemList)

Անվանում

Տեսակ

Կիրառումը

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

debitAccount

String(12)

*Required

Reference type

Դեբետագրվող հաշիվ։

debitPartner

String(20)

*Conditional required

Reference type

Դեբետ հաշվի գործընկերոջ կոդը։ Պարտադիր է լրացնել, եթե դեբետագրվող հաշիվը գործընկերային է։

debitAnalytic1

String(12)

*Conditional required

Reference type

Դեբետ հաշվի անալիտիկ խումբ 1-ի կոդ։ Պարտադիր է լրացնել, եթե դեբետագրվող հաշիվը հաշվառվում է անալիտիկ խմբերով։

debitAnalytic2

String(12)

*Conditional required

Reference type

Դեբետ հաշվի անալիտիկ խումբ 2-ի կոդ։ Պարտադիր է լրացնել, եթե դեբետագրվող հաշիվը հաշվառվում է անալիտիկ խմբերով։

debitCurrency

String(3)

*Required

Reference type

Դեբետ հաշվի արժույթի կոդ։

creditAccount

String(12)

*Required

Reference type

Կրեդիտագրվող հաշիվ։

creditPartner

String(20)

*Conditional required

Reference type

Կրեդիտ հաշվի գործընկերոջ կոդը։ Պարտադիր է լրացնել, եթե կրեդիտագրվող հաշիվը գործընկերային է։

creditAnalytic1

String(12)

*Conditional required

Reference type

Կրեդիտ հաշվի անալիտիկ խումբ 1-ի կոդ։ Պարտադիր է լրացնել, եթե կրեդիտագրվող հաշիվը հաշվառվում է անալիտիկ խմբերով։

creditAnalytic2

String(12)

*Conditional required

Reference type

Կրեդիտ հաշվի անալիտիկ խումբ 2-ի կոդ։ Պարտադիր է լրացնել, եթե կրեդիտագրվող հաշիվը հաշվառվում է անալիտիկ խմբերով։

creditCurrency

String(3)

*Required

Reference type

Կրեդիտ հաշվի արժույթի կոդ։

currencyAmount

Decimal

*Required

Կատարվող գործառնության գումարն արժույթով։

amount

Decimal

*Required

Գործառնության գումարի դրամային համարժեքը։

comment

String(255)

Optional

Գործառնության վերաբերյալ մեկնաբանություն։

 

Օրինակ 1. Հիշարար օրդեր փաստաթղթի ստեղծում

POST

Request

 

curl -X POST \

 'https://api.armsoft.am/accountant/v1/documents/memorialorder' \

 -H 'accept: text/plain' \

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

 -H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \

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

 -d '{

 "transactionsList": [

   {

     "debitAccount": "25212",

     "debitCurrency": "AMD",

     "creditAccount": "52111",

     "creditPartner": "20003",

     "creditCurrency": "AMD",

     "currencyAmount": 15000,

     "amount":15000

     }

 ]

}'

 

Response body (201 Created)

 

{

   "isn": "96dd855d-d75b-4564-b920-d5cac96dd7ac",

   "date": "2026-03-12",

   "documentNumber": "",

   "state": 2,

   "amount": 15000.0000,

   "currency": "AMD",

   "exchangeRate": 1.0000,

   "exchangeBase": 1.0000,

   "previousDayExchangeRate": false,

   "analytic1": "",

   "analytic2": "",

   "comment": "",

   "transactionsList": [

       {

           "debitAccount": "25212",

           "debitPartner": "",

           "debitAnalytic1": "",

           "debitAnalytic2": "",

           "debitCurrency": "AMD",

           "creditAccount": "52111",

           "creditPartner": "20003",

           "creditAnalytic1": "",

           "creditAnalytic2": "",

           "creditCurrency": "AMD",

           "currencyAmount": 15000.0000,

           "amount": 15000.0000,

           "comment": ""

       }

   ]

}

 

Օրինակ 2. Նշված isn-ով Հիշարար օրդեր փաստաթղթի ստացում

GET

Request

 

curl -X GET \

 'https://api.armsoft.am/accountant/v1/documents/memorialorder/46c05b8f-483b-4c69-a99f-0f713b193c31' \

 -H 'accept: */*' \

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

 -H 'apiKey: %}uPbv>T0xZ}3beLxR{1'

 

Response body  (200 OK)

 

{

   "isn": "46c05b8f-483b-4c69-a99f-0f713b193c31",

   "date": "2026-03-12",

   "documentNumber": "",

   "state": 2,

   "amount": 15000.0000,

   "currency": "AMD",

   "exchangeRate": 1.0000,

   "exchangeBase": 1.0000,

   "previousDayExchangeRate": false,

   "analytic1": "",

   "analytic2": "",

   "comment": "",

   "transactionsList": [

       {

           "debitAccount": "25212",

           "debitPartner": "",

           "debitAnalytic1": "",

           "debitAnalytic2": "",

           "debitCurrency": "AMD",

           "creditAccount": "52111",

           "creditPartner": "20003",

           "creditAnalytic1": "",

           "creditAnalytic2": "",

           "creditCurrency": "AMD",

           "currencyAmount": 15000.0000,

           "amount": 15000.0000,

           "comment": ""

       }

   ]

}

 

Օրինակ 3. Նշված isn-ով Հիշարար օրդեր փաստաթղթի դաշտերի խմբագրում

PUT

Request

 

curl -X PUT \

 'https://api.armsoft.am/accountant/v1/documents/memorialorder/46c05b8f-483b-4c69-a99f-0f713b193c31' \

 -H 'accept: text/plain' \

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

 -H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \

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

 -d '{

   "isn": "46c05b8f-483b-4c69-a99f-0f713b193c31",

   "date": "2026-03-12",

   "documentNumber": "",

   "state": 2,

   "amount": 30000,

   "currency": "AMD",

   "exchangeRate": 1.0000,

   "exchangeBase": 1.0000,

   "previousDayExchangeRate": false,

   "analytic1": "",

   "analytic2": "",

   "comment": "",

   "transactionsList": [

       {

           "debitAccount": "25212",

           "debitPartner": "",

           "debitAnalytic1": "",

           "debitAnalytic2": "",

           "debitCurrency": "AMD",

           "creditAccount": "52111",

           "creditPartner": "20004",

           "creditAnalytic1": "",

           "creditAnalytic2": "",

           "creditCurrency": "AMD",

           "currencyAmount": 30000,

           "amount": 30000,

           "comment": "թարմացված"

       }

   ]

}'

 

Response body  (200 OK)

 

{

   "isn": "46c05b8f-483b-4c69-a99f-0f713b193c31",

   "date": "2026-03-12",

   "documentNumber": "",

   "state": 2,

   "amount": 30000.0000,

   "currency": "AMD",

   "exchangeRate": 1.0000,

   "exchangeBase": 1.0000,

   "previousDayExchangeRate": false,

   "analytic1": "",

   "analytic2": "",

   "comment": "",

   "transactionsList": [

       {

           "debitAccount": "25212",

           "debitPartner": "",

           "debitAnalytic1": "",

           "debitAnalytic2": "",

           "debitCurrency": "AMD",

           "creditAccount": "52111",

           "creditPartner": "20004",

           "creditAnalytic1": "",

           "creditAnalytic2": "",

           "creditCurrency": "AMD",

           "currencyAmount": 30000.0000,

           "amount": 30000.0000,

           "comment": "թարմացված"

       }

   ]

}

 

Օրինակ 4. Նշված isn-ով Հիշարար օրդեր փաստաթղթի հեռացում

DELETE

Request

 

curl -X DELETE \

 'https://api.armsoft.am/accountant/v1/documents/memorialorder/46c05b8f-483b-4c69-a99f-0f713b193c31' \

 -H 'accept: */*' \

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

 -H 'apiKey: %}uPbv>T0xZ}3beLxR{1'

 

Response body  (200 OK)