Դուրս գրված հաշիվների մատյան

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

Դուրս գրված հաշիվների մատյան

Previous pageReturn to chapter overviewNext page

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

API-ի միջոցով հնարավոր է ստանալ (POST) համակարգում գրանցված վաճառքի և վերադարձի փաստաթղթերի ցանկը:

 

URI

https://api.armsoft.am/accountant/v1/journals/invoices

URL Swagger

https://api.armsoft.am/accountant/swagger/index.html#/Journals/post_v1_journals_invoices

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

-H 'apiKey: @SKq7*ERI]ZIgXvpkWhV'

Այս հարցման դեպքում գործում է էջավորման մեխանիզմը:

 

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

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

Անվանում

Տեսակ

Կիրառումը

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

startDate

Date(YYYY-MM-DD)

*Required

Ժամանակահատվածի սկզբի ամսաթիվ: Կվերադարձվեն այն փաստաթղթերը, որոնց ամսաթիվը ներառվում է նշված    ժամանակահատվածում:

endDate

Date(YYYY-MM-DD)

*Required

Ժամանակահատվածի վերջի ամսաթիվ: Կվերադարձվեն այն փաստաթղթերը, որոնց ամսաթիվը ներառվում է նշված ժամանակահատվածում:

pageSize

Integer

Optional

Սահմանում է մեկ հարցմամբ վերադարձվող գրառումների քանակը։ Նվազագույն վերադարձվող քանակը 5000 տող է․ եթե փոխանցված արժեքը փոքր է 5000-ից, համակարգը միևնույն է վերադարձնում է առնվազն 5000 գրառում։ Եթե pageSize = 0, վերադարձվում են բոլոր հասանելի տվյալները։ Առավելագույն սահմանաչափ ներկայումս սահմանված չէ։

Վերադարձվող օբյեկտում առկա է hasMore լոգիկական (boolean) դաշտ, որի true արժեքը ցույց է տալիս, որ կան դեռ չվերադարձված գրառումներ. այսինքն ՝ առկա են հաջորդ էջեր։

documentTypes [0..n]

Array

Optional

Reference type

Փաստաթղթերի տեսակների ցանկ: Ընդունում է հետևյալ արժեքները`

07 - Վաճառք (Մանրածախ),

72 - Վերադարձ գնորդից,

02 - Ստացված ծառայություններ,

06 - Հաշիվ-Ապրանքագիր։

currency

String(20)

Optional

Reference type

Արժույթի կոդը, ըստ որի կառուցվում է մատյանը։

partner

String(12)

Optional

Reference type

Գործընկերոջ կոդ: Մատյանում կընդգրկվեն միայն նշված գործընկերոջ հետ կապված փաստաթղթերը:

showOutputAmountsAsNegatives

Boolean

Optional

True արժեքի դեպքում Վերադարձ գնորդից փաստաթղթերի գումարները արտացոլվում են բացասական նշանով։

documentState

Boolean

Optional

Փաստաթղթի վիճակ: Ընդունում է հետևյալ արժեքները.

0 - Գրանցված կամ սևագիր,

1 - Սևագիր,

2 - Գրանցված,

3 - Հեռացված:

 

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

Անվանում

Տեսակ

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

id

UUID

Հարցման ունիկալ նույնացուցիչ, որը գեներացվում է համակարգի կողմից և օգտագործվում է էջավորման (pagination) համար։ Եթե պատասխանում hasMore = true, ապա id-ն պետք է փոխանցել հաջորդ հարցման մեջ մնացած տվյալները ստանալու համար։

hasMore

Boolean

Լոգիկական(boolean) դաշտ է, որի true արժեքը ցույց է տալիս, որ կան դեռ չվերադարձված գրառումներ. այսինքն ՝ առկա են հաջորդ էջեր։

isn

UUID

Փաստաթղթի ներքին նույնացուցիչ։

date

Date(YYYY-MM-DD)

Փաստաթղթի ստեղծման ամսաթիվ:

documentNumber

String

Փաստաթղթի համար:

type

Enum

Փաստաթղթի տեսակի կոդ։

typeName

String

Փաստաթղթի տեսակի անվանում։

taxSerialNumber

String

Հարկային մարմնի կողմից ստացված սերիա-համար։

currency

Decimal

Փաստաթղթի արժույթ։

amount

Decimal

Փաստաթղթի գումար:

vatType

Enum

ԱԱՀ-ի հաշվարկի ձև: Ընդունում է հետևյալ արժեքները․

1 - ԱԱՀ-ով,

2 - ԱԱՀ-ն այդ թվում,

3 - Առանց ԱԱՀ,

4 - Զրոյական ԱԱՀ,

5 - ԱԱՀ-ն այդ թվում 16.67 %:

vatTypeName

String

ԱԱՀ-ի հաշվարկի տեսակի անվանում:

state

Enum

Փաստաթղթի վիճակի կոդ:

stateName

String

Փաստաթղթի վիճակի անվանում։

partnerId

Integer

Գործընկերոջ ներքին նույնացուցիչ։

partnerCode

String

Գործընկերոջ կոդ:

partnerName

String

Գործընկերոջ անվանում:

partnerTaxCode

String

Գործընկերոջ ՀՎՀՀ:

comment

String

Մեկնաբանություն փաստաթղթի վերաբերյալ:

taxExportType

Enum

Հաշվարկային փաստաթղթի դուրսգրման եղանակ։ Ընդունում է հետևյա արժեքները․

1- էլեկտրոնային,

2-թղթային:

userName

String

Օգտագործողի անունը: Նշվում է այն օգտագործողի անունը, ով վերջինն է աշխատել (գրանցել կամ խմբագրել) տվյալ փաստաթղթի հետ:

lastChange

Date(YYYY-MM-DDTHH:mm:ss)

Փաստաթղթի վերջին խմբագրման ամսաթիվը և ժամը:

 

Օրինակ 1. 2026 թ.-ի հունվար ամսվա դուրս գրված հաշիվների ստացում

POST

 

Օրինակ 2. 2026 թ.-ի հունվար ամսվա դուրս գրված հաշիվների ստացում` ելքերի (վերդարձների) գումարները բացասական ցուցադրելով

POST