Ստացված ծառայություններ

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

Ստացված ծառայություններ

Previous pageReturn to chapter overviewNext page

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

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

 

URI

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

URL Swagger

https://api.armsoft.am/accountant/swagger/index.html#/ReceivedService

GitHub

https://github.com/armsoft/accountant-public-api-docs/blob/main/docs/api/documents/receivedservice.md

Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ 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

Ծառայության տողի համար։

 

GitHub

https://github.com/armsoft/accountant-public-api-docs/blob/main/examples/csharp/documents/create-receivedservice.cs

Օրինակ 1. Ստացված ծառայություններ փաստաթղթի ստեղծում

POST

 

Օրինակ 2. Նշված isn-ով Ստացված ծառայություններ փաստաթղթի ստացում

GET

 

Օրինակ 3. Նշված isn-ով Ստացված ծառայություններ փաստաթղթի դաշտերի խմբագրում

PUT

 

Օրինակ 4. Նշված isn-ով Ստացված ծառայություններ փաստաթղթի հեռացում

DELETE