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

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

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

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

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

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

Վերադարձվող օբյեկտի ատրիբուտներ (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	Ապրանքի ինքնարժեքի գումարը արտարժույթով։

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)

{

"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

}

]

}

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)

{

"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

}

]

}