Metadata Integrations

This document serves as a guide to streamline the setup and management of product metadata using the Norce Management API. It discusses key types of metadata you may need to work with and provides instructions on how to use an example Excel macro for integration purposes.

Key Types of Product Metadata

Frequently-used types

1. Manufacturers
2. Flags
3. Parametrics
4. Parametric lists
5. Categories
6. Connected Parametrics to categories

Less-common but important types

1. Variant types
2. File types
3. Relation types

The examples and API endpoints mentioned provide an efficient way to start working with these metadata categories.

Using the Excel Macro Example

An Excel workbook example with TypeScript macros is provided as a practical tool for fetching and updating metadata.

Steps to Get Started

1. Download the example
   Download the workbook here.

2. Change settings

   • Open the Excel file.
   • Update settings to match your environment. (Default configuration points to Norce’s open demo environment.)

   

   Note: The token expires in an hour and needs to be manually renewed by:

   • Calling the identity service for your environment.
   • Generating a token using the Postman collection.

3. Use tabs for operations
   Each tab provides the following options:

   • Get from Norce API: Fetch metadata from the system.
   • Update Norce API: Push your changes back to the system.

   Workflow: Fetch data first, update it as needed, and then push changes.

   

4. Immediate Results
   Any updates you make are instantly reflected in the Commerce Admin interface since the admin UI and Norce Management API share the same cache.

This content is well-suited for users implementing integrations or managing system metadata.