ՆԱ տեղաշարժ

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

ՆԱ տեղաշարժ

 Previous pageReturn to chapter overviewNext page

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

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

 

URI

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

URL Swagger

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

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

Եթե վիճակը չի փոխանցվում, փաստաթուղթը ավտոմատ գրանցված վիճակում է ուղարկվում։

storageOutput

String(5)

*Required

Reference type

Պահեստը, որտեղից ելքագրվում են նյութական արժեքները:

storageInput

String(5)

*Required

Reference type

Պահեստը, որտեղ մուտքագրվում են նյութական արժեքները:

printSalePriceType

Enum

Optional

Գնի տեսակ, որն օգտագործվում է փաստաթուղթը տպելիս: Ընդունում է հետևյալ արժեքները. 1 - Մեծածախ գին, 2-Մանրածախ գին, 3-Միջին ինքնարժեք:

analytic1

String(12)

Optional

Reference type

Անալիտիկ խումբ 1-ի կոդը։

analytic2

String(12)

Optional

Reference type

Անալիտիկ խումբ 2-ի կոդը։

comment

String(255)

Optional

Փաստաթղթի մեկնաբանություն։

chiefAccount

String(100)

Optional

Կազմակերպության գլխավոր հաշվապահի Ա.Ա.Հ:

mediator

String(50)

Optional

Նյութական արժեքների տեղափոխման համար պատասխանատու աշխատակցի տվյալներ:

allowed

String(50)

Optional

Տեղաշարժը թույլատրող աշխատակցի  Ա.Ա.Հ:

bookNumber

Decimal

Optional

Փաստաթղթի գրանցման գրքի համար (չի կիրառվում):

bookPage

Decimal

Optional

Գրանցման գրքում էջի համար (չի կիրառվում):

bookLine

Decimal

Optional

Գրանցման գրքի էջում տողի համար  (չի կիրառվում):

taxExportType

Enum

Optional

Հաշվարկային փաստաթղթի դուրսգրման եղանակ`1- էլեկտրոնային, 2-թղթային (չի կիրառվում):

taxInvoiceSeries

Decimal

Optional

 

Հարկային մարմնի կողմից ստացված սերիա:

taxInvoiceNumber

String(10)

Optional

Հարկային մարմնի կողմից ստացված համար:

submissionDate

Date(YYYY-MM-DD)

Optional

Հաշվարկային փաստաթղթի դուրսգրման ամսաթիվ:

transportationMethod

String(256)

Optional

Նյութական արժեքների տեղափոխման եղանակ:

vehicle

Boolean

Optional

Ավտոտրանսպորտային միջոց։

brand

String(256)

Optional

Մակնիշ։

licensePlate

String(20)

Optional

Պետհամարանիշ։

contract

String(50)

Optional

Պայմանագիր։

contractDate

Date(YYYY-MM-DD)

Optional

Պայմանագրի ամսաթիվը։

additionalData

String(256)

Optional

Լրացուցիչ տվյալներ։

 

Անվանացուցակի տողի դաշտերը (itemList)

Անվանում

Տեսակ

Կիրառումը

Նկարագրություն

id

Integer

System defined

Նյութական արժեքի, ծառայության կամ հիմնական միջոցի ներքին նույնացուցիչ։

code

String(20)

*Required

Reference type

Նյութական արժեքի կոդ:

name

String(200)

Optional

Նյութական արժեքի անվանում։

unitAbbreviation

String(3)

Optional

Նյութական արժեքի չափման միավոր։

quantity

Decimal

*Required

Տեղաշարժվող քանակ:

amount

Decimal

Optional

Նյութական արժեքի գումար:

account

String(12)

Optional

Reference type

Նյութական արժեքի հաշվառման հաշիվ։

rowId

Integer

System defined

Տողի ներքին նույնացուցիչ։

 

Օրինակ 1. ՆԱ տեղաշարժ փաստաթղթի ստեղծում

POST

Request

 

curl -X 'POST' \

 'https://smetest.armsoft.am/accountanttest/v1/documents/materialsmovement' \

 -H 'accept: text/plain' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: 5GR4tLE#@><C8!,_zfPK' \

 -H 'Content-Type: application/json' \

 -d '{

 "isn": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

 "date": "2026-03-18",

 "documentNumber": "",

 "state": 0,

 "storageOutput": "01",

 "storageInput": "02",

 "printSalePriceType": "1",

 "analytic1": "001",

 "analytic2": "",

 "comment": "Նա տեղաշարժ",

 "chiefAccount": "Ստեփանյան Ա.",

 "mediator": "",

 "allowed": "",

 "bookNumber": "",

 "bookPage": 0,

 "bookLine": 0,

 "taxExportType": "1",

 "taxInvoiceSeries": "",

 "taxInvoiceNumber": "",

 "submissionDate": "2026-03-18",

 "transportationMethod": "Համաձայն N ... պայմանագրի",

 "vehicle": false,

 "brand": "Համաձայն N ... պայմանագրի",

 "licensePlate": "",

 "contract": "",

 "contractDate": "2026-03-18",

 "additionalData": "",

 "materialsList": [

   {

     "id": 0,

     "code": "10001",

     "name": "Իտալական մանկական կոշիկ",

     "unitAbbreviation": "հատ",

     "quantity": 1,

     "amount": 10000,

     "account": "2161",

     "rowId": 0

   }

 ]

}'

 

Response body (201 Created)

 

{

 "isn": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

 "date": "2026-03-18",

 "documentNumber": "ՆԱՏ007",

 "state": 2,

 "storageOutput": "01",

 "storageInput": "02",

 "printSalePriceType": "1",

 "analytic1": "001",

 "analytic2": "",

 "comment": "Նա տեղաշարժ",

 "chiefAccount": "Ստեփանյան Ա.",

 "mediator": "",

 "allowed": "",

 "bookNumber": "",

 "bookPage": 0,

 "bookLine": 0,

 "taxExportType": "1",

 "taxInvoiceSeries": "",

 "taxInvoiceNumber": "",

 "submissionDate": "2026-03-18",

 "transportationMethod": "Համաձայն N ... պայմանագրի",

 "vehicle": false,

 "brand": "Համաձայն N ... պայմանագրի",

 "licensePlate": "",

 "contract": "",

 "contractDate": "2026-03-18",

 "additionalData": "",

 "materialsList": [

   {

     "id": 100000,

     "code": "10001",

     "name": "Իտալական մանկական կոշիկ",

     "unitAbbreviation": "հատ",

     "quantity": 1,

     "amount": 10000,

     "account": "2161",

     "rowId": 0

   }

 ]

}

 

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

GET

Request

 

curl -X 'GET' \

 'https://smetest.armsoft.am/accountanttest/v1/documents/materialsmovement/3fa85f64-5717-4562-b3fc-2c963f66afa6' \

 -H 'accept: */*' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: 5GR4tLE#@><C8!,_zfPK'

 

Response body  (200 OK)

 

{

 "isn": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

 "date": "2026-03-18",

 "documentNumber": "ՆԱՏ007",

 "state": 2,

 "storageOutput": "01",

 "storageInput": "02",

 "printSalePriceType": "1",

 "analytic1": "001",

 "analytic2": "",

 "comment": "Նա տեղաշարժ",

 "chiefAccount": "Ստեփանյան Ա.",

 "mediator": "",

 "allowed": "",

 "bookNumber": "",

 "bookPage": 0,

 "bookLine": 0,

 "taxExportType": "1",

 "taxInvoiceSeries": "",

 "taxInvoiceNumber": "",

 "submissionDate": "2026-03-18",

 "transportationMethod": "Համաձայն N ... պայմանագրի",

 "vehicle": false,

 "brand": "Համաձայն N ... պայմանագրի",

 "licensePlate": "",

 "contract": "",

 "contractDate": "2026-03-18",

 "additionalData": "",

 "materialsList": [

   {

     "id": 100000,

     "code": "10001",

     "name": "Իտալական մանկական կոշիկ",

     "unitAbbreviation": "հատ",

     "quantity": 1,

     "amount": 10000,

     "account": "2161",

     "rowId": 0

   }

 ]

}

 

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

PUT

Request

 

curl -X 'PUT' \

 'https://smetest.armsoft.am/accountanttest/v1/documents/materialsmovement/3fa85f64-5717-4562-b3fc-2c963f66afa6' \

 -H 'accept: text/plain' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: 5GR4tLE#@><C8!,_zfPK' \

 -H 'Content-Type: application/json' \

 -d '{

 "isn": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

 "date": "2026-03-18",

 "documentNumber": "ՆԱՏ007",

 "state": 1,

 "storageOutput": "01",

 "storageInput": "03",

 "printSalePriceType": "1",

 "analytic1": "001",

 "analytic2": "",

 "comment": "Նա տեղաշարժ",

 "chiefAccount": "Ստեփանյան Ա.",

 "mediator": "",

 "allowed": "",

 "bookNumber": "",

 "bookPage": 0,

 "bookLine": 0,

 "taxExportType": "1",

 "taxInvoiceSeries": "",

 "taxInvoiceNumber": "",

 "submissionDate": "2026-03-18",

 "transportationMethod": "false",

 "vehicle": true,

 "brand": "",

 "licensePlate": "",

 "contract": "",

 "contractDate": "2026-03-18",

 "additionalData": "",

 "materialsList": [

   {

     "id": 0,

     "code": "10001",

     "name": "Իտալական մանկական կոշիկ",

     "unitAbbreviation": "հատ",

     "quantity": 2,

     "amount": 20000,

     "account": "2161",

     "rowId": 0

   }

 ]

}'

 

Response body  (200 OK)

 

{

 "isn": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

 "date": "2026-03-18",

 "documentNumber": "ՆԱՏ007",

 "state": 1,

 "storageOutput": "01",

 "storageInput": "03",

 "printSalePriceType": "1",

 "analytic1": "001",

 "analytic2": "",

 "comment": "Նա տեղաշարժ",

 "chiefAccount": "Ստեփանյան Ա.",

 "mediator": "",

 "allowed": "",

 "bookNumber": "",

 "bookPage": 0,

 "bookLine": 0,

 "taxExportType": "1",

 "taxInvoiceSeries": "",

 "taxInvoiceNumber": "",

 "submissionDate": "2026-03-18",

 "transportationMethod": "false",

 "vehicle": true,

 "brand": "",

 "licensePlate": "",

 "contract": "",

 "contractDate": "2026-03-18",

 "additionalData": "",

 "materialsList": [

   {

     "id": 100000,

     "code": "10001",

     "name": "Իտալական մանկական կոշիկ",

     "unitAbbreviation": "հատ",

     "quantity": 2,

     "amount": 0,

     "account": "2161",

     "rowId": 0

   }

 ]

}

 

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

DELETE

Request

 

curl -X 'DELETE' \

 'https://smetest.armsoft.am/accountanttest/v1/documents/materialsmovement/3fa85f64-5717-4562-b3fc-2c963f66afa6' \

 -H 'accept: */*' \

 -H 'Accept-Language: hy-AM' \

 -H 'apiKey: 5GR4tLE#@><C8!,_zfPK'

 

Response body  (200 OK)