Tracking Level

Tracking level gives multiple ways of storing a SKU. For e.g. 1 BOX = 10 EACHES, 1 PALLET = 100 BOXES thereby ability to store and measure inventory at granular levels

Fetch Tracking Level

GET /wms/sku/tracking-level

This api returns all or a set of Tracking Levels configured depending on the filter criteria passed or not. Note when more than one below parameters are sent the result will be filtered matching all the parameters and not any one. so filter should be applied accordingly or else result would be empty if all conditions are not met.

Query Parameters

Name	Type	Description
name	String	Partial or full text matching the name of the Tracking Level like 'Combo' 'Each' etc.
id	String	Blowhorn assigned/supplied integer unique id for the Tracking Level like 12345

Headers

Name	Type	Description
API_KEY*	String	API key obtained by the Customer/Partner

200: OK Response for no search criteria or matching criteria

{
    "count": 3,
    "previous": null,
    "next": 0,
    "result": [
        {
            "id": 58,
            "created_date": "2022-04-29T11:35:54.681038+05:30",
            "modified_date": "2022-04-29T12:19:11.669348+05:30",
            "name": "Combo",
            "level_one_name": "Combo of 2",
            "level_two_name": "Combo of 4",
            "level_three_name": "Combo of 6",
            "ratio_level_two_one": 200,
            "ratio_level_three_two": 150,
            "created_by": 108434,
            "modified_by": null,
            "customer": 40082
        },
        {
            "id": 5,
            "created_date": "2021-07-30T17:52:25.615928+05:30",
            "modified_date": "2021-07-30T17:52:25.616689+05:30",
            "name": "Single",
            "level_one_name": "Single",
            "level_two_name": "Box of 30",
            "level_three_name": "Pallet for 30",
            "ratio_level_two_one": 30,
            "ratio_level_three_two": 1,
            "created_by": 108434,
            "modified_by": 108434,
            "customer": 40082
        },
        {
            "id": 4,
            "created_date": "2021-07-30T17:51:58.203915+05:30",
            "modified_date": "2021-07-30T17:51:58.204736+05:30",
            "name": "Each",
            "level_one_name": "Each",
            "level_two_name": "Box of 25",
            "level_three_name": "Pallet for 25",
            "ratio_level_two_one": 25,
            "ratio_level_three_two": 1,
            "created_by": 108434,
            "modified_by": 108434,
            "customer": 40082
        }
    ]
}

401: Unauthorized Unauthorized/Validation Error

{
  "status": "FAIL",
  "message": "Unauthorized"
}

200: OK No Product Group found for the search criteria

{
    "count": 0,
    "previous": null,
    "next": 0,
    "result": []
}

500: Internal Server Error Unexpected Error

{
  "status": "FAIL",
  "message": "Unexpected error"
}

Create Tracking Level

POST /wms/sku/tracking-level

This API is for creating new Tracking Levels.

Headers

Name	Type	Description
API_KEY*	String	API key obtained by the Customer/Partner

Request Body

Name	Type	Description
name*	String	Unique text identifier of the Tracking Levels for the client
level_one_name*	String	First level of tracking
id	String	An identifier will be randomly generated by Blowhorn. You can optionally override this ID, but the ID must be unique across all Tracking Levels in your account.
level_two_name	String	Second level of tracking
level_three_name	String	Third level of tracking
ratio_level_two_one	String	Ratio between two tracking levels
ratio_level_three_two	String	Ratio between last two tracking levels

200: OK Successful creation of Tracking Level

{
    "status": "PASS",
    "message": {
        "id": 297
    }
}

400: Bad Request Bad Request/Validation Error

{
    "status": "FAIL",
    "message": "Tracking Level already exists"
}

401: Unauthorized Unauthorized/Wrong API key

{
  "status": "FAIL",
  "message": "Unauthorized"
}

500: Internal Server Error Unexpected Error

{
  "status": "FAIL",
  "message": "Unexpected error"
}

400: Bad Request Missing required parameters

{
    "status": "FAIL",
    "message": "Missing required parameters."
}

Update Tracking Level

PUT /wms/sku/tracking-level

This API is for updating an existing Tracking Level. Any or all of the below mentioned attribute of the Tracking Level can be updated using this API.

Headers

Name	Type	Description
API_KEY	String	API key obtained by the Customer/Partner

Request Body

Name	Type	Description
id	String	Unique identifier either generated by Blowhorn or provided at the time of Tracking Level creation. Note: This is conditionally optional. Either id or name should be provided for identifying the Tracking Level that needs to be updated.
name	String	Unique text identifier of the Tracking Level for the client. Note: This is conditionally optional. Either id or name should be provided for identifying the Tracking Level that needs to be updated.
level_one_name	String	First level of tracking
level_two_name	String	Second level of tracking
level_three_name	String	Third level of tracking
ratio_level_two_one	String	Ratio between first two levels
ratio_level_three_two	String	Ratio between last two levels

200: OK Successful updation of Product Group

{
    "status": "PASS",
    "message": "Tracking Level Updated successfully."
}

400: Bad Request Bad Request/Validation Error

{
    "status": "FAIL",
    "message": "Tracking Level does not exists"
}

401: Unauthorized Unauthorized/Wrong API key

{
  "status": "FAIL",
  "message": "Unauthorized"
}

500: Internal Server Error Unexpected error

{
  "status": "FAIL",
  "message": "Unexpected error"
}

400: Bad Request Missing required parameters

{
    "status": "FAIL",
    "message": "Missing required parameters."
}

Sample Create Tracking Level | Schema

{
    "name": "Combo",
    "level_one_name": "Combo of 2",
    "level_two_name": "Combo of 4",
    "level_three_name": "Combo of 6",
    "ratio_level_two_one": 200,
    "ratio_level_three_two": 150
}