Goto APIs

Purchase orders API

General:

Basics:

Base-URL: https://capi.lagerkoll.com/v1/purchase_orders/
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.

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.
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
901101 Error when getting purchase order
901102 Error when creating a purchase order
901103 Error when updating a purchase order
{
  "errorCode" : 900101,
  "errorMessage" : "Something went wrong on the server",
  "errorField" : null,
  "errorData" : null
}

Purchase orders API:

Delivery

Deliver article

POSTUrl: /{order_id}/deliver
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Mark article as delivered for a purchase order. If article has already been delivered, the deliveryArticle-object will add to the already delivered amount
Body:

{ "deliveredAmount": "0", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 6220, "batchId": "batchId", "barcode": "barcode" }], "id": 7314 }
Successfull response:

{ "deliveredAmount": "0", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 1955, "batchId": "batchId", "barcode": "barcode" }], "id": 8808 }

Deliver all articles

POSTUrl: /{order_id}/deliver_all
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Mark all articles as delivered for a purchase order, with the ordered amount
Body:
Successfull response:

Deliver purchase order

PUTUrl: /{id}/deliver
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Update purchase order state to delivered. If the order is Pick-n-pack the connected customer order is marked as delivered.

Valid parameters:

Parameter Description Default value Allowed values
delivered_date

Body:
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 7646, "productionOrderId": 9462, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 3320, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 1117, "orderValue": 5609.8973624584305, "confirmedDeliveryDate": 1733244402526, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402526, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402526, "deliveryContact": "deliveryContact", "id": 4843, "state": 29, "deliveryDate": 1733244402526, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 3851.6943884099333, "storeId": 8768, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 3775 }, "articleId": "articleId", "storegroupId": 1068, "convert": 2526.754385198676, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 887, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 6849.726162734245, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 6380, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Print

Print purchase order verification

GETUrl: /{id}/verification/print
Headers:
Accept: application/pdf or application/json
Print a purchase order verification based on order id
Body:
Successfull response:

Print purchase order

GETUrl: /{id}/print
Headers:
Accept: application/pdf or application/json
Content-type: application/json or application/xml
Print purchase order
Body:
Successfull response:

Print labels

GETUrl: /{id}/print_labels
Headers:
Accept: application/pdf or application/json
Content-type: application/json or application/xml
Print purchase order labels

Valid parameters:

Parameter Description Default value Allowed values
ordered false
gs1 false

Body:
Successfull response:

Purchase orders

Get purchase order batch products

GETUrl: /{id}/products/{article_id}/batches
Headers:
Accept: application/json or application/xml
Get a list of all batches for a product in a purchase orders
Body:
Successfull response:

{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 8978, "batchId": "batchId", "orderedAmount": "1" }

Get purchase orders

GETUrl:
Headers:
Accept: application/json or application/xml
Get a list of purchase orders based on query

Valid parameters:

Parameter Description Default value Allowed values
supplier_id
query
state -1 -1,0,1,2,3,4
order asc asc,desc
sort_column po_ref id,po_ref,delivery_date,confirmed_delivery_date,delivered_date,supplier
page 0
limit 50

Body:
Successfull response:

{ "ordersCount": 998, "pages": 6940, "pageSize": 372, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 4694, "productionOrderId": 3845, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 4963, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 7601, "orderValue": 1379.0910991855442, "confirmedDeliveryDate": 1733244402530, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402530, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402530, "deliveryContact": "deliveryContact", "id": 129, "state": 2429, "deliveryDate": 1733244402530, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 58.316718716919794, "storeId": 4443, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 7319 }, "articleId": "articleId", "storegroupId": 671, "convert": 8057.4195398096845, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 2723, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 4445.959730176561, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 4229, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 9728 }

Get purchase orders with article

GETUrl: /article/{article_id : .+}
Headers:
Accept: application/json or application/xml
Get a list of purchase orders that contains a specific article. It´s also possible to filter article on batch or serialnumber

Valid parameters:

Parameter Description Default value Allowed values
batch
serialnumber
max_state
order asc asc,desc
sort_column id id,po_ref,delivery_date,confirmed_delivery_date,delivered_date,supplier,state
page 0
limit 50

Body:
Successfull response:

{ "ordersCount": 2389, "pages": 8864, "pageSize": 5824, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 1444, "productionOrderId": 6993, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 9131, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 5766, "orderValue": 2754.844705799809, "confirmedDeliveryDate": 1733244402532, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402532, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402532, "deliveryContact": "deliveryContact", "id": 8075, "state": 6099, "deliveryDate": 1733244402532, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 6651.892809637857, "storeId": 7580, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 1689 }, "articleId": "articleId", "storegroupId": 9854, "convert": 3025.2242339288614, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 4219, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 7408.134554710794, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 8016, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 3871 }

Get last delivered purchase orders for article

GETUrl: /article/{article_id : .+}/last_delivered
Headers:
Accept: application/json or application/xml
Get last delivered purchase orders for article
Body:
Successfull response:

{ "ordersCount": 8217, "pages": 6087, "pageSize": 7324, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 227, "productionOrderId": 9110, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 5028, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 8193, "orderValue": 8582.542695265027, "confirmedDeliveryDate": 1733244402534, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402534, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402534, "deliveryContact": "deliveryContact", "id": 5837, "state": 8168, "deliveryDate": 1733244402534, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 6511.58914751756, "storeId": 5967, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 5122 }, "articleId": "articleId", "storegroupId": 7866, "convert": 6962.521516911306, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 561, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 3069.6174711540734, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 8368, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 1802 }

Get purchase orders based on state

GETUrl: /state/{state}
Headers:
Accept: application/json or application/xml
Get a list of purchase orders based on state

Valid parameters:

Parameter Description Default value Allowed values
supplier_id
order asc asc,desc
sort_column po_ref id,po_ref,delivery_date,confirmed_delivery_date,delivered_date,supplier
page 0
limit 50

Body:
Successfull response:

{ "ordersCount": 1751, "pages": 4756, "pageSize": 2467, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 6299, "productionOrderId": 170, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 3135, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 8093, "orderValue": 1659.9970703815281, "confirmedDeliveryDate": 1733244402535, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402535, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402535, "deliveryContact": "deliveryContact", "id": 9242, "state": 9977, "deliveryDate": 1733244402535, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 7731.363236599934, "storeId": 2845, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 1734 }, "articleId": "articleId", "storegroupId": 8193, "convert": 1968.9097723238003, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 8127, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 6077.296643839345, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 7563, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 5593 }

Get purchase order

GETUrl: /{id}
Headers:
Accept: application/json or application/xml
Get a single purchase orders based on order id
Body:
Successfull response:

{ "ordersCount": 1802, "pages": 8266, "pageSize": 827, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 408, "productionOrderId": 6082, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 3233, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 5737, "orderValue": 8908.772671379662, "confirmedDeliveryDate": 1733244402537, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402537, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402537, "deliveryContact": "deliveryContact", "id": 9285, "state": 652, "deliveryDate": 1733244402537, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 5218.988139018767, "storeId": 3245, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 299 }, "articleId": "articleId", "storegroupId": 1719, "convert": 1641.8302333412737, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 4319, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 6130.569867303144, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 2930, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 1781 }

Get dropshipment order for supplier

GETUrl: /dropshipment/{customer_order_id}/supplier/{supplier_id}
Headers:
Accept: application/json or application/xml
Get a dropshipment order for a customer order and supplier
Body:
Successfull response:

{ "ordersCount": 9168, "pages": 4370, "pageSize": 7633, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 429, "productionOrderId": 8159, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 6977, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 2899, "orderValue": 6304.099725717226, "confirmedDeliveryDate": 1733244402538, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402538, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402538, "deliveryContact": "deliveryContact", "id": 2732, "state": 1070, "deliveryDate": 1733244402538, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 5787.56896926486, "storeId": 2374, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 7806 }, "articleId": "articleId", "storegroupId": 3607, "convert": 7276.639917140547, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 3826, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 6038.485141416444, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 7611, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 4412 }

Get dropshipment orders for customer order

GETUrl: /dropshipment/{customer_order_id}
Headers:
Accept: application/json or application/xml
Get dropshipment orders for a customer order
Body:
Successfull response:

{ "ordersCount": 9574, "pages": 2842, "pageSize": 1249, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 8001, "productionOrderId": 6251, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 2054, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 6941, "orderValue": 6004.693966449207, "confirmedDeliveryDate": 1733244402539, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402539, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402539, "deliveryContact": "deliveryContact", "id": 1529, "state": 1342, "deliveryDate": 1733244402539, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 6000.018252359304, "storeId": 8250, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 2648 }, "articleId": "articleId", "storegroupId": 3645, "convert": 5913.197286725882, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 2932, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 6115.813978999828, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 7966, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 5116 }

Get purchase order products

GETUrl: /{id}/products
Headers:
Accept: application/json or application/xml
Get a list of all products in a purchase orders with detailed information

Valid parameters:

Parameter Description Default value Allowed values
query
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,supplier,is_stock,type,status,active

Body:
Successfull response:

{ "pages": 9241, "pageSize": 727, "page": 4132, "articlesCount": 3669, "articles": [{ "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 2520.0287274237708, "supplierExternalId": "supplierExternalId", "type": "type", "price": 6859.963664664258, "supplier": 4756, "supplierArticleId": "supplierArticleId", "vatAccount": 8450, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 9121.650150029185, "bundled": "false", "vat": 5642.391012042246, "nextDeliveryDate": 1028, "active": "true", "weight": 4329.205925780292, "tags": [{ "name": "name", "externalId": "externalId", "id": 106, "desc": "desc" }], "supplierBuyRate": 937.8832984012475, "unit": "st", "reserved": 5972.614705129786, "name": "name", "parts": [{ "buyPrice": 540.6561977745805, "supplierName": "supplierName", "amount": 2984.627454484937, "articleName": "articleName", "supplierId": 629, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 1483.513754646072, "buyPriceShipment": 7040.210341189752, "buyPriceMisc": 1109.0869010750082, "supplierArticleId": "supplierArticleId", "stock": 4233.999602323307, "isStock": true, "stockWarning": 2831.217836906742 }], "supplierBuyPriceShipment": 5884.761497264155, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 403, "orderedAmount": 6153.991980181183, "stockWarning": 656.4102391428218, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 9368.505804179538, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 6489.591303917153, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 7386.692561490818, "bestBefore": 3968, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 5975.717932376042, "totalSerialNumbersInStock": 2686.445151464786, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2462.571104877589, "bestBefore": 3637, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 7655.904406774768, "totalBatches": 8538, "totalSerialNumbers": 2828 }, "webshopArticle": "false", "availableAmount": 416.36899207041165, "orderLevel": 3999.1053924836974, "prices": [{ "listId": 9813, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 7997.8423810935055, "supplierBuyRate": "1.0", "supplierBuyPrice": 487.7142930052736, "supplier": 359, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 7202.358437267215 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 489.0793541457139, "amount": 9808.35074351661, "articleId": "articleId", "externalId": "externalId", "depth": 8952.703452600921, "supplierBuyPrice": 8166.154359606027, "supplierBuyCurrency": "supplierBuyCurrency", "width": 3426.0470322537994, "category": "övrigt" }], "since": 5273 }

Get open purchase order articles

GETUrl: /open/products
Headers:
Accept: application/json or application/xml
Get articles for open purchase order. The open purchase order is not connected to a specific supplier and cannot be closed. It´s just a container for articles that should later be ordered

Valid parameters:

Parameter Description Default value Allowed values
order asc asc,desc
sort_column art id,po_ref,delivery_date,confirmed_delivery_date,delivered_date,supplier
page 0
limit 20

Body:
Successfull response:

{ "pages": 5123, "pageSize": 3918, "page": 721, "articlesCount": 7467, "articles": [{ "supplierName": "supplierName", "articleName": "articleName", "supplierId": 5460, "shipmentPrice": 9298.860672608685, "bundled": true, "articleId": "articleId", "miscPrice": 7256.485462793132, "purchasePrice": 5636.729559566963, "partAmount": 7387.581619976974, "rate": 7122.243606174176, "bundleParts": [{ "supplierName": "supplierName", "articleName": "articleName", "supplierId": 5439, "shipmentPrice": 3025.4679619557132, "bundled": true, "articleId": "articleId", "miscPrice": 6252.040357189858, "purchasePrice": 580.4360832430932, "partAmount": 7477.327119573386, "rate": 2137.683298978904, "bundleParts": [{ "supplierName": "supplierName", "articleName": "articleName", "supplierId": 1495, "shipmentPrice": 3429.636955450577, "bundled": true, "articleId": "articleId", "miscPrice": 9500.324253499497, "purchasePrice": 4731.096330565647, "partAmount": 4525.492459573916, "rate": 8955.190774145114, "bundleParts": [], "currency": "currency", "orders": [], "orderedAmount": 8414.494220572367 }], "currency": "currency", "orders": [{ "id": 1034, "poReference": "poReference" }], "orderedAmount": 6711.284964631361 }], "currency": "currency", "orders": [{ "id": 645, "poReference": "poReference" }], "orderedAmount": 4117.483890844409 }] }

Get purchase order by po-ref

GETUrl: /po_ref/{po_ref}
Headers:
Accept: application/json or application/xml
Get a single purchase order based on po-ref
Body:
Successfull response:

{ "ordersCount": 5577, "pages": 5631, "pageSize": 8689, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 726, "productionOrderId": 9426, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 1467, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 8108, "orderValue": 9375.100073307183, "confirmedDeliveryDate": 1733244402543, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402543, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402543, "deliveryContact": "deliveryContact", "id": 9139, "state": 2356, "deliveryDate": 1733244402543, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 6971.956546554362, "storeId": 1560, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 4757 }, "articleId": "articleId", "storegroupId": 9596, "convert": 5055.2707179072695, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 8276, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 9556.5175983232, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 9069, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 4944 }

Get available po-ref

GETUrl: /po_ref/next_id
Headers:
Accept: application/json or application/xml
Get next available po-ref that can be used when creating a new purchase order
Body:
Successfull response:

{"poReference": "poReference"}

Get order value based on state and query

GETUrl: /state/{state}/order_value
Headers:
Accept: application/json or application/xml
Get total order value based on state and query

Valid parameters:

Parameter Description Default value Allowed values
supplier_id
query

Body:
Successfull response:

{ "ordersCount": 4958, "pages": 9762, "pageSize": 8336, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 265, "productionOrderId": 4021, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 2906, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 7848, "orderValue": 116.30170127784555, "confirmedDeliveryDate": 1733244402545, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402545, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402545, "deliveryContact": "deliveryContact", "id": 8088, "state": 5303, "deliveryDate": 1733244402545, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 4607.105294292312, "storeId": 1552, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 9629 }, "articleId": "articleId", "storegroupId": 935, "convert": 9190.204432715049, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 1607, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 5299.504619203703, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 5497, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 7973 }

Get ordered articles

GETUrl: /ordered_articles
Headers:
Accept: application/json or application/xml
Get ordered articles for store

Valid parameters:

Parameter Description Default value Allowed values
order asc asc,desc
sort_column name art, name, bundled, cat, desc, order, state
page 0
limit 50

Body:
Successfull response:

{ "pages": 1918, "pageSize": 7421, "page": 4819, "articlesCount": 5404, "articles": [{ "orderId": 42, "state": 7963, "article": { "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 1948.518714936065, "supplierExternalId": "supplierExternalId", "type": "type", "price": 5418.909301220661, "supplier": 7262, "supplierArticleId": "supplierArticleId", "vatAccount": 1357, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 6088.526212574166, "bundled": "false", "vat": 9719.328639550355, "nextDeliveryDate": 8013, "active": "true", "weight": 6470.574854309708, "tags": [{ "name": "name", "externalId": "externalId", "id": 9028, "desc": "desc" }], "supplierBuyRate": 4240.32003413653, "unit": "st", "reserved": 6246.450184392722, "name": "name", "parts": [{ "buyPrice": 9633.469487794924, "supplierName": "supplierName", "amount": 4136.36561847335, "articleName": "articleName", "supplierId": 7112, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 8055.526184112636, "buyPriceShipment": 9936.018902866444, "buyPriceMisc": 2401.054949149287, "supplierArticleId": "supplierArticleId", "stock": 6482.833800123167, "isStock": false, "stockWarning": 9434.568749844488 }], "supplierBuyPriceShipment": 1878.2442300607238, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 3614, "orderedAmount": 5590.5117911519255, "stockWarning": 2374.241760881125, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 3419.576457093473, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 696.3050582874264, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 1875.206878574337, "bestBefore": 3497, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 566.127002652197, "totalSerialNumbersInStock": 4781.925341469977, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2453.9393017901525, "bestBefore": 7062, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 2542.220096659169, "totalBatches": 921, "totalSerialNumbers": 285 }, "webshopArticle": "false", "availableAmount": 1027.3267487387538, "orderLevel": 4557.080085229699, "prices": [{ "listId": 6424, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 8032.283217859594, "supplierBuyRate": "1.0", "supplierBuyPrice": 5073.771728517065, "supplier": 7756, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 5080.164122962844 }], "automaticOrder": true, "supplierName": "supplierName", "deliveredAmount": 836.2278247557953, "amount": 1521.983867782878, "articleId": "articleId", "externalId": "externalId", "depth": 5132.40081532453, "supplierBuyPrice": 2187.9166197942536, "supplierBuyCurrency": "supplierBuyCurrency", "width": 3863.657996415387, "category": "övrigt" }, "poReference": "poReference" }], "since": 2849 }

Get warned articles

GETUrl: /warned_articles
Headers:
Accept: application/json or application/xml
Get warned articles for store

Valid parameters:

Parameter Description Default value Allowed values
order asc asc,desc
sort_column name art, name, bundled, cat, desc, supplier, order, state
page 0
limit 50
include_ordered true

Body:
Successfull response:

{ "pages": 1427, "pageSize": 1953, "page": 3777, "articlesCount": 3842, "articles": [{ "orderId": 5953, "state": 8487, "article": { "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 546.9480728506626, "supplierExternalId": "supplierExternalId", "type": "type", "price": 9514.395264963143, "supplier": 564, "supplierArticleId": "supplierArticleId", "vatAccount": 5959, "links": [{ "name": "name", "type": "type", "url": "url" }], "stock": "true", "barcode": "barcode", "height": 2413.258614989685, "bundled": "false", "vat": 6356.7775405619095, "nextDeliveryDate": 1637, "active": "true", "weight": 2203.327928719374, "tags": [{ "name": "name", "externalId": "externalId", "id": 9791, "desc": "desc" }], "supplierBuyRate": 8064.286680837687, "unit": "st", "reserved": 3918.7279539569, "name": "name", "parts": [{ "buyPrice": 610.6940912744874, "supplierName": "supplierName", "amount": 1039.2694369024534, "articleName": "articleName", "supplierId": 474, "unitName": "unitName", "articleId": "articleId", "externalId": "externalId", "stockPlace": "stockPlace", "type": "type", "buyPriceCurrency": "buyPriceCurrency", "reserved": 691.4439920293114, "buyPriceShipment": 2612.61805121629, "buyPriceMisc": 6902.367116724809, "supplierArticleId": "supplierArticleId", "stock": 5610.507359401014, "isStock": false, "stockWarning": 7895.293137200741 }], "supplierBuyPriceShipment": 702.9279092418028, "manufacturerArticleId": "manufacturerArticleId", "imageLastUpdated": 5234, "orderedAmount": 2205.7365272653064, "stockWarning": 2762.7782408819103, "customFields": [{ "name": "name", "type": "type", "validValues": [{ "description": "description", "value": "value" }], "value": "value" }], "barcodeType": "EAN", "description": "description", "stockPlace": "stockPlace", "criticalLevel": 9469.437016878011, "manufacturer": "manufacturer", "batches": { "totalSerialNumbersReserved": 4448.180587415907, "batches": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2359.4216584707806, "bestBefore": 6133, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesInStock": 7535.976577260048, "totalSerialNumbersInStock": 5194.796502670006, "serialNumbers": [{ "serialNr": "serialNr", "amount": "1", "articleName": "articleName", "reserved": 2149.6480212227407, "bestBefore": 1264, "articleId": "articleId", "batchId": "batchId", "barcode": "barcode" }], "totalBatchesReserved": 5314.607860116404, "totalBatches": 671, "totalSerialNumbers": 4565 }, "webshopArticle": "false", "availableAmount": 2544.0687957514842, "orderLevel": 7640.659768346783, "prices": [{ "listId": 6901, "price": "0", "articleId": "articleId", "fromQuantity": "0", "listExternalId": "listExternalId" }], "supplierArticles": [{ "supplierName": "supplierName", "supplierAutomaticOrder": false, "supplierBuyPriceMisc": 6717.334568814277, "supplierBuyRate": "1.0", "supplierBuyPrice": 649.6063669922047, "supplier": 6751, "supplierArticleId": "supplierArticleId", "supplierBuyCurrency": "Store currency", "supplierBuyPriceShipment": 9212.164083137539 }], "automaticOrder": false, "supplierName": "supplierName", "deliveredAmount": 6253.471479906652, "amount": 2614.1177258096313, "articleId": "articleId", "externalId": "externalId", "depth": 5895.209702059685, "supplierBuyPrice": 5901.927931695109, "supplierBuyCurrency": "supplierBuyCurrency", "width": 222.7594847345926, "category": "övrigt" }, "poReference": "poReference" }], "since": 4061 }

Add purchase order

POSTUrl:
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Add a new purchase order
Body:

{ "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 5283, "productionOrderId": 9603, "customerOrderId": 4975, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "confirmedDeliveryDate": 1733244402553, "externalInvoiceReference": "externalInvoiceReference", "deliveryAddress": "deliveryAddress", "deliveryContact": "deliveryContact", "state": 7281, "deliveryDate": 1733244402553, "paymentTerms": "paymentTerms", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 3811, "batchId": "batchId", "orderedAmount": "1" }], "articleName": "articleName", "purchasePriceMisc": "0", "articleId": "articleId", "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "description": "description", "purchasePrice": "0", "orderedAmount": "0" }], "poReference": "poReference" }
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 2182, "productionOrderId": 4282, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 2193, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 987, "orderValue": 8413.067720342324, "confirmedDeliveryDate": 1733244402553, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402553, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402553, "deliveryContact": "deliveryContact", "id": 7180, "state": 7277, "deliveryDate": 1733244402553, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 6086.548009944781, "storeId": 7774, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 6199 }, "articleId": "articleId", "storegroupId": 6987, "convert": 912.9528038584356, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 1759, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 3750.0902206311084, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 3544, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Create purchase order from customer order

POSTUrl: /customer_order
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Create a new purchase order from a customer order
Body:

{ "customerOrderId": 5602, "articles": [{ "articleId": "articleId", "orderedAmount": "0", "storeId": 2678 }] }
Successfull response:

{ "ordersCount": 9475, "pages": 8221, "pageSize": 4942, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 536, "productionOrderId": 5933, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 3595, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 1221, "orderValue": 9449.90288479006, "confirmedDeliveryDate": 1733244402555, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402555, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402555, "deliveryContact": "deliveryContact", "id": 9600, "state": 6965, "deliveryDate": 1733244402555, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 2458.12979086824, "storeId": 4419, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 4212 }, "articleId": "articleId", "storegroupId": 9798, "convert": 5896.346110520516, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 3539, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 7503.384145618896, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 1729, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 3322 }

Create purchase orders from production order

POSTUrl: /production_order
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Create new purchase orders from a production order
Body:

{ "productionOrderId": 9314, "articles": [{ "articleId": "articleId", "orderedAmount": "0", "storeId": 9789 }] }
Successfull response:

{ "ordersCount": 4735, "pages": 6540, "pageSize": 3668, "orders": [{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 8063, "productionOrderId": 7577, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 4570, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 4492, "orderValue": 6146.793539624322, "confirmedDeliveryDate": 1733244402556, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402556, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402556, "deliveryContact": "deliveryContact", "id": 5244, "state": 3348, "deliveryDate": 1733244402556, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 1104.2868327073563, "storeId": 2980, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 1061 }, "articleId": "articleId", "storegroupId": 1100, "convert": 5483.886010660541, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 2135, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 3664.061412453484, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 5188, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }], "page": 5642 }

Add row to purchase order

POSTUrl: /{id}/product
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Add article or textrow to an existing purchase order
Body:

{ "deliveredAmount": "0", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 3498, "batchId": "batchId", "orderedAmount": "1" }], "articleName": "articleName", "purchasePriceMisc": "0", "articleId": "articleId", "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "description": "description", "purchasePrice": "0", "orderedAmount": "0" }
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 2360, "productionOrderId": 7615, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 1339, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 1280, "orderValue": 9061.483010930315, "confirmedDeliveryDate": 1733244402558, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402558, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402558, "deliveryContact": "deliveryContact", "id": 6823, "state": 1477, "deliveryDate": 1733244402558, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 3548.458383824138, "storeId": 4300, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 3433 }, "articleId": "articleId", "storegroupId": 7051, "convert": 9318.041618860923, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 8993, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 3889.603162766452, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 7995, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Add articles to purchase order

POSTUrl: /products
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Add articles to a new or existing purchase order
Body:

{ "supplierId": 179, "orderId": 6177, "articles": [{ "deliveredAmount": "0", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 8892, "batchId": "batchId", "orderedAmount": "1" }], "articleName": "articleName", "purchasePriceMisc": "0", "articleId": "articleId", "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "description": "description", "purchasePrice": "0", "orderedAmount": "0" }] }
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 9155, "productionOrderId": 5232, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 9404, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 4923, "orderValue": 9284.053997268937, "confirmedDeliveryDate": 1733244402559, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402559, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402559, "deliveryContact": "deliveryContact", "id": 1424, "state": 186, "deliveryDate": 1733244402559, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 2587.80793026945, "storeId": 1272, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 7500 }, "articleId": "articleId", "storegroupId": 663, "convert": 2791.352615681736, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 8409, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 1989.4601962747392, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 140, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Add article to open order

POSTUrl: /open/products
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Add article to open purchase order
Body:

{ "amount": 2272.254029879156, "articleId": "articleId" }
Successfull response:

Create article

POSTUrl: /{order_id}/create_article
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Create a new article from a purchase order row and replaces that row with the newly create article
Body:

{ "deliveredAmount": 6241.817134659164, "unit": "unit", "articleName": "articleName", "orderId": 6406, "articleId": "articleId", "supplierArticleId": "supplierArticleId", "purchasePrice": 5113.654608855467 }
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 9792, "productionOrderId": 8104, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 3514, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 3098, "orderValue": 2386.343795228899, "confirmedDeliveryDate": 1733244402562, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402562, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402562, "deliveryContact": "deliveryContact", "id": 4794, "state": 4628, "deliveryDate": 1733244402562, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 6651.352964115931, "storeId": 6825, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 1355 }, "articleId": "articleId", "storegroupId": 6506, "convert": 8026.536110100549, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 4132, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 9871.046915678595, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 8914, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Update purchase order product

PUTUrl: /{id}/product
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Update an existing purchase order product
Body:

{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 5237 }, "articleId": "articleId", "storegroupId": 7368, "convert": 1630.056875282112, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 3657, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 7553.2782820342445, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 4293, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 4311, "productionOrderId": 3296, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 4652, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 658, "orderValue": 4645.576639604744, "confirmedDeliveryDate": 1733244402564, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402564, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402564, "deliveryContact": "deliveryContact", "id": 6920, "state": 6442, "deliveryDate": 1733244402564, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 8269.240427961246, "storeId": 9009, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 6569 }, "articleId": "articleId", "storegroupId": 7616, "convert": 2627.048017170526, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 4586, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 6679.501936017165, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 2370, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Update purchase order

PUTUrl: /{id}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Update an existing purchase order
Body:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 6839, "productionOrderId": 7898, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 1409, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 4899, "orderValue": 5699.936533805178, "confirmedDeliveryDate": 1733244402566, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402566, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402566, "deliveryContact": "deliveryContact", "id": 5916, "state": 1559, "deliveryDate": 1733244402566, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 7699.377251456324, "storeId": 9262, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 6775 }, "articleId": "articleId", "storegroupId": 2618, "convert": 7503.690994712331, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 3828, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 6943.9389108408795, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 9518, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 6086, "productionOrderId": 5516, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 6573, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 140, "orderValue": 6785.037245611258, "confirmedDeliveryDate": 1733244402566, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402566, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402566, "deliveryContact": "deliveryContact", "id": 5908, "state": 9053, "deliveryDate": 1733244402566, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 3414.5696087845245, "storeId": 5555, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 5872 }, "articleId": "articleId", "storegroupId": 135, "convert": 9228.699668711815, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 4417, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 6672.708939779335, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 5863, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Remove purchase order product

PUTUrl: /{id}/product/remove
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Remove product from an existing purchase order
Body:

{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 8638 }, "articleId": "articleId", "storegroupId": 8428, "convert": 2501.0446286957267, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 1242, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 6769.330283186524, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 2541, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 7323, "productionOrderId": 8082, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 2007, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 6346, "orderValue": 2267.7710089954617, "confirmedDeliveryDate": 1733244402569, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402569, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402569, "deliveryContact": "deliveryContact", "id": 6283, "state": 8299, "deliveryDate": 1733244402569, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 240.67154052119344, "storeId": 6250, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 6229 }, "articleId": "articleId", "storegroupId": 7172, "convert": 803.0822655785264, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 4109, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 4715.316829665415, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 3702, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Send purchase order

PUTUrl: /{id}/send
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Update purchase order state to sent

Valid parameters:

Parameter Description Default value Allowed values
sendemail false

Body:

{ "ccList": [{}], "to": "to" }
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 88, "productionOrderId": 8741, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 4162, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 8803, "orderValue": 273.24482102646374, "confirmedDeliveryDate": 1733244402571, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402571, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402571, "deliveryContact": "deliveryContact", "id": 7325, "state": 642, "deliveryDate": 1733244402571, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 3052.6405573160932, "storeId": 4784, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 8969 }, "articleId": "articleId", "storegroupId": 296, "convert": 4803.806994723784, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 3380, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 7143.182757130811, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 648, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Verify purchase order

PUTUrl: /{id}/verify
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Update purchase order state to verified
Body:

{ "verify": "true", "externalInvoiceReference": "externalInvoiceReference", "products": [{ "purchasePriceMisc": 8411.11650077079, "articleId": "articleId", "purchasePriceShipment": 9851.614806805954, "purchasePrice": 6615.5358932078725 }] }
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 6403, "productionOrderId": 2155, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 3551, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 2548, "orderValue": 6575.328742190465, "confirmedDeliveryDate": 1733244402573, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402573, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402573, "deliveryContact": "deliveryContact", "id": 8072, "state": 2503, "deliveryDate": 1733244402573, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 921.0671098714229, "storeId": 5398, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 4564 }, "articleId": "articleId", "storegroupId": 8457, "convert": 730.5682144661773, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 5530, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 9139.122087058382, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 9057, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Cancel purchase order

PUTUrl: /{id}/cancel
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Update purchase order state to cancelled
Body:
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 10, "productionOrderId": 6664, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 1995, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 6442, "orderValue": 9958.758108287346, "confirmedDeliveryDate": 1733244402574, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402574, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402574, "deliveryContact": "deliveryContact", "id": 1840, "state": 2157, "deliveryDate": 1733244402574, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 5984.827861211418, "storeId": 3304, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 4840 }, "articleId": "articleId", "storegroupId": 8968, "convert": 9105.180853378599, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 7256, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 4424.015171738377, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 7080, "orderedAmount": "0", "stock": true, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Update rate

PUTUrl: /{id}/rate
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Update rate for an existing purchase order
Body:

{"rate": 2552.264718546862}
Successfull response:

{ "paymentTermsDescription": "paymentTermsDescription", "deliveryPhone": "deliveryPhone", "supplierOrderId": "supplierOrderId", "supplierId": 1791, "productionOrderId": 4137, "deliveryTermsDescription": "deliveryTermsDescription", "customerOrderId": 7438, "contactPerson": "contactPerson", "deliveryZip": "deliveryZip", "productCount": 184, "orderValue": 7357.374835626201, "confirmedDeliveryDate": 1733244402576, "externalInvoiceReference": "externalInvoiceReference", "orderValueCurrency": "orderValueCurrency", "deliveredDate": 1733244402576, "deliveryAddress": "deliveryAddress", "orderSentDate": 1733244402576, "deliveryContact": "deliveryContact", "id": 1864, "state": 6699, "deliveryDate": 1733244402576, "paymentTerms": "paymentTerms", "supplierName": "supplierName", "deliveryCity": "deliveryCity", "deliveryTerms": "deliveryTerms", "goodsMarking": "goodsMarking", "contactEmail": "contactEmail", "isPickNPack": "false", "deliveryAddress2": "deliveryAddress2", "orderValueStore": 8844.83731229487, "storeId": 6587, "deliveryCompany": "deliveryCompany", "message": "message", "deliveryCountry": "deliveryCountry", "comment": "comment", "articles": [{ "deliveredAmount": "0", "articleName": "articleName", "purchasePriceMisc": "0", "barcodeType": "EAN", "articleId": "articleId", "description": "description", "purchasePrice": "0", "units": [{ "unit": { "name": "name", "externalId": "externalId", "id": 6972 }, "articleId": "articleId", "storegroupId": 5441, "convert": 2146.641946021599, "barcode": "barcode" }], "type": "type", "batches": [{ "deliveredAmount": "1", "serialNr": "serialNr", "bestBefore": 5494, "batchId": "batchId", "orderedAmount": "1" }], "unit": "unit", "availableAmount": "0", "rate": 5634.501195899011, "supplierArticleId": "supplierArticleId", "purchasePriceShipment": "0", "id": 8573, "orderedAmount": "0", "stock": false, "barcode": "barcode", "orderedAmountWithUnits": "orderedAmountWithUnits", "stockWarning": "0" }], "poReference": "poReference" }

Move article from open order

PUTUrl: /open/products
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Move article from open purchase order to either a new purchase order or an existing one
Body:

{ "amount": 6886.559854319658, "supplierId": 8722, "orderId": 4379, "price": 2332.143710169008, "bundleParts": [{ "amount": 2147.112704702282, "supplierId": 5427, "orderId": 5732, "price": 843.0179340309285, "bundleParts": [{ "amount": 1720.2461446747552, "supplierId": 4674, "orderId": 2285, "price": 3284.474486188428, "bundleParts": [{ "amount": 227.02290147853188, "supplierId": 6220, "orderId": 6515, "price": 5418.00980769341, "bundleParts": [], "articleId": "articleId" }], "articleId": "articleId" }], "articleId": "articleId" }], "articleId": "articleId" }
Successfull response:

Remove article from open order

DELETEUrl: /open/products/{article_id : .+}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Remove article from open purchase order
Body:
Successfull response:

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

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

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

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

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

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

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

CreatePurchaseOrderArticle

Field Type Description Default Mandatory Accepted values Example values Access
id Long Unique id for purchase order row R
articleId String Unique article id for the new article POST R,W
articleName String Name of article R,W
supplierArticleId String Supplier´s article id R,W
orderId Long Purchase order id R,W
deliveredAmount Double Delivered amount of the purchase order article. This will be the initial stock value for the newly created article R,W
purchasePrice Double Purchase price R,W
unit String Unit of the article R,W

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

CustomFieldValidValue

Field Type Description Default Mandatory Accepted values Example values Access
value String R
description String R

MoveOpenPurchaseOrderArticle

Field Type Description Default Mandatory Accepted values Example values Access
articleId String PUT R,W
supplierId Long PUT R,W
orderId Long PUT R,W
amount Double PUT R,W
price Double PUT R,W
bundleParts List Only mandatory if article is bundled PUT R,W

OpenPurchaseOrderArticleRequest

Field Type Description Default Mandatory Accepted values Example values Access
articleId String POST R,W
amount double R,W

OpenPurchaseOrderArticleResponse

Field Type Description Default Mandatory Accepted values Example values Access
articleId String R
articleName String R
supplierId Long R
supplierName String R
orderedAmount Double R
purchasePrice Double Total purchase price including shipment and misc costs R
shipmentPrice Double R
miscPrice Double R
currency String R
rate Double R
partAmount Double R
bundled Boolean R
bundleParts List R
orders List R

OpenPurchaseOrderArticlesResponse

Field Type Description Default Mandatory Accepted values Example values Access
page int R
pages int R
pageSize int R
articlesCount int R
articles List R

OrderedArticle

Field Type Description Default Mandatory Accepted values Example values Access
article Article R,W
orderId Long R,W
poReference String R,W
state Integer R,W

OrderedArticlesResponse

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

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

ProductionOrderPurchaseOrderLight

Field Type Description Default Mandatory Accepted values Example values Access
productionOrderId Long R,W
articles List List of PurchaseOrderArticleLight R,W

PurchaseOrder

Field Type Description Default Mandatory Accepted values Example values Access
id long R
storeId long R
poReference String Must be a unique id POST R,W
supplierId Long POST R,W
supplierName String R
orderSentDate Date R
deliveryDate Date POST R,W
confirmedDeliveryDate Date R,W
deliveredDate Date R
paymentTerms String Payment terms code R,W
paymentTermsDescription String Payment terms description R
deliveryTerms String Delivery terms code R,W
deliveryTermsDescription String Delivery terms description R
deliveryContact String R,W
deliveryCompany String R,W
deliveryPhone String R,W
deliveryAddress String POST R,W
deliveryAddress2 String R,W
deliveryCity String POST R,W
deliveryZip String POST R,W
deliveryCountry String POST R,W
contactPerson String POST R,W
contactEmail String POST R,W
productCount Integer R
state Integer NEW = 0,
SENT = 1,
RECEIVED = 2,
FINISHED = 3,
CANCELLED = 4
R,W
supplierOrderId String R,W
customerOrderId Long R,W
productionOrderId Long R,W
message String R,W
isPickNPack Boolean false R,W
comment String R,W
externalInvoiceReference String R,W
goodsMarking String R,W
orderValue Double Order value based on the supplier's currency R
orderValueCurrency String Supplier's currency for the order value R
orderValueStore Double Order value based on the store's currency R
articles List List of PurchaseOrderArticles R,W

PurchaseOrderArticle

Field Type Description Default Mandatory Accepted values Example values Access
id Long id is created by system, but must be supplied when updating order or matching product row won´t be found PUT R
articleId String Mandatory if this is not a freetext row. If this is a freetext row all fields except articleName is ignored POST, DELETE R,W
articleName String Name of article, or freetext row if articleId is missing R,W
supplierArticleId String If omitted, article id from supplier is used R,W
orderedAmount Double 0 R,W
deliveredAmount Double 0 R,W
availableAmount Double 0 R
stockWarning Double 0 R
barcode String R
barcodeType String EAN EAN, CODE128, QR, UPC R
purchasePrice Double If omitted, price from supplier is used 0 R,W
purchasePriceMisc Double If omitted, price from supplier is used 0 R,W
purchasePriceShipment Double If omitted, price from supplier is used 0 R,W
rate Double R
description String R,W
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
batches List If an article contains batches or serial numbers and this should be defined in the purchase order this list contains that information. If this list is null, no updates are done. Otherwise the content of this list replaces existing list R,W
units List List of units connected to the article, with factor and barcode. This does not contain information about the main unit on the article R
orderedAmountWithUnits String If article contains multiple units this string represents the most optimal package variants R

PurchaseOrderArticleBatch

Field Type Description Default Mandatory Accepted values Example values Access
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
orderedAmount Double 1 R,W
deliveredAmount Double 1 R,W
bestBefore Long ms since 1970, Write only with POST R,W

PurchaseOrderArticleLight

Field Type Description Default Mandatory Accepted values Example values Access
articleId String Mandatory if this is not a freetext row. If this is a freetext row all fields except articleName is ignored POST, DELETE R,W
orderedAmount Double 0 R,W
storeId Long R,W

PurchaseOrderArticlesRequest

Field Type Description Default Mandatory Accepted values Example values Access
orderId Long Order on which the articles are added. If null, a new order is created R,W
supplierId Long Should point to an existing supplier if a new order is created R,W
articles List List of articles to add to order R,W

PurchaseOrderDeliveryArticle

Field Type Description Default Mandatory Accepted values Example values Access
id Long Purchase Order Article id POST R,W
deliveredAmount Double If there are batches, this field must be the total delivered for all batches and serialnumbers in the request 0 R,W
batches List List of possible PurchaseOrderDeliveryArticleBatches. Ignored if articleId is not set R,W

PurchaseOrderDeliveryArticleBatch

Field Type Description Default Mandatory Accepted values Example values Access
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
deliveredAmount double 1 R,W
barcode String Write only with POST R,W
bestBefore Long ms since 1970, Write only with POST R,W

PurchaseOrderId

Field Type Description Default Mandatory Accepted values Example values Access
id Long R,W
poReference String R,W

PurchaseOrderLight

Field Type Description Default Mandatory Accepted values Example values Access
customerOrderId Long R,W
articles List List of PurchaseOrderArticleLight R,W

PurchaseOrderRate

Field Type Description Default Mandatory Accepted values Example values Access
rate Double R,W

PurchaseOrderRef

Field Type Description Default Mandatory Accepted values Example values Access
poReference String Next available purchase order reference R

PurchaseOrdersResponse

Field Type Description Default Mandatory Accepted values Example values Access
page int R
pages int R
pageSize int R
ordersCount int R
orders List R

Receivers

Field Type Description Default Mandatory Accepted values Example values Access
to String Main receiver of email POST, PUT R,W
ccList List Copy receiver of email R,W

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

VerifyProduct

Field Type Description Default Mandatory Accepted values Example values Access
articleId String R
purchasePrice Double R,W
purchasePriceShipment Double R,W
purchasePriceMisc Double R,W

VerifyProducts

Field Type Description Default Mandatory Accepted values Example values Access
verify Boolean Set this flag to true if state should be changed on purchase order to finished true W
externalInvoiceReference String R,W
products List R,W