The Product Group – List API call reads existing Product Groups from Eyelit MES-M. The data can be filtered based on the parameters passed in the body/payload of the JSON packet giving the flexibility to search for one or multiple Product Groups.  

Using the Product Group – List API call has no impact on the data within the given Eyelit MES-M application, it is read-only. 

Figure 1 shows the logic used within the Product Group – List API call. 

Figure 1 - Logic within ProductGroup/List API Call 

There is no data required in Eyelit MES-M to act as a pre-requisite to make the API call to list Product Groups. If parameters are passed in through the body that return no valid results, an empty payload will be returned.  

Table 1 shows the method and endpoint required to make the API call to list Product Groups. 

Note: For any fields where the match type is ‘Like’, a percent symbol should be used as a wildcard character to indicate a number of characters within the given string.  

See below for sample use cases with examples of the JSON payload format required.  

To list Product Groups where the name is ‘Controlled’: 

Response 

When using the Product Group – List API call, if any data has been found in Eyelit MES-M that meets the parameter values passed in the original payload, a JSON payload will be returned containing data in the following structure: 

See below for sample use cases with examples of the JSON payload format returned. 

No results were found that matched given parameters: 

Multiple Product Groups were found that matched given parameters: 

The Product Group – Upsert API call checks if a Product Group with the given ID already exists. If it does, appropriate fields are updated in the matching product in Eyelit MES-M. If no ID is provided, then a new Product Group is created. 

Figure 2 shows the logic used within the Product Group – Upsert API call. 

Figure 2 - Logic within ProductGroup/Upsert API Call 

There is no data required in Eyelit MES-M to act as a pre-requisite to make the API call to upsert Product Groups. If parameters are passed in through the body that return no valid results a new product group will be created, otherwise the Product Group identified will be updated. 

Table 3 shows the method and endpoint required to make the API call to list Product Groups. 

Table 3 - Outbound Message Detail for Product Group - Upsert 

Note: For any fields where the match type is ‘Like’, a percent symbol should be used as a wildcard character to indicate a number of characters within the given string. See examples in Section 3.1.3.1 for use cases.  

See below for sample use cases with examples of the JSON payload format required. 

To create a new Product Group. 

To update name and description by ID. 

When using the Product Group – Upsert API call, if a Product Group has been Created or Updated a JSON payload will be returned containing data in the following structure: 

Sample Response 

See below for sample use cases with examples of the JSON payload format returned. 

Delete

The Product Group – Delete API call attempts to delete a Product Group. A Product Group can be deleted as long as there are no Products currently assigned to the Product Group. 

Figure 3 shows the logic used within the Product Group – Delete API call. 

Figure 3 - Logic within ProductGroup/Delete API Call

In order to delete a Product Group, the Product Group must exist in Eyelit MES-M. The Product Group must have no Products currently assigned. 

Table 5 shows the method and endpoint required to make the API call to list Product Groups. 

Table 5 - Outbound Message Detail for Product Group - Delete 

Note: For any fields where the match type is ‘Like’, a percent symbol should be used as a wildcard character to indicate a number of characters within the given string. 

See below for sample use cases with examples of the JSON payload format required. 

Delete by ID 

When using the Product Group – Delete API call, if a Product Group has been Deleted a 200 status response will be returned.