Here is the naming convention for the different host names.
Norce Commerce Services is a set of services primarily focused on application development in front of the commerce engine Norce. These services handle actions and activities from eCommerce storefronts and eCommerce applications. Norce provides data and interaction with the business logic.
- Postman examples
- How to call the Norce Commerce Services
- Note that all datetimes returned in this API are in Unix Epoch format, e.g., Date(1727273870693+0200)
| Service | Description |
|---|---|
| Metadata | https://[hostname]/commerce/metadata/1.1/[method] Contains the Application and Expose endpoints. The Application endpoint manages applications as entities. It contains the Application entity, Store, and other lookup data common to an application and client's configuration. The Expose endpoint has shared information used by all other services. |
| Customer | https://[hostname]/commerce/customer/1.1/[method] The Customer service manages customer and company data. |
| Order | https://[hostname]/commerce/order/1.1/[method] The Order service handles orders and related entities such as DeliveryNotes and Invoices. |
| Product | https://[hostname]/commerce/product/1.1/[method] The Product service manages product catalog data including products, prices, and availability. |
| Shopping | https://[hostname]/commerce/shopping/1.1/[method] Contains entities and methods to handle baskets and payments. |
This API provides an effective way to export large product catalogs from Norce for different use cases. Target systems might include external search services that add functionality to eCommerce applications, marketplaces, or customer procurement systems that require customer-specific assortments, prices, and agreements. The product data is similar to what Norce Commerce Services provides.
| Service | Description |
|---|---|
| API | https://[hostname]/commerce/productfeed/1.0/api/v1/[endpoint] Set up exports of product catalogs to different channels. |
Norce Management API provides functionality for administrative tasks. With this API, you can script data management of product metadata, promotions, application settings, and much more. Use this for effective handling of business logic and configurations.
| Service | Description |
|---|---|
| API | https://[hostname]/api/[endpoint] Manage configuration and business logic on clients and applications. |
Connect is an API primarily designed for system integrations. This API is highly effective for large data payloads. Use this API for importing products, prices, inventory, customer information, and similar data. Connect also includes contracts for the Order Notification webhook and endpoints for updating transactions in Norce after order creation.
| Service | Description |
|---|---|
| Customer | https://[hostname]/commerce/connect/4.0/Customer/[method] Import customer and company data. |
| Job | https://[hostname]/commerce/connect/4.0/Job/[method] Storm Connect job information. |
| Order | https://[hostname]/commerce/connect/4.0/Order/[method] Import order statuses, delivery notes, and invoices, and send new orders to integrated systems. |
| Product | https://[hostname]/commerce/connect/4.0/Product/[method] Entities, enums, and methods for importing products and product-related information. |
| Supplier | https://[hostname]/commerce/connect/4.0/Supplier/[method] Import supplier product data. |
The Norce Query is an OData REST API with all write and update capabilities disabled. It is primarily for looking up data directly from Norce's data layer. It is feature-rich but complex and may be slow since the data is not cached. Use this with caution. When other APIs are available, such as the Management API, they are preferable and recommended. Also note that the data is "raw" since no business logic is applied when accessing it.
| Service | Description |
|---|---|
| Application | https://[hostname]/commerce/query/2.0/Application/[method] Contains entities and methods for all different settings for the client and application. |
| Core | https://[hostname]/commerce/query/2.0/Core/[method] Contains entities and methods for all different settings for all clients. |
| Customers | https://[hostname]/commerce/query/2.0/Customers/[method] Contains entities and methods for all customer and company related information. |
| Orders | https://[hostname]/commerce/query/2.0/Orders/[method] Contains entities and methods for orders, delivery notes, and invoices—everything regarding transactions that happen after purchase. |
| Products | https://[hostname]/commerce/query/2.0/Products/[method] Contains entities and methods for all product-related data. |
| Reporting | https://[hostname]/commerce/query/2.0/Reporting/[method] Contains entities and methods for looking up simple reports and summaries. |
| Shopping | https://[hostname]/commerce/query/2.0/Shopping/[method] Contains entities and methods concerning the setup of shopping rules. |
Event is a collection of webhooks that allow integrations to subscribe to data changes in Norce. Note that this service is not designed to be fast or real-time, as its primary use is to help integrations and automations outside of Norce.
- How to use Norce Commerce Webhooks
| Service | Description |
|---|---|
| Webhooks | Catch Commerce events. |
Payment Callback API is normally not used by client solutions. Only payment integrations, such as Norce's own Adapters, typically use these. Its purpose is to allow third-party services to call back to Norce when payments are approved, failed, or changed.
The base URL for payment callbacks to Norce Commerce is https://[hostname]/commerce/callback/1.0/. See respective PSP documentation for more information.