Tag

Introduction

The Tag entity defines reusable labels that can be applied to various entities throughout the system (orders, commodities, contacts, inventory items). Tags enable flexible categorization, filtering, and organization of business data without modifying entity schemas.

Entity Structure

Properties

Property Name	Type	Required	Description
TagId	int	Yes	Primary key
Name	string	Yes	Tag name (e.g., "urgent", "fragile", "high-value")
Color	string?	No	Hex color code for UI display (e.g., "#FF5733")
OrganizationId	int	Yes	Organization owning this tag
Description	string?	No	Optional tag description
Created	DateTime	Yes	Creation timestamp
CreatedBy	string	Yes	User who created the tag
LastModified	DateTime	Yes	Last modification timestamp
LastModifiedBy	string	Yes	User who last modified

Relationships

Relationship	Type	Description
OrderTags	ICollection<OrderTag>	Junction to orders using this tag
CommodityTags	ICollection<CommodityTag>	Junction to commodities using this tag
InventoryItemTags	ICollection<InventoryItemTag>	Junction to inventory items using this tag
Organization	Organization	Parent organization

Usage

Tags are typically applied when creating or updating entities:

# Create order with tags
- task: Order/Create@1
  name: createOrder
  inputs:
    organizationId: ${organizationId}
    order:
      orderNumber: "ORD-001"
      tags:
        - "urgent"
        - "high-priority"
        - "temperature-controlled"

Related Topics

• OrderTag Entity - Junction for order tags
• CommodityTag Entity - Junction for commodity tags
• Order Entity - Orders with tagging support
• Commodity Entity - Commodities with tagging support