API-ի միջոցով հնարավոր է ստանալ (POST) վաճառքերի վերլուծություն հաշվետվությունը։ Այն նախատեսված է կազմակերպության վաճառքները վերլուծելու համար։ Հաշվետվությունում երևում են վաճառքի ինքնարժեքները, վաճառքի գումարները և վաճառքից ստացված օգուտները/վնասները` գումարային և տոկոսային ներկայացմամբ։
URI |
https://api.armsoft.am/trade/v1/reports/salesanalysis |
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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 արժեքը ցույց է տալիս, որ կան դեռ չվերադարձված գրառումներ. այսինքն ՝ առկա են հաջորդ էջեր։ |
startDate |
Date(YYYY-MM-DD) |
*Required |
Ժամանակահատվածի սկզբի ամսաթիվ: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը: |
endDate |
Date(YYYY-MM-DD) |
*Required |
Ժամանակահատվածի վերջի ամսաթիվ: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը: |
storages [0..n] |
Array |
Optional Reference type |
Պահեստը, որտեղից կատարվել են վաճառքները: Դատարկ լինելու դեպքում հաշվետվության մեջ կընդգրկվեն բոլոր պահեստներից վաճառքները։ Կարելի է նշել մեկ կամ մի քանի պահեստներ։ |
itemType |
Enum |
Optional |
Ընդունում է հետևյալ արժեքները․ 1 - Ապրանք 2 - Ծառայություն Դաշտը դատարկ լինելու դեպքում հաշվետվության մեջ կընդգրկվեն և' ապրանքները, և' ծառայությունները: |
itemsGroup |
String(5) |
Optional Reference type |
Ապրանքի կամ ծառայության խմբի կոդ: Դատարկ լինելու դեպքում հաշվետվության մեջ կընդգրկվեն բոլոր խմբերի ապրանքները և ծառայությունները: |
itemCode |
String(20) |
Optional Reference type |
Ապրանքի կամ ծառայության կոդ: Դատարկ լինելու դեպքում հաշվետվության մեջ կընդգրկվեն և՛ ապրանքները, և՛ ծառայությունները: |
partnersGroup |
String(5) |
Optional Reference type |
Գործընկերոջ խմբի կոդ: Դատարկ լինելու դեպքում հաշվետվության մեջ կընդգրկվեն գործընկերների բոլոր խմբերին կատարված վաճառքները: |
partnerCode |
String(20) |
Optional Reference type |
Գործընկերոջ կոդ: Դատարկ լինելու դեպքում հաշվետվության մեջ կընդգրկվեն բոլոր գործընկերներին կատարված վաճառքները: |
showQuantitiesWithAdditionalUnits |
Boolean |
Optional |
Քանակները ցույց տալ լրացուցիչ չափման միավորով: |
showSumsWithoutVAT |
Boolean |
Optional |
True արժեքի դեպքում հաշվետվությունում երևում են ապրանքների ինքնարժեքները` ներկայացված դրամով և առանց ԱԱՀ-ի։ |
showSumsWithVAT |
Boolean |
Optional |
True արժեքի դեպքում հաշվետվությունում երևում են ապրանքների ինքնարժեքները` ներկայացված դրամով և ներառյալ ԱԱՀ-ն։ |
showCurrencySums |
Boolean |
Optional |
True արժեքի դեպքում հաշվետվությունում երևում են ապրանքների ինքնարժեքները` ներկայացված USD-ով և ներառյալ ԱԱՀ-ն։ |
showParties |
Boolean |
Optional |
True արժեքի դեպքում հաշվետվությունում երևում են ապրանքների խմբաքանակները բնորոշող սյուներ (Մուտքի ա/թ, Մատակարար, մուտքի փաստաթղթի N, Օգտ․ ժամկետ, Երկիր, Արտադրող և այլն)։ |
showCostAndSalePrices |
Boolean |
Optional |
True արժեքի դեպքում հաշվետվությունում երևում են ապրանքների ինքնարժեքներն ու վաճառքի գները: |
showDiscounts |
Boolean |
Optional |
True արժեքի դեպքում հաշվետվությունում երևում են վաճառքների ժամանակ կիրառված զեղչի գումարները և տոկոսները։ |
showBonusPoints |
Boolean |
Optional |
True արժեքի դեպքում հաշվետվությունում երևում են բոնուսների կուտակումներն ու մարումները: |
showVATAmounts |
Boolean |
Optional |
True արժեքի դեպքում կցուցադրվեն Վաճառքի գումարի ԱԱՀ և Ինքնարժեքի գումարի ԱԱՀ սյուներ: |
groupBy |
Enum |
Optional |
Հաշվետվությունը կարելի է կանչել խմբավորված ըստ ապրանքների և ծառայությունների կամ ըստ գործընկերների։ Այդ դեպքում հաշվետվության մեջ միևնույն ապրանքների (գործընկերներին) վաճառքները երևում են մեկ տողով։ |
Վերադարձվող օբյեկտի ատրիբուտներ (Object Attributes)
Անվանում |
Տեսակ |
Նկարագրություն |
id |
Integer |
Հարցման ունիկալ նույնացուցիչ, որը գեներացվում է համակարգի կողմից և օգտագործվում է էջավորման (pagination) համար։ Եթե պատասխանում hasMore = true, ապա id-ն պետք է փոխանցել հաջորդ հարցման մեջ մնացած տվյալները ստանալու համար։ |
hasMore |
Boolean |
Լոգիկական(boolean) դաշտ է, որի true արժեքը ցույց է տալիս, որ կան դեռ չվերադարձված գրառումներ. այսինքն ՝ առկա են հաջորդ էջեր։ |
data[] |
Array |
Տվյալների ցուցակ (մասսիվ), որտեղ յուրաքանչյուր օբյեկտ ներկայացնում է 1 գրառում (ապրանք)։ |
Տվյալների օբյեկտի ատրիբուտներ (Data Object Attributes)
Անվանում |
Տեսակ |
Նկարագրություն |
documentNumber |
String |
Վաճառքի (վերադարձի) փաստաթղթի համար: |
date |
Date(YYYY-MM-DD) |
Վաճառքի (վերադարձի) փաստաթղթի ամսաթիվը: |
isn |
UUID |
Փաստաթղթի ներքին նույնացուցիչ (UUID): |
operationType |
String |
Գործողության տեսակի անվանում. Հաշիվ-ապրանքագիր, Վերադարձ գնորդից, Վաճառք (Կտրոն), Վաճառք (Մանրածախ): |
documentCurrency |
String |
Վաճառքի (վերադարձի) փաստաթղթի արժույթը: |
documentVATType |
String |
ԱԱՀ-ի հաշվարկի ձև: Ընդունում է հետևյալ արժեքները․ 1 - ԱԱՀ-ով, 2 - ԱԱՀ-ն այդ թվում, 3 - Առանց ԱԱՀ, 4 - Զրոյական ԱԱՀ, 5 - ԱԱՀ-ն այդ թվում 16.67 % |
documentVATTypeName |
String |
ԱԱՀ-ի հաշվարկի տեսակի անվանում: |
ecrCheckNumber |
String |
ՀԴՄ կտրոնի համար: |
itemType |
String |
Տեսակ: Ընդունում է հետևյալ արժեքները․ 1 - Ապրանք, 2 - Ծառայություն: |
itemTypeName |
String |
Տեսակի անվանում. Ապրանք, Ծառայություն: |
itemId |
Integer |
Ապրանքի (ծառայության) ներքին նույնացուցիչ: |
itemCode |
String |
Ապրանքի (ծառայության) կոդ: |
itemName |
String |
Ապրանքի (ծառայության) անվանում: |
unitMeasure |
String |
Չափման միավորի կոդը: |
unitMeasureAbbreviation |
String |
Չափման միավորի անվանում: |
storage |
String |
Պահեստի կոդ: |
storageName |
String |
Պահեստի անվանում: |
cashDesk |
String |
Դրամարկղի կոդ: |
cashDeskName |
String |
Դրամարկղի անվանում: |
customer |
String |
Գնորդի կոդ: |
customerName |
String |
Գնորդի անվանում: |
customerContractName |
String |
Գնորդի պայմանագրի անվանում |
quantity |
Decimal |
Վաճառքի (վերադարձի) քանակ: |
costAmountWithoutVAT |
Decimal |
Ինքնարժեքի գումար առանց ԱԱՀ: |
costPriceWithoutVAT |
Decimal |
Ինքնարժեքի գին առանց ԱԱՀ: |
salePriceWithoutVAT |
Decimal |
Վաճառքի գին առանց ԱԱՀ: |
saleAmountWithoutVAT |
Decimal |
Վաճառքի գումար առանց ԱԱՀ: |
profitWithoutVAT |
Decimal |
Շահույթ առանց ԱԱՀ: |
profitPercentBySaleWithoutVAT |
Decimal |
Վաճառքի շահութաբերություն առանց ԱԱՀ: |
profitPercentByCostWithoutVAT |
Decimal |
Վաճառքի արդյունավետություն առանց ԱԱՀ։ |
initialPriceWithoutVAT |
Decimal |
Սկզբնական գին առանց ԱԱՀ։ |
initialAmountWithoutVAT |
Decimal |
Սկզբնական գումար առանց ԱԱՀ։ |
discountPercentWithoutVAT |
Decimal |
Զեղչի % առանց ԱԱՀ։ |
discountAmountWithoutVAT |
Decimal |
Զեղչի գումար առանց ԱԱՀ։ |
costAmountWithVAT |
Decimal |
Ինքնարժեքի գումար ներառյալ ԱԱՀ։ |
costPricewithVAT |
Decimal |
Ինքնարժեքի գին ներառյալ ԱԱՀ։ |
salePriceWithVAT |
Decimal |
Վաճառքի գին ներառյալ ԱԱՀ։ |
saleAmountWithVAT |
Decimal |
Վաճառքի գումար ներառյալ ԱԱՀ։ |
profitWithVAT |
Decimal |
Շահույթ ներառյալ ԱԱՀ։ |
profitPercentBySaleWithVAT |
Decimal |
Վաճառքի շահութաբերություն ներառյալ ԱԱՀ։ |
profitPercentByCostWithVAT |
Decimal |
Վաճառքի արդյունավետություն ներառյալ ԱԱՀ։ |
initialPriceWithVAT |
Decimal |
Սկզբնական գին ներառյալ ԱԱՀ։ |
initialAmountWithVAT |
Decimal |
Սկզբնական գումար ներառյալ ԱԱՀ։ |
discountPercentWithVAT |
Decimal |
Զեղչի % ներառյալ ԱԱՀ։ |
discountAmountWithVAT |
Decimal |
Զեղչի գումար ներառյալ ԱԱՀ։ |
costVATAmount |
Decimal |
Ինքնարժեքի գումարի ԱԱՀ։ |
costVATPrice |
Decimal |
Ինքնարժեքի ԱԱՀ։ |
saleVATAmount |
Decimal |
Վաճառքի գումարի ԱԱՀ։ |
discountVATAmount |
Decimal |
Զեղչի գումարի ԱԱՀ։ |
costAmountCurrency |
Decimal |
Ինքնարժեքի գումար արտարժույթով։ |
costPriceCurrency |
Decimal |
Ինքնարժեքի գին արտարժույթով։ |
salePriceCurrency |
Decimal |
Վաճառքի գին արտարժույթով։ |
saleAmountCurrency |
Decimal |
Վաճառքի գումար արտարժույթով։ |
profitCurrency |
Decimal |
Շահույթ արտարժույթով։ |
profitPercentBySaleCurrency |
Decimal |
Վաճառքի շահութաբերություն արտարժույթով։ |
profitPercentByCostCurrency |
Decimal |
Վաճառքի արդյունավետություն արտարժույթով։ |
initialPriceCurrency |
Decimal |
Սկզբնական գին արտարժույթով։ |
initialAmountCurrency |
Decimal |
Սկզբնական գումար արտարժույթով։ |
discountPercentCurrency |
Decimal |
Զեղչի % արտարժույթով։ |
discountAmountCurrency |
Decimal |
Զեղչի գումար արտարժույթով։ |
usedBonus |
Decimal |
Օգտագործված բոնուսային միավորներ։ |
accumulatedBonus |
Decimal |
Հաշվարկված բոնուսային միավորներ։ |
description |
String |
Նկարագրություն։ |
seller |
String |
Վաճառողի կոդ։ |
sellerName |
String |
Վաճառողի անվանում։ |
comment |
String |
Վաճառքի (վերադարձի) փաստաթղթի մեկնաբանություն: |
itemGroup |
String |
Ապրանքների խումբ։ |
itemSpecification |
String |
Ապրանքի բնութագիր։ |
businessAddress |
String |
Գործունեության հասցե։ |
incomeDate |
Date(YYYY-MM-DD) |
Ապրանքի խմբաքանակի. մուտքագրման ամսաթիվ: |
partySupplierId |
Integer |
Ապրանքի խմբաքանակի մատակարարի ներքին նույնացուցիչ։ |
partySupplierName |
String |
Ապրանքի խմբաքանակ. մատակարարի անվանում: |
partySupplierTaxCode |
String |
Ապրանքի խմբաքանակի մատակարարի ՀՎՀՀ: |
partyContractName |
String |
Ապրանքի խմբաքանակի մատակարարման պայմանագիր: |
partyDocumentTypeName |
String |
Ապրանքի խմբաքանակի մատակարարման փաստաթղթի տեսակ: |
partyDocumentNumber |
String |
Ապրանքի խմբաքանակի մատակարարման փաստաթղթի համար: |
partyCountryName |
String |
Ապրանքի խմբաքանակը արտադրող երկիր: |
partyProducerName |
String |
Ապրանքի խմբաքանակի արտադրողը: |
partyBase |
UUID |
Ապրանքի խմբաքանակի փաստաթղթի ներքին նույնացուցիչը։ |
partyRow |
Integer |
Ապրանքի խմբաքանակի փաստաթղթի տողի համար։ |
GitHub |
https://github.com/armsoft/trade-public-api-docs/blob/main/examples/csharp/reports/salesanalysis.cs |
Օրինակ 1. 2026 թ.-ի համար Վաճառքների վերլուծություն հաշվետվության ստացում
|
Օրինակ 2. 2026 թ.-ի համար Վաճառքների վերլուծություն հաշվետվության ստացում (նշված պահեստների համար և լրացուցիչ կարգավորումներով)
POST |
|