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.