Update Digital Passport

Overview

Use cases

  • Update complete JSON Schema: Your brand wishes to fix issues and review the content.
  • Update JSON schema & metadata: Update digital passports' tag(s).
  • Update one JSON schema property: The URL of the external content you linked to a digital passport, such as a YouTube video, must be updated in the passport content and the tags.
  • Update extra-languages JSON schema:
    • Your brand wishes to provide additional language for the passport content.
    • Your brand wishes to update the content of an extra language of a digital passport to fix issues, review the content, or add additional information.
  • Remove one property in the JSON schema: Remove information in the content such as the product model.
  • Remove one property in extra-languages JSON schema: Remove information in the content such as the product model in an extra language such as French.

Update content & metadata

โš ๏ธ

Fields with multiple values

Example: If you defined two tags (tag1, tag2) while creating your digital passport, and udpate with a new one (tag3), the two previous ones will be erased. So if you wish to keep them all, update with tag1, tag2, tag3.

This works will all the fields that may have multiple values.

Update Complete JSON Schema

This request will update all the digital passport data, and erase all the existing fields of your digital passport.

URL

Required rights: admin or certCreate

To update the complete JSON schema of a target digital passport, use /productManagement/product/:productId/update.

PUT - https://{{nmpUrl}}/productManagement/product/:productId/update

๐Ÿ’ก

The update override all objects.

Body

{
	"name": "Omega",
  "model": "speedmaster",
  "subBrand": "sub brand",
  "description": "This is a watch",
  "category": "accessory",
  "sku": "SKU",
  "gtin": "gtin",
  "brandInternalId": "brand id",
  "intended": "womens",
  "manufacturingCountry": "SWISS",
  "facilityId": "234",
  "serialnumber": [
    {
      "type": "serialnumber",
      "value": "12324"
    }
  ],
  "attributes": [
    {
      "trait_type": "TRAIT",
      "type": "color",
      "value": "VALUE"
    }
  ]
}

Return Payload

FieldTypeDescription
successBooleanIndicates whether the request was successful.
dataObjectContains the full payload and the digital passport information.
{
    "success": true,
    "data": {
        "productGroupId": "productGroupID",
        "content": {
            "language": "en-US",
            "name": "product",
            "sku": "NAC-BB-LS20-06",
            "gtin": "0 00 12345 60001 2",
            "brandInternalId": "NYC12345",
            "category": "apparel",
            "subCategory": "watch",
            "intended": "womens",
            "serialnumber": [
                {
                    "type": "serialnumber",
                    "value": "DEMO#001"
                },
                {
                    "type": "casenumber",
                    "value": "Cas pratique"
                },
                {
                    "type": "movementnumber",
                    "value": "85QR18 [demo]"
                }
            ],
            "subBrand": "Arianee watches",
            "model": "Limited serie 2020",
            "description": "<b>Description</b>\nThe Navyclock by Arianee watch, small model, quartz movement. Case in 18k pink gold, beaded crown in 18k pink gold set with a synthetic cabochon-shaped spinel, strap in leather. \n\n<b>Case dimensions</b>\ndiameter: 29.5 mm, thickness: 6.35 mm, water-resistant to 3 bar (approx. 30 meters/100 feet).",
            "subDescription": [
                {
                    "type": "other",
                    "title": "The Navyclock watchmaking process",
                    "content": "The Navyclock preserves the perfectly pitched classical elegance and signature Arianee features. The brand has been producing its own in-house movements since 2017. The movements boast a host of features but are designed to be thin by incorporating various complications into the mainplate."
                },
                {
                    "type": "service",
                    "title": "Customer service information",
                    "content": "The Navyclock is rarely down. When it happens you can be sure our network will be here for you. "
                }
            ],
            "externalContents": [
                {
                    "type": "website",
                    "title": "Website",
                    "url": "https://www.arianee.org/"
                },
                {
                    "type": "website",
                    "title": "About Arianee",
                    "url": "https://www.arianee.org/about-arianee"
                },
                {
                    "type": "website",
                    "title": "History of Watches",
                    "url": "https://en.wikipedia.org/wiki/History_of_watches"
                },
                {
                    "type": "proofLinkAction",
                    "title": "Link with a proof of ownership",
                    "url": "https://test.arian.ee/proofLinkAction.html"
                }
            ],
            "msrp": [
                {
                    "msrp": "35000",
                    "currency": "EUR",
                    "msrpCountry": "Europe"
                },
                {
                    "msrp": "32000",
                    "currency": "GBP",
                    "msrpCountry": "United Kingdom"
                },
                {
                    "msrp": "40000",
                    "currency": "USD",
                    "msrpCountry": "USA"
                }
            ],
            "medias": [
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-Lzfbb6qGXMN3LVhPRWG_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LzfbcJwhZPNES_2NK1h_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LzfbdNMkhOxvu5n_cPv_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "brandItemBackgroundPicture",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LtzQIIK-FD65qAFCBEm"
                },
                {
                    "mediaType": "youtube",
                    "type": "product",
                    "url": "https://www.youtube.com/watch?v=Z7v41l4I-Gc",
                    "ytId": "Z7v41l4I-Gc",
                    "thumbnail": "https://img.youtube.com/vi/Z7v41l4I-Gc/0.jpg",
                    "embedURL": "https://www.youtube.com/embed/Z7v41l4I-Gc"
                },
                {
                    "mediaType": "picture",
                    "type": "itemBackgroundPicture",
                    "url": "https://bdharianeemaxime.firebaseapp.com/pub/-LzI78FCrDVaPk8tQkl9"
                },
                {
                    "mediaType": "picture",
                    "type": "certificateBackgroundPicture",
                    "url": "https://bdharianeemaxime.firebaseapp.com/pub/-LzI7CrFW31aP_hyx1ZE"
                }
            ],
            "attributes": [
                {
                    "type": "color",
                    "value": "Gold"
                }
            ],
            "materials": [
                {
                    "material": "gold",
                    "pourcentage": "50%"
                }
            ],
            "size": [
                {
                    "type": "depth",
                    "value": "6",
                    "unit": "in"
                },
                {
                    "type": "depth",
                    "value": "3,6",
                    "unit": "cm"
                }
            ],
            "manufacturingCountry": "Switzerland",
            "facilityId": "12345",
            "productCertification": [
                {
                    "name": "fairtrade"
                }
            ],
            "i18n": [
                {
                    "language": "fr-FR",
                    "description": "<b>Description</b>\nLa montre The Navyclock d'Arianee est un petit modรจle utilisant le mouvement ร  quartz. Boitier en or rose 18 carats, Couronne perlรฉe en or rose 18 carats sertie d'un spinelle synthรฉtique en forme de cabochon, bracelet en cuir.\n\n<b>Dimensions</b>\ndiamรจtre: 29.5 mm, รฉpaisseur: 6.35 mm, รฉtanche ร  3 bar (environ 30 mรจtres/100 pieds).",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": "Site",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": "Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": "L'Histoires des montres ",
                            "url": "https://fr.wikipedia.org/wiki/Montre_(horlogerie)"
                        },
                        {
                            "type": "proofLinkAction",
                            "title": "Link with a proof of ownership",
                            "url": "https://test.arian.ee/proofLinkAction.html"
                        }
                    ]
                },
                {
                    "language": "zh-CN",
                    "description": "<b>ๆ่ฟฐ</b>\nThe Navyclock by Arianee ๆ‰‹่กจ๏ผŒๅฐๅž‹ๆฌพ๏ผŒ็Ÿณ่‹ฑๆœบ่Šฏ. 18k็Žซ็‘ฐ้‡‘่กจๅฃณ๏ผŒ18k็Žซ็‘ฐ้‡‘ไธฒ็ ็Šถ่กจๅ† ๏ผŒ้•ถๆœ‰ๅ‡ธๅœ†ๅฝขไบบ้€ ๅˆๆˆๅฐ–ๆ™ถ็Ÿณ๏ผŒ็šฎ้ฉ่กจๅธฆ.\n\n<b>ๅค–ๅฃณๅฐบๅฏธ</b>\n็›ดๅพ„๏ผš29.5ๆฏซ็ฑณ๏ผŒๅŽšๅบฆ๏ผš6.35ๆฏซ็ฑณ๏ผŒ้˜ฒๆฐดๆทฑๅบฆ่พพ3ๅทด๏ผˆ็บฆ30็ฑณ/ 100่‹ฑๅฐบ\n",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": " ็ฝ‘็ซ™",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": " ๅ…ณไบŽ Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": " ๆ‰‹่กจ็š„ๅŽ†ๅฒ",
                            "url": "https://zh.wikipedia.org/wiki/%E6%89%8B%E8%A1%A8"
                        }
                    ]
                }
            ],
            "$schema": "https://cert.arianee.org/version5/ArianeeProductCertificate-i18n.json"
        },
        "tags": [
            "EDITED",
            "public_v2"
        ],
        "minted": false,
        "passphrase": "6d8j0envby6d",
        "productId": "productId"
    }
}

Update JSON Schema & Metadata

You wish to replace specific fields of a digital passport.

URL

Required rights: admin or certCreate

To update specific data in the JSON body, use /productManagement/product/:productId.

PATCH - https://{{nmpUrl}}/productManagement/product/:productId
{
    "tags": ["EDITED"],
    "content": {
    "language": "en-US",
    "name": "product",
    "sku": "NAC-BB-LS20-06",
    "gtin": "0 00 12345 60001 2",
    "brandInternalId": "NYC12345",
    "category": "apparel",
    "subCategory": "watch",
    "intended": "womens",
    "serialnumber": [
        {
            "type": "edited",
            "value": "edited"
        }
    ],
    "i18n": [
      {
        "language": "fr-FR",
        "description": "<b>Description</b>\nLa montre The Navyclock d'Arianee est un petit modรจle utilisant le mouvement ร  quartz. Boitier en or rose 18 carats, Couronne perlรฉe en or rose 18 carats sertie d'un spinelle synthรฉtique en forme de cabochon, bracelet en cuir.\n\n<b>Dimensions</b>\ndiamรจtre: 29.5 mm, รฉpaisseur: 6.35 mm, รฉtanche ร  3 bar (environ 30 mรจtres/100 pieds).",
        "externalContents": [
          {
            "type": "website",
            "title": "Site",
            "url": "https://www.arianee.org/"
          },
          {
            "type": "website",
            "title": "Arianee",
            "url": "https://www.arianee.org/about-arianee"
          },
          {
            "type": "website",
            "title": "L'Histoires des montres ",
            "url": "https://fr.wikipedia.org/wiki/Montre_(horlogerie)"
          },
          {
            "type": "proofLinkAction",
            "title": "Link with a proof of ownership",
            "url": "https://test.arian.ee/proofLinkAction.html"
          }
        ]
      },
      {
        "language": "zh-CN",
        "description": "<b>ๆ่ฟฐ</b>\nThe Navyclock by Arianee ๆ‰‹่กจ๏ผŒๅฐๅž‹ๆฌพ๏ผŒ็Ÿณ่‹ฑๆœบ่Šฏ. 18k็Žซ็‘ฐ้‡‘่กจๅฃณ๏ผŒ18k็Žซ็‘ฐ้‡‘ไธฒ็ ็Šถ่กจๅ† ๏ผŒ้•ถๆœ‰ๅ‡ธๅœ†ๅฝขไบบ้€ ๅˆๆˆๅฐ–ๆ™ถ็Ÿณ๏ผŒ็šฎ้ฉ่กจๅธฆ.\n\n<b>ๅค–ๅฃณๅฐบๅฏธ</b>\n็›ดๅพ„๏ผš29.5ๆฏซ็ฑณ๏ผŒๅŽšๅบฆ๏ผš6.35ๆฏซ็ฑณ๏ผŒ้˜ฒๆฐดๆทฑๅบฆ่พพ3ๅทด๏ผˆ็บฆ30็ฑณ/ 100่‹ฑๅฐบ\n",
        "externalContents": [
          {
            "type": "website",
            "title": " ็ฝ‘็ซ™",
            "url": "https://www.arianee.org/"
          },
          {
            "type": "website",
            "title": " ๅ…ณไบŽ Arianee",
            "url": "https://www.arianee.org/about-arianee"
          },
          {
            "type": "website",
            "title": " ๆ‰‹่กจ็š„ๅŽ†ๅฒ",
            "url": "https://zh.wikipedia.org/wiki/%E6%89%8B%E8%A1%A8"
          }
        ]
      }
    ]
  }
}
{
    "tags": ["newtag"]
}

Return Payload

FieldTypeDescription
successBooleanIndicates whether the request was successful.
dataObjectContains the full payload of the group information.
{
    "success": true,
    "data": {
        "productGroupId": "productGroupID",
        "content": {
            "language": "en-US",
            "name": "product",
            "sku": "NAC-BB-LS20-06",
            "gtin": "0 00 12345 60001 2",
            "brandInternalId": "NYC12345",
            "category": "apparel",
            "subCategory": "watch",
            "intended": "womens",
            "serialnumber": [
                {
                    "type": "edited",
                    "value": "edited"
                }
            ],
            "subBrand": "Arianee watches",
            "model": "Limited serie 2020",
            "description": "<b>Description</b>\nThe Navyclock by Arianee watch, small model, quartz movement. Case in 18k pink gold, beaded crown in 18k pink gold set with a synthetic cabochon-shaped spinel, strap in leather. \n\n<b>Case dimensions</b>\ndiameter: 29.5 mm, thickness: 6.35 mm, water-resistant to 3 bar (approx. 30 meters/100 feet).",
            "subDescription": [
                {
                    "type": "other",
                    "title": "The Navyclock watchmaking process",
                    "content": "The Navyclock preserves the perfectly pitched classical elegance and signature Arianee features. The brand has been producing its own in-house movements since 2017. The movements boast a host of features but are designed to be thin by incorporating various complications into the mainplate."
                },
                {
                    "type": "service",
                    "title": "Customer service information",
                    "content": "The Navyclock is rarely down. When it happens you can be sure our network will be here for you. "
                }
            ],
            "externalContents": [
                {
                    "type": "website",
                    "title": "Website",
                    "url": "https://www.arianee.org/"
                },
                {
                    "type": "website",
                    "title": "About Arianee",
                    "url": "https://www.arianee.org/about-arianee"
                },
                {
                    "type": "website",
                    "title": "History of Watches",
                    "url": "https://en.wikipedia.org/wiki/History_of_watches"
                },
                {
                    "type": "proofLinkAction",
                    "title": "Link with a proof of ownership",
                    "url": "https://test.arian.ee/proofLinkAction.html"
                }
            ],
            "msrp": [
                {
                    "msrp": "35000",
                    "currency": "EUR",
                    "msrpCountry": "Europe"
                },
                {
                    "msrp": "32000",
                    "currency": "GBP",
                    "msrpCountry": "United Kingdom"
                },
                {
                    "msrp": "40000",
                    "currency": "USD",
                    "msrpCountry": "USA"
                }
            ],
            "medias": [
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-Lzfbb6qGXMN3LVhPRWG_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LzfbcJwhZPNES_2NK1h_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LzfbdNMkhOxvu5n_cPv_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "brandItemBackgroundPicture",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LtzQIIK-FD65qAFCBEm"
                },
                {
                    "mediaType": "youtube",
                    "type": "product",
                    "url": "https://www.youtube.com/watch?v=Z7v41l4I-Gc",
                    "ytId": "Z7v41l4I-Gc",
                    "thumbnail": "https://img.youtube.com/vi/Z7v41l4I-Gc/0.jpg",
                    "embedURL": "https://www.youtube.com/embed/Z7v41l4I-Gc"
                },
                {
                    "mediaType": "picture",
                    "type": "itemBackgroundPicture",
                    "url": "https://bdharianeemaxime.firebaseapp.com/pub/-LzI78FCrDVaPk8tQkl9"
                },
                {
                    "mediaType": "picture",
                    "type": "certificateBackgroundPicture",
                    "url": "https://bdharianeemaxime.firebaseapp.com/pub/-LzI7CrFW31aP_hyx1ZE"
                }
            ],
            "attributes": [
                {
                    "type": "color",
                    "value": "Gold"
                }
            ],
            "materials": [
                {
                    "material": "gold",
                    "pourcentage": "50%"
                }
            ],
            "size": [
                {
                    "type": "depth",
                    "value": "6",
                    "unit": "in"
                },
                {
                    "type": "depth",
                    "value": "3,6",
                    "unit": "cm"
                }
            ],
            "manufacturingCountry": "Switzerland",
            "facilityId": "12345",
            "productCertification": [
                {
                    "name": "fairtrade"
                }
            ],
            "i18n": [
                {
                    "language": "fr-FR",
                    "description": "<b>Description</b>\nLa montre The Navyclock d'Arianee est un petit modรจle utilisant le mouvement ร  quartz. Boitier en or rose 18 carats, Couronne perlรฉe en or rose 18 carats sertie d'un spinelle synthรฉtique en forme de cabochon, bracelet en cuir.\n\n<b>Dimensions</b>\ndiamรจtre: 29.5 mm, รฉpaisseur: 6.35 mm, รฉtanche ร  3 bar (environ 30 mรจtres/100 pieds).",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": "Site",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": "Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": "L'Histoires des montres ",
                            "url": "https://fr.wikipedia.org/wiki/Montre_(horlogerie)"
                        },
                        {
                            "type": "proofLinkAction",
                            "title": "Link with a proof of ownership",
                            "url": "https://test.arian.ee/proofLinkAction.html"
                        }
                    ]
                },
                {
                    "language": "zh-CN",
                    "description": "<b>ๆ่ฟฐ</b>\nThe Navyclock by Arianee ๆ‰‹่กจ๏ผŒๅฐๅž‹ๆฌพ๏ผŒ็Ÿณ่‹ฑๆœบ่Šฏ. 18k็Žซ็‘ฐ้‡‘่กจๅฃณ๏ผŒ18k็Žซ็‘ฐ้‡‘ไธฒ็ ็Šถ่กจๅ† ๏ผŒ้•ถๆœ‰ๅ‡ธๅœ†ๅฝขไบบ้€ ๅˆๆˆๅฐ–ๆ™ถ็Ÿณ๏ผŒ็šฎ้ฉ่กจๅธฆ.\n\n<b>ๅค–ๅฃณๅฐบๅฏธ</b>\n็›ดๅพ„๏ผš29.5ๆฏซ็ฑณ๏ผŒๅŽšๅบฆ๏ผš6.35ๆฏซ็ฑณ๏ผŒ้˜ฒๆฐดๆทฑๅบฆ่พพ3ๅทด๏ผˆ็บฆ30็ฑณ/ 100่‹ฑๅฐบ\n",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": " ็ฝ‘็ซ™",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": " ๅ…ณไบŽ Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": " ๆ‰‹่กจ็š„ๅŽ†ๅฒ",
                            "url": "https://zh.wikipedia.org/wiki/%E6%89%8B%E8%A1%A8"
                        }
                    ]
                }
            ],
            "$schema": "https://cert.arianee.org/version5/ArianeeProductCertificate-i18n.json"
        },
        "tags": [
            "EDITED",
            "public_v2"
        ],
        "minted": false,
        "passphrase": "6d8j0envby6d",
        "productId": "productId"
    }
}

Update One JSON Schema Property

You wish to update one specific property of the digital passport schema. Find below the supported properties.

URL

Required rights: admin or certCreate

To update one specific field, use /productManagement/product/:productId/:property. The new property value is passed in the body.

โš ๏ธ

When updating a property, pass all the associated values in the body if you do not want to erase them from the content.
See the materials update example: Pourcentage of gold has been updated but silver remains the same, however we have both values.

๐Ÿ’ก

Supported properties

language, name, sku, gtin, brandInternalId, category, subCategory, intended, serialnumber, subBrand, model, description, subDescription, externalContents, msrp, medias, customAttributes, attributes, materials, size, manufacturingCountry, facilityId, productCertification, transparencyItems, i18n, parentCertificates, image, image_data, external_url, background_color, animation_url, youtube_url

PUT - https://{{nmpUrl}}/productManagement/product/:productId/:property

Body

{
    "data": "New name"
}
{
		"data": [
    {
      	"type": "serialnumber",
      	"value": "12324"
    }
  ]
}
{
		"data": [
    {
      	"material": "gold",
      	"pourcentage": "99"
    },
    {
      	"material": "silver",
      	"pourcentage": "1"
    }
  ],
}

Return Payload

FieldTypeDescription
successBooleanIndicates whether the request was successful.
dataObjectContains the full payload of the digital passport information.
{
    "success": true,
    "data": {
        "productGroupId": "productGroupID",
        "content": {
            "language": "en-US",
            "name": "product",
            "sku": "NAC-BB-LS20-06",
            "gtin": "0 00 12345 60001 2",
            "brandInternalId": "NYC12345",
            "category": "apparel",
            "subCategory": "watch",
            "intended": "womens",
            "serialnumber": [
                {
                    "type": "edited",
                    "value": "edited"
                }
            ],
            "subBrand": "Arianee watches",
            "model": "Limited serie 2020",
            "description": "<b>Description</b>\nThe Navyclock by Arianee watch, small model, quartz movement. Case in 18k pink gold, beaded crown in 18k pink gold set with a synthetic cabochon-shaped spinel, strap in leather. \n\n<b>Case dimensions</b>\ndiameter: 29.5 mm, thickness: 6.35 mm, water-resistant to 3 bar (approx. 30 meters/100 feet).",
            "subDescription": [
                {
                    "type": "other",
                    "title": "The Navyclock watchmaking process",
                    "content": "The Navyclock preserves the perfectly pitched classical elegance and signature Arianee features. The brand has been producing its own in-house movements since 2017. The movements boast a host of features but are designed to be thin by incorporating various complications into the mainplate."
                },
                {
                    "type": "service",
                    "title": "Customer service information",
                    "content": "The Navyclock is rarely down. When it happens you can be sure our network will be here for you. "
                }
            ],
            "externalContents": [
                {
                    "type": "website",
                    "title": "Website",
                    "url": "https://www.arianee.org/"
                },
                {
                    "type": "website",
                    "title": "About Arianee",
                    "url": "https://www.arianee.org/about-arianee"
                },
                {
                    "type": "website",
                    "title": "History of Watches",
                    "url": "https://en.wikipedia.org/wiki/History_of_watches"
                },
                {
                    "type": "proofLinkAction",
                    "title": "Link with a proof of ownership",
                    "url": "https://test.arian.ee/proofLinkAction.html"
                }
            ],
            "msrp": [
                {
                    "msrp": "35000",
                    "currency": "EUR",
                    "msrpCountry": "Europe"
                },
                {
                    "msrp": "32000",
                    "currency": "GBP",
                    "msrpCountry": "United Kingdom"
                },
                {
                    "msrp": "40000",
                    "currency": "USD",
                    "msrpCountry": "USA"
                }
            ],
            "medias": [
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-Lzfbb6qGXMN3LVhPRWG_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LzfbcJwhZPNES_2NK1h_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LzfbdNMkhOxvu5n_cPv_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "brandItemBackgroundPicture",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LtzQIIK-FD65qAFCBEm"
                },
                {
                    "mediaType": "youtube",
                    "type": "product",
                    "url": "https://www.youtube.com/watch?v=Z7v41l4I-Gc",
                    "ytId": "Z7v41l4I-Gc",
                    "thumbnail": "https://img.youtube.com/vi/Z7v41l4I-Gc/0.jpg",
                    "embedURL": "https://www.youtube.com/embed/Z7v41l4I-Gc"
                },
                {
                    "mediaType": "picture",
                    "type": "itemBackgroundPicture",
                    "url": "https://bdharianeemaxime.firebaseapp.com/pub/-LzI78FCrDVaPk8tQkl9"
                },
                {
                    "mediaType": "picture",
                    "type": "certificateBackgroundPicture",
                    "url": "https://bdharianeemaxime.firebaseapp.com/pub/-LzI7CrFW31aP_hyx1ZE"
                }
            ],
            "attributes": [
                {
                    "type": "color",
                    "value": "Gold"
                }
            ],
            "materials": [
                {
                    "material": "gold",
                    "pourcentage": "50%"
                }
            ],
            "size": [
                {
                    "type": "depth",
                    "value": "6",
                    "unit": "in"
                },
                {
                    "type": "depth",
                    "value": "3,6",
                    "unit": "cm"
                }
            ],
            "manufacturingCountry": "Switzerland",
            "facilityId": "12345",
            "productCertification": [
                {
                    "name": "fairtrade"
                }
            ],
            "i18n": [
                {
                    "language": "fr-FR",
                    "description": "<b>Description</b>\nLa montre The Navyclock d'Arianee est un petit modรจle utilisant le mouvement ร  quartz. Boitier en or rose 18 carats, Couronne perlรฉe en or rose 18 carats sertie d'un spinelle synthรฉtique en forme de cabochon, bracelet en cuir.\n\n<b>Dimensions</b>\ndiamรจtre: 29.5 mm, รฉpaisseur: 6.35 mm, รฉtanche ร  3 bar (environ 30 mรจtres/100 pieds).",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": "Site",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": "Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": "L'Histoires des montres ",
                            "url": "https://fr.wikipedia.org/wiki/Montre_(horlogerie)"
                        },
                        {
                            "type": "proofLinkAction",
                            "title": "Link with a proof of ownership",
                            "url": "https://test.arian.ee/proofLinkAction.html"
                        }
                    ]
                },
                {
                    "language": "zh-CN",
                    "description": "<b>ๆ่ฟฐ</b>\nThe Navyclock by Arianee ๆ‰‹่กจ๏ผŒๅฐๅž‹ๆฌพ๏ผŒ็Ÿณ่‹ฑๆœบ่Šฏ. 18k็Žซ็‘ฐ้‡‘่กจๅฃณ๏ผŒ18k็Žซ็‘ฐ้‡‘ไธฒ็ ็Šถ่กจๅ† ๏ผŒ้•ถๆœ‰ๅ‡ธๅœ†ๅฝขไบบ้€ ๅˆๆˆๅฐ–ๆ™ถ็Ÿณ๏ผŒ็šฎ้ฉ่กจๅธฆ.\n\n<b>ๅค–ๅฃณๅฐบๅฏธ</b>\n็›ดๅพ„๏ผš29.5ๆฏซ็ฑณ๏ผŒๅŽšๅบฆ๏ผš6.35ๆฏซ็ฑณ๏ผŒ้˜ฒๆฐดๆทฑๅบฆ่พพ3ๅทด๏ผˆ็บฆ30็ฑณ/ 100่‹ฑๅฐบ\n",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": " ็ฝ‘็ซ™",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": " ๅ…ณไบŽ Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": " ๆ‰‹่กจ็š„ๅŽ†ๅฒ",
                            "url": "https://zh.wikipedia.org/wiki/%E6%89%8B%E8%A1%A8"
                        }
                    ]
                }
            ],
            "$schema": "https://cert.arianee.org/version5/ArianeeProductCertificate-i18n.json"
        },
        "tags": [
            "EDITED",
            "public_v2"
        ],
        "minted": false,
        "passphrase": "6d8j0envby6d",
        "productId": "productId"
    }
}

Errors

Status CodeSuccessError Message
400falseProperty passed as param must be a string and one of language, name, sku, gtin, brandInternalId, category, subCategory, intended, serialnumber, subBrand, model, description, subDescription, externalContents, msrp, medias, customAttributes, attributes, materials, size, manufacturingCountry, facilityId, productCertification, transparencyItems, i18n, parentCertificates, image, image_data, external_url, background_color, animation_url, youtube_url

Update One Property in Extra-language JSON Schema

You wish to update data for the extra languages of your digital passport.

URL

Required rights: admin or certCreate

To update an additional language, use /productManagement/product/:productId/i18n/:language/:property.

๐Ÿ’ก

Supported languages

fr-FR, en-US, zh-TW, zh-CN, ko-KR, ja-JP, de-DE, es, it, ru

PUT - https://{{nmpUrl}}/productManagement/product/:productId/i18n/:language/:property

Body

{
    "data": [{ //required
        "type": "editedserialnumber",
        "value": "edited"
    }]
}

Return Payload

FieldTypeDescription
successBooleanIndicates whether the request was successful.
dataObjectContains the full payload of the group information.
{
    "success": true,
    "data": {
        "productGroupId": "productGroupID",
        "content": {
            "language": "en-US",
            "name": "product",
            "sku": "NAC-BB-LS20-06",
            "gtin": "0 00 12345 60001 2",
            "brandInternalId": "NYC12345",
            "category": "apparel",
            "subCategory": "watch",
            "intended": "womens",
            "serialnumber": [
                {
                    "type": "edited",
                    "value": "edited"
                }
            ],
            "subBrand": "Arianee watches",
            "model": "Limited serie 2020",
            "description": "<b>Description</b>\nThe Navyclock by Arianee watch, small model, quartz movement. Case in 18k pink gold, beaded crown in 18k pink gold set with a synthetic cabochon-shaped spinel, strap in leather. \n\n<b>Case dimensions</b>\ndiameter: 29.5 mm, thickness: 6.35 mm, water-resistant to 3 bar (approx. 30 meters/100 feet).",
            "subDescription": [
                {
                    "type": "other",
                    "title": "The Navyclock watchmaking process",
                    "content": "The Navyclock preserves the perfectly pitched classical elegance and signature Arianee features. The brand has been producing its own in-house movements since 2017. The movements boast a host of features but are designed to be thin by incorporating various complications into the mainplate."
                },
                {
                    "type": "service",
                    "title": "Customer service information",
                    "content": "The Navyclock is rarely down. When it happens you can be sure our network will be here for you. "
                }
            ],
            "externalContents": [
                {
                    "type": "website",
                    "title": "Website",
                    "url": "https://www.arianee.org/"
                },
                {
                    "type": "website",
                    "title": "About Arianee",
                    "url": "https://www.arianee.org/about-arianee"
                },
                {
                    "type": "website",
                    "title": "History of Watches",
                    "url": "https://en.wikipedia.org/wiki/History_of_watches"
                },
                {
                    "type": "proofLinkAction",
                    "title": "Link with a proof of ownership",
                    "url": "https://test.arian.ee/proofLinkAction.html"
                }
            ],
            "msrp": [
                {
                    "msrp": "35000",
                    "currency": "EUR",
                    "msrpCountry": "Europe"
                },
                {
                    "msrp": "32000",
                    "currency": "GBP",
                    "msrpCountry": "United Kingdom"
                },
                {
                    "msrp": "40000",
                    "currency": "USD",
                    "msrpCountry": "USA"
                }
            ],
            "medias": [
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-Lzfbb6qGXMN3LVhPRWG_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LzfbcJwhZPNES_2NK1h_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LzfbdNMkhOxvu5n_cPv_arianeeResized"
                },
                {
                    "mediaType": "picture",
                    "type": "brandItemBackgroundPicture",
                    "url": "https://bdharianeetest.firebaseapp.com/pub/-LtzQIIK-FD65qAFCBEm"
                },
                {
                    "mediaType": "youtube",
                    "type": "product",
                    "url": "https://www.youtube.com/watch?v=Z7v41l4I-Gc",
                    "ytId": "Z7v41l4I-Gc",
                    "thumbnail": "https://img.youtube.com/vi/Z7v41l4I-Gc/0.jpg",
                    "embedURL": "https://www.youtube.com/embed/Z7v41l4I-Gc"
                },
                {
                    "mediaType": "picture",
                    "type": "itemBackgroundPicture",
                    "url": "https://bdharianeemaxime.firebaseapp.com/pub/-LzI78FCrDVaPk8tQkl9"
                },
                {
                    "mediaType": "picture",
                    "type": "certificateBackgroundPicture",
                    "url": "https://bdharianeemaxime.firebaseapp.com/pub/-LzI7CrFW31aP_hyx1ZE"
                }
            ],
            "attributes": [
                {
                    "type": "color",
                    "value": "Gold"
                }
            ],
            "materials": [
                {
                    "material": "gold",
                    "pourcentage": "50%"
                }
            ],
            "size": [
                {
                    "type": "depth",
                    "value": "6",
                    "unit": "in"
                },
                {
                    "type": "depth",
                    "value": "3,6",
                    "unit": "cm"
                }
            ],
            "manufacturingCountry": "Switzerland",
            "facilityId": "12345",
            "productCertification": [
                {
                    "name": "fairtrade"
                }
            ],
            "i18n": [
                {
                    "language": "fr-FR",
                    "description": "<b>Description</b>\nLa montre The Navyclock d'Arianee est un petit modรจle utilisant le mouvement ร  quartz. Boitier en or rose 18 carats, Couronne perlรฉe en or rose 18 carats sertie d'un spinelle synthรฉtique en forme de cabochon, bracelet en cuir.\n\n<b>Dimensions</b>\ndiamรจtre: 29.5 mm, รฉpaisseur: 6.35 mm, รฉtanche ร  3 bar (environ 30 mรจtres/100 pieds).",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": "Site",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": "Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": "L'Histoires des montres ",
                            "url": "https://fr.wikipedia.org/wiki/Montre_(horlogerie)"
                        },
                        {
                            "type": "proofLinkAction",
                            "title": "Link with a proof of ownership",
                            "url": "https://test.arian.ee/proofLinkAction.html"
                        }
                    ]
                },
                {
                    "language": "zh-CN",
                    "description": "<b>ๆ่ฟฐ</b>\nThe Navyclock by Arianee ๆ‰‹่กจ๏ผŒๅฐๅž‹ๆฌพ๏ผŒ็Ÿณ่‹ฑๆœบ่Šฏ. 18k็Žซ็‘ฐ้‡‘่กจๅฃณ๏ผŒ18k็Žซ็‘ฐ้‡‘ไธฒ็ ็Šถ่กจๅ† ๏ผŒ้•ถๆœ‰ๅ‡ธๅœ†ๅฝขไบบ้€ ๅˆๆˆๅฐ–ๆ™ถ็Ÿณ๏ผŒ็šฎ้ฉ่กจๅธฆ.\n\n<b>ๅค–ๅฃณๅฐบๅฏธ</b>\n็›ดๅพ„๏ผš29.5ๆฏซ็ฑณ๏ผŒๅŽšๅบฆ๏ผš6.35ๆฏซ็ฑณ๏ผŒ้˜ฒๆฐดๆทฑๅบฆ่พพ3ๅทด๏ผˆ็บฆ30็ฑณ/ 100่‹ฑๅฐบ\n",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": " ็ฝ‘็ซ™",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": " ๅ…ณไบŽ Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": " ๆ‰‹่กจ็š„ๅŽ†ๅฒ",
                            "url": "https://zh.wikipedia.org/wiki/%E6%89%8B%E8%A1%A8"
                        }
                    ]
                }
            ],
            "$schema": "https://cert.arianee.org/version5/ArianeeProductCertificate-i18n.json"
        },
        "tags": [
            "EDITED",
            "public_v2"
        ],
        "minted": false,
        "passphrase": "6d8j0envby6d",
        "productId": "productId"
    }
}

Errors

Status CodeSuccessError Message
400falseLanguage passed as param must be a string and one of fr-FR, en-US, zh-TW, zh-CN, ko-KR, ja-JP, de-DE, es, it, ru.

Remove Property in Content

Remove One Property in the JSON Schema

You wish to remove one specific property in the JSON schema of a target digital passport.

๐Ÿ’ก

Supported properties

language, name, sku, gtin, brandInternalId, category, subCategory, intended, serialnumber, subBrand, model, description, subDescription, externalContents, msrp, medias, customAttributes, attributes, materials, size, manufacturingCountry, facilityId, productCertification, transparencyItems, i18n, parentCertificates, image, image_data, external_url, background_color, animation_url, youtube_url

URL

To remove a specific property, use productManagement/product/:productId/:property.

Required rights: admin or certCreate

DELETE - https://{{nmpUrl}}/productManagement/product/:productId/:property

Return Payload

FieldTypeDescription
successBooleanIndicates whether the request was successful.
dataObjectContains the full payload of the group information.
{
    "success": true,
    "data": {
        "productGroupId": "Hybrid 450",
        "content": {
            "language": "en-US",
            "name": "product name",
            "model": "SF90",
            "description": "Description of the product.",
            "medias": [
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://www.sites/default/files/slideshow/slides/2022-07/62c4188892bc3.jpg"
                },
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://site.fr/wp-content/uploads/2022/07/5__fitmaxwzeyodasmtaynf0.jpeg"
                }
            ],
            "attributes": [
                {
                    "type": "color",
                    "value": "Red"
                }
            ],
            "manufacturingCountry": "Italy",
            "i18n": [
                {
                    "language": "fr-FR",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": "Site",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": "Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": "L'Histoires des montres ",
                            "url": "https://fr.wikipedia.org/wiki/Montre_(horlogerie)"
                        },
                        {
                            "type": "proofLinkAction",
                            "title": "Link with a proof of ownership",
                            "url": "https://test.arian.ee/proofLinkAction.html"
                        }
                    ]
                },
                {
                    "language": "zh-CN",
                    "description": "<b>ๆ่ฟฐ</b>\nThe Navyclock by Arianee ๆ‰‹่กจ๏ผŒๅฐๅž‹ๆฌพ๏ผŒ็Ÿณ่‹ฑๆœบ่Šฏ. 18k็Žซ็‘ฐ้‡‘่กจๅฃณ๏ผŒ18k็Žซ็‘ฐ้‡‘ไธฒ็ ็Šถ่กจๅ† ๏ผŒ้•ถๆœ‰ๅ‡ธๅœ†ๅฝขไบบ้€ ๅˆๆˆๅฐ–ๆ™ถ็Ÿณ๏ผŒ็šฎ้ฉ่กจๅธฆ.\n\n<b>ๅค–ๅฃณๅฐบๅฏธ</b>\n็›ดๅพ„๏ผš29.5ๆฏซ็ฑณ๏ผŒๅŽšๅบฆ๏ผš6.35ๆฏซ็ฑณ๏ผŒ้˜ฒๆฐดๆทฑๅบฆ่พพ3ๅทด๏ผˆ็บฆ30็ฑณ/ 100่‹ฑๅฐบ\n",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": " ็ฝ‘็ซ™",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": " ๅ…ณไบŽ Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": " ๆ‰‹่กจ็š„ๅŽ†ๅฒ",
                            "url": "https://zh.wikipedia.org/wiki/%E6%89%8B%E8%A1%A8"
                        }
                    ]
                }
            ],
            "$schema": "https://cert.arianee.org/version5/ArianeeProductCertificate-i18n.json"
        },
        "tags": [
            "parentPassport"
        ],
        "minted": true,
        "passphrase": "dr3qu5h7af7h",
        "tokenId": 216529552
    }
}

Errors

Status CodeSuccessError Message
400falseProperty passed as param must be a string and one of language, name, sku, gtin, brandInternalId, category, subCategory, intended, serialnumber, subBrand, model, description, subDescription, externalContents, msrp, medias, customAttributes, attributes, materials, size, manufacturingCountry, facilityId, productCertification, transparencyItems, i18n, parentCertificates, image, image_data, external_url, background_color, animation_url, youtube_url

Remove One Property in Extra-languages JSON Schema

You wish to remove one property for a target extra language.

URL

Required rights: admin or certCreate

To remove one property, use productManagement/product/:productId/i18n/:language/:property.

๐Ÿ’ก

  • Supported languages: fr-FR, en-US, zh-TW, zh-CN, ko-KR, ja-JP, de-DE, es, it, ru
  • Supported properties: language, name, sku, gtin, brandInternalId, category, subCategory, intended, serialnumber, subBrand, model, description, subDescription, externalContents, msrp, medias, customAttributes, attributes, materials, size, manufacturingCountry, facilityId, productCertification, transparencyItems, i18n, parentCertificates, image, image_data, external_url, background_color, animation_url, youtube_url
DELETE - https://{{nmpUrl}}/productManagement/product/:productId/i18n/:language/:property

Return Payload

FieldTypeDescription
successBooleanIndicates whether the request was successful.
dataObjectContains the full payload of the group information.
{
    "success": true,
    "data": {
        "productGroupId": "Hybrid 450",
        "content": {
            "language": "en-US",
            "name": "product name",
            "model": "SF90",
            "description": "Description of the product.",
            "medias": [
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://www.sites/default/files/slideshow/slides/2022-07/62c4188892bc3.jpg"
                },
                {
                    "mediaType": "picture",
                    "type": "product",
                    "url": "https://site.fr/wp-content/uploads//2022/07/5__fitmaxwzeyodasmtaynf0.jpeg"
                }
            ],
            "attributes": [
                {
                    "type": "color",
                    "value": "Red"
                }
            ],
            "manufacturingCountry": "Italy",
            "i18n": [
                {
                    "language": "fr-FR",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": "Site",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": "Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": "L'Histoires des montres ",
                            "url": "https://fr.wikipedia.org/wiki/Montre_(horlogerie)"
                        },
                        {
                            "type": "proofLinkAction",
                            "title": "Link with a proof of ownership",
                            "url": "https://test.arian.ee/proofLinkAction.html"
                        }
                    ]
                },
                {
                    "language": "zh-CN",
                    "description": "<b>ๆ่ฟฐ</b>\nThe Navyclock by Arianee ๆ‰‹่กจ๏ผŒๅฐๅž‹ๆฌพ๏ผŒ็Ÿณ่‹ฑๆœบ่Šฏ. 18k็Žซ็‘ฐ้‡‘่กจๅฃณ๏ผŒ18k็Žซ็‘ฐ้‡‘ไธฒ็ ็Šถ่กจๅ† ๏ผŒ้•ถๆœ‰ๅ‡ธๅœ†ๅฝขไบบ้€ ๅˆๆˆๅฐ–ๆ™ถ็Ÿณ๏ผŒ็šฎ้ฉ่กจๅธฆ.\n\n<b>ๅค–ๅฃณๅฐบๅฏธ</b>\n็›ดๅพ„๏ผš29.5ๆฏซ็ฑณ๏ผŒๅŽšๅบฆ๏ผš6.35ๆฏซ็ฑณ๏ผŒ้˜ฒๆฐดๆทฑๅบฆ่พพ3ๅทด๏ผˆ็บฆ30็ฑณ/ 100่‹ฑๅฐบ\n",
                    "externalContents": [
                        {
                            "type": "website",
                            "title": " ็ฝ‘็ซ™",
                            "url": "https://www.arianee.org/"
                        },
                        {
                            "type": "website",
                            "title": " ๅ…ณไบŽ Arianee",
                            "url": "https://www.arianee.org/about-arianee"
                        },
                        {
                            "type": "website",
                            "title": " ๆ‰‹่กจ็š„ๅŽ†ๅฒ",
                            "url": "https://zh.wikipedia.org/wiki/%E6%89%8B%E8%A1%A8"
                        }
                    ]
                }
            ],
            "$schema": "https://cert.arianee.org/version5/ArianeeProductCertificate-i18n.json"
        },
        "tags": [
            "parentPassport"
        ],
        "minted": true,
        "passphrase": "dr3qu5h7af7h",
        "tokenId": 216529552
    }
}

Errors

Status CodeSuccessError Message
400falseLanguage passed as param must be a string and one of fr-FR, en-US, zh-TW, zh-CN, ko-KR, ja-JP, de-DE, es, it, ru.
400falseProperty passed as param must be a string and one of language, name, sku, gtin, brandInternalId, category, subCategory, intended, serialnumber, subBrand, model, description, subDescription, externalContents, msrp, medias, customAttributes, attributes, materials, size, manufacturingCountry, facilityId, productCertification, transparencyItems, i18n, parentCertificates, image, image_data, external_url, background_color, animation_url, youtube_url