Ongoing WMS logo

Ongoing WMS Developer

Reported number of items

Table of contents

Introduction

Most people who integrate with Ongoing WMS using our API will generally want some way of querying Ongoing WMS for:

Ongoing WMS provides a way for the integrating system to store information about which objects have already been processed by the integrating system. We call this reporting back and it is done with an additional API call.

By reporting back, you will be able to very easily query Ongoing WMS for e.g. "all orders which have been picked since my last API call". This way of querying is very robust since it does not depend on a time variable.

Example

We will now provide an example of how this works, using orders.

Each order line in Ongoing WMS has a field called ReportedNumberOfItems. This is the quantity which the integrating system has reported back that it has confirmed as picked.

The integrating system can use UpdateOrderLines to set the ReportedNumberOfItems.

The integrating system can use GetOrdersByQuery and specify OnlyOrdersWithOrderLinesToReport = true to query for all orders where the picked number of items differs from the reported number of items.

An example for partial delivery with reported number of items being used:

Other objects

The same basic logic which is described in the example can be applied to other objects.

Order - picked items

For reporting back the picked number of items on an order, use UpdateOrderLines to set the ReportedNumberOfItems. Use GetOrdersByQuery and specify OnlyOrdersWithOrderLinesToReport = true to query.

Order - returned items

For reporting back the return number of items on an order, use UpdateOrderLines to set the ReportedReturnedNumberOfItems. Use GetOrdersByQuery and specify OnlyOrdersWithOrderLinesToReportReturned = true to query.

Inorder - received items

For reporting back the received number of items on an inorder, use UpdateInOrderLines to set the ReportedNumberOfItems. Use GetInOrdersByQuery and specify OnlyWithInOrderLinesWithDiffingReceviedToReported = true to query.

Production order - produced items

For reporting back the produced number of items on a production order, use UpdateProductionOrderLines to set the UpdateReportedNumberOfItems. Use GetProductionOrdersByQuery and specify OnlyProductionOrdersWithLinesToReport = true to query.

Stock comparisons

When you call GetInventory, GetInventoryByQuery and GetInventoryPerWarehouse, the response contains the field PickedToBeReportedNumberOfItems. This is the number of items which have been picked but have not been reported back yet by the integrating system.

If you use this value as part of a daily stock comparison between your system and Ongoing WMS, then it's important to note that all orders have to be reported back, even if the orders did not originate from the integrating system.