Skip to content
Last updated

This page describes how to integrate product, pricing, and availability data between Norce Commerce and external systems. It provides recommended practices, API usage, and integration patterns for common scenarios.

Tip: For a general overview of integration patterns, see System integration patterns.

Overview of Norce Commerce APIs

Norce Commerce provides several APIs for system integration:

Integrating Product Information to Norce Commerce

When an external system (such as an ERP) is the master for product data, use the ImportProducts API to create or update products in Norce Commerce.

Integration Flow:

  1. Fetch or push articles from ERP to an integration layer.
  2. Apply business logic and mapping rules. Optionally, use Norce Commerce Query to look up codes or other data (e.g., parametrics, categories).
  3. Call Norce Commerce Connect's ImportProducts to update the product catalog.

Diagram: Products imported into Norce Commerce Image: Flowchart showing ERP → Integration → Norce Commerce Connect

API Usage and Examples

Full and Delta Updates

  • Full updates: Import all products, typically once per day or week.
  • Delta updates: Import only changed products, typically 2-3 times per day.
  • Use smaller imports for minor updates (e.g., prices, on hand).

Header Object

The header object in the API request controls which fields the ERP source system is allowed to update.
See Postman example for header usage.

Integrating Product Information from Norce Commerce

When Norce Commerce is the master for product data, other systems receive updates when products are created or changed.

Integration Flow:

  1. Product changes in Norce Commerce trigger an event (configurable in Admin UI).
  2. Integration listens for events and fetches messages from the Norce Commerce Event service bus.
  3. Integration applies business logic and may use Norce Commerce Query for additional data.
  4. Integration sends changed data to the target system (e.g., ERP).

Diagram: Products exported from Norce Commerce Image: Flowchart showing Norce Commerce → Event → Integration → Target system

Event Configuration

Examples

Integrating Price Information to Norce Commerce

When an external system is the master for pricing, use the ImportSkusPriceLists API to update prices in Norce Commerce.

Integration Flow:

  1. Fetch or push prices from ERP to an integration layer.
  2. Apply business logic and mapping rules. Optionally, use Norce Commerce Query for additional data.
  3. Call ImportSkusPriceLists to update prices.

Diagram: Prices imported into Norce Commerce Image: Flowchart showing ERP → Integration → Norce Commerce Connect

API Usage

Update Strategies

  • Use StandardPrice in ImportProducts for base price lists.
  • For multiple price lists, send a full import with all prices.
  • Full updates: daily or with product imports.
  • Delta updates: 1-12 times per day, depending on frequency of price changes.

Note: PartNo, PricelistCode (called "Agreement" in Query), and QuantityBreak (default "1") are required for correct price updates. Products are not created or deactivated via ImportSkuPriceList; use ImportProducts for that.

Examples

Integrating Price Information from Norce Commerce

When Norce Commerce is the master for pricing, use the SkuPriceChangedNotification event to update external systems.

Integration Flow:

  1. Price changes in Norce Commerce trigger an event.
  2. Integration listens for events and fetches messages.
  3. Integration applies business logic and may use Norce Commerce Query for additional data.
  4. Integration sends changed price data to the target system.

Diagram: Prices exported from Norce Commerce Image: Flowchart showing Norce Commerce → Event → Integration → Target system

Event Configuration

Examples

Integrating Availability (On Hand) Information to Norce Commerce

When an external WMS is the master for on hand data, use the ImportOnHands API.

Integration Flow:

  1. Fetch or push on hand data from WMS to an integration layer.
  2. Apply business logic and mapping rules. Optionally, use Norce Commerce Query for additional data.
  3. Call ImportOnHands to update availability.

Diagram: On hand imported into Norce Commerce Image: Flowchart showing WMS → Integration → Norce Commerce Connect

API Usage

Note: Setting on hand to 0 is different from deactivating a product for a warehouse. Deactivation means the warehouse cannot handle the product.

Update Strategies

  • Full imports: Deactivate on hand for products not included, but only for specified warehouses.
  • Delta imports: Frequency depends on accuracy needs (3-4 times a day to 3-4 times an hour).

Examples

Managing Price Lists in Norce Commerce

External systems can manage entire price lists in Norce Commerce.

Process:

  1. Call ImportPriceLists to create or update price lists.
  2. Call ImportSkuPriceLists to set prices for products.

Note: Price list code must be unique per client.

  • Full updates: Usually once per day.

Importing Images and Files

To import images and files, use ImportProducts and include MainImage and AdditionalImages fields.

Importing Competitor Information

For competitor pricing, use ImportCompetitorSkus to import competitor data.

Further Reading