Դրամարկղի մուտքի օրդեր

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

Դրամարկղի մուտքի օրդեր

 Previous pageReturn to chapter overviewNext page

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

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

 

URI

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

URL Swagger

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

GitHub

https://github.com/armsoft/accountant-public-api-docs/blob/main/docs/api/documents/cashinputorder.md

Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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 - Հեռացված:

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

cashDesk

String(12)

*Required

Reference type

Դրամարկղի կոդը, որտեղ մուտքագրվում են դրամական միջոցները:

currency

String(3)

Read only

Reference type

Գործառնության արժույթ։ Ավտոմատ լրացվում է դրամարկղի տեղեկատուի վրայից։

amount

Decimal

Optional

Գումար ԱԴՄ-ով: Գումար արժույթով դաշտում լրացված գումարի դրամային համարժեքը:

currencyAmount

Decimal

*Required

Գումար արժույթով: Դրամարկղ մուտքագրվող գումարը` լրացված դրամարկղի արժույթով:

ecrCheckNumber

String(12)

Optional

Կանխավճարի ՀԴՄ կտրոնի համարը:

correspondentAccount

String(12)

Optional

Reference type

Դրամարկղի հաշվի հետ թղթակցող հաշվային պլանի հաշիվը։

cashInFlowAccount

String(12)

Optional

Reference type

Գործառնության բնույթին համապատասխան Դրամական ներհոսքի հաշիվը։ Լրացվում է հանրային հատվածի կազմակերպությունների դեպքում։

analytic1

String(12)

Optional

Reference type

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

analytic2

String(12)

Optional

Reference type

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

partnerCode

String(20)

Optional

Reference type

Գործընկերոջ կոդը։

payerName

String(50)

*Required

Նշվում է, թե որտեղից է ստացվել գումարը: Եթե Գործընկեր դաշտի արժեքը լրացված է, համակարգն ավտոմատ լրացնում է այդ գործընկերոջ անվանումը:

base

String(255)

Optional

Վճարման նպատակը։

attached

String(50)

Optional

Դրամարկղի մուտքի օրդերին կից փաստաթղթերը։

 

GitHub

https://github.com/armsoft/accountant-public-api-docs/blob/main/examples/csharp/documents/create-cashinputorder.cs

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

POST

Request

 

curl -X POST \

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

 -H 'accept: text/plain' \

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

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

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

 -d '{

 "cashDesk": "001",

 "amount": 1500,

 "currencyAmount": 1500,

 "payerName": "Վճարողի անվանում"

}'

 

Response body (201 Created)

 

{

   "isn": "b18c55a2-b00a-4150-a059-ba2c09bf8e6f",

   "date": "2026-08-28",

   "documentNumber": "ԴՄ013",

   "state": 2,

   "cashDesk": "001",

   "currency": "AMD",

   "amount": 1500.0000,

   "currencyAmount": 1500.0000,

   "ecrCheckNumber": "",

   "correspondentAccount": "",

   "cashInFlowAccount": "",

   "analytic1": "",

   "analytic2": "",

   "partnerCode": "",

   "payerName": "Վճարողի անվանում",

   "base": "",

   "attached": ""

}

 

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

GET

Request

 

curl -X GET \

 'https://api.armsoft.am/accountant/v1/documents/cashinputorder/4b318b27-d3f0-4ef0-8913-d2df24c9187a \

 -H 'accept: */*' \

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

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

 

Response body  (200 OK)

 

{

   "isn": "4b318b27-d3f0-4ef0-8913-d2df24c9187a",

   "date": "2026-08-28",

   "documentNumber": "ԴՄ014",

   "state": 2,

   "cashDesk": "001",

   "currency": "AMD",

   "amount": 1500.0000,

   "currencyAmount": 1500.0000,

   "ecrCheckNumber": "",

   "correspondentAccount": "",

   "cashInFlowAccount": "",

   "analytic1": "",

   "analytic2": "",

   "partnerCode": "",

   "payerName": "Վճարողի անվանում",

   "base": "",

   "attached": ""

}

 

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

PUT

Request

 

curl -X PUT \

 'https://api.armsoft.am/accountant/v1/documents/cashinputorder/4b318b27-d3f0-4ef0-8913-d2df24c9187a' \

 -H 'accept: text/plain' \

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

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

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

 -d '{

   "isn": "4b318b27-d3f0-4ef0-8913-d2df24c9187a",

   "date": "2026-08-27",

   "documentNumber": "ԴՄ014",

   "state": 2,

   "cashDesk": "002",

   "currency": "USD",

   "currencyAmount": 1600,

   "ecrCheckNumber": "12345678",

   "partnerCode": "",

   "payerName": "Արտարժույթով մուտք",

   "base": "",

   "attached": ""

}'

 

Response body  (200 OK)

 

{

   "isn": "4b318b27-d3f0-4ef0-8913-d2df24c9187a",

   "date": "2026-08-27",

   "documentNumber": "ԴՄ014",

   "state": 2,

   "cashDesk": "002",

   "currency": "USD",

   "amount": 583152.0000,

   "currencyAmount": 1600.0000,

   "ecrCheckNumber": "12345678",

   "correspondentAccount": "",

   "cashInFlowAccount": "",

   "analytic1": "",

   "analytic2": "",

   "partnerCode": "",

   "payerName": "Արտարժույթով մուտք",

   "base": "",

   "attached": ""

}

 

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

DELETE

Request

 

curl -X DELETE \

 'https://api.armsoft.am/accountant/v1/documents/cashinputorder/4b318b27-d3f0-4ef0-8913-d2df24c9187a' \

 -H 'accept: */*' \

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

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

 

Response body  (200 OK)