Item Group Classification

Overview:

The Item Group Classification API allows you to create, retrieve, update, and delete item group class records. This documentation provides detailed information about the endpoints, request and response formats, and field descriptions.

Create:

Endpoint: /api/message/ln_itmgrp_class_code/{ Company }

This API will create a new Item group class.

• Method: POST
• Content-Type: application/json
• Authentication: Bearer <token>

Request Body:

{
    "data_set": "<Data-Set>",                //string
    "cls_code": "<Item-Group>",              //string
    "dsca": "<Description>",                 //string
    "delf": true                             //boolean
}

Fields Details:

Field Name	Description	Data Type	Length
data_set	Data set	String	10
cls_code	ItemGroup	String	6
dsca	Description	String	120
delf	Delete Flag	Boolean	1

---

Response Body: (Status: 200)

{
    "data_set": "<Data-Set>", 
    "cls_code": "<Item-Group>",
    "delf": true,
    "dsca": "<Description>"
}

Fields Details:

Field Name	Description	Data Type	Example
data_set	Data Set	String	"dataset1"
cls_code	ItemGroup Code	String	"XCD345"
delf	Delete Flag	Boolean	true
dsca	Description	String	"Item group class"

---

Response Body: (Status: 401 - Unauthorized / Invalid Token)

When there is no token / invalid token passed or When Normal user tries to create a new record:

{
    "message": "Unauthorized!"
}

Response Body: (Status: 400 - Bad Request/ Duplicate )

When the record is already present in the database:

{
    "message": "Record already exists!"
}

Response Body: (Status: 400 - Bad Request/ Invalid Datatype )

When passing a record with invalid datatype:

{
    "message": "Unable to Update to Item Classification "
}

Response Body: (Status: 500 - Internal Server Error/ Empty Field )

When passing an empty field as input to Item group:

{
    "message": "Validation Errors|Validation 'isNotEmpty' failed for field 'cls_code'"
}

when passing an empty field as input to dataset:

 {
    "message": "Validation Errors|Validation 'isNotEmpty' failed for field 'data_set'"
}

Update:

Endpoint: /api/message/ln_itmgrp_class_code/{ Company }

This API will update the specified Item group .

• Method: PUT
• Content-Type: application/json
• Authentication: Bearer <token>

Request Body:

{
    "data_set": "<Data-Set>",     //string
    "cls_code": "<Item-Group>",   //string
    "dsca": "<Description>",      //string
    "delf": true                  //boolean
}

Response Body: (Status: 200)

{
    "data_set": "<Data-Set>",               
    "cls_code": "<Item-Group>",
    "delf": true,
    "dsca": "<Description>",
}

Response Body: (Status: 401 - Unauthorized / Invalid Token)

When there is no token or invalid token passed or When Normal user tries to update a existing record:

{
    "message": "Unauthorized!"
}

Response Body: (Status: 400 - Bad Request/ Not Found)

When the specified record is not found:

{
    "message": "Record not found!"
}

Response Body: (Status: 400 - Bad Request/ Invalid Datatype )

When passing a record with invalid datatype:

{
    "message": "Unable to Update to Item Classification "
}

Response Body: (Status: 500 - Internal Server Error/ Empty Field )

When passing an empty field as input to Item group:

{
    "message": "Validation Errors|Validation 'isNotEmpty' failed for field 'cls_code'"
}

when passing an empty field as input to dataset:

 {
    "message": "Validation Errors|Validation 'isNotEmpty' failed for field 'data_set'"
}

Delete:

Endpoint: /api/message/ln_itmgrp_class_code/{ Company }/{ record_id }

This API will delete the specified record id.

• Method: DELETE
• Authentication: Bearer <token>

Response Body: (Status: 200)

{
    "Message": "Message Deleted Sucessfully!"
}

Response Body: (Status: 401 - Unauthorized / Invalid Token)

When there is no token / invalid token passed or When Normal user tries to delete the existing record:

{
    "message": "Unauthorized!"
}

Response Body: (Status: 500 - Internal Server Error / Invalid Record)

When there is no record or invalid record passed:

{
    "Message": "Unable to Delete Record - Invalid Data Type"
}

Get:

Endpoint: /api/message/ln_itmgrp_class_code/{ Company }/{ record_id }

This API retrieves the specified record id.

• Method: GET
• Authentication: Bearer <token>

Response Body: (Status: 200)

{
    "data_set": "<data-set>", 
    "cls_code": "<Item-Group>",
    "delf": true,
    "dsca": "<Description>"
}

Response Body: (Status: 200 - success status/invalid id)

When there is no such id or invalid id is passed :

{
    "message": "null"
}

Response Body: (Status: 401 - Unauthorized / Invalid Token)

When there is no token or invalid token passed :

{
    "message": "Unauthorized!"
}

Get All:

Endpoint: /api/messages/ln_itmgrp_class_code/{ Company }/{ PageSize }/{ PageNumber }

This API retrieves all records.

• Method: GET
• Authentication: Bearer <token>

Response Body: (Status: 200)

[
    {
        "data_set": "<data-set>", 
        "cls_code": "<Item-Group>",
        "delf": true,
        "dsca": "<Description>"
    }
]

Response Body: (Status: 401 - Unauthorized / Invalid Token)

When there is no token or invalid token passed :

{
    "message": "Unauthorized!"
}