REST API (ամպային տարբերակ) > Հաշվետվություններ > ՊՄՕ-ի և ստացված ծառայությունների մատյան

API-ի միջոցով հնարավոր է ստանալ (POST) ընտրման պայմաններին համապատասխանող ՊՄՕ-ի և ստացված ծառայությունների մատյան հաշվետվությունը:

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

URL Swagger

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

Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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	Ժամանակահատվածի վերջի ամսաթիվ: Կվերադարձվեն այն գործողությունները, որոնց ամսաթիվը ներառվում է նշված ժամանակահատվածում: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը:
documentType	Enum	*Required	Փաստաթղթի տեսակը: Դատարկ թողնելու դեպքում վերադարձնում է միայն ստացված ծառայությունների ցանկը։ Ընդունում է հետևյալ արժեքները․ 02 - Ստացված ծառայություններ 08 - Պահեստի մուտքի օրդեր
itemCode	String(20)	Optional Reference type	Նյութական արժեքի կամ ծառայության կոդը, որի համար ստեղծվում է հաշվետվությունը: Այս դաշտը դատարկ լինելու դեպքում հաշվետվությունը ստեղծվում է ըստ բոլոր նյութական արժեքների կամ ծառայությունների:
documentState	Enum	Optional	Փաստաթղթի վիճակը: Մատյանում կընդգրկվեն Սևագիր, Հեռացված կամ Գրանցված վիճակում գտնվող փաստաթղթերը: Դաշտը դատարկ լինելու դեպքում` կընդգրկվեն բոլոր փաստաթղթերը: Ընդունում է հետևյալ արժեքները․ 0 - Գրանցված կամ սևագիր, 1 - Սևագիր, 2 - Գրանցված, 99 - Հեռացված:

Վերադարձվող օբյեկտի ատրիբուտներ (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	Փաստաթղթի համարը:
itemCode	String	Նյութական արժեքի կամ ծառայության կոդ։
itemName	String	Նյութական արժեքի կամ ծառայության անվանում։
unitMeasure	String	Նյութական արժեքի կամ ծառայության չափման միավորի կոդ։
unitMeasureAbbreviation	String	Նյութական արժեքի կամ ծառայության չափման միավորի անվանում։
supplierCode	String	Մատակարարի կոդ։
supplierName	String	Մատակարարի անվանում։
supplierTaxCode	String	Մատակարարի ՀՎՀՀ։
quantity	Decimal	Նյութական արժեքի կամ ծառայության քանակ։
currency	String	Արժույթի կոդ։
price	Decimal	Նյութական արժեքի կամ ծառայության գին։
discountPercent	Decimal	Զեղչի տոկոս։
discountedPrice	Decimal	Նյութական արժեքի կամ ծառայության զեղչված գին։
amount	Decimal	Նյութական արժեքի կամ ծառայության գումար։
vat	Boolean	Նյութական արժեքի կամ ծառայության ԱԱՀ-ով հարկման հայտանիշ։
account	String	Նյութական արժեքի կամ ծառայության հաշվառման հաշիվ։
cpaClassifier	String	Նյութական արժեքի դասակարգման կոդ Արտաքին տնտեսական գործունեության ապրանքային Անվանացանկում (ԱՏԳ ԱԱ)։
comment	String	Փաստաթղթի մեկնաբանություն։
documentState	String	Փաստաթղթի կարգավիճակի կոդ։
documentStateName	String	Փաստաթղթի կարգավիճակի անվանում։

Օրինակ 1. 2026 թ.-ի ՊՄՕ-ների ցուցակի ստացում

POST

Request

curl -X 'POST' \

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

-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",

"documentType": "08"

Response body (201 Created)

{

"id": "005d88e7-1435-4ca6-99ec-3180cc39b3cc",

"hasMore": false,

"data": [

{

"isn": "07a51cbd-e00f-4b3c-8300-de95d8381d80",

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

"documentNumber": "ՊՄ017",

"itemCode": "10001",

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

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"supplierCode": "",

"supplierName": "",

"supplierTaxCode": "",

"quantity": 1000000.0000,

"currency": "AMD",

"price": 0.0000,

"discountPercent": 0.0000,

"discountedPrice": 1.0000,

"amount": 1000000.0000,

"vat": true,

"account": "2161",

"cpaClassifier": "",

"comment": "",

"documentState": 2,

"documentStateName": "Գրանցված"

{

"isn": "07a51cbd-e00f-4b3c-8300-de95d8381d80",

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

"documentNumber": "ՊՄ017",

"itemCode": "10002",

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

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"supplierCode": "",

"supplierName": "",

"supplierTaxCode": "",

"quantity": 1000000.0000,

"currency": "AMD",

"price": 0.0000,

"discountPercent": 0.0000,

"discountedPrice": 1.0000,

"amount": 1000000.0000,

"vat": true,

"account": "2161",

"cpaClassifier": "",

"comment": "",

"documentState": 2,

"documentStateName": "Գրանցված"

{

"isn": "07a51cbd-e00f-4b3c-8300-de95d8381d80",

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

"documentNumber": "ՊՄ017",

"itemCode": "20001",

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

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"supplierCode": "",

"supplierName": "",

"supplierTaxCode": "",

"quantity": 1000000.0000,

"currency": "AMD",

"price": 0.0000,

"discountPercent": 0.0000,

"discountedPrice": 1.0000,

"amount": 1000000.0000,

"vat": true,

"account": "2151",

"cpaClassifier": "",

"comment": "",

"documentState": 2,

"documentStateName": "Գրանցված"

}

]

}

Օրինակ 2. 2026թ․-ի Ստացված ծառայությունների ցուցակի ստացում

POST

Request

curl -X 'POST' \

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

-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-05-27",

"documentType": "02"

Response body (201 Created)

{

"id": "8a911895-eb8d-4365-aac7-7d3f59d2b3cb",

"hasMore": false,

"data": [

{

"isn": "7ad13cf5-11af-455b-b151-11407f20cd57",

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

"documentNumber": "ՍԾ001",

"itemCode": "203",

"itemName": "Ստացված ծառայություն",

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"supplierCode": "20006",

"supplierName": "Համակարգչային տեխնիկայի խանութ",

"supplierTaxCode": "01505169",

"quantity": 1.0000,

"currency": "AMD",

"price": 21000.0000,

"discountPercent": 0,

"discountedPrice": 0,

"amount": 21000.0000,

"vat": true,

"account": "7139",

"comment": "Համակարգչային ծրագրերի տեղադրում",

"documentState": 2,

"documentStateName": "Գրանցված"

{

"isn": "b4446e48-9a26-473e-9ed5-8defdd73cef8",

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

"documentNumber": "ՍԾ001",

"itemCode": "203",

"itemName": "Ստացված ծառայություն",

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"supplierCode": "20006",

"supplierName": "Համակարգչային տեխնիկայի խանութ",

"supplierTaxCode": "01505169",

"quantity": 1.0000,

"currency": "AMD",

"price": 21000.0000,

"discountPercent": 0,

"discountedPrice": 0,

"amount": 21000.0000,

"vat": true,

"account": "7139",

"comment": "Համակարգչային ծրագրերի տեղադրում",

"documentState": 2,

"documentStateName": "Գրանցված"

{

"isn": "f97a9819-3fcd-43b8-9a3e-365406beb4dd",

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

"documentNumber": "ՍԾ002",

"itemCode": "201",

"itemName": "Էլ.էներգիա",

"unitMeasure": "012",

"unitMeasureAbbreviation": "կվտ/ժ",

"supplierCode": "20004",

"supplierName": "Հայաստանի Էլեկտրական Ցանցեր ՓԲԸ",

"supplierTaxCode": "01520882",

"quantity": 1.0000,

"currency": "AMD",

"price": 47564.0000,

"discountPercent": 0,

"discountedPrice": 0,

"amount": 47564.0000,

"vat": true,

"account": "7135",

"comment": "Էլ.Էներգիայի վճար",

"documentState": 2,

"documentStateName": "Գրանցված"

{

"isn": "5152ad49-4490-47fa-8795-de584bcf0f0f",

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

"documentNumber": "ՍԾ002",

"itemCode": "201",

"itemName": "Էլ.էներգիա",

"unitMeasure": "012",

"unitMeasureAbbreviation": "կվտ/ժ",

"supplierCode": "20004",

"supplierName": "Հայաստանի Էլեկտրական Ցանցեր ՓԲԸ",

"supplierTaxCode": "01520882",

"quantity": 1.0000,

"currency": "AMD",

"price": 47564.0000,

"discountPercent": 0,

"discountedPrice": 0,

"amount": 47564.0000,

"vat": true,

"account": "7135",

"comment": "Էլ.Էներգիայի վճար",

"documentState": 2,

"documentStateName": "Գրանցված"

}

]

}