Վաճառքների մատյան

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

Վաճառքների մատյան

Previous pageReturn to chapter overviewNext page

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

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

 

URI

https://api.armsoft.am/accountant/v1/reports/salesjournal

URL Swagger

https://api.armsoft.am/accountant/swagger/index.html#/Reports/post_v1_reports_materialsoperationsjournal

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 թ.-ի Վաճառքների մատյանի ստացում

POST