Articles API
General:
Basics:
Base-URL: https://capi.lagerkoll.com/v1/articles/
Parameters in the url should all be encoded and all data sent should be UTF-8
MAX number of requests per minute is set to 200.
When the limit is hit an error with code 429 is returned, with the header "Retry-After" containing the number of seconds you have to wait for your next request.
When the limit is hit an error with code 429 is returned, with the header "Retry-After" containing the number of seconds you have to wait for your next request.
Headers:
There are 2 ways to be authenticated when using this API. in both ways you add headers to the request.
1) Use an API-key together with store-id. This would be used when communicating machine to machine and no real person is involved. The API-key is available from where you activated the API. The store-id is also available in the same place.
2) Use a user_id and user_token together with a store-id. You get these values from the login-request. The values are connected to a person and are gained when an actual login to the system has been made.
1) Use an API-key together with store-id. This would be used when communicating machine to machine and no real person is involved. The API-key is available from where you activated the API. The store-id is also available in the same place.
2) Use a user_id and user_token together with a store-id. You get these values from the login-request. The values are connected to a person and are gained when an actual login to the system has been made.
store: <<STORE>> user_id: <<USER_ID>> user_token: <<USER_TOKEN>> api_key: <<API_KEY>> Accept: application/json Content-Type: application/json
Errors:
Code | Description |
---|---|
900001 | Credentials don't match |
900101 | Common error |
900429 | Too many requests |
900201 | Error when getting an article |
900202 | Error when creating an article |
900203 | Error when updating an article |
900204 | Error when deleting an article |
900211 | Error when getting batches on article |
900221 | Error when getting serial number on article |
900212 | Error when creating a batch on article |
900222 | Error when creating a serialnumber on article |
900213 | Error when updating batch on article |
900223 | Error when updating serialnumber on article |
900214 | Error when deleting batch on article |
900224 | Error when deleting serialnumber on article |
900803 | Error when updating customfield template |
900232 | Error when importing articles |
900233 | Error when getting import template |
900234 | Error when adding import template |
900235 | Error when updating import template |
900236 | Error when deleting import template |
900241 | Error when exporting articles |
900251 | Error when getting an article units |
900252 | Error when creating an article unit |
900253 | Error when updating an article unit |
900254 | Error when deleting an article unit |
{ "errorCode" : 900101, "errorMessage" : "Something went wrong on the server", "errorField" : null, "errorData" : null }
Articles API:
Article units
Get article units
GETUrl: /{id : .+}/article_units
Headers:
Accept: application/json or application/xml
Get article units for a specific article
Body:
Successfull response:
{"units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 1776 }, "articleId": "articleId", "storegroupId": 3657, "convert": 6322.740788189789, "barcode": "barcode" }]}
Add article unit
POSTUrl: /{id : .+}/article_units
Headers:
Accept: application/json or application/xml
Add article unit for a specific article
Body:
{ "unit": { "name": "name", "id": 8423 }, "convert": 2988.8520343436776, "barcode": "barcode" }
Successfull response:
Set article units
POSTUrl: /{id : .+}/article_units/list
Headers:
Accept: application/json or application/xml
Replace list of article units for a specific article
Update article unit
PUTUrl: /{id : .+}/article_units/{unit_id}
Headers:
Accept: application/json or application/xml
Update existing article unit for a specific article
Body:
{ "unit": { "name": "name", "externalId": "externalId", "id": 4213 }, "articleId": "articleId", "storegroupId": 6515, "convert": 1585.078083355449, "barcode": "barcode" }
Successfull response:
Remove article unit
DELETEUrl: /{id : .+}/article_units/{unit_id}
Headers:
Accept: application/json or application/xml
Remove article unit from a specific article
Body:
Successfull response:
Articles
Get bundle products from part
GETUrl: /{id : .+}/bundle
Headers:
Accept: application/json or application/xml
Get all bundle products which includes a specific part
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
page | 0 | ||
limit | 100 |
Body:
Successfull response:
{ "totalSerialNumbersReserved": 2651.7165038424773, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 6177.69658980806, "bestBefore": 6608, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 2546.1593422643505, "totalSerialNumbersInStock": 36.25170749620432, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 5004.091978772019, "bestBefore": 289, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 7826.361871114223, "totalBatches": 9023, "totalSerialNumbers": 7636 }
Get article tags
GETUrl: /tags
Headers:
Accept: application/json or application/xml
Get article tags for store group
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
page | 0 | ||
limit | 50 |
Body:
Successfull response:
{ "pages": 7519, "pageSize": 1102, "page": 852, "projectsCount": 5041, "tags": [{ "name": "name", "externalId": "externalId", "id": 5538, "desc": "desc" }] }
Get article fifo
GETUrl: /{id : .+}/fifo
Headers:
Accept: application/json or application/xml
Get an article fifo based on article-id
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
page | 0 | ||
limit | 25 |
Body:
Successfull response:
{ "pages": 7447, "pageSize": 3704, "fifos": [{ "date": 1732182655696, "supplierName": "supplierName", "amount": 1657.323490629209, "supplierOrderId": 4663, "supplierId": 5461, "poRef": "poRef", "description": "description", "purchasePrice": 3623.8265931602064, "userName": "userName", "userId": 9887, "amountInStock": 5097.6212944647805, "purchaseRate": 8759.037120930452, "id": 1175 }], "fifoCount": 1672, "page": 2758, "since": 3941 }
Get other articles
GETUrl: /{article_id}/other_purchased
Headers:
Accept: application/json or application/xml
Based on an article a list of other interesting articles is returned
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
amount | 5 |
Body:
Successfull response:
{ "pages": 4529, "pageSize": 7478, "page": 4411, "articlesCount": 4088, "articles": [{ "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 7259.203461803716, "supplierExternalId": "supplierExternalId", "type": "type", "price": 7511.315265274593, "supplier": 1294, "supplierArticleId": "supplierArticleId", "vatAccount": 8051, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 5243.951749539481, "bundled": "false", "vat": 8340.889487776534, "nextDeliveryDate": 6332, "active": "true", "weight": 9796.013911627153, "tags": [{ "name": "name", "externalId": "externalId", "id": 3896, "desc": "desc" }], "supplierBuyRate": 8387.610248650155, "unit": "st", "reserved": 1797.0635855891849, "name": "name", "parts": [{ "buyPrice": 1551.265723176023, "supplierName": "supplierName", "amount": 5774.463142976792, "articleName": "articleName", "supplierId": 8573, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 2221.880149569857, "buyPriceShipment": 9974.076676902321, "buyPriceMisc": 5244.505233227374, "supplierArticleId": "supplierArticleId", "stock": 472.32944074479644, "isStock": true, "stockWarning": 2537.438769447051 }], "supplierBuyPriceShipment": 22.41212032790596, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 8043, "orderedAmount": 8925.18584102296, "stockWarning": 9170.591492651423, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 3278.7399465007384, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 3600.545193787098, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 1576.1281805710082, "bestBefore": 1977, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 3094.219878552653, "totalSerialNumbersInStock": 7281.533656472293, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 9747.107353683106, "bestBefore": 3857, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 6633.2846660917, "totalBatches": 7592, "totalSerialNumbers": 650 }, "webshopArticle": "false", "availableAmount": 5611.9200016551895, "orderLevel": 927.4890212633802, "prices": [{ "listId": 5327, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 595.3804447155043, "supplierBuyRate": "1.0", "supplierBuyPrice": 9579.14515194663, "supplier": 4715, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 9149.116741950202 }], "automaticOrder": true, "supplierName": "supplierName", "deliveredAmount": 7548.906294596207, "amount": 992.8922606995272, "articleId": "articleId", "externalId": "externalId", "depth": 2311.3578651289613, "supplierBuyPrice": 9630.378989287316, "supplierBuyCurrency": "supplierBuyCurrency", "width": 4581.00951172452, "category": "övrigt" }], "since": 8928 }
Get articles
GETUrl:
Headers:
Accept: application/json or application/xml
Get a list of articles based on parameters
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
since | Default value is current time. To get all articles you must set the since-parameter | ||
page | 0 | ||
limit | 25 | ||
order | desc | asc,desc | |
sort_column | query | query,art,name,bundled,cat,unit,stock_place,stock_place_article,desc,price,order,warning_order,stock,reserved,available,supplier,is_stock,type,status,active | |
details | true | ||
tags | true | ||
prices | false | ||
include_purchase_prices | false | ||
filter_outof_stock | false | ||
filter_stock_warning | false | ||
filter_non_stock | false | ||
filter_non_active | false | ||
filter_regardless_bundled | true | ||
include_image_last_updated | false | ||
include_bundle | false | ||
include_next_delivery | false | ||
include_batches | false | ||
supplier_id |
Body:
Successfull response:
{ "pages": 9498, "pageSize": 1359, "page": 3907, "articlesCount": 3222, "articles": [{ "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 3509.663598199937, "supplierExternalId": "supplierExternalId", "type": "type", "price": 259.2242515398702, "supplier": 649, "supplierArticleId": "supplierArticleId", "vatAccount": 8410, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 265.7605700683097, "bundled": "false", "vat": 5067.369221088828, "nextDeliveryDate": 9040, "active": "true", "weight": 533.3637104871635, "tags": [{ "name": "name", "externalId": "externalId", "id": 4824, "desc": "desc" }], "supplierBuyRate": 9042.274239968434, "unit": "st", "reserved": 9351.27416237989, "name": "name", "parts": [{ "buyPrice": 1448.763006472694, "supplierName": "supplierName", "amount": 4018.3862666667246, "articleName": "articleName", "supplierId": 5618, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 7062.33923814073, "buyPriceShipment": 6398.108770713722, "buyPriceMisc": 3610.6041356726646, "supplierArticleId": "supplierArticleId", "stock": 415.03670230255585, "isStock": false, "stockWarning": 8007.8987378292895 }], "supplierBuyPriceShipment": 5355.624661077637, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 3594, "orderedAmount": 8122.924587871841, "stockWarning": 7724.817934477287, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 2140.4957185788653, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 4970.7784098208185, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 928.7045613389611, "bestBefore": 6614, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 7435.920076298366, "totalSerialNumbersInStock": 7371.263295036059, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 1219.5722129236087, "bestBefore": 7637, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 4266.793855722064, "totalBatches": 3699, "totalSerialNumbers": 4671 }, "webshopArticle": "false", "availableAmount": 4857.376788760319, "orderLevel": 125.35589246850942, "prices": [{ "listId": 9741, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 6024.041115470563, "supplierBuyRate": "1.0", "supplierBuyPrice": 8953.346576874603, "supplier": 8490, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 3722.0000274224894 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 1170.9735732054428, "amount": 4361.709291609775, "articleId": "articleId", "externalId": "externalId", "depth": 5322.970925821474, "supplierBuyPrice": 5786.023310931078, "supplierBuyCurrency": "supplierBuyCurrency", "width": 9204.935232372025, "category": "övrigt" }], "since": 8283 }
Get storegroup articles
GETUrl: /group
Headers:
Accept: application/json or application/xml
Search for articles across all stores in a storegroup
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
page | 0 | ||
limit | 25 | ||
order | asc | asc,desc | |
sort_column | art | query,art,name,store |
Body:
Successfull response:
{ "pages": 5156, "pageSize": 5812, "page": 7258, "articlesCount": 4161, "articles": [{ "availableAmount": 5769.9623827684845, "articleId": "articleId", "name": "name", "storeName": "storeName", "storeId": 7195 }], "since": 1438 }
Get articles for supplier
GETUrl: /supplier/{supplier_id}
Headers:
Accept: application/json or application/xml
Get a list of articles connected to a supplier
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
page | 0 | ||
limit | 25 | ||
order | asc | asc,desc | |
sort_column | name | art,name,bundled,cat,unit,stock_place,stock_place_article,desc,price,order,warning_order,stock,reserved,supplier,is_stock,type,status,active |
Body:
Successfull response:
{ "pages": 3961, "pageSize": 8940, "page": 4284, "articlesCount": 7943, "articles": [{ "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 7681.56611902153, "supplierExternalId": "supplierExternalId", "type": "type", "price": 9261.46939768716, "supplier": 4563, "supplierArticleId": "supplierArticleId", "vatAccount": 4111, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 590.3899756915887, "bundled": "false", "vat": 5844.187700392172, "nextDeliveryDate": 8488, "active": "true", "weight": 9972.580252478514, "tags": [{ "name": "name", "externalId": "externalId", "id": 4898, "desc": "desc" }], "supplierBuyRate": 4711.053667402344, "unit": "st", "reserved": 8110.058914525461, "name": "name", "parts": [{ "buyPrice": 6614.679818495698, "supplierName": "supplierName", "amount": 5454.578346600309, "articleName": "articleName", "supplierId": 8142, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 8989.99845240274, "buyPriceShipment": 8142.149557472715, "buyPriceMisc": 7114.25805983954, "supplierArticleId": "supplierArticleId", "stock": 3041.119684611514, "isStock": false, "stockWarning": 4492.801884642013 }], "supplierBuyPriceShipment": 4746.983714343961, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 7790, "orderedAmount": 6395.2796873111365, "stockWarning": 5833.880260070493, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 5057.772292788183, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 4332.7517861993765, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 7531.727878627506, "bestBefore": 1164, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 9460.787734711095, "totalSerialNumbersInStock": 4210.949972897378, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 5539.616279807527, "bestBefore": 7895, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 4193.794499530287, "totalBatches": 8923, "totalSerialNumbers": 1871 }, "webshopArticle": "false", "availableAmount": 7943.185116726544, "orderLevel": 609.1954407666523, "prices": [{ "listId": 8507, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 7459.308555109582, "supplierBuyRate": "1.0", "supplierBuyPrice": 3691.2847157463157, "supplier": 1436, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 8182.188657326293 }], "automaticOrder": true, "supplierName": "supplierName", "deliveredAmount": 3121.70636154904, "amount": 2191.560858618127, "articleId": "articleId", "externalId": "externalId", "depth": 8212.219076680478, "supplierBuyPrice": 3592.0623190845713, "supplierBuyCurrency": "supplierBuyCurrency", "width": 1429.5246801768535, "category": "övrigt" }], "since": 4462 }
Get articles for category
GETUrl: /category/{category_id}
Headers:
Accept: application/json or application/xml
Get a list of articles connected to a category
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
page | 0 | ||
limit | 25 | ||
order | asc | asc,desc | |
sort_column | name | art,name,bundled,cat,unit,stock_place,stock_place_article,desc,price,order,warning_order,stock,reserved,supplier,is_stock,type,status,active | |
details | true | ||
prices | false | ||
include_purchase_prices | false | ||
include_image_last_updated | false | ||
include_bundle | false | ||
include_next_delivery | false | ||
include_batches | false |
Body:
Successfull response:
{ "pages": 4334, "pageSize": 9460, "page": 9039, "articlesCount": 2335, "articles": [{ "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 3831.5497089801565, "supplierExternalId": "supplierExternalId", "type": "type", "price": 2867.214018709002, "supplier": 5262, "supplierArticleId": "supplierArticleId", "vatAccount": 9845, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 1132.9432397475248, "bundled": "false", "vat": 3990.113175407035, "nextDeliveryDate": 7011, "active": "true", "weight": 9411.782367923375, "tags": [{ "name": "name", "externalId": "externalId", "id": 1079, "desc": "desc" }], "supplierBuyRate": 169.70629883055088, "unit": "st", "reserved": 8336.29310901132, "name": "name", "parts": [{ "buyPrice": 6636.865790805501, "supplierName": "supplierName", "amount": 7585.850867125322, "articleName": "articleName", "supplierId": 8108, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 5428.860442865744, "buyPriceShipment": 9393.517549434302, "buyPriceMisc": 4369.955657371428, "supplierArticleId": "supplierArticleId", "stock": 8369.458329281813, "isStock": true, "stockWarning": 4511.698597398254 }], "supplierBuyPriceShipment": 5426.535577824711, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 1093, "orderedAmount": 309.09205312327657, "stockWarning": 6902.313152595157, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 273.2520886106282, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 446.50899538493104, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 4941.366050822035, "bestBefore": 4234, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 8777.271435683047, "totalSerialNumbersInStock": 7762.788100719042, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 8742.742307074559, "bestBefore": 4896, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 297.9836978207051, "totalBatches": 2841, "totalSerialNumbers": 5346 }, "webshopArticle": "false", "availableAmount": 9474.099239946361, "orderLevel": 2648.723006933681, "prices": [{ "listId": 905, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 8348.035182060794, "supplierBuyRate": "1.0", "supplierBuyPrice": 9402.018563675225, "supplier": 7381, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 8741.225544237774 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 589.9442462235072, "amount": 1351.9175272743855, "articleId": "articleId", "externalId": "externalId", "depth": 576.6837098194933, "supplierBuyPrice": 6393.042758529936, "supplierBuyCurrency": "supplierBuyCurrency", "width": 4792.8768177946295, "category": "övrigt" }], "since": 4964 }
Get stockplaces
GETUrl: /stockplaces
Headers:
Accept: application/json or application/xml
Get list of stockplaces used in articles
Body:
Successfull response:
{"stockplaces": [{ "articles": 2587, "stockplace": "stockplace" }]}
Get history articles
GETUrl: /history
Headers:
Accept: application/json or application/xml
Get a list of articles for a specific date
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
page | 0 | ||
limit | 25 | ||
date | |||
category | Include a category-id to only include articles for this category | ||
include_paging_info | true |
Body:
Successfull response:
{ "pages": 6875, "pageSize": 9317, "page": 7009, "articlesCount": 1958, "articles": [{ "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 2619.163753367736, "supplierExternalId": "supplierExternalId", "type": "type", "price": 6522.098745945569, "supplier": 3656, "supplierArticleId": "supplierArticleId", "vatAccount": 4206, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 7977.330777965834, "bundled": "false", "vat": 8029.50422935303, "nextDeliveryDate": 902, "active": "true", "weight": 7979.317667707767, "tags": [{ "name": "name", "externalId": "externalId", "id": 9752, "desc": "desc" }], "supplierBuyRate": 8137.709739109074, "unit": "st", "reserved": 7195.777216223198, "name": "name", "parts": [{ "buyPrice": 356.80229302857856, "supplierName": "supplierName", "amount": 2845.5098878570484, "articleName": "articleName", "supplierId": 1162, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 5405.025598461225, "buyPriceShipment": 4796.603195031344, "buyPriceMisc": 3917.010529273052, "supplierArticleId": "supplierArticleId", "stock": 645.1954141708671, "isStock": false, "stockWarning": 8321.076253076048 }], "supplierBuyPriceShipment": 4911.36921675113, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 7933, "orderedAmount": 9643.82360300639, "stockWarning": 2975.1391445421596, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 2821.8812433908847, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 3320.3491136816674, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 241.99372920926442, "bestBefore": 8506, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 632.2740239015257, "totalSerialNumbersInStock": 7269.604522689699, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 5229.837280292073, "bestBefore": 7106, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 8942.928852354215, "totalBatches": 228, "totalSerialNumbers": 9249 }, "webshopArticle": "false", "availableAmount": 5553.680352234764, "orderLevel": 8549.74177127354, "prices": [{ "listId": 9916, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 7524.228198854324, "supplierBuyRate": "1.0", "supplierBuyPrice": 4920.616848715808, "supplier": 4298, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 1810.4520951364655 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 5603.4611824729045, "amount": 7147.442892372932, "articleId": "articleId", "externalId": "externalId", "depth": 9987.63536395402, "supplierBuyPrice": 3844.7745038769244, "supplierBuyCurrency": "supplierBuyCurrency", "width": 4527.658276363035, "category": "övrigt" }], "since": 2756 }
Get history articles info
GETUrl: /history/info
Headers:
Accept: application/json or application/xml
Get info on number of articles and pages exists in stock for given date
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
limit | 25 | ||
date | |||
category | Include a category-id to only include articles for this category |
Body:
Successfull response:
{ "pages": 1768, "pageSize": 415, "page": 8446, "articlesCount": 3998, "articles": [{ "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 7593.784823692739, "supplierExternalId": "supplierExternalId", "type": "type", "price": 9827.714833938886, "supplier": 9471, "supplierArticleId": "supplierArticleId", "vatAccount": 9423, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 8915.786736481628, "bundled": "false", "vat": 69.12033960018049, "nextDeliveryDate": 143, "active": "true", "weight": 498.0862128705277, "tags": [{ "name": "name", "externalId": "externalId", "id": 4117, "desc": "desc" }], "supplierBuyRate": 5309.971321020169, "unit": "st", "reserved": 5920.370773573495, "name": "name", "parts": [{ "buyPrice": 8077.580190012078, "supplierName": "supplierName", "amount": 9163.94027291556, "articleName": "articleName", "supplierId": 1458, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 2547.2006259164727, "buyPriceShipment": 3975.8892706020333, "buyPriceMisc": 7186.88199858034, "supplierArticleId": "supplierArticleId", "stock": 5771.5108716553905, "isStock": false, "stockWarning": 5178.253136925716 }], "supplierBuyPriceShipment": 3025.370797573648, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 688, "orderedAmount": 1670.8131708568085, "stockWarning": 3621.1644400380983, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 4848.6409877769665, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 5778.801843796079, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 4978.718439977962, "bestBefore": 2386, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 7919.989763496742, "totalSerialNumbersInStock": 1041.1195340754075, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2413.1104462140406, "bestBefore": 3195, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 9338.019420467053, "totalBatches": 9175, "totalSerialNumbers": 4921 }, "webshopArticle": "false", "availableAmount": 5670.081362036868, "orderLevel": 1021.355674066976, "prices": [{ "listId": 4573, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 8636.68272066404, "supplierBuyRate": "1.0", "supplierBuyPrice": 1455.0700727189546, "supplier": 997, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 1269.7048294921399 }], "automaticOrder": true, "supplierName": "supplierName", "deliveredAmount": 3266.11571693079, "amount": 3204.9112228245513, "articleId": "articleId", "externalId": "externalId", "depth": 7628.020845093504, "supplierBuyPrice": 2181.7603855888424, "supplierBuyCurrency": "supplierBuyCurrency", "width": 7669.403466319927, "category": "övrigt" }], "since": 2552 }
Get articles for autocomplete
GETUrl: /autocomplete
Headers:
Accept: application/json or application/xml
Get a list of articles with bare minimum of fields to use for autocomplete fields
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
light | true | ||
query | |||
pricelist_id | -1 | ||
supplier_id | -1 | ||
page | 0 | ||
limit | 20 |
Body:
Successfull response:
{ "pages": 2941, "pageSize": 3604, "page": 5568, "articlesCount": 4705, "articles": [{ "supplierBuyPriceMisc": 7151.01812164257, "amount": 6361.319725027398, "bundled": true, "barcodeType": "EAN", "articleId": "articleId", "vat": 331.492969106697, "active": true, "type": "type", "supplierBuyRate": 755.6846760771052, "unit": "unit", "reserved": 2936.3850338852826, "price": 930.0539579392853, "supplierBuyPrice": 9590.985345044945, "name": "name", "supplierBuyCurrency": "supplierBuyCurrency", "supplierBuyPriceShipment": 4858.537281760998, "stock": false, "barcode": "barcode" }] }
Get articles low in stock
GETUrl: /stockwarning
Headers:
Accept: application/json or application/xml
Get a list of articles below stock warning
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
filter_warning_flag | false | ||
set_articles_warned | false |
Body:
Successfull response:
{ "pages": 8389, "pageSize": 4590, "page": 6279, "articlesCount": 1524, "articles": [{ "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 944.2646398320919, "supplierExternalId": "supplierExternalId", "type": "type", "price": 690.6951629175672, "supplier": 4501, "supplierArticleId": "supplierArticleId", "vatAccount": 1669, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 7736.089410056108, "bundled": "false", "vat": 7279.090274809202, "nextDeliveryDate": 4924, "active": "true", "weight": 2606.59968602203, "tags": [{ "name": "name", "externalId": "externalId", "id": 8657, "desc": "desc" }], "supplierBuyRate": 8512.393237106744, "unit": "st", "reserved": 8358.452163533468, "name": "name", "parts": [{ "buyPrice": 6182.933910497315, "supplierName": "supplierName", "amount": 4123.249180900035, "articleName": "articleName", "supplierId": 2082, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 4031.6819930788574, "buyPriceShipment": 4501.750829769155, "buyPriceMisc": 8445.482714485686, "supplierArticleId": "supplierArticleId", "stock": 8597.522132685572, "isStock": false, "stockWarning": 8600.772219610604 }], "supplierBuyPriceShipment": 2090.64827711256, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 8890, "orderedAmount": 7813.7340270699515, "stockWarning": 3413.2332806930453, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 3296.1241215850578, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 9413.489703045052, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 7941.752203481606, "bestBefore": 8615, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 6121.6057645796955, "totalSerialNumbersInStock": 3488.3243507638686, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 3140.3231465556746, "bestBefore": 4871, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 4304.174196127818, "totalBatches": 2440, "totalSerialNumbers": 1797 }, "webshopArticle": "false", "availableAmount": 6542.774610937965, "orderLevel": 9784.730596294288, "prices": [{ "listId": 1044, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 1896.3737242077727, "supplierBuyRate": "1.0", "supplierBuyPrice": 5526.141966984324, "supplier": 2871, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 8498.155173687826 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 8242.190270622432, "amount": 669.1746532456943, "articleId": "articleId", "externalId": "externalId", "depth": 3196.9528001773683, "supplierBuyPrice": 4392.024211384244, "supplierBuyCurrency": "supplierBuyCurrency", "width": 6018.658344430584, "category": "övrigt" }], "since": 5865 }
Count articles low in stock
GETUrl: /stockwarning/count
Headers:
Accept: application/json or application/xml
Get the number of articles below stock warning
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
include_ordered | true |
Get article (external)
GETUrl: /external/{id : .+}
Headers:
Accept: application/json or application/xml
Get an article based on external article-id
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
prices | false | ||
include_bundle | false | ||
include_next_delivery | false | ||
include_purchase_prices | false | ||
include_batches | false | ||
sort_column | batch_id | batch_id,serie_nr,amount,best_before | |
order | desc | asc,desc |
Body:
Successfull response:
{ "pages": 107, "pageSize": 9041, "page": 5133, "articlesCount": 195, "articles": [{ "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 5239.560411578731, "supplierExternalId": "supplierExternalId", "type": "type", "price": 4771.6222686210685, "supplier": 1027, "supplierArticleId": "supplierArticleId", "vatAccount": 7542, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 5844.264454925936, "bundled": "false", "vat": 1898.7677820113158, "nextDeliveryDate": 5934, "active": "true", "weight": 6581.332034148109, "tags": [{ "name": "name", "externalId": "externalId", "id": 3259, "desc": "desc" }], "supplierBuyRate": 948.3755414523154, "unit": "st", "reserved": 9330.13909996125, "name": "name", "parts": [{ "buyPrice": 5579.387894160383, "supplierName": "supplierName", "amount": 4472.601234347443, "articleName": "articleName", "supplierId": 272, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 4611.969246640883, "buyPriceShipment": 4958.7171634944325, "buyPriceMisc": 1613.8563762649726, "supplierArticleId": "supplierArticleId", "stock": 2480.9516969566394, "isStock": false, "stockWarning": 6118.045451070625 }], "supplierBuyPriceShipment": 4663.11178401261, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 2522, "orderedAmount": 8661.652097287248, "stockWarning": 3503.0463375153377, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 6883.27895730735, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 3052.112945249368, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 227.45893479475643, "bestBefore": 8751, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 4394.835188886938, "totalSerialNumbersInStock": 8511.654608699018, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2729.011872809688, "bestBefore": 2279, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 3545.2176467012564, "totalBatches": 2186, "totalSerialNumbers": 7702 }, "webshopArticle": "false", "availableAmount": 1219.291650615052, "orderLevel": 3408.6023907512085, "prices": [{ "listId": 699, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 5281.3027802467695, "supplierBuyRate": "1.0", "supplierBuyPrice": 610.9299684275593, "supplier": 3942, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 2472.683460465084 }], "automaticOrder": true, "supplierName": "supplierName", "deliveredAmount": 4734.079828241794, "amount": 9591.148187655715, "articleId": "articleId", "externalId": "externalId", "depth": 6331.872189328085, "supplierBuyPrice": 9836.388171539344, "supplierBuyCurrency": "supplierBuyCurrency", "width": 5928.833150004991, "category": "övrigt" }], "since": 5634 }
Get article
GETUrl: /{id : .+}
Headers:
Accept: application/json or application/xml
Get an article based on article-id
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
prices | false | ||
include_bundle | false | ||
include_next_delivery | false | ||
include_purchase_prices | false | ||
include_batches | false | ||
sort_column | batch_id | batch_id,serie_nr,amount,best_before | |
order | desc | asc,desc |
Body:
Successfull response:
{ "pages": 4123, "pageSize": 3762, "page": 7508, "articlesCount": 5491, "articles": [{ "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 442.0557582049678, "supplierExternalId": "supplierExternalId", "type": "type", "price": 1497.8406791411503, "supplier": 7972, "supplierArticleId": "supplierArticleId", "vatAccount": 8334, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 1081.7339665868108, "bundled": "false", "vat": 6930.226536421957, "nextDeliveryDate": 5228, "active": "true", "weight": 4835.928942998106, "tags": [{ "name": "name", "externalId": "externalId", "id": 9945, "desc": "desc" }], "supplierBuyRate": 6857.891713949427, "unit": "st", "reserved": 764.8254447474978, "name": "name", "parts": [{ "buyPrice": 8961.21901908793, "supplierName": "supplierName", "amount": 179.59316989107467, "articleName": "articleName", "supplierId": 746, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 5976.42221938236, "buyPriceShipment": 8027.7121254895, "buyPriceMisc": 1114.7488370506865, "supplierArticleId": "supplierArticleId", "stock": 3557.418922893526, "isStock": true, "stockWarning": 8444.57137150937 }], "supplierBuyPriceShipment": 9764.105627931787, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 7293, "orderedAmount": 7965.360849881204, "stockWarning": 6567.299237137146, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 1582.4345051026146, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 4936.523425150979, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 7212.613989041977, "bestBefore": 5361, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 2373.1025120361182, "totalSerialNumbersInStock": 5475.338648319507, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 3352.2624173459913, "bestBefore": 801, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 9932.500932997733, "totalBatches": 2640, "totalSerialNumbers": 2064 }, "webshopArticle": "false", "availableAmount": 8737.379885375021, "orderLevel": 659.5425105135378, "prices": [{ "listId": 6081, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 6393.4213735851, "supplierBuyRate": "1.0", "supplierBuyPrice": 6315.709003446668, "supplier": 1165, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 1868.221801032337 }], "automaticOrder": true, "supplierName": "supplierName", "deliveredAmount": 9337.795618033953, "amount": 985.781812052069, "articleId": "articleId", "externalId": "externalId", "depth": 4377.463966272426, "supplierBuyPrice": 8091.624738512697, "supplierBuyCurrency": "supplierBuyCurrency", "width": 8521.841936891804, "category": "övrigt" }], "since": 8875 }
Get article history
GETUrl: /{id : .+}/history
Headers:
Accept: application/json or application/xml
Get an article history based on article-id
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
page | 0 | ||
limit | 25 |
Body:
Successfull response:
{ "pages": 5208, "pageSize": 4912, "page": 2856, "historyCount": 1617, "history": [{ "supplierName": "supplierName", "reason": "reason", "supplierId": 2611, "newSalesPrice": 8875.040458524805, "oldCount": 5928.301740189305, "newCount": 5341.33120032218, "pricelistId": 7315, "pricelistName": "pricelistName", "created": 1732182655743, "oldSalesPrice": 9861.147061812668, "articleId": "articleId", "userName": "userName", "newReserved": 1094.074339525235, "userId": 6943, "newPurchasePrice": 9585.689378077805, "oldPurchasePrice": 3476.305342051268, "oldReserved": 6904.027007731939 }], "since": 2432 }
Get next article id
GETUrl: /next_id
Headers:
Accept: application/json or application/xml
Get next available unique article id
Add new article
POSTUrl:
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Add a new article
Body:
{ "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 1916.019410370815, "customFields": [{ "name": "name", "type": "type", "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "type": "type", "criticalLevel": 4688.389311124076, "manufacturer": "manufacturer", "webshopArticle": "false", "orderLevel": 3019.1818840735605, "price": 9533.297978465898, "supplier": 4363, "supplierArticleId": "supplierArticleId", "vatAccount": 7729, "links": [{ "name": "name", "type": "type", "url": "url" }], "prices": [{ "listId": 6232, "price": "0", "articleId": "articleId", "fromQuantity": "0" }], "stock": "true", "barcode": "barcode", "supplierArticles": [{ "supplierName": "supplierName", "supplierBuyPriceMisc": 9681.291992074443, "supplierBuyRate": "1.0", "supplierBuyPrice": 9992.693311158957, "supplier": 2195, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 82.37447180306168 }], "height": 686.690419703796, "automaticOrder": false, "supplierName": "supplierName", "amount": 7571.800467798461, "bundled": "false", "articleId": "articleId", "vat": 8356.257889266815, "externalId": "externalId", "active": "true", "weight": 1685.2250166430315, "tags": [{ "name": "name", "externalId": "externalId", "id": 6881, "desc": "desc" }], "unit": "st", "depth": 8319.343687650655, "supplierBuyPrice": 8535.550562610892, "name": "name", "parts": [{ "amount": 8220.70394995325, "articleId": "articleId", "type": "type" }], "width": 3436.5889909290636, "supplierBuyPriceShipment": 7905.752754064043, "manufacturerArticleId": "manufacturerArticleId", "category": "övrigt", "stockWarning": 5399.554162660205 }
Successfull response:
{ "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 8629.308005729592, "supplierExternalId": "supplierExternalId", "type": "type", "price": 2940.8360186084615, "supplier": 7946, "supplierArticleId": "supplierArticleId", "vatAccount": 5536, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 1783.360287158532, "bundled": "false", "vat": 8997.33411857972, "nextDeliveryDate": 5275, "active": "true", "weight": 9989.35486791, "tags": [{ "name": "name", "externalId": "externalId", "id": 9235, "desc": "desc" }], "supplierBuyRate": 2729.2195655234264, "unit": "st", "reserved": 659.0100864267612, "name": "name", "parts": [{ "buyPrice": 9144.79510396552, "supplierName": "supplierName", "amount": 7372.27435446347, "articleName": "articleName", "supplierId": 4984, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 1308.055441503767, "buyPriceShipment": 2326.9068668997106, "buyPriceMisc": 7029.550494925263, "supplierArticleId": "supplierArticleId", "stock": 9147.83013617128, "isStock": true, "stockWarning": 488.8684328752113 }], "supplierBuyPriceShipment": 1611.9561941479444, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 6101, "orderedAmount": 9631.238804743203, "stockWarning": 9220.844901113494, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 5097.885255527581, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 3258.778303671621, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 831.0762478184186, "bestBefore": 6575, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 5273.785939223041, "totalSerialNumbersInStock": 2081.062012367698, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2787.15395006064, "bestBefore": 3067, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 8068.0972685027, "totalBatches": 680, "totalSerialNumbers": 5803 }, "webshopArticle": "false", "availableAmount": 1600.2400587254917, "orderLevel": 6511.476265948112, "prices": [{ "listId": 7582, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 1931.0778520330919, "supplierBuyRate": "1.0", "supplierBuyPrice": 9558.018742947861, "supplier": 4500, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 841.6340566169811 }], "automaticOrder": true, "supplierName": "supplierName", "deliveredAmount": 5948.118670952485, "amount": 5862.036078742641, "articleId": "articleId", "externalId": "externalId", "depth": 3509.4897135470005, "supplierBuyPrice": 9749.233106706697, "supplierBuyCurrency": "supplierBuyCurrency", "width": 7173.204938419631, "category": "övrigt" }
Add article tags
POSTUrl: /tag
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Add article tags for store group
Body:
{ "name": "name", "externalId": "externalId", "id": 5820, "desc": "desc" }
Successfull response:
{ "name": "name", "externalId": "externalId", "id": 5797, "desc": "desc" }
Add articles
POSTUrl: /list
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Add a list of articles
Import articles
POSTUrl: /import/{template_id}
Headers:
Accept: application/json or application/xml
Content-type: multipart/form-data
Content-type: multipart/form-data
Import articles from excel or tsv
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
update_only | |||
register_delivery | false | ||
file | |||
file |
Body:
Successfull response:
Test import articles
POSTUrl: /import/test/{template_id}
Headers:
Accept: application/json or application/xml
Content-type: multipart/form-data
Content-type: multipart/form-data
Test import articles from excel or tsv. This will read the first data-row from the uploaded file and return the result. Can be used to verify that the template being used is mapped correctly. No actual changed will be saved.
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
file | |||
file |
Import bundled articles
POSTUrl: /import/bundle
Headers:
Accept: application/json or application/xml
Content-type: multipart/form-data
Content-type: multipart/form-data
Import structure for bundled articles from excel or tsv
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
file_type | tsv | ||
file | |||
file |
Body:
Successfull response:
Test import bundled articles
POSTUrl: /import/bundle/test
Headers:
Accept: application/json or application/xml
Content-type: multipart/form-data
Content-type: multipart/form-data
Test import structure for bundled articles from excel or tsv. No actual changed will be saved.
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
file_type | tsv | ||
file | |||
file |
Body:
Successfull response:
Update articles
PUTUrl: /list
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Update a list of existing articles (Max 100 articles per request)
Body:
{ "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 9465.494122662645, "supplierExternalId": "supplierExternalId", "type": "type", "price": 5320.88436437218, "supplier": 6661, "supplierArticleId": "supplierArticleId", "vatAccount": 190, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 1142.8139931071169, "bundled": "false", "vat": 6674.94617437712, "nextDeliveryDate": 1326, "active": "true", "weight": 8515.692158116753, "tags": [{ "name": "name", "externalId": "externalId", "id": 9487, "desc": "desc" }], "supplierBuyRate": 9098.634683165024, "unit": "st", "reserved": 77.3197992625252, "name": "name", "parts": [{ "buyPrice": 867.8188277805043, "supplierName": "supplierName", "amount": 4234.28843434014, "articleName": "articleName", "supplierId": 9002, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 667.9575332203525, "buyPriceShipment": 6709.603833042262, "buyPriceMisc": 6853.918590563416, "supplierArticleId": "supplierArticleId", "stock": 7302.413710672304, "isStock": true, "stockWarning": 3272.9855040225675 }], "supplierBuyPriceShipment": 2388.261834375561, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 2103, "orderedAmount": 4046.1695580359656, "stockWarning": 9231.780865377881, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 9304.484993111213, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 5768.867809640871, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 8070.992457913458, "bestBefore": 7759, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 4237.965415756796, "totalSerialNumbersInStock": 6917.173154634244, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 7616.962864287094, "bestBefore": 4931, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 7140.077564373455, "totalBatches": 5480, "totalSerialNumbers": 4114 }, "webshopArticle": "false", "availableAmount": 5711.078621691416, "orderLevel": 8999.501091123655, "prices": [{ "listId": 8546, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 5740.602724650687, "supplierBuyRate": "1.0", "supplierBuyPrice": 7271.685156124974, "supplier": 7360, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 5139.582164685692 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 2577.476925968736, "amount": 5409.805678064523, "articleId": "articleId", "externalId": "externalId", "depth": 4806.388389267232, "supplierBuyPrice": 7594.023243896221, "supplierBuyCurrency": "supplierBuyCurrency", "width": 8981.9712597781, "category": "övrigt" }
Successfull response:
Update article
PUTUrl: /{id : .+}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Update an existing article
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
reason | |||
sort_column | batch_id | batch_id,serie_nr,amount,best_before | |
order | desc | asc,desc |
Body:
{ "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 43.58137738381118, "supplierExternalId": "supplierExternalId", "type": "type", "price": 9478.23529324497, "supplier": 9915, "supplierArticleId": "supplierArticleId", "vatAccount": 5804, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 6159.887178153999, "bundled": "false", "vat": 8210.187960806232, "nextDeliveryDate": 6311, "active": "true", "weight": 964.5619717754684, "tags": [{ "name": "name", "externalId": "externalId", "id": 1705, "desc": "desc" }], "supplierBuyRate": 9086.27580348051, "unit": "st", "reserved": 1907.4535494472634, "name": "name", "parts": [{ "buyPrice": 4725.245284079044, "supplierName": "supplierName", "amount": 4740.670566946345, "articleName": "articleName", "supplierId": 6531, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 6867.0814539540015, "buyPriceShipment": 7642.917416548948, "buyPriceMisc": 8778.241712372992, "supplierArticleId": "supplierArticleId", "stock": 1074.370493291521, "isStock": false, "stockWarning": 9842.922639833198 }], "supplierBuyPriceShipment": 8437.36681535064, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 7369, "orderedAmount": 1154.9109333546025, "stockWarning": 3156.219602801725, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 531.4620913433832, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 3520.808111705295, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 3244.282163650307, "bestBefore": 7990, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 9092.104705033633, "totalSerialNumbersInStock": 6776.873499395495, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2587.349525834446, "bestBefore": 787, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 5254.618946463903, "totalBatches": 5459, "totalSerialNumbers": 1858 }, "webshopArticle": "false", "availableAmount": 9702.559290745752, "orderLevel": 3926.558310130561, "prices": [{ "listId": 8438, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 5005.780642761337, "supplierBuyRate": "1.0", "supplierBuyPrice": 9577.778319162677, "supplier": 3870, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 4646.762964489606 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 2666.9576322211065, "amount": 1355.9858361961064, "articleId": "articleId", "externalId": "externalId", "depth": 2198.086305824126, "supplierBuyPrice": 7873.913562515413, "supplierBuyCurrency": "supplierBuyCurrency", "width": 6457.989951256335, "category": "övrigt" }
Successfull response:
{ "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 6857.121374210609, "supplierExternalId": "supplierExternalId", "type": "type", "price": 8734.136444065096, "supplier": 2875, "supplierArticleId": "supplierArticleId", "vatAccount": 7479, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 4183.196595108987, "bundled": "false", "vat": 9624.12048178102, "nextDeliveryDate": 3677, "active": "true", "weight": 2079.783029806056, "tags": [{ "name": "name", "externalId": "externalId", "id": 635, "desc": "desc" }], "supplierBuyRate": 6829.694755887053, "unit": "st", "reserved": 9702.588132731717, "name": "name", "parts": [{ "buyPrice": 6017.737152226047, "supplierName": "supplierName", "amount": 9870.92562492339, "articleName": "articleName", "supplierId": 8317, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 7591.671180127249, "buyPriceShipment": 515.9099046246096, "buyPriceMisc": 1714.0109199790654, "supplierArticleId": "supplierArticleId", "stock": 298.45848888578996, "isStock": true, "stockWarning": 4231.360890048766 }], "supplierBuyPriceShipment": 3131.259219772443, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 2541, "orderedAmount": 9324.435224400162, "stockWarning": 8711.358864731508, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 6301.632142284696, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 1773.7809763970447, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 1549.535728068322, "bestBefore": 6006, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 6928.255024143272, "totalSerialNumbersInStock": 4302.194944468007, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 8076.1169821974445, "bestBefore": 3806, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 4709.173507540715, "totalBatches": 8835, "totalSerialNumbers": 1976 }, "webshopArticle": "false", "availableAmount": 2173.720928197187, "orderLevel": 4406.606601096815, "prices": [{ "listId": 6220, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 4128.905733295587, "supplierBuyRate": "1.0", "supplierBuyPrice": 7417.729790002617, "supplier": 1191, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 1851.1648207088094 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 9373.057128435992, "amount": 1840.8629598873893, "articleId": "articleId", "externalId": "externalId", "depth": 8515.37730588034, "supplierBuyPrice": 9752.199478951443, "supplierBuyCurrency": "supplierBuyCurrency", "width": 2420.5750715626873, "category": "övrigt" }
Update article reserved
PUTUrl: /{id : .+}/reserved
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Update an article´s reserved value
Update article fifo rate
PUTUrl: /{id : .+}/fifo/rate
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Update an existing article fifo purchase rate for a specific timestamp
Update article fifo purchase price
PUTUrl: /{id : .+}/fifo/purchase_price
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Update an existing article fifo purchase price for a specific timestamp
Move article
PUTUrl: /{id : .+}/move
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Move article to another store
Body:
{ "batches": { "totalSerialNumbersReserved": 3561.740935637958, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 9733.34410091962, "bestBefore": 1300, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 6861.097895038455, "totalSerialNumbersInStock": 288.33104043062275, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 8819.729875893003, "bestBefore": 4670, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 626.3940335148699, "totalBatches": 6576, "totalSerialNumbers": 4132 }, "amount": 6357.256808119251, "articleId": "articleId", "toStoreId": 239 }
Successfull response:
Bulk update articles
PUTUrl: /bulk
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Update a field for a list of existing articles (Max 100 articles per request)
Body:
{ "field": "field", "pricelistId": 8417, "type": "SET", "articles": [{}], "value": "value" }
Successfull response:
{ "field": "field", "pricelistId": 8839, "articles": [{ "articleId": "articleId", "value": "value" }] }
Delete list of articles
PUTUrl: /bulk/delete
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Delete list of existing articles (Max 100 articles per request)
Create bundles for article
PUTUrl: /{id : .+}/bundles
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Create bundles for article
Body:
{ "amount": 1948.3304474355346, "articleName": "articleName", "articleId": "articleId" }
Successfull response:
{ "pages": 9953, "pageSize": 6760, "page": 339, "articlesCount": 4425, "articles": [{ "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 3038.7381756448394, "supplierExternalId": "supplierExternalId", "type": "type", "price": 9787.454003576278, "supplier": 7573, "supplierArticleId": "supplierArticleId", "vatAccount": 6356, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 1605.550861240479, "bundled": "false", "vat": 249.09045164637766, "nextDeliveryDate": 6874, "active": "true", "weight": 5160.366761547519, "tags": [{ "name": "name", "externalId": "externalId", "id": 3511, "desc": "desc" }], "supplierBuyRate": 3114.5011235091893, "unit": "st", "reserved": 4582.9920568279595, "name": "name", "parts": [{ "buyPrice": 4671.318631436714, "supplierName": "supplierName", "amount": 4565.274613733764, "articleName": "articleName", "supplierId": 2921, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 3678.4790146405553, "buyPriceShipment": 154.63835997797327, "buyPriceMisc": 1615.0902365174702, "supplierArticleId": "supplierArticleId", "stock": 299.19162532199175, "isStock": false, "stockWarning": 960.6039774587694 }], "supplierBuyPriceShipment": 5790.4328770196935, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 9348, "orderedAmount": 6296.942663848052, "stockWarning": 930.008451562312, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 317.6078677804095, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 4564.472970842079, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2289.8712856799584, "bestBefore": 7470, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 5191.3691209320805, "totalSerialNumbersInStock": 5993.752501633089, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 5675.296946115765, "bestBefore": 766, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 6816.796035387221, "totalBatches": 9778, "totalSerialNumbers": 889 }, "webshopArticle": "false", "availableAmount": 6219.026989489696, "orderLevel": 9836.109142476114, "prices": [{ "listId": 8532, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 6316.278652841579, "supplierBuyRate": "1.0", "supplierBuyPrice": 5617.3800235778235, "supplier": 1498, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 546.4317169854382 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 1642.7160664188966, "amount": 1686.417644546191, "articleId": "articleId", "externalId": "externalId", "depth": 7524.8810115095375, "supplierBuyPrice": 4372.712218753006, "supplierBuyCurrency": "supplierBuyCurrency", "width": 3130.1150058903395, "category": "övrigt" }], "since": 8646 }
Split bundles for article
PUTUrl: /{id : .+}/split
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Split bundles for article
Body:
{ "amount": 5819.4741135392205, "articleName": "articleName", "articleId": "articleId" }
Successfull response:
{ "pages": 3566, "pageSize": 3700, "page": 892, "articlesCount": 6882, "articles": [{ "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 5081.173857869952, "supplierExternalId": "supplierExternalId", "type": "type", "price": 2706.3453321943443, "supplier": 9208, "supplierArticleId": "supplierArticleId", "vatAccount": 906, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 1662.149938101749, "bundled": "false", "vat": 7913.880034467403, "nextDeliveryDate": 4812, "active": "true", "weight": 2774.4594098235875, "tags": [{ "name": "name", "externalId": "externalId", "id": 4792, "desc": "desc" }], "supplierBuyRate": 8530.716111258918, "unit": "st", "reserved": 2493.0376929379418, "name": "name", "parts": [{ "buyPrice": 1744.9671144957813, "supplierName": "supplierName", "amount": 6436.334848514187, "articleName": "articleName", "supplierId": 3986, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 6129.606054102903, "buyPriceShipment": 5282.725079711894, "buyPriceMisc": 7873.6831264726825, "supplierArticleId": "supplierArticleId", "stock": 9184.151594279443, "isStock": true, "stockWarning": 8864.900469098644 }], "supplierBuyPriceShipment": 9036.9917667102, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 6238, "orderedAmount": 5059.719475256842, "stockWarning": 3527.416940044006, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 3854.852921468949, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 2599.1662053602927, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 8935.446888656234, "bestBefore": 9934, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 4148.697035570267, "totalSerialNumbersInStock": 2319.4366050669755, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 5480.805842410963, "bestBefore": 5592, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 6517.959290739365, "totalBatches": 4494, "totalSerialNumbers": 8604 }, "webshopArticle": "false", "availableAmount": 4266.150697167127, "orderLevel": 1916.0340974857127, "prices": [{ "listId": 990, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": true, "supplierBuyPriceMisc": 8662.067330824073, "supplierBuyRate": "1.0", "supplierBuyPrice": 3398.7910677166833, "supplier": 7245, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 1074.948907484664 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 4572.011212372898, "amount": 2622.687027547411, "articleId": "articleId", "externalId": "externalId", "depth": 87.56920293857328, "supplierBuyPrice": 7282.346318914372, "supplierBuyCurrency": "supplierBuyCurrency", "width": 4180.250236995834, "category": "övrigt" }], "since": 2612 }
Delete article fifo
DELETEUrl: /fifo/{id}
Headers:
Accept: application/json or application/xml
Delete a specific fifo row
Body:
Successfull response:
Delete article
DELETEUrl: /{id : .+}
Headers:
Accept: application/json or application/xml
Delete article based on article-id
Body:
Successfull response:
Delete fifo
DELETEUrl: /{id : .+}/fifo
Headers:
Accept: application/json or application/xml
Delete all article fifos based on article-id
Body:
Successfull response:
Batches
Get batches
GETUrl: /batch
Headers:
Accept: application/json or application/xml
Get batches based on query
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
include_all_batches | true | ||
page | 0 | ||
limit | 100 |
Body:
Successfull response:
{ "totalSerialNumbersReserved": 8263.255087403053, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 6104.873789882517, "bestBefore": 8586, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 2811.6184462896776, "totalSerialNumbersInStock": 3214.3361175048612, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 8283.179195919667, "bestBefore": 3392, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 5662.813507874699, "totalBatches": 1054, "totalSerialNumbers": 5778 }
Get serial numbers
GETUrl: /serialnumber
Headers:
Accept: application/json or application/xml
Get serial numbers based on query
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
page | 0 | ||
limit | 100 |
Body:
Successfull response:
{ "totalSerialNumbersReserved": 21.91200193476628, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2178.286261221849, "bestBefore": 7113, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 8174.27680086285, "totalSerialNumbersInStock": 4834.488519343794, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 429.08870648405315, "bestBefore": 7777, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 2704.705944356294, "totalBatches": 4780, "totalSerialNumbers": 4589 }
Get batches for article
GETUrl: /{id : .+}/batch
Headers:
Accept: application/json or application/xml
Get batches for a specific article based on article-id
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
page | 0 | ||
limit | 100 | ||
sort_column | batch_id | batch_id,serie_nr,amount,best_before | |
order_by | asc | asc,desc |
Body:
Successfull response:
{ "totalSerialNumbersReserved": 41.695040420760556, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 3771.975797721249, "bestBefore": 9172, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 4242.262903562097, "totalSerialNumbersInStock": 6787.510299428764, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2008.4590152507453, "bestBefore": 3723, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 1287.8529044219356, "totalBatches": 6265, "totalSerialNumbers": 8728 }
Get serial numbers for article
GETUrl: /{id : .+}/serialnumber
Headers:
Accept: application/json or application/xml
Get serial numbers for a specific article based on article-id
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
include_all_serial_numbers | true | ||
page | 0 | ||
limit | 100 | ||
sort_column | batch_id | batch_id,serie_nr,amount,best_before | |
order_by | asc | asc,desc |
Body:
Successfull response:
{ "totalSerialNumbersReserved": 3377.4424202171126, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 5493.213609661981, "bestBefore": 1539, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 9930.501797812212, "totalSerialNumbersInStock": 2677.723217710296, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 9416.55449283625, "bestBefore": 663, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 3626.09368072499, "totalBatches": 7574, "totalSerialNumbers": 7797 }
Get batches and serial numbers for article
GETUrl: /{id : .+}/batch/serialnumber
Headers:
Accept: application/json or application/xml
Get batches and serial numbers for a specific article based on article-id
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
filter_all_batches | true | ||
page | 0 | ||
limit | 100 | ||
sort_column | batch_id | batch_id,serie_nr,amount,best_before | |
order | desc | asc,desc |
Body:
Successfull response:
{ "totalSerialNumbersReserved": 5840.933441627909, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 7591.440647452739, "bestBefore": 3310, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 536.8736315860579, "totalSerialNumbersInStock": 7489.083180721819, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 6316.669323276124, "bestBefore": 3276, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 1402.4992397843794, "totalBatches": 5880, "totalSerialNumbers": 3693 }
Get batches and serial numbers
GETUrl: /batch/serialnumber
Headers:
Accept: application/json or application/xml
Get batches and serial numbers
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
batch | true | ||
serial | true | ||
filter_all_batches | true | ||
page | 0 | ||
limit | 100 |
Body:
Successfull response:
{ "totalSerialNumbersReserved": 5083.765560470261, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 9533.49616252576, "bestBefore": 7221, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 6074.0758782380735, "totalSerialNumbersInStock": 552.379949981473, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 5676.157072394268, "bestBefore": 4123, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 7742.848809053256, "totalBatches": 838, "totalSerialNumbers": 6292 }
Add batch
POSTUrl: /{id : .+}/batch
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Add batch to an existing article
Body:
{ "serialNr": "serialNr", "amount": "1", "bestBefore": 7544, "batchId": "batchId", "barcode": "barcode" }
Successfull response:
Import batches and serial numbers
POSTUrl: /import/batch_serial
Headers:
Accept: application/json or application/xml
Content-type: multipart/form-data
Content-type: multipart/form-data
Import batches and serial numbers for articles from excel or tsv
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
file_type | tsv | ||
file | |||
file |
Body:
Successfull response:
Test import batches and serial numbers
POSTUrl: /import/batch_serial/test
Headers:
Accept: application/json or application/xml
Content-type: multipart/form-data
Content-type: multipart/form-data
Test import batches and serial numbers for articles from excel or tsv. No actual changed will be saved.
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
file_type | tsv | ||
file | |||
file |
Body:
Successfull response:
Add serial number
POSTUrl: /{id : .+}/serialnumber
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Add serial number to an existing article
Body:
{ "serialNr": "serialNr", "amount": "1", "bestBefore": 6062, "batchId": "batchId", "barcode": "barcode" }
Successfull response:
Add serial numbers sequence
POSTUrl: /{id : .+}/serialnumber/list
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Create a sequence of serial numbers to an existing article
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
prefix | |||
start | 1 | ||
length | 0 | ||
amount | 1 | ||
suffix | |||
set_barcode_from_serialnumber | false |
Body:
Successfull response:
Update batch
PUTUrl: /{id : .+}/batch/{batch_id : .+}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Update batch for a specific article
Body:
{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2208.8550642461423, "bestBefore": 2884, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }
Successfull response:
Update serial number
PUTUrl: /{id : .+}/serialnumber/{serialnumber : .+}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Update serial number for a specific article
Body:
{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 1150.304235387992, "bestBefore": 2987, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }
Successfull response:
Delete batch
DELETEUrl: /{id : .+}/batch/{batch_id : .+}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Delete a batch for a specific article
Body:
Successfull response:
Delete serial number
DELETEUrl: /{id : .+}/serialnumber/{serialnumber : .+}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Delete serial number for a specific article
Body:
Successfull response:
Custom fields
Get custom fields template
GETUrl: /customfields_template
Headers:
Accept: application/json or application/xml
The template contains fields that will automatically be added to new articles
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query |
Body:
Successfull response:
{"fields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }]}
Get custom fields not in template
GETUrl: /customfields
Headers:
Accept: application/json or application/xml
Get custom fields which exists on articles but is not in the template
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
page | 0 | ||
limit | 50 |
Body:
Successfull response:
{"fields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }]}
Update custom fields template
PUTUrl: /customfields_template
Headers:
Accept: application/json or application/xml
The template contains fields that will automatically be added to new articles
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
update_articles | false |
Body:
{"fields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }]}
Successfull response:
{"fields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }]}
Export
Get export dates
GETUrl: export
Headers:
Accept: application/json or application/xml
Get a list of existing export dates. Each date corresponds to an article export file
Body:
Successfull response:
{ "pages": 9743, "datesCount": 4498, "pageSize": 2538, "dates": [{ "date": 1732182655885, "stockValue": 1809.5247109157265, "stockValueFIFO": 2014.3599164161774, "id": "id", "type": "type" }], "page": 1500 }
Get export for date
GETUrl: /export/{date}
Headers:
Accept: application/json or application/xml
Get existing export file for specific date
Get export by id
GETUrl: /export/file/{id : .+}
Headers:
Accept: application/json or application/xml
Get existing export file based on id
Create export for date
POSTUrl: /export/{template_id}/date/{date}
Headers:
Accept: application/json or application/xml
Create export file for specific date and template
Body:
Successfull response:
Create export
POSTUrl: /export/{template_id}
Headers:
Accept: application/json or application/xml
Create export file for today´s date for specific template
Body:
Successfull response:
Create export for stock changes
POSTUrl: /export/{template_id}/stock_changes
Headers:
Accept: application/json or application/xml
Create export file for specific period and template that lists stock changes
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
start_date | Start date of export period. Format is yyyy-MM-dd and defaults to 1 month prior end date | ||
end_date | End date of export period. Format is yyyy-MM-dd and defaults to today´s date |
Body:
Successfull response:
Export bundled articles
POSTUrl: /export/bundle
Headers:
Accept: application/json or application/xml
Create export file for today´s date for bundled articles
Body:
Successfull response:
Field list
Get field list for settings
GETUrl: /fields/{articleFields}
Headers:
Accept: application/json or application/xml
Get field list for delivery note and order confirmation settings
Print labels
GETUrl: /{id : .+}/labels/print
Headers:
Accept: application/pdf or application/json
Print labels for article
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
count | 1 | ||
label_width | 110 | ||
label_height | 28 | ||
label_margin_width | 2 | ||
label_margin_height | 2 | ||
paper_width | 210 | ||
paper_height | 297 | ||
paper_margin_width | 0 | ||
paper_margin_height | 0 |
Print labels
GETUrl: /labels/print
Headers:
Accept: application/pdf or application/json
Print labels for article
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
articles | |||
count | 1 | ||
label_width | 110 | ||
label_height | 28 | ||
label_margin_width | 2 | ||
label_margin_height | 2 | ||
paper_width | 210 | ||
paper_height | 297 | ||
paper_margin_width | 0 | ||
paper_margin_height | 0 |
Print bundled article
GETUrl: /{id : .+}/bundle/print
Headers:
Accept: application/pdf or application/json
Print bundle article as PDF
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
amount | 1 |
Print supplier articles
GETUrl: /supplier/{supplier_id}/print
Headers:
Accept: application/pdf or application/json
Print articles connected to a supplier as PDF
Stock
Get stock value
GETUrl: /stockvalue
Headers:
Accept: application/json or application/xml
Get stock value for selected store
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
date |
Body:
Successfull response:
{ "stockValue": 1580.9706121193856, "stockValueFIFO": 1066.8227467253023 }
Templates
Get import templates
GETUrl: /import/templates
Headers:
Accept: application/json or application/xml
Get article import templates
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
page | 0 | ||
limit | 50 |
Body:
Successfull response:
{ "importTemplates": [{ "data": { "rowFirst": 5986, "customFields": {}, "barcodeType": { "defaultValue": "defaultValue", "column": 3115 }, "description": { "defaultValue": "defaultValue", "column": 5057 }, "stockPlace": { "defaultValue": "defaultValue", "column": 9266 }, "isActive": { "defaultValue": "defaultValue", "column": 8062 }, "type": { "defaultValue": "defaultValue", "column": 7119 }, "criticalLevel": { "defaultValue": "defaultValue", "column": 5281 }, "buyPriceCurrency": { "defaultValue": "defaultValue", "column": 1690 }, "manufacturer": { "defaultValue": "defaultValue", "column": 3856 }, "buyPriceShipment": { "defaultValue": "defaultValue", "column": 5231 }, "rate": { "defaultValue": "defaultValue", "column": 9122 }, "orderLevel": { "defaultValue": "defaultValue", "column": 1477 }, "buyPriceMisc": { "defaultValue": "defaultValue", "column": 8035 }, "supplier": { "defaultValue": "defaultValue", "column": 654 }, "supplierArticleId": { "defaultValue": "defaultValue", "column": 2714 }, "vatAccount": { "defaultValue": "defaultValue", "column": 65 }, "isWebshopArticle": { "defaultValue": "defaultValue", "column": 7415 }, "barcode": { "defaultValue": "defaultValue", "column": 3841 }, "height": { "defaultValue": "defaultValue", "column": 8281 }, "isBundled": { "defaultValue": "defaultValue", "column": 4591 }, "buyPrice": { "defaultValue": "defaultValue", "column": 6932 }, "amount": { "defaultValue": "defaultValue", "column": 5868 }, "articleName": 7398, "rowTitle": 2918, "articleId": 5981, "vat": { "defaultValue": "defaultValue", "column": 7501 }, "weight": { "defaultValue": "defaultValue", "column": 4914 }, "tags": { "defaultValue": "defaultValue", "column": 4280 }, "unit": { "defaultValue": "defaultValue", "column": 9024 }, "depth": { "defaultValue": "defaultValue", "column": 9852 }, "priceLists": {}, "width": { "defaultValue": "defaultValue", "column": 9458 }, "manufacturerArticleId": { "defaultValue": "defaultValue", "column": 8789 }, "category": { "defaultValue": "defaultValue", "column": 2002 }, "isStock": { "defaultValue": "defaultValue", "column": 7412 }, "stockWarning": { "defaultValue": "defaultValue", "column": 2867 } }, "name": "name", "storegroupId": 7981, "id": 6235, "type": "type" }], "pages": 2552, "pageSize": 2866, "page": 6735, "importTemplateCount": 9246 }
Get article import template
GETUrl: /import/template/{id}
Headers:
Accept: application/json or application/xml
Get article import template
Body:
Successfull response:
{ "data": { "rowFirst": 7926, "customFields": {}, "barcodeType": { "defaultValue": "defaultValue", "column": 5035 }, "description": { "defaultValue": "defaultValue", "column": 408 }, "stockPlace": { "defaultValue": "defaultValue", "column": 1843 }, "isActive": { "defaultValue": "defaultValue", "column": 5650 }, "type": { "defaultValue": "defaultValue", "column": 6584 }, "criticalLevel": { "defaultValue": "defaultValue", "column": 4076 }, "buyPriceCurrency": { "defaultValue": "defaultValue", "column": 87 }, "manufacturer": { "defaultValue": "defaultValue", "column": 4686 }, "buyPriceShipment": { "defaultValue": "defaultValue", "column": 935 }, "rate": { "defaultValue": "defaultValue", "column": 8248 }, "orderLevel": { "defaultValue": "defaultValue", "column": 7418 }, "buyPriceMisc": { "defaultValue": "defaultValue", "column": 2997 }, "supplier": { "defaultValue": "defaultValue", "column": 7951 }, "supplierArticleId": { "defaultValue": "defaultValue", "column": 7962 }, "vatAccount": { "defaultValue": "defaultValue", "column": 8649 }, "isWebshopArticle": { "defaultValue": "defaultValue", "column": 3619 }, "barcode": { "defaultValue": "defaultValue", "column": 8596 }, "height": { "defaultValue": "defaultValue", "column": 6605 }, "isBundled": { "defaultValue": "defaultValue", "column": 3632 }, "buyPrice": { "defaultValue": "defaultValue", "column": 1410 }, "amount": { "defaultValue": "defaultValue", "column": 1178 }, "articleName": 9466, "rowTitle": 7925, "articleId": 7219, "vat": { "defaultValue": "defaultValue", "column": 3779 }, "weight": { "defaultValue": "defaultValue", "column": 3659 }, "tags": { "defaultValue": "defaultValue", "column": 2957 }, "unit": { "defaultValue": "defaultValue", "column": 2071 }, "depth": { "defaultValue": "defaultValue", "column": 477 }, "priceLists": {}, "width": { "defaultValue": "defaultValue", "column": 2914 }, "manufacturerArticleId": { "defaultValue": "defaultValue", "column": 2759 }, "category": { "defaultValue": "defaultValue", "column": 4928 }, "isStock": { "defaultValue": "defaultValue", "column": 4948 }, "stockWarning": { "defaultValue": "defaultValue", "column": 2592 } }, "name": "name", "storegroupId": 8288, "id": 8799, "type": "type" }
Add article import template
POSTUrl: /import/template
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Add an article import template
Body:
{ "data": { "rowFirst": 9080, "customFields": {}, "barcodeType": { "defaultValue": "defaultValue", "column": 1525 }, "description": { "defaultValue": "defaultValue", "column": 7926 }, "stockPlace": { "defaultValue": "defaultValue", "column": 3599 }, "isActive": { "defaultValue": "defaultValue", "column": 5869 }, "type": { "defaultValue": "defaultValue", "column": 9514 }, "criticalLevel": { "defaultValue": "defaultValue", "column": 3014 }, "buyPriceCurrency": { "defaultValue": "defaultValue", "column": 4967 }, "manufacturer": { "defaultValue": "defaultValue", "column": 4322 }, "buyPriceShipment": { "defaultValue": "defaultValue", "column": 1282 }, "rate": { "defaultValue": "defaultValue", "column": 5835 }, "orderLevel": { "defaultValue": "defaultValue", "column": 9976 }, "buyPriceMisc": { "defaultValue": "defaultValue", "column": 7604 }, "supplier": { "defaultValue": "defaultValue", "column": 4819 }, "supplierArticleId": { "defaultValue": "defaultValue", "column": 6105 }, "vatAccount": { "defaultValue": "defaultValue", "column": 861 }, "isWebshopArticle": { "defaultValue": "defaultValue", "column": 4047 }, "barcode": { "defaultValue": "defaultValue", "column": 4836 }, "height": { "defaultValue": "defaultValue", "column": 7248 }, "isBundled": { "defaultValue": "defaultValue", "column": 5814 }, "buyPrice": { "defaultValue": "defaultValue", "column": 8561 }, "amount": { "defaultValue": "defaultValue", "column": 7939 }, "articleName": 7018, "rowTitle": 1771, "articleId": 429, "vat": { "defaultValue": "defaultValue", "column": 9892 }, "weight": { "defaultValue": "defaultValue", "column": 4312 }, "tags": { "defaultValue": "defaultValue", "column": 129 }, "unit": { "defaultValue": "defaultValue", "column": 5187 }, "depth": { "defaultValue": "defaultValue", "column": 9846 }, "priceLists": {}, "width": { "defaultValue": "defaultValue", "column": 6043 }, "manufacturerArticleId": { "defaultValue": "defaultValue", "column": 7194 }, "category": { "defaultValue": "defaultValue", "column": 996 }, "isStock": { "defaultValue": "defaultValue", "column": 9221 }, "stockWarning": { "defaultValue": "defaultValue", "column": 4341 } }, "name": "name", "storegroupId": 1376, "type": "type" }
Successfull response:
{ "data": { "rowFirst": 6303, "customFields": {}, "barcodeType": { "defaultValue": "defaultValue", "column": 9482 }, "description": { "defaultValue": "defaultValue", "column": 9277 }, "stockPlace": { "defaultValue": "defaultValue", "column": 2821 }, "isActive": { "defaultValue": "defaultValue", "column": 8639 }, "type": { "defaultValue": "defaultValue", "column": 4680 }, "criticalLevel": { "defaultValue": "defaultValue", "column": 9697 }, "buyPriceCurrency": { "defaultValue": "defaultValue", "column": 5121 }, "manufacturer": { "defaultValue": "defaultValue", "column": 6623 }, "buyPriceShipment": { "defaultValue": "defaultValue", "column": 361 }, "rate": { "defaultValue": "defaultValue", "column": 951 }, "orderLevel": { "defaultValue": "defaultValue", "column": 6133 }, "buyPriceMisc": { "defaultValue": "defaultValue", "column": 9128 }, "supplier": { "defaultValue": "defaultValue", "column": 4857 }, "supplierArticleId": { "defaultValue": "defaultValue", "column": 9837 }, "vatAccount": { "defaultValue": "defaultValue", "column": 4020 }, "isWebshopArticle": { "defaultValue": "defaultValue", "column": 536 }, "barcode": { "defaultValue": "defaultValue", "column": 6515 }, "height": { "defaultValue": "defaultValue", "column": 2661 }, "isBundled": { "defaultValue": "defaultValue", "column": 2458 }, "buyPrice": { "defaultValue": "defaultValue", "column": 785 }, "amount": { "defaultValue": "defaultValue", "column": 9428 }, "articleName": 7677, "rowTitle": 5100, "articleId": 7934, "vat": { "defaultValue": "defaultValue", "column": 9089 }, "weight": { "defaultValue": "defaultValue", "column": 26 }, "tags": { "defaultValue": "defaultValue", "column": 4338 }, "unit": { "defaultValue": "defaultValue", "column": 8395 }, "depth": { "defaultValue": "defaultValue", "column": 1631 }, "priceLists": {}, "width": { "defaultValue": "defaultValue", "column": 4451 }, "manufacturerArticleId": { "defaultValue": "defaultValue", "column": 3146 }, "category": { "defaultValue": "defaultValue", "column": 1692 }, "isStock": { "defaultValue": "defaultValue", "column": 2072 }, "stockWarning": { "defaultValue": "defaultValue", "column": 5313 } }, "name": "name", "storegroupId": 1271, "id": 2557, "type": "type" }
Update article import template
PUTUrl: /import/template/{id}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Update an article import template
Body:
{ "data": { "rowFirst": 3659, "customFields": {}, "barcodeType": { "defaultValue": "defaultValue", "column": 1426 }, "description": { "defaultValue": "defaultValue", "column": 7779 }, "stockPlace": { "defaultValue": "defaultValue", "column": 6906 }, "isActive": { "defaultValue": "defaultValue", "column": 249 }, "type": { "defaultValue": "defaultValue", "column": 3726 }, "criticalLevel": { "defaultValue": "defaultValue", "column": 9575 }, "buyPriceCurrency": { "defaultValue": "defaultValue", "column": 7947 }, "manufacturer": { "defaultValue": "defaultValue", "column": 7283 }, "buyPriceShipment": { "defaultValue": "defaultValue", "column": 2149 }, "rate": { "defaultValue": "defaultValue", "column": 5939 }, "orderLevel": { "defaultValue": "defaultValue", "column": 5569 }, "buyPriceMisc": { "defaultValue": "defaultValue", "column": 1997 }, "supplier": { "defaultValue": "defaultValue", "column": 768 }, "supplierArticleId": { "defaultValue": "defaultValue", "column": 7348 }, "vatAccount": { "defaultValue": "defaultValue", "column": 5089 }, "isWebshopArticle": { "defaultValue": "defaultValue", "column": 8104 }, "barcode": { "defaultValue": "defaultValue", "column": 7495 }, "height": { "defaultValue": "defaultValue", "column": 5499 }, "isBundled": { "defaultValue": "defaultValue", "column": 7454 }, "buyPrice": { "defaultValue": "defaultValue", "column": 9559 }, "amount": { "defaultValue": "defaultValue", "column": 5167 }, "articleName": 8158, "rowTitle": 7015, "articleId": 253, "vat": { "defaultValue": "defaultValue", "column": 2634 }, "weight": { "defaultValue": "defaultValue", "column": 2211 }, "tags": { "defaultValue": "defaultValue", "column": 5962 }, "unit": { "defaultValue": "defaultValue", "column": 8784 }, "depth": { "defaultValue": "defaultValue", "column": 2028 }, "priceLists": {}, "width": { "defaultValue": "defaultValue", "column": 9299 }, "manufacturerArticleId": { "defaultValue": "defaultValue", "column": 6757 }, "category": { "defaultValue": "defaultValue", "column": 8836 }, "isStock": { "defaultValue": "defaultValue", "column": 8964 }, "stockWarning": { "defaultValue": "defaultValue", "column": 8918 } }, "name": "name", "storegroupId": 7944, "id": 9543, "type": "type" }
Successfull response:
{ "data": { "rowFirst": 5222, "customFields": {}, "barcodeType": { "defaultValue": "defaultValue", "column": 1731 }, "description": { "defaultValue": "defaultValue", "column": 8749 }, "stockPlace": { "defaultValue": "defaultValue", "column": 7126 }, "isActive": { "defaultValue": "defaultValue", "column": 5026 }, "type": { "defaultValue": "defaultValue", "column": 5022 }, "criticalLevel": { "defaultValue": "defaultValue", "column": 2569 }, "buyPriceCurrency": { "defaultValue": "defaultValue", "column": 6036 }, "manufacturer": { "defaultValue": "defaultValue", "column": 6595 }, "buyPriceShipment": { "defaultValue": "defaultValue", "column": 3037 }, "rate": { "defaultValue": "defaultValue", "column": 8857 }, "orderLevel": { "defaultValue": "defaultValue", "column": 6967 }, "buyPriceMisc": { "defaultValue": "defaultValue", "column": 564 }, "supplier": { "defaultValue": "defaultValue", "column": 597 }, "supplierArticleId": { "defaultValue": "defaultValue", "column": 4686 }, "vatAccount": { "defaultValue": "defaultValue", "column": 506 }, "isWebshopArticle": { "defaultValue": "defaultValue", "column": 174 }, "barcode": { "defaultValue": "defaultValue", "column": 5016 }, "height": { "defaultValue": "defaultValue", "column": 4973 }, "isBundled": { "defaultValue": "defaultValue", "column": 8044 }, "buyPrice": { "defaultValue": "defaultValue", "column": 3445 }, "amount": { "defaultValue": "defaultValue", "column": 1739 }, "articleName": 8021, "rowTitle": 1902, "articleId": 3365, "vat": { "defaultValue": "defaultValue", "column": 4807 }, "weight": { "defaultValue": "defaultValue", "column": 3766 }, "tags": { "defaultValue": "defaultValue", "column": 9720 }, "unit": { "defaultValue": "defaultValue", "column": 8179 }, "depth": { "defaultValue": "defaultValue", "column": 2763 }, "priceLists": {}, "width": { "defaultValue": "defaultValue", "column": 7840 }, "manufacturerArticleId": { "defaultValue": "defaultValue", "column": 4435 }, "category": { "defaultValue": "defaultValue", "column": 7714 }, "isStock": { "defaultValue": "defaultValue", "column": 4370 }, "stockWarning": { "defaultValue": "defaultValue", "column": 5089 } }, "name": "name", "storegroupId": 9466, "id": 9868, "type": "type" }
Update article to bundle or simple
PUTUrl: /{id : .+}/bundle
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Update an article to bundle or simple
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
bundle |
Body:
Successfull response:
{ "name": "name", "externalId": "externalId", "id": 2925, "desc": "desc" }
Delete custom field
DELETEUrl: customfields/{name}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Delete custom field and remove it from articles
Body:
Successfull response:
Delete import template
DELETEUrl: import/template/{id}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Delete import template for articles
Body:
Successfull response:
Traceability
Traceability for a bundled article
GETUrl: /{article_id}/batch/{batch_id}/traceability
Headers:
Accept: application/json or application/xml
Get bundled parts with batch and serial numbers for a batch
Body:
Successfull response:
{ "modifiedStructure": false, "traceability": [{ "amount": 4618.952982402406, "articleName": "articleName", "serial": [{ "serialNr": "serialNr", "amount": 5305.820434209546, "reserved": 1485.9063284218178, "bestBefore": 1732182655959, "batchId": "batchId", "barcode": "barcode" }], "producedAmount": 3108.013641997721, "articleId": "articleId", "batch": { "serialNr": "serialNr", "amount": 8463.863062555612, "reserved": 6055.569037187355, "bestBefore": 1732182655959, "batchId": "batchId", "barcode": "barcode" } }] }
Traceability for a bundled article
GETUrl: /{article_id}/serial/{serial_nr}/traceability
Headers:
Accept: application/json or application/xml
Get bundled parts with batch and serial numbers for a serial number
Body:
Successfull response:
{ "modifiedStructure": false, "traceability": [{ "amount": 4149.759316837043, "articleName": "articleName", "serial": [{ "serialNr": "serialNr", "amount": 900.9200569657338, "reserved": 9250.321321091977, "bestBefore": 1732182655959, "batchId": "batchId", "barcode": "barcode" }], "producedAmount": 5893.25954058078, "articleId": "articleId", "batch": { "serialNr": "serialNr", "amount": 7036.8155874521635, "reserved": 8758.091289458594, "bestBefore": 1732182655959, "batchId": "batchId", "barcode": "barcode" } }] }
Classes:
Article
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articleId | String | Write only with POST | Post | R,W | |||
externalId | String | External article id | R,W | ||||
active | Boolean | true | R,W | ||||
name | String | Post | R,W | ||||
bundled | Boolean | Write only with POST | false | R,W | |||
parts | List | If article is bundled this is the parts contained in the article. When updating an existing bundled article this list will replace old list. If list is null, no replacement will be made. If list is empty, all parts will be removed | R,W | ||||
batches | ArticleBatches | Returns the first 20 batches and the first 20 serial numbers connected to this article | R | ||||
description | String | R,W | |||||
category | String | övrigt | R,W | ||||
amount | Double | Available amount. This means stock amount reduced by reserved amount | R,W | ||||
reserved | Double | Reserved amount | R | ||||
barcode | String | R,W | |||||
barcodeType | String | EAN | EAN, CODE128, QR, UPC | R,W | |||
price | Double | R,W | |||||
prices | List | R,W | |||||
supplier | Long | If article is bundled, supplier information will be ignored | if not null, must point to an existing supplier | R,W | |||
supplierExternalId | String | external id of Supplier | R | ||||
supplierName | String | If article is bundled, supplier information will be ignored | if not null, must point to an existing supplier | R,W | |||
supplierArticleId | String | If article is bundled, supplier information will be ignored | R,W | ||||
supplierAutomaticOrder | Boolean | If article is bundled, supplier information will be ignored | R,W | ||||
supplierBuyPrice | Double | Total buy price including shipment and misc costs. If article is bundled, supplier information will be ignored | R,W | ||||
supplierBuyPriceShipment | Double | If article is bundled, supplier information will be ignored | R,W | ||||
supplierArticles | List | If article is bundled, supplier information will be ignored | R,W | ||||
supplierBuyPriceMisc | Double | If article is bundled, supplier information will be ignored | R,W | ||||
supplierBuyCurrency | String | R | |||||
supplierBuyRate | Double | R | |||||
unit | String | st | R,W | ||||
vat | Double | Vat in percentage. If both vat-account and vat is submitted, vat-account takes precedence | Post | R,W | |||
vatAccount | Integer | If both vat-account and vat is submitted, vat-account takes precedence | R,W | ||||
imageLastUpdated | Long | R | |||||
type | String | Stock means it's a physical product and service means it's work and lacks stock-amount | Post | Stock, Service | R,W | ||
stock | Boolean | True means it's a physical article in stock and false means it's an article that needs to be ordered from supplier | true | R,W | |||
webshopArticle | Boolean | false | R,W | ||||
manufacturer | String | R,W | |||||
manufacturerArticleId | String | R,W | |||||
customFields | List | if you have need for other type of fields then what lagerkoll offers you can use this key-value list. When creating / updating an article the content of this list will replace the list of fields in the existing article | R,W | ||||
links | List | R,W | |||||
tags | List | Make sure you provide tagId for existing tags, otherwise new ones will be created | R,W | ||||
width | Double | R,W | |||||
height | Double | R,W | |||||
depth | Double | R,W | |||||
weight | Double | R,W | |||||
stockPlace | String | R,W | |||||
stockWarning | Double | R,W | |||||
criticalLevel | Double | When amount reaches the critical level it is automatically added to a purchase order, with amount set to order level | R,W | ||||
orderLevel | Double | When amount reaches the critical level it is automatically added to a purchase order, with amount set to order level | R,W | ||||
automaticOrder | Boolean | Set flag to true if the article should be automatically added to a purchase order when stock level reaches the critical level | R,W | ||||
nextDeliveryDate | Long | If there is a purchase order for this article, this would be the delivery date for that order | R | ||||
orderedAmount | Double | If there is a purchase order for this article, this would be the ordered amount for that order | R | ||||
deliveredAmount | Double | If there is a purchase order for this article, this would be the delivered amount for that order | R | ||||
availableAmount | Double | Amount available for given deliveryDate | R |
ArticleAutoComplete
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articleId | String | R | |||||
active | Boolean | R | |||||
name | String | R | |||||
bundled | Boolean | R | |||||
amount | Double | R | |||||
reserved | Double | R | |||||
barcode | String | R,W | |||||
barcodeType | String | EAN | EAN, CODE128, QR, UPC | R,W | |||
price | Double | R | |||||
supplierBuyPrice | Double | R | |||||
supplierBuyPriceShipment | Double | R | |||||
supplierBuyPriceMisc | Double | R | |||||
supplierBuyCurrency | String | R | |||||
supplierBuyRate | Double | R | |||||
unit | String | R | |||||
type | String | Stock means it's a physical product and service means it's work and lacks stock-amount | Stock, Service | R | |||
stock | Boolean | True means it's a physical article in stock and false means it's an article that needs to be ordered from supplier | R | ||||
vat | Double | VAT for article | R |
ArticleBatch
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articleId | String | Id of article the batch/serialnumber is connected to | R | ||||
articleName | String | Name of article | R | ||||
batchId | String | batch-id or serial-nr must be set, Write only with POST | Post | R,W | |||
serialNr | String | batch-id or serial-nr must be set, Write only with POST | Post | R,W | |||
amount | double | 1 | R,W | ||||
reserved | double | Reserved is set automatically when part of a customer order that has not yet been invoiced | R | ||||
barcode | String | Write only with POST | R,W | ||||
bestBefore | Long | ms since 1970, Write only with POST | R,W |
ArticleBatches
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
totalBatches | Integer | Total number of batches for an article | R | ||||
batches | List | Current page of batches for an article | R | ||||
totalSerialNumbers | Integer | Total number of serial numbers for an article | R | ||||
serialNumbers | List | Current page of serial numbers for an article | R | ||||
totalBatchesInStock | Double | Total batches in stock | R | ||||
totalBatchesReserved | Double | Total batches reserved | R | ||||
totalSerialNumbersInStock | Double | Total serial numbers in stock | R | ||||
totalSerialNumbersReserved | Double | Total serial numbers reserved | R |
ArticleField
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articleId | String | R,W | |||||
value | String | R,W |
ArticleFIFOsResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
page | int | R | |||||
pages | int | R | |||||
pageSize | int | R | |||||
fifoCount | int | R | |||||
since | long | R | |||||
fifos | List | R |
ArticleHistory
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articleId | String | R | |||||
supplierId | Long | R | |||||
supplierName | String | R | |||||
oldCount | Double | R | |||||
newCount | Double | R | |||||
oldReserved | Double | R | |||||
newReserved | Double | R | |||||
pricelistId | Long | R | |||||
pricelistName | String | R | |||||
oldSalesPrice | Double | R | |||||
newSalesPrice | Double | R | |||||
oldPurchasePrice | Double | R | |||||
newPurchasePrice | Double | R | |||||
userId | Long | R | |||||
userName | String | R | |||||
reason | String | R | |||||
created | Date | R |
ArticleHistoryResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
page | int | R | |||||
pages | int | R | |||||
pageSize | int | R | |||||
historyCount | int | R | |||||
since | long | R | |||||
history | List | R |
ArticleId
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
id | String | R,W |
ArticleIds
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articles | List | List of article ids | R,W |
ArticleImportTemplate
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
id | long | R | |||||
storegroupId | long | R,W | |||||
name | String | R,W | |||||
type | String | R,W | |||||
data | ImportTemplate | R,W |
ArticleImportTemplateResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
page | int | R | |||||
pages | int | R | |||||
pageSize | int | R | |||||
importTemplateCount | int | R | |||||
importTemplates | List | R |
ArticleLink
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
name | String | Post | R,W | ||||
url | String | Post | R,W | ||||
type | String | Post | unknown, webpage, image, document, lagerkoll_document | R,W |
ArticleMove
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articleId | String | PUT | R,W | ||||
amount | Double | PUT | R,W | ||||
toStoreId | Long | Id of stock that article is moved to | PUT | R,W | |||
batches | ArticleBatches | PUT | R,W |
ArticleReserved
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
reserved | double | R |
ArticlesAutoCompleteResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articlesCount | int | R | |||||
page | int | R | |||||
pageSize | int | R | |||||
pages | int | R | |||||
articles | List | R |
ArticlesResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
page | int | R | |||||
pages | int | R | |||||
pageSize | int | R | |||||
articlesCount | int | R | |||||
since | long | R | |||||
articles | List | R |
ArticleStockplace
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
stockplace | String | R | |||||
articles | Integer | Number of articles in this stockplace | R |
ArticleStockplacesResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
stockplaces | List | R |
ArticleTag
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
id | long | Write only with POST | Post | R,W | |||
externalId | String | R,W | |||||
name | String | Post | R,W | ||||
desc | String | Post | R,W |
ArticleTraceabilityBatch
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
batchId | String | R,W | |||||
serialNr | String | R,W | |||||
amount | double | R,W | |||||
reserved | double | R,W | |||||
barcode | String | R,W | |||||
bestBefore | Date | R,W |
ArticleUnit
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
storegroupId | long | R | |||||
articleId | String | Article id | R | ||||
unit | Unit | Unit id | true | R,W | |||
convert | Double | Conversion coefficient between unit and the article base unit | true | R,W | |||
barcode | String | Barcode conected to unit | R,W |
ArticleUnitsResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
units | List | R |
BulkArticle
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articles | List | List of article ids | R,W | ||||
field | String | Field to update | R,W | ||||
pricelistId | Long | When updating sales price the pricelist should be given | R,W | ||||
type | BulkArticle$BulkType | Describe how the updated value should be applied. SET will set the value, PERCENTAGE will add to existing value, PROFIT will calculate sales price taking purchase price into account. PERCENTAGE and PROFIT is only valid for sales prices | SET | SET, PERCENTAGE, PROFIT | R,W | ||
value | String | Value for field that will be applied to all articles in the list | R,W |
BulkArticleResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articles | List | List of articles with the updated field value | R,W | ||||
field | String | Updated field | R,W | ||||
pricelistId | Long | Pricelist when sales price has been updated | R,W |
BundleArticleForPart
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articleId | String | R,W | |||||
articleName | String | R | |||||
amount | double | R,W |
BundledArticle
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articleId | String | R,W | |||||
articleName | String | R | |||||
externalId | String | External article id | R | ||||
amount | Double | Amount of this article for a single bundled article | Post/Put | R,W | |||
isStock | Boolean | Is article is of type stock | R | ||||
stockWarning | Double | Warning for low stock level | R | ||||
stock | Double | Number of articles in stock | R | ||||
reserved | Double | Number of articles reserved. Number of available = stock - reserved | R | ||||
type | String | Stock means it's a physical product and service means it's work and lacks stock-amount | Post | Stock, Service | R,W | ||
unitName | String | R | |||||
stockPlace | String | R | |||||
buyPrice | Double | R | |||||
buyPriceShipment | Double | R | |||||
buyPriceMisc | Double | R | |||||
buyPriceCurrency | String | R | |||||
supplierId | Long | R | |||||
supplierName | String | R | |||||
supplierArticleId | String | R |
Count
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
count | int | R |
CustomerTag
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
id | Long | Write only with POST | Post | R,W | |||
externalId | String | R,W | |||||
name | String | Post | R,W | ||||
desc | String | Post | R,W |
CustomerTagResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
page | int | R | |||||
pages | int | R | |||||
pageSize | int | R | |||||
projectsCount | int | R | |||||
tags | List | R |
CustomField
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
name | String | Post | R,W | ||||
type | String | Post | String, Number, Int, Long, Float, Double Boolean, Date, Json, JsonArray, Email | R,W | |||
value | String | Post | R,W | ||||
validValues | List | R |
CustomFieldsTemplate
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
fields | List | R |
CustomFieldValidValue
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
value | String | R | |||||
description | String | R |
ExportDate
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
id | String | Id of export file | R | ||||
type | String | Type of export | daily, weekly, monthly, inventory, other | R | |||
date | Date | Date of export | R | ||||
stockValue | Double | Stockvalue for specified date | R | ||||
stockValueFIFO | Double | Stockvalue FIFO for specified date | R |
ExportDatesResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
page | int | R | |||||
pages | int | R | |||||
pageSize | int | R | |||||
datesCount | int | R | |||||
dates | List | List of export dates | R |
FieldsResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
fields | List | Returns list of field names | R |
FIFO
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
id | long | R | |||||
date | Date | R | |||||
amount | double | R | |||||
amountInStock | double | R | |||||
supplierId | long | R | |||||
supplierName | String | R | |||||
purchasePrice | double | R | |||||
purchaseRate | double | R | |||||
supplierOrderId | long | R | |||||
poRef | String | R | |||||
description | String | R | |||||
userId | long | R | |||||
userName | String | R |
FIFOPrice
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
date | Date | Format is sent in ms since 1970 | R | ||||
price | Double | R |
FIFORate
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
date | Date | R | |||||
rate | Double | R |
ImportTemplate
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
rowTitle | Integer | R,W | |||||
rowFirst | Integer | R,W | |||||
articleName | Integer | R,W | |||||
articleId | Integer | R,W | |||||
description | ImportTemplateColumn | R,W | |||||
isActive | ImportTemplateColumn | R,W | |||||
isBundled | ImportTemplateColumn | R,W | |||||
category | ImportTemplateColumn | R,W | |||||
amount | ImportTemplateColumn | R,W | |||||
unit | ImportTemplateColumn | R,W | |||||
barcode | ImportTemplateColumn | R,W | |||||
barcodeType | ImportTemplateColumn | R,W | |||||
buyPrice | ImportTemplateColumn | R,W | |||||
buyPriceShipment | ImportTemplateColumn | R,W | |||||
buyPriceMisc | ImportTemplateColumn | R,W | |||||
rate | ImportTemplateColumn | R,W | |||||
buyPriceCurrency | ImportTemplateColumn | R,W | |||||
supplier | ImportTemplateColumn | R,W | |||||
supplierArticleId | ImportTemplateColumn | R,W | |||||
vat | ImportTemplateColumn | R,W | |||||
vatAccount | ImportTemplateColumn | R,W | |||||
isStock | ImportTemplateColumn | R,W | |||||
type | ImportTemplateColumn | R,W | |||||
stockPlace | ImportTemplateColumn | R,W | |||||
stockWarning | ImportTemplateColumn | R,W | |||||
criticalLevel | ImportTemplateColumn | R,W | |||||
orderLevel | ImportTemplateColumn | R,W | |||||
isWebshopArticle | ImportTemplateColumn | R,W | |||||
manufacturer | ImportTemplateColumn | R,W | |||||
manufacturerArticleId | ImportTemplateColumn | R,W | |||||
width | ImportTemplateColumn | R,W | |||||
height | ImportTemplateColumn | R,W | |||||
depth | ImportTemplateColumn | R,W | |||||
weight | ImportTemplateColumn | R,W | |||||
tags | ImportTemplateColumn | R,W | |||||
priceLists | HashMap | R,W | |||||
customFields | HashMap | R,W |
ImportTemplateColumn
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
column | Integer | R,W | |||||
defaultValue | String | R,W |
PartTraceabilityExtended
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articleId | String | R,W | |||||
articleName | String | R,W | |||||
amount | double | Amount of parts to create one bundled | R,W | ||||
producedAmount | double | Total amount that has been produced (with regards to overproduction and waste) multiplied with amount needed to create a bundled | R,W | ||||
batch | ArticleTraceabilityBatch | R,W | |||||
serial | List | R,W |
PartTraceabilityResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
traceability | List | R,W | |||||
modifiedStructure | boolean | Check if the bundle article structure have changed e.g. articles have been added/removed | R,W |
Price
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
listId | Long | Write only with POST | Post | R,W | |||
listExternalId | String | External id of pricelist | R | ||||
articleId | String | Write only with POST | Post | R,W | |||
fromQuantity | double | Write only with POST | 0 | R,W | |||
price | Double | To remove a price, send null to server | 0 | R,W |
StockValue
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
stockValue | double | R | |||||
stockValueFIFO | double | R |
StoreArticle
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articleId | String | Article id | R | ||||
name | String | Article name | R | ||||
storeId | long | Store where article belongs | R | ||||
storeName | String | Name of store | R | ||||
availableAmount | Double | Available stock amount of article | R |
StoreArticlesResponse
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
page | int | R | |||||
pages | int | R | |||||
pageSize | int | R | |||||
articlesCount | int | R | |||||
since | long | R | |||||
articles | List | R |
SupplierArticle
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
supplier | Long | if not null, must point to an existing supplier | R,W | ||||
supplierName | String | if not null, must point to an existing supplier | R,W | ||||
supplierArticleId | String | R,W | |||||
supplierAutomaticOrder | boolean | R | |||||
supplierBuyPrice | Double | Total buy price including shipment and misc costs | R,W | ||||
supplierBuyPriceShipment | Double | R,W | |||||
supplierBuyPriceMisc | Double | R,W | |||||
supplierBuyCurrency | String | If omitted, supplier's currency is used. If supplier is missing, it defaults to store's currency | Store currency | R,W | |||
supplierBuyRate | Double | If supplier's currency differ from store's currency, provide an exchange rate. If rate is omitted, the supplier's rate is used. If supplier is missing, it defaults to 1.0 | 1.0 | R,W |
Unit
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
id | Long | R,W | |||||
externalId | String | R | |||||
name | String | Name of unit | R,W |