Retrieve the cumulative quantities in bins.
| Parameter name | Description | Possible value | Required |
|---|---|---|---|
| binIDs | Multiple bin IDs, separated by commas, such as: "1,2,3,4,5". | string | |
| productIDs | Multiple product IDs, separated by commas, such as: "1,2,3,4,5". | string | |
| warehouseID | Warehouse ID. | integer | |
| preferred | Get quantities from preferred / not preferred bins only. 0 or 1. | integer | |
| minimumAmount | Retrieve only those bins where current quantity is larger or equal to the specified value. | Decimal | |
| changedSince | Integer (Unix timestamp) |
| Field name | Type | Description |
|---|---|---|
| binID | integer | Bin ID. |
| binCode | String(255) | Bin code. |
| binPreferred | Integer (0 or 1) | Indicates if this bin is preferred. |
| warehouseID | integer | Warehouse ID. |
| productID | integer | Product ID. |
| productCode | string | First code of the product (by convention, this is used for company's internal code). |
| productCode2 | string | Second code of the product (by convention, this is used for EAN/UPC barcode). |
| productCode3 | string | Third code of the product. |
| productSupplierCode | string | Supplier's product code. |
| productCode5 | string | Code 5 of the product. "Extra product codes" module must be enabled. |
| productCode6 | string | Code 6 of the product. "Extra product codes" module must be enabled. |
| productCode7 | string | Code 7 of the product. "Extra product codes" module must be enabled. |
| productCode8 | string | Code 8 of the product. "Extra product codes" module must be enabled. |
| amount | Decimal (6 places) |
This call is part of the "Quantities in Bins" API. It allows you to keep more precise track of inventory quantities — at aisle, shelf and bin level, not just at warehouse level.
To successfully make use of this API, you need to build an end-to-end integration yourself: make API calls every time inventory is removed from or added to shelves, or relocated in the warehouse, and build a custom report to display current quantities and their locations.
Standard operations in Erply (like confirming a sales or purchase invoice) that otherwise automatically adjust inventory levels, do not make any changes to the quantities in bins. Instead, API commands should be sent to remove inventory from bins when an employee goes and actually picks up the items for the shipment.
The calls that make up the "Quantities in Bins" API are: