API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) Պահեստի մուտքի օրդեր (մանրածախ) փաստաթուղթը։
URI |
https://api.armsoft.am/trade/v1/documents/storageinputorderretail |
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ API բանալու օգտագործմամբ։ Այն անհրաժեշտ է տեղադրել հարցման գլխագրի apiKey դաշտում. API բանալին ստանալու համար անհրաժեշտ է կատարել API գաղտնի բանալու ստացում էջում նկարագրված քայլերը:
-H 'apiKey: hJk:|^&K.f2(=0#biWc:' |
Պահեստի մուտքի օրդեր (մանրածախ) օբյեկտի ատրիբուտներ (Object Attributes)
Ստորև ներկայացված է օբյեկտի ատրիբուտների նկարագրությունը.
Անվանում |
Տեսակ |
Կիրառումը |
Նկարագրություն |
isn |
UUID |
|
Փաստաթղթի նույնացուցիչ: Պարտադիր է GET, PUT, DELETE հարցումների դեպքում։ POST հարցման ժամանակ UUID-ը չի փոխանցվում, սերվերը այն ավտոմատ գեներացնում է և վերադարձնում պատասխանում։ |
date |
Date(YYYY-MM-DD) |
Փաստաթղթի ամսաթիվ: Եթե ամսաթիվը չի փոխանցվում, ապա օգտագործվում է սերվերի ընթացիկ ամսաթիվը: |
|
documentNumber |
String(12) |
Փաստաթղթի համար: Եթե համարը չի փոխանցվում, ապա գրանցվում է վերջին համարին ավելացնելով 1: |
|
state |
Enum |
Փաստաթղթի վիճակ: Ընդունում է հետևյալ արժեքները. 0 - Գրանցված կամ սևագիր, 1 - Սևագիր, 2 - Գրանցված, 3 - Հեռացված: |
|
baseDocumentISN |
UUID |
Հիմք փաստաթղթի նույնացուցիչ։ |
|
storage |
String(5) |
Պահեստի կոդ։ |
|
supplierCode |
String(20) |
Մատակարարի կոդ։ |
|
supplierContract |
String(3) |
Մատակարարի պայմանագրի կոդ։ Պայմանագիրը չուղարկելու դեպքում ավտոմատ լրացվում է մատակարարի հիմնական պայմանագիրը։ |
|
purchaseDocumentNumber |
String(20) |
Մատակարարից ստացված ձեռքբերման փաստաթղթի համար: |
|
purchaseDocumentDate |
Date(YYYY-MM-DD) |
Մատակարարից ստացված ձեռքբերման փաստաթղթի ամսաթիվ։ |
|
comment |
String(255) |
Մեկնաբանություն։ |
|
owner |
String(20) |
Փաստաթղթի հեղինակ։ |
|
currency |
String(3) |
Փաստաթղթի արժույթի կոդ: |
|
currencyExchangeRate |
Decimal |
Արժույթի փոխարժեք: |
|
currencyExchangeBase |
Decimal |
Արժույթի փոխարժեքի պատիկություն: |
|
vatCalculationType |
Enum |
ԱԱՀ-ի հաշվարկի ձև։ Ընդունում է հետևյալ արժեքները. 1 - ԱԱՀ-ով, 2 - ԱԱՀ-ն այդ թվում, 3 - Առանց ԱԱՀ, 4 - Զրոյական ԱԱՀ, 5 - ԱԱՀ-ն այդ թվում 16.67 % Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթների արժեքը։ |
|
includeVATInCost |
Boolean |
True արժեքի դեպքում ԱԱՀ-ն ներառվում է ինքնարժեքի մեջ։ |
|
priceType |
String(2) |
Նշվում է, թե ապրանքները մուտքագրելիս համակարգն ինչ տեսակի գներ առաջարկի։ |
|
discountPercent |
Decimal |
Զեղչի %: |
|
vatAmount |
Decimal |
ԱԱՀ-ի գումար: ԱԱՀ-ի գումարը ավտոմատ հաշվարկվում է ապրանքի վրա նշված ԱԱՀ-ի հաշվարկման բնութագրիչի, ԱԱՀ-ի հաշվարկի ձևի և ընդհանուր գումարի հիման վրա։ |
|
totalAmount |
Decimal |
Ընդհանուր գումար: Ընդհանուր գումարը ավտոմատ է հաշվարկվում տրված գնի և քանակի հիման վրա։ |
|
letterOfAttorney |
String(6) |
Լիազորագրի համարը: |
|
mediator |
String(12) |
Միջնորդ։ |
|
vehicle |
String(9) |
Ավտո բեռնարկղի համարը: |
|
chiefAccount |
String(50) |
Գլխավոր հաշվապահի Ա.Ա.Հ։ |
|
allowed |
String(50) |
Թույլատրողի Ա.Ա.Հ.։ |
|
accepted |
String(50) |
Նյութական պատասխանատու անձը։ |
|
productsList [0..n] |
Array |
Ապրանքների անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի ապրանքի առնվազն մեկ տող։ |
Անվանացուցակի տողի դաշտերը (itemList)
Անվանում |
Տեսակ |
Կիրառումը |
Նկարագրություն |
id |
Integer |
Ապրանքի ներքին նույնացուցիչ։ |
|
code |
String(20) |
Ապրանքի կոդ։ |
|
name |
String(200) |
Ապրանքի անվանում։ |
|
fullName |
String(255) |
Ապրանքի լրիվ անվանում։ |
|
unit |
String(3) |
Ապրանքի չափման միավորի կոդ։ |
|
unitAbbreviation |
String(6) |
Ապրանքի չափման միավորի հապավում։ |
|
quantity |
Decimal |
Ապրանքի քանակ։ |
|
price |
Decimal |
Ապրանքի ձեռքբերման արժեք։ |
|
discountPercent |
Decimal |
Զեղչի %: |
|
discountedPrice |
Decimal |
Ապրանքի զեղչված գին։ |
|
amount |
Decimal |
Գումար։ Ավտոմատ հաշվարկվում է գնի և քանակի հիման վրա։ Եթե տվել ենք նաև զեղչված գինը, ապա գումարը հաշվարկվում է զեղչված գնի և քանակի հիման վրա։ Ընդունում է նաև մեր տված արժեքը, բայց այս դեպքում անհրաժեշտ է ուշադիր լինել , որ այն բավարարի վերևում նշված հավասարմանը։ |
|
description |
String |
Ապրանքի նկարագրություն։ |
|
vat |
Boolean |
ԱԱՀ-ի հաշվարկի բնութագրիչ։ Եթե չենք տալիս այս դաշտը, ավտոմատ վերցնում է ապրանքներ և ծառայությունների տեղեկատուից։ |
|
expirationDate |
Date(YYYY-MM-DD) |
Օգտագործման ժամկետ։ |
|
country |
String(3) |
Երկրի կոդ։ |
|
producer |
String(4) |
Արտադրողի կոդ։ |
|
property1 |
String(50) |
Ապրանքը բնութագրող հատկություն 1-ի կոդ։ |
|
property2 |
String(50) |
Ապրանքը բնութագրող հատկություն 1-ի կոդ։ |
|
rowNumber |
Integer |
Տողի համար։ |
|
rowId |
Integer |
Տողի ներքին նույնացուցիչ։ |
|
addedValuePercent |
Decimal |
Հավելագնի %: |
|
salePrice |
Decimal |
Ապրանքի վաճառքի գին։ |
|
saleAmount |
Decimal |
Ապրանքի վաճառքի գումար։ |
|
|
|
|