SmartAcc DynaMod Web API v2024.4 Build 0000 - Local

<back to all web services

Stocks

Stock Module

Stocks API

Requires Authentication
Required permission:Stock-Setup.GET
The following routes are available for this service:
GET/Stocks/page/{Page}Get records by given a page numberEach page consists of 20 records
GET/Stocks/EditDate/{EditDate}Get records that since last changed for a given date.Each page consinsts of 20 records.
GET/Stocks/StockBarcode/{StockBarcode}Get record for given barcodePlease provide value for AcLocationID in order to get POS Price
GET/Stocks/StockArticleNo/{StockArticleNo}Get records by given Article NumberAll colors and sizes of the stock would be presented if found for the given Article Number.
GET/Stocks/EditDateRange/Get records that since last changed for a given date range (SearchEditDateFrom, SearchEditDateTo).Each page consinsts of 20 records.
GET/Stocks/StockIDList/Get records for given stock ID ListMultiple records could be returned for multi-uom stocks
GET/Stocks/StockID/{AcStockID*}Get records for given stock IDMultiple records could be returned for multi-uom stocks
Stocks Parameters:
NameParameterData TypeRequiredDescription
Pagepathint?NoPage Number. Default 1.
RecordsPerPagequeryint?NoRecords Per Page. Default 20 Records.
EditDatepathDateTime?NoEdit Date. YYYY-MM-DD.
AcStockIDpathstringNoGet product info by providing Stock ID
AcLocationIDquerystringNoProvide Location ID to get it's StockPosPrice
StockBarcodepathstringNoGet product info by providing Barcode
AcStockIDListquerystring[]NoGet product info by providing Stock ID list
IsReturnImagequeryboolNoIndicate whether should return image data (if any). true;false
SearchEditDateFromqueryDateTime?NoEdit Date From (Search By Edit Date From). YYYY-MM-DD.
SearchEditDateToqueryDateTime?NoEdit Date To (Search By Edit Date To). YYYY-MM-DD.
StockArticleNopathstringNoGet product info by providing Stock Article Number
StocksResponse Parameters:
NameParameterData TypeRequiredDescription
StocksformList<Acvw_AcStockCompany>No
ResponseStatusformResponseStatusNo
TotalRecordsformintNoTotal records in all pages.
TotalRecordsInPageformintNoTotal records in current page.
Acvw_AcStockCompany Parameters:
NameParameterData TypeRequiredDescription
AcStockIDformNVARCHAR(40)NoStock ID
AcStockUOMIDformNVARCHAR(20)NoUOM ID
StockDescription1formNVARCHAR(100)NoStock Description 1
StockDescription2formNVARCHAR(100)NoStock Description 2
StockBalanceQuantityformNVARCHAR(100)NoStock Balance Quantity (Company Level, Converted Multi-Uom if Applicable)
StockBarcodeformNVARCHAR(40)NoStock Barcode
StockArticleNoformNVARCHAR(20)NoArticle Number
StockPrice1formNUMERIC(18,4)NoPrice 1
StockPrice2formNUMERIC(18,4)NoPrice 2
StockPrice3formNUMERIC(18,4)NoPrice 3
StockPrice4formNUMERIC(18,4)NoPrice 4
StockPrice5formNUMERIC(18,4)NoPrice 5
QuantityMinimumLevelformNUMERIC(18,4)NoQuantity Minimum Level
AcStockBrandIDformNVARCHAR(20)NoStock Brand ID
AcStockGroupIDformNVARCHAR(20)NoStock Group ID
AcStockCategoryIDformNVARCHAR(20)NoStock Category ID
AcStockColorIDformNVARCHAR(20)NoStock Color ID
AcStockSizeIDformNVARCHAR(20)NoStock Size ID
AcStockUDGroup1IDformNVARCHAR(20)NoStock User Define Group 1 ID
AcStockUDGroup2IDformNVARCHAR(20)NoStock User Define Group 2 ID
AcStockUDGroup3IDformNVARCHAR(20)NoStock User Define Group 3 ID
AcStockBrandDescformNVARCHAR(100)NoStock Brand Description
AcStockGroupDescformNVARCHAR(100)NoStock Group Description
AcStockCategoryDescformNVARCHAR(100)NoStock Category Description
AcStockColorDescformNVARCHAR(100)NoStock Color Description
AcStockSizeDescformNVARCHAR(100)NoStock Size Description
AcStockUDGroup1DescformNVARCHAR(100)NoStock User Define Group 1 Description
AcStockUDGroup2DescformNVARCHAR(100)NoStock User Define Group 2 Description
AcStockUDGroup3DescformNVARCHAR(100)NoStock User Define Group 3 Description
EditDateformDATETIMENoRecord Edit DateTime
AccountNoSalesformNVARCHAR(20)NoAccount Number (Sales)
AccountNoSalesDiscountformNVARCHAR(20)NoAccount Number (Sales Discount)
AccountNoSalesReturnformNVARCHAR(20)NoAccount Number (Sales Return)
AccountNoPurchaseformNVARCHAR(20)NoAccount Number (Purchase)
AccountNoPurchaseDiscountformNVARCHAR(20)NoAccount Number (Purchase Discount)
AccountNoPurchaseReturnformNVARCHAR(20)NoAccount Number (Purchase Return)
StockPosPriceformNUMERIC(18,4)NoPOS Price (Value will presented if AcLocationID in parameter provided). Else 0.00
StockDimensionHeightformNUMERIC(18,6)NoDimension - Height
StockDimensionWidthformNUMERIC(18,6)NoDimension - Width
StockDimensionLengthformNUMERIC(18,6)NoDimension - Length
AcStockUOMIDDimensionformNVARCHAR(20)NoDimension - UOM ID
StockWeightformNUMERIC(18,6)NoStock Weight
AcStockUOMIDWeightformNVARCHAR(20)NoStock Weight - UOM ID
AcStockUOMIDWeighingTypeformNVARCHAR(20)NoWeighing Type - UOM ID
AcStockTypeIDformNVARCHAR(20)NoStock Type ID. STOCK; SERVICE; NON-STOCK
StockISBNformNVARCHAR(100)NoStock ISBN
StockIsActiveformNVARCHAR(1)NoIs Active? Y: Active; N: Inactive
StockExtraRemark1formNVARCHAR(100)NoStock Extra Remark 1
StockExtraRemark2formNVARCHAR(100)NoStock Extra Remark 2
StockExtraRemark3formNVARCHAR(100)NoStock Extra Remark 3
StockExtraRemark4formNVARCHAR(100)NoStock Extra Remark 4
ImageDisplayBase64formVARCHAR(MAX)NoStock Display Image in Base64 Encoding.
IsStockNotesAddToSalesformNVARCHAR(1)NoIs Stock Note add to sales? (Y/N)
StockNotesformNVARCHAR(MAX)NoStock Notes. Also known as Sales Notes in Dynamod Stock Maintenance.
IsStockNotesAddToPurchaseformNVARCHAR(1)NoIs Stock Note Purchase add to purchase? (Y/N)
StockNotesPurchaseformNVARCHAR(MAX)NoStock Notes purchases.
StockCostformNUMERIC(18,4)NoStock Cost.
StockIsSerialNumberformNVARCHAR(1)NoIs Serial Number Stock (Y/N)
AcEInvoiceItemClassificationIDformNVARCHAR(40)YesE-Invoice Item Classification ID
AcEInvoiceItemTaxTypeIDformNVARCHAR(40)YesE-Invoice Item Tax Type ID
AcTaxIDSupplySSTformNVARCHAR(20)YesTax Code (SST) (Supply)
AcTaxIDPurchaseSSTformNVARCHAR(20)YesTax Code (SST) (Purchase)
AcTaxIDSupplyformNVARCHAR(20)YesTax Code (GST) (Supply)
AcTaxIDPurchaseformNVARCHAR(20)YesTax Code (GST) (Purchase)

To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /Stocks/page/{Page} HTTP/1.1 
Host: snr2u.com 
Accept: text/csv
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"Stocks":[{"AcStockID":"String","AcStockUOMID":"String","StockDescription1":"String","StockDescription2":"String","StockBalanceQuantity":0,"StockBarcode":"String","StockArticleNo":"String","StockPrice1":0,"StockPrice2":0,"StockPrice3":0,"StockPrice4":0,"StockPrice5":0,"QuantityMinimumLevel":0,"AcStockBrandID":"String","AcStockGroupID":"String","AcStockCategoryID":"String","AcStockColorID":"String","AcStockSizeID":"String","AcStockUDGroup1ID":"String","AcStockUDGroup2ID":"String","AcStockUDGroup3ID":"String","AcStockBrandDesc":"String","AcStockGroupDesc":"String","AcStockCategoryDesc":"String","AcStockColorDesc":"String","AcStockSizeDesc":"String","AcStockUDGroup1Desc":"String","AcStockUDGroup2Desc":"String","AcStockUDGroup3Desc":"String","EditDate":"\/Date(-62135596800000-0000)\/","AccountNoSales":"String","AccountNoSalesDiscount":"String","AccountNoSalesReturn":"String","AccountNoPurchase":"String","AccountNoPurchaseDiscount":"String","AccountNoPurchaseReturn":"String","StockPosPrice":0,"StockDimensionHeight":0,"StockDimensionWidth":0,"StockDimensionLength":0,"AcStockUOMIDDimension":"String","StockWeight":0,"AcStockUOMIDWeight":"String","AcStockUOMIDWeighingType":"String","AcStockTypeID":"String","StockISBN":"String","StockIsActive":"String","StockExtraRemark1":"String","StockExtraRemark2":"String","StockExtraRemark3":"String","StockExtraRemark4":"String","ImageDisplayBase64":"String","IsStockNotesAddToSales":"String","StockNotes":"String","IsStockNotesAddToPurchase":"String","StockNotesPurchase":"String","StockCost":0,"StockIsSerialNumber":"String","AcEInvoiceItemClassificationID":"String","AcEInvoiceItemTaxTypeID":"String","AcTaxIDSupplySST":"String","AcTaxIDPurchaseSST":"String","AcTaxIDSupply":"String","AcTaxIDPurchase":"String"}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}},"TotalRecords":0,"TotalRecordsInPage":0}