REST API (ամպային տարբերակ) > Փաստաթղթեր

API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) Պահեստի մուտքի օրդեր փաստաթուղթը:

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

URL Swagger

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

Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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 - Հեռացված: Եթե վիճակը չի փոխանցվում, փաստաթուղթը ավտոմատ գրանցված վիճակում է ուղարկվում։
storage	String(5)	*Required Reference type	Պահեստի կոդ։
currency	String(3)	*Required Reference type	Փաստաթղթի արժույթի կոդ: Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։
currencyExchangeRate	Decimal	*Conditional required	Արժույթի փոխարժեք: Պարտադիր է ուղարկել, եթե փաստաթուղթը արտարժույթով է։
currencyExchangeBase	Integer	*Conditional required	Արժույթի փոխարժեքի պատիկություն: Պարտադիր է ուղարկել, եթե փաստաթուղթը արտարժույթով է։
supplierCode	String(20)	Optional Reference type	Մատակարարի կոդ։
supplierName	String(50)	Optional	Մատակարարի անվանում։
supplierAccount	String(12)	Optional Reference type	Մատակարարի հաշիվ։
prepaymentAccount	String(12)	Optional Reference type	Տրված կանխավճարի հաշիվ։
analytic1	String(12)	Optional Reference type	Անալիտիկ խումբ 1-ի կոդ։
analytic2	String(12)	Optional Reference type	Անալիտիկ խումբ 2-ի կոդ։
taxExportType	Enum	Optional	Հաշվարկային փաստաթղթի դուրսգրման եղանակ։ Ընդունում է հետևյալ արժեքները․ 1- էլեկտրոնային, 2-թղթային:
purchaseDocumentNumber	String(12)	Optional	Մատակարարից ստացված ձեռքբերման փաստաթղթի համար։
purchaseDocumentDate	Date(YYYY-MM-DD)	Optional	Մատակարարից ստացված ձեռքբերման փաստաթղթի ամսաթիվ։
comment	String(255)	Optional	Մեկնաբանություն։
purchasingType	Enum	*Required	Նյութական արժեքների ձեռքբերման տեսակ։ Ընդունում է հետևյալ արժեքները․ 1 - Մատակարարից Հ/Ա-ով, 2 - Առհաշվից` միակողմանի գնման ակտով, 3 - Առհաշվից` երկկողմանի գնման ակտով, 4- Առանց հարկերի։
vatCalculationType	Enum	*Required	ԱԱՀ-ի հաշվարկի ձև։ Ընդունում է հետևյալ արժեքները. 1 - ԱԱՀ-ով, 2 - ԱԱՀ-ն այդ թվում, 3 - Առանց ԱԱՀ, 4 - Զրոյական ԱԱՀ, Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։
includeVATInCost	Boolean	Optional	ԱԱՀ-ն ինքնարժեքի մեջ ներառելու հայտանիշ։
vatInclusionMethod	Enum	*Conditional required	ԱԱՀ-ի արտացոլման ձև։ ընդունում է հետևյալ արժեքները․ 1 - Չարտացոլել ԱԱՀ-ն շրջանառության մեջ, 2 - Արտացոլել ԱԱՀ-ն շրջանառության մեջ։ Պարտադիր է ուղարկել, եթե ԱԱՀ-ն ինքնարժեքի մեջ ներառելու հայտանիշը True արժեքն ունի։
discountPercent	Decimal	Optional	Զեղչի %:
vatAmount	Decimal	*Required	Գումար ԱԱՀ։ Ավտոմատ հաշվարկվում է համակարգի կողմից։ Եթե արժեք ենք տալիս totalAmount-ին, ապա պարտադիր է դառնում նաև ուղարկել vatAmount-ը։
totalAmount	Decimal	*Required	Ընդհանուր գումար։ Ավտոմատ հաշվարկվում է համակարգի կողմից։
supplierLegalAddress	String(255)	Optional	Մատակարարի իրավաբանական հասցե։
supplierBusinessAddress	String(255)	Optional	Մատակարարի գործունեության հասցե։
supplierSettlementAccount	String(12)	Optional	Մատակարարի հաշվարկային հաշիվ։
supplierTaxCode	String(20)	Optional	Մատակարարի ՀՎՀՀ։
supplierManagerPosition	String(50)	Optional	Մատակարարի ղեկավարի պաշտոն։
supplierManagerName	String(50)	Optional	Մատակարարի ղեկավարի Ա․Ա․Հ․։
supplierAccountantPosition	String(50)	Optional	Մատակարարի հաշվապահի պաշտոն։
supplierAccountantName	String(50)	Optional	Մատակարարի հաշվապահի Ա․Ա․Հ․։
letterOfAttorney	String(20)	Optional	Լիազորագրի համար։
mediator	String(50)	Optional	Միջնորդ։
vehicle	String(20)	Optional	Ավտո բեռնարկղի համար։
chiefAccount	String(100)	Optional	Գլխավոր հաշվապահի Ա․Ա․Հ․։
allowed	String(50)	Optional	Թույլատրողի Ա․Ա․Հ․։
accepted	String(50)	Optional	Նյութական պատասխանատու անձը։
transportationDocumentNumber	String(24)	Optional	Տրանսպորտային փաստաթղթի համար։
transportationDocumentDate	Date(YYYY-MM-DD)	Optional	Տրանսպորտային փաստաթղթի ամսաթիվ։
itemList [0..n]	Array	*Required	Նյութական արժեքների անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի նյութական արժեքի առնվազն մեկ տող։

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

Անվանում	Տեսակ	Կիրառումը	Նկարագրություն
id	Integer	System defined	Նյութական արժեքի ներքին նույնացուցիչ։
code	String(20)	*Required Reference type	Նյութական արժեքի կոդ:
name	String(200)	Read only	Նյութական արժեքի անվանում:
unitAbbreviation	String(6)	Read only	Նյութական արժեքի չափման միավորի հապավում։
quantity	Decimal	*Required	Նյութական արժեքի քանակ։
price	Decimal	*Required	Նյութական արժեքի ձեռքբերման գին։
discountPercent	Decimal	Optional	Զեղչի %:
discountedPrice	Decimal	Optional	Նյութական արժեքի զեղչված ձեռքբերման գին։
amount	Decimal	*Required	Նյութական արժեքի ձեռքբերման գումար։
vat	Boolean	Optional	ԱԱՀ-ով հարկման հայտանիշ։ Եթե արժեք չենք տալիս, արժեքը վերցնում է տեղեկատուներից։
account	String(12)	*Required Reference type	Նյութական արժեքի հաշվառման հաշիվ։
cpaClassifier	String(12)	Optional Reference type	Նյութական արժեքի դասակարգման կոդը ըստ Արտաքին տնտեսական գործունեության ապրանքային Անվանացանկի (ԱՏԳ ԱԱ):
rowNumber	Integer	System defined	Տողի համար։
rowId	Integer	System defined	Տողի ներքին նույնացուցիչ։

Օրինակ 1. Պահեստի մուտքի օրդեր փաստաթղթի ստեղծում

POST

Request

curl -X POST \

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

-H 'accept: text/plain' \

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

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

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

-d '{

"storage": "01",

"purchasingType": "1",

"materialsList": [

{

"code": "10001",

"quantity": 100,

"price": 150,

"account": "2161"

}

]

Response body (201 Created)

{

"isn": "9e410e0d-8060-47a3-99c0-e7b6f32d53cc",

"date": "2026-03-18",

"documentNumber": "ՊՄ016",

"state": 2,

"storage": "01",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"supplierCode": "",

"supplierName": "",

"supplierAccount": "",

"prepaymentAccount": "",

"analytic1": "",

"analytic2": "",

"taxExportType": "",

"purchaseDocumentNumber": "",

"comment": "",

"purchasingType": "1",

"vatCalculationType": "1",

"includeVATInCost": false,

"vatInclusionMethod": "",

"discountPercent": 0,

"vatAmount": 3000.0000,

"totalAmount": 15000.0000,

"supplierLegalAddress": "",

"supplierBusinessAddress": "",

"supplierSettlementAccount": "",

"supplierTaxCode": "",

"supplierManagerPosition": "",

"supplierManagerName": "",

"supplierAccountantPosition": "",

"supplierAccountantName": "",

"letterOfAttorney": "",

"mediator": "",

"vehicle": "",

"chiefAccount": "",

"allowed": "",

"accepted": "",

"transportationDocumentNumber": "",

"materialsList": [

{

"id": 100000,

"code": "10001",

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

"unitAbbreviation": "հատ",

"quantity": 100.0000,

"price": 150.0000,

"discountPercent": 0.0000,

"discountedPrice": 150.0000,

"amount": 15000.0000,

"vat": true,

"account": "2161",

"cpaClassifier": "",

"rowNumber": 0,

"rowId": 0

}

]

}

Օրինակ 2. Նշված isn-ով Պահեստի մուտքի օրդեր փաստաթղթի ստացում

GET

Request

curl -X GET \

'https://api.armsoft.am/accountant/v1/documents/storageinputorder/9e410e0d-8060-47a3-99c0-e7b6f32d53cc' \

-H 'accept: */*' \

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

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

Response body (200 OK)

{

"isn": "9e410e0d-8060-47a3-99c0-e7b6f32d53cc",

"date": "2026-03-18",

"documentNumber": "ՊՄ016",

"state": 2,

"storage": "01",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"supplierCode": "",

"supplierName": "",

"supplierAccount": "",

"prepaymentAccount": "",

"analytic1": "",

"analytic2": "",

"taxExportType": "",

"purchaseDocumentNumber": "",

"comment": "",

"purchasingType": "1",

"vatCalculationType": "1",

"includeVATInCost": false,

"vatInclusionMethod": "",

"discountPercent": 0,

"vatAmount": 3000.0000,

"totalAmount": 15000.0000,

"supplierLegalAddress": "",

"supplierBusinessAddress": "",

"supplierSettlementAccount": "",

"supplierTaxCode": "",

"supplierManagerPosition": "",

"supplierManagerName": "",

"supplierAccountantPosition": "",

"supplierAccountantName": "",

"letterOfAttorney": "",

"mediator": "",

"vehicle": "",

"chiefAccount": "",

"allowed": "",

"accepted": "",

"transportationDocumentNumber": "",

"materialsList": [

{

"id": 100000,

"code": "10001",

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

"unitAbbreviation": "հատ",

"quantity": 100.0000,

"price": 150.0000,

"discountPercent": 0.0000,

"discountedPrice": 150.0000,

"amount": 15000.0000,

"vat": true,

"account": "2161",

"cpaClassifier": "",

"rowNumber": 0,

"rowId": 0

}

]

}

Օրինակ 3. Նշված isn-ով Պահեստի մուտքի օրդեր փաստաթղթի դաշտերի խմբագրում

PUT

Request

curl -X PUT \

'https://api.armsoft.am/accountant/v1/documents/invoice/10471e86-00a9-4d5d-b464-b06df78b20ed' \

-H 'accept: text/plain' \

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

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

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

-d '{

"isn": "10471e86-00a9-4d5d-b464-b06df78b20ed",

"date": "2026-03-11",

"documentNumber": "ՀԱ012",

"customer": "20003",

"currency": "AMD",

"exchangeRate": 1.0000,

"exchangeBase": 1.0000,

"state": 1,

"contract": "",

"customerAccount": "52111",

"receivedPrepaymentAccount": "",

"vatAccount": "",

"environmentalFeeAccount": "",

"analytic1": "",

"analytic2": "",

"bookNumber": "",

"bookPage": 0,

"bookLine": 0,

"taxExportType": "",

"taxInvoiceSeries": "",

"taxInvoiceNumber": "",

"comment": "",

"vatCalculationType": "1",

"dealType": "",

"storage": "",

"discountPercent": 20.0000,

"supplierBusinessAddress": "",

"supplierSettlementAccount": "",

"supplierManagerPosition": "",

"supplierManagerName": "",

"supplierAccountantPosition": "",

"supplierAccountantName": "",

"supplierAdditionalData": "",

"customerName": "",

"customerLegalAddress": "",

"customerBusinessAddress": "",

"customerSettlementAccount": "",

"customerTaxCode": "",

"customerManagerPosition": "",

"customerManagerName": "",

"customerAccountantPosition": "",

"customerAccountantName": "",

"stateRegisterNumber": "",

"idDocumentType": "",

"passportNumber": "",

"socialCardNumber": "",

"customerAdditionalData": "",

"shippingMethod": "",

"citizenOfRA": false,

"socialExpensesType": "",

"socialExpenseSocialCard": "",

"socialExpenseCitizenName": "",

"socialExpenseIdentityDocument": "",

"socialExpenseSerialNumber": "",

"additionalFullName": "",

"credentialNumber": "",

"baseECRCheckNumber": "",

"itemList": [

{

"type": "1",

"storage": "01",

"id": 100000,

"code": "10001",

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

"unitAbbreviation": "հատ",

"quantity": 1.0000,

"price": 2500.0000,

"environmentalFeePercent": 0.0000,

"environmentalFeeAmount": 0.0000,

"vat": true,

"dealType": " ",

"expenseAccount": "7112",

"incomeAccount": "61121",

"markingList": [],

"cpaClassifier": "",

"rowNumber": 0,

"rowId": 0

}

]

Response body (200 OK)

{

"isn": "10471e86-00a9-4d5d-b464-b06df78b20ed",

"date": "2026-03-11",

"documentNumber": "ՀԱ012",

"customer": "20003",

"currency": "AMD",

"exchangeRate": 1.0000,

"exchangeBase": 1.0000,

"state": 1,

"contract": "",

"customerAccount": "52111",

"receivedPrepaymentAccount": "",

"vatAccount": "",

"environmentalFeeAccount": "",

"analytic1": "",

"analytic2": "",

"bookNumber": "",

"bookPage": 0,

"bookLine": 0,

"taxExportType": "",

"taxInvoiceSeries": "",

"taxInvoiceNumber": "",

"comment": "",

"vatCalculationType": "1",

"dealType": "",

"storage": "",

"discountPercent": 20.0000,

"vatAmount": 400.0000,

"totalAmount": 2400.0000,

"supplierBusinessAddress": "",

"supplierSettlementAccount": "",

"supplierManagerPosition": "",

"supplierManagerName": "",

"supplierAccountantPosition": "",

"supplierAccountantName": "",

"supplierAdditionalData": "",

"customerName": "",

"customerLegalAddress": "",

"customerBusinessAddress": "",

"customerSettlementAccount": "",

"customerTaxCode": "",

"customerManagerPosition": "",

"customerManagerName": "",

"customerAccountantPosition": "",

"customerAccountantName": "",

"stateRegisterNumber": "",

"idDocumentType": "",

"passportNumber": "",

"socialCardNumber": "",

"customerAdditionalData": "",

"shippingMethod": "",

"citizenOfRA": false,

"socialExpensesType": "",

"socialExpenseSocialCard": "",

"socialExpenseCitizenName": "",

"socialExpenseIdentityDocument": "",

"socialExpenseSerialNumber": "",

"additionalFullName": "",

"credentialNumber": "",

"baseECRCheckNumber": "",

"itemList": [

{

"type": "1",

"storage": "01",

"id": 100000,

"code": "10001",

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

"unitAbbreviation": "հատ",

"quantity": 1.0000,

"price": 2500.0000,

"discountPercent": 20.0000,

"discountedPrice": 2000.0000,

"amount": 2000.0000,

"environmentalFeePercent": 0.0000,

"environmentalFeeAmount": 0.0000,

"vat": true,

"dealType": " ",

"expenseAccount": "7112",

"incomeAccount": "61121",

"markingList": [],

"cpaClassifier": "",

"rowNumber": 0,

"rowId": 0

}

]

}

Օրինակ 4. Նշված isn-ով Պահեստի մուտքի օրդեր փաստաթղթի հեռացում

DELETE