Pickwagen

Manage warehouse pick trolleys and boxes in VARIO Cloud, including assignments, states, barcode lookup, box generation and picking workflows.

Pickwagen & Co.

Find an existing Resource by identifier

get

Path parameters

idinteger · int64Required

an identifier

Responses

200

successful operation

application/json

Pickwagen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung des Wagens

descriptionstringOptional

Beschreibung des Wagens

identifierstringOptional

Barcode zur Selektion des Wagens

typestring · enumOptional

Pickwagen Typen

Possible values:

statestring · enumRead-onlyOptional

Status vom Pickwagen

Possible values:

currentPicklistIdinteger · int64Read-onlyOptional

Wagen gehört aktuell zu dieser Pickliste

404

Resource with given ID was not found

application/json

get/wms/picktrolleys/{id}

GET /wms/picktrolleys/{id} HTTP/1.1
Host: api.example.com
Accept: */*

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "type": "FREE_COLLECTION",
  "state": "NOT_ACTIVE",
  "processedByUserRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "currentPicklistId": 1,
  "pickTrolleyGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "storageBinRef": {
    "id": 1,
    "displayName": "text",
    "routePosition": 1,
    "color": "text",
    "storageRef": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    }
  },
  "pickTrolleyBoxes": [],
  "picklistTemplateRefs": []
}

Update existing Resource

put

Path parameters

idinteger · int64Required

an identifier

Body

Pickwagen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung des Wagens

descriptionstringOptional

Beschreibung des Wagens

identifierstringOptional

Barcode zur Selektion des Wagens

typestring · enumOptional

Pickwagen Typen

Possible values:

statestring · enumRead-onlyOptional

Status vom Pickwagen

Possible values:

currentPicklistIdinteger · int64Read-onlyOptional

Wagen gehört aktuell zu dieser Pickliste

Responses

200

successful operation

application/json

Pickwagen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung des Wagens

descriptionstringOptional

Beschreibung des Wagens

identifierstringOptional

Barcode zur Selektion des Wagens

typestring · enumOptional

Pickwagen Typen

Possible values:

statestring · enumRead-onlyOptional

Status vom Pickwagen

Possible values:

currentPicklistIdinteger · int64Read-onlyOptional

Wagen gehört aktuell zu dieser Pickliste

404

Resource was not found

application/json

422

Resource was not valid to process

application/json

put/wms/picktrolleys/{id}

PUT /wms/picktrolleys/{id} HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 346

{
  "version": "text",
  "info": {},
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "type": "FREE_COLLECTION",
  "processedByUserRef": {
    "id": "text"
  },
  "pickTrolleyGroupRef": {
    "id": "text"
  },
  "storageBinRef": {
    "id": 1,
    "displayName": "text",
    "routePosition": 1,
    "color": "text",
    "storageRef": {
      "id": "text"
    }
  },
  "pickTrolleyBoxes": [],
  "picklistTemplateRefs": []
}

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "type": "FREE_COLLECTION",
  "state": "NOT_ACTIVE",
  "processedByUserRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "currentPicklistId": 1,
  "pickTrolleyGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "storageBinRef": {
    "id": 1,
    "displayName": "text",
    "routePosition": 1,
    "color": "text",
    "storageRef": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    }
  },
  "pickTrolleyBoxes": [],
  "picklistTemplateRefs": []
}

Delete an existing Resource

delete

Path parameters

idinteger · int64Required

an identifier

Responses

200

successful operation

application/json

contextstringOptional

message context

messageValuestringOptional

message

404

Resource was not found

application/json

409

unable to delete Resource, due to constraints, existing references or internal state

application/json

delete/wms/picktrolleys/{id}

DELETE /wms/picktrolleys/{id} HTTP/1.1
Host: api.example.com
Accept: */*

{
  "context": "text",
  "messageValue": "text"
}

put

Path parameters

idinteger · int64Required

ID des Pickwagen

Responses

200

OK

application/json

Pickwagen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung des Wagens

descriptionstringOptional

Beschreibung des Wagens

identifierstringOptional

Barcode zur Selektion des Wagens

typestring · enumOptional

Pickwagen Typen

Possible values:

statestring · enumRead-onlyOptional

Status vom Pickwagen

Possible values:

currentPicklistIdinteger · int64Read-onlyOptional

Wagen gehört aktuell zu dieser Pickliste

put/wms/picktrolleys/{id}/free

PUT /wms/picktrolleys/{id}/free HTTP/1.1
Host: api.example.com
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "type": "FREE_COLLECTION",
  "state": "NOT_ACTIVE",
  "processedByUserRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "currentPicklistId": 1,
  "pickTrolleyGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "storageBinRef": {
    "id": 1,
    "displayName": "text",
    "routePosition": 1,
    "color": "text",
    "storageRef": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    }
  },
  "pickTrolleyBoxes": [],
  "picklistTemplateRefs": []
}

get

Path parameters

idinteger · int64Required

ID des Pickwagen

boxIdinteger · int64Required

ID der Pickbox

Responses

200

OK

application/json

Pickbox

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung der Box

descriptionstringOptional

Beschreibung der Box

identifierstringOptional

Barcode zur Selektion der Box

statestring · enumRead-onlyOptional

Status der Pickbox

Possible values:

currentDocumentIdinteger · int64Optional

Aktuell kommissionierter Beleg

pickTrolleyIdinteger · int64Required

Box gehört zu diesem Pickwagen

get/wms/picktrolleys/{id}/boxes/{boxId}

GET /wms/picktrolleys/{id}/boxes/{boxId} HTTP/1.1
Host: api.example.com
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "state": "NOT_ACTIVE",
  "currentDocumentId": 1,
  "pickTrolleyId": 1
}

put

Path parameters

idinteger · int64Required

ID des Pickwagen

boxIdinteger · int64Required

ID der Pickbox

Body

Pickbox

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung der Box

descriptionstringOptional

Beschreibung der Box

identifierstringOptional

Barcode zur Selektion der Box

statestring · enumRead-onlyOptional

Status der Pickbox

Possible values:

currentDocumentIdinteger · int64Optional

Aktuell kommissionierter Beleg

pickTrolleyIdinteger · int64Required

Box gehört zu diesem Pickwagen

Responses

200

OK

application/json

Pickbox

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung der Box

descriptionstringOptional

Beschreibung der Box

identifierstringOptional

Barcode zur Selektion der Box

statestring · enumRead-onlyOptional

Status der Pickbox

Possible values:

currentDocumentIdinteger · int64Optional

Aktuell kommissionierter Beleg

pickTrolleyIdinteger · int64Required

Box gehört zu diesem Pickwagen

put/wms/picktrolleys/{id}/boxes/{boxId}

PUT /wms/picktrolleys/{id}/boxes/{boxId} HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "version": "text",
  "info": {},
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "currentDocumentId": 1,
  "pickTrolleyId": 1
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "state": "NOT_ACTIVE",
  "currentDocumentId": 1,
  "pickTrolleyId": 1
}

delete

Path parameters

idinteger · int64Required

ID des Pickwagen

boxIdinteger · int64Required

ID der Pickbox

Responses

200

OK

application/json

contextstringOptional

message context

messageValuestringOptional

message

delete/wms/picktrolleys/{id}/boxes/{boxId}

DELETE /wms/picktrolleys/{id}/boxes/{boxId} HTTP/1.1
Host: api.example.com
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

Create new Resource

post

Body

Pickwagen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung des Wagens

descriptionstringOptional

Beschreibung des Wagens

identifierstringOptional

Barcode zur Selektion des Wagens

typestring · enumOptional

Pickwagen Typen

Possible values:

statestring · enumRead-onlyOptional

Status vom Pickwagen

Possible values:

currentPicklistIdinteger · int64Read-onlyOptional

Wagen gehört aktuell zu dieser Pickliste

Responses

200

successful operation

application/json

Pickwagen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung des Wagens

descriptionstringOptional

Beschreibung des Wagens

identifierstringOptional

Barcode zur Selektion des Wagens

typestring · enumOptional

Pickwagen Typen

Possible values:

statestring · enumRead-onlyOptional

Status vom Pickwagen

Possible values:

currentPicklistIdinteger · int64Read-onlyOptional

Wagen gehört aktuell zu dieser Pickliste

422

Resource was not valid to process

application/json

post/wms/picktrolleys

POST /wms/picktrolleys HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 346

{
  "version": "text",
  "info": {},
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "type": "FREE_COLLECTION",
  "processedByUserRef": {
    "id": "text"
  },
  "pickTrolleyGroupRef": {
    "id": "text"
  },
  "storageBinRef": {
    "id": 1,
    "displayName": "text",
    "routePosition": 1,
    "color": "text",
    "storageRef": {
      "id": "text"
    }
  },
  "pickTrolleyBoxes": [],
  "picklistTemplateRefs": []
}

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "type": "FREE_COLLECTION",
  "state": "NOT_ACTIVE",
  "processedByUserRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "currentPicklistId": 1,
  "pickTrolleyGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "storageBinRef": {
    "id": 1,
    "displayName": "text",
    "routePosition": 1,
    "color": "text",
    "storageRef": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    }
  },
  "pickTrolleyBoxes": [],
  "picklistTemplateRefs": []
}

post

Path parameters

idinteger · int64Required

ID des Pickwagen

Body

Infos zur Generierung von Pickboxen

pickTrolleyIdinteger · int64Optional

ID des Pickwagens

labelPrefixstringOptional

Präfix des Labels der generierten Boxen

labelPostfixStartinteger · int32Optional

Startwert des Postfix vom Label

Default: 1

desiredCountinteger · int32Optional

Gewünschte Anzahl

Responses

200

OK

application/json

Pickbox

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung der Box

descriptionstringOptional

Beschreibung der Box

identifierstringOptional

Barcode zur Selektion der Box

statestring · enumRead-onlyOptional

Status der Pickbox

Possible values:

currentDocumentIdinteger · int64Optional

Aktuell kommissionierter Beleg

pickTrolleyIdinteger · int64Required

Box gehört zu diesem Pickwagen

post/wms/picktrolleys/{id}/generate-boxes

POST /wms/picktrolleys/{id}/generate-boxes HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 79

{
  "pickTrolleyId": 1,
  "labelPrefix": "text",
  "labelPostfixStart": 1,
  "desiredCount": 1
}

200

OK

[]

post

Path parameters

idinteger · int64Required

ID des Pickwagen

Body

Pickbox

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung der Box

descriptionstringOptional

Beschreibung der Box

identifierstringOptional

Barcode zur Selektion der Box

statestring · enumRead-onlyOptional

Status der Pickbox

Possible values:

currentDocumentIdinteger · int64Optional

Aktuell kommissionierter Beleg

pickTrolleyIdinteger · int64Required

Box gehört zu diesem Pickwagen

Responses

200

OK

application/json

Pickbox

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung der Box

descriptionstringOptional

Beschreibung der Box

identifierstringOptional

Barcode zur Selektion der Box

statestring · enumRead-onlyOptional

Status der Pickbox

Possible values:

currentDocumentIdinteger · int64Optional

Aktuell kommissionierter Beleg

pickTrolleyIdinteger · int64Required

Box gehört zu diesem Pickwagen

post/wms/picktrolleys/{id}/boxes

POST /wms/picktrolleys/{id}/boxes HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "version": "text",
  "info": {},
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "currentDocumentId": 1,
  "pickTrolleyId": 1
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "state": "NOT_ACTIVE",
  "currentDocumentId": 1,
  "pickTrolleyId": 1
}

get

Path parameters

identifierstringRequired

Identifier des Pickwagen

Responses

200

OK

application/json

Pickwagen

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung des Wagens

descriptionstringOptional

Beschreibung des Wagens

identifierstringOptional

Barcode zur Selektion des Wagens

typestring · enumOptional

Pickwagen Typen

Possible values:

statestring · enumRead-onlyOptional

Status vom Pickwagen

Possible values:

currentPicklistIdinteger · int64Read-onlyOptional

Wagen gehört aktuell zu dieser Pickliste

get/wms/picktrolleys/byIdentifier/{identifier}

GET /wms/picktrolleys/byIdentifier/{identifier} HTTP/1.1
Host: api.example.com
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "type": "FREE_COLLECTION",
  "state": "NOT_ACTIVE",
  "processedByUserRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "currentPicklistId": 1,
  "pickTrolleyGroupRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "storageBinRef": {
    "id": 1,
    "displayName": "text",
    "routePosition": 1,
    "color": "text",
    "storageRef": {
      "id": "text",
      "label": "text",
      "description": "text",
      "active": true
    }
  },
  "pickTrolleyBoxes": [],
  "picklistTemplateRefs": []
}

get

Path parameters

identifierstringRequired

Identifier der Pickbox

Responses

200

OK

application/json

Pickbox

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

labelstring · min: 1Required

Bezeichnung der Box

descriptionstringOptional

Beschreibung der Box

identifierstringOptional

Barcode zur Selektion der Box

statestring · enumRead-onlyOptional

Status der Pickbox

Possible values:

currentDocumentIdinteger · int64Optional

Aktuell kommissionierter Beleg

pickTrolleyIdinteger · int64Required

Box gehört zu diesem Pickwagen

get/wms/picktrolleys/boxByIdentifier/{identifier}

GET /wms/picktrolleys/boxByIdentifier/{identifier} HTTP/1.1
Host: api.example.com
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "label": "text",
  "description": "text",
  "identifier": "text",
  "state": "NOT_ACTIVE",
  "currentDocumentId": 1,
  "pickTrolleyId": 1
}