REST API (ամպային տարբերակ) > Հաշվետվություններ > ՆԱ գործողությունների մատյան

API-ի միջոցով հնարավոր է ստանալ (POST) ընտրման պայմաններին համապատասխանող ՆԱ գործողությունների մատյան հաշվետվությունը:

URI	https://api.armsoft.am/accountant/v1/reports/materialsoperationsjournal

URL Swagger

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

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

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

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

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

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

Անվանում	Տեսակ	Կիրառումը	Նկարագրություն
pageSize	Integer	Optional	Սահմանում է մեկ հարցմամբ վերադարձվող գրառումների քանակը։ Նվազագույն վերադարձվող քանակը 5000 տող է․ եթե փոխանցված արժեքը փոքր է 5000-ից, համակարգը միևնույն է վերադարձնում է առնվազն 5000 գրառում։ Եթե pageSize = 0, վերադարձվում են բոլոր հասանելի տվյալները։ Առավելագույն սահմանաչափ ներկայումս սահմանված չէ։ Վերադարձվող օբյեկտում առկա է hasMore լոգիկական (boolean) դաշտ, որի true արժեքը ցույց է տալիս, որ կան դեռ չվերադարձված գրառումներ. այսինքն ՝ առկա են հաջորդ էջեր։
startDate	Date(YYYY-MM-DD)	*Required	Ժամանակահատվածի սկզբի ամսաթիվ: Կվերադարձվեն այն գործողությունները, որոնց ամսաթիվը ներառվում է նշված ժամանակահատվածում: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը:
endDate	Date(YYYY-MM-DD)	*Required	Ժամանակահատվածի վերջի ամսաթիվ: Կվերադարձվեն այն գործողությունները, որոնց ամսաթիվը ներառվում է նշված ժամանակահատվածում: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը:
storage	String(5)	Optional Reference type	Պահեստի կոդ։ Հաշվետվությունում կընդգրկվեն միայն այդ պահեստին վերաբերող գործողությունները։ Արժեք չուղարկելու դեպքում հաշվետվությունը կազմվում է ըստ բոլոր պահեստների։
materialGroup	String(5)	Optional Reference type	Նյութական արժեքի խմբի կոդը: Հաշվետվությունը կընդգրկի միայն այդ խմբում ներառվող նյութական արժեքների տվյալները, հակառակ դեպքում` բոլոր նյութական արժեքների տվյալները:
material	String(20)	Optional Reference type	Նյութական արժեքի կոդը: Հաշվետվությունը կընդգրկի միայն այդ նյութական արժեքի տվյալները, հակառակ դեպքում` բոլոր նյութական արժեքների տվյալները:
account	String(12)	Optional Reference type	Նյութական արժեքի հաշվառման հաշիվը: Հաշվետվությունում կընդգրկվեն միայն տվյալ հաշվով հաշվառվող նյութական արժեքների տվյալները: Դաշտն ակտիվ է, երբ նշված է Ըստ տարբեր հաշիվների հայտանիշը:
partner	String(20)	Optional Reference type	Գործընկերոջ կոդը: Հաշվետվությունում կընդգրկվեն միայն այն գործողությունները, որոնք կապված են նշված գործընկերոջ հետ:
operationTypes	Enum	Optional	Գործողության տեսակը: Կարելի է նշել մեկ կամ մի քանի գործողության տեսակներ: Հաշվետվությունում կընդգրկվեն նշված տեսակի գործողությունները, իսկ դաշտը դատարկ լինելու դեպքում` բոլոր տեսակի: Ընդունում է հետևյալ արժեքները․ A - Մնացորդների մուտք, B - Մաքսազերծում, D - ՆԱ ապակոմպլեկտավորում, E - Ելք, F - ԱԱՀ գումարների ճշգրտում, I - Մուտք, K - ՆԱ կոմպլեկտավորում, M - Տեղաշարժ, O - Հավելյալ ծախսեր, P - Վերագնահատում, Q - ԱԱ-ի շահագործման հանձնում, R - Իրացում, T - Իրացում (մանրածախ), V - Վերադարձ, W - Վերադարձ մատակարարին։
showParties	Boolean	Optional	True արժեքի դեպքում հաշվետվությունում նյութական արժեքները երևում են բացված ըստ խմբաքանակների:
currency	String(3)	Optional Reference type	Արժույթը, ըստ որի կառուցվում է հաշվետվությունը:
showCurrencies	Boolean	Optional	Ցույց տալ արտարժույթները: True արժեքի դեպքում հաշվետվությունում կերևան նաև գործողությունների արտարժույթները:
showSalePrice	Boolean	Optional	Ցույց տալ վաճառքի գինը: True արժեքի դեպքում հաշվետվությունում կերևան նաև վաճառքի գները։
showVATAmounts	Boolean	Optional	Ցույց տալ ԱԱՀ-ի գումարները։ True արժեքի դեպքում կցուցադրվի Ինքնարժեքի գումարի ԱԱՀ-ն:

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

Անվանում	Տեսակ	Նկարագրություն
id	Integer	Հարցման ունիկալ նույնացուցիչ, որը գեներացվում է համակարգի կողմից և օգտագործվում է էջավորման (pagination) համար։ Եթե պատասխանում hasMore = true, ապա id-ն պետք է փոխանցել հաջորդ հարցման մեջ մնացած տվյալները ստանալու համար։
hasMore	Boolean	Լոգիկական(boolean) դաշտ է, որի true արժեքը ցույց է տալիս, որ կան դեռ չվերադարձված գրառումներ. այսինքն ՝ առկա են հաջորդ էջեր։
data[]	Array	Տվյալների ցուցակ (մասսիվ), որտեղ յուրաքանչյուր օբյեկտ ներկայացնում է 1 գրառում (ապրանք)։

Տվյալների օբյեկտի ատրիբուտներ (Data Object Attributes)

Անվանում	Տեսակ	Նկարագրություն
isn	Integer	Փաստաթղթի ներքին նույնացուցիչ։
date	Date(YYYY-MM-DD)	Գործողության գրանցման ամսաթիվը:
documentNumber	String	Փաստաթղթի համարը:
documentType	String	Փաստաթղթի տեսակը:
operationType	String	Գործողության տեսակը:
operationName	String	Գործողության անվանում։
inputOutput	String	Ցույց է տալիս, թե գործողության արդյունքում նյութական արժեքը մուտք է եղել պահեստ, թե ելքագրվել է:
storage	String	Պահեստի կոդ։
materialId	Integer	Նյութական արժեքի ներքին նույնացուցիչ։
materialCode	String	Նյութական արժեքի կոդ։
materialName	String	Նյութական արժեքի անվանում։
unitMeasure	String	Նյութական արժեքի չափման միավորի կոդ։
unitMeasureAbbreviation	String	Նյութական արժեքի չափման միավորի հապավում։
account	String	Նյութական արժեքի հաշիվը։
correspondingObject	String	Թղթակցող գործընկերոջ կոդը,պահեստի կոդը կամ ծախսի հաշիվը:
correspondingObjectName	String	Թղթակցող գործընկերոջ, պահեստի կամ ծախսի հաշվի անվանումը:
analytic1	String	Անալիտիկ խումբ 1։
analytic2	String	Անալիտիկ խումբ 2։
cost	Decimal	Նյութական արժեքի գին։
quantity	Decimal	Նյութական արժեքի քանակ։
costAmount	Decimal	Նյութական արժեքի ինքնարժեքի գումար։
costVATAmount	Decimal	Նյութական արժեքի ինքնարժեքի գումարի ԱԱՀ: Երևում է, երբ նշված է Ցույց տալ ԱԱՀ-ի գումարները հայտանիշը:
unitVAT	Decimal	Նյութական արժեքի միավորի ինքնարժեքի ԱԱՀ: Երևում է, երբ նշված է Ցույց տալ ԱԱՀ-ի գումարները հայտանիշը:
currency	String	Գործողության արժույթը: Երևում է, երբ նշված է Ցույց տալ արտարժույթները հայտանիշը:
currencyCost	Decimal	Նյութական արժեքի գինն արտարժույթով, միայն արտարժութային մուտքի գործողություններում: Երևում է, երբ նշված է Ցույց տալ արտարժույթները հայտանիշը:
salePrice	Decimal	Նյութական արժեքի վաճառքի գինը դրամով: Երևում է, երբ նշված է Ցույց տալ վաճառքի գինը հայտանիշը:
saleAmount	Decimal	Նյութական արժեքի վաճառքի գումարը դրամով: Երևում է, երբ նշված է Ցույց տալ վաճառքի գինը հայտանիշը:
saleVATPrice	Decimal	Նյութական արժեքի վաճառքի գնի ԱԱՀ։ Երևում է, երբ նշված է Ցույց տալ ԱԱՀ-ի գումարները հայտանիշը:
saleVATAmount	Decimal	Նյութական արժեքի վաճառքի գումարի ԱԱՀ։ Երևում է, երբ նշված է Ցույց տալ ԱԱՀ-ի գումարները հայտանիշը:
salePriceCurrency	Decimal	Նյութական արժեքի վաճառքի գինն արժույթով: Երևում է, երբ նշված է Ցույց տալ վաճառքի գինը հայտանիշը:
saleAmountCurrency	Decimal	Նյութական արժեքի վաճառքի գումարն արժույթով: Երևում է, երբ նշված է Ցույց տալ վաճառքի գինը հայտանիշը:
comment	String	Գործողության մեկնաբանությունը:
group	String	Նյութական արժեքի խումբը:
specification	String	Նյութական արժեքի բնութագիրը:
vat	Boolean	Նյութական արժեքի ԱԱՀ-ով հարկման հայտանիշը։
incomeDate	Date(YYYY-MM-DD)	Նյութական արժեքի մուտքի ամսաթիվը: Երևում է, երբ նշված է Ցույց տալ Ըստ տարբեր խմբաքանակների հայտանիշը:
partySupplierId	Integer	Նյութական արժեքի մատակարարի ներքին նույնացուցիչ: Երևում է, երբ նշված է Ցույց տալ Ըստ տարբեր խմբաքանակների հայտանիշը:
partySupplierCode	String	Նյութական արժեքի մատակարարի կոդ: Երևում է, երբ նշված է Ցույց տալ Ըստ տարբեր խմբաքանակների հայտանիշը:
partySupplierName	String	Նյութական արժեքի մատակարարի անվանում: Երևում է, երբ նշված է Ցույց տալ Ըստ տարբեր խմբաքանակների հայտանիշը:
partyDocumentNumber	String	Նյութական արժեքի մուտքի փաստաթղթի համարը: Երևում է, երբ նշված է Ցույց տալ Ըստ տարբեր խմբաքանակների հայտանիշը:
partyDocumentType	Enum	Նյութական արժեքի մուտքի փաստաթղթի տեսակի կոդը: Երևում է, երբ նշված է Ցույց տալ Ըստ տարբեր խմբաքանակների հայտանիշը:
partyDocumentTypeName	String	Նյութական արժեքի մուտքի փաստաթղթի տեսակի անվանումը: Երևում է, երբ նշված է Ցույց տալ Ըստ տարբեր խմբաքանակների հայտանիշը:
partyPurchasingPrice	Decimal	Նյութական արժեքի ձեռքբերման գինը։ Երևում է, երբ նշված է Ցույց տալ Ըստ տարբեր խմբաքանակների հայտանիշը:
partyPurchasingPriceWithoutVAT	Decimal	Նյութական արժեքի ձեռքբերման գինը առանց ԱԱՀ։ Երևում է, երբ նշված է Ցույց տալ Ըստ տարբեր խմբաքանակների հայտանիշը:

Օրինակ 1. 2026 թ.-ի նյութական արժեքների գործողությունների ստացում

POST

Request

curl -X 'POST' \

'https://api.armsoft.am/accountant/v1/reports/materialsoperationsjournal' \

-H 'accept: text/plain' \

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

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

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

-d '{

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

"endDate": "2026-12-31",

"showParties": true,

"showCurrencies": true,

"showSalePrice": true,

"showVATAmounts": true

Response body (201 Created)

{

"id": "6ba71371-1502-43c3-8021-90a114ae6b97",

"hasMore": false,

"data": [

{

"isn": "e10c89fb-cede-4631-a545-96744aea71ff",

"date": "2025-12-31",

"documentNumber": "ՄՆ01",

"documentType": 8,

"operationType": "I",

"operationName": "Մուտք",

"inputOutput": "Մուտք",

"storage": "01 - Հիմնական պահեստ",

"materialId": 100000,

"materialCode": "10001",

"materialName": "Իտալական մանկական կոշիկ",

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"account": "2161",

"correspondingObject": "",

"correspondingObjectName": "",

"analytic1": "",

"analytic2": "",

"cost": 19500,

"quantity": 10.0000,

"costAmount": 195000.0000,

"costVATAmount": 0.0000,

"unitVAT": 0,

"currency": "AMD",

"currencyCost": 0,

"salePrice": 0,

"saleAmount": 0,

"saleVATPrice": 0,

"saleVATAmount": 0,

"salePriceCurrency": 0,

"saleAmountCurrency": 0,

"comment": "Մնացորդի մուտք",

"group": "10 - Ապրանք",

"specification": "Մանկական կոշիկ տղա երեխայի",

"vat": false,

"incomeDate": "2025-12-31",

"partySupplierId": -1,

"partySupplierCode": "",

"partySupplierName": "",

"partyDocumentNumber": "ՄՆ01",

"partyDocumentType": 8,

"partyDocumentTypeName": "Պահեստի մուտք",

"partyPurchasingPrice": 19500.0000,

"partyPurchasingPriceWithoutVAT": 19500.0000

{

"isn": "b68690a5-632e-4d1b-a7ac-9fcd7e89cfab",

"date": "2026-02-08",

"documentNumber": "ԱՇ001",

"documentType": 17,

"operationType": "Q",

"operationName": "ԱԱ-ի շահագործման հանձնում",

"inputOutput": "Ելք",

"storage": "01 - Հիմնական պահեստ",

"materialId": 100008,

"materialCode": "40002",

"materialName": "Գրիչ",

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"account": "2131",

"correspondingObject": "001",

"correspondingObjectName": "Վարչակազմ",

"analytic1": "",

"analytic2": "",

"cost": 150,

"quantity": 3.0000,

"costAmount": 450.0000,

"costVATAmount": 0.0000,

"unitVAT": 0,

"currency": "AMD",

"currencyCost": 0,

"salePrice": 0,

"saleAmount": 0,

"saleVATPrice": 0,

"saleVATAmount": 0,

"salePriceCurrency": 0,

"saleAmountCurrency": 0,

"comment": "",

"group": "40 - Արագամաշ առարկաներ",

"specification": "",

"vat": false,

"incomeDate": "2026-02-04",

"partySupplierId": 100015,

"partySupplierCode": "40001",

"partySupplierName": "Սահակյան Մարինե",

"partyDocumentNumber": "ՊՄ006",

"partyDocumentType": 8,

"partyDocumentTypeName": "Պահեստի մուտք",

"partyPurchasingPrice": 150.0000,

"partyPurchasingPriceWithoutVAT": 150.0000

{

"isn": "e10c89fb-cede-4631-a545-96744aea71ff",

"date": "2025-12-31",

"documentNumber": "ՄՆ01",

"documentType": 8,

"operationType": "I",

"operationName": "Մուտք",

"inputOutput": "Մուտք",

"storage": "01 - Հիմնական պահեստ",

"materialId": 100002,

"materialCode": "20001",

"materialName": "Տղամարդու կոշիկ",

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"account": "2151",

"correspondingObject": "",

"correspondingObjectName": "",

"analytic1": "",

"analytic2": "",

"cost": 26400,

"quantity": 15.0000,

"costAmount": 396000.0000,

"costVATAmount": 0.0000,

"unitVAT": 0,

"currency": "AMD",

"currencyCost": 0,

"salePrice": 0,

"saleAmount": 0,

"saleVATPrice": 0,

"saleVATAmount": 0,

"salePriceCurrency": 0,

"saleAmountCurrency": 0,

"comment": "Մնացորդի մուտք",

"group": "20 - Արտադրանք",

"specification": "Հայկական կար",

"vat": false,

"incomeDate": "2025-12-31",

"partySupplierId": -1,

"partySupplierCode": "",

"partySupplierName": "",

"partyDocumentNumber": "ՄՆ01",

"partyDocumentType": 8,

"partyDocumentTypeName": "Պահեստի մուտք",

"partyPurchasingPrice": 26400.0000,

"partyPurchasingPriceWithoutVAT": 26400.0000

{

"isn": "cf361d35-1e9b-4057-825f-a5efcc1b0d19",

"date": "2026-01-29",

"documentNumber": "ՆԱՏ003",

"documentType": 11,

"operationType": "M",

"operationName": "Տեղաշարժ",

"inputOutput": "Մուտք",

"storage": "03 - Խանութ",

"materialId": 100001,

"materialCode": "10002",

"materialName": "Կանացի կոշիկ",

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"account": "2162",

"correspondingObject": "01",

"correspondingObjectName": "Հիմնական պահեստ",

"analytic1": "",

"analytic2": "",

"cost": 31000,

"quantity": 3.0000,

"costAmount": 93000.0000,

"costVATAmount": 18600.0000,

"unitVAT": 6200,

"currency": "AMD",

"currencyCost": 0,

"salePrice": 0,

"saleAmount": 0,

"saleVATPrice": 0,

"saleVATAmount": 0,

"salePriceCurrency": 0,

"saleAmountCurrency": 0,

"comment": "Ապրանքների տեղաշարժ խանութ",

"group": "10 - Ապրանք",

"specification": "",

"vat": false,

"incomeDate": "2026-01-21",

"partySupplierId": 100007,

"partySupplierCode": "20002",

"partySupplierName": "Արարատ կարի-կոշիկի գործարան",

"partyDocumentNumber": "ՊՄ003",

"partyDocumentType": 8,

"partyDocumentTypeName": "Պահեստի մուտք",

"partyPurchasingPrice": 31000.0000,

"partyPurchasingPriceWithoutVAT": 31000.0000

{

"isn": "eddf80cb-dff0-4c6d-b214-dec758dde519",

"date": "2026-02-04",

"documentNumber": "ՀԾԲ003",

"documentType": 9,

"operationType": "O",

"operationName": "Հավելյալ ծախսեր",

"inputOutput": "Մուտք",

"storage": "01 - Հիմնական պահեստ",

"materialId": 100000,

"materialCode": "10001",

"materialName": "Իտալական մանկական կոշիկ",

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"account": "2161",

"correspondingObject": "",

"correspondingObjectName": "",

"analytic1": "",

"analytic2": "",

"cost": 0,

"quantity": 0.0000,

"costAmount": 3780.0000,

"costVATAmount": 0.0000,

"unitVAT": 0,

"currency": "AMD",

"currencyCost": 0,

"salePrice": 0,

"saleAmount": 0,

"saleVATPrice": 0,

"saleVATAmount": 0,

"salePriceCurrency": 0,

"saleAmountCurrency": 0,

"comment": "Մաքսավճար",

"group": "10 - Ապրանք",

"specification": "Մանկական կոշիկ տղա երեխայի",

"vat": false,

"incomeDate": "2026-02-04",

"partySupplierId": 100006,

"partySupplierCode": "20001",

"partySupplierName": "Իտալիան լես ՓԲԸ",

"partyDocumentNumber": "ՊՄ004",

"partyDocumentType": 8,

"partyDocumentTypeName": "Պահեստի մուտք",

"partyPurchasingPrice": 8642.5200,

"partyPurchasingPriceWithoutVAT": 8642.5200

}

]

}