Skip to content

Materials

The materials schema contains information regarding the materials that are used within components. These maybe a single material from the base materials catalogue, a combination of base materials and/or a material from the materials schema itself.

Table

Column
Status
 Format Notes
identifier required String The globally unique identifier for the created material unique identifier. See identifiers section for information on how to construct this identifier
materialName required String The name of the material this row relates to. (e.g., Aluminium 3000 Series or Borosilicate glass)
externalIdentifiers recommended Dictionary A dictionary of identifiers that might be used to identify the material in other systems. For example: manufacturer’s own internal identifier, bar codes or global trade item number (gtin). To provide external identifiers please follow this format. {'externalIdentifierName1': 'identifier1', 'externalIdentifierName2': 'identifier2'}
materialConstituents required List The information regarding the consituents that are combined to create this material. The entries should be from the Material Constituents Relationship List identifier.
combinationPurpose recommended String Why is this material being used? Use the identifier of the function that this row relates to. The entry here should be drawn from the Function Controlled List.
certification recommended Boolean Does the material have a certificate (e.g. FSC, REACH, FSA etc.)? Answer as: TRUE for yes and FALSE for no.
certificationClaims recommended List The information regarding the certification. The entries should be the Certification Claims Relationship List identifiers.
manufacturedCountry recommended Numeric The country the component was manufactured in. Use the country numeric ISO codes as described in the ISO 3166 international standard.
updateDate required String The date that the material was provided/last updated. Use the format dd/mm/yyyy.

Diagram

erDiagram
BASE_MATERIALS }o--o{ MATERIALS : within
  MATERIALS {
    identifier String
    materialName String
    externalIdentifiers Dictionary
    materialConstituents List
    combinationPurpose String
    certification Boolean
    certificationClaims List
    manufacturedCountry Numeric
    updateDate String
  }
  MATERIALS }o..o{ CONTROLLED_LISTS : attributes
  MATERIALS }o--o{ COMPONENTS : within
  MATERIALS }o..o{ RELATIONSHIP_LISTS : attributes
        CONTROLLED_LISTS {
    function recommended
    }
        RELATIONSHIP_LISTS {
    materialConstituents required
    certificationClaims recommended
      }

Template

Materials should be provided as a separate csv file. The specification of this csv file is as follows:

Materials Template

Example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
--Food grade synthetic polyethylene terephthalate (PET) made in the UK. Only one base material.
{
  "identifier": "DCEE1F88-A83B-5BBC-D2D9-6A862B344977",
  "materialName":"PET",
  "externalIdentifiers": {
    "GTIN":"123456789101",
    },
  "materialConstituents":["DCEE1F88-A83B-5BBC-D2D9-6A862B344977"],
  "combinationPurpose": "",
  "certification": "TRUE",
  "certificationClaims": ["1"],
  "manufacturedCountry": 826,
  "updateDate": "01/08/2022",
}

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
--Fibre based composite material to be used for a carton - semi verbose
{
  "identifier": "f87b9bb3-f141-41cf-986e-e3a32b223f09",
  "materialName": "Classic Carton Board - EVOH",
  "externalIdentifiers": {
    "EAN": "0123456789101",
    "BatchNumber": "2145-23-po"
    },
  "materialConstituents": [
    {
      "materialConstituentsIdentifier": "f87b9bb3-f141-41cf-986e-e3a32b223f09",
      "materialCombinationIdentifier": {
        "identifier": "3ca24db2-84d5-4681-aa16-136fbdba101f",
        "baseMaterialName": "Polyethylene",
        "baseMaterialType": {
          "identifier":"bm-material-type-0002",
          "category":"synthetic",
          "detailed":"derived from crude oil, natural gas or coal."
        },
        "materialChemCID": null,
        "externalIdentifiers": {
          "pk":"12",
          },
        "certification": "FALSE",
        "certificationClaims": null,
        "manufacturedCountry": {
          "Country": "United Kingdom of Great Britain and Northern Ireland (the)",
          "Numeric": 826
        },
        "updateDate": "01/08/2022",
      },
      "materialPurpose": {
        "identifier": "m-material-purpose-0005",
        "category": "barrier",
        "detailed": "Used to reduce water and gas diffusion into and/or out of the material."
      },
      "virginMaterial": 100,
      "layer": 1,
      "materialPercentage": 7
    },
    {
      "materialConstituentsIdentifier": "f87b9bb3-f141-41cf-986e-e3a32b223f09",
      "materialCombinationIdentifier": "96245c85-5671-4f3d-875f-82665005e9e8",
      "materialPurpose": {
        "identifier": "m-material-purpose-0015",
        "category": "structure",
        "detailed": "Providing strength and stability."
      },
      "virginMaterial": 100,
      "layer": 2,
      "materialPercentage": 27
    },
    {
      "materialConstituentsIdentifier": "f87b9bb3-f141-41cf-986e-e3a32b223f09",
      "materialCombinationIdentifier": {
        "identifier": "3ca24db2-84d5-4681-aa16-136fbdba101f",
        "baseMaterialName": "Polyethylene",
        "baseMaterialType": {
          "identifier":"bm-material-type-0002",
          "category":"synthetic",
          "detailed":"derived from crude oil, natural gas or coal."
        },
        "materialChemCID": null,
        "externalIdentifiers": {
          "pk":"12",
          },
        "certification": "FALSE",
        "certificationClaims": null,
        "manufacturedCountry": {
          "Country": "United Kingdom of Great Britain and Northern Ireland (the)",
          "Numeric": 826
        },
        "updateDate": "01/08/2022",
      },
      "materialPurpose": {
        "identifier": "m-material-purpose-0002",
        "category": "adhesive",
        "detailed": "Applied to one or both surfaces of two separate items that binds them together and resists their separation."
      },
      "virginMaterial": 100,
      "layer": 3,
      "materialPercentage": 7
    },
    {
      "materialConstituentsIdentifier": "f87b9bb3-f141-41cf-986e-e3a32b223f09",
      "materialCombinationIdentifier": "ff249e1f-5015-46b8-8655-6c920fbf2606",
      "materialPurpose": {
        "identifier": "m-material-purpose-0003",
        "category": "antioxidant",
        "detailed": "Used to inhibit oxidation."
      },
      "virginMaterial": 100,
      "layer": 4,
      "materialPercentage": 18
    },
    {
      "materialConstituentsIdentifier": "f87b9bb3-f141-41cf-986e-e3a32b223f09",
      "materialCombinationIdentifier": {
        "identifier": "3ca24db2-84d5-4681-aa16-136fbdba101f",
        "baseMaterialName": "Polyethylene",
        "baseMaterialType": {
          "identifier":"bm-material-type-0002",
          "category":"synthetic",
          "detailed":"derived from crude oil, natural gas or coal."
        },
        "materialChemCID": null,
        "externalIdentifiers": {
          "pk":"12",
          },
        "certification": "FALSE",
        "certificationClaims": null,
        "manufacturedCountry": {
          "Country": "United Kingdom of Great Britain and Northern Ireland (the)",
          "Numeric": 826
        },
        "updateDate": "01/08/2022",
      },
      "materialPurpose": {
        "identifier": "m-material-purpose-0002",
        "category": "adhesive",
        "detailed": "Applied to one or both surfaces of two separate items that binds them together and resists their separation."
      },
      "virginMaterial": 100,
      "layer": 5,
      "materialPercentage": 7
    },
    {
      "materialConstituentsIdentifier": "f87b9bb3-f141-41cf-986e-e3a32b223f09",
      "materialCombinationIdentifier": "96245c85-5671-4f3d-875f-82665005e9e8",
      "materialPurpose": {
        "identifier": "m-material-purpose-0015",
        "category": "structure",
        "detailed": "Providing strength and stability."
      },
      "virginMaterial": 100,
      "layer": 6,
      "materialPercentage": 27
    },
    {
      "materialConstituentsIdentifier": "f87b9bb3-f141-41cf-986e-e3a32b223f09",
      "materialCombinationIdentifier": {
        "identifier": "3ca24db2-84d5-4681-aa16-136fbdba101f",
        "baseMaterialName": "Polyethylene",
        "baseMaterialType": {
          "identifier":"bm-material-type-0002",
          "category":"synthetic",
          "detailed":"derived from crude oil, natural gas or coal."
        },
        "materialChemCID": null,
        "externalIdentifiers": {
          "pk":"12",
          },
        "certification": "FALSE",
        "certificationClaims": null,
        "manufacturedCountry": {
          "Country": "United Kingdom of Great Britain and Northern Ireland (the)",
          "Numeric": 826
        },
        "updateDate": "01/08/2022",
      },
      "materialPurpose": {
        "identifier": "m-material-purpose-0005",
        "category": "barrier",
        "detailed": "Used to reduce water and gas diffusion into and/or out of the material."
      },
      "virginMaterial": 100,
      "layer": 7,
      "materialPercentage": 7
    },
  ],
  "combinationPurpose": {
    "identifier": "function-0012",
    "category": "carton",
    "detailed": "Box or container used for transporting and storaging goods."
  },
  "certification": "FALSE",
  "certificationClaims": null,
  "manufacturedCountry": {
    "Country": "United Kingdom of Great Britain and Northern Ireland (the)",
    "Numeric": 826
  },
  "updateDate": "01/08/2022"
}

Guide for how to take measurements

Units

All measurements should be given using the metric system.

  • Weight: grams (g)

Numbers should be entered with a decimal place. Use the decimal / full stop / period character as a separator. Do not exceed 3 decimal places. When rounding, use convential rounding methods: for 5 and above round up, 4 and below round down. For example: volume = 0.67952 rounded to 0.68.

Important: When converting between systems of measurement, perform the conversion first and then apply the convential rounding. This will give more accuracy and consistency.