Weighed or measured products

Creating and using measurment units in picking

With every order it is possible to provide information about items which must be weighed or measured during the picking process (for example fruits, liquids or fabric). It is possible to configure individual measurement units for each tenant, such as grams, kilograms, liters, milliliters etc. via the API.

Create measurementUnit

POSThttps://%%HOST%%//api/measurementunits

Authorization

firebase

Body

application/json

abbreviationLocalized*all of

Abbreviation of the unit. Maximum 4 chars long.

key*string

Descriptor for the measurement unit

Example: "kilogramm"

nameLocalized*LocaleString (object)

requiresMeasurementboolean

Indicates that the given unit need to be measured.

Example: true

Response

201401403404

Successfully created the measurementUnit.

Body

application/json

abbreviationLocalized*all of

Abbreviation of the unit. Maximum 4 chars long.

key*string

Descriptor for the measurement unit

Example: "kilogramm"

nameLocalized*LocaleString (object)

requiresMeasurementboolean

Indicates that the given unit need to be measured.

Example: true

createdstring (date-time)

The date this entity was created at the platform. This value is generated by the service.

Example: "2020-02-03T08:45:51.525Z"

lastModifiedstring (date-time)

The date this entity was modified last. This value is generated by the service.

Example: "2020-02-03T09:45:51.525Z"

version*integer (int64)

The version of the document to be used in optimistic locking mechanisms.

Example: 42

Request

JavaScriptCurlPython

const response = await fetch('https://%%HOST%%//api/measurementunits', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "nameLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "abbreviationLocalized": {
        "de_DE": "kg",
        "en_US": "kg",
        "ru_RU": "кг"
      },
      "key": "kilogramm"
    }),
});
const data = await response.json();

Response

201

{
  "abbreviation": "kg",
  "id": "c5300790-9477-475c-bd6d-98e5d61f6413",
  "name": "kilogramm"
}

The configured measurement units can be used to mark items of an order as “must be measured”. There is no check of completion for measuring items, which means that no short-pick will be triggered when the picked measurement is lower than the ordered measurement.

Optionally, it is possible to specify tolerance limits that must not be exceeded or undershot when picking these items. If a soft tolerance is defined, the picker just sees a hint, when entering more or less than configured. If a hard tolerance limit is configured it is not possible to enter more or less (except of 0) than configured.

Secondary measurement units

In addition to a quantity of a line item, an order can also contain a second quantity and unit of this item, which leads the picker to enter a second quantity. This only works, if one of the two units were created as measurement units.

If you are interested in using this feature please get in touch with us.

FAQs

How to pick weighted goods with one measurement unit?

There are different cases for a consumer to order weighted goods. This How To show´s the example of the case, when a consumer orders weighted goods in form of weight (1500g pears)

Start the pickjob as usual (Pick)

When you need to pick an weighted item, first weight the item and then enter the weighted amount into the app

Press "OK" when you are done

How to pick weighted goods with two measurement units?

This How To shows the example of the case, when a consumer orders weighted goods, that are ordered in pieces, but need to be weighted as well to define the price. (2 Watermelons)

Start the pickjob as usual (Pick)

Collect the amount of the item that are ordered. Afterwards enter the weighted amount and click on OK

Example for configured tolerances - hard tolerance

This How To shows the example of the case, when a consumer orders weighted goods in form of weight (1500g pears) with hard tolerance configured. In this case a hard tolerance for overweight is set with 20%.

Start the pickjob as usual (Pick)

Collect as much of the ordered item as is shown in the order. When you are about to enter the amount of weight, you can already see the max. tolerance rate (1200g in this case)

When you enter a weight over the max. tolerance rate. You will not be able to pick that amount of weight. The amount is shown in red and the “Save” button is greyed out and not able to be pushed.

Take less amount and try to stay in the tolerance range

Click on “Save” and continue with the picking process

Example for configured tolerances - soft tolerance

This How To shows the example of the case, when a consumer orders weighted goods in form of weight (1500g pears) with soft tolerance configured. In this case a hard tolerance for underweight is set with 20%

Start the pickjob as usual (Pick)

Collect as much of the ordered item as is shown in the order. In this example we could just pick 700g instead of 1000g because we were out of stock. Enter the 700g that have been picked

In case of a soft tolerance you will get a notification about the missing amounts, that you need to confirm.

When you are finished with picking, you have to confirm again, that the missing amounts, are correct. Click on “Yes, complete picking” to finish the process