Skip to main content

Warehouse Service

A Warehouse is a commercial space vital in the supply chain that is used to store finished goods and raw materials and is widely used in industries such as manufacturing and distribution.

Each warehouse keeps records that show stock movements, losses and balances at the warehouse.

Warehouse Object​

Attributes​


AttributeTypeDescription
activebooleanHas the value true if the warehouse is active or false if the warehouse is not active.
assignUserIdslistList of user ids assigned to the warehouse.
codestringWarehouse specific unique code.
idlongUnique identifier for the Warehouse.
locationLocationDtoLocation details.
namestringWarehouse Name.
primarybooleanHas the value true if the warehouse is primary or false if the warehouse is not primary.
warehouseBinInfoslistList of bin details for the warehouse. Attribute for WarehouseBinInfo
warehouseRackInfoslistList of rack details for the warehouse. Attribute for WarehouseRackInfo
warehouseRowInfoslistList of row details for the warehouse. Attribute for WarehouseRowInfo
warehouseTypeenumType of the warehouse. Possible values for warehouseType

API​


List All Warehouse​

Returns list of warehouse.

Parameters​

Code​

  @Autowired
private InventoryClient inventoryClient;

public List<WarehouseResponse> getWarehouseList(String accessToken){
return this.inventoryClient.getWarehouseList(accessToken);
}

Retrive Warehouse details by code​

Retrieves the details of an existing warehouse. You need only supply the code that was returned upon warehouse creation.

Parameters​

Code​

  @Autowired
private InventoryClient inventoryClient;

public WarehouseResponse getWarehouseDetailsByCode(final String accessToken, final String code){
return this.inventoryClient.getWarehouseDetailsByCode(accessToken, code);
}

Search Warehouses​

Returns a paginated list of warehouses matching the given filter criteria.

Parameters​

  • accessToken string
  • search string
  • query string
  • sort string
  • sortDir string
  • page int
  • limit int
  • filterOnRolesFlg boolean
  • allRRBDetails boolean

Code​

  @Autowired
private InventoryClient inventoryClient;

public Page<WarehouseResponse> searchWarehouses(String accessToken, String search, String query,
String sort, String sortDir, Integer page, Integer limit, Boolean filterOnRolesFlg,
Boolean allRRBDetails){
return this.inventoryClient.searchWarehouses(accessToken, search, query, sort, sortDir, page,
limit, filterOnRolesFlg, allRRBDetails);
}

Create Warehouse​

Creates a new warehouse.

Parameters​

Code​

  @Autowired
private InventoryClient inventoryClient;

public WarehouseResponse createWarehouse(WareHouseRequest wareHouseRequest, String accessToken){
return this.inventoryClient.createWarehouse(wareHouseRequest, accessToken);
}

Update Warehouse​

Updates an existing warehouse. You only need to supply the unique identifier that was returned upon warehouse creation.

Parameters​

Code​

  @Autowired
private InventoryClient inventoryClient;

public WarehouseResponse updateWarehouse(Long id, WareHouseRequest wareHouseRequest, String accessToken){
return this.inventoryClient.updateWarehouse(id, wareHouseRequest, accessToken);
}

Update Warehouse Attributes​

Updates the active/primary attributes of an existing warehouse.

Parameters​

Code​

  @Autowired
private InventoryClient inventoryClient;

public void updateWarehouseAttributes(Long id, Boolean active, Boolean primary, String accessToken){
this.inventoryClient.updateWarehouseAttributes(id, active, primary, accessToken);
}

Delete Warehouse​

Deletes an existing warehouse. You only need to supply the unique identifier that was returned upon warehouse creation.

Parameters​

Code​

  @Autowired
private InventoryClient inventoryClient;

public void deleteWarehouse(Long id, String accessToken){
this.inventoryClient.deleteWarehouse(id, accessToken);
}

Retrive Warehouse Products​

Retrieves the warehouse details with available quantity for the given product codes.

Parameters​

  • accessToken string
  • productCodes set
  • includeRejectedWarehouse boolean
  • includeAvailableQtyWarehouse boolean
  • includeJwoWarehouse boolean

Code​

  @Autowired
private InventoryClient inventoryClient;

public WHProductResponse getWarehouseProducts(final String accessToken, final Set<String> productCodes,
final Boolean includeRejectedWarehouse, final Boolean includeAvailableQtyWarehouse,
final Boolean includeJwoWarehouse){
return this.inventoryClient.getWarehouseProducts(accessToken, productCodes,
includeRejectedWarehouse, includeAvailableQtyWarehouse, includeJwoWarehouse);
}

Retrive Active Warehouse Products​

Retrieves the details of active warehouses with product and available quantity.

Parameters​

  • accessToken string
  • search string
  • warehouseCode string
  • filterOnRolesFlg boolean
  • includeRejectedWarehouse boolean
  • page int
  • limit int

Code​

  @Autowired
private InventoryClient inventoryClient;

public WHProductResponse getActiveWarehouseProducts(final String accessToken, final String search,
final String warehouseCode, final Boolean filterOnRolesFlg, final Boolean includeRejectedWarehouse,
final Integer page, final Integer limit){
return this.inventoryClient.getActiveWarehouseProducts(accessToken, search, warehouseCode,
filterOnRolesFlg, includeRejectedWarehouse, page, limit);
}

Get Warehouses Short Info​

Returns a short-form list of all warehouses.

Parameters​

Code​

  @Autowired
private InventoryClient inventoryClient;

public List<WarehouseResponse> getWarehousesShortInfo(final String accessToken, final Boolean filterOnRolesFlg){
return this.inventoryClient.getWarehousesShortInfo(accessToken, filterOnRolesFlg);
}

Get Primary Warehouse Code​

Returns the code of the tenant's primary warehouse.

Parameters​

Code​

  @Autowired
private InventoryClient inventoryClient;

public String getPrimaryWarehouseCode(final String accessToken){
return this.inventoryClient.getPrimaryWarehouseCode(accessToken);
}

Get Rejected Warehouse​

Returns the details of the tenant's rejected-goods warehouse.

Parameters​

Code​

  @Autowired
private InventoryClient inventoryClient;

public WarehouseResponse getRejectedWarehouse(final String accessToken){
return this.inventoryClient.getRejectedWarehouse(accessToken);
}

Objects​


WarehouseResponse​

WarehouseResponse includes all attributes of Warehouse, plus the following response-only attributes.

AttributeTypeDescription
isDeleteEnablebooleanHas the value true if the warehouse can be deleted or false otherwise.

LocationDto​

AttributeTypeDescription
addresslistList of Address. Attribute for Address
idlongUnique identifier for the Location.
namestringName of location

Address​

AttributeTypeDescription
address1stringAddress line 1
address2stringAddress line 2
citystringCity
contactNamestringName of the contact associated with the address
countrystringCountry
countryCodestringCountry code of the address
customFieldslistList of key-value pairs for custom field name and its value
destinationOfSupplystringDestination of supply for tax purposes
emailIdstringEmail address
mobileCountryCodestringCountry code for the mobile number
mobileNumberstringMobile number
placeOfSupplystringPlace of supply for tax purposes
postalCodestringPostal Code
preferredbooleanIs this a default address?
statestringState
stateCodestringState code of the address

WHProductResponse​

AttributeTypeDescription
totalWarehouseCountintTotal number of warehouses matching the request.
warehouseShortInfoListlistList of warehouse and product details. Attribute for WarehouseShortInfo

WarehouseShortInfo​

AttributeTypeDescription
activebooleanHas the value true if the warehouse is active or false if the warehouse is not active.
advancedTrackingMetalistList of advanced tracking (batch/serial) details for the requested products.
assignUserIdslistList of user ids assigned to the warehouse.
codestringWarehouse specific unique code.
existingBatchCustomFieldsMapMap of batch/serial number to its list of custom field values.
idlongUnique identifier for the Warehouse.
locationLocationDtoLocation details.
namestringWarehouse Name.
primarybooleanHas the value true if the warehouse is primary or false if the warehouse is not primary.
productAdvancedTrackingMetaMapMap of product code to its list of advanced tracking (batch/serial) details.
productAvailableQuantityMapProduct Code and Available quantity Map.
productReservedQuantityMapProduct Code and Reserved quantity Map.
rowRackBinProductAvailableQuantityDtoslistList of row/rack/bin level available quantity details. Attribute for RowRackBinProductAvailableQuantityDto
warehouseBinInfoslistList of bin details for the warehouse. Attribute for WarehouseBinInfoResponse
warehouseRackInfoslistList of rack details for the warehouse. Attribute for WarehouseRackInfoResponse
warehouseRowInfoslistList of row details for the warehouse. Attribute for WarehouseRowInfoResponse
warehouseTypeenumType of the warehouse. Possible values for warehouseType

WarehouseRowInfo​

AttributeTypeDescription
codestringRow code.
namestringRow name.

WarehouseRackInfo​

AttributeTypeDescription
codestringRack code.
namestringRack name.
rowCodestringCode of the row the rack belongs to.

WarehouseBinInfo​

AttributeTypeDescription
codestringBin code.
namestringBin name.
rackCodestringCode of the rack the bin belongs to.
rowCodestringCode of the row the bin belongs to.
taggedQuantitynumberQuantity tagged to this bin.

WarehouseRowInfoResponse​

AttributeTypeDescription
codestringRow code.
namestringRow name.

WarehouseRackInfoResponse​

AttributeTypeDescription
codestringRack code.
namestringRack name.
rowCodestringCode of the row the rack belongs to.

WarehouseBinInfoResponse​

AttributeTypeDescription
codestringBin code.
namestringBin name.
rackCodestringCode of the rack the bin belongs to.
rowCodestringCode of the row the bin belongs to.

RowRackBinProductAvailableQuantityDto​

AttributeTypeDescription
availableQuantitynumberAvailable quantity at this row/rack/bin.
binCodestringBin code.
binNamestringBin name.
productCodestringProduct code.
rackCodestringRack code.
rackNamestringRack name.
reservedQuantitynumberReserved quantity at this row/rack/bin.
rowCodestringRow code.
rowNamestringRow name.

Enums​


WAREHOUSE_TYPE​

  • PRIMARY
  • REJECTED
  • TOLERANCE_REJECTED
  • JOB_WORK_OUT
  • QA
  • NONE