Skip to content
/
Extend basket and order m...
Last updated

Extending the Basket and Order Model in Norce Commerce

Overview

This page explains how to extend the shopping model in Norce Commerce by adding custom fields—called info types—to baskets and orders. You will learn how to plan, configure, and use these extensions to capture additional information during checkout and order processing.

Prerequisites

Before extending the shopping model, ensure you have completed these steps:

Preparations

Before you begin, gather the following information and make key decisions:

  • Additional Information: Define what extra data you need to capture (e.g., delivery instructions, ERP references).
  • Extension Level: Decide where the information should be stored:
    • Basket (basket header)
    • BasketItem (individual line items)
    • Order (order header)
    • OrderItem (order lines)
  • Data Types and Formats: Determine the expected format (text, date, number, JSON) for each field.

Note: Order and orderitem info types are application specific.

Tip: Plan your checkout process and integration needs to ensure all required data is captured at the correct level.

How-to: Add Info Types

Follow these steps to extend the shopping model with custom fields:

1. Access Info Types in Admin

  • Go to Shopping → Settings in the Admin UI.
  • Select the Info-Types tab.
  • Choose the object you want to extend:
    • Basket: Fields for the entire basket.
    • BasketItem: Fields for each basket line item.
    • Order: Fields for the order header.
    • OrderItem: Fields for each order line.

2. Create and Configure Info Types

  • Select the appropriate object level.
  • Add new info type fields as needed.
  • Configure each field's properties (name, description, etc.).

3. Example Use Cases

  • Basket: Add ERP order references or customer notes.
  • BasketItem: Store expected delivery dates or product-specific attributes.
  • Order: Include software download links or ERP data.
  • OrderItem: Capture line-specific information from ERP.

Important Considerations

  • All info type fields are stored as text in Norce Commerce.
  • You can interpret fields as dates, numbers, or other formats in your client applications.
  • For complex data, use JSON objects as field values.
  • Use matching identifiers between basket and order fields to enable automatic data transfer during checkout.

Further Configuration

After adding info types, you may:

  • Adjust field properties or add more fields as requirements evolve.
  • Integrate info type fields with your ERP or other external systems.
  • Use client-side logic to validate and process info type data.

Next Steps

After extending the shopping model, you may:

Previous page
Next page