API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) Վերադարձ մատակարարին փաստաթուղթը:
URI |
https://api.armsoft.am/accountant/v1/documents/returntosupplier |
GitHub |
|
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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 - Հեռացված: Եթե վիճակը չի փոխանցվում, փաստաթուղթը ավտոմատ գրանցված վիճակում է ուղարկվում։ |
baseDocumentISN |
UUID |
Optional |
Հիմք փաստաթղթի նույնացուցիչ։ |
currency |
String(3) |
*Required Reference type |
Փաստաթղթի արժույթի կոդ: Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։ |
currencyExchangeRate |
Decimal |
*Conditional required |
Արժույթի փոխարժեք: Պարտադիր է ուղարկել, եթե փաստաթուղթը արտարժույթով է։ |
currencyExchangeBase |
Integer |
*Conditional required |
Արժույթի փոխարժեքի պատիկություն: Պարտադիր է ուղարկել, եթե փաստաթուղթը արտարժույթով է։ |
previousDayExchangeRate |
Boօlean |
Optional |
Նախորդ օրվա փոխարժեքը կիրառելու հայտանիշ։ |
supplierCode |
String(20) |
Optional Reference type |
Մատակարարի կոդ։ |
supplierAccount |
String(12) |
Optional Reference type |
Մատակարարի հաշիվ։ |
transitAccount |
String(12) |
Optional Reference type |
Տարանցիկ հաշիվ։ |
analytic1 |
String(12) |
Optional Reference type |
Անալիտիկ խումբ 1-ի կոդ։ |
analytic2 |
String(12) |
Optional Reference type |
Անալիտիկ խումբ 2-ի կոդ։ |
comment |
String(255) |
Optional |
Մեկնաբանություն։ |
baseTaxInvoiceSeries |
String(1) |
Optional |
Հիմք փաստաթղթի սերիա: |
baseTaxInvoiceNumber |
String(10) |
Optional |
Հիմք փաստաթղթի համար: |
baseSubmissionDate |
Date(YYYY-MM-DD) |
Optional |
Հիմք փաստաթղթի դուրսգրման ամսաթիվ։ |
vatCalculationType |
Enum |
*Required |
ԱԱՀ-ի հաշվարկի ձև։ Ընդունում է հետևյալ արժեքները. 1 - ԱԱՀ-ով, 2 - ԱԱՀ-ն այդ թվում, 3 - Առանց ԱԱՀ, 4 - Զրոյական ԱԱՀ, Եթե արժեք չենք տալիս, ավտոմատ լրացվում է ծրագրի դրույթներում նշված արժեքը։ |
vatIncludedInCost |
Boolean |
Optional |
ԱԱՀ-ն ինքնարժեքի մեջ ներառելու հայտանիշ։ |
storage |
String(5) |
Optional Reference type |
Պահեստի կոդ։ |
vatAmount |
Decimal |
*Required |
Գումար ԱԱՀ։ Ավտոմատ հաշվարկվում է համակարգի կողմից։ |
totalAmount |
Decimal |
*Required |
Ընդհանուր գումար։ Ավտոմատ հաշվարկվում է համակարգի կողմից։ |
supplierName |
String(50) |
Optional |
Մատակարարի անվանում։ |
supplierLegalAddress |
String(255) |
Optional |
Մատակարարի իրավաբանական հասցե։ |
supplierBusinessAddress |
String(255) |
Optional |
Մատակարարի գործունեության հասցե։ |
supplierSettlementAccount |
String(50) |
Optional |
Մատակարարի հաշվարկային հաշիվ։ |
supplierTaxCode |
String(20) |
Optional |
Մատակարարի ՀՎՀՀ։ |
supplierManagerPosition |
String(50) |
Optional |
Մատակարարի ղեկավարի պաշտոն։ |
supplierManagerName |
String(50) |
Optional |
Մատակարարի ղեկավարի Ա․Ա․Հ․։ |
supplierAccountantPosition |
String(50) |
Optional |
Մատակարարի հաշվապահի պաշտոն։ |
supplierAccountantName |
String(50) |
Optional |
Մատակարարի հաշվապահի Ա․Ա․Հ․։ |
customerName |
String(50) |
Optional |
Գնորդի անվանում։ |
customerLegalAddress |
String(255) |
Optional |
Գնորդի իրավաբանական հասցե։ |
customerBusinessAddress |
String(255) |
Optional |
Գնորդի գործունեության հասցե։ |
customerSettlementAccount |
String(22) |
Optional |
Գնորդի հաշվարկային հաշիվ։ |
customerTaxCode |
String(20) |
Optional |
Գնորդի ՀՎՀՀ։ |
customerManagerPosition |
String(50) |
Optional |
Գնորդի ղեկավարի պաշտոն։ |
customerManagerName |
String(50) |
Optional |
Գնորդի ղեկավարի Ա․Ա․Հ․։ |
customerAccountantPosition |
String(50) |
Optional |
Գնորդի հաշվապահի պաշտոն։ |
customerAccountantName |
String(50) |
Optional |
Գնորդի հաշվապահի անվանում։ |
materialsList [0..n] |
Array |
*Required |
Նյութական արժեքների անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի նյութական արժեքի առնվազն մեկ տող։ |
Անվանացուցակի տողի դաշտերը (itemList)
Անվանում |
Տեսակ |
Կիրառումը |
Նկարագրություն |
storage |
String(5) |
*Required Reference type |
Պահեստի կոդ: |
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 |
Նյութական արժեքի գին։ Պարտադիր է լրացնել, եթե գումար դաշտին արժեք չենք տալիս։ Հակառակ դեպքում հաշվարկվում է ավտոմատ։ |
amount |
Decimal |
*Required |
Նյութական արժեքի գումար։ Պարտադիր է լրացնել, եթե գին դաշտին արժեք չենք տալիս։ Հակառակ դեպքում հաշվարկվում է ավտոմատ։ |
rowId |
Integer |
System defined |
Տողի ներքին նույնացուցիչ։ |
GitHub |
|
Օրինակ 1. Վերադարձ մատակարարին փաստաթղթի ստեղծում առանց հիմք փաստաթղթի
|
Օրինակ 2. Վերադարձ մատակարարին փաստաթղթի ստեղծում հիմք փաստաթղթով
|
Օրինակ 3. Նշված isn-ով Վերադարձ մատակարարին փաստաթղթի ստացում
|
Օրինակ 4. Նշված isn-ով Վերադարձ մատակարարին փաստաթղթի դաշտերի խմբագրում
|
Օրինակ 5. Նշված isn-ով Վերադարձ մատակարարին փաստաթղթի հեռացում
|