Վերադարձ մատակարարին

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

Վերադարձ մատակարարին

Previous pageReturn to chapter overviewNext page

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

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

 

URI

https://api.armsoft.am/accountant/v1/documents/returntosupplier

URL Swagger

https://api.armsoft.am/accountant/swagger/index.html#/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. Վերադարձ մատակարարին փաստաթղթի ստեղծում առանց հիմք փաստաթղթի

POST

 

Օրինակ 2. Վերադարձ մատակարարին փաստաթղթի ստեղծում հիմք փաստաթղթով

POST

 

Օրինակ 3. Նշված isn-ով Վերադարձ մատակարարին փաստաթղթի ստացում

GET

 

Օրինակ 4. Նշված isn-ով Վերադարձ մատակարարին փաստաթղթի դաշտերի խմբագրում

PUT

 

Օրինակ 5. Նշված isn-ով Վերադարձ մատակարարին փաստաթղթի հեռացում

DELETE