API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) Ստացված ծառայություններ փաստաթուղթը:
URI |
https://api.armsoft.am/accountant/v1/documents/receivedservice |
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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 - Հեռացված: Եթե վիճակը չի փոխանցվում, փաստաթուղթը ավտոմատ գրանցված վիճակում է ուղարկվում։ |
currency |
String(3) |
*Required Reference type |
Փաստաթղթի արժույթի կոդ: Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։ |
currencyExchangeRate |
Decimal |
*Conditional required |
Արժույթի փոխարժեք: Պարտադիր է ուղարկել, եթե փաստաթուղթը արտարժույթով է։ |
currencyExchangeBase |
Integer |
*Conditional required |
Արժույթի փոխարժեքի պատիկություն: Պարտադիր է ուղարկել, եթե փաստաթուղթը արտարժույթով է։ |
previousDayExchangeRate |
Boolean |
Optional |
True արժեքի դեպքում նշված արժույթի դրամային համարժեքը կհաշվարկվի նախորդ օրվա փոխարժեքի հիման վրա: |
supplierCode |
String(20) |
Optional Reference type |
Մատակարարի կոդ։ |
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-ի կոդ։ |
selfInvoice |
Boolean |
Optional |
True արժեքի դեպքում փաստաթուղթը կարտացոլվի Դուրս գրված հաշիվների մատյանում և հնարավոր կլինի արտահանել e-Invoicing` որպես Մատակարարի անունից դուրս գրված հաշիվ: |
taxExportType |
Enum |
Optional |
Հաշվարկային փաստաթղթի դուրսգրման եղանակ։ Ընդունում է հետևյալ արժեքները․ 1- էլեկտրոնային, 2-թղթային: |
purchaseDocumentNumber |
String(12) |
Optional |
Մատակարարից ստացված ձեռքբերման փաստաթղթի համար։ |
submissionDate |
Date(YYYY-MM-DD) |
Optional |
Ձեռքբերման փաստաթղթի ամսաթիվը: |
comment |
String(255) |
Optional |
Մեկնաբանություն։ |
purchasingType |
Enum |
*Required |
Ծառայությունների ձեռքբերման տեսակ։ Ընդունում է հետևյալ արժեքները․ 1 - Մատակարարից Հ/Ա-ով, 2 - Առհաշվից` միակողմանի գնման ակտով, 3 - Առհաշվից` երկկողմանի գնման ակտով, 4- Առանց հարկերի, Եթե արժեք չենք տալիս, ավտոմատ լրացվում է 1 - Մատակարարից Հ/Ա-ով արժեքը։ |
vatCalculationType |
Enum |
*Required |
ԱԱՀ-ի հաշվարկի ձև։ Ընդունում է հետևյալ արժեքները. 1 - ԱԱՀ-ով, 2 - ԱԱՀ-ն այդ թվում, 3 - Առանց ԱԱՀ, 4 - Զրոյական ԱԱՀ, Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։ |
includeVATInExpense |
Boolean |
Optional |
ԱԱՀ-ն ինքնարժեքի մեջ ներառելու հայտանիշ։ |
vatInclusionMethod |
Enum |
*Conditional required |
ԱԱՀ-ի արտացոլման ձև։ ընդունում է հետևյալ արժեքները․ 1 - Չարտացոլել ԱԱՀ-ն շրջանառության մեջ, 2 - Արտացոլել ԱԱՀ-ն շրջանառության մեջ։ Պարտադիր է ուղարկել, եթե ԱԱՀ-ն ինքնարժեքի մեջ ներառելու հայտանիշը True արժեքն ունի։ |
vatAmount |
Decimal |
*Required |
Գումար ԱԱՀ։ Ավտոմատ հաշվարկվում է համակարգի կողմից։ |
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 |
Մատակարարի հաշվապահի Ա․Ա․Հ․։ |
servicesList [0..n] |
Array |
*Required |
Ծառայությունների անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի ծառայութան առնվազն մեկ տող։ |
Անվանացուցակի տողի դաշտերը (itemList)
Անվանում |
Տեսակ |
Կիրառումը |
Նկարագրություն |
id |
Integer |
System defined |
Ծառայության ներքին նույնացուցիչ։ |
code |
String(20) |
*Required |
Ծառայության կոդ։ |
name |
String(200) |
Optional |
Ծառայության անվանում։ Արժեք չտալու դեպքում ժառանգում է ծրագրի տեղեկատուներում առկա արժեքը։ |
unitAbbreviation |
String(6) |
Read only |
Ծառայության չափման միավոր։ |
quantity |
Decimal |
*Required |
Ծառայության քանակ։ |
price |
Decimal |
*Required |
Ծառայության գին։ |
amount |
Decimal |
*Required |
Ծառայության գումար։ Ավտոմատ հաշվարկվում է համակարգի կողմից տրված քանակի և գնի հիման վրա։ |
vat |
Boolean |
Optional |
Ծառայության ԱԱՀ-ով հարկման հայտանիշ: Արժեք չտալու դեպքում ժառանգում է ծրագրի տեղեկատուներում առկա արժեքը։ |
account |
String(12) |
Optional Reference type |
Ծառայության հաշվառման հաշիվ։ Արժեք չտալու դեպքում ժառանգում է ծրագրի տեղեկատուներում առկա արժեքը։ |
rowNumber |
Integer |
System defined |
Ծառայության տողի համար։ |
Օրինակ 1. Ստացված ծառայություններ փաստաթղթի ստեղծում
|
Օրինակ 2. Նշված isn-ով Ստացված ծառայություններ փաստաթղթի ստացում
|
Օրինակ 3. Նշված isn-ով Ստացված ծառայություններ փաստաթղթի դաշտերի խմբագրում
|
Օրինակ 4. Նշված isn-ով Ստացված ծառայություններ փաստաթղթի հեռացում
|