Ապրանքների տեղաշարժ

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

Ապրանքների տեղաշարժ

 Previous pageReturn to chapter overviewNext page

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

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

URI

https://api.armsoft.am/trade/v1/documents/productsmovement

URL Swagger

https://api.armsoft.am/trade/swagger/index.html#/ProductsMovement

GitHub

https://github.com/armsoft/trade-public-api-docs/blob/main/docs/api/documents/productsmovement.md

Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ API բանալու օգտագործմամբ։ Այն անհրաժեշտ է տեղադրել հարցման գլխագրի apiKey դաշտում. API բանալին ստանալու համար անհրաժեշտ է կատարել API գաղտնի բանալու ստացում էջում նկարագրված քայլերը:

-H 'apiKey: hJk:|^&99։՛(=0#biWc:'

 

Ապրանքների տեղաշարժ օբյեկտի ատրիբուտներ (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

Պահեստի կոդ, որտեղ մուտքագրվում են ապրանքները։

priceType

String(2)

Optional

Reference type

Նշվում է, թե ապրանքները մուտքագրելիս համակարգն ինչ տեսակի գներ առաջարկի։

comment

String(255)

Optional

Մեկնաբանություն։

owner

String(50)

Optional

Reference type

Փաստաթղթի հեղինակ։

mediator

String(50)

Optional

Reference type

Միջնորդ։

chiefAccount

String(100)

Optional

Գլխավոր հաշվապահի Ա.Ա.Հ։

allowed

String(50)

Optional

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

 bookNumber

String(10)

Optional

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

bookPage

Integer

Optional

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

bookLine

Integer

Optional

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

taxExportType

Enum

Optional

Հաշվարկային փաստաթղթի դուրսգրման եղանակ։ Ընդունում է հետևյալ արժեքները․

1- էլեկտրոնային,

2-թղթային:

taxInvoiceSeries

String(1)

Optional

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

taxInvoiceNumber

String(10)

Optional

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

submissionDate

Date(YYYY-MM-DD)

Optional

Հարկային հաշվի դուրսգրման ամսաթիվը։

transportationMethod

String(255)

Optional

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

vehicle

Boolean

Optional

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

licensePlate

String(20)

*Conditional required

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

baseDocumentISN

UUID(50)

Optional

Հիմք փաստաթղթի նույնացուցիչ։

productsList [0..n]

Array

*Required

Ապրանքների և ծառայությունների անվանացուցակ (մասսիվ): Անվանացուցակը պետք է պարունակի ապրանքի կամ ծառայութան առնվազն մեկ տող։

 

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

Անվանում

Տեսակ

Կիրառումը

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

id

Integer

System defined

Ապրանքի ներքին նույնացուցիչ։

code

String(20)

*Required

Reference type

Ապրանքի կոդ։

name

String(200)

Read only

Ապրանքի անվանում։

fullName

String(255)

Read only

Ապրանքի լրիվ անվանում։

unit

String(3)

*Required

Reference type

Ապրանքի չափման միավորի կոդ։

unitAbbreviation

String(6)

Read only

Ապրանքի չափման միավորի հապավում։

quantity

Decimal

*Required

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

salePrice

Decimal

*Required

Վաճառքի գին։

saleAmount

Decimal

Optional

Վաճառքի գումար։

discountedPrice

Decimal

Optional

Ապրանքի զեղչված գին։

description

String(50)

Optional

Ապրանքի նկարագրություն։

rowNumber

Integer

System defined

Տողի համար։

rowId

Integer

System defined

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

 

GitHub

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

Օրինակ 1. Ապրանքների տեղաշարժ փաստաթղթի ստեղծում (պարտադիր դաշտերով)

POST

Request

 

curl -X 'POST' \

"https://api.armsoft.am/trade/v1/documents/productsmovement" \

 -H 'accept: text/plain' \

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

 -H 'apiKey: y3(jw33<g}sp.ex)#>^k' \

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

 -d '{

 

 "storageOutput": "00",

 "storageInput": "02",

 "productsList": [

   {

     "code": "1001",

     "unit": "001",

     "quantity": 2

   }

  ]

}'

 

Response body (201 Created)

 

{

   "isn": "76bbd1d6-dc0f-4872-be4b-4e32fabfdf1f",

   "date": "2026-03-24",

   "documentNumber": "ԱՏՂ-021",

   "state": 2,

   "storageOutput": "00",

   "storageInput": "02",

   "priceType": "",

   "comment": "",

   "owner": "testuser@testmail.am",

   "mediator": "",

   "chiefAccount": "",

   "allowed": "",

   "bookNumber": "",

   "bookPage": 0,

   "bookLine": 0,

   "taxExportType": "",

   "taxInvoiceSeries": "",

   "taxInvoiceNumber": "",

   "transportationMethod": "",

   "vehicle": false,

   "brand": "",

   "licensePlate": "",

   "baseDocumentISN": "00000000-0000-0000-0000-000000000000",

   "productsList": [

       {

           "id": 100000,

           "code": "1001",

           "name": "Հեռուստացույց",

           "fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

           "unit": "001",

           "unitAbbreviation": "հատ",

           "quantity": 2.0000,

           "salePrice": 0.0000,

           "saleAmount": 0.0000,

           "description": "",

           "rowNumber": 0,

           "rowId": 0

       }

   ]

}

 

Օրինակ 2. Ապրանքների տեղաշարժ փաստաթղթի ստեղծում (լրացուցիչ դաշտերով)

POST

Request

 

curl -X 'POST' \

"https://api.armsoft.am/trade/v1/documents/productsmovement" \

 -H 'accept: text/plain' \

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

 -H 'apiKey: y3(jw33<g}sp.ex)#>^k' \

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

 -d '{

 "isn": "996f6fa8-b41f-4371-9852-cd9eb76eb410",

 "date": "2026-02-19",

 "documentNumber": "",

 "state": 2,

 "storageOutput": "00",

 "storageInput": "01",

 "priceType": "01",

 "comment": "",

 "owner": "",

 "mediator": "",

 "chiefAccount": "",

 "allowed": "",

 "bookNumber": "",

 "bookPage": 0,

 "bookLine": 0,

 "taxExportType": "",

 "taxInvoiceSeries": "",

 "taxInvoiceNumber": "",

 "submissionDate": "2026-02-19",

 "transportationMethod": "",

 "vehicle": true,

 "brand": "",

 "licensePlate": "",

 "baseDocumentISN": "00000000-0000-0000-0000-000000000000",

 "productsList": [

   {

     "id": 0,

     "code": "1001",

     "name": "Հեռուստացույց",

     "fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

     "unit": "001",

     "unitAbbreviation": "հատ",

     "quantity": 5,

     "salePrice": 500000,

     "saleAmount": 500000,

     "description": "",

     "rowNumber": 0,

     "rowId": 0

   }

 ]

}'

 

Response body (201 Created)

 

{

 "isn": "996f6fa8-b41f-4371-9852-cd9eb76eb410",

 "date": "2026-02-19",

 "documentNumber": "ԱՏՂ-019",

 "state": 2,

 "storageOutput": "00",

 "storageInput": "01",

 "priceType": "01",

 "comment": "",

 "owner": "",

 "mediator": "",

 "chiefAccount": "",

 "allowed": "",

 "bookNumber": "",

 "bookPage": 0,

 "bookLine": 0,

 "taxExportType": "",

 "taxInvoiceSeries": "",

 "taxInvoiceNumber": "",

 "submissionDate": "2026-02-19",

 "transportationMethod": "",

 "vehicle": true,

 "brand": "",

 "licensePlate": "",

 "baseDocumentISN": "00000000-0000-0000-0000-000000000000",

 "productsList": [

   {

     "id": 100000,

     "code": "1001",

     "name": "Հեռուստացույց",

     "fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

     "unit": "001",

     "unitAbbreviation": "հատ",

     "quantity": 5,

     "salePrice": 500000,

     "saleAmount": 500000,

     "description": "",

     "rowNumber": 0,

     "rowId": 0

   }

 ]

}

 

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

GET

Request

 

curl -X GET \

 "https://api.armsoft.am/trade/v1/documents/productsmovement/2eb0a60f-acbe-452e-9505-101160212220" \

 -H "accept: */*" \

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

 -H "apiKey: %}uPbv>T0xZ}3beLxR{1"

 

Response body  (200 OK)

 

{"isn": "2eb0a60f-acbe-452e-9505-101160212220",

   "date": "2026-02-18",

   "documentNumber": "ՊՄՕ-017",

   "state": 1,

   "baseDocumentISN": "00000000-0000-0000-0000-000000000000",

   "storage": "00",

   "supplierCode": "1001",

   "supplierContract": "001",

   "purchaseDocumentNumber": "",

   "comment": "",

   "owner": "testuser@testmail.am",

   "currency": "AMD",

   "currencyExchangeRate": 1.0000,

   "currencyExchangeBase": 1.0000,

   "vatCalculationType": "1",

   "includeVATInCost": true,

   "priceType": "",

   "discountPercent": 0,

   "vatAmount": 30000.0000,

   "totalAmount": 500000.0000,

   "letterOfAttorney": "",

   "mediator": "",

   "vehicle": "",

   "chiefAccount": "",

   "allowed": "",

   "accepted": "",

   "productsList": [

       {

           "id": 100000,

           "code": "1001",

           "name": "Հեռուստացույց LED Panasonic TX-LR55ET5",

           "fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

           "unit": "001",

           "unitAbbreviation": "հատ",

           "quantity": 1.0000,

           "price": 200000.0000,

           "discountPercent": 25.0000,

           "discountedPrice": 150000.0000,

           "amount": 150000.0000,

           "description": "",

           "vat": true,

           "country": "",

           "producer": "",

           "property1": "",

           "property2": "",

           "rowNumber": 0,

           "rowId": 0

       },

       {

           "id": 100001,

           "code": "1002",

           "name": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

           "fullName": "Հեռուստացույց LED SONY KDL-55W905ABAEP",

           "unit": "001",

           "unitAbbreviation": "հատ",

           "quantity": 2.0000,

           "price": 160000.0000,

           "discountPercent": 0.0000,

           "discountedPrice": 160000.0000,

           "amount": 320000.0000,

           "description": "",

           "vat": false,

           "country": "",

           "producer": "",

           "property1": "",

           "property2": "",

           "rowNumber": 1,

           "rowId": 1

       }

   ]

}

 

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

PUT

Request

 

curl -X 'PUT' \

 "https://api.armsoft.am/trade/v1/documents/productsmovement/4f821ee3-35c3-4fe1-842d-c16fa62fc04f" \

 -H 'accept: text/plain' \

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

 -H 'apiKey: y3(jw33<g}sp.ex)#>^k' \

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

 -d '{

 "isn": "0d702e05-af11-460b-add7-6b72b41e7690",

 "date": "2026-02-19",

 "documentNumber": "ԱՏՂ-017",

 "state": 2,

 "storageOutput": "00",

 "storageInput": "01",

 "priceType": "01",

 "comment": "",

 "owner": "",

 "mediator": "",

 "chiefAccount": "Պ.Հակոբյան",

 "allowed": "",

 "bookNumber": "",

 "bookPage": 0,

 "bookLine": 0,

 "taxExportType": "",

 "taxInvoiceSeries": "",

 "taxInvoiceNumber": "",

 "submissionDate": "2026-02-19",

 "transportationMethod": "",

 "vehicle": true,

 "brand": "",

 "licensePlate": "",

 "baseDocumentISN": "00000000-0000-0000-0000-000000000000",

 "productsList": [

   {

     "id": 100000,

     "code": "1001",

     "name": "Հեռուստացույց",

     "fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

     "unit": "001",

     "unitAbbreviation": "հատ",

     "quantity": 2,

     "salePrice": 736850,

     "saleAmount": 736850,

     "description": "",

     "rowNumber": 0,

     "rowId": 0

   }

 ]

}'

 

Response body  (200 OK)

 

{

 "isn": "4f821ee3-35c3-4fe1-842d-c16fa62fc04f",

 "date": "2026-02-19",

 "documentNumber": "ԱՏՂ-017",

 "state": 2,

 "storageOutput": "00",

 "storageInput": "01",

 "priceType": "01",

 "comment": "",

 "owner": "testuser@testmail.am",

 "mediator": "",

 "chiefAccount": "Պ.Հակոբյան",

 "allowed": "",

 "bookNumber": "",

 "bookPage": 0,

 "bookLine": 0,

 "taxExportType": "",

 "taxInvoiceSeries": "",

 "taxInvoiceNumber": "",

 "submissionDate": "2026-02-19",

 "transportationMethod": "",

 "vehicle": true,

 "brand": "",

 "licensePlate": "",

 "baseDocumentISN": "00000000-0000-0000-0000-000000000000",

 "productsList": [

   {

     "id": 100000,

     "code": "1001",

     "name": "Հեռուստացույց",

     "fullName": "Հեռուստացույց LED Panasonic TX-LR55ET5",

     "unit": "001",

     "unitAbbreviation": "հատ",

     "quantity": 10,

     "salePrice": 750150,

     "saleAmount": 7501500,

     "description": "",

     "rowNumber": 0,

     "rowId": 0

   }

 ]

}

 

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

DELETE

Request

 

curl -X 'DELETE' \

 "https://api.armsoft.am/trade/v1/documents/productsmovement/996f6fa8-b41f-4371-9852-cd9eb76eb410" \

 -H 'accept: */*' \

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

 -H 'apiKey: y3(jw33<g}sp.ex)#>^k'

 

Response body  (200 OK)