Ապրանքների մնացորդներ

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

Ապրանքների մնացորդներ

 Previous pageReturn to chapter overviewNext page

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

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

 

URI

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

URL Swagger

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

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

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

 

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

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

Անվանում

Տեսակ

Կիրառումը

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

date

Date(YYYY-MM-DD)

api_required

Մնացորդների ձևավորման ամսաթիվը:

storages [0..n]

Array

api_optional

Դատարկ թողնելու դեպքում կընդգրկվեն բոլոր պահեստների մնացորդները:

group

String(5)

api_optional

Ապրանքի կամ ծառայության խմբի կոդը: Դատարկ լինելու դեպքում հաշվետվության մեջ կընդգրկվեն բոլոր   խմբերի ապրանքները։

codes [0..n]

Array

api_optional

Ապրանքի կոդը:

showQuantitiesWithAdditionalUnits

Boolean

api_optional

True արժեքի դեպքում քանակները ցուցադրվում են լրացուցիչ չափման միավորով:

   priceType

String(2)

api_optional

Կարելի է լրացնել կազմակերպությունում գործող որևէ գնի տեսակ, և եթե տվյալ ապրանքն ունի սահմանված այդ տեսակի գին, ապա այն կերևա հաշվետվության մեջ։

showZeroRows

Boolean

api_optional

Սահմանում է՝ արդյոք հաշվետվության մեջ պետք է ցուցադրվեն նաև այն ապրանքները, որոնց մնացորդը հավասար է 0-ի։ True արժեքի դեպքում հաշվետվության մեջ կցուցադրվեն նաև այն ապրանքները, որոնց ընթացիկ մնացորդը 0 է, սակայն նրանց նկատմամբ երբևէ գրանցվել է առնվազն մեկ գործողություն (մուտք, ելք, տեղափոխություն և այլն)։

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

Անվանում

Տեսակ

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

salePrice

Decimal

Ապրանքի  վաճառքի գին։

salePriceAmount

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": [

       {

           "salePrice": 0,

           "salePriceAmount": 0,

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

           "costAmountCurrency": 11098.4200

       },

       {

           "salePrice": 0,

           "salePriceAmount": 0,

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

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

 ],

 "codes": [

  "1001",

  "1002"

 ],

 "priceType": "02"

}'

 

Response body (201 Created)

 

{

   "data": [

       {

           "salePrice": 750150.00,

           "salePriceAmount": 2250450.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": 1917624.1700,

           "costAmountCurrency": 5638.4400

       },

       {

           "salePrice": 920450.00,

           "salePriceAmount": 4602250.00,

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

           "costAmountWithoutVAT": 3403107.6900,

           "costAmountWithVAT": 3403107.6900,

           "costAmountCurrency": 10006.2400

       }

   ]

}