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

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

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

 Previous pageReturn to chapter overviewNext page

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

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

URI

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

URL Swagger

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

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

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

 

Ապրանքների տեղաշարժ օբյեկտի ատրիբուտներ (Object Attributes)

Ստորև ներկայացված է օբյեկտի ատրիբուտների նկարագրությունը.

Անվանում

Տեսակ

Կիրառումը

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

isn

UUID

api_optional api_required_upd api_system defined

Փաստաթղթի նույնացուցիչ: Պարտադիր է GET, PUT, DELETE հարցումների դեպքում։ POST հարցման ժամանակ UUID-ը չի փոխանցվում, սերվերը այն ավտոմատ գեներացնում է և վերադարձնում պատասխանում։

date

Date(YYYY-MM-DD)

api_required

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

documentNumber

String(12)

api_required

Փաստաթղթի համար: Եթե համարը չի փոխանցվում, ապա գրանցվում է վերջին համարին ավելացնելով 1:

state

Enum

api_required

Փաստաթղթի վիճակ: Ընդունում է հետևյալ արժեքները.

0 - Գրանցված կամ սևագիր,

1 - Սևագիր,

2 - Գրանցված,

3 - Հեռացված:

storageOutput

String(5)

api_required

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

storageInput

String(5)

api_required

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

priceType

String(2)

api_optional

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

comment

String(255)

api_optional

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

owner

String(50)

api_optional

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

mediator

String(50)

api_optional

Միջնորդ։

chiefAccount

String(100)

api_optional

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

allowed

String(50)

api_optional

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

 bookNumber

String(10)

api_optional

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

bookPage

Integer

api_optional

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

bookLine

Integer

api_optional

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

taxExportType

Enum

api_optional

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

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

2-թղթային:

taxInvoiceSeries

String(1)

api_optional

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

taxInvoiceNumber

String(10)

api_optional

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

submissionDate

Date(YYYY-MM-DD)

api_optional

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

transportationMethod

String(255)

api_optional

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

vehicle

Boolean

api_optional

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

licensePlate

String(20)

api_conditionally required

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

baseDocumentISN

UUID(50)

api_optional

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

productsList [0..n]

Array

api_required

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

 

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

Անվանում

Տեսակ

Կիրառումը

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

id

Integer

api_system defined

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

code

String(20)

api_required

Ապրանքի կոդ։

name

String(200)

api_read_only

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

fullName

String(255)

api_read_only

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

unit

String(3)

api_required

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

unitAbbreviation

String(6)

api_read_only

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

quantity

Decimal

api_required

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

salePrice

Decimal

api_required

Վաճառքի գին։

saleAmount

Decimal

api_optional

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

discountedPrice

Decimal

api_optional

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

description

String(50)

api_optional

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

rowNumber

Integer

api_system defined

Տողի համար։

rowId

Integer

api_system defined

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

 

POST

Request

 

curl -X 'POST' \

 'https://smetest.armsoft.am/tradetest/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

   }

 ]

}

 

GET

Request

 

curl -X GET \

 "https://api.armsoft.am/trade/v1/documents/storageinputorder/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

       }

   ]

}

 

PUT

Request

 

curl -X 'PUT' \

 'https://smetest.armsoft.am/tradetest/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

   }

 ]

}

 

DELETE

Request

 

curl -X 'DELETE' \

 'https://smetest.armsoft.am/tradetest/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)