Last updated

Event Settings

Some event types has additional event settings that can specify exactly what should be triggered by the event. Since some items, for example product has quite a lot of different things that can trigger the event, you are able to restrict what should be triggered using these settings so that you don't get too many unnecessary events that you are not interested in.

Event configurations

  • Name A friendly name on what is actually a data table in Norce.
  • On insert Mark this if you want the event triggered when an new record is created to the data table (associated to the identifiers you get in the message).
  • On update Mark this and configure which fields you want to trigger the event, when they are changed in value.
  • On delete Mark if want an event when the record is deleted.
  • Filter For some settings you can set a filter that lets you restrict to a subset of the data table that should be triggering the event (for example, Category on the Product changed notification can be filtered to only listen for the primary categories).

EntityChanged property

Event metadata

To be able to understand why an event has been triggered you can look at the EntityChanged property passed with the event message. This describes which event setting that triggered the event.

For example, the CustomerChangedNotification has currently six different event settings - Customer, Customer Address, Customer Division, Customer Flag, Customer Info and Customer Price List. If the customer’s first name has changed the EntityChanged property will be tClientCustomer (the table name in Norce Commerce). If a new delivery address or a change to a saved address is done, the EntityChanged property will instead be tClientCustomerAddress.

This may help you when handling the integration, if you have different processes for different changes in the item in Norce Commerce.

Event type settings

Here are all the possible values and their explanation so that you can set up the event settings as you want it.

CustomerChangedNotification

Link to admin.

NameEntityChanged valueDescription
CustomertClientCustomerThe main data table for the CustomerChangedNotification event type. Contains customer information like name, email, role, etc.
Customer AddresstClientCustomerAddressSaved invoice and delivery addresses. (Norce Commerce allowed for only one Invoice address, but many delivery addresses)
Customer DivisiontClientCustomerDivisionA customer can have a relation to physical stores. And one can be primary (default).
Customer FlagtClientCustomerFlagCustomer flags, they can be non-existent for a customer and be active or inactive (“set” or “not set”)
Customer InfotClientCustomerInfoCustomer info types. You can filter on specific info types and (of course) both listen for new inserts as well as updates to the value.
Customer PriceListtClientCustomerPriceListA customer can have a relation to price lists.

CompanyChangedNotification

Link to admin.

NameEntityChanged valueDescription
CompanytClientCompanyThe main data table for the CompanyChangedNotification event type. Contains company information like name, code, vatno, etc.
Company AddresstClientCompanyAddressSaved invoice and delivery addresses. (Norce Commerce allowed for only one Invoice address, but many delivery addresses)
Company Delivery methodtClientCompanyDeliveryMethodA company can have relation to delivery methods
Company DiscounttClientCompanyDiscountA company can have discount rates
Company DivisiontClientCompanyDivisionA company can have a relation to physical stores. And one can be primary (default).
Company FlagtClientCompanyFlagCompany flags, they can be non-existent for a company and be active or inactive (“set” or “not set”)
Company InfotClientCompanyInfoCompany info types. You can filter on specific info types and (of course) both listen for new inserts as well as updates to the value.
Company Payment methodtClientCompanyPaymentMethodA company can have relation to payment methods
Company PriceListtClientCompanyPriceListA company can have a relation to price lists.
CustomertClientCustomerA company can have relation to many customers. If information on a customer is changed this can also trigger this event.
Customer CompanytClientCustomerCompanyA company can have relation to many customers.

SkuChangedNotification

Link to admin.

NameEntityChanged valueDescription
CategorytCategoryA product has a relation to one or more categories. Where only one is primary. Contains default language information on the category and also default values that the product might use. You can (and often should) filter on only primary categories.
Category culturetCategoryCultureThe language specific data table for the category. You can filter on specific culture codes.
Category SalesAreatCategorySalesAreaContains default vat code for the primary category. You can filter on sales area.
Client manufacturertClientManufacturerContains the name and code of the Manufacturer for the product.
Product SKUtClientProductSkuTogether with Product, this is the main data table for the SkuChangedNotification event type. Contains product information like partno, logistic info, statusid, typeid, etc. You can filter based on the product type.
Product SKU CulturetClientProductSkuCultureLanguage specific text information on the product sku, not commonly used. Can filter on culture codes.
Product SKU OnHandtClientProductSkuOnHandAvailability information on the product. Information like onhand, incoming, nextdelivery, etc. Can filter on Warehouse.
Product SKU PriceListtClientProductSkuPriceListPrice information on the product. Price Sale, Costs, price rules. But also chosen (primary) supplier information. Can filter on price lists.
Product SKU SalesAreatClientProductSkuSalesAreaContains vat code for the product (unless inherited from Category SalesArea). You can filter on sales area.
Structure itemtClientProductSkuStructureItemIf a product is an item in a package or a structure product, this is the identifier and quantity.
Structure pricelist itemtClientProductSkuStructureItemPriceListIf a product is an item in a package or a structure product, this is the price information.
ParametrictParametricA product can have parametrics. This is the metadata on the parametrics. Default name, description, type id.
Parametric culturetParametricCultureThe language specific data table for the parametrics. Can filter on culture codes.
Parametric list itemtParametricListIf a parametric is of type list, this contains the list items, with code, default name, sort order etc.
Parametric list item culturetParametricListCultureThe language specific data table for the parametric list items. Can filter on culture codes.
Parametric multiple itemtParametricMultipleIf a parametric is of type multiple, this contains the list items with code, default name, sort order etc.
Parametric multiple culture itemtParametricMultipleCultureThe language specific data table for the parametric multiple items. Can filter on culture codes.
PriceListClientPricingtPriceListClientPricingThe price rules on the price lists. Contains price rule information.
ProducttProductTogether with Product SKU, this is the main data table for the SkuChangedNotification event type. Contains product information like default name and description, manufacturer etc.
Product accessory (deprecated)tProductAccessoryNot used anymore, Use Product Relation.
Product categorytProductCategoryThe relation to the category, contains primary flag and sort order (if manual sort order is enabled for you).
Product crossell (deprecated)tProductCrossellNot used anymore, Use Product Relation.
Product culturetProductCultureThe language specific data table for the Product. Can filter on culture codes.
Product filetProductFileThe information on files and images on the product. Contains code, default texts, file id and file (image) key. Can filter on file/image type.
Product flagtProductFlagProduct flags, they can be non-existent for a product and be active or inactive (“set” or “not set”). Can be filtered on flag.
Product parametrictProductParametricThe relation between parametrics and the product, with the product’s value information, like booleanValue, dateValue, listId, etc.
Product parametric culturetProductParametricCultureThe language specific data table for the parametric-product relation. Contains text values, like htmlValue and varcharValue. Can be filtered on Culture codes.
Product parametric multipletProductParametricMultipleContains relation between product and parametrics of the type multiple. No addition setting can be added.
Product relationtProductRelationReplaced Accessory, Upsell and Crossell.
Relations between products, contains type id, rule id, sort order etc. Can filter on relation type.
Product upsell (deprecated)tProductUpsellNot used anymore, Use Product Relation.
Variant groupingtVariantGroupThe grouping information for products that are variants to other products. Contains common information for variants like code, group id and default texts.
Variant grouping culturetVariantGroupCultureThe language specific data table for the Variant grouping. Contains language specific texts. Can be filtered on Culture codes.

TranslationRequestedNotification

Link to admin.

NameEntityChanged valueDescription
ProducttProductThe main data table for the TranslationRequestedNotification event type. Contains product information like default name and other texts on the default language.

SupplierSkuChangedNotification

Link to admin.

NameEntityChanged valueDescription
Supplier ProducttSupplierProductSkuThe main data table for SupplierSkuChangedNotification event type. Contains base product information from the supplier, like partno, eancode, manufacturer, vat code, and sometimes logistic information and weight.
Supplier ProducttSupplierProductSkuClientMapping information to the client product (productId)
Supplier ProducttSupplierProductSkuInfoExtra fields from the supplier (not commonly used)
Supplier PricestSupplierProductSkuPriceListPrice information on the supplier product. Cost purchase, Price recommended.

SupplierSkuPriceChangedNotification

Link to admin.

NameEntityChanged valueDescription
Supplier PricestSupplierProductSkuPriceListThe main data table for SupplierSkuPriceChangedNotification event type. Price information on the supplier product. Cost purchase, Price recommended.

SupplierSkuOnHandChangedNotification

Link to admin.

NameEntityChanged valueDescription
Supplier OnHandtSupplierProductSkuOnHandThe main data table for SupplierSkuOnHandChangedNotification event type. Availability information on the product. Information like onhand, incoming, nextdelivery, etc.