Skip to main content

​
Introduction

This API endpoint allows for the creation of custom materials in the Higg MSI. To create a custom material, the following base attributes are required:
  • Name (open text field, must be unique within an MSI library)
  • Category (user defined from the set of categories available in the MSI). See MSI Get Material Categories for additional information.
  • At least one base material (user defined from the set of base materials available in the MSI) See MSI Get Base Materials for additional information.
An optional text field material code can be added as ‘code’. For example, this field can be used to store a PLM id. Note that the field is editable by users within MSI. 
{
    "name": "My custom material",
    "code": "my PLM code",
    "category": "TX",
    "baseMaterials":[{
        "baseMaterialId": "FM002"
    }]
}

​
Creating blends

Blends are based on % of material for 1kg of MSI material. For example the code below represents an MSI material with 60% organic cotton, 40% polyester. The % blend must equal 100%. 
{

    "name": "Organic/Poly Blend",
    "code": "my PLM code",
    "baseMaterials":[{
        "baseMaterialId": "TX0010",
        "blendPercentage": 60
    }, {
        "baseMaterialId": "TX0001",
        "blendPercentage": 40
    }],
      "category": "TX"
}

​
Setting Yields

Optionally one or multiple yields can be sent for a material. All materials in MSI are normalized to 1kg. Yields provide conversions for the MSI 1kg material to a linear/volumetric unit. See MSI Get Yield Options for additional information. 
{
    "name": "Example MSI custom material",
    "code": "yield 2",
    "baseMaterials": [
        {
            "baseMaterialId": "FM002"
        }
    ],
    "yieldInfo": [
        {
            "type": "Yards (volumetric)",
            "width": 1,
            "widthUnit": "m",
            "thickness": 2,
            "thicknessUnit": "in",
            "densityVolumetric": 13,
            "densityVolumetricUnit": "kg/m3"
        }
    ],
    "category": "TX"
}

​
Setting Base Material Processes

The stage process for a base material can be changed via the API using the processId. For example, changing ‘cotton, fiber’ to ‘cotton fiber, organic” in the raw material formation stage. The processes must be available for the base material to change it. See MSI Get Processes for Base Material for how to get a list of available processes and their IDs. 
{
    "name": "Test blend",
    "code": "xyz PLM code",
    "baseMaterials":[{
        "baseMaterialId": "FM002",
        "blendPercentage": 60,
        "processes": {
      	 "P001": "PR0804000648",
         "P002": "PR0804000331"
        }
    }, {
       "baseMaterialId": "TX0010",
       "blendPercentage": 40,
       "processes": {
       	"P006": "PR0804000543"
       }
   }],
      "category": "TX"
}
See MSI Data Dictionary for details about the parameters.