The Customer Master API can create a customer data with a master id, corresponding to workshop id based on region/country.

Overview

Http Method

POST

Authentication

Basic Auth.

Http Status Codes

200 - OK with data in response body

400 - In case your request is malformed or contains insufficient information - Bad Request (Validation error)

401 - Wrong or missing auth header

403 - In case of Invalid User trying to access the information

50x - Internal Server Error
Versioning

The initial API version is v1.0, and is namespaced into endpoint route -
https://bosch-garage-management.com/WSMS_Q_CustomerMasterAPI/api/CustomerMaster/CreateCustomerMaster.
The API version will be increased due to a backwards-incompatible changes.v

Schema

All information is sent and received as JSON data interchange format over HTTPS. Timestamps in API responses will always include timezone (typically UTC). Always provide timezones in API requests (preferably UTC).

Http Path

https://bosch-garage-management.com/WSMS_Q_CustomerMasterAPI/api/CustomerMaster/CreateCustomerMaster

Http Path Parameters

None

Header Parameters

None

Request Parameters

None

Request Fields
FieldName DataType Mandatory Description DataLength Remarks

Customer ID

varchar

Yes

Unique Customer Identifier

20

Primary Key

Customer ID

Nvarchar

Yes

Unique Customer Identifier if other than English language if applicable

20

Primary Key

Workshop ID

Int

Yes

Workshop Identifier

20

Primary Key

First Name

varchar

No

First name of the customer

50

First Name (Local Language)

Nvarchar

No

First name of the customer if other than English language if applicable

50

Last Name

varchar

No

Last name of the customer

50

Last Name

Nvarchar

No

Last name of the customer if other than English language if applicable

50

Creation Date

Date (DDMMYYYY)

No

customer Record creation date

Modified Date

Date (DDMMYYYY)

No

customer Record modified date

Customer Group

varchar

Yes

Category or Type of Customer

50

Customer Group(Local Language)

Nvarchar

No

Category or Type of Customer if other than English language if applicable

50

sCompany

varchar

Yes

fleet customer or not(Yes/No)

3

Company Name

varchar

No

Company Name

50

Company Name

Nvarchar

No

Company Name if other than English language if applicable

50

Status

varchar

No

Active/Inactive

20

Customer Source

varchar

No

Customer Source

20

Request Body
{
    "CustomerId": "c1",
    "WorkshopId": "wwww1556b",
    "CustomerIdLanguage": "CustLang1",
    "FirstName": "Bhargavi",
    "FirstNameLocalLanguage": "TestBharg",
    "LastName": "TestSunchu",
    "LastNameLocalLanguage": "TestLocalSunchu",
    "CreationDate": "12\\\/12\\\/2023",
    "ModifiedDate": "11\/122023",
    "CustomerGroup": "CustGropr1",
    "CustomerGroupLocalLanguage": "CustGropLocalLang1",
    "IsCompany": "YES",
    "CompanyName": "BOSCHWSMSUSer",
    "CompanyNameLocalLanguage": "BOSCHUSER1",
    "Status": "NA",
    "CustomerSource": "Cust12"
    }
Response Headers

None

Responses

201 OK

{
    {
    "message": "One record(s) failed to process.",
    "totalRecords": 2,
    "failedRecords": 1,
    "successRecords": 1,
    "processedFailedRecords": [
    {
    "customerId": "c1",
    "workshopId": "wwww1556b",
    "customerIdLanguage": "CustLang1",
    "firstName": "Bhargavi",
    "firstNameLocalLanguage": "TestBharg",
    "lastName": "TestSunchu",
    "lastNameLocalLanguage": "TestLocalSunchu",
    "creationDate": "0001-01-01T00:00:00",
    "modifiedDate": "0001-01-01T00:00:00",
    "customerGroup": "CustGropr1",
    "customerGroupLocalLanguage": "CustGropLocalLang1",
    "isCompany": "YES",
    "companyName": "BOSCHWSMSUSer",
    "companyNameLocalLanguage": "BOSCHUSER1",
    "status": "NA",
    "customerSource": "Cust12",
    "errorMessage": "Invalid CreationDate For this CustomerID: c1 (Valid Date Formats: DD-MM-YYYY, DD/MM/YYYY)"
    }
  }

Authentication

Authorization

The API endpoint requires client authorization. Every request must select Basic Auth mode from Authorization section if using Postman Application and provide the username and password.

Content type of request payload

All information is sent and received as JSON data interchange format over HTTPS. Every request must select raw json as a data format for the request payload from the body section if using Postman Application and specify the content accordingly.

API Specification

Steps to use Postman Application to send the API Post Http Request

1. Open Postman:
• Launch the Postman application.

2. Create a New Request:
• In the Postman app, click on the "New" button (usually located at the top-left corner) to create a new request.

3. Choose the Request Type:
• In the request editor, you will see a dropdown menu next to the URL field. Select "POST" from this dropdown.

4. Enter the Request URL:
• In the URL field (located next to the request type dropdown), enter the URL of the endpoint where you want to send the POST request. Make sure it's the correct URL for the API or service you are working with.

5. Authentication:
• As the API requires authentication, you can set it up in the "Authorization" tab.Click on the "Basic Auth" from dropdown, and enter the username and password.

6. Configure the Request Body:
• In the "Body" tab, select "raw" and choose "JSON (application/json)" as the data format. Enter your JSON data in the provided text field.

7. Send the Request:
• Once you've configured all the necessary details for your POST request, click the "Send" button (usually a blue "Send" button located at the top-right corner). Postman will send the POST request to the specified URL with the provided headers and payload.

8. View the Response:
• Postman will display the response from the server, including the status code, headers, and response body. You can review the response to ensure that your request was successful

Postman call request payload
[
    {
    "CustomerId": "c1",
    "WorkshopId": "wwww1556b",
    "CustomerIdLanguage": "CustLang1",
    "FirstName": "Bhargavi",
    "FirstNameLocalLanguage": "TestBharg",
    "LastName": "TestSunchu",
    "LastNameLocalLanguage": "TestLocalSunchu",
    "CreationDate": "12\\\/12\\\/2023",
    "ModifiedDate": "11\/122023",
    "CustomerGroup": "CustGropr1",
    "CustomerGroupLocalLanguage": "CustGropLocalLang1",
    "IsCompany": "YES",
    "CompanyName": "BOSCHWSMSUSer",
    "CompanyNameLocalLanguage": "BOSCHUSER1",
    "Status": "NA",
    "CustomerSource": "Cust12"
    }
  ]
Postman HTTP response body

    HTTP/1.1 200 OK
    {
    "message": "All record(s) failed to process.",
    "totalRecords": 499,
    "failedRecords": 499,
    "successRecords": 0,
    "processedFailedRecords": [
    {
    "customerId": "c1",
    "workshopId": "wwww1556b",
    "customerIdLanguage": "CustLang1",
    "firstName": "Bhargavi",
    "firstNameLocalLanguage": "TestBharg",
    "lastName": "TestSunchu",
    "lastNameLocalLanguage": "TestLocalSunchu",
    "creationDate": "0001-01-01T00:00:00",
    "modifiedDate": "0001-01-01T00:00:00",
    "customerGroup": "CustGropr1",
    "customerGroupLocalLanguage": "CustGropLocalLang1",
    "isCompany": "YES",
    "companyName": "BOSCHWSMSUSer",
    "companyNameLocalLanguage": "BOSCHUSER1",
    "status": "NA",
    "customerSource": "Cust12",
    "errorMessage": "Invalid CreationDate For this CustomerID: c1 (Valid Date Formats: DD-MM-YYYY, DD/MM/YYYY)"
    }
    ]
   }