REST API (ամպային տարբերակ) > Հաշվետվություններ > Ապրանքների մնացորդներ (Ընդլայնված)

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

URI	https://api.armsoft.am/trade/v1/reports/productsbalances

URL Swagger

https://api.armsoft.am/trade/swagger/index.html#/Reports/post_v1_reports_productsbalances

GitHub

https://github.com/armsoft/trade-public-api-docs/blob/main/docs/api/reports/productsbalances.md

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

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

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

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

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

Անվանում	Տեսակ	Կիրառումը	Նկարագրություն
pageSize	Integer	Optional	Սահմանում է մեկ հարցմամբ վերադարձվող գրառումների քանակը։ Նվազագույն վերադարձվող քանակը 5000 տող է․ եթե փոխանցված արժեքը փոքր է 5000-ից, համակարգը միևնույն է վերադարձնում է առնվազն 5000 գրառում։ Եթե pageSize = 0, վեչադարձվում են բոլոր հասանելի տվյալները։ Առավելագույն սահմանաչափ ներկայումս սահմանված չէ։ Վերադարձվող օբյեկտում առկա է hasMore լոգիկական (boolean) դաշտ, որի true արժեքը ցույց է տալիս, որ կան դեռ չվերադարձված գրառումներ. այսինքն ՝ առկա են հաջորդ էջեր։
date	Date(YYYY-MM-DD)	*Required	Մնացորդների ձևավորման ամսաթիվ: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը:
storages [0..n]	Array	Optional Reference type	Պահեստի կոդ: Դատարկ թողնելու դեպքում կընդգրկվեն բոլոր պահեստների մնացորդները։
group	String(5)	Optional Reference type	Ապրանքի խմբի կոդը: Դատարկ լինելու դեպքում հաշվետվության մեջ կընդգրկվեն բոլոր խմբերի ապրանքները։
codes [0..n]	Array	Optional Reference type	Ապրանքի կոդը:
showQuantitiesWithAdditionalUnits	Boolean	Optional	True արժեքի դեպքում քանակները ցուցադրվում են լրացուցիչ չափման միավորով:
showSumsWithoutVAT	Boolean	Optional	True արժեքի դեպքում հաշվետվությունում երևում են ապրանքների մեկ միավորի միջինացված ինքնարժեքները և ընդհանուր գումարները` ներկայացված դրամով և առանց ԱԱՀ-ի։
showSumsWithVAT	Boolean	Optional	True արժեքի դեպքում հաշվետվությունում երևում են ապրանքների մեկ միավորի միջինացված ինքնարժեքները և ընդհանուր գումարները` ներկայացված դրամով և ներառյալ ԱԱՀ-ն։
showCurrencySums	Boolean	Optional	True արժեքի դեպքում հաշվետվությունում երևում են ապրանքների ինքնարժեքները` ներկայացված USD-ով և ներառյալ ԱԱՀ-ն։
showByDifferentParties	Boolean	Optional	True արժեքի դեպքում հաշվետվությունում երևում են ապրանքների խմբաքանակները բնորոշող սյուներ (մուտքի ամսաթիվ, մատակարար, օգտագործման ժամկետ, երկիր, արտադրող և այլն)։
openedByStorages	Boolean	Optional	True արժեքի դեպքում հաշվետվությունում տարբեր պահեստներում գտնվող միևնույն ապրանքը երևում է առանձին տողերով։
minimumQuantities	Enum	Optional	Ընդունում է հետևյալ արժեքները․ 1 - Ցույց տալ նվազագույնից փոքր քանակները, 2 - Ցույց տալ բոլորը: Ցույց տալ նվազագույնից փոքր քանակները ընտրելու դեպքում հաշվետվությունում երևում են այն ապրանքները, որոնց համար լրացված է Նվազագույն քանակ դաշտը և տվյալ պահին այդ ապրանքի առկայությունը նշված նվազագույն քանակից քիչ է։ Ցույց տալ բոլորը ընտրելու դեպքում հաշվետվությունում ընդգրկվում են բոլոր ապրանքները։
subtotalType	Enum	Optional	Նշված լինելու դեպքում հաշվետվությունը խմբավորվում է ըստ ենթագումարների: Կարող է ընդունել հետևյալ արժեքները. 1 - Պահեստ, 2 - Խումբ, 3 - Ապրանք:
priceListTypes [0..n]	Array	Optional Reference type	Կարելի է լրացնել կազմակերպությունում գործող որևէ գնի տեսակ, և եթե տվյալ ապրանքն ունի սահմանված այդ տեսակի գին, ապա այն կերևա հաշվետվության մեջ։

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

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

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

Անվանում	Տեսակ	Նկարագրություն
storage	String	Պահեստի կոդ:
storageName	String	Պահեստի անվանում:
group	String	Ապրանքի խմբի կոդ:
groupName	String	Ապրանքի խմբի անվանում:
costPriceWithoutVAT	Decimal	Ինքնարժեք (առանց ԱԱՀ):
costPriceWithVAT	Decimal	Ինքնարժեք (ներառյալ ԱԱՀ):
costPriceCurrency	Decimal	Ինքնարժեք արտարժույթով:
minimumQuantity	Decimal	Նվազագույն քանակ։
variance	Decimal	Շեղում(%)։
maximumQuantity	Decimal	Առավելագույն քանակ։
orderQuantity	Decimal	Պատվերի քանակ։
orderComment	Decimal	Պատվերի մեկնաբանություն։
incomeDate	Date(YYYY-MM-DD)	Ապրանքի խմբաքանակ. մուտքագրման ամսաթիվ:
partySupplierId	Integer	Ապրանքի խմբաքանակի մատակարարի ներքին նույնացուցիչ։
partySupplierName	String	Ապրանքի խմբաքանակի մատակարարի անվանում։
partySupplierTaxCode	String	Ապրանքի խմբաքանակի մատակարարի ՀՎՀՀ։
partyContractCode	String	Ապրանքի խմբաքանակի պայմանագրի կոդ։
partyContractName	String	Ապրանքի խմբաքանակի պայմանագրի անվանում։
partyDocumentNumber	String	Ապրանքի խմբաքանակի փաստաթղթի համար։
partyDocumentType	String	Ապրանքի խմբաքանակի փաստաթղթի տեսակ։
partyCountryCode	String	Ապրանքի խմբաքանակի երկրի կոդ։
partyCountryName	String	Ապրանքի խմբաքանակի երկրի անվանում։
partyProducerCode	String	Ապրանքի խմբաքանակի արտադրողի կոդ։
partyProducerName	String	Ապրանքի խմբաքանակի արտադրողի անվանում։
partyPropertyType1Code	String	Ապրանքի խմբաքանակի ապրանքի հատկության տեսակ 1-ի կոդ:
partyPropertyType1Name	String	Ապրանքի խմբաքանակի ապրանքի հատկության տեսակ 1-ի անվանում:
partyPropertyValue1Code	String	Ապրանքի խմբաքանակի ապրանքի հատկության արժեք 1-ի կոդ:
partyPropertyValue1Name	String	Ապրանքի խմբաքանակի ապրանքի հատկության արժեք 1-ի անվանում:
partyPropertyType2Code	String	Ապրանքի խմբաքանակի ապրանքի հատկության տեսակ 2-ի կոդ:
partyPropertyType2Name	String	Ապրանքի խմբաքանակի ապրանքի հատկության տեսակ 2-ի անվանում:
partyPropertyValue2Code	String	Ապրանքի խմբաքանակի ապրանքի հատկության արժեք 2-ի կոդ:
partyPropertyValue2Name	String	Ապրանքի խմբաքանակի ապրանքի հատկության արժեք 2-ի անվանում:
partyBase	UUID	Ապրանքի մուտքի խմբաքանակի փաստաթղթի ներքին նույնացուցիչ։
partyRow	Integer	Ապրանքի մուտքի խմբաքանակի փաստաթղթի տողի համար։
prices	Decimal	Ապրանքի մուտքի խմբաքանակի փաստաթղթի տողի համար։
id	Integer	Ապրանքի գինը ըստ դիալոգ պատուհանում նշված գնի տեսակի։
code	String	Ապրանքի կոդը։
name	String	Ապրանքի անվանումը։
fullName	String	Ապրանքի լրիվ անվանումը։
specification	String	Ապրանքի բնութագիրը։
unitMeasure	String	Ապրանքի չափման միավորի կոդը։
unitMeasureAbbreviation	String	Ապրանքի չափման միավորի հապավումը։
quantity	Decimal	Ապրանքի քանակը։
costAmountWithoutVAT	Decimal	Ապրանքի ինքնարժեքի գումարը առանց ԱԱՀ։
costAmountWithVAT	Decimal	Ապրանքի ինքնարժեքի գումարը ԱԱՀ-ով։
costAmountCurrency	Decimal	Ապրանքի ինքնարժեքի գումարը արտարժույթով։

GitHub

https://github.com/armsoft/trade-public-api-docs/blob/main/examples/csharp/reports/productsbalances.cs

Օրինակ 1. 31.01.2026թ.-ի դրությամբ բոլոր ապրանքների մնացորդների ստացում (ընդլայնված տվյալներով)

POST

Request

curl -X POST \

'https://api.armsoft.am/trade/v1/reports/productsbalances' \

-H 'accept: text/plain' \

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

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

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

-d '

{

"date": "2026-01-31"

Response body (201 Created)

{

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"hasMore": false,

"data": [

{

"storage": "",

"storageName": "",

"group": "110",

"groupName": "110 - Հեռուստացույցներ",

"costPriceWithoutVAT": 628506.72,

"costPriceWithVAT": 754177.00,

"costPriceCurrency": 1849.74,

"minimumQuantity": 0,

"variance": 0,

"maximumQuantity": 0,

"orderQuantity": 0,

"orderComment": "",

"incomeDate": "0001-01-01",

"partySupplierId": -1,

"partySupplierName": "",

"partySupplierTaxCode": "",

"partyContractCode": "",

"partyContractName": "",

"partyDocumentNumber": "",

"partyDocumentType": "",

"partyCountryCode": "",

"partyCountryName": "",

"partyProducerCode": "",

"partyProducerName": "",

"partyPropertyType1Code": "",

"partyPropertyType1Name": "",

"partyPropertyValue1Code": "",

"partyPropertyValue1Name": "",

"partyPropertyType2Code": "",

"partyPropertyType2Name": "",

"partyPropertyValue2Code": "",

"partyPropertyValue2Name": "",

"partyBase": "00000000-0000-0000-0000-000000000000",

"partyRow": 0,

"prices": {},

"id": 100000,

"code": "1001",

"name": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"specification": "Smart VIERA LCD TV, Size: 55\" (140 cm), Full-HD",

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"quantity": 6.0000,

"costAmountWithoutVAT": 3771040.2900,

"costAmountWithVAT": 4525061.9900,

"costAmountCurrency": 11098.4200

{

"storage": "",

"storageName": "",

"group": "110",

"groupName": "110 - Հեռուստացույցներ",

"costPriceWithoutVAT": 680981.38,

"costPriceWithVAT": 817141.58,

"costPriceCurrency": 2003.43,

"minimumQuantity": 0,

"variance": 0,

"maximumQuantity": 0,

"orderQuantity": 0,

"orderComment": "",

"incomeDate": "0001-01-01",

"partySupplierId": -1,

"partySupplierName": "",

"partySupplierTaxCode": "",

"partyContractCode": "",

"partyContractName": "",

"partyDocumentNumber": "",

"partyDocumentType": "",

"partyCountryCode": "",

"partyCountryName": "",

"partyProducerCode": "",

"partyProducerName": "",

"partyPropertyType1Code": "",

"partyPropertyType1Name": "",

"partyPropertyValue1Code": "",

"partyPropertyValue1Name": "",

"partyPropertyType2Code": "",

"partyPropertyType2Name": "",

"partyPropertyValue2Code": "",

"partyPropertyValue2Name": "",

"partyBase": "00000000-0000-0000-0000-000000000000",

"partyRow": 0,

"prices": {},

"id": 100001,

"code": "1002",

"name": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

"fullName": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

"specification": "Edge LED TV , Size: 55\" (140 cm), Full HD",

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"quantity": 10.0000,

"costAmountWithoutVAT": 6809813.7700,

"costAmountWithVAT": 8171415.7800,

"costAmountCurrency": 20034.2500

}

]

}

Օրինակ 2. 31.01.2026թ.-ի դրությամբ 00 և 03 պահեստներում առկա նշված կոդերով ապրանքների մնացորդների և 01 ու 02 գնի տեսակով գների ցանկի ստացում (ընդլայնված տվյալներով)

POST

Request

curl -X POST \

'https://api.armsoft.am/trade/v1/reports/productsbalances' \

-H 'accept: text/plain' \

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

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

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

-d '

{

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

"storages": [

"00",

"03"

"codes": [

"1001",

"1002"

"showSumsWithoutVAT": true,

"showSumsWithVAT": true,

"showCurrencySums": true,

"showByDifferentParties": true,

"openedByStorages": true,

"priceListTypes": [

"01",

"02"

]

Response body (201 Created)

{

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"hasMore": true,

"data": [

{

"storage": "00",

"storageName": "Կենտրոնական պահեստ",

"group": "110",

"groupName": "110 - Հեռուստացույցներ",

"costPriceWithoutVAT": 639208.06,

"costPriceWithVAT": 767012.40,

"costPriceCurrency": 1879.48,

"minimumQuantity": 0,

"variance": 0,

"maximumQuantity": 0,

"orderQuantity": 0,

"orderComment": "",

"incomeDate": "2026-01-13",

"partySupplierId": 100001,

"partySupplierName": "Техно Парк (Россия)",

"partySupplierTaxCode": "",

"partyContractCode": "001",

"partyContractName": "Հիմնական պայմանագիր",

"partyDocumentNumber": "ՊՄՆ-001",

"partyDocumentType": "Ներմուծում",

"partyCountryCode": "MY",

"partyCountryName": "MALAYSIA",

"partyProducerCode": "",

"partyProducerName": "",

"partyPropertyType1Code": "",

"partyPropertyType1Name": "",

"partyPropertyValue1Code": "",

"partyPropertyValue1Name": "",

"partyPropertyType2Code": "",

"partyPropertyType2Name": "",

"partyPropertyValue2Code": "",

"partyPropertyValue2Name": "",

"partyBase": "421054b1-cedd-4bcd-a347-fa5d03a89162",

"partyRow": 6,

"prices": {

"01": 736850.00,

"02": 750150.00

"id": 100000,

"code": "1001",

"name": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"specification": "Smart VIERA LCD TV, Size: 55\" (140 cm), Full-HD",

"unitMeasure": "001",

"unitMeasureAbbreviation": "հատ",

"quantity": 3.0000,

"costAmountWithoutVAT": 1917624.1700,

"costAmountWithVAT": 2301037.1900,

"costAmountCurrency": 5638.4400

{

"storage": "03",

"storageName": "ՙԴԱԼՄԱ՚ տոնավաճառ",

"group": "110",

"groupName": "110 - Հեռուստացույցներ",

"costPriceWithoutVAT": 639208.06,

"costPriceWithVAT": 767012.4,

"costPriceCurrency": 1879.48,

"minimumQuantity": 0,

"variance": 0,

"maximumQuantity": 0,

"orderQuantity": 0,

"orderComment": "",

"incomeDate": "2026-01-13",

"partySupplierId": 100001,

"partySupplierName": "Техно Парк (Россия)",

"partySupplierTaxCode": "",

"partyContractCode": "001",

"partyContractName": "Հիմնական պայմանագիր",

"partyDocumentNumber": "ՊՄՆ-001",

"partyDocumentType": "Ներմուծում",

"partyCountryCode": "MY",

"partyCountryName": "MALAYSIA",

"partyProducerCode": "",

"partyProducerName": "",

"partyPropertyType1Code": "",

"partyPropertyType1Name": "",

"partyPropertyValue1Code": "",

"partyPropertyValue1Name": "",

"partyPropertyType2Code": "",

"partyPropertyType2Name": "",

"partyPropertyValue2Code": "",

"partyPropertyValue2Name": "",

"partyBase": "421054b1-cedd-4bcd-a347-fa5d03a89162",

"partyRow": 6,

"prices": {

"01": 736850.00,

"02": 750150.00

}

]

}