Պահեստի մուտքի օրդեր

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

Պահեստի մուտքի օրդեր

 Previous pageReturn to chapter overviewNext page

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

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

URI

https://api.armsoft.am/trade/v1/documents/storageinputorder

URL Swagger

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

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

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

 

 

Պահեստի մուտքի օրդեր օբյեկտի ատրիբուտներ (Object Attributes)

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

Անվանում

Տեսակ

Կիրառումը

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

isn

UUID

api_optional

api_required_upd

api_system defined

Փաստաթղթի նույնացուցիչ: Պարտադիր է GET, PUT, DELETE հարցումների դեպքում։ POST հարցման ժամանակ UUID-ը չի փոխանցվում, սերվերը այն ավտոմատ գեներացնում է և վերադարձնում պատասխանում։

date

Date(YYYY-MM-DD)

api_required

Փաստաթղթի ամսաթիվ: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը:

documentNumber

String(12)

api_required

Փաստաթղթի համար: Եթե համարը չի փոխանցվում, ապա գրանցվում է վերջին համարին ավելացնելով 1:

state

Enum

api_optional

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

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

1 - Սևագիր,

2 - Գրանցված,

3 - Հեռացված:

baseDocumentISN

UUID

api_optional

Հիմք փաստաթղթի նույնացուցիչ։

storage

String(5)

api_required

Պահեստի կոդ։

supplierCode

String(20)

api_optional

Մատակարարի կոդ։

supplierContract

String(3)

api_conditionally required

Մատակարարի պայմանագրի կոդ։ Պայմանագիրը չուղարկելու դեպքում ավտոմատ լրացվում է մատակարարի հիմնական պայմանագիրը։

purchaseDocumentNumber

String(20)

api_optional

Մատակարարից ստացված ձեռքբերման փաստաթղթի համար:

purchaseDocumentDate

Date(YYYY-MM-DD)

api_optional

Մատակարարից ստացված ձեռքբերման փաստաթղթի ամսաթիվ։

comment

String(255)

api_optional

Մեկնաբանություն։

owner

String(50)

api_optional

Փաստաթղթի հեղինակ։

currency

String(3)

api_optional

Փաստաթղթի արժույթի կոդ:

currencyExchangeRate

Decimal

api_conditionally required

Արժույթի փոխարժեք:

currencyExchangeBase

Decimal

api_conditionally required

Արժույթի փոխարժեքի պատիկություն:

vatCalculationType

Enum

api_required

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

1 - ԱԱՀ-ով,

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

3 - Առանց ԱԱՀ,

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

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

Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթների արժեքը։

includeVATInCost

Boolean

api_optional

True արժեքի դեպքում ԱԱՀ-ն ներառվում է ինքնարժեքի մեջ։

priceType

String(2)

api_optional

Նշվում է, թե ապրանքները մուտքագրելիս համակարգն ինչ տեսակի գներ առաջարկի։

discountPercent

Decimal

api_optional

Զեղչի %:

vatAmount

Decimal

api_read_only

ԱԱՀ-ի գումար: ԱԱՀ-ի գումարը ավտոմատ հաշվարկվում է ապրանքի վրա նշված  ԱԱՀ-ի հաշվարկման բնութագրիչի, ԱԱՀ-ի հաշվարկի ձևի և ընդհանուր գումարի հիման վրա։

totalAmount

Decimal

api_read_only

Ընդհանուր գումար: Ընդհանուր գումարը ավտոմատ է հաշվարկվում տրված գնի և քանակի հիման վրա։

letterOfAttorney

String(6)

api_optional

Լիազորագրի համարը:

mediator

String(12)

api_optional

Միջնորդ։

vehicle

String(9)

api_optional

Ավտո բեռնարկղի համարը:

chiefAccount

String(100)

api_optional

Գլխավոր հաշվապահի Ա.Ա.Հ։

allowed

String(50)

api_optional

Թույլատրողի Ա.Ա.Հ.։

accepted

String(50)

api_optional

Նյութական պատասխանատու անձը։

productsList [0..n]

Array

api_required

Ապրանքների  անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի ապրանքի  առնվազն մեկ տող։

 

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

Անվանում

Տեսակ

Կիրառումը

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

id

Integer

api_system defined

Ապրանքի ներքին նույնացուցիչ։

code

String(20)

api_required

Ապրանքի կոդ։

name

String(200)

api_read_only

Ապրանքի անվանում։

fullName

String(255)

api_read_only

Ապրանքի լրիվ անվանում։

unit

String(3)

api_required

Ապրանքի չափման միավորի կոդ։

unitAbbreviation

String(6)

api_read_only

Ապրանքի չափման միավորի հապավում։

quantity

Decimal

api_required

Ապրանքի քանակ։

price

Decimal

api_required

Ապրանքի ձեռքբերման արժեք։

discountPercent

Decimal

api_optional

Զեղչի %:

discountedPrice

Decimal

api_optional

Ապրանքի զեղչված գին։

amount

Decimal

api_optional

api_read_only

Գումար։ Ավտոմատ հաշվարկվում է գնի և քանակի հիման վրա։ Եթե տվել ենք նաև զեղչված գինը, ապա գումարը հաշվարկվում է զեղչված գնի և քանակի հիման վրա։ Ընդունում է նաև մեր տված արժեքը, բայց այս դեպքում անհրաժեշտ է ուշադիր լինել , որ այն բավարարի վերևում նշված հավասարմանը։

description

String(50)

api_optional

Ապրանքի նկարագրություն։

vat

Boolean

api_optional

ԱԱՀ-ի հաշվարկի բնութագրիչ։ Եթե չենք տալիս այս դաշտը, ավտոմատ վերցնում է ապրանքներ և ծառայությունների տեղեկատուից։

expirationDate

Date(YYYY-MM-DD)

api_optional

Օգտագործման ժամկետ։

country

String(3)

api_optional

Երկրի կոդ։

producer

String(4)

api_optional

Արտադրողի կոդ։

property1

String(50)

api_optional

Ապրանքը բնութագրող հատկություն 1-ի կոդ։

property2

String(50)

api_optional

Ապրանքը բնութագրող հատկություն 1-ի կոդ։

rowNumber

Integer

api_system defined

Տողի համար։

rowId

Integer

api_system defined

Տողի ներքին նույնացուցիչ։

 

POST

Request

 

curl -X POST \

 "https://api.armsoft.am/trade/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": "00",

"productsList": [

   {

     "code": "1001",

     "unit": "001",

     "quantity": 1,

     "price": 200000,

     "discountedPrice": 150000,

     "amount": 150000

   }

 ]

}'

 

Response body (201 Created)

 

{"isn": "996f6fa8-b41f-4371-9852-cd9eb76eb409",

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

   "documentNumber": "ՊՄՕ-015",

   "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": 30000.0000,

   "totalAmount": 180000.0000,

   "letterOfAttorney": "",

   "mediator": "",

   "vehicle": "",

   "chiefAccount": "",

   "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

       }

   ]

}

 

POST

Request

 

curl -X POST \

 "https://api.armsoft.am/trade/v1/documents/storageinputorder" \

 -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

    },

   {

     "code": "1002",

     "unit": "001",

     "quantity": 2,

     "price": 160000,

     "amount": 320000,

     "vat": false

   }

 ]

}'

 

Response body (201 Created)

 

{ "isn": "2eb0a60f-acbe-452e-9505-101160212220",

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

   "documentNumber": "ՊՄՕ-017",

   "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": "",

   "chiefAccount": "",

   "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

       },

       {

           "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

       }

   ]

}

 

GET
hmtoggle_arrow0/v1/documents/storageinputorder/{isn}                                                                            

Request

 

curl -X GET \

 "https://api.armsoft.am/trade/v1/documents/storageinputorder/2eb0a60f-acbe-452e-9505-101160212220" \

 -H "accept: */*" \

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

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

 

Response body  (200 OK)

 

{"isn": "2eb0a60f-acbe-452e-9505-101160212220",

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

   "documentNumber": "ՊՄՕ-017",

   "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": "",

   "chiefAccount": "",

   "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

       },

       {

           "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

       }

   ]

}

 

PUT

Request

 

curl -X PUT \

 "https://smetest.armsoft.am/tradetest/v1/documents/storageinputorder/2eb0a60f-acbe-452e-9505-101160212220" \

 -H "accept: text/plain" \

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

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

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

 -d '{

   "isn": "2eb0a60f-acbe-452e-9505-101160212220",

   "date": "2026-02-17",

   "documentNumber": "ՊՄՕ-017",

   "state": 2,

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

   "storage": "00",

   "supplierCode": "1002",

   "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": "",

   "chiefAccount": "",

   "allowed": "",

   "accepted": "",

   "productsList": [

       {

           "id": 100000,

           "code": "1001",

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

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

           "unit": "001",

           "unitAbbreviation": "հատ",

           "quantity": 1.0000,

           "price": 25000.0000,

           "discountPercent": 25.0000,

           "discountedPrice": 12000.0000,

           "amount": 12000,

           "description": "",

           "vat": true,

           "country": "",

           "producer": "",

           "property1": "",

           "property2": "",

           "rowNumber": 0,

           "rowId": 0

       },

       {

           "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

       }

   ]

}'

 

Response body  (200 OK)

 

{    "isn": "2eb0a60f-acbe-452e-9505-101160212220",

   "date": "2026-02-17",

   "documentNumber": "ՊՄՕ-017",

   "state": 2,

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

   "storage": "00",

   "supplierCode": "1002",

   "supplierContract": "001",

   "purchaseDocumentNumber": "",

   "comment": "",

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

   "currency": "AMD",

   "currencyExchangeRate": 1.0000,

   "currencyExchangeBase": 1.0000,

   "vatCalculationType": "1",

   "includeVATInCost": true,

   "priceType": "",

   "discountPercent": 0,

   "vatAmount": 2400.0000,

   "totalAmount": 334400.0000,

   "letterOfAttorney": "",

   "mediator": "",

   "vehicle": "",

   "chiefAccount": "",

   "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

       },

       {

           "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

       }

   ]

}

 

DELETE

Request

 

curl -X DELETE \

 "https://smetest.armsoft.am/tradetest/v1/documents/storageinputorder/2eb0a60f-acbe-452e-9505-101160212220" \

 -H "accept: */*" \

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

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

 

Response body  (200 OK)