This page explains how to configure event settings for Norce Commerce Event types. Event settings allow you to control which changes in Norce Commerce trigger events, helping you avoid unnecessary notifications and focus on relevant updates.
Some event types in Norce Commerce support additional event settings. These settings let you specify exactly what should trigger an event. For example, since a product can have many properties that might change, you can restrict events to only those changes you care about.
Event Setting Options:
- Name: A friendly name for the data table in Norce.
- On insert: Trigger the event when a new record is created in the data table.
- On update: Trigger the event when specific fields change. You can configure which fields to monitor.
- On delete: Trigger the event when a record is deleted.
- Filter: For some settings, you can set a filter to restrict which subset of the data table triggers the event (e.g., only primary categories for products).
When an event is triggered, the event message includes an EntityChanged property. This property indicates which event setting caused the event, helping you understand the reason for the notification.
For example, the CustomerChangedNotification event has several possible settings, such as Customer, Customer Address, and Customer Price List. If a customer's first name changes, EntityChanged will be tClientCustomer. If a delivery address changes, it will be tClientCustomerAddress.
This information helps you handle integrations with different processes for different types of changes.
The following sections list all possible event settings for each event type. Each table includes the setting name, the EntityChanged value, and a description.
| Name | EntityChanged value | Description |
|---|---|---|
| Customer | tClientCustomer | The main data table for the CustomerChangedNotification event type. Contains customer information like name, email, role, etc. |
| Customer Address | tClientCustomerAddress | Saved invoice and delivery addresses. Only one invoice address is allowed, but many delivery addresses. |
| Customer Division | tClientCustomerDivision | A customer can have a relation to physical stores. One can be primary (default). |
| Customer Flag | tClientCustomerFlag | Customer flags, which can be active or inactive (“set” or “not set”). |
| Customer Info | tClientCustomerInfo | Customer info types. You can filter on specific info types and listen for inserts or updates. |
| Customer PriceList | tClientCustomerPriceList | A customer can have a relation to price lists. |
| Name | EntityChanged value | Description |
|---|---|---|
| Company | tClientCompany | Main data table for company information (name, code, VAT number, etc.). |
| Company Address | tClientCompanyAddress | Saved invoice and delivery addresses. Only one invoice address is allowed, but many delivery addresses. |
| Company Delivery method | tClientCompanyDeliveryMethod | Company delivery methods. |
| Company Discount | tClientCompanyDiscount | Company discount rates. |
| Company Division | tClientCompanyDivision | Relation to physical stores. One can be primary (default). |
| Company Flag | tClientCompanyFlag | Company flags, which can be active or inactive (“set” or “not set”). |
| Company Info | tClientCompanyInfo | Company info types. You can filter on specific info types and listen for inserts or updates. |
| Company Payment method | tClientCompanyPaymentMethod | Company payment methods. |
| Company PriceList | tClientCompanyPriceList | Relation to price lists. |
| Customer | tClientCustomer | Relation to many customers. Changes to a customer can trigger this event. |
| Customer Company | tClientCustomerCompany | Relation to many customers. |
This event type has many possible settings. The table below lists each setting, the corresponding EntityChanged value, and a description.
| Name | EntityChanged value | Description |
|---|---|---|
| Category | tCategory | Product's relation to categories. Only one is primary. You can filter on primary categories. |
| Category culture | tCategoryCulture | Language-specific data for the category. Filter on culture codes. |
| Category SalesArea | tCategorySalesArea | Default VAT code for the primary category. Filter on sales area. |
| Client manufacturer | tClientManufacturer | Manufacturer information for the product. |
| Product SKU | tClientProductSku | Main data table for product information (part number, logistics, status, type, etc.). Filter by product type. |
| Product SKU Culture | tClientProductSkuCulture | Language-specific text for the product SKU. Filter on culture codes. |
| Product SKU OnHand | tClientProductSkuOnHand | Availability information (on hand, incoming, next delivery, etc.). Filter on warehouse. |
| Product SKU PriceList | tClientProductSkuPriceList | Price information, including sale prices, costs, price rules, and supplier info. Filter on price lists. |
| Product SKU SalesArea | tClientProductSkuSalesArea | VAT code for the product (unless inherited from Category SalesArea). Filter on sales area. |
| Structure item | tClientProductSkuStructureItem | Identifies items in a package or structure product. |
| Structure pricelist item | tClientProductSkuStructureItemPriceList | Price information for items in a package or structure product. |
| Parametric | tParametric | Metadata on product parametrics (name, description, type). |
| Parametric culture | tParametricCulture | Language-specific data for parametrics. Filter on culture codes. |
| Parametric list item | tParametricList | List items for parametrics of type list (code, name, sort order). |
| Parametric list item culture | tParametricListCulture | Language-specific data for parametric list items. Filter on culture codes. |
| Parametric multiple item | tParametricMultiple | List items for parametrics of type multiple. |
| Parametric multiple culture item | tParametricMultipleCulture | Language-specific data for parametric multiple items. Filter on culture codes. |
| PriceListClientPricing | tPriceListClientPricing | Price rules on price lists. |
| Product | tProduct | Main data table for product information (name, description, manufacturer, etc.). |
| Product accessory (deprecated) | tProductAccessory | Not used anymore. Use Product Relation instead. |
| Product category | tProductCategory | Relation to category, including primary flag and sort order. |
| Product crossell (deprecated) | tProductCrossell | Not used anymore. Use Product Relation instead. |
| Product culture | tProductCulture | Language-specific data for the product. Filter on culture codes. |
| Product file | tProductFile | Information on files and images (code, texts, file ID, image key). Filter on file/image type. |
| Product flag | tProductFlag | Product flags, which can be active or inactive (“set” or “not set”). Filter on flag. |
| Product parametric | tProductParametric | Relation between parametrics and the product, including value information. |
| Product parametric culture | tProductParametricCulture | Language-specific data for the parametric-product relation. Filter on culture codes. |
| Product parametric multiple | tProductParametricMultiple | Relation between product and parametrics of type multiple. No additional setting can be added. |
| Product relation | tProductRelation | Replaces Accessory, Upsell, and Cross-sell. Relations between products, including type, rule, sort order. Filter on relation type. |
| Product upsell (deprecated) | tProductUpsell | Not used anymore. Use Product Relation instead. |
| Variant grouping | tVariantGroup | Grouping information for products that are variants. |
| Variant grouping culture | tVariantGroupCulture | Language-specific data for variant grouping. Filter on culture codes. |
| Name | EntityChanged value | Description |
|---|---|---|
| Product | tProduct | Main data table for translation requests. Contains product information in the default language. |
| Name | EntityChanged value | Description |
|---|---|---|
| Supplier Product | tSupplierProductSku | Main data table for supplier product information (part number, EAN code, manufacturer, VAT code, etc.). |
| Supplier Product | tSupplierProductSkuClient | Mapping information to the client product (productId). |
| Supplier Product | tSupplierProductSkuInfo | Extra fields from the supplier (not commonly used). |
| Supplier Prices | tSupplierProductSkuPriceList | Price information for the supplier product (cost purchase, recommended price). |
| Name | EntityChanged value | Description |
|---|---|---|
| Supplier Prices | tSupplierProductSkuPriceList | Main data table for supplier product price information (cost purchase, recommended price). |
| Name | EntityChanged value | Description |
|---|---|---|
| Supplier OnHand | tSupplierProductSkuOnHand | Main data table for supplier product availability (on hand, incoming, next delivery, etc.). |