Sales Office

Overview

The Sales Office API enables the creation, retrieval, updating, and deletion of sales office records. This documentation provides detailed information on the endpoints, request and response formats, and field descriptions.

Create

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

This API will creat new Sales Office.

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

Request Body:

{
    "data_set": "<Data_set>",               //string
    "sls_off": "<Sales-Office>",            //string
    "dsca": "<Sales-office-description>",   //string
}

Fields Details:

Field Name	Description	Data Type	Length
data_set	Data Set	String	10
sls_off	Sales Office	String	6
dsca	Sales Office Description	String	120

---

Response Body: (Status: 200)

{
    "data_set": "<Data_set>",             
    "dsca": "<Sales-office-description>",
    "sls_off": "<Sales-Office>",            
}

Fields Details:

Field	Description	Data Type	Example
data_set	Data Set	String	"Dataset1"
dsca	Sales Office Description	String	"Sales In"
sls_off	Sales Office	String	"SIS"

---

Response Body: (Status: 401 - Unauthorized)

When there is no token or invalid token passed:

{
    "message": "Unauthorized!"
}

Response Body: (Status: 400 - Bad Request)

When both the Data set and Sales office is already present in the database:

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

Response Body: (Status: 400 - Bad Request)

When invalid or wrong Data set is passed:

{
    "message": "Reference Error"
}

Response Body: (Status: 400 - Bad Request)

When there is an invalid data type is passed:

{
    "message": "Invalid Data Type"
}

Response Body: (Status: 500 - Internal Server Error)

When the mandatory fields are passed as an empty field:

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

Update

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

This API will update a Sales Office.

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

Request Body:

{
    "data_set": "<Data_set>",               //string
    "sls_off": "<Sales-Office>",            //string
    "dsca": "<Sales-office-description>",   //string
}

Response Body: (Status: 200)

{
    "data_set": "<Data_set>",             
    "dsca": "<Sales-office-description>",
    "sls_off": "<Sales-Office>", 
}

Response Body: (Status: 401 - Unauthorized)

When there is no token or invalid token passed:

{
    "message": "Unauthorized!"
}

Response Body: (Status: 400 - Bad Request)

When there is an invalid data type is passed:

{
    "message": "Invalid Data Type"
}

Response Body: (Status: 400 - Bad Request)

When you are trying to update the both the Data set and Sales office:

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

Response Body: (Status: 500 - Internal Server Error)

When the mandatory fields are passed as an empty field:

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

Delete

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

This API will delete a Sales Office.

• Method: DELETE
• Authentication: Bearer <token>

Response Body: (Status: 200)

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

Response Body: (Status: 401 - Unauthorized)

When there is no token or invalid token passed:

{
    "message": "Unauthorized!"
}

Response Body: (Status: 500 - Internal Server Error)

When invalid or wrong Sales Office id is paased:

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

Get

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

This API will get a Sales Office.

• Method: GET
• Authentication: Bearer <token>

Response Body: (Status: 200)

{
    "data_set": "<Data_set>",             
    "dsca": "<Sales-office-description>",
    "sls_off": "<Sales-Office>", 
}

Response Body: (Status: 200)

When invalid or wrong Sales Office id is paased:

{
    "message": "null"
}

Response Body: (Status: 401 - Unauthorized)

When there is no token or invalid token passed:

{
    "message": "Unauthorized!"
}

Get All

Endpoint: /api/messages/sls-off/{ Company }/{ PageSize }/{ PageNumber }

This API will get all Sales Offices.

• Method: GET
• Authentication: Bearer <token>

Response Body: (Status: 200)

[
  {
    "data_set": "<Data_set>",             
    "dsca": "<Sales-office-description>",
    "sls_off": "<Sales-Office>", 
  },
  .
  .
  .
]

Response Body: (Status: 401 - Unauthorized)

When there is no token or invalid token passed:

{
    "message": "Unauthorized!"
}