Attribute labels

Attribute labels allow to specify standard labels to Attribute Definitions. This is useful to indicate Partium the meaning of the attribute values associated to the attribute definitions.

Standard attribute labels

Label	Definition
description	Equal or larger definition of the part than in the part name with additional information of the product that is useful for searching. It is around 100 characters long. E.g.: Induktiver Näherungsschalter IN 40-S-M8 Fa.Schunk Ident.-Nr. 0301474
identifier	Generic label for an identifier of unknown type (i.e., not one of the existing labels can be set instead). Should not be used for the external_id as defined in the Partium system as the unique identifier in the catalog of the customer. However, it could be used to label a secondary identifier in the catalog.
manufacturer_name	Brand name or manufacturer name. E.g., column containing brand or manufacturer information: Siemens, Husky, ASCO,... Use this label when it is not clear if this column refers to an OEM, an OPM, or a Supplier (or mixes them).
manufacturer_part_number	Identifier the manufacturer assigns to a part design (contrary to serial numbers, which refer to physical instances of a part), unique to the manufacturer.
oem_name	Name of the Original Equipment Manufacturer.
oem_id	Identifier the Original Equipment Manufacturer assigns to the part.
upc	Universal Product Code: Worldwide unique code, so it's consistent across manufacturers, retailers, etc. It consists of 12 digits.
ean	European Article Number: Same as UPC, applied worldwide despite of the name. It consists of 13 digits.
serial_number	Serial Number: Code that uniquely identifies a physical part. For that, it can consists of numbers or letters referring to the instance in a batch, plant where it was assembled, manufacturing date, etc.
sku	Stock Keeping Unit: Local to the retailer, so not consistent across manufacturers. Varies in length and can contain numbers and letters.
supplier_name	Supplier/Provider/Vendor: The company that provides the manufactured parts to another company, but did not build them.
supplier_id	Identifier that the vendor gave to the spare part, which usually does not coincide with the one provided by the manufacturer.
standard	ISO/DIN/other standard number assigned to the part (e.g. DIN-A3)
opm_name	Name of the Original Part Manufacturer.
opm_id	Identifier the Original Part Manufacturer assigns to the part.

Part attributes and labels

Parts in Partium are identified by an external_id, which identifies the part for the customer. They also contain a name in multiple languages. Parts can also contain extra metadata about the part.

Part metadata is organized in attributes, which are specified by a list of attribute definitions at the organization level. These attribute definitions have properties common to all part attributes belonging to that definition.

Attribute definitions represent a column or property common to all parts. The part holds the attribute information with its value and is linked to the attribute definition. The value represents this property for the part.

Example of attribute definition

# Attribute definition:
{
    "attribute_id": "long_name",
    "name":
    {
        "en": "Long name"
    }
}

# Part data:
{
    "external_id": "PM10",
    "name": {
        "en": "screw"
    },
    "attributes": [
        {
            "attribute_id": "long_name",
            "value": {
                "en": "10cm screw 10mm diameter"
            }
        }
    ]
}

Example of attribute definition with a single label

Labels allow to map the concept from the customer catalog to existing concepts standardized for Partium. This helps separate the name we want to be shown in the UI from the underlying standard concept it represents.

Now that the attribute is defined, we can add a label to it:

# Attribute definition:
{
    "attribute_id": "long_name",
    "name": {
        "en": "Long name"
    },
    "labels": ["description"]
}

# Part data:
{
    "external_id": "PM10",
    "name": {
        "en": "screw"
    },
    "attributes": [
        {
            "attribute_id": "long_name",
            "value": {
                "en": "10cm screw 10mm diameter"
            }
        }
    ]
}

Example of attribute definition with multiple labels

Attribute definitions can have multiple labels. When a single attribute in the part metadata of the customer catalog represents multiple Partium standardized concepts, it is advised to use this mechanism. Continuing with the same example:

# Attribute definition:
{
    "attribute_id": "part_manufacturer_id",
    "name": {
        "en": "Manufacturer ID"
    },
    "labels": ["manufacturer_name", "manufacturer_part_number"]
}

# Part data:
{
    "external_id": "PM10",
    "name": {
        "en": "screw"
    },
    "attributes": [
        {
            "attribute_id": "part_manufacturer_id",
            "value": {
                "en": "Siemens RX75FD"
            }
        }
    ]
}

Example of labels assigned to multiple attribute definitions

Parts can also have the same labels in multiple attributes:

# Attribute definitions:
{
    "attribute_id": "part_manufacturer_id",
    "name": {
        "en": "Manufacturer ID"
    },
    "labels": ["manufacturer_name", "manufacturer_part_number"]
},
{
    "attribute_id": "manufacturer",
    "name": {
        "en": "Manufacturer"
    },
    "labels": ["manufacturer_name"]
}

# Part data:
{
    "external_id": "PM10",
    "name": {
        "en": "screw"
    },
    "attributes": [
        {
            "attribute_id": "part_manufacturer_id",
            "value": {
                "en": "Siemens RX75FD"
            }
        },
        {
            "attribute_id": "manufacturer",
            "value": {
                "en": "Siemens"
            }
        }
    ]
}