Guidelines > Advanced Guidelines > Multilingual Material Features
The following steps represent the normal workflow for creating, updating, and deleting the material features and skus in a multilingual context.
Obviously, these guidelines cannot contain all the features. The features with similar characteristics will have similar behavior.
💡 See the isTranslatable, isCustom, and isMultiple flags, the possibleValues, and the possibleUnits in PropertyDetailsLookup to know the features that can be similar to the features presented in these guidelines.
Services Used
Step 1 Creation
Which actions will be performed
- Create a material with
- Locale :
en(⚠️ It's highly recommanded that you create your entity in English first ("locale": "en"). The majority of users use this language and it's used as fallback language.) - External id :
Connect_Material_Multilingual_01_External_Id - Name :
Connect Material Multilingual 01 - Product id :
connect-material-multilingual-01-product-id - Management permission :
COMPANY_EDITABLE - Brand with the name :
Branduro inc.(This brand already exist in the system and is already translated in French) - Logo :
image.original.url/connect-file-1.png(In Origin, It refers to the material thumbnail image and the first image of the material. This image can be also set in Origin Website -> Material edit page -> Image Section -> Featured Image checkbox.) - Category : Hardware (code:
gc_36) - Add custom features
- Custom Numeric Attribute (code
CUSTOM_NUMERIC_ATTRIBUTE) namedDeepness (meter)with value10 - Custom Date Attribute (code
CUSTOM_DATE_ATTRIBUTE) namedProduction datewith value2019-04-01T04:00:00Z - 3 Custom Text Attribute (code
CUSTOM_TEXT_ATTRIBUTE)- Named
Mineral densitywith valueDiamond - Named
Awith valueX - Named
Awith valueY
- Named
- Custom Color Attribute (code
CUSTOM_COLOR_ATTRIBUTE) NamedSeat Colorwith the custom color nameCharcoaland mapped on the standard color Black (codeBLACK#000000)
- Custom Numeric Attribute (code
- Add property features
- Additional Notes (code
MM_ADD_NOTES) with valuenote - Length (code
LENGTH) with value10and the unit inches (codeINCH) - Fire Rating (code
FIRERATING) with valueA1 - Material Composition (code
MATERIAL_TYPE) with value Bamboo (codeBAMBOO) - Colour (code
COLOR) with value Green (codeGREEN#00ff00)
- Additional Notes (code
- Add one sku with
- Name:
C_M_ML_01 sku-01, - Product id :
c-m-ml-01-sku01 - Same custom features and property features as the material
- Name:
- Locale :
- Publish the material on Origin (channel name :
ORIGIN)
📝 Note 1 All custom feature names are translatable.
⚠️ Note 2 For now, only the property feature with the code FIRERATING, the custom features with the code CUSTOM_TEXT_ATTRIBUTE and the custom feature with the code CUSTOM_COLOR_ATTRIBUTE have a value that can be translated. For the other features, if an update is done in one language, the update will be applied on all languages.
💡 Note 3 See the isTranslatable flag in PropertyDetailsLookup to know the features that can be translated.
⚠️ Note 4 For the custom feature with the code CUSTOM_COLOR_ATTRIBUTE, if the mapped color code is updated in one language, the update will be applied on all languages.
Request URI
/connect/v2/materials/create
Sample MaterialsCreate Request
{
"materials": [
{
"locale": "en",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01",
"brand": {
"name": "Branduro inc."
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png"
},
"category": {
"code": "gc_36"
},
"channels": [
{
"name": "ORIGIN"
}
],
"featuresCustoms": [
{
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)",
"value": {
"content": "10"
}
},
{
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date",
"value": {
"content": "2019-04-01T04:00:00Z"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density",
"value": {
"content": "Diamond"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "X"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color",
"value": {
"code": "BLACK#000000",
"content": "Charcoal"
}
}
],
"featuresProperties": [
{
"code": "MM_ADD_NOTES",
"value": {
"content": "note"
}
},
{
"code": "LENGTH",
"value": {
"content": "10"
},
"unit": {
"code": "INCH"
}
},
{
"code": "FIRERATING",
"value": {
"content": "A1"
}
},
{
"code": "MATERIAL_TYPE",
"value": {
"code": "BAMBOO"
}
},
{
"code": "COLOR",
"value": {
"code": "GREEN#00ff00"
}
}
],
"skus": [
{
"name": "C_M_ML_01 sku-01",
"productId": "c-m-ml-01-sku01",
"featuresCustoms": [
{
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)",
"value": {
"content": "10"
}
},
{
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date",
"value": {
"content": "2019-04-01T04:00:00Z"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density",
"value": {
"content": "Diamond"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "X"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color",
"value": {
"code": "BLACK#000000",
"content": "Charcoal"
}
}
],
"featuresProperties": [
{
"code": "MM_ADD_NOTES",
"value": {
"content": "note"
}
},
{
"code": "LENGTH",
"value": {
"content": "10"
},
"unit": {
"code": "INCH"
}
},
{
"code": "FIRERATING",
"value": {
"content": "A1"
}
},
{
"code": "MATERIAL_TYPE",
"value": {
"code": "BAMBOO"
}
},
{
"code": "COLOR",
"value": {
"code": "GREEN#00ff00"
}
}
]
}
]
}
]
}
Sample MaterialsCreate Response
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"correlations": [
{
"externalId": "Connect_Material_Multilingual_01_External_Id",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
},
"connectRequest": {
"materials": [
{
"locale": "en",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01",
"brand": {
"name": "Branduro inc."
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png"
},
"category": {
"code": "gc_36"
},
"channels": [
{
"name": "ORIGIN"
}
],
"featuresCustoms": [
{
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)",
"value": {
"content": "10"
}
},
{
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date",
"value": {
"content": "2019-04-01T04:00:00Z"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density",
"value": {
"content": "Diamond"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "X"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color",
"value": {
"code": "BLACK#000000",
"content": "Charcoal"
}
}
],
"featuresProperties": [
{
"code": "MM_ADD_NOTES",
"value": {
"content": "note"
}
},
{
"code": "LENGTH",
"value": {
"content": "10"
},
"unit": {
"code": "INCH"
}
},
{
"code": "FIRERATING",
"value": {
"content": "A1"
}
},
{
"code": "MATERIAL_TYPE",
"value": {
"code": "BAMBOO"
}
},
{
"code": "COLOR",
"value": {
"code": "GREEN#00ff00"
}
}
],
"skus": [
{
"name": "C_M_ML_01 sku-01",
"productId": "c-m-ml-01-sku01",
"featuresCustoms": [
{
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)",
"value": {
"content": "10"
}
},
{
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date",
"value": {
"content": "2019-04-01T04:00:00Z"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density",
"value": {
"content": "Diamond"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "X"
}
},
{
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color",
"value": {
"code": "BLACK#000000",
"content": "Charcoal"
}
}
],
"featuresProperties": [
{
"code": "MM_ADD_NOTES",
"value": {
"content": "note"
}
},
{
"code": "LENGTH",
"value": {
"content": "10"
},
"unit": {
"code": "INCH"
}
},
{
"code": "FIRERATING",
"value": {
"content": "A1"
}
},
{
"code": "MATERIAL_TYPE",
"value": {
"code": "BAMBOO"
}
},
{
"code": "COLOR",
"value": {
"code": "GREEN#00ff00"
}
}
]
}
]
}
]
}
}
📝 Note The MaterialsCreate Response return a correlations array that contains a pair of externalId and originId.
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"correlations": [
{
"externalId": "Connect_Material_Multilingual_01_External_Id",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
},
"connectRequest": { ... }
}
You can store the originId on your side, so you can use it in future calls.
Both can be used to make the calls, ⚠️ but externalId is not unique unlike originId.
Both are used in these guidelines.
Step 2 Creation Validation (Optional)
Which actions will be performed
- Validate the material creation in English
- Validate the material creation in French
Request URI
/connect/v2/materials/search
Sample MaterialsSearch Request in English
{
"locale": "en",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
Sample MaterialsSearch Response in English after creation
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"searchInfo": {
"numberOfElements": "1",
"numberOfPages": "1"
},
"data": [
{
"locale": "en",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01",
"contentManagedBy": "John Smith",
"lastUpdated": "2023-03-07T16:45:55Z",
"brand": {
"originId": "111fbedf-d293-44cf-9967-9e1e458d89c3",
"name": "Branduro inc.",
"website": "www.branduro-2000.tld"
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
},
"company": {
"originId": "d0b95867-fc95-4c15-a76e-f2593e1dbab9",
"name": "Connect",
"companyType": "MANUFACTURER"
},
"category": {
"name": "Hardware",
"code": "gc_36"
},
"images": [
{
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
}
],
"contacts": [
{
"type": "COMPANYHQ",
"name": "Contact",
"website": "connect.tld",
"phone": "+1-000-000-0000",
"email": "contact@connect.tld",
"location": {
"city": "Washington, D.C.",
"region": "Washington, D.C.",
"country": "United States"
}
}
],
"featuresCustoms": [
{
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date",
"value": {
"content": "2019-04-01T04:00:00Z"
}
},
{
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color",
"value": {
"code": "BLACK#000000",
"content": "Charcoal"
}
},
{
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density",
"value": {
"content": "Diamond"
}
},
{
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)",
"value": {
"content": "10"
}
},
{
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "X"
}
},
{
"originId": "5da6a9a9-aa35-4c8d-b982-d0545cc8868c",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
}
],
"featuresProperties": [
{
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "10"
},
"unit": {
"code": "INCH",
"name": "inches"
}
},
{
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "GREEN#00ff00",
"content": "Green"
}
},
{
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"name": "Material Composition",
"value": {
"code": "BAMBOO",
"content": "Bamboo"
}
},
{
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"name": "Additional Notes",
"value": {
"content": "note"
}
},
{
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"name": "Fire Rating",
"value": {
"content": "A1"
}
}
],
"skus": [
{
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01",
"productId": "c-m-ml-01-sku01",
"featuresCustoms": [
{
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "X"
}
},
{
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)",
"value": {
"content": "10"
}
},
{
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color",
"value": {
"code": "BLACK#000000",
"content": "Charcoal"
}
},
{
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density",
"value": {
"content": "Diamond"
}
},
{
"originId": "ab1d2c24-9a0b-441e-a4bd-2767c12252f9",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date",
"value": {
"content": "2019-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"name": "Fire Rating",
"value": {
"content": "A1"
}
},
{
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"name": "Additional Notes",
"value": {
"content": "note"
}
},
{
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "10"
},
"unit": {
"code": "INCH",
"name": "inches"
}
},
{
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"name": "Material Composition",
"value": {
"code": "BAMBOO",
"content": "Bamboo"
}
},
{
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "GREEN#00ff00",
"content": "Green"
}
}
]
}
],
"originUrl": "https://origin.build/#/material/f3668700-5f01-42b9-bd2c-73b82ac41af3?locale=en"
}
]
},
"connectRequest": {
"locale": "en",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
}
📝 Note 1 All features and skus have been created correctly, and each one has an originId. This originId can be use to update or remove the feature or the sku.
📝 Note 2 Even if the material features and the sku features share the same structure, they all have a different originId.
📝 Note 3 The other fields have been created correctly.
Sample MaterialsSearch Request in French
{
"locale": "fr",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
Sample MaterialsSearch Response in French after creation
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"searchInfo": {
"numberOfElements": "1",
"numberOfPages": "1"
},
"data": [
{
"locale": "fr",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01",
"contentManagedBy": "John Smith",
"lastUpdated": "2023-03-07T16:45:55Z",
"brand": {
"originId": "111fbedf-d293-44cf-9967-9e1e458d89c3",
"name": "Marqueuro incorporé (Branduro)",
"website": "www.branduro-2000.tld"
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
},
"company": {
"originId": "d0b95867-fc95-4c15-a76e-f2593e1dbab9",
"name": "Connecter (Connect)",
"companyType": "MANUFACTURER"
},
"category": {
"name": "Quincaillerie",
"code": "gc_36"
},
"images": [
{
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
}
],
"contacts": [
{
"type": "COMPANYHQ",
"name": "Contact",
"website": "connect.tld",
"phone": "+1-000-000-0000",
"email": "contact@connect.tld",
"location": {
"city": "Washington",
"region": "Washington, D.C.",
"country": "USA"
}
}
],
"featuresCustoms": [
{
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date",
"value": {
"content": "2019-04-01T04:00:00Z"
}
},
{
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color",
"value": {
"code": "BLACK#000000",
"content": "Charcoal"
}
},
{
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density",
"value": {
"content": "Diamond"
}
},
{
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)",
"value": {
"content": "10"
}
},
{
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "X"
}
},
{
"originId": "5da6a9a9-aa35-4c8d-b982-d0545cc8868c",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
}
],
"featuresProperties": [
{
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "10"
},
"unit": {
"code": "INCH",
"name": "pouces"
}
},
{
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "GREEN#00ff00",
"content": "Vert"
}
},
{
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"name": "Composition des matériaux",
"value": {
"code": "BAMBOO",
"content": "Bambou"
}
},
{
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"name": "Note additionnelle",
"value": {
"content": "note"
}
},
{
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"name": "Propriétés ignifuges",
"value": {
"content": "A1"
}
}
],
"skus": [
{
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01",
"productId": "c-m-ml-01-sku01",
"featuresCustoms": [
{
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "X"
}
},
{
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)",
"value": {
"content": "10"
}
},
{
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color",
"value": {
"code": "BLACK#000000",
"content": "Charcoal"
}
},
{
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density",
"value": {
"content": "Diamond"
}
},
{
"originId": "ab1d2c24-9a0b-441e-a4bd-2767c12252f9",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date",
"value": {
"content": "2019-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"name": "Propriétés ignifuges",
"value": {
"content": "A1"
}
},
{
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"name": "Note additionnelle",
"value": {
"content": "note"
}
},
{
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "10"
},
"unit": {
"code": "INCH",
"name": "pouces"
}
},
{
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"name": "Composition des matériaux",
"value": {
"code": "BAMBOO",
"content": "Bambou"
}
},
{
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "GREEN#00ff00",
"content": "Vert"
}
}
]
}
],
"originUrl": "https://origin.build/#/material/f3668700-5f01-42b9-bd2c-73b82ac41af3?locale=fr"
}
]
},
"connectRequest": {
"locale": "fr",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
}
📝 Note 1 The brand.name, the company.name, and the category.name are displayed in French.
⚠️ Note 2 The English translation is copied on the French translation for the field materials[].name after the publication.
📝 Note 3 On custom features, the translatable feature names fall back on the English translation.
📝 Note 4 On custom features, the translatable feature values fall back on the English translation.
📝 Note 5 On property features, the translatable feature values fall back on the English translation.
📝 Note 6 On property features, the not translatable feature names, values* and units** are displayed in French.
⚠️ Note 7 The other values are displayed as is.
📝 Note 8 The sku1 name falls back on the English translation.
⚠️ Note 9 The sku1 productId is displayed as is.
*If they are related to possibleValues 💡 See the possibleValues in PropertyDetailsLookup
**If they are related to possibleUnits 💡 See the possibleUnits in PropertyDetailsLookup
Step 3 Update in English
Which actions will be performed
- Update the material in English
- Locale :
en(⚠️ It's highly recommanded that you update your entity in English first ("locale": "en"). The majority of users use this language and it's used as fallback language.) - External id :
Connect_Material_Multilingual_01_External_Id(No change) - Update the Name to
Connect Material Multilingual 01_UPDATED(The name will be updated only in English) - Add custom features
- Custom Numeric Attribute (code
CUSTOM_NUMERIC_ATTRIBUTE) namedCircumference (meter)with value31.416 - Custom Date Attribute (code
CUSTOM_DATE_ATTRIBUTE) namedEnd of Production datewith value2030-04-01T04:00:00Z - Custom Text Attribute (code
CUSTOM_TEXT_ATTRIBUTE) namedRock Categorywith valueMetamorphic - Custom Color Attribute (code
CUSTOM_COLOR_ATTRIBUTE) NamedDoor Colorwith the custom color nameWhite Eggand mapped on the standard color White (codeWHITE#ffffff)
- Custom Numeric Attribute (code
- Update custom features
- Update the feature
Deepness (meter)with value10toDeepness (meter)_UPDATEDwith value20(The name will be updated only in English, but the value will be updated on all language) - Update the feature
Production datewith value2019-04-01T04:00:00ZtoProduction date_UPDATEDwith value2020-04-01T04:00:00Z(The name will be updated only in English, but the value will be updated on all language) - Update the feature
Mineral densitywith valueDiamondtoMineral density_UPDATEDwith valueDiamond_UPDATED(The name and the value will be updated only in English) - Update the feature
Awith valueXtoA_UPDATEDwith valueX_UPDATED(The name and the value will be updated only in English) - Update the feature
Seat Colorwith the custom color nameCharcoaland mapped on the standard color Black (codeBLACK#000000) toSeat Color_UPDATEDwith the custom color nameCherry Redand mapped on the standard color Red (codeRED#ff0000) (The name and the custom color name will be updated only in English, but the mapped color code will be updated on all language)
- Update the feature
- Add property features
- Warranty (code
WARRANTY) with value13and the unit months (codeMONTH) - Length (code
LENGTH) with value25and the unit cm (codeCENTIMETER) - End of Life (code
ENDOFLIFE) with value100 % recyclable - PVC free (code
PVC_FREE) with value Yes (codeYES) - Colour (code
COLOR) with value Dark Blue (codeBLUEDARK#00008b)
- Warranty (code
- Update property features
- Update the feature Additional Notes with value
noteto Additional Notes with valuenote_UPDATED(The value will be updated on all language) - Update the feature Length with value
10and the unit inches to Length with value20and the unit inches (The value and the unit will be updated on all language) - Update the feature Fire Rating with value
A1to Fire Rating with valueA1_UPDATED(The value will be updated only in English) - Update the feature Material Composition with value Bamboo (code
BAMBOO) to Material Composition with value Wood (codeWOOD) (The value will be updated on all language) - Update the feature Colour with value Green (code
GREEN#00ff00) to Colour with value Dark Red (codeREDDARK#8b0000) (The value will be updated on all language)
- Update the feature Additional Notes with value
- Add one sku with
- Name:
C_M_ML_01 sku-02 - Product id :
c-m-ml-01-sku02 - No custom feature and no property feature
- Name:
- Update one sku with
- Name:
C_M_ML_01 sku-01_UPDATED(The name will be updated only in English) - Product id :
c-m-ml-01-sku01_UPDATED(The product id will be updated on all language) - The same feature additions and feature updates as the material
- Name:
- Locale :
📝 Note 1 All custom feature names are translatable.
⚠️ Note 2 Now, only the property feature with the code FIRERATING, the property feature with the code ENDOFLIFE, the custom features with the code CUSTOM_TEXT_ATTRIBUTE and the custom feature with the code CUSTOM_COLOR_ATTRIBUTE have a value that can be translated. For the other features, if an update is done in one language, the update will be applied on all languages.
💡 Note 3 See the isTranslatable flag in PropertyDetailsLookup to know the features that can be translated.
⚠️ Note 4 For the custom feature with the code CUSTOM_COLOR_ATTRIBUTE, if the mapped color code is updated in one language, the update will be applied on all languages.
Request URI
/connect/v2/materials/update
Sample MaterialsUpdate Request
{
"materials": [
{
"locale": "en",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"name": "Connect Material Multilingual 01_UPDATED",
"featuresCustoms": [
{
"collectionBehavior": "ADD",
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "20"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"collectionBehavior": "ADD",
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2020-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"collectionBehavior": "ADD",
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "RED#ff0000",
"content": "Cherry red"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "ADD",
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"value": {
"content": "note_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "WARRANTY",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH"
}
},
{
"collectionBehavior": "ADD",
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"value": {
"content": "20"
},
"unit": {
"code": "INCH"
}
},
{
"collectionBehavior": "ADD",
"code": "LENGTH",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER"
}
},
{
"collectionBehavior": "ADD",
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"value": {
"content": "A1_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "ENDOFLIFE",
"value": {
"content": "100 % recyclable"
}
},
{
"collectionBehavior": "ADD",
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"value": {
"code": "WOOD"
}
},
{
"collectionBehavior": "ADD",
"code": "PVC_FREE",
"value": {
"code": "YES"
}
},
{
"collectionBehavior": "ADD",
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"value": {
"code": "REDDARK#8b0000"
}
},
{
"collectionBehavior": "ADD",
"code": "COLOR",
"value": {
"code": "BLUEDARK#00008b"
}
}
],
"skus": [
{
"collectionBehavior": "ADD",
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_UPDATED",
"productId": "c-m-ml-01-sku01_UPDATED",
"featuresCustoms": [
{
"collectionBehavior": "ADD",
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "20"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"collectionBehavior": "ADD",
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2020-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"collectionBehavior": "ADD",
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "RED#ff0000",
"content": "Cherry red"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "ADD",
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"value": {
"content": "note_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "WARRANTY",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH"
}
},
{
"collectionBehavior": "ADD",
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"value": {
"content": "20"
},
"unit": {
"code": "INCH"
}
},
{
"collectionBehavior": "ADD",
"code": "LENGTH",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER"
}
},
{
"collectionBehavior": "ADD",
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"value": {
"content": "A1_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "ENDOFLIFE",
"value": {
"content": "100 % recyclable"
}
},
{
"collectionBehavior": "ADD",
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"value": {
"code": "WOOD"
}
},
{
"collectionBehavior": "ADD",
"code": "PVC_FREE",
"value": {
"code": "YES"
}
},
{
"collectionBehavior": "ADD",
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"value": {
"code": "REDDARK#8b0000"
}
},
{
"collectionBehavior": "ADD",
"code": "COLOR",
"value": {
"code": "BLUEDARK#00008b"
}
}
]
},
{
"collectionBehavior": "ADD",
"name": "C_M_ML_01 sku-02",
"productId": "c-m-ml-01-sku02"
}
]
}
]
}
⚠️ Note If you want to update some sku fields, you need to add this "collectionBehavior": "ADD" to the sku.
Sample MaterialsUpdate Response
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"result": "Update completed."
},
"connectRequest": {
"materials": [
{
"locale": "en",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"name": "Connect Material Multilingual 01_UPDATED",
"featuresCustoms": [
{
"collectionBehavior": "ADD",
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "20"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"collectionBehavior": "ADD",
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2020-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"collectionBehavior": "ADD",
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "RED#ff0000",
"content": "Cherry red"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "ADD",
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"value": {
"content": "note_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "WARRANTY",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH"
}
},
{
"collectionBehavior": "ADD",
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"value": {
"content": "20"
},
"unit": {
"code": "INCH"
}
},
{
"collectionBehavior": "ADD",
"code": "LENGTH",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER"
}
},
{
"collectionBehavior": "ADD",
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"value": {
"content": "A1_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "ENDOFLIFE",
"value": {
"content": "100 % recyclable"
}
},
{
"collectionBehavior": "ADD",
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"value": {
"code": "WOOD"
}
},
{
"collectionBehavior": "ADD",
"code": "PVC_FREE",
"value": {
"code": "YES"
}
},
{
"collectionBehavior": "ADD",
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"value": {
"code": "REDDARK#8b0000"
}
},
{
"collectionBehavior": "ADD",
"code": "COLOR",
"value": {
"code": "BLUEDARK#00008b"
}
}
],
"skus": [
{
"collectionBehavior": "ADD",
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_UPDATED",
"productId": "c-m-ml-01-sku01_UPDATED",
"featuresCustoms": [
{
"collectionBehavior": "ADD",
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "20"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"collectionBehavior": "ADD",
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2020-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"collectionBehavior": "ADD",
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "RED#ff0000",
"content": "Cherry red"
}
},
{
"collectionBehavior": "ADD",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "ADD",
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"value": {
"content": "note_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "WARRANTY",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH"
}
},
{
"collectionBehavior": "ADD",
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"value": {
"content": "20"
},
"unit": {
"code": "INCH"
}
},
{
"collectionBehavior": "ADD",
"code": "LENGTH",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER"
}
},
{
"collectionBehavior": "ADD",
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"value": {
"content": "A1_UPDATED"
}
},
{
"collectionBehavior": "ADD",
"code": "ENDOFLIFE",
"value": {
"content": "100 % recyclable"
}
},
{
"collectionBehavior": "ADD",
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"value": {
"code": "WOOD"
}
},
{
"collectionBehavior": "ADD",
"code": "PVC_FREE",
"value": {
"code": "YES"
}
},
{
"collectionBehavior": "ADD",
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"value": {
"code": "REDDARK#8b0000"
}
},
{
"collectionBehavior": "ADD",
"code": "COLOR",
"value": {
"code": "BLUEDARK#00008b"
}
}
]
},
{
"collectionBehavior": "ADD",
"name": "C_M_ML_01 sku-02",
"productId": "c-m-ml-01-sku02"
}
]
}
]
}
}
Step 4 Update in English Validation (Optional)
Which actions will be performed
- Validate the English updates in English
- Validate the English updates in French
Request URI
/connect/v2/materials/search
See Step 2 Sample MaterialsSearch Request in English for the MaterialsSearch Request.
Sample MaterialsSearch Response in English after update in English
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"searchInfo": {
"numberOfElements": "1",
"numberOfPages": "1"
},
"data": [
{
"locale": "en",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01_UPDATED",
"contentManagedBy": "John Smith",
"lastUpdated": "2023-03-07T17:50:30Z",
"brand": {
"originId": "111fbedf-d293-44cf-9967-9e1e458d89c3",
"name": "Branduro inc.",
"website": "www.branduro-2000.tld"
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
},
"company": {
"originId": "d0b95867-fc95-4c15-a76e-f2593e1dbab9",
"name": "Connect",
"companyType": "MANUFACTURER"
},
"category": {
"name": "Hardware",
"code": "gc_36"
},
"images": [
{
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
}
],
"contacts": [
{
"type": "COMPANYHQ",
"name": "Contact",
"website": "connect.tld",
"phone": "+1-000-000-0000",
"email": "contact@connect.tld",
"location": {
"city": "Washington, D.C.",
"region": "Washington, D.C.",
"country": "United States"
}
}
],
"featuresCustoms": [
{
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2020-04-01T04:00:00Z"
}
},
{
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "RED#ff0000",
"content": "Cherry red"
}
},
{
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "20"
}
},
{
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"originId": "5da6a9a9-aa35-4c8d-b982-d0545cc8868c",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"originId": "9b858095-ccc5-44cd-946b-a224228b8396",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"originId": "6c680bc9-21ef-48bd-8a8a-fc77df8fab1e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
},
{
"originId": "34ac6a27-dd8d-4fdf-9746-7306671b4d71",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"originId": "f30f01e0-bd48-4230-8978-ca7ac38f0e8f",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "cca0846b-6c02-4223-b2aa-f4af95a720de",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER",
"name": "cm"
}
},
{
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "20"
},
"unit": {
"code": "INCH",
"name": "inches"
}
},
{
"originId": "0d00d21e-86d3-46a7-8773-6d75ee2a105e",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "BLUEDARK#00008b",
"content": "Dark Blue"
}
},
{
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "REDDARK#8b0000",
"content": "Dark Red"
}
},
{
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"name": "Material Composition",
"value": {
"code": "WOOD",
"content": "Wood"
}
},
{
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"name": "Additional Notes",
"value": {
"content": "note_UPDATED"
}
},
{
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"name": "Fire Rating",
"value": {
"content": "A1_UPDATED"
}
},
{
"originId": "e71f637e-bd32-453f-8699-ce758c3d1492",
"code": "ENDOFLIFE",
"name": "End of Life",
"value": {
"content": "100 % recyclable"
}
},
{
"originId": "38289388-b8a9-41de-96e2-0dd1b5cd93ed",
"code": "PVC_FREE",
"name": "PVC free",
"value": {
"code": "YES",
"content": "Yes"
}
},
{
"originId": "e5334bd4-d828-4af0-8255-ce347db59e4c",
"code": "WARRANTY",
"name": "Warranty",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH",
"name": "Months"
}
}
],
"skus": [
{
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_UPDATED",
"productId": "c-m-ml-01-sku01_UPDATED",
"featuresCustoms": [
{
"originId": "b4e95af5-044d-46a0-aaea-043b76f00749",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
},
{
"originId": "916e5b98-e16e-4bef-ad42-6bb24929f3b9",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"originId": "be83a526-46b5-4ab2-91cc-288edee3f84f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"originId": "b0ec6700-58bf-4569-9f21-256425c29cad",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "20"
}
},
{
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "RED#ff0000",
"content": "Cherry red"
}
},
{
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"originId": "ab1d2c24-9a0b-441e-a4bd-2767c12252f9",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2020-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "1251891b-fa77-4488-a37a-61fc4cbfe7a8",
"code": "WARRANTY",
"name": "Warranty",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH",
"name": "Months"
}
},
{
"originId": "6b71d095-405b-4d28-9245-4e7df55a8be4",
"code": "PVC_FREE",
"name": "PVC free",
"value": {
"code": "YES",
"content": "Yes"
}
},
{
"originId": "a7dcbdfa-e3f7-4e8f-957b-3f9e0abfc88b",
"code": "ENDOFLIFE",
"name": "End of Life",
"value": {
"content": "100 % recyclable"
}
},
{
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"name": "Fire Rating",
"value": {
"content": "A1_UPDATED"
}
},
{
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"name": "Additional Notes",
"value": {
"content": "note_UPDATED"
}
},
{
"originId": "22b653cc-bdfa-4278-b075-e08a1f527c7f",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER",
"name": "cm"
}
},
{
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "20"
},
"unit": {
"code": "INCH",
"name": "inches"
}
},
{
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"name": "Material Composition",
"value": {
"code": "WOOD",
"content": "Wood"
}
},
{
"originId": "18f2a9a6-aa8a-49a5-9ff5-4f7566a8a5b7",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "BLUEDARK#00008b",
"content": "Dark Blue"
}
},
{
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "REDDARK#8b0000",
"content": "Dark Red"
}
}
]
},
{
"originId": "807f952a-d82a-4d5b-bec3-4e726ade1393",
"name": "C_M_ML_01 sku-02",
"productId": "c-m-ml-01-sku02"
}
],
"originUrl": "https://origin.build/#/material/f3668700-5f01-42b9-bd2c-73b82ac41af3?locale=en"
}
]
},
"connectRequest": {
"locale": "en",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
}
📝 Note 1 All features and skus have been created correctly, and each one has an originId. This originId can be use to update or remove the feature or the sku.
📝 Note 2 Even if the material features and the sku features share the same structure, they all have a different originId.
📝 Note 3 The English translation, for the field materials[].name, has been updated correctly.
📝 Note 4 On custom features, the English translations, for the translatable feature names, have been updated correctly.
📝 Note 5 On custom features, the English translations, for the translatable feature values, have been updated correctly.
📝 Note 6 On property features, the English translations, for the translatable feature values, have been updated correctly.
📝 Note 7 On property features, the not translatable feature names, values* and units** are displayed in English.
⚠️ Note 8 The other values have been updated correctly and their updates will be applied on all languages.
📝 Note 9 The English translation, for the sku1 name, has been updated correctly.
⚠️ Note 10 The sku1 productId has been updated correctly and its update will be applied on all languages.
*If they are related to possibleValues 💡 See the possibleValues in PropertyDetailsLookup
**If they are related to possibleUnits 💡 See the possibleUnits in PropertyDetailsLookup
See Step 2 Sample MaterialsSearch Request in French for the MaterialsSearch Request.
Sample MaterialsSearch Response in French after update in English
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"searchInfo": {
"numberOfElements": "1",
"numberOfPages": "1"
},
"data": [
{
"locale": "fr",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01",
"contentManagedBy": "John Smith",
"lastUpdated": "2023-03-07T17:50:30Z",
"brand": {
"originId": "111fbedf-d293-44cf-9967-9e1e458d89c3",
"name": "Marqueuro incorporé (Branduro)",
"website": "www.branduro-2000.tld"
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
},
"company": {
"originId": "d0b95867-fc95-4c15-a76e-f2593e1dbab9",
"name": "Connecter (Connect)",
"companyType": "MANUFACTURER"
},
"category": {
"name": "Quincaillerie",
"code": "gc_36"
},
"images": [
{
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
}
],
"contacts": [
{
"type": "COMPANYHQ",
"name": "Contact",
"website": "connect.tld",
"phone": "+1-000-000-0000",
"email": "contact@connect.tld",
"location": {
"city": "Washington",
"region": "Washington, D.C.",
"country": "USA"
}
}
],
"featuresCustoms": [
{
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2020-04-01T04:00:00Z"
}
},
{
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "RED#ff0000",
"content": "Cherry red"
}
},
{
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "20"
}
},
{
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"originId": "5da6a9a9-aa35-4c8d-b982-d0545cc8868c",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"originId": "9b858095-ccc5-44cd-946b-a224228b8396",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"originId": "6c680bc9-21ef-48bd-8a8a-fc77df8fab1e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
},
{
"originId": "34ac6a27-dd8d-4fdf-9746-7306671b4d71",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"originId": "f30f01e0-bd48-4230-8978-ca7ac38f0e8f",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "cca0846b-6c02-4223-b2aa-f4af95a720de",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER",
"name": "cm"
}
},
{
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "20"
},
"unit": {
"code": "INCH",
"name": "pouces"
}
},
{
"originId": "0d00d21e-86d3-46a7-8773-6d75ee2a105e",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "BLUEDARK#00008b",
"content": "Bleu Foncé"
}
},
{
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge Foncé"
}
},
{
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"name": "Composition des matériaux",
"value": {
"code": "WOOD",
"content": "Bois"
}
},
{
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"name": "Note additionnelle",
"value": {
"content": "note_UPDATED"
}
},
{
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"name": "Propriétés ignifuges",
"value": {
"content": "A1_UPDATED"
}
},
{
"originId": "e71f637e-bd32-453f-8699-ce758c3d1492",
"code": "ENDOFLIFE",
"name": "Fin de vie",
"value": {
"content": "100 % recyclable"
}
},
{
"originId": "38289388-b8a9-41de-96e2-0dd1b5cd93ed",
"code": "PVC_FREE",
"name": "Sans PVC",
"value": {
"code": "YES",
"content": "Oui"
}
},
{
"originId": "e5334bd4-d828-4af0-8255-ce347db59e4c",
"code": "WARRANTY",
"name": "Garantie",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH",
"name": "Mois"
}
}
],
"skus": [
{
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_UPDATED",
"productId": "c-m-ml-01-sku01_UPDATED",
"featuresCustoms": [
{
"originId": "b4e95af5-044d-46a0-aaea-043b76f00749",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
},
{
"originId": "916e5b98-e16e-4bef-ad42-6bb24929f3b9",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"originId": "be83a526-46b5-4ab2-91cc-288edee3f84f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"originId": "b0ec6700-58bf-4569-9f21-256425c29cad",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "20"
}
},
{
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "RED#ff0000",
"content": "Cherry red"
}
},
{
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"originId": "ab1d2c24-9a0b-441e-a4bd-2767c12252f9",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2020-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "1251891b-fa77-4488-a37a-61fc4cbfe7a8",
"code": "WARRANTY",
"name": "Garantie",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH",
"name": "Mois"
}
},
{
"originId": "6b71d095-405b-4d28-9245-4e7df55a8be4",
"code": "PVC_FREE",
"name": "Sans PVC",
"value": {
"code": "YES",
"content": "Oui"
}
},
{
"originId": "a7dcbdfa-e3f7-4e8f-957b-3f9e0abfc88b",
"code": "ENDOFLIFE",
"name": "Fin de vie",
"value": {
"content": "100 % recyclable"
}
},
{
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"name": "Propriétés ignifuges",
"value": {
"content": "A1_UPDATED"
}
},
{
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"name": "Note additionnelle",
"value": {
"content": "note_UPDATED"
}
},
{
"originId": "22b653cc-bdfa-4278-b075-e08a1f527c7f",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER",
"name": "cm"
}
},
{
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "20"
},
"unit": {
"code": "INCH",
"name": "pouces"
}
},
{
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"name": "Composition des matériaux",
"value": {
"code": "WOOD",
"content": "Bois"
}
},
{
"originId": "18f2a9a6-aa8a-49a5-9ff5-4f7566a8a5b7",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "BLUEDARK#00008b",
"content": "Bleu Foncé"
}
},
{
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge Foncé"
}
}
]
},
{
"originId": "807f952a-d82a-4d5b-bec3-4e726ade1393",
"name": "C_M_ML_01 sku-02",
"productId": "c-m-ml-01-sku02"
}
],
"originUrl": "https://origin.build/#/material/f3668700-5f01-42b9-bd2c-73b82ac41af3?locale=fr"
}
]
},
"connectRequest": {
"locale": "fr",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
}
⚠️ Note 1 The materials[].name is not updated here, because the English translation is copied on the French translation after the publication and the translation doesn't fall back on the English translation, so an update in French is needed to update the materials[].name.
📝 Note 2 On custom features, the translatable feature names fall back on the English translation.
📝 Note 3 On custom features, the translatable feature values fall back on the English translation.
📝 Note 4 On property features, the translatable feature values fall back on the English translation.
📝 Note 5 On property features, the not translatable feature names, values* and units** are displayed in French.
⚠️ Note 6 The other values are displayed as is.
📝 Note 7 The sku1 name falls back on the English translation.
⚠️ Note 8 The sku1 productId is updated here, because it's a not translatable field and its update is applied on this language.
*If they are related to possibleValues 💡 See the possibleValues in PropertyDetailsLookup
**If they are related to possibleUnits 💡 See the possibleUnits in PropertyDetailsLookup
Step 5 Update in French
Which actions will be performed
- Update the material in French
- Locale :
fr - External id :
Connect_Material_Multilingual_01_External_Id(No change) - Update the Name to
Connect Material Multilingual 01_MIS_À_JOUR(The name will be updated only in French) - Update custom features
- Update the feature
Deepness (meter)_UPDATEDwith value20toProfondeur (mètre)with value30(The name will be updated only in French, but the value will be updated on all language) - Update the feature
Production date_UPDATEDwith value2020-04-01T04:00:00ZtoDate de productionwith value2021-04-01T04:00:00Z(The name will be updated only in French, but the value will be updated on all language) - Update the feature
Mineral density_UPDATEDwith valueDiamond_UPDATEDtoDensité minéralewith valueDiamant(The name and the value will be updated only in French) - Update the feature
A_UPDATEDwith valueX_UPDATEDtoA_MIS_À_JOURwith valueX_MIS_À_JOUR(The name and the value will be updated only in French) - Update the feature
Seat Color_UPDATEDwith the custom color nameCherry Redand mapped on the standard color Red (codeRED#ff0000) toCouleur de siègewith the custom color nameRouge ceriseand mapped on the standard color Dark Red (codeREDDARK#8b0000) (The name and the custom color name will be updated only in French, but the mapped color code will be updated on all language)
- Update the feature
- Update property features
- Update the feature Additional Notes with value
note_UPDATEDto Additional Notes with valuenote_MIS_À_JOUR(The value will be updated on all language) - Update the feature Length with value
20and the unit inches (codeINCH) to Length with value254and the unit mm (codeMILLIMETER) (The value and the unit will be updated on all language) - Update the feature Fire Rating with value
A1_UPDATEDto Fire Rating with valueA1_MIS_À_JOUR(The value will be updated only in French) - Update the feature Material Composition with value Wood (code
WOOD) to Material Composition with value Metal (codeMETAL) (The value will be updated on all language) - Update the feature Colour with value Dark Red (code
REDDARK#8b0000) to Colour with value Gold (codeGOLD#ffd700) (The value will be updated on all language)
- Update the feature Additional Notes with value
- Update one sku with
- Name:
C_M_ML_01 sku-01_MIS_À_JOUR(The name will be updated only in French) - Product id :
c-m-ml-01-sku01_MIS_À_JOUR(The product id will be updated on all language) - The same feature updates as the material
- Name:
- Locale :
Request URI
/connect/v2/materials/update
Sample MaterialsUpdate Request
{
"materials": [
{
"locale": "fr",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"name": "Connect Material Multilingual 01_MIS_À_JOUR",
"featuresCustoms": [
{
"collectionBehavior": "ADD",
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Profondeur (mètre)",
"value": {
"content": "30"
}
},
{
"collectionBehavior": "ADD",
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Date de production",
"value": {
"content": "2021-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Densité minérale",
"value": {
"content": "Diamant"
}
},
{
"collectionBehavior": "ADD",
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_MIS_À_JOUR",
"value": {
"content": "X_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Couleur de siège",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge cerise"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "ADD",
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER"
}
},
{
"collectionBehavior": "ADD",
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"value": {
"content": "A1_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"value": {
"code": "METAL"
}
},
{
"collectionBehavior": "ADD",
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"value": {
"code": "GOLD#ffd700"
}
}
],
"skus": [
{
"collectionBehavior": "ADD",
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_MIS_À_JOUR",
"productId": "c-m-ml-01-sku01_MIS_À_JOUR",
"featuresCustoms": [
{
"collectionBehavior": "ADD",
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Profondeur (mètre)",
"value": {
"content": "30"
}
},
{
"collectionBehavior": "ADD",
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Date de production",
"value": {
"content": "2021-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Densité minérale",
"value": {
"content": "Diamant"
}
},
{
"collectionBehavior": "ADD",
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_MIS_À_JOUR",
"value": {
"content": "X_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Couleur de siège",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge cerise"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "ADD",
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER"
}
},
{
"collectionBehavior": "ADD",
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"value": {
"content": "A1_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"value": {
"code": "METAL"
}
},
{
"collectionBehavior": "ADD",
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"value": {
"code": "GOLD#ffd700"
}
}
]
}
]
}
]
}
⚠️ Note If you want to update some sku fields, you need to add this "collectionBehavior": "ADD" to the sku.
Sample MaterialsUpdate Response
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"result": "Update completed."
},
"connectRequest": {
"materials": [
{
"locale": "fr",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"name": "Connect Material Multilingual 01_MIS_À_JOUR",
"featuresCustoms": [
{
"collectionBehavior": "ADD",
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Profondeur (mètre)",
"value": {
"content": "30"
}
},
{
"collectionBehavior": "ADD",
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Date de production",
"value": {
"content": "2021-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Densité minérale",
"value": {
"content": "Diamant"
}
},
{
"collectionBehavior": "ADD",
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_MIS_À_JOUR",
"value": {
"content": "X_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Couleur de siège",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge cerise"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "ADD",
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER"
}
},
{
"collectionBehavior": "ADD",
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"value": {
"content": "A1_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"value": {
"code": "METAL"
}
},
{
"collectionBehavior": "ADD",
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"value": {
"code": "GOLD#ffd700"
}
}
],
"skus": [
{
"collectionBehavior": "ADD",
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_MIS_À_JOUR",
"productId": "c-m-ml-01-sku01_MIS_À_JOUR",
"featuresCustoms": [
{
"collectionBehavior": "ADD",
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Profondeur (mètre)",
"value": {
"content": "30"
}
},
{
"collectionBehavior": "ADD",
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Date de production",
"value": {
"content": "2021-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "ADD",
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Densité minérale",
"value": {
"content": "Diamant"
}
},
{
"collectionBehavior": "ADD",
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_MIS_À_JOUR",
"value": {
"content": "X_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Couleur de siège",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge cerise"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "ADD",
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER"
}
},
{
"collectionBehavior": "ADD",
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"value": {
"content": "A1_MIS_À_JOUR"
}
},
{
"collectionBehavior": "ADD",
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"value": {
"code": "METAL"
}
},
{
"collectionBehavior": "ADD",
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"value": {
"code": "GOLD#ffd700"
}
}
]
}
]
}
]
}
}
Step 6 Update in French Validation (Optional)
Which actions will be performed
- Validate the French updates in English
- Validate the French updates in French
Request URI
/connect/v2/materials/search
See Step 2 Sample MaterialsSearch Request in English for the MaterialsSearch Request.
Sample MaterialsSearch Response in English after update in French
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"searchInfo": {
"numberOfElements": "1",
"numberOfPages": "1"
},
"data": [
{
"locale": "en",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01_UPDATED",
"contentManagedBy": "John Smith",
"lastUpdated": "2023-03-07T18:04:13Z",
"brand": {
"originId": "111fbedf-d293-44cf-9967-9e1e458d89c3",
"name": "Branduro inc.",
"website": "www.branduro-2000.tld"
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
},
"company": {
"originId": "d0b95867-fc95-4c15-a76e-f2593e1dbab9",
"name": "Connect",
"companyType": "MANUFACTURER"
},
"category": {
"name": "Hardware",
"code": "gc_36"
},
"images": [
{
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
}
],
"contacts": [
{
"type": "COMPANYHQ",
"name": "Contact",
"website": "connect.tld",
"phone": "+1-000-000-0000",
"email": "contact@connect.tld",
"location": {
"city": "Washington, D.C.",
"region": "Washington, D.C.",
"country": "United States"
}
}
],
"featuresCustoms": [
{
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2021-04-01T04:00:00Z"
}
},
{
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "REDDARK#8b0000",
"content": "Cherry red"
}
},
{
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "30"
}
},
{
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"originId": "5da6a9a9-aa35-4c8d-b982-d0545cc8868c",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"originId": "9b858095-ccc5-44cd-946b-a224228b8396",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"originId": "6c680bc9-21ef-48bd-8a8a-fc77df8fab1e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
},
{
"originId": "34ac6a27-dd8d-4fdf-9746-7306671b4d71",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"originId": "f30f01e0-bd48-4230-8978-ca7ac38f0e8f",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "cca0846b-6c02-4223-b2aa-f4af95a720de",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER",
"name": "cm"
}
},
{
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER",
"name": "mm"
}
},
{
"originId": "0d00d21e-86d3-46a7-8773-6d75ee2a105e",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "BLUEDARK#00008b",
"content": "Dark Blue"
}
},
{
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "GOLD#ffd700",
"content": "Gold"
}
},
{
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"name": "Material Composition",
"value": {
"code": "METAL",
"content": "Metal"
}
},
{
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"name": "Additional Notes",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"name": "Fire Rating",
"value": {
"content": "A1_UPDATED"
}
},
{
"originId": "e71f637e-bd32-453f-8699-ce758c3d1492",
"code": "ENDOFLIFE",
"name": "End of Life",
"value": {
"content": "100 % recyclable"
}
},
{
"originId": "38289388-b8a9-41de-96e2-0dd1b5cd93ed",
"code": "PVC_FREE",
"name": "PVC free",
"value": {
"code": "YES",
"content": "Yes"
}
},
{
"originId": "e5334bd4-d828-4af0-8255-ce347db59e4c",
"code": "WARRANTY",
"name": "Warranty",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH",
"name": "Months"
}
}
],
"skus": [
{
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_UPDATED",
"productId": "c-m-ml-01-sku01_MIS_À_JOUR",
"featuresCustoms": [
{
"originId": "b4e95af5-044d-46a0-aaea-043b76f00749",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
},
{
"originId": "916e5b98-e16e-4bef-ad42-6bb24929f3b9",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"originId": "be83a526-46b5-4ab2-91cc-288edee3f84f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"originId": "b0ec6700-58bf-4569-9f21-256425c29cad",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "30"
}
},
{
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "REDDARK#8b0000",
"content": "Cherry red"
}
},
{
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"originId": "ab1d2c24-9a0b-441e-a4bd-2767c12252f9",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2021-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "1251891b-fa77-4488-a37a-61fc4cbfe7a8",
"code": "WARRANTY",
"name": "Warranty",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH",
"name": "Months"
}
},
{
"originId": "6b71d095-405b-4d28-9245-4e7df55a8be4",
"code": "PVC_FREE",
"name": "PVC free",
"value": {
"code": "YES",
"content": "Yes"
}
},
{
"originId": "a7dcbdfa-e3f7-4e8f-957b-3f9e0abfc88b",
"code": "ENDOFLIFE",
"name": "End of Life",
"value": {
"content": "100 % recyclable"
}
},
{
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"name": "Fire Rating",
"value": {
"content": "A1_UPDATED"
}
},
{
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"name": "Additional Notes",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"originId": "22b653cc-bdfa-4278-b075-e08a1f527c7f",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER",
"name": "cm"
}
},
{
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER",
"name": "mm"
}
},
{
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"name": "Material Composition",
"value": {
"code": "METAL",
"content": "Metal"
}
},
{
"originId": "18f2a9a6-aa8a-49a5-9ff5-4f7566a8a5b7",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "BLUEDARK#00008b",
"content": "Dark Blue"
}
},
{
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "GOLD#ffd700",
"content": "Gold"
}
}
]
},
{
"originId": "807f952a-d82a-4d5b-bec3-4e726ade1393",
"name": "C_M_ML_01 sku-02",
"productId": "c-m-ml-01-sku02"
}
],
"originUrl": "https://origin.build/#/material/f3668700-5f01-42b9-bd2c-73b82ac41af3?locale=en"
}
]
},
"connectRequest": {
"locale": "en",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
}
📝 Note 1 The material[].name is not updated here, because the update is applied only on the French translation.
📝 Note 2 The feature name Deepness (meter)_UPDATED is not updated here, because the update is applied only on the French translation, but the value is updated.
📝 Note 3 The feature name Production date_UPDATED is not updated here, because the update is applied only on the French translation, but the value is updated.
📝 Note 4 The feature name Mineral density_UPDATED and the feature value Diamond_UPDATED are not updated here, because the update is applied only on the French translations.
📝 Note 5 The feature name A_UPDATED and the feature value X_UPDATED are not updated here, because the update is applied only on the French translations.
⚠️ Note 6 The feature name Seat Color_UPDATED and the custom color name Cherry Red are not updated here, because the update is applied only on the French translations, but the mapped color code is updated.
⚠️ Note 7 The Additional Notes value is updated.
⚠️ Note 8 The Length value and unit are updated.
📝 Note 9 The Fire Rating value A1_UPDATED is not updated here, because the update is applied only on the French translation.
⚠️ Note 10 The Material Composition value is updated.
⚠️ Note 11 The Colour value Dark Red (code REDDARK#8b0000) is updated to Gold (code GOLD#ffd700).
📝 Note 12 The sku1 name is not updated here, because the update is applied only on the French translation.
⚠️ Note 13 The sku1 productId is updated here, because it's a not translatable field and its update is applied on this language.
See Step 2 Sample MaterialsSearch Request in French for the MaterialsSearch Request.
Sample MaterialsSearch Response in French after update in French
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"searchInfo": {
"numberOfElements": "1",
"numberOfPages": "1"
},
"data": [
{
"locale": "fr",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01_MIS_À_JOUR",
"contentManagedBy": "John Smith",
"lastUpdated": "2023-03-07T18:04:13Z",
"brand": {
"originId": "111fbedf-d293-44cf-9967-9e1e458d89c3",
"name": "Marqueuro incorporé (Branduro)",
"website": "www.branduro-2000.tld"
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
},
"company": {
"originId": "d0b95867-fc95-4c15-a76e-f2593e1dbab9",
"name": "Connecter (Connect)",
"companyType": "MANUFACTURER"
},
"category": {
"name": "Quincaillerie",
"code": "gc_36"
},
"images": [
{
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
}
],
"contacts": [
{
"type": "COMPANYHQ",
"name": "Contact",
"website": "connect.tld",
"phone": "+1-000-000-0000",
"email": "contact@connect.tld",
"location": {
"city": "Washington",
"region": "Washington, D.C.",
"country": "USA"
}
}
],
"featuresCustoms": [
{
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Date de production",
"value": {
"content": "2021-04-01T04:00:00Z"
}
},
{
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Couleur de siège",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge cerise"
}
},
{
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Densité minérale",
"value": {
"content": "Diamant"
}
},
{
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Profondeur (mètre)",
"value": {
"content": "30"
}
},
{
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_MIS_À_JOUR",
"value": {
"content": "X_MIS_À_JOUR"
}
},
{
"originId": "5da6a9a9-aa35-4c8d-b982-d0545cc8868c",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"originId": "9b858095-ccc5-44cd-946b-a224228b8396",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"originId": "6c680bc9-21ef-48bd-8a8a-fc77df8fab1e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
},
{
"originId": "34ac6a27-dd8d-4fdf-9746-7306671b4d71",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"originId": "f30f01e0-bd48-4230-8978-ca7ac38f0e8f",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "cca0846b-6c02-4223-b2aa-f4af95a720de",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER",
"name": "cm"
}
},
{
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER",
"name": "mm"
}
},
{
"originId": "0d00d21e-86d3-46a7-8773-6d75ee2a105e",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "BLUEDARK#00008b",
"content": "Bleu Foncé"
}
},
{
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "GOLD#ffd700",
"content": "Or"
}
},
{
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"name": "Composition des matériaux",
"value": {
"code": "METAL",
"content": "Métal"
}
},
{
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"name": "Note additionnelle",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"name": "Propriétés ignifuges",
"value": {
"content": "A1_MIS_À_JOUR"
}
},
{
"originId": "e71f637e-bd32-453f-8699-ce758c3d1492",
"code": "ENDOFLIFE",
"name": "Fin de vie",
"value": {
"content": "100 % recyclable"
}
},
{
"originId": "38289388-b8a9-41de-96e2-0dd1b5cd93ed",
"code": "PVC_FREE",
"name": "Sans PVC",
"value": {
"code": "YES",
"content": "Oui"
}
},
{
"originId": "e5334bd4-d828-4af0-8255-ce347db59e4c",
"code": "WARRANTY",
"name": "Garantie",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH",
"name": "Mois"
}
}
],
"skus": [
{
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_MIS_À_JOUR",
"productId": "c-m-ml-01-sku01_MIS_À_JOUR",
"featuresCustoms": [
{
"originId": "b4e95af5-044d-46a0-aaea-043b76f00749",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
},
{
"originId": "916e5b98-e16e-4bef-ad42-6bb24929f3b9",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"originId": "be83a526-46b5-4ab2-91cc-288edee3f84f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"originId": "b0ec6700-58bf-4569-9f21-256425c29cad",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_MIS_À_JOUR",
"value": {
"content": "X_MIS_À_JOUR"
}
},
{
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Profondeur (mètre)",
"value": {
"content": "30"
}
},
{
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Couleur de siège",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge cerise"
}
},
{
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Densité minérale",
"value": {
"content": "Diamant"
}
},
{
"originId": "ab1d2c24-9a0b-441e-a4bd-2767c12252f9",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Date de production",
"value": {
"content": "2021-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "1251891b-fa77-4488-a37a-61fc4cbfe7a8",
"code": "WARRANTY",
"name": "Garantie",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH",
"name": "Mois"
}
},
{
"originId": "6b71d095-405b-4d28-9245-4e7df55a8be4",
"code": "PVC_FREE",
"name": "Sans PVC",
"value": {
"code": "YES",
"content": "Oui"
}
},
{
"originId": "a7dcbdfa-e3f7-4e8f-957b-3f9e0abfc88b",
"code": "ENDOFLIFE",
"name": "Fin de vie",
"value": {
"content": "100 % recyclable"
}
},
{
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"name": "Propriétés ignifuges",
"value": {
"content": "A1_MIS_À_JOUR"
}
},
{
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"name": "Note additionnelle",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"originId": "22b653cc-bdfa-4278-b075-e08a1f527c7f",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER",
"name": "cm"
}
},
{
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER",
"name": "mm"
}
},
{
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"name": "Composition des matériaux",
"value": {
"code": "METAL",
"content": "Métal"
}
},
{
"originId": "18f2a9a6-aa8a-49a5-9ff5-4f7566a8a5b7",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "BLUEDARK#00008b",
"content": "Bleu Foncé"
}
},
{
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "GOLD#ffd700",
"content": "Or"
}
}
]
},
{
"originId": "807f952a-d82a-4d5b-bec3-4e726ade1393",
"name": "C_M_ML_01 sku-02",
"productId": "c-m-ml-01-sku02"
}
],
"originUrl": "https://origin.build/#/material/f3668700-5f01-42b9-bd2c-73b82ac41af3?locale=fr"
}
]
},
"connectRequest": {
"locale": "fr",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
}
📝 Note 1 The material[].name is updated here, because the update is applied only on the French translation.
📝 Note 2 The feature name Profondeur (mètre) is updated here, because the update is applied only on the French translation, and the value is updated too.
📝 Note 3 The feature name Date de production is updated here, because the update is applied only on the French translation, and the value is updated too.
📝 Note 4 The feature name Densité minérale and the feature value Diamant are updated here, because the update is applied only on the French translations.
📝 Note 5 The feature name A_MIS_À_JOUR and the feature value X_MIS_À_JOUR are updated here, because the update is applied only on the French translations.
📝 Note 6 The feature name Couleur de siège and the custom color name Rouge cerise are updated here, because the update is applied only on the French translations, but the mapped color code is updated.
📝 Note 7 The Additional Notes value is updated.
📝 Note 8 The Length value and unit are updated.
📝 Note 9 The Fire Rating value A1_MIS_À_JOUR is updated here, because the update is applied only on the French translation.
📝 Note 10 The Material Composition value is updated.
📝 Note 11 The Colour value Dark Red (code REDDARK#8b0000) is updated to Gold (code GOLD#ffd700).
📝 Note 12 The sku1 name is updated here, because the update is applied only on the French translation.
📝 Note 13 The sku1 productId is updated here, because it's a not translatable field and its update is applied on this language.
Step 7 Update (remove features) in English
Which actions will be performed
- Update the material in English
- Locale :
en(⚠️ It's highly recommanded that you update your entity in English first ("locale": "en"). The majority of users use this language and it's used as fallback language.) - External id :
Connect_Material_Multilingual_01_External_Id - Remove custom features
- Custom Numeric Attribute (code
CUSTOM_NUMERIC_ATTRIBUTE) namedCircumference (meter)with value31.416 - Custom Date Attribute (code
CUSTOM_DATE_ATTRIBUTE) namedEnd of Production datewith value2030-04-01T04:00:00Z - Custom Text Attribute (code
CUSTOM_TEXT_ATTRIBUTE) namedRock Categorywith valueMetamorphic - Custom Text Attribute (code
CUSTOM_TEXT_ATTRIBUTE) namedAwith valueY - Custom Color Attribute (code
CUSTOM_COLOR_ATTRIBUTE) NamedDoor Colorwith the custom color nameWhite Eggand mapped on the standard color White (codeWHITE#ffffff)
- Custom Numeric Attribute (code
- Remove property features
- Warranty (code
WARRANTY) with value13and the unit months (codeMONTH) - Length (code
LENGTH) with value25and the unit cm (codeCENTIMETER) - End of Life (code
ENDOFLIFE) with value100 % recyclable - PVC free (code
PVC_FREE) with value Yes (codeYES) - Colour (code
COLOR) with value Dark Blue (codeBLUEDARK#00008b)
- Warranty (code
- Update one sku with
- Name:
C_M_ML_01 sku-01_UPDATED - Remove the same features as the material
- Name:
- Locale :
Request URI
/connect/v2/materials/update
Sample MaterialsUpdate Request
{
"materials": [
{
"locale": "en",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"featuresCustoms": [
{
"collectionBehavior": "REMOVE",
"originId": "34ac6a27-dd8d-4fdf-9746-7306671b4d71",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "f30f01e0-bd48-4230-8978-ca7ac38f0e8f",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "9b858095-ccc5-44cd-946b-a224228b8396",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "5da6a9a9-aa35-4c8d-b982-d0545cc8868c",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "6c680bc9-21ef-48bd-8a8a-fc77df8fab1e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "REMOVE",
"originId": "e5334bd4-d828-4af0-8255-ce347db59e4c",
"code": "WARRANTY",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "cca0846b-6c02-4223-b2aa-f4af95a720de",
"code": "LENGTH",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "e71f637e-bd32-453f-8699-ce758c3d1492",
"code": "ENDOFLIFE",
"value": {
"content": "100 % recyclable"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "38289388-b8a9-41de-96e2-0dd1b5cd93ed",
"code": "PVC_FREE",
"value": {
"code": "YES"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "0d00d21e-86d3-46a7-8773-6d75ee2a105e",
"code": "COLOR",
"value": {
"code": "BLUEDARK#00008b"
}
}
],
"skus": [
{
"collectionBehavior": "ADD",
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_UPDATED",
"featuresCustoms": [
{
"collectionBehavior": "REMOVE",
"originId": "34ac6a27-dd8d-4fdf-9746-7306671b4d71",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "f30f01e0-bd48-4230-8978-ca7ac38f0e8f",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "9b858095-ccc5-44cd-946b-a224228b8396",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "ab1d2c24-9a0b-441e-a4bd-2767c12252f9",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "6c680bc9-21ef-48bd-8a8a-fc77df8fab1e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "REMOVE",
"originId": "e5334bd4-d828-4af0-8255-ce347db59e4c",
"code": "WARRANTY",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "cca0846b-6c02-4223-b2aa-f4af95a720de",
"code": "LENGTH",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "e71f637e-bd32-453f-8699-ce758c3d1492",
"code": "ENDOFLIFE",
"value": {
"content": "100 % recyclable"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "38289388-b8a9-41de-96e2-0dd1b5cd93ed",
"code": "PVC_FREE",
"value": {
"code": "YES"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "0d00d21e-86d3-46a7-8773-6d75ee2a105e",
"code": "COLOR",
"value": {
"code": "BLUEDARK#00008b"
}
}
]
}
]
}
]
}
⚠️ Note If you want to update some sku fields, you need to add this "collectionBehavior": "ADD" to the sku.
Sample MaterialsUpdate Response
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"result": "Update completed."
},
"connectRequest": {
"materials": [
{
"locale": "en",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"featuresCustoms": [
{
"collectionBehavior": "REMOVE",
"originId": "34ac6a27-dd8d-4fdf-9746-7306671b4d71",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "f30f01e0-bd48-4230-8978-ca7ac38f0e8f",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "9b858095-ccc5-44cd-946b-a224228b8396",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "5da6a9a9-aa35-4c8d-b982-d0545cc8868c",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "6c680bc9-21ef-48bd-8a8a-fc77df8fab1e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "REMOVE",
"originId": "e5334bd4-d828-4af0-8255-ce347db59e4c",
"code": "WARRANTY",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "cca0846b-6c02-4223-b2aa-f4af95a720de",
"code": "LENGTH",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "e71f637e-bd32-453f-8699-ce758c3d1492",
"code": "ENDOFLIFE",
"value": {
"content": "100 % recyclable"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "38289388-b8a9-41de-96e2-0dd1b5cd93ed",
"code": "PVC_FREE",
"value": {
"code": "YES"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "0d00d21e-86d3-46a7-8773-6d75ee2a105e",
"code": "COLOR",
"value": {
"code": "BLUEDARK#00008b"
}
}
],
"skus": [
{
"collectionBehavior": "ADD",
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_UPDATED",
"featuresCustoms": [
{
"collectionBehavior": "REMOVE",
"originId": "34ac6a27-dd8d-4fdf-9746-7306671b4d71",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Circumference (meter)",
"value": {
"content": "31.416"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "f30f01e0-bd48-4230-8978-ca7ac38f0e8f",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "End of Production date",
"value": {
"content": "2030-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "9b858095-ccc5-44cd-946b-a224228b8396",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Rock Category",
"value": {
"content": "Metamorphic"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "ab1d2c24-9a0b-441e-a4bd-2767c12252f9",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A",
"value": {
"content": "Y"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "6c680bc9-21ef-48bd-8a8a-fc77df8fab1e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Door Color",
"value": {
"code": "WHITE#ffffff",
"content": "White Egg"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "REMOVE",
"originId": "e5334bd4-d828-4af0-8255-ce347db59e4c",
"code": "WARRANTY",
"value": {
"content": "13"
},
"unit": {
"code": "MONTH"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "cca0846b-6c02-4223-b2aa-f4af95a720de",
"code": "LENGTH",
"value": {
"content": "25"
},
"unit": {
"code": "CENTIMETER"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "e71f637e-bd32-453f-8699-ce758c3d1492",
"code": "ENDOFLIFE",
"value": {
"content": "100 % recyclable"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "38289388-b8a9-41de-96e2-0dd1b5cd93ed",
"code": "PVC_FREE",
"value": {
"code": "YES"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "0d00d21e-86d3-46a7-8773-6d75ee2a105e",
"code": "COLOR",
"value": {
"code": "BLUEDARK#00008b"
}
}
]
}
]
}
]
}
}
Step 8 Update (remove features) in English Validation (Optional)
Which actions will be performed
- Validate the English updates in English
- Validate the English updates in French
Request URI
/connect/v2/materials/search
See Step 2 Sample MaterialsSearch Request in English for the MaterialsSearch Request.
Sample MaterialsSearch Response in English after update (remove features) in English
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"searchInfo": {
"numberOfElements": "1",
"numberOfPages": "1"
},
"data": [
{
"locale": "en",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01_UPDATED",
"contentManagedBy": "John Smith",
"lastUpdated": "2023-03-07T18:26:56Z",
"brand": {
"originId": "111fbedf-d293-44cf-9967-9e1e458d89c3",
"name": "Branduro inc.",
"website": "www.branduro-2000.tld"
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
},
"company": {
"originId": "d0b95867-fc95-4c15-a76e-f2593e1dbab9",
"name": "Connect",
"companyType": "MANUFACTURER"
},
"category": {
"name": "Hardware",
"code": "gc_36"
},
"images": [
{
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
}
],
"contacts": [
{
"type": "COMPANYHQ",
"name": "Contact",
"website": "connect.tld",
"phone": "+1-000-000-0000",
"email": "contact@connect.tld",
"location": {
"city": "Washington, D.C.",
"region": "Washington, D.C.",
"country": "United States"
}
}
],
"featuresCustoms": [
{
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2021-04-01T04:00:00Z"
}
},
{
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "REDDARK#8b0000",
"content": "Cherry red"
}
},
{
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "30"
}
},
{
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
}
],
"featuresProperties": [
{
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER",
"name": "mm"
}
},
{
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "GOLD#ffd700",
"content": "Gold"
}
},
{
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"name": "Material Composition",
"value": {
"code": "METAL",
"content": "Metal"
}
},
{
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"name": "Additional Notes",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"name": "Fire Rating",
"value": {
"content": "A1_UPDATED"
}
}
],
"skus": [
{
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_UPDATED",
"productId": "c-m-ml-01-sku01_MIS_À_JOUR",
"featuresCustoms": [
{
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_UPDATED",
"value": {
"content": "X_UPDATED"
}
},
{
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Deepness (meter)_UPDATED",
"value": {
"content": "30"
}
},
{
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Seat Color_UPDATED",
"value": {
"code": "REDDARK#8b0000",
"content": "Cherry red"
}
},
{
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Mineral density_UPDATED",
"value": {
"content": "Diamond_UPDATED"
}
},
{
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Production date_UPDATED",
"value": {
"content": "2021-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"name": "Fire Rating",
"value": {
"content": "A1_UPDATED"
}
},
{
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"name": "Additional Notes",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"name": "Length",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER",
"name": "mm"
}
},
{
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"name": "Material Composition",
"value": {
"code": "METAL",
"content": "Metal"
}
},
{
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"name": "Colour",
"value": {
"code": "GOLD#ffd700",
"content": "Gold"
}
}
]
},
{
"originId": "807f952a-d82a-4d5b-bec3-4e726ade1393",
"name": "C_M_ML_01 sku-02",
"productId": "c-m-ml-01-sku02"
}
],
"originUrl": "https://origin.build/#/material/f3668700-5f01-42b9-bd2c-73b82ac41af3?locale=en"
}
]
},
"connectRequest": {
"locale": "en",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
}
📝 Note All features with the collectionBehavior set to REMOVE have been removed.
See Step 2 Sample MaterialsSearch Request in French for the MaterialsSearch Request.
Sample MaterialsSearch Response in French after update (remove features) in English
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"searchInfo": {
"numberOfElements": "1",
"numberOfPages": "1"
},
"data": [
{
"locale": "fr",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01_MIS_À_JOUR",
"contentManagedBy": "John Smith",
"lastUpdated": "2023-03-07T18:26:56Z",
"brand": {
"originId": "111fbedf-d293-44cf-9967-9e1e458d89c3",
"name": "Marqueuro incorporé (Branduro)",
"website": "www.branduro-2000.tld"
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
},
"company": {
"originId": "d0b95867-fc95-4c15-a76e-f2593e1dbab9",
"name": "Connecter (Connect)",
"companyType": "MANUFACTURER"
},
"category": {
"name": "Quincaillerie",
"code": "gc_36"
},
"images": [
{
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
}
],
"contacts": [
{
"type": "COMPANYHQ",
"name": "Contact",
"website": "connect.tld",
"phone": "+1-000-000-0000",
"email": "contact@connect.tld",
"location": {
"city": "Washington",
"region": "Washington, D.C.",
"country": "USA"
}
}
],
"featuresCustoms": [
{
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Date de production",
"value": {
"content": "2021-04-01T04:00:00Z"
}
},
{
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Couleur de siège",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge cerise"
}
},
{
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Densité minérale",
"value": {
"content": "Diamant"
}
},
{
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Profondeur (mètre)",
"value": {
"content": "30"
}
},
{
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_MIS_À_JOUR",
"value": {
"content": "X_MIS_À_JOUR"
}
}
],
"featuresProperties": [
{
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER",
"name": "mm"
}
},
{
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "GOLD#ffd700",
"content": "Or"
}
},
{
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"name": "Composition des matériaux",
"value": {
"code": "METAL",
"content": "Métal"
}
},
{
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"name": "Note additionnelle",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"name": "Propriétés ignifuges",
"value": {
"content": "A1_MIS_À_JOUR"
}
}
],
"skus": [
{
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_MIS_À_JOUR",
"productId": "c-m-ml-01-sku01_MIS_À_JOUR",
"featuresCustoms": [
{
"originId": "40254516-f360-4998-8619-cfa231ef703f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_MIS_À_JOUR",
"value": {
"content": "X_MIS_À_JOUR"
}
},
{
"originId": "b955c4cb-0d45-4385-a82d-d1c18818784b",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Profondeur (mètre)",
"value": {
"content": "30"
}
},
{
"originId": "c307e45a-bc21-46fe-a5e4-c8e28d99cff0",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Couleur de siège",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge cerise"
}
},
{
"originId": "8ef7b72f-745e-47fe-85f1-07a01ab1416f",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Densité minérale",
"value": {
"content": "Diamant"
}
},
{
"originId": "cc09dc98-d96c-48f3-8a84-8946423cdab6",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Date de production",
"value": {
"content": "2021-04-01T04:00:00Z"
}
}
],
"featuresProperties": [
{
"originId": "dda6f2e2-9b54-4d11-a64f-0b6ec227ddf5",
"code": "FIRERATING",
"name": "Propriétés ignifuges",
"value": {
"content": "A1_MIS_À_JOUR"
}
},
{
"originId": "5090d3c5-9dc6-4275-b181-f787a374d8a6",
"code": "MM_ADD_NOTES",
"name": "Note additionnelle",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"originId": "4ed82574-fa1a-4ed4-bc90-4b3211062784",
"code": "LENGTH",
"name": "Longueur",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER",
"name": "mm"
}
},
{
"originId": "ccb02e6b-85b4-4615-b689-d76b04b7e7ff",
"code": "MATERIAL_TYPE",
"name": "Composition des matériaux",
"value": {
"code": "METAL",
"content": "Métal"
}
},
{
"originId": "c4756f31-6089-4657-8cc5-524fb929a3bb",
"code": "COLOR",
"name": "Couleur",
"value": {
"code": "GOLD#ffd700",
"content": "Or"
}
}
]
},
{
"originId": "807f952a-d82a-4d5b-bec3-4e726ade1393",
"name": "C_M_ML_01 sku-02",
"productId": "c-m-ml-01-sku02"
}
],
"originUrl": "https://origin.build/#/material/f3668700-5f01-42b9-bd2c-73b82ac41af3?locale=fr"
}
]
},
"connectRequest": {
"locale": "fr",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
}
📝 Note All features with the collectionBehavior set to REMOVE have been removed.
Step 9 Update (remove features) in French
Which actions will be performed
- Update the material in French
- Locale :
fr - External id :
Connect_Material_Multilingual_01_External_Id - Remove custom features
- Remove the feature
Profondeur (mètre)with value30 - Remove the feature
Date de productionwith value2021-04-01T04:00:00Z - Remove the feature
Densité minéralewith valueDiamant - Remove the feature
A_MIS_À_JOURwith valueX_MIS_À_JOUR - Remove the feature
Couleur de siègewith the custom color nameRouge ceriseand mapped on the standard color Dark Red (codeREDDARK#8b0000)
- Remove the feature
- Remove property features
- Remove the feature Additional Notes with value
note_MIS_À_JOUR - Remove the feature Length with value
254and the unit mm (codeMILLIMETER) - Remove the feature Fire Rating with value
A1_MIS_À_JOUR - Remove the feature Material Composition with value Metal (code
METAL) - Remove the feature Colour with value Gold (code
GOLD#ffd700)
- Remove the feature Additional Notes with value
- Remove all skus
- Locale :
Request URI
/connect/v2/materials/update
Sample MaterialsUpdate Request
{
"materials": [
{
"locale": "fr",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"name": "Connect Material Multilingual 01_MIS_À_JOUR",
"featuresCustoms": [
{
"collectionBehavior": "REMOVE",
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Profondeur (mètre)",
"value": {
"content": "30"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Date de production",
"value": {
"content": "2021-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Densité minérale",
"value": {
"content": "Diamant"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_MIS_À_JOUR",
"value": {
"content": "X_MIS_À_JOUR"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Couleur de siège",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge cerise"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "REMOVE",
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"value": {
"content": "A1_MIS_À_JOUR"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"value": {
"code": "METAL"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"value": {
"code": "GOLD#ffd700"
}
}
],
"skus": [
{
"collectionBehavior": "REMOVE",
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_MIS_À_JOUR"
},
{
"collectionBehavior": "REMOVE",
"originId": "807f952a-d82a-4d5b-bec3-4e726ade1393",
"name": "C_M_ML_01 sku-02"
}
]
}
]
}
📝 Note Removing a sku remove all its sub fields.
Sample MaterialsUpdate Response
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"result": "Update completed."
},
"connectRequest": {
"materials": [
{
"locale": "fr",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"name": "Connect Material Multilingual 01_MIS_À_JOUR",
"featuresCustoms": [
{
"collectionBehavior": "REMOVE",
"originId": "10995375-87f1-4bdb-9d2d-c72bcc2b2e99",
"code": "CUSTOM_NUMERIC_ATTRIBUTE",
"name": "Profondeur (mètre)",
"value": {
"content": "30"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "2045864d-bf37-4ba2-9f07-3b8463cc0912",
"code": "CUSTOM_DATE_ATTRIBUTE",
"name": "Date de production",
"value": {
"content": "2021-04-01T04:00:00Z"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "dc39cb08-4f7a-460d-bc9a-bc2c6f6776d7",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "Densité minérale",
"value": {
"content": "Diamant"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "4635dd9a-8867-4c8a-a674-78a4c70da830",
"code": "CUSTOM_TEXT_ATTRIBUTE",
"name": "A_MIS_À_JOUR",
"value": {
"content": "X_MIS_À_JOUR"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "e3568f3c-072f-4e21-bf80-79e872bda98e",
"code": "CUSTOM_COLOR_ATTRIBUTE",
"name": "Couleur de siège",
"value": {
"code": "REDDARK#8b0000",
"content": "Rouge cerise"
}
}
],
"featuresProperties": [
{
"collectionBehavior": "REMOVE",
"originId": "29dcabf6-49e4-4876-858e-5f7be54c1f1d",
"code": "MM_ADD_NOTES",
"value": {
"content": "note_MIS_À_JOUR"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "37be5528-a2db-48dd-b045-f71a7c9868c0",
"code": "LENGTH",
"value": {
"content": "254"
},
"unit": {
"code": "MILLIMETER"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "7d17e0ad-fe0f-447b-ab40-e764abd773e6",
"code": "FIRERATING",
"value": {
"content": "A1_MIS_À_JOUR"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "41f08bec-7b34-452b-8609-4e2b0b84545b",
"code": "MATERIAL_TYPE",
"value": {
"code": "METAL"
}
},
{
"collectionBehavior": "REMOVE",
"originId": "da3c0548-4c78-457e-b3ca-6e24f7311c41",
"code": "COLOR",
"value": {
"code": "GOLD#ffd700"
}
}
],
"skus": [
{
"collectionBehavior": "REMOVE",
"originId": "e2b67a80-3d7e-4f1f-bac6-cdd4b4543684",
"name": "C_M_ML_01 sku-01_MIS_À_JOUR"
},
{
"collectionBehavior": "REMOVE",
"originId": "807f952a-d82a-4d5b-bec3-4e726ade1393",
"name": "C_M_ML_01 sku-02"
}
]
}
]
}
}
Step 10 Update (remove features) in French Validation (Optional)
Which actions will be performed
- Validate the French updates in English
- Validate the French updates in French
Request URI
/connect/v2/materials/search
See Step 2 Sample MaterialsSearch Request in English for the MaterialsSearch Request.
Sample MaterialsSearch Response in English after update (remove features) in French
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"searchInfo": {
"numberOfElements": "1",
"numberOfPages": "1"
},
"data": [
{
"locale": "en",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01_UPDATED",
"contentManagedBy": "John Smith",
"lastUpdated": "2023-03-07T18:37:43Z",
"brand": {
"originId": "111fbedf-d293-44cf-9967-9e1e458d89c3",
"name": "Branduro inc.",
"website": "www.branduro-2000.tld"
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
},
"company": {
"originId": "d0b95867-fc95-4c15-a76e-f2593e1dbab9",
"name": "Connect",
"companyType": "MANUFACTURER"
},
"category": {
"name": "Hardware",
"code": "gc_36"
},
"images": [
{
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
}
],
"contacts": [
{
"type": "COMPANYHQ",
"name": "Contact",
"website": "connect.tld",
"phone": "+1-000-000-0000",
"email": "contact@connect.tld",
"location": {
"city": "Washington, D.C.",
"region": "Washington, D.C.",
"country": "United States"
}
}
],
"originUrl": "https://origin.build/#/material/f3668700-5f01-42b9-bd2c-73b82ac41af3?locale=en"
}
]
},
"connectRequest": {
"locale": "en",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
}
📝 Note All features with the collectionBehavior set to REMOVE have been removed.
See Step 2 Sample MaterialsSearch Request in French for the MaterialsSearch Request.
Sample MaterialsSearch Response in French after update in (remove features) French
{
"status": {
"state": "SUCCESS"
},
"result": {
"entityType": "MATERIAL",
"searchInfo": {
"numberOfElements": "1",
"numberOfPages": "1"
},
"data": [
{
"locale": "fr",
"originId": "f3668700-5f01-42b9-bd2c-73b82ac41af3",
"externalId": "Connect_Material_Multilingual_01_External_Id",
"productId": "connect-material-multilingual-01-product-id",
"managementPermission": "COMPANY_EDITABLE",
"name": "Connect Material Multilingual 01_MIS_À_JOUR",
"contentManagedBy": "John Smith",
"lastUpdated": "2023-03-07T18:37:43Z",
"brand": {
"originId": "111fbedf-d293-44cf-9967-9e1e458d89c3",
"name": "Marqueuro incorporé (Branduro)",
"website": "www.branduro-2000.tld"
},
"logoUrl": {
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
},
"company": {
"originId": "d0b95867-fc95-4c15-a76e-f2593e1dbab9",
"name": "Connecter (Connect)",
"companyType": "MANUFACTURER"
},
"category": {
"name": "Quincaillerie",
"code": "gc_36"
},
"images": [
{
"originalUrl": "image.original.url/connect-file-1.png",
"referenceUrl": "https://origin.build/equinox/storage/public/connect-file-1.png"
}
],
"contacts": [
{
"type": "COMPANYHQ",
"name": "Contact",
"website": "connect.tld",
"phone": "+1-000-000-0000",
"email": "contact@connect.tld",
"location": {
"city": "Washington",
"region": "Washington, D.C.",
"country": "USA"
}
}
],
"originUrl": "https://origin.build/#/material/f3668700-5f01-42b9-bd2c-73b82ac41af3?locale=fr"
}
]
},
"connectRequest": {
"locale": "fr",
"pageNumber": "1",
"pageSize": "100",
"searchCriteria": [
{
"name": "ORIGINID",
"value": "f3668700-5f01-42b9-bd2c-73b82ac41af3"
}
]
}
}
📝 Note All features with the collectionBehavior set to REMOVE have been removed.