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