REST API (ամպային տարբերակ) > Տեղեկատուներ > Ապրանքներ և ծառայություններ

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

URI	https://api.armsoft.am/trade/v1/directories/products

URL Swagger

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

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

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

Հարցման պարամետրեր (Request Body)

Ապրանքներ և ծառայություններ տեղեկատուի ձևավորման պարամետրերը (ցուցադրվող սյուներ, ֆիլտրացում, խմբավորում) փոխանցվում են հարցման մարմնում (Request Body)՝ JSON ձևաչափով։

Անվանում	Տեսակ	Կիրառումը	Նկարագրություն
showMode	Enum		Ընդունում է հետևյալ արժեքները․ 1 - Գնացուցակում ընգրկվածները ընտրելու դեպքում տեղեկատուում ընդգրկվում են միայն այն ապրանքները (ծառայությունները), որոնց համար Ցույց տալ գնացուցակում դրոշակը դրված է, 2 - Գնացուցակում չընդգրկվածները ընտրելու դեպքում` այն ապրանքները (ծառայությունները), որոնց համար Ցույց տալ գնացուցակում դրոշակը դրված չէ։ 3 - Բոլորն ընտրելու դեպքում ընդգրկվում են բոլոր ապրանքները (ծառայությունները)։
group	String(5)		Ապրանքի խումբը։
type	Enum		Ընդունում է հետևյալ արժեքները․1-Ապրանք 2 - Ծառայություն
codes	Array		Ապրանքի կամ ծառայության կոդը։
priceListTypes	Array		Գների տեսակների կոդերը։
extended	Boolean		Տեղեկատուն ընլայնված սյուներով կանչելու հայտանիշ։
lastModifiedDate	DateTime(YYYY-MM-DDTHH:mm:ss.SSSZ)		Վերջին խմբագրման ամսաթիվ։

Ապրանքների (ծառայությունների) օբյեկտի դաշտերը

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

Անվանում	Տեսակ	Կիրառումը	Նկարագրություն
id	Integer		Ապրանքի (ծառայության) ներքին նույնացուցիչ։
code	String(20)		Ապրանքի (ծառայության) կոդ։ Արժեք չտալու դեպքում ընդունում է ծրագրից գեներացված հերթական համարը։
name	String(200)		Ապրանքի (ծառայության) անվանում։
fullName	String(255)		Ապրանքի (ծառայության) լրիվ անվանում։
type	Enum		Ընդունում է հետևյալ արժեքները․ 1 - Ապրանք 2 - Ծառայություն Արժեք չտալու դեպքում վերցնում է 1 արժեքը։
cpaClassifier	String(12)		Ապրանքի (ծառայության) ԱՏԳԱԱ դասակարգիչ:
group	String(5)		Ապրանքի (ծառայության) խմբի կոդ:
baseUnitMeasure	String(3)		Հիմնական չափման միավորի կոդ։
baseUnitMeasureAbbreviation	String(6)		Հիմնական չափման միավորի հապավում։
alternativeUnitMeasure	String(3)		Լրացուցիչ չափման միավորի կոդ։
alternativeUnitMeasureAbbreviation	String(6)		Լրացուցիչ չափման միավորի հապավում։
barcode	String(20)		Ապրանքի (ծառայության) գծիկավոր կոդ։
specification	String(255)		Ապրանքի (ծառայության) բնութագիր։
externalCode	String(20)		Ապրանքի (ծառայության) արտաքին կոդ։
costingMethod	Enum		Ապրանքի հաշվառման մեթոդ։ Ընդունում է հետևյալ արժեքները․ 1 - ՖԻՖՈ (առաջինը մուտք՝ առաջինը ելք), 2 - ԼԻՖՈ (վերջինը մուտք՝ առաջինը ելք), 3 - Միջին կշռված գնով։
vat	Boolean		ԱԱՀ-ով հաշվառվող համարվելու հայտանիշ։
checkMarking	Boolean		True արժեքի դեպքում տվյալ ապրանքը վաճառելիս դրոշմավորման կոդը լրացված չլինելու պարագայում համակարգը թույլ չի տալիս տպել ՀԴՄ կտրոն:
weight	Boolean		Նշվում է` տվյալ ապրանքը քաշային է, թե ոչ: Կիրառվում է էլեկտրոնային կշեռքով աշխատելու դեպքում:
pluCode	Integer		Ապրանքին տրվող չկրկնվող կոդ, որը ենթակա է արտահանման էլ. կշեռք։
showInPriceLists	Boolean		Եթե որևէ օգտագործողի Փաստաթղթի դրույթներում Ցույց տալ միայն գնացուցակում ներառվածները դրոշակը նշված է, ապա տվյալ օգտագործողի համար բոլոր ապրանքների ընտրման ցանկում կերևան միայն այն ապրանքները, որոնց համար Ցույց տալ գնացուցակներում դրոշակը նշված է։
environmentalFeePercent	Decimal		Ապրանքի (ծառայության) բնապահպանական հարկի %։
labelUnitMeasure	String(3)		Գնապիտակի չափման միավորը այն չափման միավորի կոդն է, որով արտահայտված գինը որպես միավոր գին պետք է արտացոլվի պիտակի ձևանմուշում:
labelUnitMeasureCoefficient	Decimal		Գնապիտակի չափման միավորի հապավում։
country	String(3)		Ապրանքը արտադրող երկիր։
producer	String(4)		Ապրանքը արտադրող կազմակերպություն։
property1	String(4)		Ապրանքը (ծառայությունը) բնութագրող հատկություն 1-ի կոդ։
property2	String(4)		Ապրանքը (ծառայությունը) բնութագրող հատկություն 2-ի կոդ։
minimumQuantity	Decimal		Ապրանքի մնացորդի նվազագույն քանակային մեծություն։
maximumQuantity	Decimal		Ապրանքի մնացորդի առավելագույն քանակային մեծություն։
addedValuePercent	Decimal		Ապրանքի (ծառայության) հավելագնի %։
aoeCoefficient	Decimal		Հավելյալ ծախսերի բաշխման գործակից։
bonusPercent	Decimal		Ապրանքի (ծառայության) բոնուսի տոկոս։
bonusPoint	Decimal		Ապրանքի (ծառայության) բոնուսի միավոր։
discountPercent	Decimal		Ապրանքի (ծառայության) զեղչի տոկոս։
mainSupplierId	Integer		Ապրանքի (ծառայության) հիմնական մատակարարի ներքին նույնացուցիչ։
substituteItemsGroup	String(5)		Փոխարինվող ապրանքների խմբի կոդ։
nameEN	String(200)		Ապրանքի (ծառայության) անգլերեն անվանում։
nameRU	String(200)		Ապրանքի (ծառայության) ռուսերեն անվանում։
additionalSpecification1	String(255)		Ապրանքի (ծառայության) լրացուցիչ բնութագիր 1։
additionalSpecification2	String(255)		Ապրանքի (ծառայության) լրացուցիչ բնութագիր 2։
baseUnitMeasureName	String(3)		Ապրանքի (ծառայության) հիմնական չափման միավորի անվանում։
alternativeUnitMeasureName	String(6)		Ապրանքի (ծառայության) լրացուցիչ չափման միավորի անվանում։
mainSupplierCode	String(5)		Ապրանքի (ծառայության) հիմնական մատակարարի կոդ։
measureUnits [0..n]	Array		Ապրանքների և ծառայությունների չափման միավորների ցուցակ (մասսիվ): Ցուցակը պետք է պարունակի չափման միավորի առնվազն մեկ տող։
barcodes [0..n]	Array		Ապրանքների և ծառայությունների գծիկավոր կոդերի ցուցակ (մասսիվ): Ցուցակը պետք է պարունակի գծիկավոր կոդի առնվազն մեկ տող։

Չափման միավորների տողերի դաշտերը

Անվանում	Տեսակ	Կիրառումը	Նկարագրություն
default	Boolean		Հիմնական չափման միավոր է, թե ոչ։
coefficient	decimal		Նշվում է, թե տվյալ չափման մեկ միավորը քանի հիմնական չափման միավորի է հավասար։
code	String(3)		Չափման միավորի կոդ։
abbreviation	String(6)		Չափման միավորի կոդը։ հապավում։

Գծիկավոր կոդերի տողերի դաշտերը

Անվանում	Տեսակ	Կիրառումը	Նկարագրություն
unitMeasure	String(3)		Չափման միավորի կոդ։
abbreviation	String(6)		Չափման միավորի ի հապավում։
barcode	String(20)		Գծիկավոր կոդ:

POST

Request

curl -X POST \

"https://api.armsoft.am/trade/v1/directories/products" \

-H "accept: text/plain" \

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

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

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

-d '

{

"code": "7012",

"name": "Կոշտ սկավառակ",

"fullName": "Կոշտ սկավառակ 512ԳԲ",

"type": "1",

"cpaClassifier": "8430",

"group": "352",

"baseUnitMeasure": "001",

"alternativeUnitMeasure": "002",

"barcode": "8452015263244",

"specification": "512 գբ",

"costingMethod": "2",

"vat": false,

"showInPriceLists": true,

"nameEN": "HDD",

"mainSupplierCode": "1001",

"measureUnits": [

{

"default": true,

"coefficient": 0,

"code": "001"

{

"default": false,

"coefficient": 10,

"code": "002"

}

"barcodes": [

{

"unitMeasure": "001",

"barcode": "45678945643121"

{

"unitMeasure": "001",

"barcode": "5468735468654"

{

"unitMeasure": "002",

"barcode": "3568354654544"

}

]

Response body (201 Created)

{

"id": 100070,

"code": "7012",

"name": "Կոշտ սկավառակ",

"fullName": "Կոշտ սկավառակ 512ԳԲ",

"type": "1",

"cpaClassifier": "8430",

"group": "352",

"baseUnitMeasure": "001",

"baseUnitMeasureAbbreviation": "հատ",

"alternativeUnitMeasure": "002",

"alternativeUnitMeasureAbbreviation": "տուփ",

"barcode": "45678945643121",

"specification": "512 գբ",

"externalCode": "",

"costingMethod": "2",

"vat": false,

"checkMarking": false,

"weight": false,

"showInPriceLists": true,

"environmentalFeePercent": 0.0000,

"labelUnitMeasure": "",

"labelUnitMeasureCoefficient": 1.0000000000,

"country": "",

"producer": "",

"property1": "",

"property2": "",

"minimumQuantity": 0,

"maximumQuantity": 0,

"addedValuePercent": 0.0000,

"aoeCoefficient": 1.0000,

"bonusPercent": 0.0000,

"bonusPoint": 0.0000,

"discountPercent": 0.0000,

"mainSupplierId": 100000,

"substituteItemsGroup": "",

"nameEN": "HDD",

"nameRU": "",

"additionalSpecification1": "",

"additionalSpecification2": "",

"baseUnitMeasureName": "Հատ",

"alternativeUnitMeasureName": "Տուփ",

"mainSupplierCode": "1001",

"measureUnits": [

{

"code": "001",

"abbreviation": "հատ",

"default": true,

"coefficient": 1.0000000000

{

"code": "002",

"abbreviation": "տուփ",

"default": false,

"coefficient": 10.0000000000

}

"barcodes": [

{

"unitMeasure": "001",

"abbreviation": "հատ",

"barcode": "45678945643121"

{

"unitMeasure": "001",

"abbreviation": "հատ",

"barcode": "5468735468654"

{

"unitMeasure": "001",

"abbreviation": "հատ",

"barcode": "8452015263244"

{

"unitMeasure": "002",

"abbreviation": "տուփ",

"barcode": "3568354654544"

}

]

}

POST

Request

curl -X POST \

"https://api.armsoft.am/trade/v1/directories/products/list" \

-H "accept: text/plain" \

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

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

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

-d '

{

"showMode": "3"

Response body (201 Created)

{

"data": [

{

"typeName": "Ապրանք",

"groupName": "Հեռուստացույցներ",

"groupPath": "100!110",

"labelUnitMeasureAbbreviation": "",

"costingMethodName": "ՖԻՖՈ",

"countryName": "",

"producerName": "",

"mainSupplierName": "",

"substituteItemsGroupName": "",

"lastModifierName": "",

"creatorName": "",

"prices": {},

"id": 100000,

"code": "1001",

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

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

"type": "1",

"cpaClassifier": "",

"group": "110",

"baseUnitMeasure": "001",

"baseUnitMeasureAbbreviation": "հատ",

"alternativeUnitMeasure": "002",

"alternativeUnitMeasureAbbreviation": "տուփ",

"barcode": "",

"specification": "Smart VIERA LCD TV, Size: 55\" (140 cm), Full-HD",

"externalCode": "",

"costingMethod": "1",

"vat": true,

"checkMarking": false,

"weight": false,

"showInPriceLists": true,

"environmentalFeePercent": 0,

"labelUnitMeasure": "",

"labelUnitMeasureCoefficient": 1.0000000000,

"country": "MY",

"producer": "02",

"property1": "",

"property2": "",

"minimumQuantity": 0,

"maximumQuantity": 0,

"addedValuePercent": 20.0000,

"aoeCoefficient": 1.0000,

"bonusPercent": 0,

"bonusPoint": 0,

"discountPercent": 0,

"mainSupplierId": -1,

"substituteItemsGroup": "",

"nameEN": "",

"nameRU": "",

"additionalSpecification1": "",

"additionalSpecification2": ""

{

"typeName": "Ապրանք",

"groupName": "Հեռուստացույցներ",

"groupPath": "100!110",

"labelUnitMeasureAbbreviation": "",

"costingMethodName": "ՖԻՖՈ",

"countryName": "",

"producerName": "",

"mainSupplierName": "",

"substituteItemsGroupName": "",

"lastModifierName": "",

"creatorName": "",

"prices": {},

"id": 100001,

"code": "1002",

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

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

"type": "1",

"cpaClassifier": "",

"group": "110",

"baseUnitMeasure": "001",

"baseUnitMeasureAbbreviation": "հատ",

"alternativeUnitMeasure": "001",

"alternativeUnitMeasureAbbreviation": "հատ",

"barcode": "",

"specification": "Edge LED TV , Size: 55\" (140 cm), Full HD",

"externalCode": "",

"costingMethod": "1",

"vat": true,

"checkMarking": false,

"weight": false,

"showInPriceLists": true,

"environmentalFeePercent": 0,

"labelUnitMeasure": "",

"labelUnitMeasureCoefficient": 1.0000000000,

"country": "TW",

"producer": "01",

"property1": "",

"property2": "",

"minimumQuantity": 0,

"maximumQuantity": 0,

"addedValuePercent": 0,

"aoeCoefficient": 1.0000,

"bonusPercent": 0,

"bonusPoint": 0,

"discountPercent": 0,

"mainSupplierId": -1,

"substituteItemsGroup": "",

"nameEN": "",

"nameRU": "",

"additionalSpecification1": "",

"additionalSpecification2": ""

]

}

GET

/v1/directories/products/:code

Request

curl -X GET \

"https://api.armsoft.am/trade/v1/directories/products/1001" \

-H "accept: */*" \

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

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

Response body (200 OK)

{

"id": 100000,

"code": "1001",

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

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

"type": "1",

"cpaClassifier": "",

"group": "110",

"baseUnitMeasure": "001",

"baseUnitMeasureAbbreviation": "հատ",

"alternativeUnitMeasure": "002",

"alternativeUnitMeasureAbbreviation": "տուփ",

"barcode": "11112",

"specification": "Smart VIERA LCD TV, Size: 55\" (140 cm), Full-HD",

"externalCode": "",

"costingMethod": "1",

"vat": true,

"checkMarking": false,

"weight": false,

"showInPriceLists": true,

"environmentalFeePercent": 0.0000,

"labelUnitMeasure": "",

"labelUnitMeasureCoefficient": 1.0000000000,

"country": "MY",

"producer": "02",

"property1": "",

"property2": "",

"minimumQuantity": 5.0000,

"maximumQuantity": 0.0000,

"addedValuePercent": 20.0000,

"aoeCoefficient": 1.0000,

"bonusPercent": 0.0000,

"bonusPoint": 0.0000,

"discountPercent": 0.0000,

"mainSupplierId": -1,

"substituteItemsGroup": "",

"nameEN": "",

"nameRU": "",

"additionalSpecification1": "",

"additionalSpecification2": "",

"baseUnitMeasureName": "Հատ",

"alternativeUnitMeasureName": "Տուփ",

"mainSupplierCode": "",

"measureUnits": [

{

"code": "001",

"abbreviation": "հատ",

"default": true,

"coefficient": 1.0000000000

{

"code": "002",

"abbreviation": "տուփ",

"default": false,

"coefficient": 10.0000000000

}

"barcodes": [

{

"unitMeasure": "001",

"abbreviation": "հատ",

"barcode": "11112"

}

]

}

PUT

Request

curl -X PUT \

"https://api.armsoft.am/trade/v1/directories/products/1001" \

-H "accept: text/plain" \

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

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

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

-d {

"code": "1001",

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

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

"vat": false,

"discountPercent": 15,

"nameEN": "TV LED Panasonic TX-LR55ET5"

Response body (200 OK)

{

"id": 100000,

"code": "1001",

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

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

"type": "1",

"cpaClassifier": "",

"group": "110",

"baseUnitMeasure": "001",

"baseUnitMeasureAbbreviation": "հատ",

"alternativeUnitMeasure": "002",

"alternativeUnitMeasureAbbreviation": "տուփ",

"barcode": "11112",

"specification": "Smart VIERA LCD TV, Size: 55\" (140 cm), Full-HD",

"externalCode": "",

"costingMethod": "1",

"vat": false,

"checkMarking": false,

"weight": false,

"showInPriceLists": true,

"environmentalFeePercent": 0.0000,

"labelUnitMeasure": "",

"labelUnitMeasureCoefficient": 1.0000000000,

"country": "MY",

"producer": "02",

"property1": "",

"property2": "",

"minimumQuantity": 5.0000,

"maximumQuantity": 0.0000,

"addedValuePercent": 20.0000,

"aoeCoefficient": 1.0000,

"bonusPercent": 0.0000,

"bonusPoint": 0.0000,

"discountPercent": 15.0000,

"mainSupplierId": -1,

"substituteItemsGroup": "",

"nameEN": "TV LED Panasonic TX-LR55ET5",

"nameRU": "",

"additionalSpecification1": "",

"additionalSpecification2": "",

"baseUnitMeasureName": "Հատ",

"alternativeUnitMeasureName": "Տուփ",

"mainSupplierCode": "",

"measureUnits": [

{

"code": "001",

"abbreviation": "հատ",

"default": true,

"coefficient": 1.0000000000

{

"code": "002",

"abbreviation": "տուփ",

"default": false,

"coefficient": 10.0000000000

}

"barcodes": [

{

"unitMeasure": "001",

"abbreviation": "հատ",

"barcode": "11112"

}

]

}

DELETE

/v1/directories/products/:code