REST API (ամպային տարբերակ) > Փաստաթղթեր > Պահեստի մուտքի օրդեր (Մանրածախ)

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

URI	https://api.armsoft.am/trade/v1/documents/storageinputorderretail

URL Swagger

https://api.armsoft.am/trade/swagger/index.html#/StorageInputOrderRetail

GitHub

https://github.com/armsoft/trade-public-api-docs/blob/main/docs/api/documents/storageinputorderretail.md

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

-H 'apiKey: hJk:|^&K.f2(=0#biWc:'

Պահեստի մուտքի օրդեր (մանրածախ) օբյեկտի ատրիբուտներ (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	Optional	Փաստաթղթի վիճակ: Ընդունում է հետևյալ արժեքները. 0 - Գրանցված կամ սևագիր, 1 - Սևագիր, 2 - Գրանցված, 99 - Հեռացված: Եթե վիճակը չի փոխանցվում, փաստաթուղթը ավտոմատ գրանցված վիճակում է ուղարկվում։
baseDocumentISN	UUID	Optional	Հիմք փաստաթղթի նույնացուցիչ։
storage	String(5)	*Required Reference type	Պահեստի կոդ։
supplierCode	String(20)	Optional Reference type	Մատակարարի կոդ։
supplierContract	String(3)	*Conditional required Reference type	Մատակարարի պայմանագրի կոդ։ Պայմանագիրը չուղարկելու դեպքում ավտոմատ լրացվում է մատակարարի հիմնական պայմանագիրը։
purchaseDocumentNumber	String(20)	Optional	Մատակարարից ստացված ձեռքբերման փաստաթղթի համար:
purchaseDocumentDate	Date(YYYY-MM-DD)	Optional	Մատակարարից ստացված ձեռքբերման փաստաթղթի ամսաթիվ։
comment	String(255)	Optional	Մեկնաբանություն։
owner	String(20)	Optional Reference type	Փաստաթղթի հեղինակ։
currency	String(3)	Optional Reference type	Փաստաթղթի արժույթի կոդ:
currencyExchangeRate	Decimal	*Conditional required	Արժույթի փոխարժեք:
currencyExchangeBase	Decimal	*Conditional required	Արժույթի փոխարժեքի պատիկություն:
vatCalculationType	Enum	*Required	ԱԱՀ-ի հաշվարկի ձև։ Ընդունում է հետևյալ արժեքները. 1 - ԱԱՀ-ով, 2 - ԱԱՀ-ն այդ թվում, 3 - Առանց ԱԱՀ, 4 - Զրոյական ԱԱՀ, 5 - ԱԱՀ-ն այդ թվում 16.67 %: Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթների արժեքը։
includeVATInCost	Boolean	Optional	True արժեքի դեպքում ԱԱՀ-ն ներառվում է ինքնարժեքի մեջ։
priceType	String(2)	Optional Reference type	Նշվում է, թե ապրանքները մուտքագրելիս համակարգն ինչ տեսակի գներ առաջարկի։
discountPercent	Decimal	Optional	Զեղչի %:
vatAmount	Decimal	Read only	ԱԱՀ-ի գումար: ԱԱՀ-ի գումարը ավտոմատ հաշվարկվում է ապրանքի վրա նշված ԱԱՀ-ի հաշվարկման բնութագրիչի, ԱԱՀ-ի հաշվարկի ձևի և ընդհանուր գումարի հիման վրա։
totalAmount	Decimal	Read only	Ընդհանուր գումար: Ընդհանուր գումարը ավտոմատ է հաշվարկվում տրված գնի և քանակի հիման վրա։
letterOfAttorney	String(6)	Optional	Լիազորագրի համարը:
mediator	String(12)	Optional Reference type	Միջնորդ։
vehicle	String(9)	Optional	Ավտո բեռնարկղի համարը:
chiefAccountant	String(50)	Optional	Գլխավոր հաշվապահի Ա.Ա.Հ։
allowed	String(50)	Optional	Թույլատրողի Ա.Ա.Հ.։
accepted	String(50)	Optional	Նյութական պատասխանատու անձը։
productsList [0..n]	Array	*Required	Ապրանքների անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի ապրանքի առնվազն մեկ տող։

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

Անվանում	Տեսակ	Կիրառումը	Նկարագրություն
id	Integer	System defined	Ապրանքի ներքին նույնացուցիչ։
code	String(20)	*Required Reference type	Ապրանքի կոդ։
name	String(200)	Read only	Ապրանքի անվանում։
fullName	String(255)	Read only	Ապրանքի լրիվ անվանում։
unit	String(3)	*Required Reference type	Ապրանքի չափման միավորի կոդ։
unitAbbreviation	String(6)	Read only	Ապրանքի չափման միավորի հապավում։
quantity	Decimal	*Required	Ապրանքի քանակ։
price	Decimal	*Required	Ապրանքի ձեռքբերման արժեք։
discountPercent	Decimal	Optional	Զեղչի %:
discountedPrice	Decimal	Optional	Ապրանքի զեղչված գին։
amount	Decimal	Optional Read only	Գումար։ Ավտոմատ հաշվարկվում է գնի և քանակի հիման վրա։ Եթե տվել ենք նաև զեղչված գինը, ապա գումարը հաշվարկվում է զեղչված գնի և քանակի հիման վրա։ Ընդունում է նաև մեր տված արժեքը, բայց այս դեպքում անհրաժեշտ է ուշադիր լինել , որ այն բավարարի վերևում նշված հավասարմանը։
description	String	Optional	Ապրանքի նկարագրություն։
vat	Boolean	Optional	ԱԱՀ-ի հաշվարկի բնութագրիչ։ Եթե չենք տալիս այս դաշտը, ավտոմատ վերցնում է ապրանքներ և ծառայությունների տեղեկատուից։
expirationDate	Date(YYYY-MM-DD)	Optional	Օգտագործման ժամկետ։
country	String(3)	Optional Reference type	Երկրի կոդ։
producer	String(4)	Optional Reference type	Արտադրողի կոդ։
property1	String(50)	Optional Reference type	Ապրանքը բնութագրող հատկություն 1-ի կոդ։
property2	String(50)	Optional Reference type	Ապրանքը բնութագրող հատկություն 1-ի կոդ։
rowNumber	Integer	System defined	Տողի համար։
rowId	Integer	System defined	Տողի ներքին նույնացուցիչ։
addedValuePercent	Decimal	Optional	Հավելագնի %:
salePrice	Decimal	Optional	Ապրանքի վաճառքի գին։
saleAmount	Decimal	Optional	Ապրանքի վաճառքի գումար։

GitHub

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

Օրինակ 1. Պահեստի մուտքի օրդեր (Մանրածախ) փաստաթղթի ստեղծում (պարտադիր դաշտերով)

POST

Request

curl -X POST \

'https://api.armsoft.am/trade/v1/documents/storageinputorderretail' \

-H 'accept: text/plain' \

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

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

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

-d '{

"storage": "00",

"productsList": [

{

"code": "1001",

"quantity": 100,

"price": 64000

]

Response body (201 Created)

{

"isn": "303d94d0-0cce-4d79-ad0a-b27c36ed56c2",

"date": "2026-03-24",

"documentNumber": "ՊՄՄ-006",

"state": 2,

"baseDocumentISN": "00000000-0000-0000-0000-000000000000",

"storage": "00",

"supplierCode": "",

"supplierContract": "",

"purchaseDocumentNumber": "",

"comment": "",

"owner": "testuser@testmail.am",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"vatCalculationType": "1",

"includeVATInCost": false,

"priceType": "",

"discountPercent": 0,

"vatAmount": 1280000.0000,

"totalAmount": 7680000.0000,

"letterOfAttorney": "",

"mediator": "",

"vehicle": "",

"chiefAccountant": "",

"allowed": "",

"accepted": "",

"productsList": [

{

"id": 100000,

"code": "1001",

"name": "Հեռուստացույց",

"fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"unit": "001",

"unitAbbreviation": "հատ",

"quantity": 100.0000,

"price": 64000.0000,

"discountPercent": 0.0000,

"discountedPrice": 64000.0000,

"amount": 6400000.0000,

"addedValuePercent": 0.0000,

"salePrice": 0.0000,

"saleAmount": 0.0000,

"description": "",

"vat": true,

"country": "",

"producer": "",

"property1": "",

"property2": "",

"rowNumber": 0,

"rowId": 0

}

]

}

Օրինակ 2. Պահեստի մուտքի օրդեր (Մանրածախ) փաստաթղթի ստեղծում (լրացուցիչ դաշտերով)

POST

Request

curl -X POST \

'https://api.armsoft.am/trade/v1/documents/storageinputorderretail' \

-H 'accept: text/plain' \

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

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

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

-d '{

"state": 1,

"storage": "00",

"supplierCode": "1001",

"vatCalculationType": "1",

"includeVATInCost": true,

"productsList": [

{

"code": "1001",

"unit": "001",

"quantity": 1,

"price": 200000,

"discountedPrice": 150000,

"amount": 150000,

"salePrice": 250000

"saleAmount":250000

{

"code": "1002",

"unit": "001",

"quantity": 2,

"price": 160000,

"amount": 320000,

"vat": false,

"salePrice": 200000,

"saleAmount": 400000

}

]

Response body (201 Created)

{ "isn": "089a8688-921c-4cf8-8262-b7252700a4a9",

"date": "2026-02-18",

"documentNumber": "ՊՄՄ-005",

"state": 1,

"baseDocumentISN": "00000000-0000-0000-0000-000000000000",

"storage": "00",

"supplierCode": "1001",

"supplierContract": "001",

"purchaseDocumentNumber": "",

"comment": "",

"owner": "testuser@testmail.am",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"vatCalculationType": "1",

"includeVATInCost": true,

"priceType": "",

"discountPercent": 0,

"vatAmount": 30000.0000,

"totalAmount": 500000.0000,

"letterOfAttorney": "",

"mediator": "",

"vehicle": "",

"chiefAccountant": "",

"allowed": "",

"accepted": "",

"productsList": [

{

"id": 100000,

"code": "1001",

"name": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"unit": "001",

"unitAbbreviation": "հատ",

"quantity": 1.0000,

"price": 200000.0000,

"discountPercent": 25.0000,

"discountedPrice": 150000.0000,

"amount": 150000.0000,

"description": "",

"vat": true,

"country": "",

"producer": "",

"property1": "",

"property2": "",

"rowNumber": 0,

"rowId": 0

"addedValuePercent": 0.0000,

"salePrice": 250000.0000,

"saleAmount": 250000.0000

{

"id": 100001,

"code": "1002",

"name": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

"fullName": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

"unit": "001",

"unitAbbreviation": "հատ",

"quantity": 2.0000,

"price": 160000.0000,

"discountPercent": 0.0000,

"discountedPrice": 160000.0000,

"amount": 320000.0000,

"description": "",

"vat": false,

"country": "",

"producer": "",

"property1": "",

"property2": "",

"rowNumber": 1,

"rowId": 1,

"addedValuePercent": 0.0000,

"salePrice": 200000.0000,

"saleAmount": 400000.0000,

}

]

}

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

GET

Request

curl -X GET \

'https://api.armsoft.am/trade/v1/documents/storageinputorderretail/089a8688-921c-4cf8-8262-b7252700a4a9' \

-H 'accept: */*' \

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

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

Response body (200 OK)

{"isn": "089a8688-921c-4cf8-8262-b7252700a4a9",

"date": "2026-02-18",

"documentNumber": "ՊՄՄ-005",

"state": 1,

"baseDocumentISN": "00000000-0000-0000-0000-000000000000",

"storage": "00",

"supplierCode": "1001",

"supplierContract": "001",

"purchaseDocumentNumber": "",

"comment": "",

"owner": "testuser@testmail.am",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"vatCalculationType": "1",

"includeVATInCost": true,

"priceType": "",

"discountPercent": 0,

"vatAmount": 30000.0000,

"totalAmount": 500000.0000,

"letterOfAttorney": "",

"mediator": "",

"vehicle": "",

"chiefAccountant": "",

"allowed": "",

"accepted": "",

"productsList": [

{

"id": 100000,

"code": "1001",

"name": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"unit": "001",

"unitAbbreviation": "հատ",

"quantity": 1.0000,

"price": 200000.0000,

"discountPercent": 25.0000,

"discountedPrice": 150000.0000,

"amount": 150000.0000,

"description": "",

"vat": true,

"country": "",

"producer": "",

"property1": "",

"property2": "",

"rowNumber": 0,

"rowId": 0,

"addedValuePercent": 0.0000,

"salePrice": 250000.0000,

"saleAmount": 250000.0000,

{

"id": 100001,

"code": "1002",

"name": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

"fullName": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

"unit": "001",

"unitAbbreviation": "հատ",

"quantity": 2.0000,

"price": 160000.0000,

"discountPercent": 0.0000,

"discountedPrice": 160000.0000,

"amount": 320000.0000,

"description": "",

"vat": false,

"country": "",

"producer": "",

"property1": "",

"property2": "",

"rowNumber": 1,

"rowId": 1

"addedValuePercent": 0.0000,

"salePrice": 200000.0000,

"saleAmount": 400000.0000,

}

]

}

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

PUT

Request

curl -X PUT \

'https://api.armsoft.am/trade/v1/documents/storageinputorderretail/089a8688-921c-4cf8-8262-b7252700a4a9' \

-H 'accept: text/plain' \

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

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

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

-d '{ "isn": "089a8688-921c-4cf8-8262-b7252700a4a9",

"date": "2026-02-18",

"documentNumber": "ՊՄՄ-005",

"state": 1,

"baseDocumentISN": "00000000-0000-0000-0000-000000000000",

"storage": "00",

"supplierCode": "1001",

"supplierContract": "001",

"purchaseDocumentNumber": "",

"comment": "",

"owner": "testuser@testmail.am",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"vatCalculationType": "1",

"includeVATInCost": true,

"priceType": "",

"discountPercent": 0,

"vatAmount": 30000.0000,

"totalAmount": 500000.0000,

"letterOfAttorney": "",

"mediator": "",

"vehicle": "",

"chiefAccountant": "",

"allowed": "001",

"accepted": "",

"productsList": [

{

"id": 100000,

"code": "1001",

"name": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"unit": "001",

"unitAbbreviation": "հատ",

"quantity": 1.0000,

"price": 200000.0000,

"discountPercent": 25.0000,

"discountedPrice": 150000.0000,

"amount": 150000.0000,

"description": "",

"vat": true,

"country": "",

"producer": "",

"property1": "",

"property2": "",

"rowNumber": 0,

"rowId": 0,

"addedValuePercent": 0.0000,

"salePrice": 300000.0000,

"saleAmount": 300000.0000

{

"id": 100001,

"code": "1002",

"name": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

"fullName": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

"unit": "001",

"unitAbbreviation": "հատ",

"quantity": 2.0000,

"price": 160000.0000,

"discountPercent": 0.0000,

"discountedPrice": 160000.0000,

"amount": 320000.0000,

"description": "",

"vat": false,

"country": "",

"producer": "",

"property1": "",

"property2": "",

"rowNumber": 1,

"rowId": 1,

"addedValuePercent": 0.0000,

"salePrice": 250000.0000,

"saleAmount": 500000.0000

}

]

Response body (200 OK)

{ "isn": "089a8688-921c-4cf8-8262-b7252700a4a9",

"date": "2026-02-18",

"documentNumber": "ՊՄՄ-005",

"state": 1,

"baseDocumentISN": "00000000-0000-0000-0000-000000000000",

"storage": "00",

"supplierCode": "1001",

"supplierContract": "001",

"purchaseDocumentNumber": "",

"comment": "",

"owner": "testuser@testmail.am",

"currency": "AMD",

"currencyExchangeRate": 1.0000,

"currencyExchangeBase": 1.0000,

"vatCalculationType": "1",

"includeVATInCost": true,

"priceType": "",

"discountPercent": 0,

"vatAmount": 30000.0000,

"totalAmount": 500000.0000,

"letterOfAttorney": "",

"mediator": "",

"vehicle": "",

"chiefAccountant": "",

"allowed": "001",

"accepted": "",

"productsList": [

{

"id": 100000,

"code": "1001",

"name": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

"unit": "001",

"unitAbbreviation": "հատ",

"quantity": 1.0000,

"price": 200000.0000,

"discountPercent": 25.0000,

"discountedPrice": 150000.0000,

"amount": 150000.0000,

"description": "",

"vat": true,

"country": "",

"producer": "",

"property1": "",

"property2": "",

"rowNumber": 0,

"rowId": 0,

"addedValuePercent": 0.0000,

"salePrice": 300000.0000,

"saleAmount": 300000.0000,

{

"id": 100001,

"code": "1002",

"name": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

"fullName": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

"unit": "001",

"unitAbbreviation": "հատ",

"quantity": 2.0000,

"price": 160000.0000,

"discountPercent": 0.0000,

"discountedPrice": 160000.0000,

"amount": 320000.0000,

"description": "",

"vat": false,

"country": "",

"producer": "",

"property1": "",

"property2": "",

"rowNumber": 1,

"rowId": 1,

"addedValuePercent": 0.0000,

"salePrice": 250000.0000,

"saleAmount": 500000.0000,

}

]

}

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

DELETE