Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The order interface is available starting from version 2.2.0 and is used solely for the PTLCart, where it can be used as a stand alone order picking system.

colour

URL

http://<<ip address>>/rest/order/

Method

GET

Description

Receive a list of all available orders in the PTLControl.

Response

Code Block
languagejson
{
   «orderid»: {
      "orderlines": [
          { 
            "articledescription": «article description», 
            "articlebarcode": «article barcode», 
            "location": «location», 
            "ordered": «amount ordered», 
            "picked": «amount picked»
          },
          ...
      ],
      "tote": «order tote»
  },
   ...
}

Note that «amount picked» can be null if the line has not been processed yet.

Possible Error

HTTP404 with no body when no orders found.

Status

Status
Yellow
titledevelop

URL

http://<<ip address>>/rest/order/«orderid»

Method

GET

Description

Receive the lines in order «orderid».

Response

Code Block
languagejson
{
      "orderlines": [
          { 
            "articledescription": «article description», 
            "articlebarcode": «article barcode», 
            "location": «location», 
            "ordered": «amount ordered»ordersed», 
            "picked": «amount picked»
          },
          ...
      ],              
      "tote": «order tote»
}

Note that «amount picked» can be null if the line has not been processed yet.

Possible Error

HTTP404 with no body when the order was not found.

Status

Status
colourYellow
titledevelop

Status

URL

http://<<ip address>>/rest/order/

Method

DELETE

Description

Delete all orders

Response

HTTP204

Status
colourYellow
titledevelop

URL

http://<<ip address>>/rest/order/«orderid»

Method

DELETE

Description

Delete order with orderid «orderid» «oderid». There is no reason not to delete an order, i.e. there are no checks on status, progress, lines, etc. Note, when the order did not exist, this call still returns a HTTP204.

Response

HTTP204

Status

Status
colourYellow
titledevelop

HTTP204d

develop

URL

http://<<ip address>>/rest/order/

Method

POST

Description

Create a new orders, if an order already exists, it will be overwritten, whatever the status of the order.

Request

Code Block
languagejson
{
   «orderid»: { 
      "orderlines": [
          { 
            "articledescription": «article description», 
            "articlebarcode": «article barcode», 
            "location": «location», 
            "ordered": «amount ordered»
          },
          ...
      ],
      "tote": «order tote»
  },
   ...
}

Response

HTTP201 without body if created or updated status

colourBlue
titleimplemented

Possible Error

HTTP400 if request was invalid (e.g. invalid JSON). A human readable error message can be found in the body.

Status
colourBlue
titleimplemented

Status

Status
colourYellow
title

URL

http://<<ip address>>/rest/order/«orderid»

Method

PUT

Description

Set the tote for this order.

Request

Code Block
languagejson
{
   "tote": «toteid»
}

«toteid» can be a string

Response

HTTP200 without body if updated

Possible Error

HTTP404 if order was not found.