REST API (ամպային տարբերակ) > Փաստաթղթեր > Հավելյալ ծախսերի բաշխում

API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) Հավելյալ ծախսերի բաշխում փաստաթուղթը:

URI	https://api.armsoft.am/accountant/v1/documents/overheadexpenseallocation

URL Swagger

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

GitHub

https://github.com/armsoft/accountant-public-api-docs/blob/main/docs/api/documents/overheadexpenseallocation.md

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

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

Հավելյալ ծախսերի բաշխում օբյեկտի ատրիբուտներ (Object Attributes)

Ստորև ներկայացված է օբյեկտի ատրիբուտների նկարագրությունը.

Անվանում	Տեսակ	Կիրառումը	Նկարագրություն
isn	UUID	Optional *Required for update System defined	Փաստաթղթի նույնացուցիչ: Պարտադիր է GET, PUT, DELETE հարցումների դեպքում։ Եթե POST հարցման ժամանակ UUID-ը չի փոխանցվում, սերվերը այն ավտոմատ գեներացնում է և վերադարձնում պատասխանում։
date	Date(YYYY-MM-DD)	*Required	Փաստաթղթի ամսաթիվ: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը:
documentNumber	String(12)	*Required	Փաստաթղթի համար: Եթե համարը չի փոխանցվում, ապա գրանցվում է վերջին համարին ավելացնելով 1:
state	Enum	*Required	Փաստաթղթի վիճակ: Ընդունում է հետևյալ արժեքները. 0 - Գրանցված կամ սևագիր, 1 - Սևագիր, 2 - Գրանցված, 99 - Հեռացված: Եթե վիճակը չի փոխանցվում, փաստաթուղթը ավտոմատ գրանցված վիճակում է ուղարկվում։
baseDocument	UUID	*Required	Հավելյալ ծախսերի բաշխում փաստաթղթի համար հիմք հանդիսացող Պահեստ մուտքի օրդեր փաստաթուղթի ISN, որին վերաբերում է հավելյալ ծախսը և որի վրա պետք է կատարվի բաշխումը:
currency	String(3)	*Conditional required Reference type	Փաստաթղթի արժույթի կոդ: Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։
currencyExchangeRate	Decimal	*Conditional required	Արժույթի փոխարժեք: Պարտադիր է ուղարկել, եթե փաստաթուղթը արտարժույթով է։
currencyExchangeBase	Integer	*Conditional required	Արժույթի փոխարժեքի պատիկություն: Պարտադիր է ուղարկել, եթե փաստաթուղթը արտարժույթով է։
previousDayExchangeRate	Boolean	Optional	Նախորդ օրվա փոխարժեքով հաշվառելու հայտանիշ։
supplierCode	String(20)	Optional Reference type	Մատակարարի կոդ։
supplierAccount	String(12)	Optional Reference type	Մատակարարի հաշիվ։
prepaymentAccount	String(12)	Optional Reference type	Տրված կանխավճարի հաշիվ։
vatAccount	String(12)	Optional Reference type	ԱԱՀ-ի հաշիվը։
analytic1	String(12)	Optional Reference type	Անալիտիկ խումբ 1-ի կոդ։
analytic2	String(12)	Optional Reference type	Անալիտիկ խումբ 1-ի կոդ։
taxExportType	Enum	Optional	Հաշվարկային փաստաթղթի դուրսգրման եղանակ։ Ընդունում է հետևյալ արժեքները․ 1- էլեկտրոնային, 2-թղթային:
purchaseDocumentNumber	String(12)	Optional	Մատակարարից ստացված ձեռքբերման փաստաթղթի համար։
purchaseDocumentDate	Date(YYYY-MM-DD)	Optional	Մատակարարից ստացված ձեռքբերման փաստաթղթի ամսաթիվ։
comment	String(255)	Optional	Մեկնաբանություն։
overheadExpenseType	Enum	*Required	Հավելյալ ծախսի ձեռք բերման տեսակ։ Ընդունում է հետևյալ արժեքները․ 1 - Մատակարարից Հ/Ա-ով, 2 - Առհաշվից` միակողմանի գնման ակտով, 3 - Առհաշվից` երկկողմանի գնման ակտով, 4- Առանց հարկերի։ Եթե արժեք չենք տալիս, ավտոմատ լրացվում է 1 - Մատակարարից Հ/Ա-ով արժեքը։
vatCalculationType	Enum	*Required	ԱԱՀ-ի հաշվարկի ձև։ Ընդունում է հետևյալ արժեքները. 1 - ԱԱՀ-ով, 2 - ԱԱՀ-ն այդ թվում, 3 - Առանց ԱԱՀ, 4 - Զրոյական ԱԱՀ, Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։
includeVATInCost	Boolean	Optional	ԱԱՀ-ն ինքնարժեքի մեջ ներառելու հայտանիշ։
vatInclusionMethod	Enum	*Conditional required	ԱԱՀ-ի արտացոլման ձև։ ընդունում է հետևյալ արժեքները․ 1 - Չարտացոլել ԱԱՀ-ն շրջանառության մեջ, 2 - Արտացոլել ԱԱՀ-ն շրջանառության մեջ։ Պարտադիր է ուղարկել, եթե ԱԱՀ-ն ինքնարժեքի մեջ ներառելու հայտանիշը True արժեքն ունի։
storage	String(5)	Read only Reference type	Ավտոմատ լրացվում է պահեստի կոդը, որտեղ գտնվում են այն նյութական արժեքները, որոնց վրա կատարվում է հավելյալ ծախսերի բաշխումը: Արժեքը վերցնում է հիմք փաստաթղթից։
allowEditList	Boolean	*Required	Ցուցակի խմբագրումը թույլատրելու հայտանիշ։
distributionType	Enum	*Required	Հավելյալ ծախսերի բաշխման ձևը. 1- Ավտոմատ, 2- Ձեռքով:
distributionBase	Enum	*Required	Հավելյալ ծախսերի բաշխման հիմքը. 1- Գումարային, 2- Քանակային, 3- Քանակի և գործակցի արտադրյալը: Գործակիցը նշվում է Նյութական արժեքներ տեղեկատուում:
amount	Decimal	*Required	Բաշխման ենթակա գումարը:
vatAmount	Decimal	Optional	ԱԱՀ-ի գումարը։ Ավտոմատ հաշվարկվում է համակարգի կողմից։
materialsList [0..n]	Array	Optional	Նյութական արժեքների անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի նյութական արժեքի առնվազն մեկ տող։

Անվանացուցակի տողի դաշտերը (itemList)

Անվանում	Տեսակ	Կիրառումը	Նկարագրություն
id	Integer	System defined	Նյութական արժեքի ներքին նույնացուցիչ։
code	String(20)	*Required Reference type	Նյութական արժեքի կոդ:
name	String(200)	Read only	Նյութական արժեքի անվանում: Ավտոմատ լրացվում է հիմք փաստաթղթից։
unitAbbreviation	String(6)	Read only Reference type	Նյութական արժեքի չափման միավորի հապավում։ Ավտոմատ լրացվում է հիմք փաստաթղթից։
quantity	Decimal	Read only	Նյութական արժեքի քանակ։ Ավտոմատ լրացվում է հիմք փաստաթղթից։
inputOrderAmount	Decimal	Read only	Հիմք փաստաթղթում նյութական արժեքի դրամային գումարն է, այն հանդիսանում է գումարային բաշխման հիմքը: Բաշխումը կատարվում է տեսակարար կշռի սկզբունքով:
allocatedAmount	Decimal	*Conditional required	Բաշխման արդյունքում նյութական արժեքի դրամային գումարի աճը: Պարտադիր է արժեք տալ եթե Բաշխման ձևը ընտրված է 2- Ձեռքով:
account	String(12)	Optional Reference type	Նյութական արժեքի հաշիվը:
includeInDistribution	Boolean	*Conditional required	Բաշխումը կատարվում է միայն true արժեքով տողերի վրա այն դեպքում, երբ Ցուցակի խմբագրումը թույլատրելու հայտանիշը նշված է։
coefficient	Decimal	Read only	Հավելյալ ծախսերի բաշխման գործակիցը: Եթե Բաշխման հիմքը նշված է 3` ՔանակxԳործակից արժեքը, ապա գործակցի արժեքը ավտոմատ վերցնում է Նյութական արժեքներ տեղեկատուից:
rowId	Integer	*Conditional required	Տողի հերթական համար։ Պարտադիր է նշել, եթե Բաշխման ձևը ընտրված է 2- Ձեռքով:

GitHub

https://github.com/armsoft/accountant-public-api-docs/blob/main/examples/csharp/documents/create-overheadexpenseallocation.cs

Օրինակ 1. Հավելյալ ծախսերի բաշխում փաստաթղթի ստեղծում գումարի ավտոմատ բաշխման եղանակով։

POST

Request

curl -X POST \

'https://api.armsoft.am/accountant/v1/documents/overheadexpenseallocation' \

-H 'accept: text/plain' \

-H 'Accept-Language: hy-AM' \

-H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \

-H 'Content-Type: application/json' \

-d '{

"baseDocument": "42e8b6ab-b99b-4c09-828e-029f5304ee39",

"amount": 900

Response body (201 Created)

{

"isn": "e1e53fd8-4c73-4dce-b9bd-7c20e58fc1d5",

"date": "2026-08-19",

"documentNumber": "string14",

"state": 2,

"baseDocument": "42e8b6ab-b99b-4c09-828e-029f5304ee39",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"previousDayExchangeRate": false,

"supplierCode": "",

"supplierAccount": "52131",

"prepaymentAccount": "2243",

"vatAccount": "2611",

"analytic1": "",

"analytic2": "",

"taxExportType": "",

"purchaseDocumentNumber": "",

"comment": "",

"overheadExpenseType": "1",

"vatCalculationType": "1",

"includeVATInCost": false,

"vatInclusionMethod": "",

"storage": "01",

"allowEditList": false,

"distributionType": "1",

"distributionBase": "1",

"amount": 900.0000,

"vatAmount": 180.0000,

"materialsList": [

{

"id": 100038,

"code": "0",

"name": "Chicken",

"unitAbbreviation": "հատ",

"quantity": 1.0000,

"inputOrderAmount": 200.0000,

"allocatedAmount": 72.0000,

"account": "2111",

"includeInDistribution": true,

"coefficient": 266.0000,

"rowId": 0

{

"id": 100000,

"code": "10001",

"name": "Իտալական մանկական կոշիկ",

"unitAbbreviation": "հատ",

"quantity": 2.0000,

"inputOrderAmount": 800.0000,

"allocatedAmount": 288.0000,

"account": "2161",

"includeInDistribution": true,

"coefficient": 1.0000,

"rowId": 1

{

"id": 100001,

"code": "10002",

"name": "Կանացի կոշիկ",

"unitAbbreviation": "հատ",

"quantity": 3.0000,

"inputOrderAmount": 1500.0000,

"allocatedAmount": 540.0000,

"account": "2161",

"includeInDistribution": true,

"coefficient": 1.0000,

"rowId": 2

}

]

}

Օրինակ 2. Հավելյալ ծախսերի բաշխում փաստաթղթի ստեղծում գումարի ձեռքով բաշխման եղանակով։

POST

Request

curl -X POST \

'https://api.armsoft.am/accountant/v1/documents/overheadexpenseallocation' \

-H 'accept: text/plain' \

-H 'Accept-Language: hy-AM' \

-H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \

-H 'Content-Type: application/json' \

-d '{

"baseDocument": "42e8b6ab-b99b-4c09-828e-029f5304ee39",

"supplierCode": "00000000000001",

"supplierAccount": "52131",

"prepaymentAccount": "2242",

"vatAccount": "22611",

"overheadExpenseType": "1",

"vatCalculationType": "1",

"includeVATInCost": true,

"vatInclusionMethod": "1",

"allowEditList": true,

"distributionType": "2",

"distributionBase": "1",

"amount": 900,

"materialsList": [

{

"code": "0",

"allocatedAmount": 500,

"includeInDistribution": true,

"rowId": 0

{

"code": "10001",

"allocatedAmount": 400,

"includeInDistribution": true,

"rowId": 1

}

]

Response body (201 Created)

{

"isn": "1f7ca1c9-72a2-47c3-8722-d4c7de071873",

"date": "2026-08-19",

"documentNumber": "string25",

"state": 2,

"baseDocument": "42e8b6ab-b99b-4c09-828e-029f5304ee39",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"previousDayExchangeRate": false,

"supplierCode": "00000000000001",

"supplierAccount": "52131",

"prepaymentAccount": "2242",

"vatAccount": "22611",

"analytic1": "",

"analytic2": "",

"taxExportType": "",

"purchaseDocumentNumber": "",

"comment": "",

"overheadExpenseType": "1",

"vatCalculationType": "1",

"includeVATInCost": true,

"vatInclusionMethod": "1",

"storage": "01",

"allowEditList": true,

"distributionType": "2",

"distributionBase": "1",

"amount": 500.0000,

"vatAmount": 100.0000,

"materialsList": [

{

"id": 100038,

"code": "0",

"name": "Chicken",

"unitAbbreviation": "հատ",

"quantity": 1.0000,

"inputOrderAmount": 200.0000,

"allocatedAmount": 500.0000,

"account": "2111",

"includeInDistribution": true,

"coefficient": 266.0000,

"rowId": 0

{

"id": 100000,

"code": "10001",

"name": "Իտալական մանկական կոշիկ",

"unitAbbreviation": "հատ",

"quantity": 2.0000,

"inputOrderAmount": 800.0000,

"allocatedAmount": 0.0000,

"account": "2161",

"includeInDistribution": false,

"coefficient": 1.0000,

"rowId": 1

{

"id": 100001,

"code": "10002",

"name": "Կանացի կոշիկ",

"unitAbbreviation": "հատ",

"quantity": 3.0000,

"inputOrderAmount": 1500.0000,

"allocatedAmount": 0.0000,

"account": "2161",

"includeInDistribution": false,

"coefficient": 1.0000,

"rowId": 2

}

]

}

Օրինակ 3. Նշված isn-ով Հավելյալ ծախսերի բաշխում փաստաթղթի ստացում

GET

Request

curl -X GET \

'https://api.armsoft.am/accountant/v1/documents/overheadexpenseallocation/1f7ca1c9-72a2-47c3-8722-d4c7de071873' \

-H 'accept: */*' \

-H 'Accept-Language: hy-AM' \

-H 'apiKey: %}uPbv>T0xZ}3beLxR{1'

Response body (200 OK)

{

"isn": "1f7ca1c9-72a2-47c3-8722-d4c7de071873",

"date": "2026-08-19",

"documentNumber": "string25",

"state": 2,

"baseDocument": "42e8b6ab-b99b-4c09-828e-029f5304ee39",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"previousDayExchangeRate": false,

"supplierCode": "00000000000001",

"supplierAccount": "52131",

"prepaymentAccount": "2242",

"vatAccount": "22611",

"analytic1": "",

"analytic2": "",

"taxExportType": "",

"purchaseDocumentNumber": "",

"comment": "",

"overheadExpenseType": "1",

"vatCalculationType": "1",

"includeVATInCost": true,

"vatInclusionMethod": "1",

"storage": "01",

"allowEditList": true,

"distributionType": "2",

"distributionBase": "1",

"amount": 500.0000,

"vatAmount": 100.0000,

"materialsList": [

{

"id": 100038,

"code": "0",

"name": "Chicken",

"unitAbbreviation": "հատ",

"quantity": 1.0000,

"inputOrderAmount": 200.0000,

"allocatedAmount": 500.0000,

"account": "2111",

"includeInDistribution": true,

"coefficient": 266.0000,

"rowId": 0

{

"id": 100000,

"code": "10001",

"name": "Իտալական մանկական կոշիկ",

"unitAbbreviation": "հատ",

"quantity": 2.0000,

"inputOrderAmount": 800.0000,

"allocatedAmount": 0.0000,

"account": "2161",

"includeInDistribution": false,

"coefficient": 1.0000,

"rowId": 1

{

"id": 100001,

"code": "10002",

"name": "Կանացի կոշիկ",

"unitAbbreviation": "հատ",

"quantity": 3.0000,

"inputOrderAmount": 1500.0000,

"allocatedAmount": 0.0000,

"account": "2161",

"includeInDistribution": false,

"coefficient": 1.0000,

"rowId": 2

}

]

}

Օրինակ 4. Նշված isn-ով Հավելյալ ծախսերի բաշխում փաստաթղթի դաշտերի խմբագրում

PUT

Request

curl -X PUT \

'https://api.armsoft.am/accountant/v1/documents/overheadexpenseallocation/1f7ca1c9-72a2-47c3-8722-d4c7de071873' \

-H 'accept: text/plain' \

-H 'Accept-Language: hy-AM' \

-H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \

-H 'Content-Type: application/json' \

-d '{

"isn": "1f7ca1c9-72a2-47c3-8722-d4c7de071873",

"date": "2026-08-19",

"documentNumber": "Փոփոխված",

"state": 2,

"baseDocument": "42e8b6ab-b99b-4c09-828e-029f5304ee39",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"previousDayExchangeRate": false,

"supplierCode": "00000000000001",

"supplierAccount": "52131",

"prepaymentAccount": "2242",

"vatAccount": "22611",

"analytic1": "",

"analytic2": "",

"taxExportType": "",

"purchaseDocumentNumber": "",

"comment": "",

"overheadExpenseType": "1",

"vatCalculationType": "1",

"includeVATInCost": true,

"vatInclusionMethod": "1",

"storage": "01",

"allowEditList": true,

"distributionType": "1",

"distributionBase": "1",

"amount": 1500

Response body (200 OK)

{

"isn": "1f7ca1c9-72a2-47c3-8722-d4c7de071873",

"date": "2026-08-19",

"documentNumber": "Փոփոխված",

"state": 2,

"baseDocument": "42e8b6ab-b99b-4c09-828e-029f5304ee39",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"previousDayExchangeRate": false,

"supplierCode": "00000000000001",

"supplierAccount": "52131",

"prepaymentAccount": "2242",

"vatAccount": "22611",

"analytic1": "",

"analytic2": "",

"taxExportType": "",

"purchaseDocumentNumber": "",

"comment": "",

"overheadExpenseType": "1",

"vatCalculationType": "1",

"includeVATInCost": true,

"vatInclusionMethod": "1",

"storage": "01",

"allowEditList": true,

"distributionType": "1",

"distributionBase": "1",

"amount": 1500.0000,

"vatAmount": 300.0000,

"materialsList": [

{

"id": 100038,

"code": "0",

"name": "Chicken",

"unitAbbreviation": "հատ",

"quantity": 1.0000,

"inputOrderAmount": 200.0000,

"allocatedAmount": 1500.0000,

"account": "2111",

"includeInDistribution": true,

"coefficient": 266.0000,

"rowId": 0

{

"id": 100000,

"code": "10001",

"name": "Իտալական մանկական կոշիկ",

"unitAbbreviation": "հատ",

"quantity": 2.0000,

"inputOrderAmount": 800.0000,

"allocatedAmount": 0.0000,

"account": "2161",

"includeInDistribution": false,

"coefficient": 1.0000,

"rowId": 1

{

"id": 100001,

"code": "10002",

"name": "Կանացի կոշիկ",

"unitAbbreviation": "հատ",

"quantity": 3.0000,

"inputOrderAmount": 1500.0000,

"allocatedAmount": 0.0000,

"account": "2161",

"includeInDistribution": false,

"coefficient": 1.0000,

"rowId": 2

}

]

}

Օրինակ 5. Նշված isn-ով Հավելյալ ծախսերի բաշխում փաստաթղթի հեռացում

DELETE