ՀԴՄ կտրոններ

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

ՀԴՄ կտրոններ

 Previous pageReturn to chapter overviewNext page

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

API-ի միջոցով հնարավոր է ստանալ (POST) Վաճառք (Կտրոն), Վերադարձ (կտրոն), Վերադարձ գնորդից, Մուտքի օրդեր և Ելքի օրդեր փաստաթղթերի ցանկը:

 

URI

https://api.armsoft.am/trade/v1/journals/ecrchecks

URL Swagger

https://api.armsoft.am/trade/swagger/index.html#/Journals/post_v1_journals_ecrchecks

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

-H 'apiKey: hJk:|^&99։՛(=0#biWc:'

 

Հարցման պարամետրեր (Request Body)

Մատյանի ձևավորման պարամետրերը (ցուցադրվող սյուներ, ֆիլտրացում, խմբավորում) փոխանցվում են հարցման մարմնում (Request Body)՝ JSON ձևաչափով։

Անվանում

Տեսակ

Կիրառումը

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

startDate

Date(YYYY-MM-DD)

api_required

Ժամանակահատվածի սկզբի ամսաթիվ: Կվերադարձվեն այն փաստաթղթերը, որոնց ամսաթիվը ներառվում է նշված    ժամանակահատվածում:

endDate

Date(YYYY-MM-DD)

api_required

Ժամանակահատվածի վերջի ամսաթիվ: Կվերադարձվեն այն փաստաթղթերը, որոնց ամսաթիվը ներառվում է նշվածժամանակահատվածում:

documentTypes [0..n]

Array

api_optional

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

18 - Վաճառք (Կտրոն),

15 - Վերադարձ գնորդից,

38 - Վերադարձ (Կտրոն),

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

03 - Դրամարկղի ելքի օրդեր:

partnerCode

String(20)

api_optional

Գործընկերոջ կոդ: Մատյանում կընդգրկվեն միայն նշված գործընկերոջ հետ կապված փաստաթղթերը:

itemCode

String(20)

api_optional

Ապրանքի (ծառայության) կոդ։ Մատյանում կընդգրկվեն միայն նշված ապրանքի հետ կապված փաստաթղթերը:

storageCode

String(5)

api_optional

Պահեստի կոդը։ Մատյանում կընդգրկվեն նշված պահեստի հետ կապված փաստաթղթերը:

cashDeskCode

String(8)

api_optional

Դրամարկղի կոդը։ Մատյանում կընդգրկվեն նշված դրամարկղի հետ կապված փաստաթղթերը:

employeeCode

String(12)

api_optional

Աշխատակցի կոդ։ Մատյանում կընդգրկվեն միայն նշված աշխատակցի հետ կապված փաստաթղթերը:

showPayments

Boolean

api_optional

Ցուցադրում է գումարի մարման ձևերի մասին տողեր։

showOutputAmountsAsNegatives

Boolean

api_optional

Վերադարձ գնորդից և Վերադարձ կտրոն փաստաթղթերի գումարները արտացոլվում են բացասական նշանով։

documentState

Enum

api_optional

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

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

1 - Սևագիր,

2 - Գրանցված,

3 - Հեռացված:

owner

String(50)

api_optional

Մատյանում կընդգրկվեն միայն նշված Հեղինակի փաստաթղթերը: Դաշտը դատարկ լինելու դեպքում կընդգրկվեն բոլոր հեղինակների փաստաթղթերը:

 

Վերադարձվող օբյեկտի ատրիբուտներ (Object Attributes)

Անվանում

Տեսակ

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

isn

UUID

Փաստաթղթի ներքին նույնացուցիչ։

date

Date(YYYY-MM-DD)

Փաստաթղթի ստեղծման ամսաթիվ:

dayOrderNumber

Integer

Փաստաթղթի օրվա հերթական համար։

documentNumber

String

Փաստաթղթի համար:

type

Enum

Փաստաթղթի տեսակի կոդ։ Աղյուսակում նշված են բոլոր տեսակի փաստաթղթերի կոդերը։

typeName

String

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

currency

String

Փաստաթղթի արժույթ։

amount

Decimal

Փաստաթղթի գումար:

state

Integer

Փաստաթղթի վիճակի կոդ:

stateName

String

Փաստաթղթի վիճակի անվանում։

storageCode

String

Պահեստի կոդ։

storageName

String

Պահեստի անվանում։

information

String

Այս դաշտում լրացվում է տվյալ փաստաթղթի հետ կապված առավել կարևոր տեղեկություն։ Աղյուսակում նշված է, թե յուրաքանչյուր փաստաթղթի համար ինչ տեղեկություն է լրացվում այս սյունում։

comment

String

Մեկնաբանություն փաստաթղթի վերաբերյալ:

partnerId

Integer

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

partnerCode

String

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

partnerName

String

Գործընկերոջ անվանում:

partnerTaxCode

String

Գործընկերոջ ՀՎՀՀ:

employeeCode

String

Աշխատակցի կոդ։

employeeName

String

Աշխատակցի անվանում։

userName

String

Օգտագործողի անունը: Նշվում է այն օգտագործողի անունը, ով վերջինն է աշխատել (գրանցել կամ խմբագրել) տվյալ փաստաթղթի հետ:

lastChange

Date(YYYY-MM-DDTHH:mm:ss)

Փաստաթղթի վերջին խմբագրման ամսաթիվը և ժամը:

owner

String

Փաստաթղթի հեղինակը։

information դաշտում վերադարձվող տեղեկության նկարագրությունը

Փաստաթուղթ

Տեղեկություն

Վաճառք (Կտրոն)

Դրամարկղի անվանումը:

Վերադարձ գնորդից

Գնորդի անվանումը:

Վերադարձ (Կտրոն)

Դրամարկղի անվանումը:

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

Վճարող դաշտում լրացված տեքստը:

Դրամարկղի ելքի օրդեր

Տրամադրել դաշտում լրացված տեքստը:

 

POST

Request

 

curl -X POST \

 "https://api.armsoft.am/trade/v1/journals/ecrchecks " \

 -H "accept: text/plain" \

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

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

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

 -d '

{

"startDate": "2026-01-01",

"endDate": "2026-01-31"

}'

 

Response body (200 OK)

 

{

   "data": [

       {

           "isn": "88b63443-2e8d-4f4c-b379-95c5b50e2eb9",

           "date": "2026-01-08",

           "documentNumber": "ԴՄ-001",

           "ecrCheckNumber": "",

           "type": 2,

           "typeName": "Մուտքի Օրդեր",

           "currency": "AMD",

           "amount": 59850.0000,

           "cashAmount": 0,

           "nonCashAmount": 0,

           "prepaymentAmount": 0,

           "bonusAmount": 0,

           "creditAmount": 0,

           "state": 2,

           "stateName": "Գրանցված",

           "storageCode": "",

           "storageName": "",

           "cashDeskCode": "01",

           "cashDeskName": "Դրամարկղ",

           "cashierShiftNumber": "",

           "paymentSystem": "",

           "paymentNumber": "",

           "paymentAccepted": false,

           "information": "Առևտրի սրահի օրվա հասույթի մուտք",

           "comment": "",

           "partnerId": -1,

           "partnerCode": "",

           "partnerName": "",

           "partnerTaxCode": "",

           "employeeCode": "",

           "employeeName": "",

           "lastUser": "testuser@testmail.am",

           "lastChange": "2026-02-12T15:03:41",

           "owner": "testuser@testmail.am"

       },

       {

           "isn": "534c75ce-264b-427e-8849-fe5cd0008941",

           "date": "2026-01-08",

           "documentNumber": "ՎԿՏ-001",

           "ecrCheckNumber": "",

           "type": 18,

           "typeName": "Վաճառք (Կտրոն)",

           "currency": "AMD",

           "amount": 59850.0000,

           "cashAmount": 0,

           "nonCashAmount": 0,

           "prepaymentAmount": 0,

           "bonusAmount": 0,

           "creditAmount": 0,

           "state": 2,

           "stateName": "Գրանցված",

           "storageCode": "01",

           "storageName": "Առևտրի սրահ",

           "cashDeskCode": "02",

           "cashDeskName": "Դրամարկղ(Առևտրի սրահում)",

           "cashierShiftNumber": "",

           "paymentSystem": "",

           "paymentNumber": "",

           "paymentAccepted": false,

           "information": "Դրամարկղ(Առևտրի սրահում)",

           "comment": "",

           "partnerId": -1,

           "partnerCode": "",

           "partnerName": "",

           "partnerTaxCode": "",

           "employeeCode": "001",

           "employeeName": "Կարինե Մուրադյան",

           "lastUser": "testuser@testmail.am",

           "lastChange": "2026-02-17T11:15:36",

           "owner": "testuser@testmail.am"

       }

    ]

}

 

 

POST

Request

 

curl -X POST \

 "https://api.armsoft.am/trade/v1/journals/ecrchecks " \

 -H "accept: text/plain" \

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

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

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

 -d '

{

"endDate": "2026-01-31",

 "startDate": "2026-01-01",

 "documentTypes": [

   "03",

   "18"

 ],

 "showPayments": true,

 "showOutputAmountsAsNegatives": true

}'

 

Response body (200 OK)

 

{

   "data": [

       {

           "isn": "ce008d24-fcdc-448b-a755-6e8e4c99780b",

           "date": "2026-01-14",

           "documentNumber": "ԴԵ-001",

           "ecrCheckNumber": "",

           "type": 3,

           "typeName": "Ելքի Օրդեր",

           "currency": "AMD",

           "amount": -6000.0000,

           "cashAmount": -6000.0000,

           "nonCashAmount": 0,

           "prepaymentAmount": 0,

           "bonusAmount": 0,

           "creditAmount": 0,

           "state": 2,

           "stateName": "Գրանցված",

           "storageCode": "",

           "storageName": "",

           "cashDeskCode": "01",

           "cashDeskName": "Դրամարկղ",

           "cashierShiftNumber": "",

           "paymentSystem": "",

           "paymentNumber": "",

           "paymentAccepted": false,

           "information": "ԳՐԱՍԵՆՅԱԿԱՅԻՆ ԵՎ ԿՈՄՈՒՆԱԼ ԾԱԽՍԵՐ",

           "comment": "Դեկտեմբեր ամսվա հեռախոսի վարձը",

           "partnerId": 100018,

           "partnerCode": "9003",

           "partnerName": "ԳՐԱՍԵՆՅԱԿԱՅԻՆ ԵՎ ԿՈՄՈՒՆԱԼ ԾԱԽՍԵՐ",

           "partnerTaxCode": "",

           "employeeCode": "",

           "employeeName": "",

           "lastUser": "testuser@testmail.am",

           "lastChange": "2026-02-12T15:03:43",

           "owner": "testuser@testmail.am"

       },

       {

           "isn": "373b1af0-8e2d-4f1c-b7a2-c8ea92eba119",

           "date": "2026-01-16",

           "documentNumber": "ԴԵ-002",

           "ecrCheckNumber": "",

           "type": 3,

           "typeName": "Ելքի Օրդեր",

           "currency": "AMD",

           "amount": -21000.0000,

           "cashAmount": -21000.0000,

           "nonCashAmount": 0,

           "prepaymentAmount": 0,

           "bonusAmount": 0,

           "creditAmount": 0,

           "state": 2,

           "stateName": "Գրանցված",

           "storageCode": "",

           "storageName": "",

           "cashDeskCode": "01",

           "cashDeskName": "Դրամարկղ",

           "cashierShiftNumber": "",

           "paymentSystem": "",

           "paymentNumber": "",

           "paymentAccepted": false,

           "information": "ԳՐԱՍԵՆՅԱԿԱՅԻՆ ԵՎ ԿՈՄՈՒՆԱԼ ԾԱԽՍԵՐ",

           "comment": "Դեկտեմբեր ամսվա էլ. էներգիայի վարձը",

           "partnerId": 100018,

           "partnerCode": "9003",

           "partnerName": "ԳՐԱՍԵՆՅԱԿԱՅԻՆ ԵՎ ԿՈՄՈՒՆԱԼ ԾԱԽՍԵՐ",

           "partnerTaxCode": "",

           "employeeCode": "",

           "employeeName": "",

           "lastUser": "testuser@testmail.am",

           "lastChange": "2026-02-12T15:03:47",

           "owner": "testuser@testmail.am"

       },

       {

           "isn": "4b713173-7a2e-4c1d-8996-ef30041e5f64",

           "date": "2026-01-31",

           "documentNumber": "ԴԵ-003",

           "ecrCheckNumber": "",

           "type": 3,

           "typeName": "Ելքի Օրդեր",

           "currency": "AMD",

           "amount": -350000.0000,

           "cashAmount": -350000.0000,

           "nonCashAmount": 0,

           "prepaymentAmount": 0,

           "bonusAmount": 0,

           "creditAmount": 0,

           "state": 2,

           "stateName": "Գրանցված",

           "storageCode": "",

           "storageName": "",

           "cashDeskCode": "01",

           "cashDeskName": "Դրամարկղ",

           "cashierShiftNumber": "",

           "paymentSystem": "",

           "paymentNumber": "",

           "paymentAccepted": false,

           "information": "ԱՇԽԱՏԱՆՔԻ ՎՃԱՐՄԱՆ ԾԱԽՍԵՐ",

           "comment": "Հունվար ամսվա 1-ին կեսի աշխատավարձի վճարում",

           "partnerId": 100016,

           "partnerCode": "9001",

           "partnerName": "ԱՇԽԱՏԱՆՔԻ ՎՃԱՐՄԱՆ ԾԱԽՍԵՐ",

           "partnerTaxCode": "",

           "employeeCode": "",

           "employeeName": "",

           "lastUser": "testuser@testmail.am",

           "lastChange": "2026-02-12T15:03:59",

           "owner": "testuser@testmail.am"

       }

   ]

}