Skip to main content

Article — catalog item

Fields​

FieldTypeRequired on AddArticleDescription
Idinteger(auto)Unique identifier generated by the ERP
CodestringnoUnique code. If missing, the ERP generates one (0000001, 0000002, ...)
NamestringyesDisplayed name
BarCodestringnoEAN13 barcode or similar
CategoryIdintegernoReference to a category from GetAllArticleCategories
UnitOfMeasurestringnoUoM (e.g. BUC, ORA, KG)
VATRateIdintegerno (but recommended)Default VAT rate (see VATRate)
IsActivebooleanno (default true)Article active in the nomenclature
IsServicebooleanno (default false)true = service, not goods
SalePricenumbernoSale price in RON
PurchasePricenumbernoPurchase price in RON

JSON example​

{
"Id": 102,
"Code": "0000002",
"Name": "Demo Laptop 14\"",
"BarCode": "5901234567890",
"CategoryId": 2,
"UnitOfMeasure": "BUC",
"VATRateId": 1,
"IsActive": true,
"IsService": false,
"SalePrice": 4500.00,
"PurchasePrice": 3500.00
}

Associated operations​

  • GetAllArticles, GetArticleByCode, GetArticleById, GetArticleByBarCode
  • GetArticlesByNameAndCode, GetArticlesByNameCodeAndCategory
  • AddArticle, UpdateArticle, UpdateArticlePicture
  • GetAllStocksForArticles, GetStocksForArticleByCode

Business notes​

  • The code is unique at company level. Duplicating it returns Articol cu codul "X" exista deja.
  • IsService = true implies infinite Stock (quantity is not tracked).
  • Categories are optional, but useful for aggregated reports.