API-ի միջոցով հնարավոր է ստանալ (POST) ընտրման պայմաններին համապատասխանող Վաճառքների մատյան հաշվետվությունը:
URI |
https://api.armsoft.am/accountant/v1/reports/salesjournal |
URL Swagger |
GitHub |
|
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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 |
Ժամանակահատվածի վերջի ամսաթիվ: Կվերադարձվեն այն գործողությունները, որոնց ամսաթիվը ներառվում է նշված ժամանակահատվածում: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը: |
storage |
String(5) |
Optional Reference type |
Պահեստի կոդ։ Հաշվետվությունում կընդգրկվեն միայն այդ պահեստին վերաբերող գործողությունները։ Արժեք չուղարկելու դեպքում հաշվետվությունը կազմվում է ըստ բոլոր պահեստների։ |
materialGroup |
String(5) |
Optional Reference type |
Նյութական արժեքի խմբի կոդը: Հաշվետվությունը կընդգրկի միայն այդ խմբում ներառվող նյութական արժեքների տվյալները, հակառակ դեպքում` բոլոր նյութական արժեքների տվյալները: |
material |
String(20) |
Optional Reference type |
Նյութական արժեքի կոդը: Հաշվետվությունը կընդգրկի միայն այդ նյութական արժեքի տվյալները, հակառակ դեպքում` բոլոր նյութական արժեքների տվյալները: |
service |
String(20) |
Optional Reference type |
Ծառայության կոդը։ Հաշվետվությունը կընդգրկի միայն այդ ծառայության տվյալները, հակառակ դեպքում` բոլոր ծառայությունների տվյալները: |
fixedAsset |
String(12) |
Optional Reference type |
Հիմնական միջոցի կոդը: Հաշվետվությունը կընդգրկի միայն այդ Հիմնական միջոցի տվյալները, հակառակ դեպքում` բոլոր Հիմնական միջոցների տվյալները: |
incomeAccount |
String(12) |
Optional Reference type |
Հասույթի հաշիվը: |
expenseAccount |
String(12) |
Optional Reference type |
Ծախսի հաշիվը: |
partnerGroup |
String(5) |
Optional Reference type |
Գործընկերոջ խումբը: Հաշվետվությունում կընդգրկվեն միայն այն գործողությունները, որոնք կապված են նշված գործընկերների խմբի հետ: |
customer |
String(20) |
Optional Reference type |
Գործընկերոջ կոդը: Հաշվետվությունում կընդգրկվեն միայն այն գործողությունները, որոնք կապված են նշված գործընկերոջ հետ: |
operationTypes |
Enum |
Optional |
Գործողության տեսակը: Մատյանում կընդգրկվեն նշված տեսակի գործողությունները, իսկ դաշտը դատարկ լինելու դեպքում` բոլոր տեսակի: Ընդունում է հետևյալ արժեքները․. R - Իրացում, T - Իրացում (Մանրածախ), V - Վերադարձ |
showByDifferentParties |
Boolean |
Optional |
Ըստ տարբեր խմբաքանակների: Վաճառված նյութական արժքները հաշվետվությունում երևում են բացված ըստ խմբաքանակների: Հաշվետվությանն ավելանում է մուտքի փաստաթղթի վերաբերյալ տեղեկատվություն: |
currency |
String(3) |
Optional Reference type |
Արտարժույթի կոդը: Հաշվետվությունում կընդգրկվեն միայն այն գործողությունները, որոնք կատարվել են նշված արտարժույթով: |
showCurrencies |
Boolean |
Optional |
Ցույց տալ արտարժույթները։ Մատյանում կերևան նաև գործողությունների արտարժույթները: |
showVATAmounts |
Boolean |
Optional |
Ցույց տալ ԱԱՀ-ի գումարները։ Կցուցադրվեն Վաճառքի գումարի ԱԱՀ և Ինքնարժեքի գումարի ԱԱՀ դաշտերը: |
showMTAdditionalColumns |
Boolean |
Optional |
Ցույց տալ ՆԱ լրացուցիչ սյուները։ Հաշվետվությունում ավելանում են հետևյալ սյուները` ԱՏԳԱԱ դասակարգիչ, Գծիկավոր կոդ, ԱԱՀ, Լրիվ անվանում: |
Վերադարձվող օբյեկտի ատրիբուտներ (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 |
Փաստաթղթի համարը: |
documentType |
String |
Փաստաթղթի տեսակը: |
operationType |
String |
Գործողության տեսակը: |
operationName |
String |
Գործողության անվանում։ |
itemType |
String |
Վաճառքի օբյեկտի տեսակը 1 - Նյութական արժեք, 2 - Ծառայություն, 3 - Հիմնական միջոց: |
itemId |
Integer |
Վաճառքի օբյեկտի ներքին նույնացուցիչ։ |
itemCode |
String |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի կոդը: |
itemName |
String |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի անվանումը: |
storage |
String |
Պահեստի կոդը: Ծառայությունների և ՀՄ-ների համար այս դաշտը դատարկ է: |
storageName |
String |
Պահեստի անվանումը։ |
unitMeasure |
String |
Չափման միավորի կոդը: |
unitMeasureAbbreviation |
String |
Չափման միավորի հապավումը: |
partnerGroup |
String |
Գործընկերոջ խմբի կոդը: |
customer |
String |
Գնորդի կոդը: |
customerAccount |
String |
Գնորդի դեբիտորական պարտքի հաշիվը: |
customerBusinessAddress |
String |
Գնորդի գործունեության հասցեն: |
quantity |
Decimal |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի քանակը: |
cost |
Decimal |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի ինքնարժեքը դրամով: |
costAmount |
Decimal |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի ինքնարժեքի գումարը դրամով: |
initialPrice |
Decimal |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի վաճառքի գինն առանց զեղչի: |
salePrice |
Decimal |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի վաճառքի գինը դրամով: |
saleAmount |
Decimal |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի վաճառքի գումարը դրամով: |
environmentalFeePercent |
Decimal |
Բնապահպանական հարկի տոկոս։ |
environmentalFeeAmount |
Decimal |
Բնապահպանական հարկի գումար։ |
profit |
Decimal |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի վաճառքից ստացված շահույթը գումարային արտահայտությամբ: |
profitPercentBySale |
Decimal |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի վաճառքից ստացված շահույթը տոկոսային արտահայտությամբ` հաշվարկված ըստ վաճառքի գնի: |
profitPercentByCost |
Decimal |
Նյութական արժեքի վաճառքից ստացված շահույթը տոկոսային արտահայտությամբ` հաշվարկված ըստ ինքնարժեքի: |
unitVAT |
Decimal |
Նյութական արժեքի միավորի ինքնարժեքի ԱԱՀ-ն է: |
costVATAmount |
Decimal |
Նյութական արժեքի ինքնարժեքի գումարի ԱԱՀ-ն է: |
saleVATPrice |
Decimal |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի վաճառքի գնի ԱԱՀ-ն է: |
saleVATAmount |
Decimal |
Նյութական արժեքի, Ծառայության կամ Հիմնական միջոցի վաճառքի գումարի ԱԱՀ-ն է: |
vatDifference |
Decimal |
Ինքնարժեքի գումարի ԱԱՀ-ի և Վաճառքի գումարի ԱԱՀ-ի տարբերություն։ |
currency |
String |
Արժույթի կոդը: |
salePriceCurrency |
Decimal |
Վաճառքի գինն արժույթով: |
saleAmountCurrency |
Decimal |
Վաճառքի գումարն արժույթով: |
discountPercent |
Decimal |
Զեղչի %: |
itemVAT |
Boolean |
ԱԱՀ-ով հարկման հայտանիշ։ |
incomeAccount |
String |
Հասույթի հաշիվը: |
expenseAccount |
String |
Ծախսի հաշիվը: |
analytic1 |
String |
Անալիտիկ խումբ 1-ի կոդը։ |
analytic2 |
String |
Անալիտիկ խումբ 2-ի կոդը։ |
comment |
String |
Գործողության մեկնաբանությունը։ |
group |
String |
Նյութական արժեքի խումբի կոդը: |
groupName |
String |
Նյութական արժեքի խումբի անվանումը: |
specification |
String |
Նյութական արժեքի բնութագիրը: |
cpaClassifier |
String |
Նյութական արժեքի ԱՏԳԱԱ դասակարգիչ: |
vat |
Boolean |
Նյութական արժեքի ԱԱՀ-ով հարկման հայտանիշ։ |
fullName |
String |
Նյութական արժեքի լրիվ անվանում։ |
rowId |
Integer |
Տողի ներքին նույնացուցիչ։ |
incomeDate |
Date(YYYY-MM-DD) |
Նյութական արժեքի մուտքի ամսաթիվը: Այս դաշտը երևում է, երբ հաշվետվությունը ստեղծելու համար բերվող դիալոգ պատուհանում նշված է Ըստ տարբեր խմբաքանակների հայտանիշը: |
partySupplierId |
Integer |
Նյութական արժեքի մատակարարի ներքին նույնացուցիչ։ Այս դաշտը երևում է, երբ հաշվետվությունը ստեղծելու համար բերվող դիալոգ պատուհանում նշված է Ըստ տարբեր խմբաքանակների հայտանիշը: |
partySupplierCode |
String |
Նյութական արժեքի մատակարարի կոդը: Այս դաշտը երևում է, երբ հաշվետվությունը ստեղծելու համար բերվող դիալոգ պատուհանում նշված է Ըստ տարբեր խմբաքանակների հայտանիշը: |
partySupplierName |
String |
Նյութական արժեքի մատակարարի անվանումը: Այս դաշտը երևում է, երբ հաշվետվությունը ստեղծելու համար բերվող դիալոգ պատուհանում նշված է Ըստ տարբեր խմբաքանակների հայտանիշը: |
partyDocumentNumber |
String |
Նյութական արժեքի մուտքի փաստաթղթի համարը: Այս դաշտը երևում է, երբ հաշվետվությունը ստեղծելու համար բերվող դիալոգ պատուհանում նշված է Ըստ տարբեր խմբաքանակների հայտանիշը: |
partyDocumentType |
String |
Նյութական արժեքի մուտքի փաստաթղթի տեսակի կոդը:Այս դաշտը երևում է, երբ հաշվետվությունը ստեղծելու համար բերվող դիալոգ պատուհանում նշված է Ըստ տարբեր խմբաքանակների հայտանիշը: |
partyDocumentTypeName |
String |
Նյութական արժեքի մուտքի փաստաթղթի տեսակի անվանումը։ Այս դաշտը երևում է, երբ հաշվետվությունը ստեղծելու համար բերվող դիալոգ պատուհանում նշված է Ըստ տարբեր խմբաքանակների հայտանիշը: |
partyPurchasingPrice |
Decimal |
Նյութական արժեքի մուտքի փաստաթղթի ձեռքբերման գինը։ Այս դաշտը երևում է, երբ հաշվետվությունը ստեղծելու համար բերվող դիալոգ պատուհանում նշված է Ըստ տարբեր խմբաքանակների հայտանիշը: |
partyPurchasingPriceWithoutVAT |
Decimal |
Նյութական արժեքի մուտքի փաստաթղթի ձեռքբերման գինը առանց ԱԱՀ։ Այս դաշտը երևում է, երբ հաշվետվությունը ստեղծելու համար բերվող դիալոգ պատուհանում նշված է Ըստ տարբեր խմբաքանակների հայտանիշը: |
GitHub |
|
Օրինակ 1. 2026 թ.-ի Վաճառքների մատյանի ստացում
|