Purchase orders API
General:
Basics:
Parameters in the url should all be encoded and all data sent should be UTF-8
MAX number of requests per minute is set to 200.
When the limit is hit an error with code 429 is returned, with the header "Retry-After" containing the number of seconds you have to wait for your next request.
When the limit is hit an error with code 429 is returned, with the header "Retry-After" containing the number of seconds you have to wait for your next request.
Headers:
There are 2 ways to be authenticated when using this API. in both ways you add headers to the request.
1) Use an API-key together with store-id. This would be used when communicating machine to machine and no real person is involved. The API-key is available from where you activated the API. The store-id is also available in the same place.
2) Use a user_id and user_token together with a store-id. You get these values from the login-request. The values are connected to a person and are gained when an actual login to the system has been made.
1) Use an API-key together with store-id. This would be used when communicating machine to machine and no real person is involved. The API-key is available from where you activated the API. The store-id is also available in the same place.
2) Use a user_id and user_token together with a store-id. You get these values from the login-request. The values are connected to a person and are gained when an actual login to the system has been made.
store: <<STORE>> user_id: <<USER_ID>> user_token: <<USER_TOKEN>> api_key: <<API_KEY>> Accept: application/json Content-Type: application/json
Errors:
Code | Description |
---|---|
900001 | Credentials don't match |
900101 | Common error |
900429 | Too many requests |
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
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
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
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 purchase order verification
GETUrl: /{id}/verification/print
Headers:
Accept: application/pdf or application/json
Print a purchase order verification based on order id
Print purchase order
GETUrl: /{id}/print
Headers:
Accept: application/pdf or application/json
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Print purchase order
Print labels
GETUrl: /{id}/print_labels
Headers:
Accept: application/pdf or application/json
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Print purchase order labels
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
ordered | false | ||
gs1 | false |
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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 |